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

# PutAccountName
<a name="API_PutAccountName"></a>

指定されたアカウントのアカウント名を更新します。この API を使用するには、IAM プリンシパルに `account:PutAccountName` IAM アクセス許可が必要です。

## リクエストの構文
<a name="API_PutAccountName_RequestSyntax"></a>

```
POST /putAccountName HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "AccountName": "string"
}
```

## URI リクエストパラメータ
<a name="API_PutAccountName_RequestParameters"></a>

リクエストでは URI パラメータを使用しません。

## リクエストボディ
<a name="API_PutAccountName_RequestBody"></a>

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

 ** [AccountId](#API_PutAccountName_RequestSyntax) **   <a name="accounts-PutAccountName-request-AccountId"></a>
このオペレーションでアクセスまたは変更するアカウントの 12 桁の AWS アカウント ID 番号を指定します。  
このパラメータを指定しない場合、デフォルトで オペレーションの呼び出しに使用される ID の AWS アカウントになります。  
このパラメータを使用するには、呼び出し元が[組織の管理アカウント](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account)または委任管理者アカウント、および指定されたアカウント ID は、同じ組織内のメンバーアカウントである必要があります。組織は[すべての機能を有効化](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html)して、アカウント管理サービス用の有効な[信頼されたアクセス](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html)を持つ必要があり、オプションとして[委任管理者](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin)アカウントが割り当てられます。  
管理アカウントは独自の `AccountId` アカウントを指定できません; これは、`AccountId` パラメータを含めないことにより、スタンドアロンコンテキストでの操作を呼び出さなければなりません。
組織のメンバーではないアカウントでこの操作を呼び出すには、このパラメータを指定せず、取得または変更する取引先責任者のアカウントに属する ID を使用して操作を呼び出します。  
タイプ: 文字列  
パターン: `\d{12}`   
必須: いいえ

 ** [AccountName](#API_PutAccountName_RequestSyntax) **   <a name="accounts-PutAccountName-request-AccountName"></a>
アカウントの名前。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 50 です。  
パターン: `[ -;=?-~]+`   
必須: はい

## レスポンスの構文
<a name="API_PutAccountName_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## レスポンス要素
<a name="API_PutAccountName_ResponseElements"></a>

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

## エラー
<a name="API_PutAccountName_Errors"></a>

すべてのアクションに共通のエラーについては、「[一般的なエラータイプ](CommonErrors.md)」を参照してください。

 ** AccessDeniedException **   
呼び出し元の ID に必要な最小アクセス許可がないため、操作が失敗しました。    
 ** errorType **   
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 403

 ** InternalServerException **   
内部エラーのため、オペレーションが失敗しました AWS。後でもう一度操作をお試しください。    
 ** errorType **   
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 500

 ** TooManyRequestsException **   
操作が頻繁に呼び出され、スロットルの制限を超えているため、操作が失敗しました。    
 ** errorType **   
API Gateway によって `x-amzn-ErrorType` レスポンスヘッダーに入力された値。
HTTP ステータスコード: 429

 ** ValidationException **   
入力パラメータのいずれかが無効であるため、操作が失敗しました。    
 ** fieldList **   
無効なエントリが検出されたフィールド。  
 ** message **   
リクエストのどの部分が無効だったかを知らせるメッセージ。  
 ** reason **   
検証が失敗した理由。
HTTP ステータスコード: 400

## 例
<a name="API_PutAccountName_Examples"></a>

### 例 1
<a name="API_PutAccountName_Example_1"></a>

次の例では、オペレーションの呼び出しに使用される認証情報を持つアカウント名を更新します。

#### リクエスト例
<a name="API_PutAccountName_Example_1_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAccountName
                    
{
   "AccountName":"MyAccount"
}
```

#### レスポンス例
<a name="API_PutAccountName_Example_1_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json
```

### 例 2
<a name="API_PutAccountName_Example_2"></a>

次の例では、組織内の指定されたメンバーアカウントのアカウント名を更新します。組織の管理アカウントまたはアカウント管理サービスの委任管理者アカウントの認証情報を使用する必要があります。

#### リクエスト例
<a name="API_PutAccountName_Example_2_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAccountName
                    
{
   "AccountId": "123456789012",
   "AccountName": "MyMemberAccount"
}
```

#### レスポンス例
<a name="API_PutAccountName_Example_2_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json
```

## 以下の資料も参照してください。
<a name="API_PutAccountName_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/PutAccountName) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutAccountName) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutAccountName) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutAccountName) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutAccountName) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutAccountName) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutAccountName) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutAccountName) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutAccountName) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutAccountName)