ListTagsForResource - Amazon Elastic File System

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

ListTagsForResource

Daftar semua tag untuk sumber daya EFS tingkat atas. Anda harus menyediakan ID sumber daya yang ingin diambil tanda.

Operasi ini memerlukan izin utuk tindakan elasticfilesystem:DescribeAccessPoints.

Minta Sintaks

GET /2015-02-01/resource-tags/ResourceId?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1

Parameter Permintaan URI

Permintaan menggunakan parameter URI berikut.

MaxResults

(Opsional) Menentukan jumlah maksimum objek tag yang akan dikembalikan dalam respons. Nilai default-nya adalah 100.

Rentang yang Valid: Nilai minimum 1.

NextToken

(Opsional) Anda dapat menggunakanNextTokendalam permintaan berikutnya untuk mengambil halaman berikutnya dari deskripsi titik akses jika payload respon dipaginasi.

Batasan: Panjang minimum 1. Panjang maksimum 128.

Pola: .+

ResourceId

Menentukan sumber daya EFS Anda ingin mengambil tag untuk. Anda dapat mengambil tag untuk sistem file EFS dan titik akses menggunakan endpoint API ini.

Batasan: Panjang maksimum 128.

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

Diperlukan: Ya

Isi Permintaan

Permintaan tidak memiliki isi permintaan.

Sintaks Respons

HTTP/1.1 200 Content-type: application/json { "NextToken": "string", "Tags": [ { "Key": "string", "Value": "string" } ] }

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

NextToken

NextTokenhadir jika payload respon paginasi. Anda dapat menggunakanNextTokendalam permintaan berikutnya untuk mengambil halaman berikutnya dari deskripsi titik akses.

Jenis: String

Batasan: Panjang minimum 1. Panjang maksimum 128.

Pola: .+

Tags

Array dari tag untuk sumber daya EFS tertentu.

Jenis: ArrayTagobjek

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 berikut ini: