As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
UpdateRecoveryPointIndexSettings
Essa operação atualiza as configurações de um índice de ponto de recuperação.
Obrigatório: BackupVaultName, RecoveryPointArn e IAMRoleArn
Sintaxe da Solicitação
POST /backup-vaults/backupVaultName/recovery-points/recoveryPointArn/index HTTP/1.1
Content-type: application/json
{
"IamRoleArn": "string",
"Index": "string"
}
Parâmetros da Solicitação de URI
A solicitação usa os seguintes parâmetros de URI:
- backupVaultName
-
O nome de um contêiner lógico onde os backups são armazenados. Os cofres de backup são identificados por nomes que são exclusivos da conta usada para criá-los e a região da em que são criados.
Os caracteres aceitos incluem letras minúsculas, números e hifens.
Padrão: :
^[a-zA-Z0-9\-\_]{2,50}$Exigido: Sim
- recoveryPointArn
-
Um ARN que identifica de forma exclusiva um ponto de recuperação. Por exemplo,
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.Obrigatório: Sim
Corpo da Solicitação
A solicitação aceita os dados a seguir no formato JSON.
- IamRoleArn
-
Isso especifica o ARN do perfil do IAM usado para essa operação.
Por exemplo, arn:aws:iam::123456789012:role/S3Access
Tipo: String
Obrigatório: Não
- Index
-
O índice pode ter 1 de 2 valores possíveis,
ENABLEDouDISABLED.Para criar um índice de backup para um ponto de recuperação
ACTIVEqualificado que ainda não tenha um índice de backup, defina o valor comoENABLED.Para excluir um índice de backup, defina o valor como
DISABLED.Tipo: String
Valores Válidos:
ENABLED | DISABLEDExigido: Sim
Sintaxe da Resposta
HTTP/1.1 200
Content-type: application/json
{
"BackupVaultName": "string",
"Index": "string",
"IndexStatus": "string",
"RecoveryPointArn": "string"
}
Elementos de Resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
- BackupVaultName
-
O nome de um contêiner lógico onde os backups são armazenados. Os cofres de backup são identificados por nomes que são exclusivos da conta usada para criá-los e a região da em que são criados.
Tipo: sequência
Padrão: :
^[a-zA-Z0-9\-\_]{2,50}$ - Index
-
O índice pode ter 1 de 2 valores possíveis,
ENABLEDouDISABLED.Um valor de
ENABLEDsignifica que um índice de backup para um ponto de recuperaçãoACTIVEelegível foi criado.Um valor de
DISABLEDsignifica que um índice de backup foi excluído.Tipo: String
Valores Válidos:
ENABLED | DISABLED - IndexStatus
-
Esse é o status atual do índice de backup associado ao ponto de recuperação especificado.
Os status são:
PENDING|ACTIVE|FAILED|DELETINGUm ponto de recuperação com um índice que possui o status de
ACTIVEpode ser incluído em uma pesquisa.Tipo: String
Valores Válidos:
PENDING | ACTIVE | FAILED | DELETING - RecoveryPointArn
-
Um ARN que identifica de forma exclusiva um ponto de recuperação. Por exemplo,
arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.Tipo: String
Erros
Para obter informações sobre os erros comuns a todas as ações, consulte Erros comuns.
- InvalidParameterValueException
-
Indica que há algo errado com o valor de um parâmetro. Por exemplo, o valor está fora do intervalo.
- Context
- Type
Código de Status HTTP: 400
- InvalidRequestException
-
Indica que há algo errado com a entrada da solicitação. Por exemplo, um parâmetro é do tipo errado.
- Context
- Type
Código de Status HTTP: 400
- MissingParameterValueException
-
Indica que um parâmetro necessário está ausente.
- Context
- Type
Código de Status HTTP: 400
- ResourceNotFoundException
-
Um recurso necessário para a ação não existe.
- Context
- Type
Código de Status HTTP: 400
- ServiceUnavailableException
-
Houve falha na solicitação devido a um erro temporário do servidor.
- Context
- Type
Código de Status HTTP: 500
Consulte também
Para obter mais informações sobre como usar essa API em um dos SDKs específicos de linguagem AWS, consulte: