기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# StartSnapshot API 요청에서 멱등성 보장
<a name="ebs-direct-api-idempotency"></a>

멱등성은 API 요청이 한 번만 완료되도록 합니다. 멱등성 요청에서는 원래 요청이 성공적으로 완료된 경우 후속 재시도에서 원래 성공한 요청의 결과를 반환하며 추가 영향이 없습니다.

[StartSnapshot](https://docs.aws.amazon.com/ebs/latest/APIReference/API_StartSnapshot.html) API는 *클라이언트 토큰*을 사용하여 멱등성을 지원합니다. 클라이언트 토큰은 API 요청을 할 때 지정하는 고유 문자열입니다. 요청이 성공적으로 완료된 후 동일한 클라이언트 토큰과 동일한 요청 파라미터를 사용하여 API 요청을 다시 시도하면 원래 요청의 결과가 반환됩니다. 동일한 클라이언트 토큰으로 요청을 다시 시도하지만 요청 파라미터를 하나 이상 변경하면 `ConflictException` 오류가 반환됩니다.

자체 클라이언트 토큰을 지정하지 않으면 AWS SDKs는 멱등성을 보장하기 위해 요청에 대한 클라이언트 토큰을 자동으로 생성합니다.

클라이언트 토큰은 최대 64자의 ASCII 문자를 포함하는 모든 문자열이 될 수 있습니다. 다른 요청에 동일한 클라이언트 토큰을 재사용해서는 안 됩니다.

**API를 사용하여 고유 클라이언트 토큰으로 멱등성 StartSnapshot 요청을 하려면**  
`ClientToken` 요청 파라미터를 지정합니다.

```
POST /snapshots HTTP/1.1
Host: ebs.us-east-2.amazonaws.com
Accept-Encoding: identity
User-Agent: {{<User agent parameter>}}
X-Amz-Date: 20200618T040724Z
Authorization: {{<Authentication parameter>}}

{
    "VolumeSize": 8,
    "ParentSnapshot": snap-123EXAMPLE1234567,
    "ClientToken": "550e8400-e29b-41d4-a716-446655440000",
    "Timeout": 60
}
```

**를 사용하여 자체 클라이언트 토큰으로 멱등성 StartSnapshot 요청을 수행하려면 AWS CLI**  
`client-token` 요청 파라미터를 지정합니다.

```
$ C:\> aws ebs start-snapshot --region us-east-2 --volume-size 8 --parent-snapshot snap-123EXAMPLE1234567 --timeout 60 --client-token 550e8400-e29b-41d4-a716-446655440000
```