ListTagsForResource - Amazon Elastic File System

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ListTagsForResource

最上位EFSリソースのすべてのタグを一覧表示します。タグを取得するリソースの ID を入力する必要があります。

このオペレーションには、elasticfilesystem:DescribeAccessPoints アクションに対する許可が必要です。

リクエストの構文

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

URI リクエストパラメータ

リクエストでは、次のURIパラメータを使用します。

MaxResults

(オプション)レスポンスで返すタグオブジェクトの最大数を指定します。デフォルト値は 100 です。

有効範囲: 最小値は 1 です。

NextToken

(オプション)応答のペイロードがページ割りされている場合、次のリクエストで NextToken を使用して、アクセスポイントの説明の次のページをフェッチできます。

長さの制限:最小長は 1 です。最大長は 128 です。

パターン: .+

ResourceId

タグを取得するEFSリソースを指定します。このAPIエンドポイントを使用して、EFSファイルシステムとアクセスポイントのタグを取得できます。

長さの制限:最大長は 128 です。

パターン:^(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})$

必須: はい

リクエストボディ

リクエストにリクエスト本文がありません。

レスポンスの構文

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

レスポンス要素

アクションが成功すると、サービスは 200 HTTP レスポンスを返します。

次のデータは、 サービスによって JSON 形式で返されます。

NextToken

NextToken はレスポンスペイロードがページ割りされている場合に存在します。後続のリクエストで NextToken を使うと、次のページのアクセスポイントの説明をフェッチすることができます。

型: 文字列

長さの制限: 最小長は 1 です。最大長は 128 です。

パターン: .+

Tags

指定されたEFSリソースのタグの配列。

型: Tag オブジェクトの配列

エラー

AccessPointNotFound

指定されたAccessPointId値がリクエスタの に存在しない場合に返されます AWS アカウント。

HTTP ステータスコード: 404

BadRequest

リクエストの形式が正しくない場合や、無効なパラメータ値や必須パラメータの欠落などのエラーが含まれている場合に返されます。

HTTP ステータスコード: 400

FileSystemNotFound

指定されたFileSystemId値がリクエスタの に存在しない場合に返されます AWS アカウント。

HTTP ステータスコード: 404

InternalServerError

サーバー側でエラーが発生した場合に返されます。

HTTP ステータスコード: 500

以下の資料も参照してください。

言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。