Long Term Retention Backups - List By Location

Referência

Service:: SQL Database

API Version:: 2021-11-01

Listas os backups de retenção de longo prazo para um determinado local.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionBackups?api-version=2021-11-01

With optional parameters:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionBackups?onlyLatestPerDatabase={onlyLatestPerDatabase}&databaseState={databaseState}&api-version=2021-11-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
locationName	path	True	string	O local do banco de dados
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.
databaseState	query		databaseState	Se você deve consultar apenas bancos de dados dinâmicos, apenas bancos de dados excluídos ou todos os bancos de dados.
onlyLatestPerDatabase	query		boolean	Se deseja ou não obter apenas o backup mais recente para cada banco de dados.

Respostas

Nome	Tipo	Description
200 OK	LongTermRetentionBackupListResult	Recuperamos com êxito a lista de backups.
Other Status Codes		Respostas de erro: *** 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.

Nome

Tipo

Description

200 OK

LongTermRetentionBackupListResult

Recuperamos com êxito a lista de backups.

Other Status Codes

Respostas de erro: ***

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.

Exemplos

Get all long term retention backups under the location.

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionBackups?api-version=2021-11-01


import com.azure.core.util.Context;

/** Samples for LongTermRetentionBackups ListByLocation. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/LongTermRetentionBackupListByLocation
     * .json
     */
    /**
     * Sample code: Get all long term retention backups under the location.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getAllLongTermRetentionBackupsUnderTheLocation(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionBackups().listByLocation("japaneast", null,
            null, 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/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver1/longTermRetentionDatabases/testDatabase1/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
      "name": "55555555-6666-7777-8888-999999999999;2017-08-23T08:00:00.000Z",
      "type": "Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups",
      "properties": {
        "serverName": "testserver1",
        "serverCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase1",
        "databaseDeletionTime": null,
        "backupTime": "2017-08-23T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver2/longTermRetentionDatabases/testDatabase2/longTermRetentionBackups/12341234-1234-1234-1234-123123123123;131657960820000000",
      "name": "12341234-1234-1234-1234-123123123123;2017-08-30T08:00:00.000Z",
      "type": "Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups",
      "properties": {
        "serverName": "testserver2",
        "serverCreateTime": "2017-04-10T08:00:00Z",
        "databaseName": "testDatabase2",
        "databaseDeletionTime": null,
        "backupTime": "2017-08-30T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver3/longTermRetentionDatabases/testDatabase3/longTermRetentionBackups/43214321-4321-4321-4321-321321321321;131677960820000000",
      "name": "43214321-4321-4321-4321-321321321321;2017-09-06T08:00:00.000Z",
      "type": "Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups",
      "properties": {
        "serverName": "testserver3",
        "serverCreateTime": "2017-05-10T08:00:00Z",
        "databaseName": "testDatabase3",
        "databaseDeletionTime": null,
        "backupTime": "2017-09-06T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    }
  ]
}

Definições

Nome	Description
BackupStorageRedundancy	O tipo de redundância de armazenamento do backup copiado
databaseState	Se você deve consultar apenas bancos de dados dinâmicos, apenas bancos de dados excluídos ou todos os bancos de dados.
LongTermRetentionBackup	Um backup de retenção de longo prazo.
LongTermRetentionBackupListResult	Uma lista de backups de retenção de longo prazo.

BackupStorageRedundancy

O tipo de redundância de armazenamento do backup copiado

Nome	Tipo	Description
Geo	string
GeoZone	string
Local	string
Zone	string

databaseState

Se você deve consultar apenas bancos de dados dinâmicos, apenas bancos de dados excluídos ou todos os bancos de dados.

Nome	Tipo	Description
All	string
Deleted	string
Live	string