翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
PutAccountPreferences
このオペレーションを使用して、新しい EFS ファイルシステムとマウントターゲットリソースに、長い 17 文字 (63 ビット) または短い 8 文字 (32 ビット) のリソース ID を使用するように現在の AWS リージョン のアカウント環境設定を設定します。既存のリソース ID はすべて、変更の影響を受けません。EFS が長いリソース ID に移行するときに、オプトイン期間中に ID プリファレンスを設定できます。詳細については、「Amazon EFS リソース ID の管理」を参照してください。
注記
2021 年 10 月以降、短い 8 文字形式のリソース ID を使用するようにアカウント設定をしようとすると、エラーが表示されます。エラーが表示され、ファイルシステムとマウントターゲットリソースに短い IDs を使用する必要がある場合は、 AWS サポートにお問い合わせください。
リクエストの構文
PUT /2015-02-01/account-preferences HTTP/1.1
Content-type: application/json
{
"ResourceIdType": "string"
}URI リクエストパラメータ
リクエストでは URI パラメータを使用しません。
リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
- ResourceIdType
-
ユーザーの に設定する EFS リソース ID 設定を AWS アカウント、現在の
LONG_ID(17 文字) AWS リージョンまたはSHORT_ID(8 文字) で指定します。注記
2021 年 10 月以降、アカウント設定を
SHORT_IDにするとエラーが表示されます。エラーが表示され、ファイルシステムとマウントターゲットリソースに短い IDs を使用する必要がある場合は、 AWS サポートにお問い合わせください。型: 文字列
有効な値：
LONG_ID | SHORT_ID必須: はい
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"ResourceIdPreference": {
"ResourceIdType": "string",
"Resources": [ "string" ]
}
}レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- ResourceIdPreference
-
現在の AWS アカウントのリソースタイプとそのユーザーの ID 設定について説明します AWS リージョン。
型: ResourceIdPreference オブジェクト
エラー
- BadRequest
-
リクエストの形式が正しくない場合や、無効なパラメータ値や必須パラメータの欠落などのエラーが含まれている場合に返されます。
- ErrorCode
-
エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。
- Message
-
エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。
HTTP ステータスコード: 400
- InternalServerError
-
サーバー側でエラーが発生した場合に返されます。
- ErrorCode
-
エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。
- Message
-
エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。
HTTP ステータスコード: 500
その他の参照資料
言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
