Cloud Databases CLI

Cloud Databases CLI 플러그인은 Cloud Databases 서비스의 기능에 액세스하는 추가 방법을 제공합니다. Cloud Databases CLI를 사용하여 다음 서비스를 관리하고 연결할 수 있습니다:

CLI Cloud Databases 플러그인을 사용하려면 IBM Cloud CLI가 설치되어 있어야 합니다.

CLI 플러그인 Cloud Databases (cdb)은 Gen 1 인스턴스만 지원합니다. Gen 2 인스턴스를 관리하려면 Gen 2 Cloud Databases CLI 참조 문서를 참조하십시오.

IBM Cloud CLI

IBM Cloud CLI는 명령행 인터페이스를 통해 IBM Cloud 계정 및 서비스에 대한 액세스를 제공하는 범용 개발자 도구입니다.

소개 및 설치 지침은 IBM Cloud CLI 시작하기 페이지에서 확인할 수 있습니다. 제공된 cURL 명령에서 CLI를 설치하면 여러 IDE에 대한 추가 플러그인 및 확장을 선택할 수 있습니다.

독립 실행형 설치하기 IBM Cloud CLI 페이지에서 독립 실행형 패키지를 설치합니다.

IBM Cloud CLI를 통한 서비스에 대한 액세스는 Identity and Access Management를 통해 관리됩니다. CLI를 사용하여 서비스를 보거나 관리하려면(또는 계정의 다른 사용자에게 권한을 부여하려면) 올바른 권한을 설정해야 합니다. IAM 관리에 대한 자세한 정보는 IAM 시작하기 튜토리얼을 참조하십시오.

Cloud Databases CLI 플러그인 설치

IBM Cloud CLI가 있으면 로그인하여 다음과 같은 명령을 사용하여 Cloud Databases 플러그인을 설치합니다:

ibmcloud plugin install cloud-databases

명령 목록과 사용 정보를 보려면 다음과 같은 명령을 사용하세요:

ibmcloud cdb help

ibmcloud cdb help

ibmcloud cdb help 명령은 그 자체로 사용 가능한 최상위 명령을 표시합니다. 다른 명령이 뒤에 오면 해당 명령에 대한 구체적인 도움말을 표시합니다.

ibmcloud cdb help [<command>]

명령 옵션

명령 특정 옵션이 없습니다.

예제

작업 표시 명령에 대한 도움말을 확인하세요.

ibmcloud cdb help task-show

시작하기 - 인스턴스 만들기

다음 명령을 사용하여 인스턴스를 만들 수 있습니다:

ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_NAME> <SERVICE_PLAN_NAME> <LOCATION> -g <RESOURCE_GROUP> -p '{"members_host_flavor": "<members_host_flavor value>"}' --service-endpoints="<endpoint>"

명령 옵션

기본 그룹 대신 다른 그룹을 사용하려면 리소스 그룹을 설정합니다. 이 플래그를 생략할 수도 있습니다.

예제

MongoDB 인스턴스를 만듭니다.

ibmcloud resource service-instance-create test-database databases-for-mongodb standard us-south -p '{"members_host_flavor": "multitenant", "members_memory_allocation_mb": "12288"}' --service-endpoints="private"

배치 및 배치 가능 항목

Cloud Databases 플랫폼에 배치 가능한 데이터베이스 및 데이터베이스 버전에 대한 정보를 가져옵니다. 또한 Cloud Databases 계정의 모든 IBM Cloud 목록을 가져옵니다.

ibmcloud cdb deployables-show

deployables는 새 데이터베이스 배치에 사용할 수 있는 템플리트입니다. 이 명령은 배치 가능한 데이터베이스 유형, 특히 사용 가능한 데이터베이스 버전 및 선호하는 상태 또는 안정적인 상태를 표시합니다.

ibmcloud cdb deployables-show [--stable] [--preferred] [--output, -o FORMAT]

간략한 버전 - deployables

명령 옵션

  • --stable 또는 -s 안정적인 버전의 데이터베이스만 나열합니다.
  • --preferred 또는 -p 선호하는 버전의 데이터베이스만 나열합니다.
  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

사용 가능한 모든 안정적인 버전의 데이터베이스를 표시합니다.

ibmcloud cdb deployables-show --stable

ibmcloud cdb deployments

간략한 버전 - ls

이 명령을 사용하여 계정과 연관된 배치를 나열할 수 있습니다.

ibmcloud cdb deployments [--all] [--output json]

명령 옵션

  • --all 또는 -a 인스턴스 이름 및 CRN을 표시합니다.
  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

계정이 있는 모든 현재 배포를 나열합니다.

ibmcloud cdb ls

ibmcloud cdb deployment-about

간략한 버전 - about

이 명령을 사용하여 인스턴스 내에 배포된 데이터베이스, 버전 및 적용된 옵션에 대한 세부 정보를 확인할 수 있습니다. 또한 리소스 제어기, 리소스 플랜, 현재 상태, 유형 및 마지막으로 알려진 오퍼레이션에 대한 ID 및 GUID가 표시됩니다.

