TagResource - AWS Transfer Family
請求語法請求參數回應元素錯誤範例另請參閱

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

TagResource

將鍵值對連接至資源，如其 Amazon Resource Name （ARN） 所識別。資源是使用者、伺服器、角色和其他實體。

此通話未傳回任何回應。

請求語法

{
   "Arn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

請求參數

如需所有動作的一般參數資訊，請參閱《Common Parameters》。

請求接受下列JSON格式的資料。

Arn

特定 AWS 資源的 Amazon Resource Name （ARN），例如伺服器、使用者或角色。

類型：字串

長度限制︰長度下限為 20。長度上限為 1600。

模式：arn:\S+

必要：是

Tags

指派給 ARNs 的鍵值對，可用來依類型分組和搜尋資源。您可以將此中繼資料連接到資源 （伺服器、使用者、工作流程等） 以用於任何用途。

類型：Tag 物件陣列

陣列成員：項目數下限為 1。項目數上限為 50。

必要：是

回應元素

如果動作成功，服務會傳回 200 HTTP 回應，其中內HTTP文為空白。

錯誤

如需所有動作常見錯誤的資訊，請參閱常見錯誤。

InternalServiceError

當 AWS Transfer Family 服務發生錯誤時，就會擲回此例外狀況。

HTTP 狀態碼：500

InvalidRequestException

當用戶端提交格式錯誤的請求時，就會擲回此例外狀況。

HTTP 狀態碼：400

ResourceNotFoundException

當 AWS Transfer Family 服務找不到資源時，就會擲回此例外狀況。

HTTP 狀態碼：400

ServiceUnavailableException

請求失敗，因為 AWS Transfer Family 服務無法使用。

HTTP 狀態碼：500

範例

範例

下列範例會將標籤新增至已啟用檔案傳輸通訊協定的伺服器。

請求範例


{
   "Arn": "arn:aws:transfer:us-east-1:176354371281:server/s-01234567890abcdef",
   "Tags": [ 
      { 
         "Key": "Group",
         "Value": "Europe"
      }
   ]
}

範例

此範例說明 的一個用量 TagResource。

回應範例


          HTTP 200 response with an empty HTTP body.

另請參閱

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