View a markdown version of this page

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" } ] }

回應元素

如果動作成功,則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

NextToken

如果對回應承載進行分頁,那麽將會出現 NextToken。您可以在後續請求中使用 NextToken 來擷取下一頁的存取點描述。

類型:字串

長度限制:長度下限為 1。長度上限為 128。

模式:.+

Tags

指定 EFS 資源的標籤陣列。

類型:Tag 物件陣列

錯誤

AccessPointNotFound

如果指定的AccessPointId值不存在於請求者的 中,則傳回 AWS 帳戶。

ErrorCode

錯誤代碼是一個字串,專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。

Message

錯誤訊息包含錯誤狀況的一般英文描述,目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時,會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密,而且經過適當的國際化,所以很可能會忽略錯誤訊息。

HTTP 狀態碼:404

BadRequest

如果請求格式錯誤或包含錯誤,例如無效的參數值或缺少必要參數,則傳回。

ErrorCode

錯誤代碼是一個字串,專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。

Message

錯誤訊息包含錯誤狀況的一般英文描述,目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時,會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密,而且經過適當的國際化,所以很可能會忽略錯誤訊息。

HTTP 狀態碼:400

FileSystemNotFound

如果指定的FileSystemId值不存在於請求者的 中,則傳回 AWS 帳戶。

ErrorCode

錯誤代碼是一個字串,專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。

Message

錯誤訊息包含錯誤狀況的一般英文描述,目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時,會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密,而且經過適當的國際化,所以很可能會忽略錯誤訊息。

HTTP 狀態碼:404

InternalServerError

如果伺服器端發生錯誤,則傳回。

ErrorCode

錯誤代碼是一個字串,專門用於識別錯誤狀況。偵測及依類型處理錯誤的程式必須讀取及了解此代碼。

Message

錯誤訊息包含錯誤狀況的一般英文描述,目標對象是人。一般簡單的程式在發生其無法處理的錯誤狀況時,會直接對最終使用者顯示訊息。複雜一些的程式因為錯誤處理更加周密,而且經過適當的國際化,所以很可能會忽略錯誤訊息。

HTTP 狀態碼:500

另請參閱

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊,請參閱下列內容: