UntagResource - AWS Transfer Family

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

UntagResource

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

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

リクエストの構文

{ "Arn": "string", "TagKeys": [ "string" ] }

リクエストパラメータ

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

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

Arn

削除されるタグを含んでいるリソースの値。Amazon リソースネーム (ARN) は、AWS サーバー、ユーザー、ロールなど具体的なリソースの識別子です。

型: 文字列

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

Pattern: arn:\S+

必須:はい

TagKeys

TagKeys は ARNsキーと値のペアで、リソースをタイプ別にグループ化および検索するために使用できます。このメタデータは、任意の目的でリソースにアタッチできます。

型: 文字列の配列

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

長さの制限: 最小長は 0 です。最大長は 128 です。

必須: はい

レスポンス要素

アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。

エラー

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

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", "TagKeys": "Europe" ] }

この例では、 の使用方法の 1 つを示します UntagResource。

レスポンス例

HTTP 200 response with an empty HTTP body.

その他の参照資料

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