ibmcloud cdb deployment-about <deployment name or CRN> [--all] [--output, -o FORMAT]

명령 옵션

  • --all 또는 -a 리소스 제어기의 레코드에서 사용 가능한 모든 데이터를 표시합니다.
  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

"RedisDBOne" 이라는 배포의 세부 정보를 나열합니다.

ibmcloud cdb about RedisDBOne

연결

배치에 연결할 때 사용할 연결 문자열 및 인증서 정보를 가져옵니다. 옵션이 있는 해당 데이터베이스에 대한 연결을 관리합니다.

ibmcloud cdb deployment-connections

간략한 버전 - cxn

사용자 인증 정보가 삽입되거나 삽입되지 않은 배치에 대한 연결 문자열 및 기타 연결 세부사항을 표시합니다.

ibmcloud cdb deployment-connections [--user <userid>] [--password <password>] [--endpoint-type <endpoint type>] [--all] [--only] [--start] [--certroot <path>] [--output, -o FORMAT]

명령 옵션

  • --start 또는 -s 생성된 CLI 명령을 실행하여 연결을 시작합니다. 비밀번호가 플래그에 지정되지 않은 경우 이 명령은 대화식으로 비밀번호에 대한 프롬프트를 표시합니다. 플러그인은 명령행 상호작용에 기본 명령을 사용하고 CA 인증서를 관리하여 보안 TLS 세션을 보장합니다. 기본적으로 배치의 관리자로 연결합니다.
  • --user <userid> 또는 -u 연결 설정을 검색할 때 사용되는 사용자 ID를 설정합니다. 이는 연결 문자열로 대체됩니다. 기본값은 배치의 관리자입니다.
  • --password <password> 또는 -p 연결 설정을 검색할 때 사용되는 비밀번호를 설정합니다. 이는 $PASSWORD가 기본값으로 표시되는 연결 문자열로 대체됩니다.
  • --endpoint-type [public or private] 또는 -e [public or private] 리턴된 연결 문자열의 엔드포인트 유형입니다. '공개' 또는 '비공개' 중 하나를 선택합니다. (기본값: "공개"). 엔드포인트 유형은 적용되지 않으며 표시 목적으로만 사용됩니다.
  • --all 또는 -a 연결 문자열의 컴포넌트 파트를 포함하여 사용 가능한 모든 연결 설정을 나열합니다.
  • --certroot <path> 또는 -c 경로를 인증서 루트로 사용합니다. 경로가 존재하지 않으면 자동으로 작성됩니다. --save 플래그와 함께 작동합니다. 인증서 루트 값은 $CERTROOT 환경 변수에서 설정할 수도 있습니다.
  • --only [app or cli] 또는 -o app 연결 또는 cli 연결과 관련된 설정만 표시합니다.
  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.
  • --endpoint-type 또는 -e 반환된 연결 문자열의 엔드포인트 유형, public 또는 private. 기본값은 public 입니다. 기본값은 public 이므로 public 엔드포인트가 없는 경우 아무것도 찾을 수 없으며 {"errors":"not_found"} 이라는 오류가 표시됩니다. private 엔드포인트를 사용하려면 -e private 플래그를 사용하세요.

예제

배포에 연결하는 방법을 표시합니다.

ibmcloud cdb deployment-connections MyPSQL

(연결 문자열 및 CLI 명령 문자열을 표시함)

관리자로 배치에 연결합니다.

ibmcloud cdb deployment-connections MyPSQL --start

실행 시 플러그인이 관리자 비밀번호에 대한 프롬프트를 표시한 후 CLI 명령 문자열을 실행합니다. CLI 명령 문자열에서 사용되는 명령을 설치해야 합니다.

특정 사용자 및 비밀번호 조합에 대해 배치에 연결하는 방법에 대한 모든 세부사항을 표시합니다.

ibmcloud cdb cxn MyPSQL -a -u auser -p auserpassword

ibmcloud cdb deployment-cacert

간략한 버전 - cacert

배치에 대한 TLS/SSL 연결을 확인하는 데 사용되는 자체 서명된 인증서를 표시합니다. 기본적으로 결과는 콘솔에 출력되지만 파일에 저장될 수도 있습니다.

ibmcloud cdb deployment-cacert <deployment name or CRN> [--user <userid>] [--save] [--certroot <path>] [--output, -o FORMAT]

명령 옵션

  • --user <userid> 또는 -u 기본적으로 관리자가 인증서를 가져오는 데 사용됩니다. 선택적으로 이 플래그를 사용하여 배치에서 사용자별 인증서를 지원하는 위치에 사용자를 지정할 수 있습니다.
  • --save 또는 -s 디코딩된 인증서를 인증서 루트 디렉토리에 저장합니다. 기본값은 $HOME/.cloud/plugins/cdb/cdbcerts/입니다.
  • --certroot <path> 또는 -c 경로를 인증서 루트 디렉토리로 사용합니다. 경로가 존재하지 않으면 자동으로 작성됩니다. --save 플래그와 함께 작동합니다. 인증서 루트 값은 $CERTROOT 환경 변수에서 설정할 수도 있습니다.
  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

MyPostgreSQL 라는 이름의 배포에 대한 인증서를 표시합니다.

ibmcloud cdb deployment-cacert MyPostgreSQL

동일한 배치에 대한 인증서를 현재 디렉토리에 저장합니다.

ibmcloud cdb deployment-cacert MyPostgreSQL --save --certroot .

참고: 파일 이름은 인증서 이름을 기반으로 합니다.

ibmcloud cdb deployment-kill-connections

간략한 버전 - kill-connections

배치에 대한 모든 연결을 닫습니다. PostgreSQL에만 사용할 수 있습니다.

ibmcloud cdb deployment-kill-connections <deployment name or CRN> [--nowait] [--output, -o FORMAT]

명령 옵션

  • --nowait 또는 -n 사용자 작성 태스크가 완료될 때까지 기다리지 않습니다. 사용자 작성 태스크 세부사항을 표시하고 종료합니다.
  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

이 명령은 postgresq-preproduction 이라는 이름의 배포에 대한 모든 외부 연결을 종료합니다.

ibmcloud cdb deployment-kill-connections postgresq-preproduction

기능

기능 명령은 데이터베이스 및 백업에 사용할 수 있고 지원되는 기능을 식별하는 데 도움이 됩니다.

ibmcloud cdb capability

capability-show

이 명령은 특정 데이터베이스 유형에 대해 기능이 지원되는지 여부를 검색합니다.

간략한 버전 - cs

ibmcloud cdb capability-show CAPABILITY_ID TYPE VERSION PLATFORM LOCATION TARGET_PLATFORM TARGET_LOCATION [--output, -o FORMAT] [--api-version]

명령 옵션

  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.
  • --api-version 또는 -v 요청에 사용된 API 버전입니다.
  • --hostflavor 그룹 기능을 위한 호스트 플레이버.

기능 ID 옵션

  • autoscaling
  • encryption
  • endpoints
  • groups
  • locations
  • point_in_time_recovery
  • remotes
  • restores
  • versions

예제

ibmcloud cdb capability-show 5f2d37a0-40a5-4a39-bf6a-0dbb1249ac5e database 3.2.1 IBMCloud us-south

ibmcloud cdb capability-show groups postgresql 15 classic eu-gb classic us-south --hostflavor multitenant

ibmcloud cdb capability-show groups postgresql 15 classic eu-gb classic us-south --hostflavor b3c.4x16.encrypted

backup-capability-show

이 명령은 특정 인스턴스에서 데이터베이스 유형을 복원할 수 있는지 확인합니다.

간략한 버전 - bcs

ibmcloud cdb discover-capability-information-from-backup (BACKUP_ID) (CAPABILITY_ID) (TARGET_PLATFORM) (TARGET_LOCATION) [--output, -o FORMAT] [--api-version] [--nowait]

명령 옵션

  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.
  • --api-version 또는 -v 요청에 사용된 API 버전입니다.

기능 ID 옵션

  • restores

예제

  ibmcloud cdb discover-capability-information-from-backup f7d318b6-6d4e-4d2a-9be4-7c1efbc94a52 5f2d37a0-40a5-4a39-bf6a-0dbb1249ac5e IBMCloud us-south --output, -o FORMAT --api-version 2021-09-30 --nowait

deployment-capability-show

이 명령은 특정 배치 또는 포메이션이 특정 기능을 지원하는지 여부를 검색합니다.

간략한 버전 - dcs

ibmcloud cdb deployment-capability-show (NAME|ID) (CAPABILITY_ID) [--target-platform] [--target-location] [--output, -o FORMAT] [--api-version] [--nowait]

명령 옵션

  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.
  • --api-version 또는 -v 요청에 사용된 API 버전입니다.
  • --target-platform 또는 -p 요청 대상 플랫폼
  • --target-location 또는 -l 요청 대상 위치

기능 ID 옵션

  • autoscaling
  • encryption
  • endpoints
  • groups
  • locations
  • point_in_time_recovery
  • remotes
  • versions

예제

ibmcloud cdb deployment-capability-show my-deployment 5f2d37a0-40a5-4a39-bf6a-0dbb1249ac5e --target-location us-south --output, -o FORMAT --api-version 2021-09-30 --nowait

사용자

배치 시 사용자의 비밀번호를 작성, 삭제 또는 변경합니다.

ibmcloud cdb deployment-user-create

간략한 버전 - user-create

배치 데이터베이스에 사용자를 작성합니다.

ibmcloud cdb deployment-user-create <deployment name or CRN> <newusername> <newpassword> [--nowait] [--output, -o FORMAT]

newusername은 배치의 데이터베이스에서 사용할 수 있도록 올바르게 형식화된 사용자 이름이어야 합니다. newpassword는 데이터베이스의 비밀번호 규칙을 준수해야 하며 10자 이상이어야 합니다.

명령 옵션

  • --nowait 또는 -n 사용자 작성 태스크가 완료될 때까지 기다리지 않습니다. 사용자 작성 태스크 세부사항을 표시하고 종료합니다.
  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

"MyPSQL" 배포에서 비밀번호가 "X1234Y5678" 인 "fred"라는 데이터베이스 사용자를 만듭니다.

ibmcloud cdb deployment-user-create MyPSQL fred X1234Y5678

ibmcloud cdb deployment-user-delete

간략한 버전 - user-delete

지정된 데이터베이스 배치에서 기존 사용자를 제거합니다.

ibmcloud cdb deployment-user-delete <deployment name or CRN> <username> [--nowait] [--output, -o FORMAT]

명령 옵션

  • --nowait 또는 -n 사용자 삭제 태스크가 완료될 때까지 기다리지 않습니다. 사용자 삭제 태스크 세부사항을 표시하고 종료합니다.
  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

"MyPSQL" 배포에서 "fred"라는 데이터베이스 사용자를 제거합니다.

ibmcloud cdb deployment-user-delete MyPSQL fred

ibmcloud cdb deployment-user-password

간략한 버전 - user-password

지정된 데이터베이스 배치에서 이름 지정된 사용자의 비밀번호를 변경합니다.

ibmcloud cdb deployment-user-password <deployment name or CRN> <username> <newpassword> [--nowait] [--output, -o FORMAT]

명령 옵션

  • --nowait 또는 -n 사용자 비밀번호 변경 태스크가 완료될 때까지 기다리지 않습니다. 사용자 비밀번호 변경 태스크 세부사항을 표시하고 종료합니다.
  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

데이터베이스 배포 "MyPSQL" 에서 사용자 "fred"의 비밀번호를 "A9876B5432" 으로 변경합니다.

ibmcloud cdb deployment-password MyPSQL fred A9876B5432

데이터베이스 구성

배포에서 구성 가능한 설정을 나열하거나 변경합니다. 새 구성은 JSON 파일 또는 JSON 설정 문자열에 지정됩니다. 설정은 데이터베이스 유형에 따라 다르므로 데이터베이스 구성 변경하기를 참조하세요 PostgreSQL 또는 Redis.

ibmcloud cdb deployment-configuration-schema

간략한 버전 - config-schema

지정된 배포의 기본 구성을 가져옵니다.

ibmcloud cdb deployment-configuration-schema <deployment name or CRN> [--description] [--output, -o FORMAT]

ibmcloud cdb deployment-configuration-schema 에는 기본 구성이 표시됩니다. 현재 구성 값을 확인하려면 데이터베이스에서 직접 구성을 쿼리하십시오.

명령 옵션

  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.
  • --description 또는 -d 설정 설명을 표시합니다.

예제

ibmcloud cdb deployment-configuration-schema my-redis-cache

ibmcloud cdb deployment-configuration

간략한 버전 - configuration

지정된 배치의 구성을 변경합니다.

ibmcloud cdb deployment-configuration <deployment name or CRN> [@JSON_FILE | JSON_STRING] [--output, -o FORMAT] [--nowait]

명령 옵션

  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.
  • --nowait 또는 -n 그룹 설정 태스크가 완료될 때까지 기다리지 않습니다. 스케일링 태스크의 세부사항을 표시하고 종료합니다.

예제

" PGSettings4 "라는 이름의 PostgreSQL 배포에 대한 최대 연결 수를 150으로 변경합니다.

ibmcloud cdb deployment-configuration PGSettings4 '{"configuration":{"max_connections":150}}'

스케일링

배치에 할당된 리소스를 검색하고 구성합니다.

ibmcloud cdb deployables-groups-show

각 배치는 배치 가능한 템플리트에서 작성됩니다. deployables-groups-show 명령은 특정 유형의 데이터베이스에 대한 초기 또는 기본 스케일링 그룹을 표시합니다. deployables-show 명령을 통해 유형 이름을 검색할 수 있습니다.

ibmcloud cdb deployables-groups-show <deployable type> [--output, -o FORMAT]

명령 옵션

  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

PostgreSQL 데이터베이스 배포에 대한 기본 그룹 설정을 표시합니다.

ibmcloud cdb deployables-groups-show postgresql

ibmcloud cdb deployment-groups

간략한 버전 - groups

배치 멤버에 대한 스케일링 그룹 값을 표시합니다. 스케일링 그룹은 메모리, CPU 및 디스크와 관련되어 있습니다. 기본 그룹은 "member"로 이름 지정됩니다. 각 그룹에 대해 그룹 내 노드 수가 표시되고 그 뒤에 노드 수가 표시됩니다:

  • 메모리- 총 메모리 할당량, 멤버당 할당량, 최소 할당량 및 총 메모리를 변경할 수 있는 증분 단위입니다.
  • CPU- 그룹 전용 CPU 수입니다. CPU 섹션은 전용 CPU가 구성되지 않은 경우 모든 필드에 0 값을 표시합니다. CPU 그룹은 조정 가능한 경우에만 표시됩니다.
  • 디스크- 총 디스크 할당량, 구성원당 할당량, 최소 할당량 및 총 디스크를 변경할 수 있는 증분 단위입니다.
ibmcloud cdb deployment-groups <deployment name or CRN> [--output, -o FORMAT]

명령 옵션

  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

"MyRedis" 이라는 데이터베이스 배포에 대한 스케일링 그룹 설정을 표시합니다.

ibmcloud cdb deployment-groups MyRedis

ibmcloud cdb deployment-groups-set

간략한 버전 - groups-set

스케일링 그룹에 대한 값을 설정합니다(deployment-groups 배치). 사용자는 총 메모리 크기(MB) 또는 총 디스크 스토리지(MB)를 설정할 수 있으며, 둘 다 멤버 간에 균등하게 나뉩니다. 사용 가능한 경우 할당된 CPU 수를 설정할 수도 있습니다.

ibmcloud cdb deployment-groups-set <deployment name or CRN> <memberid> [--memory <memory size>] [--disk <disk size>] [--cpu <value>] [--hostflavor <val>] [--nowait] [--output, -o FORMAT]

memberid는 이러한 값이 설정될 그룹의 이름입니다. deployment-groups 명령을 통해 이름을 찾을 수 있습니다. 일반적으로 "member"입니다.

명령 옵션

  • --memory <memory size> 또는 -m 지정된 배치 그룹의 총 메모리 값(MB)을 설정합니다.
  • --disk <disk size> 또는 -d 지정된 배치 그룹의 총 디스크 크기 값(MB)을 설정합니다.
  • --cpu <value> 또는 -c 전용 CPU 코어 수를 설정합니다.
  • --hostflavor <val> 데이터베이스의 호스팅 환경 설정: 공유 컴퓨팅의 경우 multitenant 또는 격리 컴퓨팅의 경우 개별 크기 선택 항목에서 선택합니다.
  • --nowait 또는 -n 그룹 설정 태스크가 완료될 때까지 기다리지 않습니다. 스케일링 태스크의 세부사항을 표시하고 종료합니다.
  • --output 또는 -o FORMAT 결과를 JSON으로 표시합니다.

예제

PostgreSQL "멤버" 그룹이 있는 "MyPGSQL" 배포의 총 메모리를 4096MB로 설정합니다.

ibmcloud cdb deployment-groups-set MyPGSQL member --memory 4096

지역

현재 리전에서 배포를 프로비저닝할 수 있는 모든 리전을 나열합니다.

ibmcloud cdb regions [--output, -o FORMAT] [--api-version]

명령 옵션

  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.
  • api-version value 요청에 사용된 API 버전입니다.

예제

현재 리전에서 배포를 프로비저닝할 수 있는 모든 리전의 JSON을 반환합니다.

ibmcloud cdb regions --output, -o FORMAT

자동 스케일링

Auto-Scaling 구성은 배치에 대한 Auto-Scaling을 제어하는 다양한 조건을 나타냅니다.

ibmcloud cdb deployment-autoscaling

간략한 버전 - autoscaling

특정 배치에 대한 모든 Auto-Scaling 조건을 검색합니다.

ibmcloud cdb deployment-autoscaling <deployment name or CRN> GROUP_ID [--output, -o FORMAT]

Auto-Scaling은 현재 배치에 있는 데이터 멤버에만 적용되므로 GROUP_ID는 member입니다.

명령 옵션

  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

ibmcloud cdb deployment-autoscaling elasticsearch-preproduction member

ibmcloud cdb deployment-autoscaling-set

간략한 버전 - autoscaling-set

배치의 Auto-Scaling 조건을 설정하거나 사용 또는 사용 안함으로 설정합니다.

ibmcloud cdb deployment-autoscaling-set (NAME|ID) GROUP_ID (@JSON_FILE|JSON_STRING) [--output, -o FORMAT] [--nowait]

Auto-Scaling은 현재 배치에 있는 데이터 멤버에만 적용되므로 GROUP_ID는 member입니다. 설정하거나 설정 해제하려는 Auto-Scaling 매개변수는 JSON 오브젝트에 정의됩니다.

명령 옵션

  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.
  • --nowait 또는 -n 명령이 완료될 때까지 기다리지 않습니다.

예제

이 명령은 I/O 사용률이 elasticsearch-preproduction 이라는 배포에 대해 특정 임계값에 도달하면 메모리를 자동 확장하도록 설정합니다.

ibmcloud cdb deployment-autoscaling-set elasticsearch-preproduction member '{"autoscaling": { "memory": {"scalers": {"io_utilization": {"enabled": true, "over_period": "5m","above_percent": 90}},"rate": {"increase_percent": 10.0, "period_seconds": 300,"limit_mb_per_member": 125952,"units": "mb"}}}}'

읽기 전용 복제본

읽기 전용 복제본을 검색하고 구성합니다. 현재 PostgreSQL 배치만 읽기 전용 복제본을 지원합니다.

ibmcloud cdb deployment-read-replicas

간략한 버전 - read-replicas

지정된 배치에 대한 모든 읽기 전용 복제본을 나열합니다.

ibmcloud cdb deployment-read-replicas <deployment name or CRN> [--long] [--output, -o FORMAT]

명령 옵션

  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.
  • --long 또는 -l 출력에 추가 필드를 표시합니다.

예제

"MyPGSQL" 이라는 PostgreSQL 배포에 대한 읽기 전용 복제본을 나열합니다.

ibmcloud cdb deployment-read-replicas MyPGSQL

ibmcloud cdb read-replica-leader

간략한 버전 - rr-leader

지정된 읽기 전용 복제본 배치의 리더를 리턴합니다.

ibmcloud cdb read-replica-leader <deployment name or CRN> [--long] [--output, -o FORMAT]

명령 옵션

  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.
  • --long 또는 -l 출력에 추가 필드를 표시합니다.

예제

"MyPGSQL-replica" 이라는 PostgreSQL 읽기 전용 복제본 배포의 리더를 나열합니다.

ibmcloud cdb read-replica-leader MyPGSQL-replica

ibmcloud cdb read-replica-promote

간략한 버전 - rr-promote

읽기 전용 복제본을 독립형 인스턴스로 승격합니다.

ibmcloud cdb read-replica-promote <deployment name or CRN> [--output, -o FORMAT] [--nowait] [--skip-initial-backup]

명령 옵션

  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.
  • --nowait 또는 -n 명령이 완료될 때까지 기다리지 않습니다.
  • --skip-initial-backup 또는 s 데이터가 복원되면 백업을 수행하지 않고 인스턴스를 복원하는 옵션입니다. 복원된 배치를 더 빨리 사용할 수 있습니다.

예제

"MyPGSQL-replica" 이라는 PostgreSQL 읽기 전용 복제본 배포를 독립 실행형 배포로 승격합니다.

ibmcloud cdb read-replica-promote MyPGSQL-replica

ibmcloud cdb read-replica-resync

간략한 버전 - rr-resync

읽기 전용 복제본을 재동기화합니다.

ibmcloud cdb read-replica-resync <deployment name or CRN> [--output, -o FORMAT] [--nowait]

명령 옵션

  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.
  • --nowait 또는 -n 명령이 완료될 때까지 기다리지 않습니다.

예제

"MyPGSQL-replica" 이라는 PostgreSQL 읽기 전용 복제본 배포를 다시 동기화합니다.

ibmcloud cdb read-replica-resync MyPGSQL-replica

백업

배치 시 백업을 관리하거나 On-Demand 백업을 수행합니다.

ibmcloud cdb deployment-backups-list

간략한 버전 - backups

배치와 연관된 백업의 목록을 표시합니다. 결과는 백업 ID, 유형, 상태 및 작성 날짜로 구성된 테이블입니다. 최근 백업이 먼저 표시되도록 결과가 정렬됩니다.

ibmcloud cdb deployment-backups-list <deployment name or CRN> [--scheduled] [--first] [--output, -o FORMAT]

명령 옵션

  • --scheduled 또는 -s 스케줄된 백업만 출력합니다.
  • --first 또는 -f 발견된 첫 번째(또는 가장 최근) 백업만 출력합니다.
  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

" Postgres2000 "라는 이름의 배포에서 사용 가능한 백업을 표시합니다.

ibmcloud cdb backups Postgres2000

ibmcloud cdb backup-show

백업에 대한 세부사항을 표시합니다. 백업은 deployment-backups-list 명령으로 표시된 대로 CRN ID로 식별됩니다.

ibmcloud cdb backup-show <CRN> [--output, -o FORMAT]

명령 옵션

  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

특정 백업의 세부 정보를 표시합니다.

ibmcloud cdb backup-show crn:v1:bluemix:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:ebcea542-8d8c-4b6e-a7d4-922ffd08eb50

ibmcloud cdb deployment-backup-now

간략한 버전 - backup-now

배포에 대한 온디맨드 백업을 시작합니다. 이 명령은 실행 중인 백업을 폴링하고 완료되면 종료합니다.

ibmcloud cdb deployment-backup-now <deployment name or CRN> [--nowait] [--output, -o FORMAT]

명령 옵션

  • --nowait 또는 -n 백업 태스크가 완료될 때까지 기다리지 않습니다. 백업 태스크 세부사항을 표시하고 종료합니다.
  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

"PgTips" 이라는 배포의 백업을 만듭니다.

ibmcloud cdb deployment-backup-now PgTips

보안

배치의 IP 허용 목록을 관리합니다.

ibmcloud cdb deployment-allowlist-list

간략한 버전 - wl-ls

배치에 대한 현재 허용 목록을 표시합니다.

ibmcloud cdb deployment-allowlist-list <deployment name or CRN> [--output, -o FORMAT]

명령 옵션

  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

"MyPSQL" 배포에 대한 현재 허용 목록을 나열합니다.

ibmcloud cdb deployment-whitelist-list MyPSQL

ibmcloud cdb deployment-allowlist-add

간략한 버전 - wl-add

배치의 현재 허용 목록에 IP 주소 또는 범위를 추가합니다. IP 주소는 IPv4 또는 IPv6 주소이며 범위는 마스킹된 IPv4 주소(예: 1.2.3.0/24)입니다. 설명은 허용 목록에 있는 주소 또는 범위를 설명하는 사람이 읽을 수 있는 문자열이어야 합니다.

ibmcloud cdb deployment-allowlist-add <deployment name or CRN> <allowlist address or range> <description> [--nowait] [--output, -o FORMAT]

명령 옵션

  • --nowait 또는 -n 허용 목록 추가 태스크가 완료될 때까지 기다리지 않습니다. 허용 목록 추가 태스크 세부사항을 표시하고 종료합니다.
  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

"MyPSQL" 배포에 대한 현재 허용 목록에 IP 주소 198.51.100.1 를 추가합니다.

ibmcloud cdb deployment-whitelist-add MyPSQL 198.51.100.1 "allowlisted for testing"

"MyPSQL" 배포에 대한 현재 허용 목록에 198.51.100.0 ~ 198.51.100.255 IP 범위를 추가합니다.

ibmcloud cdb deployment-whitelist-add MyPSQL 198.51.100.0/24 "Testing range is now open"

ibmcloud cdb deployment-allowlist-delete

간략한 버전 - wl-del

배치의 현재 허용 목록에서 IP 주소 또는 범위를 제거합니다. IP 주소는 IPv4 또는 IPv6 주소이며 범위는 마스킹된 IPv4 주소(예: 1.2.3.0/24)입니다.

ibmcloud cdb deployment-allowlist-delete <deployment name or CRN> <allowlist address or range> [--nowait] [--output, -o FORMAT]

명령 옵션

  • --nowait 또는 -n 허용 목록 삭제 태스크가 완료될 때까지 기다리지 않습니다. 허용 목록 삭제 태스크 세부사항을 표시하고 종료합니다.
  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

"MyPSQL" 배포에 대한 현재 허용 목록에서 IP 주소 198.51.100.1 를 제거합니다.

ibmcloud cdb deployment-whitelist-delete MyPSQL 198.51.100.1 "allowlisted for testing"

"MyPSQL" 배포에 대한 현재 허용 목록에서 198.51.100.0 ~ 198.51.100.255 IP 범위를 제거합니다.

ibmcloud cdb deployment-whitelist-delete MyPSQL 198.51.100.0/24 "Testing range is now open"

태스크

배치에 대한 조치를 수행할 때마다 태스크가 작성됩니다. 태스크에는 백업 작성, 그룹 스케일링 및 사용자 비밀번호 변경 등이 포함됩니다. 대부분의 cdb 명령은 실행 중인 태스크를 폴링하고 완료되면 종료합니다. 태스크 정보를 리턴하고 종료하는 --nowait 플래그를 사용하여 이 작동을 변경할 수 있습니다. 성공적인 태스크의 레코드는 24 - 48시간 동안 표시되고 실패한 태스크는 7 - 8일 동안 표시됩니다. Activity Tracker 통합을 통해 모든 기간의 태스크 기록을 사용할 수 있습니다.

ibmcloud cdb deployment-tasks-list

간략한 버전 - tasks

지정된 배치가 작성된 후 해당 배치에서 실행된 모든 태스크의 목록을 표시합니다. 각 태스크는 CRN, 읽을 수 있는 설명, 완료율, 상태 및 작성 날짜와 함께 표시됩니다.

ibmcloud cdb deployment-tasks-list <deployment name or CRN> [--output, -o FORMAT]

명령 옵션

  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

"NewRedis" 이라는 배포에 대해 실행된 작업 목록을 표시합니다.

ibmcloud cdb deployment-tasks-list NewRedis

ibmcloud cdb task-show

간략한 버전 - task

특정 태스크의 상태를 표시합니다. 태스크는 deployment-tasks-list 명령으로 표시된 대로 CRN ID로 식별됩니다. 태스크가 실행 중인 경우, 이 명령은 태스크가 완료될 때까지 기다리고 정기적으로 폴링하면서 상태 변경사항을 보고합니다.

ibmcloud cdb task-show <CRN> [--nowait] [--output, -o FORMAT]

명령 옵션

  • --nowait 또는 -n 태스크가 완료될 때까지 기다리지 않습니다. 사용자 비밀번호 변경 태스크 세부사항을 표시하고 종료합니다.
  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

특정 백업 작업의 세부 정보를 표시합니다.

ibmcloud cdb task-show crn:v1:bluemix:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:task:0faea465-de5a-4f14-a5ff-b402fefbd652

Elasticsearch

Elasticsearch 배치에 특정한 태스크를 수행합니다.

ibmcloud cdb elasticsearch file-sync

간략한 버전 - fs

ibm_file_sync 색인에서 디스크로 파일을 동기화합니다. 자세한 정보는 Elasticsearch에 파일 업로드 문서를 참조하십시오.

ibmcloud cdb elasticsearch file-sync <deployment name or CRN> [--output, -o FORMAT] [--nowait]

명령 옵션

  • --nowait 또는 -n 그룹 설정 태스크가 완료될 때까지 기다리지 않습니다. 스케일링 태스크의 세부사항을 표시하고 종료합니다.
  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

"MyElasticsearch" 이라는 배포의 디스크에 파일을 동기화합니다.

ibmcloud cdb elasticsearch file-sync MyElasticsearch

ibmcloud cdb elasticsearch user-list

간략한 버전 - ul

데이터베이스 내부 자격증명 저장소의 모든 사용자를 나열합니다. 자세한 내용은 사용자 비밀번호 검색 및 업데이트를 참조하세요.

ibmcloud cdb elasticsearch user-list (NAME|ID) (ADMIN_PASSWORD) [--output, -o FORMAT] [-c DIRECTORY] [--api-version]

명령 옵션

  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.
  • -c DIRECTORY 인증서 루트
  • --api-version 요청에 사용된 API 버전입니다.

예제

user-list 명령은 계정의 사용자 목록에 대한 다양한 옵션을 출력합니다.

ibmcloud cdb elasticsearch user-list

PostgreSQL

PostgreSQL 배치에 특정한 태스크를 수행합니다.

ibmcloud cdb postgresql earliest-pitr-timestamp

간략한 버전 - ept

특정 시점 복구에 사용할 수 있는 가장 빠른 시간을 ISO8601 UTC 형식으로 리턴합니다. 자세한 정보는 특정 시점 복구 문서를 참조하십시오.

ibmcloud cdb postgresql earliest-pitr-timestamp <deployment name or CRN> [--output, -o FORMAT] [--nowait]

명령 옵션

  • --nowait 또는 -n 그룹 설정 태스크가 완료될 때까지 기다리지 않습니다. 스케일링 태스크의 세부사항을 표시하고 종료합니다.
  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

ibmcloud cdb postgresql earliest-pitr-timestamp postgresql-preproduction

ibmcloud cdb postgresql replication-slot-create

간략한 버전 - rsc

새 PostgreSQL 복제 슬롯을 작성합니다. 자세한 정보는 Wal2json 문서를 참조하십시오.

ibmcloud cdb postgresql replication-slot-create <deployment name or CRN> <databasename> <slotname> <plugintype> [--output, -o FORMAT] [--nowait]

플러그인 유형은 "wal2json"이어야 합니다.

명령 옵션

  • --nowait 또는 -n 그룹 설정 태스크가 완료될 때까지 기다리지 않습니다. 스케일링 태스크의 세부사항을 표시하고 종료합니다.
  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

배포에 "MyPostgres", 라는 이름의 복제 슬롯을 만들고 데이터베이스 이름은 "testdb", 슬롯 이름은 " slot1 "로 지정합니다.

ibmcloud cdb postgresql replication-slot-create MyPostgres testdb slot1 wal2json

ibmcloud cdb postgresql replication-slot-delete

간략한 버전 - rsd

지정된 PostgreSQL 복제 슬롯을 삭제합니다. 자세한 정보는 Wal2json 문서를 참조하십시오.

ibmcloud cdb postgresql replication-slot-delete <deployment name or CRN> <slotname> [--output, -o FORMAT] [--nowait]

명령 옵션

  • --nowait 또는 -n 그룹 설정 태스크가 완료될 때까지 기다리지 않습니다. 스케일링 태스크의 세부사항을 표시하고 종료합니다.
  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.

예제

배포에서 "MyPostgres" 라는 이름의 복제 슬롯과 " slot1 " 라는 이름의 슬롯을 삭제합니다.

ibmcloud cdb postgresql replication-slot-delete MyPostgres slot1

MongoDB 엔터프라이즈

MongoDB 엔터프라이즈 배포와 관련된 작업을 수행합니다.

ibmcloud cdb mongodbee earliest-pitr-timestamp

간략한 버전 - ept

특정 시점 복구에 사용할 수 있는 가장 빠른 시간을 ISO8601 UTC 형식으로 리턴합니다. 자세한 내용은 시점 복구를 참조하세요.

ibmcloud cdb mongodb-enterprise earliest-pitr-timestamp <deployment name or CRN> [--output, -o FORMAT] [--nowait]

명령 옵션

  • --nowait 또는 -n 그룹 설정 태스크가 완료될 때까지 기다리지 않습니다. 스케일링 태스크의 세부사항을 표시하고 종료합니다.
  • --output 또는 -o 형식 출력 형식을 지정합니다. JSON만 지원됩니다.
  • api-version value 요청에 사용된 API 버전입니다.

예제

ibmcloud cdb mongodb earliest-pitr-timestamp (NAME|ID)

Redis

Redis 배포와 관련된 작업을 수행합니다.

ibmcloud cdb redis user-set

Redis 사용자의 역할을 편집합니다. 자세한 내용은 Redis RBAC 관리하기를 참조하세요.

ibmcloud cdb redis user-set <"roles">

예제

ibmcloud cdb redis user-set "-all +@read"