Long Term Retention Backups - Get By Resource Group

Servicio:

SQL Database

Versión de la API:

2021-11-01

Obtiene una copia de seguridad de retención a largo plazo.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionDatabases/{longTermRetentionDatabaseName}/longTermRetentionBackups/{backupName}?api-version=2021-11-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
backupName	path	True	string	Nombre de la copia de seguridad.
locationName	path	True	string	Ubicación de la base de datos.
longTermRetentionDatabaseName	path	True	string	Nombre de la base de datos
longTermRetentionServerName	path	True	string	El nombre del servidor.
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.
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.

Respuestas

Nombre	Tipo	Description
200 OK	LongTermRetentionBackup	Recuperó correctamente la copia de seguridad.
Other Status Codes		Respuestas de error: *** 400 InvalidLongTermRetentionBackupId: identificador de copia de seguridad de retención a largo plazo no válido para bases de datos SQL. 400 InvalidParameterValue: se ha dado un valor no válido a un parámetro. 400 LongTermRetentionMismatchingSubscriptionId: el identificador de suscripción proporcionado no coincide con el identificador de la otra entrada. 400 LongTermRetentionMismatchingResourceGroupName: el nombre del grupo de recursos proporcionado no coincide con el nombre de la otra entrada. 400 LongTermRetentionMismatchingServerName: el nombre del servidor proporcionado no coincide con el nombre de la otra entrada. 404 SubscriptionDoesNotHaveServer: no se encontró el servidor solicitado. 404 ServerNotInSubscriptionResourceGroup: el servidor especificado no existe en el grupo de recursos y la suscripción especificados. 404 ResourceNotFound: no se encontró el recurso solicitado.

Ejemplos

Get the long term retention backup.

Solicitud de ejemplo

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000?api-version=2021-11-01

Java

/**
 * Samples for LongTermRetentionBackups GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ResourceGroupBasedLongTermRetentionBackupGet.json
     */
    /**
     * Sample code: Get the long term retention backup.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getTheLongTermRetentionBackup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionBackups().getByResourceGroupWithResponse(
            "testResourceGroup", "japaneast", "testserver", "testDatabase",
            "55555555-6666-7777-8888-999999999999;131637960820000000", 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/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase/longTermRetentionBackups/2017-03-10T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2017-09-06T08:00:00.000Z",
  "name": "2017-03-10T08:00:00.000Z;55555555-6666-7777-8888-999999999999;131637960820000000",
  "type": "Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups",
  "properties": {
    "serverName": "testserver",
    "serverCreateTime": "2017-03-10T08:00:00Z",
    "databaseName": "testDatabase",
    "databaseDeletionTime": null,
    "backupTime": "2017-09-06T08:00:00Z",
    "backupStorageRedundancy": "Geo"
  }
}

Definiciones

Nombre	Description
BackupStorageRedundancy	El tipo de redundancia de almacenamiento de la copia de seguridad copiada
LongTermRetentionBackup	Una copia de seguridad de retención a largo plazo.

BackupStorageRedundancy

El tipo de redundancia de almacenamiento de la copia de seguridad copiada

Nombre	Tipo	Description
Geo	string
GeoZone	string
Local	string
Zone	string

LongTermRetentionBackup

Una copia de seguridad de retención a largo plazo.

Nombre	Tipo	Description
id	string	Identificador del recurso.
name	string	Nombre del recurso.
properties.backupExpirationTime	string	El tiempo en que expirará la copia de seguridad de retención a largo plazo.
properties.backupStorageRedundancy	BackupStorageRedundancy	El tipo de redundancia de almacenamiento de la copia de seguridad
properties.backupTime	string	Hora en que se realizó la copia de seguridad
properties.databaseDeletionTime	string	Hora de eliminación de la base de datos
properties.databaseName	string	Nombre de la base de datos a la que pertenece la copia de seguridad
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	El tipo de redundancia de almacenamiento de la copia de seguridad
properties.serverCreateTime	string	Hora de creación del servidor.
properties.serverName	string	Nombre del servidor al que pertenece la base de datos de copia de seguridad.
type	string	Tipo de recurso.