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

# UpdateRecoveryPointIndexSettings
<a name="API_UpdateRecoveryPointIndexSettings"></a>

このオペレーションは、復旧ポイントインデックスの設定を更新します。

必須: BackupVaultName、RecoveryPointArn、IAMRoleArn

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

```
POST /backup-vaults/backupVaultName/recovery-points/recoveryPointArn/index HTTP/1.1
Content-type: application/json

{
   "IamRoleArn": "string",
   "Index": "string"
}
```

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

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

 ** [backupVaultName](#API_UpdateRecoveryPointIndexSettings_RequestSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-request-uri-BackupVaultName"></a>
バックアップを保存する論理コンテナの名前。バックアップボールトは、これらのボールトを作成するために使用されたアカウントと作成先の リージョンに一意の名前で識別されます。  
使用できる文字は、小文字の英文字、数字、ハイフンです。  
パターン: `^[a-zA-Z0-9\-\_]{2,50}$`   
必須: はい

 ** [recoveryPointArn](#API_UpdateRecoveryPointIndexSettings_RequestSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-request-uri-RecoveryPointArn"></a>
たとえば、`arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45`などのリカバリポイントを一意に識別する ARN。  
必須: はい

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

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

 ** [IamRoleArn](#API_UpdateRecoveryPointIndexSettings_RequestSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-request-IamRoleArn"></a>
これは、このオペレーションに使用される IAM ロール の ARN を指定します。  
例えば、arn:aws:iam::123456789012:role/S3Access  
タイプ: 文字列  
必須: いいえ

 ** [Index](#API_UpdateRecoveryPointIndexSettings_RequestSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-request-Index"></a>
インデックスには、`ENABLED` または `DISABLED` の 2 つの値のいずれかを指定できます。  
バックアップインデックスがまだ作成されていない、対象となる `ACTIVE` 復旧ポイントのバックアップインデックスを作成するには、値を `ENABLED` に設定します。  
バックアップインデックスを削除するには、値を `DISABLED` に設定します。  
型: 文字列  
有効な値: `ENABLED | DISABLED`   
必須: はい

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

```
HTTP/1.1 200
Content-type: application/json

{
   "BackupVaultName": "string",
   "Index": "string",
   "IndexStatus": "string",
   "RecoveryPointArn": "string"
}
```

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

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [BackupVaultName](#API_UpdateRecoveryPointIndexSettings_ResponseSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-response-BackupVaultName"></a>
バックアップを保存する論理コンテナの名前。バックアップボールトは、これらのボールトを作成するために使用されたアカウントと作成先の リージョンに一意の名前で識別されます。  
タイプ: 文字列  
パターン: `^[a-zA-Z0-9\-\_]{2,50}$` 

 ** [Index](#API_UpdateRecoveryPointIndexSettings_ResponseSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-response-Index"></a>
インデックスには、`ENABLED` または `DISABLED` の 2 つの値のいずれかを指定できます。  
値 `ENABLED` は、対象となる `ACTIVE` 復旧ポイントのバックアップインデックスが作成されたことを意味します。  
値 `DISABLED` は、バックアップインデックスが削除されたことを意味します。  
型: 文字列  
有効な値：`ENABLED | DISABLED`

 ** [IndexStatus](#API_UpdateRecoveryPointIndexSettings_ResponseSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-response-IndexStatus"></a>
これは、指定された復旧ポイントに関連付けられたバックアップインデックスの現在のステータスです。  
ステータス: `PENDING` \$1 `ACTIVE` \$1 `FAILED` \$1 `DELETING`   
ステータスが `ACTIVE` のインデックスを持つ復旧ポイントは、検索に含めることができます。  
型: 文字列  
有効な値：`PENDING | ACTIVE | FAILED | DELETING`

 ** [RecoveryPointArn](#API_UpdateRecoveryPointIndexSettings_ResponseSyntax) **   <a name="Backup-UpdateRecoveryPointIndexSettings-response-RecoveryPointArn"></a>
リカバリーポイントを一意に識別する ARN、たとえば、`arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45` です。  
タイプ: 文字列

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

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

 ** InvalidParameterValueException **   
パラメータの値に問題があることを示します。たとえば、値が範囲外であることです。    
 ** Context **   
  
 ** Type **   

HTTP ステータスコード: 400

 ** InvalidRequestException **   
リクエストへの入力に何らかの問題が発生していることを示します。たとえば、パラメータのタイプが間違っています。    
 ** Context **   
  
 ** Type **   

HTTP ステータスコード: 400

 ** MissingParameterValueException **   
必須パラメータがないことを示します。    
 ** Context **   
  
 ** Type **   

HTTP ステータスコード: 400

 ** ResourceNotFoundException **   
アクションに必要なリソースは存在しません。    
 ** Context **   
  
 ** Type **   

HTTP ステータスコード: 400

 ** ServiceUnavailableException **   
サーバーの一時的障害のため、リクエストは失敗しました。    
 ** Context **   
  
 ** Type **   

HTTP ステータスコード: 500

## その他の参照資料
<a name="API_UpdateRecoveryPointIndexSettings_SeeAlso"></a>

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