Todos os produtos
Search
Central de documentação

:Criar uma instância temporária

Última atualização: Jul 08, 2026

Chame a operação CreateTempDBInstance para criar uma instância temporária.

Crie uma instância temporária com base em um arquivo de backup ou em um ponto no tempo dos últimos sete dias.

Antes de chamar esta operação, verifique se os seguintes requisitos foram atendidos:

  • A instância executa o SQL Server 2008 R2.

  • A instância está no estado Running.

  • Não há tarefas de migração em andamento na instância.

  • A criação do último arquivo de backup foi concluída.

Nota

Após a criação da instância temporária, as contas e os bancos de dados herdam os dados do arquivo de backup.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim CreateTempDBInstance

A operação a ser executada. Defina o valor como CreateTempDBInstance.

DBInstanceId String Sim rm-uf6wjk5xxxxxxx

O ID da instância.

BackupId Integer Não 603524168

O ID do arquivo de backup.

Nota Especifique o parâmetro BackupId ou RestoreTime.
RestoreTime String Não 2011-06-11T16:00:00Z

O ponto no tempo especificado dentro do período de retenção de backup. Especifique a hora no padrão ISO 8601 no formato aaaa-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.

Nota
  • A hora pode ser definida como um ponto no tempo dos últimos sete dias e deve ser anterior à hora atual em mais de 30 minutos. O fuso horário padrão é UTC.
  • Especifique o parâmetro BackupId ou RestoreTime.
ResourceGroupId String Não rg-acfmy*****

O ID do grupo de recursos.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

TempDBInstanceId

String

sub138xxxxx_rm-xxxxx

O ID da instância temporária.

RequestId

String

248DE93F-8647-4B9D-8287-4A4A0FE56AD5

O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=CreateTempDBInstance
&DBInstanceId=rm-uf6wjk5xxxxxxx
&BackupId=603524168
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateTempDBInstanceResponse>
     <RequestId>248DE93F-8647-4B9D-8287-4A4A0FE56AD5</RequestId>
<TempDBInstanceId>sub138xxxxx_juxxxxx</TempDBInstanceId>
</CreateTempDBInstanceResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "248DE93F-8647-4B9D-8287-4A4A0FE56AD5",
  "TempDBInstanceId" : "sub138xxxxx_juxxxxx"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400

OperationDenied.DBInstanceStatus

The operation is not permitted due to status of instance.

Mensagem de erro retornada porque a operação não é suportada quando a instância está no estado atual.

403

OperationDenied.TempDBInstanceExists

The operation is not permitted due to temp instance exist.

Mensagem de erro retornada porque a operação não é suportada quando já existe uma instância temporária criada para a instância atual.

404

InvalidDBInstanceName.NotFound

The specified db instance is not found.

Mensagem de erro retornada porque a operação não é suportada quando a instância não existe.

Para obter uma lista de códigos de erro, visite o API Error Center.