Long Term Retention Managed Instance 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 para una base de datos administrada.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionManagedInstances/{managedInstanceName}/longTermRetentionDatabases/{databaseName}/longTermRetentionManagedInstanceBackups/{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.
databaseName	path	True	string	Nombre de la base de datos administrada.
locationName	path	True	string	Ubicación de la base de datos.
managedInstanceName	path	True	string	El nombre de la instancia administrada.
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	ManagedInstanceLongTermRetentionBackup	Recuperó correctamente la copia de seguridad.
Other Status Codes		Respuestas de error: *** 400 InvalidLongTermRetentionManagedInstanceBackupId: identificador de copia de seguridad de retención a largo plazo no válido para instancias administradas. 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/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase/longTermRetentionManagedInstanceBackups/55555555-6666-7777-8888-999999999999;131637960820000000?api-version=2021-11-01

Java

/**
 * Samples for LongTermRetentionManagedInstanceBackups GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ResourceGroupBasedManagedInstanceLongTermRetentionBackupGet.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().getLongTermRetentionManagedInstanceBackups()
            .getByResourceGroupWithResponse("testResourceGroup", "japaneast", "testInstance", "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/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase/longTermRetentionManagedInstanceBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
  "name": "55555555-6666-7777-8888-999999999999;131637960820000000",
  "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
  "properties": {
    "managedInstanceName": "testInstance",
    "managedInstanceCreateTime": "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
ManagedInstanceLongTermRetentionBackup	Copia de seguridad de retención a largo plazo para una base de datos administrada.

BackupStorageRedundancy

Enumeration

El tipo de redundancia de almacenamiento de la copia de seguridad

Valor	Description
Geo
GeoZone
Local
Zone

ManagedInstanceLongTermRetentionBackup

Object

Copia de seguridad de retención a largo plazo para una base de datos administrada.

Nombre	Tipo	Description
id	string	Identificador del recurso.
name	string	Nombre del recurso.
properties.backupExpirationTime	string	La hora 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 a la 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.managedInstanceCreateTime	string	Hora de creación de la instancia.
properties.managedInstanceName	string	Instancia administrada a la que pertenece la base de datos de copia de seguridad.
type	string	Tipo de recurso.