Long Term Retention Managed Instance Backups - List By Location

Referência

Serviço:: SQL Database

Versão da API:: 2021-11-01

Listas os backups de retenção de longo prazo para bancos de dados gerenciados em um determinado local.

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

Com parâmetros opcionais:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionManagedInstanceBackups?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	ManagedInstanceLongTermRetentionBackupListResult	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

ManagedInstanceLongTermRetentionBackupListResult

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/longTermRetentionManagedInstanceBackups?api-version=2021-11-01


/**
 * Samples for LongTermRetentionManagedInstanceBackups ListByLocation.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedInstanceLongTermRetentionBackupListByLocation.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().getLongTermRetentionManagedInstanceBackups()
            .listByLocation("japaneast", null, null, 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 de exemplo

Código de status:: 200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testserver1/longTermRetentionDatabases/testDatabase1/longTermRetentionManagedInstanceBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
      "name": "55555555-6666-7777-8888-999999999999;2017-08-23T08:00:00.000Z",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionBackups",
      "properties": {
        "managedInstanceName": "testInstance1",
        "managedInstanceCreateTime": "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/longTermRetentionManagedInstances/testserver2/longTermRetentionDatabases/testDatabase2/longTermRetentionManagedInstanceBackups/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": {
        "managedInstanceName": "testInstance2",
        "managedInstanceCreateTime": "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/longTermRetentionManagedInstances/testserver3/longTermRetentionDatabases/testDatabase3/longTermRetentionManagedInstanceBackups/43214321-4321-4321-4321-321321321321;131677960820000000",
      "name": "43214321-4321-4321-4321-321321321321;2017-09-06T08:00:00.000Z",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance3",
        "managedInstanceCreateTime": "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
databaseState	Se você deve consultar apenas bancos de dados dinâmicos, apenas bancos de dados excluídos ou todos os bancos de dados.
ManagedInstanceLongTermRetentionBackup	Um backup de retenção de longo prazo para um banco de dados gerenciado.
ManagedInstanceLongTermRetentionBackupListResult	Uma lista de backups de retenção de longo prazo para bancos de dados gerenciados.

BackupStorageRedundancy

O tipo de redundância de armazenamento do backup

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

ManagedInstanceLongTermRetentionBackup

Um backup de retenção de longo prazo para um banco de dados gerenciado.

Nome	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.backupExpirationTime	string	O tempo em que o backup de retenção de longo prazo expirará.
properties.backupStorageRedundancy	BackupStorageRedundancy	O tipo de redundância de armazenamento do backup
properties.backupTime	string	A hora em que o backup foi feito
properties.databaseDeletionTime	string	A hora de exclusão do banco de dados
properties.databaseName	string	O nome do banco de dados ao qual o backup pertence
properties.managedInstanceCreateTime	string	A hora de criação da instância.
properties.managedInstanceName	string	A instância gerenciada à qual o banco de dados de backup pertence.
type	string	Tipo de recurso.

ManagedInstanceLongTermRetentionBackupListResult

Uma lista de backups de retenção de longo prazo para bancos de dados gerenciados.

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

Compartilhar via

Long Term Retention Managed Instance Backups - List By Location

Parâmetros de URI

Respostas

Exemplos

Get all long term retention backups under the location.

Solicitação de exemplo

Resposta de exemplo

Definições

BackupStorageRedundancy

databaseState

ManagedInstanceLongTermRetentionBackup

ManagedInstanceLongTermRetentionBackupListResult

Recursos adicionais