View a markdown version of this page

CreateTags - Amazon Elastic File System
リクエストの構文URI リクエストパラメータリクエストボディレスポンスの構文レスポンス要素エラーその他の参照資料

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

CreateTags

注記

非推奨 - CreateTags は非推奨であり、維持されません。EFS リソースのタグを作成するには、TagResource の API アクションを使用します。

ファイルシステムに関連付けられたタグを作成または上書きします。各タグはキーバリューのペアです。リクエストで指定されたタグキーがファイルシステム上にすでに存在する場合、このオペレーションは、リクエストで指定された値でその値を上書きします。Name のタグをファイルシステムに追加すると、Amazon EFS は DescribeFileSystemsのオペレーションに対する応答でタグを返します。

このオペレーションには elasticfilesystem:CreateTags アクションに対するアクセス許可が必要です。

リクエストの構文

POST /2015-02-01/create-tags/FileSystemId HTTP/1.1
Content-type: application/json

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

URI リクエストパラメータ

リクエストでは、次の URI パラメータを使用します。

FileSystemId

変更するタグが付けられたファイルシステムの ID (文字列)。このオペレーションでは、ファイルシステムは変更されず、タグのみが変更されます。

長さの制約: 最大長は 128 です。

パターン: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

必須: はい

リクエストボディ

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

Tags

追加する Tag オブジェクトの配列。各 Tag オブジェクトタグはキーバリューのペアです。

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

必須: はい

レスポンスの構文

HTTP/1.1 204

レスポンス要素

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

エラー

BadRequest

リクエストの形式が正しくない場合や、無効なパラメータ値や必須パラメータの欠落などのエラーが含まれている場合に返されます。

ErrorCode

エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。

Message

エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。

HTTP ステータスコード: 400

FileSystemNotFound

指定されたFileSystemId値がリクエスタの に存在しない場合に返されます AWS アカウント。

ErrorCode

エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。

Message

エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。

HTTP ステータスコード: 404

InternalServerError

サーバー側でエラーが発生した場合に返されます。

ErrorCode

エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。

Message

エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。

HTTP ステータスコード: 500

その他の参照資料

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