Idempotensi untuk StartSnapshot API

Idempotency memastikan bahwa API permintaan hanya selesai sekali. Dengan permintaan idempotensi, jika permintaan asli selesai, percobaan berikutnya mengembalikan hasil dari permintaan awal yang berhasil dan tidak memiliki efek tambahan.

StartSnapshotAPIMendukung idempotensi menggunakan token klien. Token klien adalah string unik yang Anda tentukan saat Anda membuat API permintaan. Jika Anda mencoba lagi API permintaan dengan token klien yang sama dan parameter permintaan yang sama setelah berhasil diselesaikan, hasil permintaan asli dikembalikan. Jika Anda mencoba ulang permintaan dengan token klien yang sama, tetapi mengubah satu atau beberapa parameter permintaan, kesalahan ConflictException dikembalikan.

Jika Anda tidak menentukan token klien Anda sendiri, secara AWS SDKs otomatis menghasilkan token klien untuk permintaan untuk memastikan bahwa itu idempoten.

Token klien dapat berupa string apa pun yang mencakup hingga 64 ASCII karakter. Anda tidak boleh menggunakan kembali token klien yang sama untuk permintaan yang berbeda.

Untuk membuat StartSnapshot permintaan idempoten dengan token klien Anda sendiri menggunakan API

Tentukan parameter permintaan 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
}

Untuk membuat StartSnapshot permintaan idempoten dengan token klien Anda sendiri menggunakan AWS CLI

Tentukan parameter permintaan 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