시작하기 전에

CLI를 사용하려면 먼저 IBM Cloud CLI 및 VPC CLI 플러그인을 설치해야 합니다. 자세한 정보는 CLI 전제조건을 참조하십시오.

IBM Cloud® 에 로그인하세요.

ibmcloud login --sso -a cloud.ibm.com

이 명령은 URL을 리턴하고 비밀번호를 입력하라는 프롬프트를 표시합니다. 브라우저의 해당 URL로 이동하여 로그인하십시오. 성공하면 일회성 비밀번호를 얻게 됩니다. 이 비밀번호를 복사하여 메시지에 응답으로 붙여넣습니다. 인증에 성공하면 계정을 선택하라는 메시지가 표시됩니다. 여러 계정을 사용할 수 있는 경우, 로그인할 계정을 선택하세요. 나머지 프롬프트에 응답하여 로그인을 완료하십시오.

시작하기 전에 다음 정보를 수집하세요:

• 스냅샷의 고유한 이름. 공유 스냅샷 이름은 공유 수준에서 고유해야 합니다. 스냅샷의 이름을 지정하는 방법에 대한 제안사항은 스냅샷 이름 지정을 참조하십시오.
• 소스 공유의 이름 또는 ID입니다.
• 스냅샷에 첨부하려는 모든 태그입니다.

다음 CLI 명령을 사용하여 필요한 정보를 수집하세요.

• ibmcloud is shares- 이 명령은 선택한 지역에서 사용 가능한 모든 공유를 나열합니다. 목록에서 공유를 찾아 상태를 확인합니다( available ).
• ibmcloud is share SHARE_ID- 이 명령을 이전 명령의 출력에 있는 공유 ID와 함께 사용하여 공유의 세부 정보를 검토합니다. 출력에 공유가 사용 가능하고 인스턴스에 연결되어 있으며 사용 중이 아닌 것으로 표시되면 스냅샷을 만들 수 있습니다.

API로 스냅샷을 만들기 위한 전제 조건

VPC API를 호출하여 스냅샷을 작성할 수 있습니다. 시작하기 전에 다음 정보를 수집하세요:

• 스냅샷의 고유한 이름. 공유 스냅샷 이름은 공유 수준에서 고유해야 합니다. 스냅샷의 이름을 지정하는 방법에 대한 제안사항은 스냅샷 이름 지정을 참조하십시오.
• 소스 공유의 ID입니다.
• 스냅샷에 첨부하려는 모든 태그입니다.

API를 사용하여 스냅샷 생성하기

shares/{share-id}/snapshots API 메서드를 호출하여 프로그래밍 방식으로 파일 공유의 스냅샷을 만들 수 있습니다. 다음 예에서는 공유 ID를 사용하여 공유의 스냅샷을 만들고 백업 정책과 연결할 수 있는 사용자 태그를 지정합니다.

curl -X POST \
"$vpc_api_endpoint/v1/shares/{share-id}/snapshots?version=2024-12-10&generation=2" \
-H "Authorization: Bearer $iam_token"
-d '{
  "name": "my-first-share-snapshot",
  "user_tags": [
    "env:test"
  ]
}'

성공적인 응답은 다음 예제와 유사합니다. 스냅샷이 작성되는 동안 스냅샷 라이프사이클 상태는 pending입니다. 생성이 성공적으로 완료되면 상태가 ‘ stable ’로 변경됩니다.

{
  "captured_at": "2024-12-10T01:21:12.000Z",
  "created_at": "2024-12-10T01:59:46.000Z",
  "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::share-snapshot:r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
  "fingerprint": "7abc3aef-c2bc-4f65-a296-2928e534d498",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
  "id": "r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
  "lifecycle_state": "pending",
  "minimum_size": 10,
  "name": "my-first-share-snapshot",
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345",
    "id": "fee82deba12e4c0fb69c3b09d1f12345",
    "name": "Default"
  },
  "resource_type": "share_snapshot",
  "status": "available",
  "status_reasons": [],
  "user_tags": [],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

지역별 파일 공유의 스냅샷의 경우, 영역 값은 CLI와 API 응답 모두에서 공백으로 표시됩니다.