Backup Short Term Retention Policies - List By Database

Service:

SQL Database

API Version:

2021-11-01

Obtém a política de retenção de curto prazo de um banco de dados.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/backupShortTermRetentionPolicies?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.

Respostas

Nome	Tipo	Description
200 OK	BackupShortTermRetentionPolicyListResult	A política foi recuperada com êxito.
Other Status Codes		Respostas de erro: *** 400 InvalidParameterValue - Um valor inválido foi dado a um parâmetro. 404 SubscriptionDoesNotHaveServer - O servidor solicitado não foi encontrado 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na assinatura especificados. 404 ResourceNotFound - O recurso solicitado não foi encontrado.

Exemplos

Get the short term retention policy for the database.

Sample Request

HTTP

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

Java

import com.azure.core.util.Context;

/** Samples for BackupShortTermRetentionPolicies ListByDatabase. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ListShortTermRetentionPoliciesByDatabase.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()
            .listByDatabase("Default-SQL-SouthEastAsia", "testsvr", "testdb", 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

{
  "value": [
    {
      "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
      }
    }
  ]
}

Definições

Nome	Description
BackupShortTermRetentionPolicy	Uma política de retenção de curto prazo.
BackupShortTermRetentionPolicyListResult	Uma lista de políticas de retenção de curto prazo.
DiffBackupIntervalInHours	O intervalo de backup diferencial em horas. Este é o número de horas de intervalo entre cada backup diferencial que terá suporte. Isso só é aplicável a bancos de dados dinâmicos, mas não a bancos de dados descartados.

BackupShortTermRetentionPolicy

Uma política de retenção de curto prazo.

Nome	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.diffBackupIntervalInHours	DiffBackupIntervalInHours	O intervalo de backup diferencial em horas. Este é o número de horas de intervalo entre cada backup diferencial que terá suporte. Isso só é aplicável a bancos de dados dinâmicos, mas não a bancos de dados descartados.
properties.retentionDays	integer	O período de retenção de backup em dias. Este é o número de dias que a Restauração Pontual terá suporte.
type	string	Tipo de recurso.

BackupShortTermRetentionPolicyListResult

Uma lista de políticas de retenção de curto prazo.

Nome	Tipo	Description
nextLink	string	Link para recuperar a próxima página de resultados.
value	BackupShortTermRetentionPolicy[]	Matriz de resultados.

DiffBackupIntervalInHours

O intervalo de backup diferencial em horas. Este é o número de horas de intervalo entre cada backup diferencial que terá suporte. Isso só é aplicável a bancos de dados dinâmicos, mas não a bancos de dados descartados.

Nome	Tipo	Description
12	string
24	string