DescribeMountTargets

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

Operasi ini memerlukan izin untuk elasticfilesystem:DescribeMountTargets tindakan, baik pada ID sistem file yang Anda tentukanFileSystemId, atau pada sistem file target mount yang Anda tentukan. MountTargetId

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 dimasukkan dalam permintaan Anda jika MountTargetId ada FileSystemId atau tidak termasuk dalam permintaan Anda. Menerima ID titik akses atau ARN sebagai input.

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 target mount Anda ingin daftar (String). Itu harus dimasukkan dalam permintaan Anda jika AccessPointId atau MountTargetId tidak termasuk. Menerima ID sistem file atau ARN sebagai input.

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 dari DescribeMountTargets operasi sebelumnya (String). Jika ada, ini 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 untuk kembali dalam respons. Saat ini, nomor ini secara otomatis diatur ke 10, dan nilai lainnya diabaikan. Respons diberi paginasi 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 dimasukkan dalam permintaan Anda jika FileSystemId tidak termasuk. Menerima ID target mount atau ARN sebagai input.

Kendala Panjang: Panjang minimum 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 dalam bidang ini.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.

Pola: .+

MountTargets

Mengembalikan target mount sistem file sebagai array MountTargetDescription objek.

Tipe: Array objek MountTargetDescription

NextMarker

Jika ada nilai, ada lebih banyak target mount untuk dikembalikan. Dalam permintaan berikutnya, Anda dapat memberikan nilai ini Marker dalam permintaan Anda untuk mengambil set target mount berikutnya.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.

Pola: .+

Kesalahan

AccessPointNotFound

Dikembalikan jika AccessPointId nilai yang ditentukan tidak ada di pemohon. Akun AWS

Kode Status HTTP: 404

BadRequest

Dikembalikan jika permintaan salah bentuk atau berisi kesalahan seperti nilai parameter yang tidak valid atau parameter wajib yang hilang.

Kode Status HTTP: 400

FileSystemNotFound

Dikembalikan jika FileSystemId nilai yang ditentukan tidak ada di pemohon. Akun AWS

Kode Status HTTP: 404

InternalServerError

Dikembalikan jika terjadi kesalahan di sisi server.

Kode Status HTTP: 500

MountTargetNotFound

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

Kode Status HTTP: 404

Contoh-contoh

Ambil deskripsi target mount yang dibuat untuk sistem file

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

Permintaan Sampel

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 ini di salah satu AWS SDK khusus bahasa, lihat berikut ini:

• AWS Command Line Interface

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go.

• AWSSDK for Java V2

• AWSSDK untuk V3 JavaScript

• AWS SDK for PHP V3

• AWS SDK for Python

• AWS SDK for Ruby V3