TagResource - Amazon Elastic File System

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

TagResource

EFS リソースのタグの作成。この API オペレーションを使用して、EFS ファイルシステムおよびアクセスポイントのタグを作成できます。

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

リクエストの構文

POST /2015-02-01/resource-tags/ResourceId HTTP/1.1 Content-type: application/json { "Tags": [ { "Key": "string", "Value": "string" } ] }

URI リクエストパラメータ

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

ResourceId

タグを作成する EFS リソースを指定する ID。

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

Pattern: ^(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})$

必須: はい

リクエストボディ

リクエストは以下の JSON 形式のデータを受け入れます。

Tags

追加する Tag オブジェクトの配列。各 Tag オブジェクトタグはキーバリューのペアです。

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

必須: はい

レスポンスの構文

HTTP/1.1 200

レスポンス要素

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

エラー

AccessPointNotFound

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

HTTP ステータスコード: 404

BadRequest

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

HTTP ステータスコード:400

FileSystemNotFound

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

HTTP ステータスコード: 404

InternalServerError

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

HTTP ステータスコード:500

ファイルシステム上でのタグの作成

次のリクエストは、指定されたファイルシステムに 3 つのタグ("key1","key2",および "key3")を作成します。

リクエスト例

POST /2015-02-01/tag-resource/fs-01234567 HTTP/1.1 Host: elasticfilesystem.us-west-2.amazonaws.com x-amz-date: 20140620T221118Z Authorization: <...> Content-Type: application/json Content-Length: 160 { "Tags": [ { "Key": "key1", "Value": "value1" }, { "Key": "key2", "Value": "value2" }, { "Key": "key3", "Value": "value3" } ] }

レスポンス例

HTTP/1.1 204 no content x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef

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

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