Restore Points - Create

Referencia

Servicio:: SQL Database

Versión de la API:: 2021-11-01

Crea un punto de restauración para un almacenamiento de datos.

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 identificador URI

Nombre	En	Requerido	Tipo	Description
databaseName	path	True	string	El nombre de la base de datos.
resourceGroupName	path	True	string	Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor en la API del Administrador de recursos o el portal de Azure.
serverName	path	True	string	El nombre del servidor.
subscriptionId	path	True	string	El id. de suscripción que identifica una suscripción de Azure.
api-version	query	True	string	La versión de API que se usará para la solicitud.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
restorePointLabel	True	string	Etiqueta de punto de restauración que se va a aplicar

Respuestas

Nombre	Tipo	Description
200 OK	RestorePoint	Se creó correctamente la solicitud de punto de restauración.
201 Created	RestorePoint	Se creó correctamente la solicitud de punto de restauración.
202 Accepted		Aceptado
Other Status Codes		Respuestas de error: *** 400 BackupNotAllowedOnDeactivatedDatabase: no se puede crear un punto de restauración en una base de datos desactivada. 400 FeatureDisabledOnSelectedEdition: el usuario intentó usar una característica que está deshabilitada en la edición actual de la base de datos. 400 RestorePointLimitReached: no se puede crear un punto de restauración porque la base de datos superaría la cuota permitida de puntos de restauración. 400 RestorePointAttemptToDeleteSystemBackup: no se puede eliminar el punto de restauración del sistema. 404 DatabaseRestorePointNotFound: no se encuentra el punto de restauración de la base de datos. 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado 404 DatabaseDoesNotExist: el usuario ha especificado un nombre de base de datos que no existe en esta instancia del servidor. 404 OperationIdNotFound: la operación con id. no existe. 408 DatabaseRestorePointTimedOut: error al crear el punto de restauración de la base de datos. 409 OperationCancelled: el usuario ha cancelado la operación. 409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió por otra operación en el mismo recurso. 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar. 500 OperationTimedOut: la operación agota el tiempo de espera y se revierte automáticamente. Vuelva a intentar la operación y, 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

Ejemplos

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

Respuesta de muestra

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

Definiciones

Nombre	Description
CreateDatabaseRestorePointDefinition	Contiene la información necesaria para realizar una operación de creación de punto de restauración de base de datos.
RestorePoint	Puntos de restauración de base de datos.
RestorePointType	Tipo de punto de restauración

CreateDatabaseRestorePointDefinition

Contiene la información necesaria para realizar una operación de creación de punto de restauración de base de datos.

Nombre	Tipo	Description
restorePointLabel	string	Etiqueta de punto de restauración que se va a aplicar

RestorePoint

Puntos de restauración de base de datos.

Nombre	Tipo	Description
id	string	Identificador del recurso.
location	string	Ubicación del recurso
name	string	Nombre del recurso.
properties.earliestRestoreDate	string	La primera vez a la que se puede restaurar esta base de datos
properties.restorePointCreationDate	string	Hora a la que se realizó la copia de seguridad
properties.restorePointLabel	string	Etiqueta del punto de restauración para la solicitud de copia de seguridad por parte del usuario
properties.restorePointType	RestorePointType	Tipo de punto de restauración
type	string	Tipo de recurso.

RestorePointType

Tipo de punto de restauración

Nombre	Tipo	Description
CONTINUOUS	string
DISCRETE	string

Compartir a través de