Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
CreateLogicallyAirGappedBackupVault
Membuat wadah logis ke tempat cadangan dapat disalin.
Permintaan ini mencakup nama, Wilayah, jumlah maksimum hari penyimpanan, jumlah minimum hari penyimpanan, dan secara opsional dapat menyertakan tag dan ID permintaan pembuat konten.
catatan
Jangan sertakan data sensitif, seperti nomor paspor, atas nama brankas cadangan.
Minta Sintaks
PUT /logically-air-gapped-backup-vaults/backupVaultName
HTTP/1.1
Content-type: application/json
{
"BackupVaultTags": {
"string
" : "string
"
},
"CreatorRequestId": "string
",
"MaxRetentionDays": number
,
"MinRetentionDays": number
}
Parameter Permintaan URI
Permintaan menggunakan parameter URI berikut.
- backupVaultName
-
Nama kontainer logis tempat cadangan disimpan. Secara logis brankas cadangan celah udara diidentifikasi dengan nama yang unik untuk akun yang digunakan untuk membuatnya dan Wilayah tempat mereka dibuat.
Pola:
^[a-zA-Z0-9\-\_]{2,50}$
Wajib: Ya
Isi Permintaan
Permintaan menerima data berikut dalam format JSON.
- BackupVaultTags
-
Tag untuk menetapkan ke lemari besi.
Tipe: Peta antar string
Wajib: Tidak
- CreatorRequestId
-
ID permintaan pembuatan.
Parameter ini bersifat opsional. Jika digunakan, parameter ini harus berisi 1 sampai 50 alfanumerik atau '-_.' karakter.
Tipe: String
Wajib: Tidak
- MaxRetentionDays
-
Periode retensi maksimum bahwa brankas mempertahankan titik pemulihannya. Jika parameter ini tidak ditentukan, AWS Backup tidak memberlakukan periode retensi maksimum pada titik pemulihan di brankas (memungkinkan penyimpanan tidak terbatas).
Jika ditentukan, pekerjaan pencadangan atau penyalinan apa pun ke vault harus memiliki kebijakan siklus hidup dengan periode penyimpanan yang sama atau lebih pendek dari periode retensi maksimum. Jika periode retensi pekerjaan lebih lama dari periode retensi maksimum tersebut, vault akan gagal melakukan pekerjaan pencadangan atau penyalinan, dan Anda harus mengubah setelan siklus hidup atau menggunakan brankas yang berbeda.
Tipe: Long
Wajib: Ya
- MinRetentionDays
-
Setelan ini menentukan periode retensi minimum dimana vault mempertahankan titik pemulihannya. Jika parameter ini tidak ditentukan, tidak ada periode retensi minimum yang diberlakukan.
Jika ditentukan, pekerjaan pencadangan atau penyalinan apa pun ke vault harus memiliki kebijakan siklus hidup dengan periode penyimpanan yang sama dengan atau lebih lama dari periode penyimpanan minimum. Jika periode retensi pekerjaan lebih pendek dari periode retensi minimum tersebut, vault akan gagal melakukan pencadangan atau penyalinan pekerjaan, dan Anda harus mengubah setelan siklus hidup atau menggunakan brankas yang berbeda.
Tipe: Long
Wajib: Ya
Sintaksis Respons
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultArn": "string",
"BackupVaultName": "string",
"CreationDate": number,
"VaultState": "string"
}
Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- BackupVaultArn
-
ARN (Nama Sumber Daya Amazon) dari lemari besi.
Jenis: String
- BackupVaultName
-
Nama kontainer logis tempat cadangan disimpan. Secara logis brankas cadangan celah udara diidentifikasi dengan nama yang unik untuk akun yang digunakan untuk membuatnya dan Wilayah tempat mereka dibuat.
Jenis: String
Pola:
^[a-zA-Z0-9\-\_]{2,50}$
- CreationDate
-
Tanggal dan waktu ketika lemari besi dibuat.
Nilai ini dalam format Unix, Coordinated Universal Time (UTC), dan akurat hingga milidetik. Misalnya, nilai 1516925490.087 mewakili Jumat, 26 Januari 2018 12:11:30.087.
Tipe: Timestamp
- VaultState
-
Keadaan lemari besi saat ini.
Jenis: String
Nilai yang Valid:
CREATING | AVAILABLE | FAILED
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
- InvalidRequestException
-
Menunjukkan bahwa ada sesuatu yang salah dengan input ke permintaan. Misalnya, parameter adalah tipe yang salah.
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: