소프트웨어 정의 스토리지

software-defined-storage- IBM Cloud 플랫폼의 IBM Storage Ceph as a Service CLI에 대한 OpenAPI 정의입니다.

ibmcloud software-defined-storage [command] [options]

software-defined-storage 의 별칭: sds

ibmcloud sds volume-create

이 명령을 사용하여 지정된 용량의 새 볼륨을 생성하십시오.

ibmcloud sds volume-create --capacity CAPACITY [--name NAME] [--source-snapshot (SOURCE-SNAPSHOT | @SOURCE-SNAPSHOT-FILE) | --source-snapshot-id SOURCE-SNAPSHOT-ID]

volume-create 의 별칭: volc

예시: 새 볼륨 만들기

ibmcloud sds volume-create \
    --capacity 10 \
    --name my-volume \
    --url $sds_endpoint

예: 스냅샷을 사용하여 볼륨 복원하기

ibmcloud sds volume-create \
    --name test-volume-restored \
    --source-snapshot-id r134-eda57df4-41f2-48d8-812d-3d81955b6a1a \
    --capacity 10 \
    --url $sds_endpoint

스냅샷에서 볼륨을 복원할 때는 용량이 원본 볼륨의 용량과 같거나 더 커야 합니다.

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 볼륨의 용량 (기가바이트 단위).

  • 플래그: --capacity CAPACITY

• 볼륨의 이름입니다.

  • 플래그: --name NAME

  새 볼륨의 이름을 지정하지 않으면 시스템에서 무작위로 선택된 단어의 하이픈으로 연결된 목록인 이름을 생성합니다.

• URL 형식의 API 엔드포인트.

  • 플래그: --url string

• 이 볼륨이 생성된 소스 스냅샷입니다.

  • 플래그: --source-snapshot

  스냅샷에서 볼륨을 만드는 경우 이 옵션을 사용합니다.

• 리소스의 고유 스냅샷 식별자입니다.

  • 플래그: --source-snapshot-id

  스냅샷에서 볼륨을 만드는 경우 이 옵션을 사용합니다.

ibmcloud sds volume

이 명령을 사용하여 단일 볼륨에 대한 세부 정보를 조회하십시오.

ibmcloud sds volume --volume-id VOLUME-ID --url string

volume 의 별칭: vol

명령 예제:

ibmcloud sds volume \
    --volume-id r134-f24710c4-d5f4-4881-ab78-7bfXX6281f39 \
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 볼륨 식별자입니다.

  • 플래그: --volume-id VOLUME-ID

• URL 형식의 API 엔드포인트.

  • 플래그: --url string

ibmcloud sds volume-update

이 명령을 볼륨 패치 매개변수에 제공된 새로운 정보와 함께 사용하여 볼륨 용량이나 볼륨 이름을 업데이트하십시오.

명령에서 한 번에 하나의 매개변수 값만 변경할 수 있습니다. 동일한 명령어에 대해 두 번 이상의 변경은 지원되지 않습니다.

ibmcloud sds volume-update --volume-id VOLUME-ID [--volume-patch VOLUME-PATCH | @VOLUME-PATCH-FILE] --url string

volume-update 의 별칭: volu

명령 예제:

ibmcloud sds volume-update \
    --volume-id r134-f24710c4-d5f4-4881-ab78-7bfXX6281f39 \
    --capacity 38 \
    --name my-volume-updated \
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 볼륨 식별자입니다.

  • 플래그:--volume-id VOLUME-ID

• 볼륨의 용량 (기가바이트 단위).

  • 플래그: --capacity CAPACITY

• 볼륨의 이름입니다.

  • 플래그: --name NAME

• JSON 파일의 경로와 같은 볼륨 정보를 포함하는 [선택적] JSON 객체입니다.

  • 플래그: --volume-patch VOLUME-PATCH

• URL 형식의 API 엔드포인트.

  • 플래그: --url string

ibmcloud sds volume-delete

이 명령을 사용하여 단일 볼륨을 삭제하십시오.

ibmcloud sds volume-delete --volume-id VOLUME-ID --url string

volume-delete 의 별칭: vold

명령 예제:

ibmcloud sds volume-delete \
    --volume-id r134-f24710c4-d5f4-4881-ab78-7bfXX6281f39 \
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 볼륨 식별자입니다.

  • 플래그:--volume-id VOLUME-ID

• URL 형식의 API 엔드포인트.

  • 플래그: --url string

ibmcloud sds volumes

이 명령을 사용하여 모든 볼륨을 나열할 수 있습니다.

ibmcloud sds volumes --help [--limit LIMIT] [--name NAME] --url string

volumes 의 별칭: vols

명령 예제:

ibmcloud sds volumes --help \
    --limit 10 \
    --name my-volume \
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 한 페이지에서 반환할 리소스의 수. 기본값은 1입니다. 최대 한계값은 1000입니다.

  • 플래그: --limit int

• 리소스 컬렉션에서 이름으로 필터링합니다. 문자열 길이는 0~200자를 지정할 수 있습니다.

  • 플래그: --name string

ibmcloud sds host-create

이 명령어를 사용하여 새 호스트를 생성하십시오.

ibmcloud sds host-create --name NAME --nqn NQN [--volume-mappings VOLUME-MAPPINGS | @VOLUME-MAPPINGS-FILE] --url string --psk string

host-create 의 별칭: hstc

명령 예제:

ibmcloud sds host-create \
    --name my-host \
    --nqn nqn.2014-06.org:9345 \
    --volume-mappings '[{"volume": {"id": "1a6b7274-678d-4dfb-8981-c71dd9d4daa5"}}]' \
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 고객의 환경에 구성된 호스트의 NVMe Qualified Name(NQN). 지원되는 최대 길이는 223바이트입니다.

  • 플래그: --nqn NQN

• 새 호스트의 이름입니다. 새 이름이 중복되지 않도록 하십시오.

  • 플래그: --name NAME

  새 호스트의 이름을 지정하지 않으면, 시스템이 임의로 선택한 단어의 하이픈 목록으로 된 이름을 생성합니다.

• 새 호스트를 위한 PSK. TLS(Transport Layer Security) 사전 공유 키(PSK) 암호 모음( TLS-PSK)은 사전 공유 키(PSK)를 기반으로 안전한 통신을 제공하는 일련의 암호화 프로토콜입니다.

  • 플래그: --psk string

• 이 호스트에 매핑할 볼륨의 고유 식별자입니다. [{"volume": {"id": "1a6b7274-678d-4dfb-8981-c71dd9d4daa5"}}] 의 형식이어야 합니다.

  • 플래그: --volume-mappings VOLUME-MAPPINGS

• URL 형식의 API 엔드포인트.

  • 플래그: --url string

ibmcloud sds host

이 명령어를 사용하여 단일 호스트에 대한 세부 정보를 조회하십시오.

ibmcloud sds host --host-id HOST-ID --url string

명령 예제:

ibmcloud sds host \
    --host-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 세부 정보를 보려는 호스트 ID

  • 플래그: --host-id HOST-ID

• URL 형식의 API 엔드포인트.

  • 플래그: --url string

ibmcloud sds hosts

이 명령어를 사용하여 모든 호스트를 나열하십시오.

ibmcloud sds hosts [--limit LIMIT] --url string

hosts 의 별칭: hsts

명령 예제:

ibmcloud sds hosts \
    --limit 10 \
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 한 페이지에 반환할 리소스의 수.

  • 플래그: --limit LIMIT

• 이 옵션을 포함하면 이름별로 자료 모음을 필터링할 수 있습니다.

  • 플래그: --name NAME

• URL 형식의 API 엔드포인트.

  • 플래그: --url string

ibmcloud sds host-update

호스트를 업데이트하려면 이 명령을 사용하십시오.

ibmcloud sds host-update --host-id HOST-ID [--host-patch HOST-PATCH | @HOST-PATCH-FILE] --url string

host-update 의 별칭: hstu

명령 예제:

ibmcloud sds host-update \
    --host-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --name my-host
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 세부 정보를 업데이트하려는 호스트 ID

  • 플래그: --host-id HOST-ID

• [선택 사항] JSON Merge-Patch 콘텐츠의 host_update 를 지정합니다.

  • 플래그: --host-patch HOST-PATCH

• 새 호스트의 이름입니다. 새 이름이 중복되지 않도록 하십시오.

  • 플래그: --name NAME

  새 호스트의 이름을 지정하지 않으면, 시스템이 임의로 선택한 단어의 하이픈 목록으로 이루어진 이름을 생성합니다.

• URL 형식의 API 엔드포인트.

  • 플래그: --url string

ibmcloud sds host-mapping-create

이 명령을 사용하여 볼륨을 호스트에 매핑하십시오.

ibmcloud sds host-mapping-create --host-id HOST-ID [--volume (VOLUME | @VOLUME-FILE) | --volume-id VOLUME-ID]

host-mapping-create 의 별칭: hstmc

명령 예제:

ibmcloud sds host-mapping-create \
    --host-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --volume '{"id": "r134-f24710c4-d5f4-4881-ab78-7bfXX6281f39"}' \
    --url $sds_endpoint

또는

ibmcloud sds host-mapping-create \
    --host-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --volume-id r134-f24710c4-d5f4-4881-ab78-7bfXX6281f39 \
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 세부 정보를 보려는 호스트 ID를 지정합니다

  • 플래그: --host-id HOST-ID

• 고유 볼륨 식별자를 지정합니다.

  • 플래그: --volume-id VOLUME-ID

• 이 호스트에 매핑할 볼륨의 고유 식별자입니다. [{"volume": {"id": "1a6b7274-678d-4dfb-8981-c71dd9d4daa5"}}] 의 형식이어야 합니다.

  • 플래그: --volume VOLUME-ID

• URL 형식의 API 엔드포인트.

  • 플래그: --url string

ibmcloud sds host-mappings

이 명령어를 사용하면 특정 호스트에 대한 모든 호스트 매핑을 확인할 수 있습니다.

ibmcloud sds host-mappings --host-id HOST-ID

host-mappings 의 별칭: hstms

명령 예제:

ibmcloud sds host-mappings \
    --host-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 세부 정보를 보려는 호스트 ID

  • 플래그: --host-id HOST-ID

• URL 형식의 API 엔드포인트.

  • 플래그: --url string

ibmcloud sds host-mapping

이 명령을 사용하여 특정 호스트에 대한 단일 호스트 매핑을 확인하십시오.

ibmcloud sds host-mapping --host-id HOST-ID --volume-mapping-id VOLUME-MAPPING-ID

host-mapping 의 별칭: hstm

명령 예제:

ibmcloud sds host-mapping \
    --host-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --volume-mapping-id r134-f24710c4-d5f4-4881-ab78-7bfXX6281f39 \
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 세부 정보를 보려는 호스트 ID

  • 플래그: --host-id HOST-ID

• 독특한 볼륨 매핑 식별자. 이 ID는 이 작업을 완료하려는 관련 볼륨 또는 호스트를 확인하여 찾을 수 있습니다.

  • 플래그: --volume-mapping-id VOLUME-MAPPING_ID

• URL 형식의 API 엔드포인트.

  • 플래그: --url string

ibmcloud sds host-delete

호스트를 삭제하려면 이 명령을 사용하십시오.

ibmcloud sds host-delete --host-id HOST-ID --url string

host-delete 의 별칭: hstd

명령 예제:

ibmcloud sds host-delete \
    --host-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 세부 정보를 보려는 호스트 ID

  • 플래그: --host-id HOST-ID

• URL 형식의 API 엔드포인트.

  • 플래그: --url string

ibmcloud sds host-mapping-delete

호스트에서 단일 볼륨 매핑을 삭제하려면 이 명령을 사용하십시오.

ibmcloud sds host-mapping-delete --host-id HOST-ID --volume-mapping-id VOLUME-MAPPING-ID

host-mapping-delete 의 별칭: hstmd

명령 예제:

ibmcloud sds host-mapping-delete \
    --host-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --volume-mapping-id r134-f24710c4-d5f4-4881-ab78-7bfXX6281f39 \
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 세부 정보를 보려는 호스트 ID

  • 플래그: --host-id HOST-ID

• 독특한 볼륨 매핑 식별자. 이 ID는 이 작업을 완료하려는 관련 볼륨 또는 호스트를 확인하여 찾을 수 있습니다.

  • 플래그: --volume-mapping-id VOLUME-MAPPING_ID

• URL 형식의 API 엔드포인트.

  • 플래그: --url string

ibmcloud sds host-mapping-delete-all

이 명령을 사용하여 호스트와 연결된 모든 볼륨 매핑을 삭제하십시오.

ibmcloud sds host-mapping-delete-all --host-id HOST-ID

host-vol-delete-all 의 별칭: hstmda

명령 예제:

ibmcloud sds host-mapping-delete-all \
    --host-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 세부 정보를 보려는 호스트 ID

  • 플래그: --host-id HOST-ID

• URL 형식의 API 엔드포인트.

  • 플래그: --url string

ibmcloud sds cred-create

이 명령어를 사용하여 스토리지 계정의 자격 증명을 업데이트하거나, 자격 증명이 없는 경우 새로 생성하십시오.

ibmcloud sds cred-create --access-key ACCESS-KEY --url string

cred-create 의 별칭: crc

명령 예제:

ibmcloud sds cred-create \
    --access-key mytestkey
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 서비스 인스턴스에 대한 액세스 키를 설정합니다.

  • 플래그: --access-key ACCESS-KEY

• URL 형식의 API 엔드포인트.

  • 플래그: --url string

ibmcloud sds cred-delete

서비스 자격 증명을 삭제하려면 이 명령을 사용하십시오.

ibmcloud sds cred-delete --access-key ACCESS-KEY --url string

cred-delete 의 별칭: crd

명령 예제:

ibmcloud sds cred-delete \
    --access-key mytestkey
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 서비스 인스턴스에 대한 액세스 키를 설정합니다.

  • 플래그: --access-key ACCESS-KEY

• URL 형식의 API 엔드포인트.

  • 플래그: --url string

ibmcloud sds creds

이 명령어를 사용하여 특정 스토리지 계정의 자격 증명을 가져옵니다.

ibmcloud sds creds --url string

creds 의 별칭: crl

명령 예제:

ibmcloud sds creds \
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• URL 형식의 API 엔드포인트.
  • 플래그: --url string

ibmcloud sds cert-types

이 명령을 사용하여 구성된 ‘ SSL ’ 인증서 유형 목록을 확인하십시오.

ibmcloud sds cert-types --url string

cert-types 의 별칭: crtt

명령 예제:

ibmcloud sds cert-types \
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• URL 형식의 API 엔드포인트.
  • 플래그: --url string

ibmcloud sds cert-create

SSL 인증서가 없는 경우, 이 명령을 사용하여 새 인증서를 생성하십시오.

ibmcloud sds cert-create --cert CERT --body BODY --url string

cert-create 의 별칭: crtc

명령 예제:

ibmcloud sds cert-create \
    --cert s3 \
    --body tempdir/test-file.txt \
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• TLS 인증서가 포함된 요청 본문. CLI는 .pem 형식의 인증서 파일을 받아들입니다.

  • 플래그: --body BODY

• 요청에 사용할 인증서 유형입니다. 허용되는 값은 - s3 입니다.

  • 플래그: --cert CERT

• URL 형식의 API 엔드포인트.

  • 플래그: --url string

ibmcloud sds cert-update

이 명령어를 사용하여 기존 SSL 인증서를 업데이트하십시오.

ibmcloud sds cert-update --cert CERT --body BODY --url string

cert-update 의 별칭: crtu

명령 예제:

ibmcloud sds cert-update \
    --cert s3 \
    --body tempdir/test-file.pem \
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• TLS 인증서가 포함된 요청 본문. CLI는 .pem 형식의 인증서 파일을 받아들입니다.

  • 플래그: --body BODY

• 요청에 사용할 인증서 유형입니다. 허용되는 값은 - s3 입니다.

  • 플래그: --cert CERT

• URL 형식의 API 엔드포인트.

  • 플래그: --url string

ibmcloud sds cert

이 명령어를 사용하여 ‘ SSL ’ 인증서의 만료일과 상태를 확인하십시오.

ibmcloud sds cert --cert CERT --url string

명령 예제:

