本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
建立 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。
模式:
^(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
範例
建立檔案系統標籤
下列請求會在指定的檔案系統上建立三個標籤 ("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 SDKs中使用此 API 的詳細資訊,請參閱下列內容: