Restore Points - Create

Referência

Service:: SQL Database

API Version:: 2021-11-01

Cria um ponto de restauração para um data warehouse.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
databaseName	path	True	string	O nome do banco de dados.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	A ID de assinatura que identifica uma assinatura do Azure.
api-version	query	True	string	A versão da API a ser usada para a solicitação.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
restorePointLabel	True	string	O rótulo do ponto de restauração a ser aplicado

Respostas

Nome	Tipo	Description
200 OK	RestorePoint	A solicitação do ponto de restauração foi criada com êxito.
201 Created	RestorePoint	A solicitação do ponto de restauração foi criada com êxito.
202 Accepted		Aceito
Other Status Codes		Respostas de erro: *** 400 BackupNotAllowedOnDeactivatedDatabase - Não é possível criar um ponto de restauração em um banco de dados desativado. 400 FeatureDisabledOnSelectedEdition - O usuário tentou usar um recurso que está desabilitado na edição atual do banco de dados. 400 RestorePointLimitReached - Não é possível criar um ponto de restauração porque o banco de dados excederia a cota permitida de pontos de restauração. 400 RestorePointAttemptToDeleteSystemBackup – não é possível excluir o ponto de restauração do sistema. 404 DatabaseRestorePointNotFound - Não é possível localizar o ponto de restauração do banco de dados. 404 SubscriptionDoesNotHaveServer - O servidor solicitado não foi encontrado 404 DatabaseDoesNotExist - O usuário especificou um nome de banco de dados que não existe nesta instância de servidor. 404 OperationIdNotFound - A operação com Id não existe. 408 DatabaseRestorePointTimedOut – Falha ao criar ponto de restauração de banco de dados. 409 OperationCancelled - A operação foi cancelada pelo usuário. 409 OperationInterrupted - A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso. 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Tente executar a operação novamente. 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas 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.core.util.Context;
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"),
            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

Sample Response

Status code:: 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"
  }
}

Status code:: 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"
  }
}

Status code:: 202

Definições

Nome	Description
CreateDatabaseRestorePointDefinition	Contém as informações necessárias para executar uma operação de criação de ponto de restauração de banco de dados.
RestorePoint	Pontos de restauração do banco de dados.
RestorePointType	O tipo de ponto de restauração

CreateDatabaseRestorePointDefinition

Contém as informações necessárias para executar uma operação de criação de ponto de restauração de banco de dados.

Nome	Tipo	Description
restorePointLabel	string	O rótulo do ponto de restauração a ser aplicado

RestorePoint

Pontos de restauração do banco de dados.

Nome	Tipo	Description
id	string	ID do recurso.
location	string	Local do recurso.
name	string	Nome do recurso.
properties.earliestRestoreDate	string	A hora mais antiga para a qual esse banco de dados pode ser restaurado
properties.restorePointCreationDate	string	A hora em que o backup foi feito
properties.restorePointLabel	string	O rótulo do ponto de restauração para solicitação de backup por usuário
properties.restorePointType	RestorePointType	O tipo de ponto de restauração
type	string	Tipo de recurso.

RestorePointType

O tipo de ponto de restauração

Nome	Tipo	Description
CONTINUOUS	string
DISCRETE	string