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 pontos de recuperação.
Obrigatório: BackupVaultName, RecoveryPointArn, e IAMRole Arn
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 hífens.
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 da função 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
ACTIVErecuperação qualificado 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 pontoACTIVEde recuperação qualificado 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|FAILEDDELETINGUm ponto de recuperação com um índice com 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 uma das linguagens específicas AWS SDKs, consulte o seguinte: