Restore Points - Create

Referência

Serviço:: SQL Database

Versão da API:: 2021-11-01

Cria um ponto de restauro para um armazém de dados.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/restorePoints?api-version=2021-11-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
databaseName	path	True	string	O nome da base de dados.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	O ID da subscrição que identifica uma subscrição do Azure.
api-version	query	True	string	A versão da API a utilizar para o pedido.

Corpo do Pedido

Name	Necessário	Tipo	Description
restorePointLabel	True	string	A etiqueta do ponto de restauro a aplicar

Respostas

Name	Tipo	Description
200 OK	RestorePoint	O pedido do ponto de restauro foi criado com êxito.
201 Created	RestorePoint	O pedido do ponto de restauro foi criado com êxito.
202 Accepted		Aceite
Other Status Codes		Respostas de Erro: *** 400 BackupNotAllowedOnDeactivatedDatabase – não é possível criar um ponto de restauro numa base de dados desativada. 400 FeatureDisabledOnSelectedEdition – o utilizador tentou utilizar uma funcionalidade que está desativada na edição atual da base de dados. 400 RestorePointLimitReached – não é possível criar um ponto de restauro porque a base de dados excederia a quota permitida de pontos de restauro. 400 RestorePointAttemptToDeleteSystemBackup – não é possível eliminar o ponto de restauro do sistema. 404 DatabaseRestorePointNotFound – não é possível localizar o ponto de restauro da base de dados. 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado 404 DatabaseDoesNotExist – o utilizador especificou um nome de base de dados que não existe nesta instância do servidor. 404 OperationIdNotFound – a operação com o ID não existe. 408 DatabaseRestorePointTimedOut – Falha ao criar o ponto de restauro da base de dados. 409 OperationCancelled - A operação foi cancelada pelo utilizador. 409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso. 429 SubscriptionTooManyCreateUpdateRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação. 503 TooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis.

Exemplos

Creates datawarehouse database restore point.

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testserver/databases/testDatabase/restorePoints?api-version=2021-11-01

{
  "restorePointLabel": "mylabel"
}


import com.azure.resourcemanager.sql.models.CreateDatabaseRestorePointDefinition;

/**
 * Samples for RestorePoints Create.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/DatabaseRestorePointsPost.json
     */
    /**
     * Sample code: Creates datawarehouse database restore point.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createsDatawarehouseDatabaseRestorePoint(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getRestorePoints().create("Default-SQL-SouthEastAsia",
            "testserver", "testDatabase", new CreateDatabaseRestorePointDefinition().withRestorePointLabel("mylabel"),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Resposta da amostra

Código de estado:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/servers/testserver/databases/testDatabase/restorePoints/131546477590000000",
  "name": "131546477590000000",
  "type": "Microsoft.Sql/servers/databases/restorePoints",
  "location": "japaneast",
  "properties": {
    "restorePointType": "DISCRETE",
    "restorePointCreationDate": "2017-03-10T08:00:00Z",
    "restorePointLabel": "mylabel"
  }
}

Código de estado:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/servers/testserver/databases/testDatabase/restorePoints/131546477590000000",
  "name": "131546477590000000",
  "type": "Microsoft.Sql/servers/databases/restorePoints",
  "location": "southeastasia",
  "properties": {
    "restorePointType": "DISCRETE",
    "restorePointCreationDate": "2017-03-10T08:00:00Z",
    "restorePointLabel": "mylabel"
  }
}

Código de estado:: 202

Definições

Name	Description
CreateDatabaseRestorePointDefinition	Contém as informações necessárias para efetuar uma operação de criação do ponto de restauro da base de dados.
RestorePoint	Pontos de restauro da base de dados.
RestorePointType	O tipo de ponto de restauro

CreateDatabaseRestorePointDefinition

Contém as informações necessárias para efetuar uma operação de criação do ponto de restauro da base de dados.

Name	Tipo	Description
restorePointLabel	string	A etiqueta do ponto de restauro a aplicar

RestorePoint

Pontos de restauro da base de dados.

Name	Tipo	Description
id	string	ID do Recurso.
location	string	Localização do recurso.
name	string	Nome do recurso.
properties.earliestRestoreDate	string	A hora mais antiga para a qual esta base de dados pode ser restaurada
properties.restorePointCreationDate	string	O tempo que a cópia de segurança demorou
properties.restorePointLabel	string	A etiqueta do ponto de restauro para o pedido de cópia de segurança por utilizador
properties.restorePointType	RestorePointType	O tipo de ponto de restauro
type	string	Tipo de recurso.

RestorePointType

O tipo de ponto de restauro

Name	Tipo	Description
CONTINUOUS	string
DISCRETE	string

Partilhar via