IBM Cloud Docs
File Storage for VPC 스냅샷 관리하기

File Storage for VPC 스냅샷 관리하기

콘솔에서 기존 스냅샷을 관리하거나, CLI에서 API 또는 Terraform을 사용하여 관리할 수 있습니다. 스냅샷의 사용자 태그를 업데이트하고 더 이상 필요하지 않은 스냅샷을 삭제하여 새 스냅샷을 위한 공간을 확보할 수 있습니다.

복제본 공유에 스냅샷을 만들 수는 없지만, 원본 공유의 스냅샷은 다음 예약된 동기화 시 소스에서 복제본으로 복사됩니다. 이러한 복제본 스냅샷은 파일 서비스에 의해 생성됩니다. 원본 스냅샷에서 태그나 이름을 상속하지 않습니다. 그러나 소스 스냅샷과 동일한 핑거프린트 값을 가집니다. 복제본 공유에서 수동으로 삭제할 수는 없지만, 소스 공유에서 소스 스냅샷이 삭제되면 다음 복제본 동기화 시 복제본 공유에서 제거됩니다.

콘솔에서 스냅샷의 사용자 태그 업데이트하기

콘솔에서 스냅샷의 사용자 태그를 업데이트하려면 다음 단계를 따르세요.

  1. 스냅샷 목록으로 이동하십시오. IBM Cloud 콘솔에서 탐색 메뉴 아이콘 메뉴 아이콘 > 인프라 VPC 아이콘 > 스토리지 > 파일 스토리지 공유를 클릭합니다.
  2. 파일 공유는 특정 지역에 대해 나열됩니다. 다른 지역의 리소스를 보려면 화살표를 클릭하여 목록을 확장하고 다른 지역을 선택하세요. 기본적으로 최신 공유는 목록의 맨 처음에 표시됩니다.
  3. 보려는 파일 공유를 선택하고 스냅샷 탭을 클릭합니다.
  4. 스냅샷의 이름을 클릭하여 스냅샷 세부정보 패널을 엽니다.
  5. 사용자 태그 옆의 편집 아이콘 수정 아이콘 을 클릭합니다.
  6. 기존 태그를 제거하고 새 태그를 추가할 수 있습니다. 저장 을 클릭하십시오.

CLI에서 스냅샷의 사용자 태그 업데이트하기

CLI에서 스냅샷에 할당된 사용자 태그를 업데이트할 수 있습니다. ibmcloud is share-snapshot-update 명령을 실행하고 스냅샷 ID와 새 태그를 입력합니다.

ibmcloud is share-snapshot-update SHARE SNAPSHOT --tags NEW_TAG1,NEW_TAG2 [--output JSON] [-q, --quiet]

사용자 태그를 추가하는 다음 예시를 참조하세요.

ibmcloud is share-snapshot-update my-file-share r134-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 --user-tags test:cli
Updating file share snapshot share-snapshot-cli-update for share my-file-share under account Test Account as user test.user@ibm.com...

ID                   r134-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3   
Name                 share-snapshot-cli-update   
Fingerprint          c25fdce4-6e0a-433f-99c0-9985f127cd54   
Backup Policy Plan   -   
Status               available   
Status reasons       Status code   Status message      
                     -             -  
Created at           2024-12-17T11:19:33+05:30   
Captured At          2024-12-17T11:19:34+05:30   
CRN                  crn:v1:bluemix:public:is:us-south-1:a/a123456::share-snapshot:r134-2ae87eb2-b26c-4126-ab34-e6e64f6f1773/r134-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3   
LifeCycle State      stable
LifeCycle Reasons    Code   Message   More Info      
                      -      -         
Href                 https://us-south.iaas.cloud.ibm.com/v1/shares/r134-2ae87eb2-b26c-4126-ab34-e6e64f6f1773/snapshots/r134-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3   
Minimum Size         40   
User Tags            test:cli   
Zone                 ID   Name      
                          us-south-1      

Resource group       ID                                 Name      
                     11caaa983d9c4beb82690daab08717e9   Default      

Resource type        share_snapshot

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 '{
     "user_tags": ["env:test","dev:test"]
    }'

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 상태여야 합니다.
  • 공유를 적극적으로 복원하지 않습니다.

스냅샷을 삭제할 수 있는지 여부를 쉽게 확인하는 방법은 콘솔에서 스냅샷 목록을 보고 상태를 확인하는 것입니다.

콘솔에서 단일 스냅샷 삭제하기

다음 단계에 따라 스냅샷 목록에서 스냅샷을 삭제할 수 있습니다.

  1. 모든 File Storage for VPC 공유 목록으로 이동합니다. IBM Cloud 콘솔에서 메뉴 아이콘 > 인프라 VPC 아이콘 > 스토리지 > 파일 스토리지 공유로 이동합니다.
  2. 목록에서 공유를 선택하고 공유 이름을 클릭하면 공유 세부정보 페이지로 이동합니다.
  3. 스냅샷 탭을 클릭하면 이 공유에서 찍은 스냅샷 목록을 볼 수 있습니다.
  4. 삭제하려는 스냅샷을 찾습니다.
  5. 조치 아이콘 조치 아이콘를 클릭하십시오.
  6. 삭제를 선택하십시오.
  7. 삭제를 확인하십시오.

CLI에서 스냅샷 삭제하기

공유에 대한 스냅샷을 삭제하거나 공유에 대한 모든 스냅샷을 삭제할 수 있습니다. 스냅샷을 삭제하려면 다음 전제 조건을 충족해야 합니다:

  • stable 또는 pending 상태여야 합니다.
  • 공유를 적극적으로 복원하지 않습니다.

CLI를 사용하여 단일 스냅샷을 삭제하려면 다음 단계를 따르세요.

  1. 공유에 사용할 수 있는 스냅샷을 나열하여 삭제하려는 스냅샷의 ID를 확인합니다.

    ibmcloud is share-snapshots SHARE [--output JSON] [-q, --quiet]
    
    ibmcloud is share-snapshots my-file-share
    
  2. ibmcloud is share-snapshot-delete 명령을 실행하고 스냅샷의 ID를 지정하십시오. 여러 개의 스냅샷을 삭제하려면 동일한 명령에 모든 스냅샷의 ID를 지정해야 합니다.

    ibmcloud is share-snapshot-delete SHARE (SNAPSHOT1 SNAPSHOT2 ...) [-f, --force] [--output JSON] [-q, --quiet]
    
  3. 스냅샷 삭제를 확인합니다. 응답 메시지는 스냅샷이 삭제되었음을 표시합니다.

    $ ibmcloud is share-snapshot-delete my-file-share r134-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3
    This will delete share snapshot r134-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 for share ID my-file-share and cannot be undone. Continue [y/N] ?> y
    Deleting share snapshot r134-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 for share ID my-file-share under account Test Account as user test.user@ibm.com...
    OK
    Share snapshot r134-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 is deleted.
    

사용 가능한 명령 옵션에 대한 자세한 내용은 ibmcloud is snaphot-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 스냅샷이 삭제되어 공유를 복원할 수 없습니다.

다음 단계

스냅샷에서 공유를 복원할 수 있습니다.