DescribeAccessPoints - Amazon Elastic File System

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

DescribeAccessPoints

Mengembalikan deskripsi titik akses Amazon EFS tertentu jikaAccessPointIddisediakan. Jika Anda memberikan EFSFileSystemId, ia mengembalikan deskripsi dari semua titik akses untuk sistem file itu. Anda dapat memberikanAccessPointIdatauFileSystemIddalam permintaan, tapi tidak keduanya.

Operasi ini memerlukan izin utuk tindakan elasticfilesystem:DescribeAccessPoints.

Minta Sintaks

GET /2015-02-01/access-points?AccessPointId=AccessPointId&FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1

Parameter Permintaan URI

Permintaan menggunakan parameter URI berikut.

AccessPointId

(Opsional) Menentukan titik akses EFS untuk menggambarkan dalam respon; saling eksklusif denganFileSystemId.

Batasan: 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) Jika Anda memberikanFileSystemId, EFS mengembalikan semua titik akses untuk sistem file itu; saling eksklusif denganAccessPointId.

Batasan: 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})$

MaxResults

(Opsional) Saat mengambil semua titik akses untuk sistem file, Anda dapat menentukanMaxItemsparameter untuk membatasi jumlah objek yang dikembalikan dalam respons. Nilai default-nya adalah 100.

Rentang yang Valid: Nilai minimum 1.

NextToken

NextTokenhadir jika respon paginasi. Anda dapat menggunakanNextMarkerdalam permintaan berikutnya untuk mengambil halaman berikutnya deskripsi jalur akses.

Batasan: Panjang minimum 1. Panjang maksimum 128.

Pola: .+

Isi Permintaan

Permintaan tidak memiliki isi permintaan.

Sintaks Respons

HTTP/1.1 200 Content-type: application/json { "AccessPoints": [ { "AccessPointArn": "string", "AccessPointId": "string", "ClientToken": "string", "FileSystemId": "string", "LifeCycleState": "string", "Name": "string", "OwnerId": "string", "PosixUser": { "Gid": number, "SecondaryGids": [ number ], "Uid": number }, "RootDirectory": { "CreationInfo": { "OwnerGid": number, "OwnerUid": number, "Permissions": "string" }, "Path": "string" }, "Tags": [ { "Key": "string", "Value": "string" } ] } ], "NextToken": "string" }

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

AccessPoints

Array deskripsi titik akses.

Jenis: ArrayAccessPointDescriptionobjek

NextToken

Hadir jika ada jalur akses yang lebih dari yang dikembalikan dalam respons. Anda dapat menggunakan NextMarker dalam permintaan berikutnya untuk mengambil deskripsi tambahan.

Jenis: String

Batasan: 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

Lihat Juga

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