TagResource - AWS Transfer Family

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

TagResource

Amazon リソースネーム () で識別されるように、キーと値のペアをリソースにアタッチしますARN。リソースは、ユーザー、サーバー、ロール、その他のエンティティです。

この呼び出しから返るレスポンスはありません。

リクエストの構文

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

リクエストパラメータ

すべてのアクションに共通のパラメータの詳細については、「共通パラメータ」を参照してください。

リクエストは、次のJSON形式のデータを受け入れます。

Arn

サーバー、ユーザー、ロールなど、特定の AWS リソースの Amazon リソースネーム (ARN)。

型: 文字列

長さの制限: 最小長は 20 です。最大長は 1600 です。

Pattern: arn:\S+

必須:はい

Tags

に割り当てられたキーと値のペアARNs。 を使用して、タイプ別にリソースをグループ化および検索できます。このメタデータは、あらゆる目的でリソース (サーバー、ユーザー、ワークフローなど) に添付できます。

型: Tag オブジェクトの配列

配列メンバー:最小数は 1 項目です。最大数は 50 項目です。

必須:はい

レスポンス要素

アクションが成功すると、サービスは空のHTTP本文で 200 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" } ] }

この例では、 の 1 つの使用状況を示しています TagResource。

レスポンス例

HTTP 200 response with an empty HTTP body.

以下の資料も参照してください。

言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。