ListLocations - AWS DataSync
Sintaksis PermintaanParameter PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

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

ListLocations

Mengembalikan daftar sumber dan lokasi tujuan.

Jika Anda memiliki lebih banyak lokasi daripada yang dikembalikan dalam respons (yaitu, respons yang hanya mengembalikan daftar agen Anda yang terpotong), respons tersebut berisi token yang dapat Anda tentukan dalam permintaan berikutnya untuk mengambil halaman lokasi berikutnya.

Sintaksis Permintaan

{
   "Filters": [ 
      { 
         "Name": "string",
         "Operator": "string",
         "Values": [ "string" ]
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}

Parameter Permintaan

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.

Permintaan menerima data berikut dalam format JSON.

Filters

Anda dapat menggunakan filter API untuk mempersempit daftar sumber daya yang dikembalikan oleh ListLocations. Misalnya, untuk mengambil semua tugas di lokasi sumber tertentu, Anda dapat menggunakan ListLocations dengan nama filter LocationType S3 dan Operator Equals.

Tipe: Array objek LocationFilter

Wajib: Tidak

MaxResults

Jumlah maksimum lokasi yang akan dikembalikan.

Tipe: Bilangan Bulat

Rentang Valid: Nilai minimum 0. Nilai maksimum 100.

Wajib: Tidak

NextToken

String buram yang menunjukkan posisi untuk memulai daftar lokasi berikutnya.

Tipe: String

Batasan Panjang: Panjang maksimum 65535.

Pola: [a-zA-Z0-9=_-]+

Diperlukan: Tidak

Sintaksis Respons

{
   "Locations": [ 
      { 
         "LocationArn": "string",
         "LocationUri": "string"
      }
   ],
   "NextToken": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

Locations

Array yang berisi daftar lokasi.

Tipe: Array objek LocationListEntry

NextToken

String buram yang menunjukkan posisi untuk mulai mengembalikan daftar lokasi berikutnya.

Tipe: String

Batasan Panjang: Panjang maksimum 65535.

Pola: [a-zA-Z0-9=_-]+

Kesalahan

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

InternalException

Pengecualian ini dilontarkan ketika terjadi kesalahan dalam layanan AWS DataSync .

Kode Status HTTP: 500

InvalidRequestException

Pengecualian ini dilontarkan ketika klien mengirimkan permintaan yang salah format.

Kode Status HTTP: 400

Lihat Juga

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