ibmcloud sds cert \
    --cert s3
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 요청에 사용할 인증서 유형입니다. 허용되는 값은 - s3 입니다.

  • 플래그: --cert CERT

• URL 형식의 API 엔드포인트.

  • 플래그: --url string

ibmcloud sds cert-delete

SSL 인증서를 삭제하려면 이 명령을 사용하십시오.

ibmcloud sds cert-delete --cert CERT --url string

cert-delete 의 별칭: crtd

명령 예제:

ibmcloud sds cert-delete \
    --cert s3
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 요청에 사용할 인증서 유형입니다. 허용되는 값은 - s3 입니다.

  • 플래그: --cert CERT

• URL 형식의 API 엔드포인트.

  • 플래그: --url string

ibmcloud sds volume-snapshot-create

이 명령어를 사용하여 볼륨의 스냅샷을 생성하십시오.

ibmcloud sds volume-snapshot-create [--source-volume (SOURCE-VOLUME | @SOURCE-VOLUME-FILE) | --source-volume-id SOURCE-VOLUME-ID] [--name NAME]

volume-snapshot-create 의 별칭: vsnapc

명령 예제:

ic sds volume-snapshot-create --source-volume-id r134-87a59338-a801-4090-a657-72867fc9ba44

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 새 스냅샷을 생성해야 하는 블록 볼륨 ID입니다.

  • 플래그: --source-volume-id

• 스냅샷의 고유한 이름. 선택적 매개변수입니다.

  • 플래그: --name

ibmcloud sds volume-snapshot

이 명령어를 사용하여 단일 스냅샷에 대한 세부 정보를 조회할 수 있습니다.

ibmcloud sds volume-snapshot --snap-id SNAP-ID

volume-snapshot 의 별칭: vsnap

명령 예제:

ibmcloud sds volume-snapshot \
    --snap-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 세부 정보를 검색할 스냅샷 식별자입니다.
  • 플래그: --snap-id

ibmcloud sds volume-snapshots

이 명령어를 사용하여 모든 스냅샷을 나열하십시오.

ibmcloud sds volume-snapshots [--start START] [--limit LIMIT] [--name NAME] [--source-volume-id SOURCE-VOLUME-ID]

volume-snapshots 의 별칭: vsnaps

명령 예제:

ibmcloud sds volume-snapshots \
    --start r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --limit 20 \
    --name my-host \
    --source-volume-id exampleString \
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

다음 매개변수는 선택사항입니다.

• 결과 페이지를 시작할 리소스 ID를 지정합니다. 대규모 컬렉션을 페이지 매김하는 데 유용합니다.

  • 플래그: --start

• 페이지당 반환할 리소스(스냅샷)의 최대 개수를 설정합니다.

  • 플래그: --limit

• 제공된 문자열과 이름이 일치하는 스냅샷만 포함하도록 결과를 필터링합니다.

  • 플래그: --name

• 지정된 소스 볼륨 ID에 속하는 스냅샷만 포함하도록 결과를 필터링합니다.

  • 플래그: source-volume-id

• 볼륨 스냅샷을 나열할 때 이 옵션은 자동으로 여러 요청을 수행하여 결과의 모든 페이지를 검색하고 표시하므로 결과를 수동으로 페이징하지 않고도 전체 컬렉션을 볼 수 있습니다.

  • 플래그: all-pages

ibmcloud sds volume-snapshot-update

스냅샷을 업데이트하려면 이 명령어를 사용하십시오.

ibmcloud sds volume-snapshot-update --snap-id SNAP-ID [--snapshot-patch SNAPSHOT-PATCH | @SNAPSHOT-PATCH-FILE]

volume-snapshot-update 의 별칭: vsnapu

명령 예제:

ibmcloud sds volume-snapshot-update \
    --snap-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --name snap-2-updated \
    --url $sds_endpoint

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• (필수) 업데이트하려는 스냅샷의 고유 식별자입니다.

  • 플래그: --snap-id

• 업데이트해야 하는 스냅샷 이름을 지정합니다.

  • 플래그: --name

• 스냅샷을 업데이트하기 위한 JSON Merge-Patch 콘텐츠를 제공합니다. 이 값은 명령에 직접 JSON 문자열을 입력하거나 패치 데이터가 포함된 JSON 파일의 경로를 입력할 수 있습니다. 이를 통해 스냅샷의 특정 필드를 업데이트할 수 있습니다.

  • 플래그: --snapshot-patch

ibmcloud sds volume-snapshot-delete

이 명령어를 사용하여 단일 스냅샷을 삭제하십시오.

ibmcloud sds volume-snapshot-delete --snap-id SNAP-ID

volume-snapshot-delete 의 별칭: vsnapd

명령 예제:

ibmcloud sds volume-snapshot-delete \
    --snap-id r134-76a4e08c-aa22-4fd3-9eb5-5cae0e78a285 \
    --url $sds_endpoint
Are you sure you want to delete? [y/n]> y
...
OK

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 명령이 실행되도록 강제하려면

  • 플래그: -f, --force

• 삭제하려는 스냅샷의 고유 식별자입니다.

  • 플래그: --snap-id

ibmcloud sds volume-snapshots-delete

이 명령어를 사용하여 볼륨에 대한 모든 스냅샷을 삭제하십시오.

ibmcloud sds volume-snapshots-delete [--source-volume-id SOURCE-VOLUME-ID]

volume-snapshots-delete 의 별칭: vsnapsd

명령 예제:

ibmcloud sds volume-snapshots-delete \
    --source-volume-id r134-76a4e08c-aa22-4fd3-9eb5-5cae0e78a285 \
    --url $sds_endpoint
Are you sure you want to delete? [y/n]> y
...
OK

$sds_endpoint 은 IBM Storage Ceph as a Service 을 구성할 때 제공된 엔드포인트를 가리키는 환경 변수입니다. URL 의 형태입니다. 예를 들어, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1입니다. URL 를 한 번 설정해 놓으면, 모든 명령어에 대해 추가할 필요가 없습니다. URL 를 설정하는 방법에 대한 지침은 Config 명령을 참조하십시오.

제공할 매개변수:

• 명령이 실행되도록 강제하려면

  • 플래그: -f, --force

• 지정된 식별자와 일치하는 source_volume-id 속성이 있는 리소스(예: 스냅샷)에만 영향을 주도록 작업을 필터링합니다. 특정 볼륨의 모든 스냅샷을 대상으로 지정하는 데 사용됩니다.

  • 플래그: --source-volume-id

설정 명령 옵션

• get- 옵션의 현재 설정된 값을 가져옵니다.

• list- 현재 설정된 모든 구성 값을 가져옵니다.

• set- 옵션에 대한 구성 값을 설정합니다.

• unset- 옵션의 구성 값을 초기화합니다.

ibmcloud sds config get

이 명령어를 사용하면 특정 옵션에 대해 현재 설정된 값을 확인할 수 있습니다.

Get 옵션을 url 옵션과 함께 사용하면, 'url' 옵션에 현재 설정된 값이 검색됩니다.

ibmcloud sds config get url

출력 예제를 확인하세요.

pc@mac ~ % ibmcloud sds config get url
http://sds-endpoint.satellite.cloud.ibm.com:33189/v1

ibmcloud sds config list

이 명령어를 사용하여 현재 설정된 모든 구성 값을 가져와 확인하십시오.

ibmcloud sds config list

출력 예제를 확인하세요.

pc@mac ~ % ibmcloud sds config list
url
http://sds-endpoint.satellite.cloud.ibm.com:33189/v1

ibmcloud sds config set

특정 옵션에 대한 새 값을 설정하려면 이 명령을 사용하십시오.

ibmcloud sds config set [url]

set 옵션을 url 옵션과 함께 사용하면 'url'옵션의 값이 설정됩니다.

url 옵션을 사용한 예제를 참조하십시오.

pc@mac ~ % ibmcloud sds config set url http://sds-endpoint.satellite.cloud.ibm.com:33189/v1

ibmcloud sds config unset

이 명령을 사용하여 특정 옵션에 대해 현재 설정된 값을 초기화하십시오.

ibmcloud sds config unset [url]

unset 옵션이 url 옵션과 함께 사용될 때, 'url' 옵션에 현재 설정된 값이 재설정됩니다.