DescribeMountTargets

Mengembalikan deskripsi dari semua target mount saat ini, atau target mount tertentu, untuk sistem file. Saat meminta semua target pemasangan saat ini, urutan target pemasangan yang dikembalikan dalam respons tidak ditentukan.

Operasi ini memerlukan izin untukelasticfilesystem:DescribeMountTargets tindakan, baik pada ID sistem file yang Anda tentukanFileSystemId, atau pada sistem file target mount yang Anda tentukanMountTargetId.

Minta Sintaks

GET /2015-02-01/mount-targets?AccessPointId=AccessPointId&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems&MountTargetId=MountTargetId HTTP/1.1

Parameter Permintaan URI

Permintaan menggunakan parameter URI berikut.

AccessPointId

(Opsional) ID titik akses yang target mount yang ingin Anda daftarkan. Itu harus disertakan dalam permintaan Anda jikaFileSystemId atauMountTargetId tidak termasuk dalam permintaan Anda. Menerima ID titik akses atau ARN sebagai masukan.

Batasan Panjang: Panjang maksimum 128.

Pola: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$

FileSystemId

(Opsional) ID dari sistem file yang mount target Anda ingin daftar (String). Itu harus dimasukkan dalam permintaan Anda jikaAccessPointId atauMountTargetId tidak termasuk. Menerima ID sistem file atau ARN sebagai masukan.

Batasan Panjang: Panjang maksimum 128.

Pola: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

Marker

(Opsional) token pagination buram dikembalikan dariDescribeMountTargets operasi sebelumnya (String). Jika ada, menentukan untuk melanjutkan daftar dari mana panggilan kembali sebelumnya ditinggalkan.

Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.

Pola: .+

MaxItems

(Opsional) Jumlah maksimum target pemasangan yang akan dikembalikan dalam respons. Saat ini, nomor ini secara otomatis diatur ke 10, dan nilai lainnya diabaikan. Respons dipaginasi pada 100 per halaman jika Anda memiliki lebih dari 100 target pemasangan.

Rentang yang Valid: Nilai minimum 1.

MountTargetId

(Opsional) ID dari target mount yang ingin Anda jelaskan (String). Itu harus disertakan dalam permintaan Anda jikaFileSystemId tidak termasuk. Menerima ID target mount atau ARN sebagai masukan.

Batasan Panjang: Panjang: Panjang 13. Panjang maksimum 45.

Pola: ^fsmt-[0-9a-f]{8,40}$

Isi Permintaan

Permintaan tidak memiliki isi permintaan.

Sintaks Respons

HTTP/1.1 200
Content-type: application/json

{
   "Marker": "string",
   "MountTargets": [ 
      { 
         "AvailabilityZoneId": "string",
         "AvailabilityZoneName": "string",
         "FileSystemId": "string",
         "IpAddress": "string",
         "LifeCycleState": "string",
         "MountTargetId": "string",
         "NetworkInterfaceId": "string",
         "OwnerId": "string",
         "SubnetId": "string",
         "VpcId": "string"
      }
   ],
   "NextMarker": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

Marker

Jika permintaan termasukMarker, respon mengembalikan nilai di bidang ini.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.

Pola: .+

MountTargets

Mengembalikan target pemasangan sistemMountTargetDescription file.

Tipe: Array objek MountTargetDescription

NextMarker

Jika nilai hadir, ada lebih banyak target mount untuk kembali. Dalam permintaan berikutnya, Anda dapat memberikan nilai iniMarker dalam permintaan Anda untuk mengambil set target pemasangan berikutnya.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.

Pola: .+

Kesalahan

AccessPointNotFound

Dikembalikan jikaAccessPointId nilai yang ditentukan tidak ada di pemohonAkun AWS.

Kode Status HTTP: 404

BadRequest

Dikembalikan jika permintaan cacat atau berisi kesalahan seperti nilai parameter yang tidak valid atau parameter yang diperlukan hilang.

Kode Status HTTP: 400

FileSystemNotFound

Dikembalikan jikaFileSystemId nilai yang ditentukan tidak ada di pemohonAkun AWS.

Kode Status HTTP: 404

InternalServerError

Kembali jika terjadi kesalahan di sisi server.

Kode Status HTTP: 500

MountTargetNotFound

Dikembalikan jika tidak ada target mount dengan ID yang ditentukan ditemukan di pemanggilAkun AWS.

Kode Status HTTP: 404

Contoh

Mengambil deskripsi target mount yang dibuat untuk sistem file

Permintaan berikut mengambil deskripsi target mount dibuat untuk sistem file yang ditentukan.

Sampel Permintaan

GET /2015-02-01/mount-targets?FileSystemId=fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T191252Z
Authorization: <...>

Contoh Respons

HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 357

{
   "MountTargets":[
      {
         "OwnerId":"251839141158",
         "MountTargetId":"fsmt-01234567",
         "FileSystemId":"fs-01234567",
         "SubnetId":"subnet-01234567",
         "LifeCycleState":"added",
         "IpAddress":"10.0.2.42",
         "NetworkInterfaceId":"eni-1bcb7772"
      }
   ]
}

Lihat Juga

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

• AWSAntarmuka Baris Perintah

• AWSSDK for .NET

• AWSSDK for C++

• AWSSDK for Go

• AWSSDK for Java V2

• AWSSDK untuk JavaScript

• AWSSDK for PHP V3

• AWSSDK for Python

• AWSSDK for Ruby V3