翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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 形式のデータを受け入れます。
レスポンスの構文
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 を使用する方法の詳細については、以下を参照してください。