Long Term Retention Policies - List By Database

Serviço:

SQL Database

Versão da API:

2021-11-01

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

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/backupLongTermRetentionPolicies?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.
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	LongTermRetentionPolicyListResult	Obtenha a política com êxito.
Other Status Codes		Respostas de Erro: *** 400 LTRNotSupportedForPerDBCMK – A Retenção de Cópia de Segurança de Longo Prazo não é suportada quando a CMK ao nível da base de dados é configurada em pré-visualização. 400 LongTermRetentionPolicyNotSupported – A Retenção de Longo Prazo não é suportada nesta base de dados. 400 LongTermRetentionPolicyInvalid – A política de retenção de longo prazo é inválida. 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 long term retention policy for the database.

Pedido de amostra

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/servers/testserver/databases/testDatabase/backupLongTermRetentionPolicies?api-version=2021-11-01

Java

/**
 * Samples for LongTermRetentionPolicies ListByDatabase.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/LongTermRetentionPolicyListByDatabase
     * .json
     */
    /**
     * Sample code: Get the long term retention policy for the database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getTheLongTermRetentionPolicyForTheDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionPolicies().listByDatabase("resourceGroup",
            "testserver", "testDatabase", 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

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/resourceGroups/resourceGroup/servers/testserver/databases/testDatabase/backupLongTermRetentionPolicies/default",
      "name": "default",
      "type": "Microsoft.Sql/resourceGroups/servers/databases/backupLongTermRetentionPolicies",
      "properties": {
        "weeklyRetention": "P1M",
        "monthlyRetention": "P1Y",
        "yearlyRetention": "P5Y",
        "weekOfYear": 5
      }
    }
  ]
}

Definições

Name	Description
LongTermRetentionPolicy	Uma política de retenção de longo prazo.
LongTermRetentionPolicyListResult	Uma lista de políticas de retenção de longo prazo.

LongTermRetentionPolicy

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

Name	Tipo	Description
id	string	ID do Recurso.
name	string	Nome do recurso.
properties.monthlyRetention	string	A política de retenção mensal de uma cópia de segurança LTR num formato ISO 8601.
properties.weekOfYear	integer	A semana do ano para fazer a cópia de segurança anual num formato ISO 8601.
properties.weeklyRetention	string	A política de retenção semanal para uma cópia de segurança LTR num formato ISO 8601.
properties.yearlyRetention	string	A política de retenção anual de uma cópia de segurança LTR num formato ISO 8601.
type	string	Tipo de recurso.

LongTermRetentionPolicyListResult

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

Name	Tipo	Description
nextLink	string	Ligação para obter a página seguinte dos resultados.
value	LongTermRetentionPolicy[]	Matriz de resultados.