ListBackupVaults - AWS Backup

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

ListBackupVaults

Mengembalikan daftar wadah penyimpanan titik pemulihan bersama dengan informasi tentang mereka.

Sintaks Permintaan

GET /backup-vaults/?maxResults=MaxResults&nextToken=NextToken&shared=ByShared&vaultType=ByVaultType HTTP/1.1

URIParameter Permintaan

Permintaan menggunakan URI parameter berikut.

ByShared

Parameter ini akan mengurutkan daftar brankas berdasarkan brankas bersama.

ByVaultType

Parameter ini akan mengurutkan daftar vault berdasarkan jenis vault.

Nilai Valid: BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT

MaxResults

Jumlah maksimum item yang akan dikembalikan.

Rentang yang Valid: Nilai minimum 1. Nilai maksimum 1000.

NextToken

Item berikutnya mengikuti sebagian daftar item yang dikembalikan. Misalnya, jika permintaan dibuat untuk mengembalikan MaxResults jumlah item, NextToken memungkinkan Anda mengembalikan lebih banyak item dalam daftar Anda mulai dari lokasi yang ditunjukkan oleh token berikutnya.

Isi Permintaan

Permintaan tidak memiliki isi permintaan.

Sintaks Respons

HTTP/1.1 200 Content-type: application/json { "BackupVaultList": [ { "BackupVaultArn": "string", "BackupVaultName": "string", "CreationDate": number, "CreatorRequestId": "string", "EncryptionKeyArn": "string", "LockDate": number, "Locked": boolean, "MaxRetentionDays": number, "MinRetentionDays": number, "NumberOfRecoveryPoints": number, "VaultState": "string", "VaultType": "string" } ], "NextToken": "string" }

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Data berikut dikembalikan dalam JSON format oleh layanan.

BackupVaultList

Larik anggota daftar vault cadangan yang berisi metadata vault, termasuk Amazon Resource Name (ARN), nama tampilan, tanggal pembuatan, jumlah titik pemulihan yang disimpan, dan informasi enkripsi jika sumber daya yang disimpan di brankas cadangan dienkripsi.

Tipe: Array objek BackupVaultListMember

NextToken

Item berikutnya mengikuti sebagian daftar item yang dikembalikan. Misalnya, jika permintaan dibuat untuk mengembalikan MaxResults jumlah item, NextToken memungkinkan Anda mengembalikan lebih banyak item dalam daftar Anda mulai dari lokasi yang ditunjukkan oleh token berikutnya.

Tipe: String

Kesalahan

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

InvalidParameterValueException

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

HTTPKode Status: 400

MissingParameterValueException

Menunjukkan bahwa parameter yang diperlukan tidak ada.

HTTPKode Status: 400

ResourceNotFoundException

Sumber daya yang diperlukan untuk tindakan tidak ada.

HTTPKode Status: 400

ServiceUnavailableException

Permintaan gagal karena kegagalan sementara server.

HTTPKode Status: 500

Lihat Juga

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