CheckRecoveryCondition - ApsaraDB for MongoDB: Central de Documentação do Alibaba Cloud

Verifica se uma instância do MongoDB atende às condições para restauração de dados.

Descrição da operação

Esta operação é aplicável a instâncias de conjunto de réplicas ou instâncias de cluster fragmentado.

Nota

Após chamar esta operação para confirmar que as condições para restauração de dados são atendidas, você pode chamar a operação CreateDBInstance para restaurar dados em uma nova instância.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

dds:CheckRecoveryCondition

get

*Instance

acs:dds:{#regionId}:{#accountId}:dbinstance/{#dbinstanceId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
SourceDBInstance	string	Sim	O ID da instância de origem a ser recuperada.	dds-bp1378****
DatabaseNames	string	Não	Os nomes dos bancos de dados a serem restaurados. O valor é uma matriz JSON. Nota Se você não especificar este parâmetro, todos os bancos de dados serão restaurados por padrão.	["db1","db2"]
RestoreTime	string	Não	O ponto no tempo para o qual você deseja restaurar a instância. Especifique o horário no formato yyyy-MM-ddTHH:mm:ssZ. O horário deve estar em UTC. Nota O valor pode ser qualquer ponto no tempo dentro dos últimos sete dias. O valor deve ser anterior ao horário atual e posterior ao horário de criação da instância. Você deve especificar este parâmetro ou o parâmetro BackupId.	2022-08-22T08:00:00Z
BackupId	string	Não	O ID do conjunto de backups. Nota Você pode chamar a operação DescribeBackups para consultar o ID do backup. Você deve especificar este parâmetro ou o parâmetro RestoreTime. Este parâmetro não é compatível com instâncias de cluster fragmentado.	5664****
ResourceGroupId	string	Não	O ID do grupo de recursos.	sg-bp179****
SourceDBInstance	string	Sim	A área onde a instância de origem reside. Nota Este parâmetro é obrigatório quando o tipo de recuperação de backup é a reconstrução de uma instância excluída. Este parâmetro é obrigatório quando o tipo de recuperação de backup é a clonagem de georredudância.	cn-beijing
SrcRegion	string	Não	A área onde o conjunto de backups reside durante a recuperação de georredudância. Nota Este parâmetro é obrigatório quando o tipo de recuperação de backup é a clonagem de georredudância.	cn-hangzhou
DestRegion	string	Não	O tipo de recuperação de backup. Valores válidos: Nota 0: recuperação de backup local 1: recuperação de ponto no tempo local 2: recuperação de backup de uma instância excluída usando um conjunto de backups 3: recuperação de backup de georredudância usando um conjunto de backups	0
RestoreType	string	Não	O tipo de instância. Valores válidos: replicate sharding Nota Este parâmetro é obrigatório quando o tipo de recuperação de backup é a reconstrução de uma instância excluída. Este parâmetro é obrigatório quando o tipo de recuperação de backup é a clonagem de georredudância.	replicate
InstanceType	string	Não	A versão do banco de dados. Valores válidos: 8.0 7.0 6.0 5.0 4.4 4.2 4.0	4.2
EngineVersion	string	Não	A versão do mecanismo de banco de dados da instância. 6.0 5.0 4.4 4.2 4.0 3.4	4.2

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	As informações da resposta.
RequestId	string	O ID da solicitação.	D563A3E7-6010-45FE-A0CD-9283414C9657
DBInstanceName	string	O ID da instância.	dds-bp1378****
IsValid	boolean	Indica se as condições de restauração são atendidas. Valores válidos: true: As condições são atendidas. false: As condições não são atendidas.	true

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "D563A3E7-6010-45FE-A0CD-9283414C9657",
  "DBInstanceName": "dds-bp1378****",
  "IsValid": true
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidMeta.WrongFormat	Meta information is wrong formatter.
400	InvalidRestoreTime.Format	Specified restore time is not valid.	O parâmetro RestoreTime especificado é inválido. Verifique se o parâmetro de entrada está correto.
403	InvalidDBName	The specified database name is not allowed.	O nome do banco de dados especificado é inválido.
403	InvalidMeta.TooLarge	Meta information is too large.	Os metadados são muito grandes.
403	SingleDBRestore.BackupSetNotSupport	This backup set do not support this operation.	O ponto no tempo ou o arquivo de backup selecionado não suporta a restauração de banco de dados único.
403	IncorrectDBInstanceType	Current DB instance type does not support this operation.
403	IncorrectEngineVersion	Current engine version does not support operations.
403	InvalidBackupLogStatus	Current backup log enable status does not support this operation.	O status atual do log de backup não suporta esta operação.
403	IncorrectBackupSetState	Current backup set state does not support operations..
404	InvalidBackupSetID.NotFound	Specifiedbackup set ID does not exist.
404	InvalidBackup.NotFound	Theavailable backup does not exist in recovery time.	Nenhum backup está disponível dentro do período de restauração especificado.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.