本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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"
}
]
}
回應元素
如果動作成功,服務會傳回 HTTP 200 回應。
服務會以JSON格式傳回下列資料。
錯誤
- AccessPointNotFound
-
如果請求者中不存在指定的
AccessPointId
AWS 帳戶值,則返回。HTTP狀態碼:4
- BadRequest
-
如果請求格式錯誤或包含錯誤,例如無效的參數值或缺少必要參數,則傳回。
HTTP狀態碼:4
- FileSystemNotFound
-
如果請求者中不存在指定的
FileSystemId
AWS 帳戶值,則返回。HTTP狀態碼:4
- InternalServerError
-
如果伺服器端發生錯誤,則傳回。
HTTP狀態碼:5
另請參閱
如需API在其中一種特定語言中使用此功能的詳細資訊 AWS SDKs,請參閱下列內容: