File Storage for VPC 스냅샷 보기
콘솔, CLI, API 또는 Terraform을 통해 File Storage for VPC 스냅샷 목록과 세부 정보를 확인하세요. 스냅샷 수, 크기, 상태 및 복제 역할 등의 정보에 액세스합니다.
콘솔에 스냅샷 나열하기
콘솔에서 공유의 상세정보 페이지에서 파일 공유에 속한 모든 스냅샷의 목록을 볼 수 있습니다.
-
IBM Cloud 콘솔에서 탐색 메뉴 아이콘
아이콘 > 인프라 
> 스토리지 > 파일 스토리지 공유를 클릭합니다. -
파일 공유는 특정 지역에 대해 나열됩니다. 다른 지역의 리소스를 보려면 화살표를 클릭하여 목록을 확장하고 다른 지역을 선택하세요. 기본적으로 가장 최근에 공유된 항목이 목록의 맨 위에 표시됩니다.
-
보려는 파일 공유를 선택하고 스냅샷 탭을 클릭합니다.
‘스냅샷 요약’ 섹션에는 다음과 같은 정보가 포함되어 있습니다:
스냅샷 탭 요약입니다. 필드 설명 스냅샷 수 파일 공유를 위해 만든 스냅샷의 수입니다. 모든 스냅샷에서 변경된 데이터의 크기 첫 번째 스냅샷은 파일 공유의 전체 사본입니다. 후속 스냅샷은 마지막 스냅샷을 찍은 이후 발생한 변경 사항을 캡처합니다. 이 필드에는 스냅샷에서 사용하는 용량의 총합이 표시됩니다.
가용성 선택 이번 리전 파일 공유 릴리스에서는 CLI 또는 API로 파일 공유 작업을 수행할 때 스냅샷이 만들어지면 스냅샷 크기 필드가 응답에서 1로, 그렇지 않으면 0으로 기본값이 지정됩니다. 이 값은 스냅샷의 실제 크기를 나타내지 않습니다.복제 역할 이 역할은 소스 공유의 복제 역할과 일치합니다. 스냅샷 섹션에는 이 소스 공유에 대해 촬영한 모든 스냅샷 목록이 포함되어 있습니다.
스냅샷 탭 요약입니다. 필드 설명 이름 스냅샷 상세 정보 패널에 연결된 스냅샷의 고유 이름입니다. 소스 공유의 크기 스냅샷이 촬영된 시점의 소스 공유 크기입니다. 이 스냅샷을 사용하여 파일 공유를 복원하는 경우 이 필드의 크기는 만들려는 파일 공유의 크기를 나타냅니다. 상태 예를 들어, stable입니다.작업 아이콘 작업
클릭하면 상황에 맞는 작업 메뉴를 표시할 수 있습니다.작업 메뉴는 동적입니다. 공유가 복제본 공유인 경우 복원 작업만 표시됩니다. 공유가 소스 공유이거나 복제본이 없는 경우 3가지 작업을 모두 사용할 수 있습니다.
콘솔에서 스냅샷 세부 정보 보기
스냅샷에 대한 자세한 정보를 보려면 파일 공유의 상세 정보 페이지에서 스냅샷을 찾습니다. 그런 다음 스냅샷 이름을 클릭합니다. 스냅샷 세부 정보 사이드 패널에는 스냅샷 이름, 스냅샷의 CRN 및 ID, 첨부된 사용자 및 액세스 관리 태그 등의 정보가 표시됩니다.
복제본 공유에서는 스냅샷을 생성할 수 없지만, 다음 예정된 복제 동기화 시점에 소스 공유의 스냅샷이 복제본에 자동으로 생성됩니다. 이러한 복제된 스냅샷은 파일 서비스에 의해 생성됩니다. 원본 스냅샷의 이름이나 태그는 상속되지 않습니다. 그러나 소스 스냅샷과 지문 값은 동일합니다.
다음 표에서는 스냅샷 세부정보 패널에서 볼 수 있는 정보에 대해 설명합니다.
| 필드 | 설명 |
|---|---|
| 이름 | 편집 아이콘  클릭하여 변경할 수 있는 스냅샷의 이름입니다. 자세한 정보는 스냅샷 이름 지정을 참조하십시오. |
| ID | 스냅샷의 복사 가능한 UUID. |
| CRN | 스냅샷의 복사 가능한 CRN입니다. |
| 리소스 그룹 | 리소스 그룹은 VPC를 설정할 때 정의됩니다. |
| 상태 | 예를 들어, stable입니다. |
| 위치 | 소스 파일 공유의 위치와 동일합니다. |
| 작성 날짜 | 스냅샷 자원 작성 프로세스가 시작된 날짜 및 시간입니다. |
| 소스 파일 공유 크기 | 스냅샷이 생성된 시점의 공유 크기(GB)입니다. |
| 소스 파일 공유 | 첫 번째 스냅샷이 생성된 소스 공유. 자세한 내용을 보려면 링크를 클릭하세요. |
| 암호화 | 제공업체 관리형 또는 고객 관리형 암호화. 고객이 관리하는 암호화의 경우 KMS 인스턴스, 루트 키 이름 및 루트 키 ID가 표시됩니다. |
| 지문 | .snapshot 폴더에서 스냅샷을 찾는 데 사용할 수 있는 참조 ID입니다. |
| 사용자 태그 | 추가한 태그입니다. 복제본 공유에서 스냅샷을 볼 때는 이 필드가 비어 있습니다. |
| 작성자 | 스냅샷이 사용자에 의해 생성되었는지 또는 백업 정책에 의해 생성되었는지를 보여줍니다. 이 필드에는 복제본 파일 공유에서 스냅샷을 볼 때 복제가 표시됩니다. |
작업 아이콘 작업 클릭하면 상황에 맞는 작업 메뉴를 표시할 수 있습니다.
작업 메뉴는 동적입니다. 공유가 복제본 공유인 경우 복원 작업만 표시됩니다. 공유가 소스 공유이거나 복제본이 없는 경우 3가지 작업을 모두 사용할 수 있습니다.
CLI에서 스냅샷 보기
CLI를 사용하여 모든 스냅샷, 특정 공유의 모든 스냅샷 및 특정 스냅샷에 대한 세부 정보를 확인할 수 있습니다.
복제본 공유에서는 스냅샷을 생성할 수 없지만, 다음 예정된 복제 동기화 시점에 소스 공유의 스냅샷이 복제본에 자동으로 생성됩니다. 이러한 복제된 스냅샷은 파일 서비스에 의해 생성됩니다. 원본 스냅샷의 이름이나 태그는 상속되지 않습니다. 그러나 소스 스냅샷과 지문 값은 동일합니다.
시작하기 전에
CLI를 사용하려면 먼저 IBM Cloud CLI 및 VPC CLI 플러그인을 설치해야 합니다. 자세한 정보는 CLI 전제조건을 참조하십시오.
IBM Cloud® 에 로그인하세요.
ibmcloud login --sso -a cloud.ibm.com
이 명령은 URL을 리턴하고 비밀번호를 입력하라는 프롬프트를 표시합니다. 브라우저의 해당 URL로 이동하여 로그인하십시오. 성공하면 일회성 비밀번호를 얻게 됩니다. 이 비밀번호를 복사하여 메시지에 응답으로 붙여넣습니다. 인증에 성공하면 계정을 선택하라는 메시지가 표시됩니다. 여러 계정을 사용할 수 있는 경우, 로그인할 계정을 선택하세요. 나머지 프롬프트에 응답하여 로그인을 완료하십시오.
CLI에서 리전 내 모든 스냅샷 보기
ibmcloud is share-snapshots 명령을 실행하여 영역에서 사용 가능한 모든 스냅샷을 확인합니다.
ibmcloud is share-snapshots [--share SHARE] [--backup-policy-plan BACKUP_POLICY_PLAN [--backup-policy BACKUP_POLICY]] [--output JSON] [-q, --quiet]
ibmcloud is share-snapshots
Listing share snapshots in all resource groups and region au-syd under account Test Account as user test.user@ibm.com...
ID Name Created at Fingerprint Minimum Size Lifecycle state Zone Status User Tags
r026-c8fd81f8-3437-424e-8fc0-f9dd2f4766d3 demo-bkp-plan-2-02ae167865c0-44e8 2024-12-09T16:55:13+05:30 15b9509d-b6f8-461b-987a-2333be203e0e 40 stable au-syd-1 available dev:tags
r026-9997158e-daa6-409d-8e51-b2bbbc23c5d2 demo-bkp-plan-2-29e97584db07-4e86 2024-12-09T16:55:12+05:30 0b9c1e17-d872-4858-b478-a4d46cfd3dfe 40 stable au-syd-1 available dev:tags
r026-d04eb5f7-4159-4fa0-bfdd-83deca3b73b0 demo-bkp-plan-2-2b8c5b1bcadc-496f 2024-12-09T18:55:14+05:30 622a0e1f-7a48-4dce-adf0-c54adb4605c3 40 stable au-syd-1 available dev:tags
r026-9289ba15-a922-4b75-9650-7afc9471e9d9 demo-bkp-plan-2-47a13671bf22-47e0 2024-12-09T17:55:11+05:30 9a433610-0134-4162-8af3-d9358af832b5 40 stable au-syd-1 available dev:tags
r026-bee1b285-adc3-43e6-b8dd-5645efbe5732 demo-bkp-plan-2-4a90deb0778a-4f1a 2024-12-09T17:55:11+05:30 f8ec608d-9fbc-48cf-9018-01b1a8711449 40 stable au-syd-1 available dev:tags
지역별 파일 공유의 스냅샷의 경우, 영역 값은 CLI와 API 응답 모두에서 공백으로 표시됩니다.
사용 가능한 명령 옵션에 대한 자세한 내용은 ibmcloud is share-snapshots.
CLI에서 백업 정책에 의해 생성된 모든 스냅샷 보기
ibmcloud is share-snapshots 명령을 실행하고 백업 정책 계획을 지정합니다. 백업 정책 계획의 ID 또는 이름을 지정할 수 있습니다. 백업 정책 계획의 이름을 사용하려면 백업 정책의 이름 또는 ID도 함께 지정해야 합니다.
ibmcloud is share-snapshots [--backup-policy-plan BACKUP_POLICY_PLAN] [--backup-policy BACKUP_POLICY]
다음 예는 ID가 r006-158e0d66-338e-4501-b756-be0732677da8 인 백업 정책 계획에서 만든 스냅샷을 보여줍니다.
ibmcloud is share-snapshots --backup-policy-plan r006-158e0d66-338e-4501-b756-be0732677da8 --share my-file-share
Listing share snapshots of share my-file-share under account Test Account as user test.user@ibm.com...
ID Name Created at Fingerprint Minimum Size LifeCycle State Zone Status User Tags
r006-b4d12d66-18de-4660-9fe7-12e667d5ed5b demo-bkp-plan-1-d619b2fb4a68-4602 2024-11-19T11:33:27+05:30 643ce8da-bbbd-4515-b988-701aea2667df 40 stable us-south-1 available dev:tags
r006-59d25cac-92cd-4076-b988-e5d6746a848f demo-bkp-plan-1-e4406ae16e8f-4cb0 2024-11-19T12:32:23+05:30 202a5bd4-a1e0-4d89-914c-3574f45fc725 40 stable us-south-1 available dev:tags
r006-41785c6b-5d48-4dc1-89b7-21a5b2ada21e demo-bkp-plan-1-efc6f81b8505-4782 2024-11-19T10:32:19+05:30 acd57e05-ffe2-4eed-8e78-40b5000c53d3 40 stable us-south-1 available dev:tags
사용 가능한 명령 옵션에 대한 자세한 내용은 ibmcloud is share-snapshots.
CLI에서 스냅샷 세부 정보 확인하기
ibmcloud is share-snapshot 명령을 스냅샷 ID 또는 스냅샷 이름과 공유 이름 또는 ID와 함께 실행합니다. 스냅샷 ID는 계정 전체에서 고유합니다. 그러나 스냅샷 이름은 스냅샷 수준에서만 고유합니다.
ibmcloud is share-snapshot SHARE_SNAPSHOT [--output JSON] [-q, --quiet]
다음 예시는 스냅샷의 세부 정보를 보여줍니다.
ibmcloud is share-snapshot my-file-share r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd
Getting share snapshot ID r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd for share ID my-file-share under account Test Account as user test.user@ibm.com...
ID r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd
Name my-first-share-snapshot
Fingerprint 7f29bdd5-bc67-4e67-9b24-638a73be4742
Backup Policy Plan -
Status available
Created at 2025-03-10T19:17:55+00:00
Captured At 2025-03-10T19:17:58+00:00
CRN crn:v1:bluemix:public:is:us-south-2:a/a1234567::share-snapshot:r006-d14e4b29-cb73-4886-a267-b2cd58d67641/r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd
LifeCycle Reasons Code Message More Info
- -
LifeCycle State stable
Href https://us-south.iaas.cloud.ibm.com/v1/shares/r006-d14e4b29-cb73-4886-a267-b2cd58d67641/snapshots/r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd
Minimum Size 10
Zone ID Name
us-south-2
Resource group ID Name
6edefe513d934fdd872e78ee6a8e73ef defaults
Status reasons Status code Status message
- -
Resource type share_snapshot
사용 가능한 명령 옵션에 대한 자세한 내용은 ibmcloud is share-snapshot.
API를 사용하여 스냅샷 나열하기
VPC API를 사용하여 프로그래밍 방식으로 동일한 공유에 속하는 스냅샷을 나열할 수 있습니다.
복제본 공유에서는 스냅샷을 생성할 수 없지만, 다음 예정된 복제 동기화 시점에 소스 공유의 스냅샷이 복제본에 자동으로 생성됩니다. 이러한 복제된 스냅샷은 파일 서비스에 의해 생성됩니다. 원본 스냅샷의 이름이나 태그는 상속되지 않습니다. 그러나 소스 스냅샷과 지문 값은 동일합니다.
API를 사용하여 모든 스냅샷 나열하기
다음 샘플 요청에 표시된 것처럼 VPC API에서 /shares/{share-id}/snapshots 메서드를 호출하여 공유의 모든 스냅샷을 프로그래밍 방식으로 나열할 수 있습니다. 기본적으로 목록에는 최신 스냅샷이 먼저 표시되고 그 뒤에 오래된 스냅샷이
내림차순으로 표시됩니다.
curl -X GET \
"$vpc_api_endpoint/v1/shares/{share-id}/snapshots?version=2024-12-10&generation=2" \
-H "Authorization: Bearer $iam_token"
백업 정책 계획 ID를 사용하여 목록을 필터링하여 백업 정책으로 만든 스냅샷을 표시할 수 있습니다. 예를 들어, 다음 호출은 특정 백업 계획에 의해 생성된 스냅샷만 표시하도록 목록을 필터링하고, 결과 표시를 페이지당 5개로 제한합니다.
curl -X GET \
"$vpc_api_endpoint/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots?version=2024-12-10&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
"limit": 5,
"backup_policy_plan":
"id": "r006-b470ae68-8325-4a9c-9051-1ade8c3806c3"
}'
성공적인 응답은 다음 예제와 유사합니다.
{
"limit": 5,
"snapshots": [
{
"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": "stable",
"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"
}
},
{
"captured_at": "2024-12-10T02:21:12.000Z",
"created_at": "2024-12-10T02:59:46.000Z",
"crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::share-snapshot:r006-1fe9e5d8-0a4d-4818-96ec-e99708644a58/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
"fingerprint": "9bbc3aef-c2bc-4f65-a296-2928e534d498",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-1fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-d13ee54f-baa4-40d3-b35c-b9ec163972b4",
"id": "r006-d13ee54f-baa4-40d3-b35c-b9ec163972b4",
"lifecycle_state": "stable",
"minimum_size": 10,
"name": "my-second-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"
}
}
],
"total_count": 1
}
지역별 파일 공유의 스냅샷의 경우, 영역 값은 CLI와 API 응답 모두에서 공백으로 표시됩니다.
API를 사용하여 스냅샷의 세부 정보 조회하기
다음 샘플 요청에 표시된 것처럼 VPC API에서 /shares/{share-id}/snapshots/{snapshot-id} 메서드를 호출하고 공유 ID와 스냅샷 ID를 지정하여 단일 스냅샷의 세부 정보를 프로그래밍 방식으로 검색할 수 있습니다.
curl -X GET \
"$vpc_api_endpoint/v1/shares/r006-1fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4?version=2024-12-10&generation=2" \
-H "Authorization: Bearer $iam_token"
성공적인 응답은 다음 예제와 유사합니다.
{
"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": "stable",
"minimum_size": 10,
"name": "my-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 응답 모두에서 공백으로 표시됩니다.
Terraform으로 스냅샷 보기
Terraform을 사용하여 스냅샷을 볼 수 있습니다. Terraform을 사용하려면 Terraform CLI를 다운로드하고 IBM Cloud 공급자 플러그인을 구성하세요. 자세한 내용은 테라폼 시작하기를 참조하세요.
VPC 인프라 서비스는 기본적으로 us-south 으로 타깃팅되는 특정 지역 엔드포인트를 사용합니다. VPC가 다른 지역에서 생성된 경우 provider.tf 파일의 공급자 블록에서 해당 지역을 대상으로 지정해야 합니다.
기본값이 아닌 지역을 타겟팅하는 다음 예제 us-south 를 참조하세요.
provider "ibm" {
region = "eu-de"
}
Terraform으로 파일 공유의 모든 스냅샷 나열하기
스냅샷 컬렉션의 세부 정보를 읽기 전용 데이터 소스로 가져옵니다. source_share, resource_group, name 등으로 스냅샷 컬렉션을 필터링할 수 있습니다.
data "ibm_is_snapshots" "example" {
}
자세한 내용은 ibm_is_snapshots를 참조하세요.
Terraform으로 스냅샷의 세부 정보 나열하기
스냅샷의 세부 정보를 읽기 전용 데이터 소스로 가져옵니다. 스냅샷 ID 또는 스냅샷 이름을 지정할 수 있습니다.
data "ibm_is_share_snapshot" "example" {
share_snapshot = ibm_is_share_snapshot.example.share_snapshot
share = ibm_is_share.example.id
}
자세한 내용은 ibm_is_share_snapshot을 참조하세요.
다음 단계
스냅샷을 수정 또는 삭제하고 스냅샷에서 공유를 복원할 수 있습니다.
- 스냅샷을 수정하거나 삭제하십시오.
- 스냅샷에서 공유를 복원합니다.