Skip to main content
Element Software
12.5 and 12.7
본 한국어 번역은 사용자 편의를 위해 제공되는 기계 번역입니다. 영어 버전과 한국어 버전이 서로 어긋나는 경우에는 언제나 영어 버전이 우선합니다.

스냅샷 생성

기여자
PDF

'CreateSnapshot'을 사용하여 볼륨의 시점 복사본을 생성할 수 있습니다. 모든 볼륨이나 기존 스냅샷에서 스냅샷을 생성할 수 있습니다.

이 API 메서드를 사용하여 SnapshotID를 제공하지 않으면 볼륨의 활성 브랜치에서 스냅샷이 생성됩니다. 스냅샷이 생성된 볼륨이 원격 클러스터로 복제되는 경우 스냅샷을 동일한 타겟으로 복제할 수도 있습니다. enableRemoteReplication 매개 변수를 사용하여 스냅샷 복제를 설정합니다.

참고 클러스터 충만도가 1단계, 2단계 또는 3단계에 있는 경우 스냅샷을 생성할 수 있습니다. 클러스터 충만도가 4단계 또는 5단계에 도달하면 스냅샷을 생성할 수 없습니다.

매개 변수

이 메서드에는 다음과 같은 입력 매개 변수가 있습니다.

이름 설명 유형 기본값 필수 요소입니다

'속성'

JSON 개체 형식의 이름-값 쌍 목록입니다.

JSON 개체

없음

아니요

enableRemoteReplication

스냅샷을 원격 스토리지에 복제할지 여부를 지정합니다. 가능한 값:

  • "참": 스냅샷이 원격 스토리지에 복제됩니다.

  • "거짓": 스냅샷은 원격 스토리지에 복제되지 않습니다.

부울

거짓

아니요

엔수에SerialCreation

이전 스냅샷 복제가 진행 중인 경우 스냅샷을 생성하지 않도록 지정합니다. 가능한 값은 다음과 같습니다.

  • "참": 이는 한 번에 하나의 스냅샷만 복제되도록 합니다. 이전 스냅샷 복제가 아직 진행 중인 경우 새 스냅샷 생성이 실패합니다.

  • 거짓: 기본값. 다른 스냅샷 복제가 아직 진행 중인 경우 이 스냅샷 생성이 허용됩니다.

부울

거짓입니다

아니요

만료 시간

스냅샷을 제거할 수 있는 시간을 지정합니다. '연장'과 함께 사용할 수 없습니다. 만료 시간 또는 보존 기간을 지정하지 않으면 스냅샷이 만료되지 않습니다. 시간 형식은 시간 기반 만료에 대한 ISO 8601 날짜 문자열이며, 그렇지 않으면 만료되지 않습니다. 값이 "null"이면 스냅샷이 영구적으로 보존됩니다. 'fifo' 값을 지정하면 해당 볼륨의 다른 FIFO 스냅샷과 비교하여 첫 번째 출력 기반으로 스냅샷이 보존됩니다. 사용할 수 있는 FIFO 공간이 없으면 API가 실패합니다.

문자열

없음

아니요

이름

스냅샷의 이름입니다. 이름을 입력하지 않으면 스냅샷이 생성된 날짜와 시간이 사용됩니다. 허용되는 최대 이름 길이는 255자입니다.

문자열

없음

아니요

'연장'

시간 형식이 HH:MM:ss인 점을 제외하고 이 매개 변수는 'expirationTime' 매개 변수와 동일합니다. 만료 시간 또는 재연이 지정되지 않으면 스냅샷이 만료되지 않습니다.

문자열

없음

아니요

'스냅샷 레이블'

SnapMirror 소프트웨어에서 SnapMirror 엔드포인트에 대한 스냅샷 보존 정책을 지정하는 데 사용되는 레이블입니다.

문자열

없음

아니요

나프산아이디

새 스냅샷이 생성된 스냅샷의 고유 ID입니다. 전달된 snapshotID는 지정된 볼륨의 스냅샷이어야 합니다.

정수

없음

아니요

'볼륨 ID'입니다

복사할 볼륨 이미지의 고유 ID입니다.

정수

없음

예

반환 값

이 메서드의 반환 값은 다음과 같습니다.

이름

설명

유형

체크섬

저장된 스냅샷에서 올바른 숫자를 나타내는 문자열입니다. 이 체크섬은 나중에 다른 스냅샷을 비교하여 데이터의 오류를 감지하는 데 사용할 수 있습니다.

문자열

스냅샷 ID입니다

새 스냅샷의 고유 ID입니다.

스냅샷 ID입니다

스냅샷

새로 생성된 스냅샷에 대한 정보가 포함된 객체입니다.

스냅샷

요청 예

이 메서드에 대한 요청은 다음 예제와 비슷합니다.

{
   "method": "CreateSnapshot",
   "params": {
      "volumeID": 1
   },
   "id": 1
}

응답 예

이 메서드는 다음 예제와 유사한 응답을 반환합니다.

{
  "id": 1,
  "result": {
    "checksum": "0x0",
      "snapshot": {
        "attributes": {},
        "checksum": "0x0",
        "createTime": "2016-04-04T17:14:03Z",
        "enableRemoteReplication": false,
        "expirationReason": "None",
        "expirationTime": null,
        "groupID": 0,
        "groupSnapshotUUID": "00000000-0000-0000-0000-000000000000",
        "name": "2016-04-04T17:14:03Z",
        "snapshotID": 3110,
        "snapshotUUID": "6f773939-c239-44ca-9415-1567eae79646",
        "status": "done",
        "totalSize": 5000658944,
        "virtualVolumeID": null,
        "volumeID": 1
      },
        "snapshotID": 3110
  }
}

예외

"CreateSnapshot" API가 호출되고 스냅샷이 생성되지 않을 때 xNotPrimary 예외가 표시됩니다. 이는 예상된 동작입니다. CreateSnapshot API 호출 재시도

버전 이후 새로운 기능

9.6