File Storage for VPC 스냅샷 관리하기
콘솔, CLI, API 또는 Terraform을 통해 File Storage for VPC 스냅샷을 관리하세요. 스냅샷의 이름을 변경하거나, 사용자 태그를 업데이트하거나, 스냅샷을 삭제하여 공간을 확보할 수 있습니다.
복제 공유로 복제된 스냅샷은 복제 공유에서 직접 삭제할 수 없습니다. 소스 공유에서 소스 스냅샷이 삭제되면, 다음 복제 동기화 시점에 해당 항목들은 복제본 공유에서 제거됩니다.
콘솔에서 스냅샷 이름 바꾸기
콘솔에서 스냅샷의 이름을 변경하려면 다음 단계를 따르십시오.
- 스냅샷 목록으로 이동하십시오. IBM Cloud 콘솔에서 탐색 메뉴 아이콘
아이콘 > 인프라
> 스토리지 > 파일 스토리지 공유를 클릭합니다.
- 파일 공유는 특정 지역에 대해 나열됩니다. 다른 지역의 리소스를 보려면 화살표를 클릭하여 목록을 확장하고 다른 지역을 선택하세요. 기본적으로 가장 최근에 공유된 항목이 목록의 맨 위에 표시됩니다.
- 보려는 파일 공유를 선택하고 스냅샷 탭을 클릭합니다.
- 목록에서 스냅샷을 찾은 다음
클릭하고 이름 바꾸기를 선택합니다.
- 새 이름을 입력하고 ‘이름 변경’을 클릭하세요.
콘솔에서 스냅샷의 사용자 태그 업데이트하기
콘솔에서 스냅샷의 사용자 태그를 업데이트하려면 다음 단계를 따르세요.
- 스냅샷 목록으로 이동하십시오. IBM Cloud 콘솔에서 탐색 메뉴 아이콘
아이콘 > 인프라
> 스토리지 > 파일 스토리지 공유를 클릭합니다.
- 파일 공유는 특정 지역에 대해 나열됩니다. 다른 지역의 리소스를 보려면 화살표를 클릭하여 목록을 확장하고 다른 지역을 선택하세요. 기본적으로 가장 최근에 공유된 항목이 목록의 맨 위에 표시됩니다.
- 보려는 파일 공유를 선택하고 스냅샷 탭을 클릭합니다.
- 스냅샷의 이름을 클릭하여 스냅샷 세부정보 패널을 엽니다.
- 사용자 태그 옆의 편집 아이콘
을 클릭합니다.
- 기존 태그를 제거하고 새 태그를 추가할 수 있습니다. 저장 을 클릭하십시오.
CLI에서 스냅샷의 세부 정보 업데이트하기
CLI에서 명령을 실행하기 위한 전제 조건
CLI를 사용하려면 먼저 IBM Cloud CLI 및 VPC CLI 플러그인을 설치해야 합니다. 자세한 정보는 CLI 전제조건을 참조하십시오.
IBM Cloud® 에 로그인하세요.
ibmcloud login --sso -a cloud.ibm.com
이 명령은 URL을 리턴하고 비밀번호를 입력하라는 프롬프트를 표시합니다. 브라우저의 해당 URL로 이동하여 로그인하십시오. 성공하면 일회성 비밀번호를 얻게 됩니다. 이 비밀번호를 복사하여 메시지에 응답으로 붙여넣습니다. 인증에 성공하면 계정을 선택하라는 메시지가 표시됩니다. 여러 계정을 사용할 수 있는 경우, 로그인할 계정을 선택하세요. 나머지 프롬프트에 응답하여 로그인을 완료하십시오.
API를 사용하여 스냅샷 이름 변경하기
API를 사용하여 스냅샷의 이름을 바꿀 수 있습니다. PATCH /shares/{share-id}/snapshots/{snapshot-id} 호출을 수행하고 스냅샷 ID와 스냅샷의 새 이름을 지정하십시오.
curl -X PATCH \
"$vpc_api_endpoint/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4?version=2024-12-10&generation=2" \
-H "Authorization: Bearer ${API_TOKEN}" \
-d '{
"name": "my-snapshot-renamed"
}'
Terraform으로 스냅샷 업데이트하기
Terraform을 사용하려면 Terraform CLI를 다운로드하고 IBM Cloud 프로바이더 플러그인을 설정하십시오. 자세한 내용은 테라폼 시작하기를 참조하세요.
VPC 인프라 서비스는 기본적으로 us-south 으로 타깃팅되는 특정 지역 엔드포인트를 사용합니다. VPC가 다른 지역에서 생성된 경우 provider.tf 파일의 공급자 블록에서 해당 지역을 대상으로 지정해야 합니다.
기본값이 아닌 지역을 타겟팅하는 다음 예제 us-south 를 참조하세요.
provider "ibm" {
region = "eu-de"
}
스냅샷을 업데이트하려면 ibm_is_share_snapshot 리소스를 사용하세요. tags 인수를 사용하여 스냅샷의 태그를 추가하여 변경할 수 있습니다.
resource "ibm_is_share_snapshot" "example" {
tags = "dev:test"
source_share = ibm_is_share.example.id
}
인자 및 속성에 대한 자세한 내용은 ibm_is_snapshot을 참조하세요.
콘솔에서 스냅샷 삭제하기
공유의 모든 스냅샷을 삭제할 수 있습니다. 스냅샷을 삭제하려면 다음 전제 조건을 충족해야 합니다:
stable또는pending상태여야 합니다.- 공유를 적극적으로 복원하고 있지 않아야 합니다.
스냅샷을 삭제할 수 있는지 여부를 확인하는 편리한 방법은 콘솔에서 스냅샷 목록을 보고 상태를 확인하는 것입니다.
콘솔에서 단일 스냅샷 삭제하기
다음 단계에 따라 스냅샷 목록에서 스냅샷을 삭제할 수 있습니다.
- File Storage for VPC 의 모든 주식 목록으로 이동하세요. IBM Cloud 콘솔에서 메뉴
> 인프라
> 스토리지 > 파일 스토리지 공유로 이동합니다.
- 목록에서 공유 항목을 선택한 다음, 공유 이름을 클릭하여 공유 상세 정보 페이지로 이동하세요.
- '스냅샷' 탭을 클릭하면 이 공유 대상에 대해 생성된 스냅샷 목록을 확인할 수 있습니다.
- 삭제하려는 스냅샷을 찾으세요.
- 조치 아이콘
를 클릭하십시오.
- 삭제를 선택하십시오.
- 삭제를 확인하십시오.
CLI에서 스냅샷 삭제하기
공유에 대한 스냅샷을 삭제하거나 공유에 대한 모든 스냅샷을 삭제할 수 있습니다. 스냅샷을 삭제하려면 다음 전제 조건을 충족해야 합니다:
stable또는pending상태여야 합니다.- 공유를 적극적으로 복원하고 있지 않아야 합니다.
CLI를 사용하여 단일 스냅샷을 삭제하려면 다음 단계를 따르세요.
-
공유에 사용할 수 있는 스냅샷을 나열하여 삭제하려는 스냅샷의 ID를 확인합니다.
ibmcloud is share-snapshots SHARE [--output JSON] [-q, --quiet]ibmcloud is share-snapshots my-file-share -
ibmcloud is share-snapshot-delete명령을 실행하고 스냅샷의 ID를 지정하십시오. 여러 개의 스냅샷을 삭제하려면 동일한 명령에 모든 스냅샷의 ID를 지정해야 합니다.ibmcloud is share-snapshot-delete SHARE (SNAPSHOT1 SNAPSHOT2 ...) [-f, --force] [--output JSON] [-q, --quiet] -
스냅샷 삭제를 확인하십시오. 응답 메시지는 스냅샷이 삭제되었음을 표시합니다.
$ ibmcloud is share-snapshot-delete my-file-share r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 This will delete share snapshot r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 for share ID my-file-share and cannot be undone. Continue [y/N] ?> y Deleting share snapshot r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 for share ID my-file-share under account Test Account as user test.user@ibm.com... OK Share snapshot r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 is deleted.
사용 가능한 명령 옵션에 대한 자세한 내용은 ibmcloud is snapshot-delete.
API를 사용하여 스냅샷 삭제하기
공유에 대한 스냅샷을 삭제하거나 공유에 대한 모든 스냅샷을 삭제할 수 있습니다. 스냅샷을 삭제하려면 다음 전제 조건을 충족해야 합니다:
stable또는pending상태여야 합니다.- 공유를 적극적으로 복원하고 있지 않아야 합니다.
특정 스냅샷을 ID별로 삭제하려면 DELETE /shares/{share-id}/snapshots/{snapshot-id} 메서드를 호출하세요.
curl -X DELETE \
"$vpc_api_endpoint/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4?version=2024-12-10&generation=2" \
-H "Authorization: Bearer ${API_TOKEN}"
Terraform으로 스냅샷 삭제하기
공유에 대한 스냅샷을 삭제하거나 공유에 대한 모든 스냅샷을 삭제할 수 있습니다. 스냅샷을 삭제하려면 다음 전제 조건을 충족해야 합니다:
stable또는pending상태여야 합니다.- 공유를 적극적으로 복원하고 있지 않아야 합니다.
terraform destroy 명령을 사용하면 단일 스냅샷과 같은 원격 개체를 편리하게 삭제할 수 있습니다. 다음 예제는 my-snapshot 을 삭제합니다.
terraform destroy --target ibm_is_snapshot.my-snapshot
자세한 내용은 테라폼 파괴를 참조하세요.
스냅샷 라이프사이클 상태
표 2는 스냅샷 수명 주기 내의 스냅샷 상태를 설명합니다.
| 스냅샷 상태 | 설명 |
|---|---|
| 안정 | 스냅샷이 생성되어 공유를 복원하는 데 사용할 수 있습니다. |
| 대기 중 | 스냅샷을 검색하는 중입니다. |
| 보류 중 | 스냅샷이 원격 공유에 복제되고 있습니다. 복제가 진행되는 동안 완료된 백분율이 표시됩니다. |
| 실패 | 스냅샷 생성에 실패했으며, 스냅샷을 통해 공유 항목을 복원할 수 없습니다. |
| 일시중단됨 | 스냅샷은 임시로 사용 불가능합니다. |
| 업데이트 중 | 스냅샷의 이름을 변경하여 업데이트 중입니다. |
| Deleting | 스냅샷이 삭제되고 있습니다. |
| Deleted | 스냅샷이 삭제되어 공유 항목을 복원할 수 없습니다. |
다음 단계
스냅샷에서 공유를 복원할 수 있습니다.