Backup Short Term Retention Policies - Get

Servicio:

SQL Database

Versión de la API:

2021-11-01

Obtiene la directiva de retención a corto plazo de una base de datos.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/backupShortTermRetentionPolicies/default?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.
policyName	path	True	ShortTermRetentionPolicyName	Nombre de la directiva. Siempre debe ser "predeterminado".
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.

Respuestas

Nombre	Tipo	Description
200 OK	BackupShortTermRetentionPolicy	Recuperó correctamente la directiva.
Other Status Codes		Respuestas de error: *** 400 InvalidParameterValue: se ha dado un valor no válido a un parámetro. 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 short term retention policy for the database.

Solicitud de ejemplo

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/backupShortTermRetentionPolicies/default?api-version=2021-11-01

Java

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

/**
 * Samples for BackupShortTermRetentionPolicies Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/GetShortTermRetentionPolicy.json
     */
    /**
     * Sample code: Get the short term retention policy for the database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getTheShortTermRetentionPolicyForTheDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getBackupShortTermRetentionPolicies().getWithResponse(
            "Default-SQL-SouthEastAsia", "testsvr", "testdb", ShortTermRetentionPolicyName.DEFAULT,
            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/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/backupShortTermRetentionPolicies/default",
  "name": "default",
  "type": "Microsoft.Sql/servers/databases/backupShortTermRetentionPolicies",
  "properties": {
    "retentionDays": 7,
    "diffBackupIntervalInHours": 24
  }
}

Definiciones

Nombre	Description
BackupShortTermRetentionPolicy	Una directiva de retención a corto plazo.
DiffBackupIntervalInHours	Intervalo de copia de seguridad diferencial en horas. Este es el número de horas de intervalo entre cada copia de seguridad diferencial. Esto solo se aplica a las bases de datos activas, pero no a las bases de datos eliminadas.
ShortTermRetentionPolicyName	Nombre de la directiva. Siempre debe ser "predeterminado".

BackupShortTermRetentionPolicy

Una directiva de retención a corto plazo.

Nombre	Tipo	Description
id	string	Identificador del recurso.
name	string	Nombre del recurso.
properties.diffBackupIntervalInHours	DiffBackupIntervalInHours	Intervalo de copia de seguridad diferencial en horas. Este es el número de horas de intervalo entre cada copia de seguridad diferencial. Esto solo se aplica a las bases de datos activas, pero no a las bases de datos eliminadas.
properties.retentionDays	integer	Período de retención de la copia de seguridad, en días. Este es el número de días que se admitirá la restauración a un momento dado.
type	string	Tipo de recurso.

DiffBackupIntervalInHours

Intervalo de copia de seguridad diferencial en horas. Este es el número de horas de intervalo entre cada copia de seguridad diferencial. Esto solo se aplica a las bases de datos activas, pero no a las bases de datos eliminadas.

Nombre	Tipo	Description
12	string
24	string

ShortTermRetentionPolicyName

Nombre de la directiva. Siempre debe ser "predeterminado".

Nombre	Tipo	Description
default	string