CreateBackupVault - AWS Backup

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

CreateBackupVault

Membuat kontainer logis tempat cadangan disimpan. Permintaan CreateBackupVault mencakup nama, secara opsional satu atau beberapa tanda sumber daya, kunci enkripsi, dan ID permintaan.

catatan

Jangan sertakan data sensitif, seperti nomor paspor, atas nama brankas cadangan.

Minta Sintaks

PUT /backup-vaults/backupVaultName HTTP/1.1 Content-type: application/json { "BackupVaultTags": { "string" : "string" }, "CreatorRequestId": "string", "EncryptionKeyArn": "string" }

Parameter Permintaan URI

Permintaan menggunakan parameter URI berikut.

backupVaultName

Nama kontainer logis tempat cadangan disimpan. Vault cadangan diidentifikasi berdasarkan nama yang unik untuk akun yang digunakan untuk membuatnya dan Wilayah AWS tempatnya dibuat. Mereka terdiri dari huruf, angka, dan tanda hubung.

Pola: ^[a-zA-Z0-9\-\_]{2,50}$

Wajib: Ya

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

BackupVaultTags

Tag yang akan ditetapkan ke brankas cadangan.

Tipe: Peta antar string

Wajib: Tidak

CreatorRequestId

String unik yang mengidentifikasi permintaan dan memungkinkan permintaan yang gagal untuk dicoba ulang tanpa risiko menjalankan operasi dua kali. Parameter ini bersifat opsional.

Jika digunakan, parameter ini harus berisi 1 sampai 50 alfanumerik atau '-_.' karakter.

Tipe: String

Wajib: Tidak

EncryptionKeyArn

Kunci enkripsi sisi server yang digunakan untuk melindungi cadangan Anda; misalnya, arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab.

Tipe: String

Wajib: Tidak

Sintaksis Respons

HTTP/1.1 200 Content-type: application/json { "BackupVaultArn": "string", "BackupVaultName": "string", "CreationDate": number }

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

BackupVaultArn

Nama Sumber Daya Amazon (ARN) yang secara unik mengidentifikasi brankas cadangan; misalnya,. arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault

Jenis: String

BackupVaultName

Nama kontainer logis tempat cadangan disimpan. Vault cadangan diidentifikasi berdasarkan nama yang unik untuk akun yang digunakan untuk membuatnya dan Wilayah tempatnya dibuat. Ia terdiri dari huruf kecil, angka, dan tanda hubung.

Jenis: String

Pola: ^[a-zA-Z0-9\-\_]{2,50}$

CreationDate

Tanggal dan waktu penyimpanan cadangan dibuat, dalam format Unix dan Coordinated Universal Time (UTC). Nilai akurat CreationDate untuk milidetik. Misalnya, nilai 1516925490.087 mewakili Jumat, 26 Januari 2018 12:11:30.087.

Tipe: Timestamp

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

AlreadyExistsException

Sumber daya yang dibutuhkan sudah ada.

Kode Status HTTP: 400

InvalidParameterValueException

Menunjukkan bahwa ada sesuatu yang salah dengan nilai parameter. Misalnya, nilainya di luar jangkauan.

Kode Status HTTP: 400

LimitExceededException

Batas permintaan telah terlampaui; misalnya, jumlah maksimum item yang diizinkan dalam permintaan.

Kode Status HTTP: 400

MissingParameterValueException

Menunjukkan bahwa parameter yang diperlukan tidak ada.

Kode Status HTTP: 400

ServiceUnavailableException

Permintaan gagal karena kegagalan sementara server.

Kode Status HTTP: 500

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: