Long Term Retention Managed Instance Backups - List By Instance

Serviço:

SQL Database

Versão da API:

2021-11-01

Listas os backups de retenção de longo prazo para uma determinada instância gerenciada.

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

Com parâmetros opcionais:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionManagedInstances/{managedInstanceName}/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
managedInstanceName	path	True	string	O nome da instância gerenciada.
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 é necessário 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 o backup mais recente para cada banco de dados.

Respostas

Nome	Tipo	Description
200 OK	ManagedInstanceLongTermRetentionBackupListResult	Recuperou 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 managed instance.

Solicitação de exemplo

HTTP

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

Java

/**
 * Samples for LongTermRetentionManagedInstanceBackups ListByInstance.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedInstanceLongTermRetentionBackupListByInstance.json
     */
    /**
     * Sample code: Get all long term retention backups under the managed instance.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getAllLongTermRetentionBackupsUnderTheManagedInstance(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionManagedInstanceBackups()
            .listByInstance("japaneast", "testInstance", 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/testInstance/longTermRetentionDatabases/testDatabase1/longTermRetentionManagedInstanceBackups/55555555-6666-7777-8888-999999999999;131637960820000000",
      "name": "55555555-6666-7777-8888-999999999999;131637960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "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/testInstance/longTermRetentionDatabases/testDatabase2/longTermRetentionManagedInstanceBackups/12341234-1234-1234-1234-123123123123;131657960820000000",
      "name": "12341234-1234-1234-1234-123123123123;131657960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2017-03-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/testInstance/longTermRetentionDatabases/testDatabase3/longTermRetentionManagedInstanceBackups/43214321-4321-4321-4321-321321321321;131677960820000000",
      "name": "43214321-4321-4321-4321-321321321321;131667960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2017-03-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 é necessário 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 é necessário 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	O tempo 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.