DescribeMountTargets - Amazon Elastic File System

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

DescribeMountTargets

Mengembalikan deskripsi dari 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 untukelasticfilesystem:DescribeMountTargetstindakan, pada ID sistem berkas yang Anda tentukan diFileSystemId, atau pada sistem file target mount yang Anda tentukan diMountTargetId.

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 cantumkan. Itu harus disertakan dalam permintaan Anda jikaFileSystemIdatauMountTargetIdtidak 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 target mount Anda ingin daftar (String). Itu harus disertakan dalam permintaan Anda jikaAccessPointIdatauMountTargetIdtidak disertakan. 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 dari sebelumnyaDescribeMountTargetsoperasi (String). Jika ada, itu 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-nilai lainnya diabaikan. Respon dipaginasi pada 100 per halaman jika Anda memiliki lebih dari 100 target mount.

Rentang yang Valid: Nilai minimum 1.

MountTargetId

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

Batasan 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 itu di bidang ini.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.

Pola: .+

MountTargets

Mengembalikan target pemasangan sistem file sebagai arrayMountTargetDescriptionbenda.

Jenis: ArrayMountTargetDescriptionobjek

NextMarker

Jika nilai hadir, ada lebih banyak target mount untuk kembali. Dalam permintaan berikutnya, Anda dapat memberikanMarkerdalam permintaan Anda dengan nilai ini untuk mengambil serangkaian target pemasangan berikutnya.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.

Pola: .+

Kesalahan

AccessPointNotFound

Kembali jika ditentukanAccessPointIdnilai tidak ada di pemohonAkun AWS.

Kode Status HTTP: 404

BadRequest

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

Kode Status HTTP: 400

FileSystemNotFound

Kembali jika ditentukanFileSystemIdnilai 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 yang 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 satu bahasaAWSSDK, lihat yang berikut ini: