일반 IBM Cloud CLI(ibmcloud) 명령

IBM Cloud® 명령행 인터페이스는 사용자가 IBM Cloud와 상호작용할 수 있도록 네임스페이스별로 그룹화된 명령 세트를 제공합니다.

IBM Cloud CLI는 이름, 인수, 옵션, 전제 조건, 설명 및 예제를 포함하여 다음 명령을 지원합니다.

글로벌 전제조건

각 명령에 대한 전제조건에서는 명령 실행 전에 필요한 조치를 설명합니다. 전제조건에는 다음 조치 중 한 가지 이상이 포함될 수 있습니다.

엔드포인트
ibmcloud api 명령을 사용하여 API 엔드포인트를 설정하십시오.
로그인
ibmcloud login 명령을 사용하여 로그인하십시오. 페더레이션 ID로 로그인하는 경우 --sso 옵션을 사용하여 일회용 비밀번호로 인증합니다. 또는 --apikey 옵션을 사용하여 API 키로 인증하십시오.
대상
ibmcloud target 명령을 사용하여 대상 계정 또는 지역을 설정하거나 확인합니다.

글로벌 옵션

다음 옵션은 IBM Cloud CLI의 대부분의 명령에 사용할 수 있습니다. 옵션이 특정 명령에 사용 가능한지 확인하려면, 명령에 -h, --help 옵션을 함께 사용하십시오.

--output FORMAT

출력 형식을 지정합니다. JSON만 지원됩니다.

예제

사용 가능한 리소스 그룹을 JSON 형식으로 인쇄합니다.

ibmcloud resource groups --output json

-q, --quiet

자세한 메시지를 표시하지 않습니다. Getting information from... as ...가 지정되는 경우 -q, --quiet와 같은 메시지가 표시되지 않습니다.

예제

quiet(자세한 메시지 표시 않음) 모드로 사용 가능한 리소스 그룹을 인쇄합니다.

ibmcloud resource groups -q

ibmcloud help

첫 번째 레벨 기본 제공 명령 및 지원되는 IBM Cloud CLI 네임스페이스에 대한 일반 도움말 또는 특정 기본 제공 명령 또는 네임스페이스에 대한 도움말을 표시합니다.

ibmcloud help [COMMAND|NAMESPACE]

전제조건

없음.

명령 옵션

COMMAND|NAMESPACE
해당 도움말이 표시되는 명령 또는 네임스페이스입니다. 값을 지정하지 않으면 IBM Cloud CLI에 대한 일반 도움말이 표시됩니다. 선택사항입니다.

예제

IBM Cloud CLI에 대한 일반 도움말을 표시합니다.

ibmcloud help

dev 명령에 대한 도움말을 표시합니다.

ibmcloud help dev

iBM클라우드 지원

별명: ai

watsonx 을 사용하는 AI 어시스턴트에게 질문하세요. 기능 및 제한 사항에 대한 자세한 내용은 AI 어시스턴트의 도움 받기를 참조하세요.

ibmcloud assist "MY_QUERY"

AI 어시스턴트가 생성한 콘텐츠에는 실수가 포함되거나 부정확할 수 있습니다.

전제조건

  • ibmcloud login 명령을 사용하여 로그인하십시오. 페더레이션 ID로 로그인하는 경우 --sso 옵션을 사용하여 일회용 비밀번호로 인증하거나 --apikey 옵션을 사용하여 API 키로 인증합니다.

명령 옵션

없음.

예제

ibmcloud assist "How do I update the CLI?"

쿼리의 일부로 따옴표나 느낌표를 사용하는 경우 \ 을 사용하여 각 문자를 이스케이프 처리해야 합니다. 자세한 내용은 IBM Cloud CLI에서 문자열에 따옴표 사용을 참조하세요.

ibmcloud version

별명: v

IBM Cloud CLI의 버전을 인쇄합니다.

ibmcloud version

전제조건

없음.

