翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
UpdateRecoveryPointIndexSettings
このオペレーションは、復旧ポイントインデックスの設定を更新します。
必須: BackupVaultName、RecoveryPointArn、IAMRoleArn
リクエストの構文
POST /backup-vaults/backupVaultName/recovery-points/recoveryPointArn/index HTTP/1.1
Content-type: application/json
{
"IamRoleArn": "string",
"Index": "string"
}URI リクエストパラメータ
リクエストでは、次の URI パラメータを使用します。
- backupVaultName
-
バックアップを保存する論理コンテナの名前。バックアップボールトは、これらのボールトを作成するために使用されたアカウントと作成先の リージョンに一意の名前で識別されます。
使用できる文字は、小文字の英文字、数字、ハイフンです。
パターン:
^[a-zA-Z0-9\-\_]{2,50}$必須: はい
- recoveryPointArn
-
たとえば、
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45などのリカバリポイントを一意に識別する ARN。必須: はい
リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
- IamRoleArn
-
これは、このオペレーションに使用される IAM ロール の ARN を指定します。
例えば、arn:aws:iam::123456789012:role/S3Access
タイプ: 文字列
必須: いいえ
- Index
-
インデックスには、
ENABLEDまたはDISABLEDの 2 つの値のいずれかを指定できます。バックアップインデックスがまだ作成されていない、対象となる
ACTIVE復旧ポイントのバックアップインデックスを作成するには、値をENABLEDに設定します。バックアップインデックスを削除するには、値を
DISABLEDに設定します。型: 文字列
有効な値：
ENABLED | DISABLED必須: はい
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultName": "string",
"Index": "string",
"IndexStatus": "string",
"RecoveryPointArn": "string"
}レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- BackupVaultName
-
バックアップを保存する論理コンテナの名前。バックアップボールトは、これらのボールトを作成するために使用されたアカウントと作成先の リージョンに一意の名前で識別されます。
タイプ: 文字列
パターン:
^[a-zA-Z0-9\-\_]{2,50}$ - Index
-
インデックスには、
ENABLEDまたはDISABLEDの 2 つの値のいずれかを指定できます。値
ENABLEDは、対象となるACTIVE復旧ポイントのバックアップインデックスが作成されたことを意味します。値
DISABLEDは、バックアップインデックスが削除されたことを意味します。型: 文字列
有効な値：
ENABLED | DISABLED - IndexStatus
-
これは、指定された復旧ポイントに関連付けられたバックアップインデックスの現在のステータスです。
ステータス:
PENDING|ACTIVE|FAILED|DELETINGステータスが
ACTIVEのインデックスを持つ復旧ポイントは、検索に含めることができます。型: 文字列
有効な値：
PENDING | ACTIVE | FAILED | DELETING - RecoveryPointArn
-
リカバリーポイントを一意に識別する ARN、たとえば、
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45です。タイプ: 文字列
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- 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
その他の参照資料
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
