Backup Short Term Retention Policies - Get

Serviço:

SQL Database

Versão da API:

2021-11-01

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

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

Name	Em	Necessário	Tipo	Description
databaseName	path	True	string	O nome da base de dados.
policyName	path	True	ShortTermRetentionPolicyName	O nome da política. Deve ser sempre "predefinição".
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	O ID da subscrição que identifica uma subscrição do Azure.
api-version	query	True	string	A versão da API a utilizar para o pedido.

Respostas

Name	Tipo	Description
200 OK	BackupShortTermRetentionPolicy	A política foi obtida com êxito.
Other Status Codes		Respostas de Erro: *** 400 InvalidParameterValue – foi atribuído um valor inválido a um parâmetro. 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e subscrição especificados. 404 ResourceNotFound – o recurso pedido não foi encontrado.

Exemplos

Get the short term retention policy for the database.

Pedido de amostra

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

Resposta da amostra

Código de estado:

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
  }
}

Definições

Name	Description
BackupShortTermRetentionPolicy	Uma política de retenção de curto prazo.
DiffBackupIntervalInHours	O intervalo de cópia de segurança diferencial em horas. Esta é a quantidade de horas de intervalo entre cada cópia de segurança diferencial que será suportada. Isto aplica-se apenas a bases de dados dinâmicas, mas não a bases de dados removidas.
ShortTermRetentionPolicyName	O nome da política. Deve ser sempre "predefinição".

BackupShortTermRetentionPolicy

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

Name	Tipo	Description
id	string	ID do Recurso.
name	string	Nome do recurso.
properties.diffBackupIntervalInHours	DiffBackupIntervalInHours	O intervalo de cópia de segurança diferencial em horas. Esta é a quantidade de horas de intervalo entre cada cópia de segurança diferencial que será suportada. Isto aplica-se apenas a bases de dados dinâmicas, mas não a bases de dados removidas.
properties.retentionDays	integer	O período de retenção da cópia de segurança em dias. Este é o número de dias em que o Restauro para Um Ponto Anterior no Tempo será suportado.
type	string	Tipo de recurso.

DiffBackupIntervalInHours

O intervalo de cópia de segurança diferencial em horas. Esta é a quantidade de horas de intervalo entre cada cópia de segurança diferencial que será suportada. Isto aplica-se apenas a bases de dados dinâmicas, mas não a bases de dados removidas.

Name	Tipo	Description
12	string
24	string

ShortTermRetentionPolicyName

O nome da política. Deve ser sempre "predefinição".

Name	Tipo	Description
default	string