명령 옵션

없음.

예제

IBM Cloud CLI의 버전을 인쇄합니다.

ibmcloud version

ibmcloud api

IBM Cloud API 엔드포인트를 설정하거나 봅니다.

ibmcloud api [API_ENDPOINT] [--unset] [--skip-ssl-validation] [--vpc]

전제조건

없음.

명령 옵션

API_ENDPOINT
대상으로 지정된 API 엔드포인트입니다(예: https://cloud.ibm.com). API_ENDPOINT 및 --unset 옵션 중 하나를 지정하지 않으면 현재 API 엔드포인트가 표시됩니다. 선택사항입니다.
--skip-ssl-validation
HTTP 요청의 SSL 유효성 검증을 무시하십시오. 이 옵션은 권장되지 않습니다.
--vpc
사설 API 엔드포인트에 대해 VPC 연결 사용 비공개 API 엔드포인트에 VPC 연결을 사용하도록 구성하는 방법에 대한 자세한 내용은 비공개 엔드포인트 게이트웨이 구성하기(VPC 사용 시 필요) 를 참조하세요.
--unset
API 엔드포인트 설정을 제거합니다.

예제

API 엔드포인트를 cloud.ibm.com 로 설정합니다:

ibmcloud api cloud.ibm.com

API 엔드포인트를 cloud.ibm.com으로 설정하고 SSL 유효성 검증을 건너뜁니다.

ibmcloud api https://cloud.ibm.com --skip-ssl-validation

현재 API 엔드포인트를 확인합니다.

ibmcloud api

API 엔드포인트를 제거합니다.

ibmcloud api --unset

ibmcloud config

기본값을 구성 파일에 씁니다.

ibmcloud config --http-timeout TIMEOUT_IN_SECONDS | --trace (true|false|path/to/file) |
         --color (true|false) | --locale (LOCALE|CLEAR) | --check-version (true|false)

전제조건

없음.

명령 옵션

--check-version
CLI 버전 확인을 사용 또는 사용 안함으로 설정합니다. 유효값은 true 또는 false입니다.
--color
색상 출력을 사용 또는 사용 안함으로 설정합니다. 이 옵션은 기본적으로 사용 안함으로 설정됩니다. 유효값은 true 또는 false입니다.
--http-timeout
HTTP 요청의 제한시간 값입니다. 기본값은 60초입니다.
--locale
기본 로케일을 설정합니다. 값이 지정되지 않은 경우 이전 로케일이 삭제됩니다.
--sso-otp
싱글 사인온(SSO) 일회용 비밀번호(OTP) 검색 스타일을 설정합니다. 기본값은 manual 이며 사용자 상호 작용이 필요합니다. auto 설정은 기본 브라우저를 자동으로 실행하고 토큰을 수락합니다.
--alpha-commands
분류되지 않은 명령을 알파벳순으로 정렬
--trace
터미널 또는 지정된 파일에 대한 HTTP 요청을 추적합니다. 유효값은 true 또는 false입니다.

한 번에 하나의 옵션만 지정할 수 있습니다.

예제

HTTP 요청 시간 제한을 30초로 설정합니다:

ibmcloud config --http-timeout 30

HTTP 요청에 대한 추적 출력을 사용하도록 설정합니다.

ibmcloud config --trace true

/home/usera/my_trace 파일에 대한 HTTP 요청을 추적합니다.

ibmcloud config --trace /home/usera/my_trace

색상 출력을 사용하지 않도록 설정합니다.

ibmcloud config --color false

로케일을 zh_Hans로 설정합니다.

ibmcloud config --locale zh_Hans

로케일 설정을 설정 해제합니다.

ibmcloud config --locale CLEAR

자동 SSO 일회용 비밀번호 수락을 사용 설정합니다:

ibmcloud config --sso-otp auto

분류되지 않은 명령을 알파벳순으로 정렬하도록 설정하기

ibmcloud config --alpha-commands true

ibmcloud login

IBM Cloud CLI에 로그인하십시오.

ibmcloud login [-a API_ENDPOINT] [--sso] [-u USERNAME] [-p PASSWORD] [--apikey KEY | @KEY_FILE] [--cr-token (TOKEN | @CR_TOKEN_FILE) | --vpc-cri] [--profile PROFILE_ID | PROFILE_NAME | PROFILE_CRN] [-c (ACCOUNT_ID | ACCOUNT_OWNER_USER_ID) | --no-account] [--accept] [-g (RESOURCE_GROUP_NAME | RESOURCE_GROUP_ID)] [-r REGION | --no-region] [--vpc]

전제조건

없음.

명령 옵션

-a API_ENDPOINT
API 엔드포인트입니다. 예를 들어, cloud.ibm.com입니다. 또는 private.cloud.ibm.com 을 사용하여 비공개 엔드포인트를 사용하여 로그인하세요. 이 플래그를 사용하면 API 엔드포인트가 구성 파일에 저장됩니다.
--sso
연합 ID로 로그인하려면 이 옵션을 지정하십시오. 이 옵션을 사용하면 싱글 사인온 제공자로 인증하고 로그인하기 위해 일회성 패스코드를 입력하라는 프롬프트가 표시됩니다.
-U username
사용자 이름입니다. 선택사항입니다.
-p password
사용자 비밀번호입니다. 선택사항입니다.
--apikey API_KEY 또는 @API_KEY_FILE_PATH
API 키 컨텐츠 또는 @로 표시되는 API 키 파일의 경로입니다.
--cr-token TOKEN 또는 @CR_TOKEN_FILE_PATH
컴퓨팅 리소스 토큰 컨텐츠 또는 @ 기호로 표시되는 컴퓨팅 리소스 토큰 파일의 경로입니다. 제공된 경우 --profile 플래그 또는 IBMCLOUD_CR_PROFILE 환경 변수도 제공하거나 설정해야 합니다.
--vpc-cri
VPC VSI 컴퓨팅 리소스 ID로 로그인합니다. 자세한 내용은 가상 서버 인스턴스 컴퓨팅 리소스 ID로 로그인 하기를 참조하세요.
--profile PROFILE_ID, PROFILE_NAME 또는 PROFILE_CRN
연결된 신뢰할 수 있는 IAM 프로필의 이름, ID 또는 CRN은 IAM 액세스 토큰을 얻을 때 사용됩니다. 제공되는 경우 --cr-token 플래그, IBMCLOUD_CR_TOKEN 환경 변수 또는 --vpc-cri 플래그도 제공하거나 설정해야 합니다. VPC VSI 컴퓨팅 리소스로 인증하는 경우, 신뢰할 수 있는 프로필 CRN 또는 ID만 지정하는 것이 지원됩니다.
-c ACCOUNT_ID
대상 계정의 ID입니다. 이 옵션은 --no-account 옵션에서만 사용할 수 있습니다.
--no-account
계정 없이 강제 로그인합니다. 이 옵션은 권장되지 않습니다. 이는 -c와 배타적입니다.
--accept
대상 계정의 가입 초대를 수락하십시오. 제공된 계정은 유효한 계정 ID여야 합니다.
-g RESOURCE_GROUP
대상 리소스 그룹의 이름 또는 ID입니다. 선택사항입니다.
-r REGION
대상 지역의 이름입니다. 예를 들어, us-south 또는 eu-gb입니다.
--no-region
지역을 대상으로 지정하지 않고 강제로 로그인합니다.
--skip-ssl-validation
HTTP 요청의 SSL 유효성 검증을 건너뜁니다. 이 옵션은 권장되지 않습니다.
--vpc
사설 API 엔드포인트에 대해 VPC 연결 사용 비공개 API 엔드포인트에 VPC 연결을 사용하여 로그인하는 방법에 대한 자세한 내용은 비공개 엔드포인트로 CLI에 로그인 하기를 참조하세요. 비공개 API 엔드포인트를 사용하도록 VPC 연결을 구성하는 방법에 대한 자세한 내용은 비공개 엔드포인트 게이트웨이 구성하기(VPC 사용 시 필요)를 참조하세요.

예제

대화식으로 로그:

ibmcloud login

사설 엔드포인트에 로그인합니다.

ibmcloud login -a private.cloud.ibm.com

us-south 와 us-east 두 지역이 지원됩니다.

VPC로 비공개 엔드포인트에 로그인합니다:

ibmcloud login -a private.cloud.ibm.com --vpc

사용자 아이디와 비밀번호로 로그인하고 대상 계정을 설정합니다:

ibmcloud login -u username -p password -c MyAccountID

페더레이션 ID로 로그인하고 대상 계정을 설정합니다:

ibmcloud login --sso -c MyAccountID

연관된 계정이 있는 API 키를 사용합니다.

ibmcloud login --apikey api-key-string

ibmcloud login --apikey @filename

연관된 계정이 없는 API 키를 사용합니다.

ibmcloud login --apikey api-key-string -c MyAccountID

ibmcloud login --apikey @fileName -c MyAccountID

API 키에 연관된 계정이 있는 경우에는 다른 계정으로의 전환이 지원되지 않습니다.

연합 ID를 사용하여 특정 사용자로 로그인합니다.

ibmcloud login --sso

그러면 CLI에서 URL 링크를 제공하며 패스코드를 입력하라는 프롬프트가 표시됩니다.

Get One Time Code from https://identity-1.us-south.iam.cloud.ibm.com/identity/passcode to proceed.
Open the URL in the default browser? [Y/n] >

브라우저에서 링크를 열어서 패스코드를 받으십시오. 콘솔에 패스코드를 입력하여 로그인하십시오.

CLI에서 제공하는 URL 링크를 사용하는 것 외에도 IBM Cloud 콘솔을 시작하고 로그인할 수 있습니다. IBM Cloud 콘솔에서 Avatar 아이콘 Avatar 아이콘 CLI 및 API에 로그인 합니다. IBM Cloud CLI 암호 명령을 복사하여 입력합니다. Google 계정으로 IBMid 에 로그인하거나 클라우드 계정을 IBM Cloud App ID 인스턴스와 연결한 경우 이 방법을 사용합니다.

신뢰할 수 있는 프로필에 연결된 IBM Kubernetes Service 컴퓨팅 리소스로 로그인합니다:

ibmcloud login --cr-token token-string --profile trusted_profile_name_id_or_crn

ibmcloud login --cr-token @filename --profile trusted_profile_name_id_or_crn

IBMCLOUD_CR_TOKEN=@filename ibmcloud login --profile trusted_profile_name_id_or_crn

IBMCLOUD_CR_TOKEN=@filename IBMCLOUD_CR_PROFILE=trusted_profile_name_id_or_crn ibmcloud login

IBM Kubernetes Service 컴퓨팅 리소스로 로그인하는 방법에 대한 자세한 내용은 컴퓨팅 리소스 토큰으로 로그인 하기를 참조하세요.

인스턴스 프로비저닝 중에 연결된 기본 신뢰할 수 있는 프로필을 사용하여 VPC VSI 컴퓨팅 리소스로 로그인합니다:

ibmcloud login --vpc-cri

지정된 신뢰 프로파일에 링크된 VPC VSI 계산 자원으로 로그인하십시오.

ibmcloud login --vpc-cri --profile trusted_profile_id_or_crn

IBMCLOUD_CR_PROFILE=trusted_profile_id_or_crn ibmcloud login --vpc-cri

VPC VSI 계산 자원으로 로그인하는 방법에 대한 자세한 정보는 가상 서버 인스턴스 계산 자원 ID로 로그인의 내용을 참조하십시오.

새 계정에 가입하라는 초대를 수락합니다:

ibmcloud login -c TargetedAccountID --accept

ibmcloud logout

CLI에서 로그아웃합니다.

ibmcloud logout

전제조건

없음.

ibmcloud regions

IBM Cloud의 모든 지역에 대한 정보를 봅니다.

ibmcloud regions

전제조건

ibmcloud api 명령을 사용하여 API 엔드포인트를 설정하십시오.

ibmcloud target

대상 계정 또는 지역을 설정하거나 확인합니다:

ibmcloud target [-r REGION_NAME | --unset-region] [-c ACCOUNT_ID] [-g RESOURCE_GROUP | --unset-resource-group]

전제조건

  • ibmcloud api 명령을 사용하여 API 엔드포인트를 설정하십시오.
  • ibmcloud login 명령을 사용하여 로그인하십시오. 페더레이션 ID로 로그인하는 경우 --sso 옵션을 사용하여 일회용 비밀번호로 인증하거나 --apikey 옵션을 사용하여 API 키로 인증합니다.

명령 옵션

-c ACCOUNT_ID
대상 계정의 ID입니다. 선택사항입니다.
-r REGION
대상 지역의 이름입니다(us-south 또는 eu-gb). 선택사항입니다.
-g RESOURCE_GROUP
대상 리소스 그룹의 이름입니다. 선택사항입니다.
--unset-region
대상으로 지정된 지역을 설정 해제합니다.
--unset-resource-group
대상으로 지정된 리소스 그룹을 설정 해제합니다.

지정한 옵션이 없으면 현재 계정과 지역이 표시됩니다.

예제

현재 계정을 설정합니다:

ibmcloud target -c MyAccountID

새 지역으로 전환하기:

ibmcloud target -r eu-gb

현재 계정 및 지역을 확인합니다:

ibmcloud target

ibmcloud update

CLI를 최신 버전으로 업데이트합니다.

ibmcloud update [-f]

전제조건

없음.

명령 옵션

-f
확인 없이 업데이트를 강제 실행합니다. 루트 권한이 필요합니다.

일반 클래식 인프라 서비스 명령

인프라 서비스를 구성하고 관리하려면 IBM Cloud CLI에서 클래식 인프라 명령을 사용하십시오.

사용 가능한 명령의 목록을 보려면 ibmcloud sl 명령을 실행하십시오.

USAGE:
   ibmcloud sl command [arguments...] [options...]

COMMANDS:
   block           Classic infrastructure Block Storage
   call-api        Call arbitrary API endpoints
   file            Classic infrastructure File Storage
   dns             Classic infrastructure Domain Name System
   globalip        Classic infrastructure Global IP addresses
   hardware        Classic infrastructure hardware servers
   image           Classic infrastructure Compute images
   ipsec           Classic infrastructure IPSEC VPN
   order           Classic infrastructure Orders
   placement-group Classic infrastructure Placement Group
   security        Classic infrastructure SSH Keys and SSL Certificates
   securitygroup   Classic infrastructure network security groups
   subnet          Classic infrastructure Network subnets
   ticket          Classic infrastructure Manage Tickets
   user            Classic infrastructure Manage Users
   vlan            Classic infrastructure Network VLANs
   vs              Classic infrastructure Virtual Servers
   help            Print command usage message

명령에 대한 도움말 정보를 보려면 다음 명령을 실행하십시오.

ibmcloud sl [command] -h

각 명령에 대한 자세한 정보는 이 문서에 있는 관련 참조 주제를 참조하십시오.

CLI 버전 ibmcloud sl init부터는 0.14 명령을 더 이상 사용할 수 없습니다. 최신 CLI 버전을 설치하려면 독립형 IBM Cloud CLI 설치를 참조하십시오.

ibmcloud sl help

클래식 인프라 환경의 운영을 위한 모든 명령에 대한 도움말 정보를 봅니다.

ibmcloud sl help