Long Term Retention Managed Instance Backups - List By Resource Group Database

Referência

Serviço:: SQL Database

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

Listas todas as cópias de segurança de retenção de longo prazo para uma base de dados gerida.

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

Com parâmetros opcionais:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionManagedInstances/{managedInstanceName}/longTermRetentionDatabases/{databaseName}/longTermRetentionManagedInstanceBackups?onlyLatestPerDatabase={onlyLatestPerDatabase}&databaseState={databaseState}&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 gerida.
locationName	path	True	string	A localização da base de dados
managedInstanceName	path	True	string	O nome da instância gerida.
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.
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.
databaseState	query		databaseState	Se pretende consultar apenas bases de dados dinâmicas, apenas bases de dados eliminadas ou todas as bases de dados.
onlyLatestPerDatabase	query		boolean	Se pretende ou não obter apenas a cópia de segurança mais recente para cada base de dados.

Respostas

Name	Tipo	Description
200 OK	ManagedInstanceLongTermRetentionBackupListResult	Foi obtida com êxito a lista de cópias de segurança.
Other Status Codes		Respostas de Erro: *** 404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na subscrição especificados.

Name

Tipo

Description

200 OK

ManagedInstanceLongTermRetentionBackupListResult

Foi obtida com êxito a lista de cópias de segurança.

Other Status Codes

Respostas de Erro: ***

404 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado
404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na subscrição especificados.

Exemplos

Get all long term retention backups under the database.

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


/**
 * Samples for LongTermRetentionManagedInstanceBackups ListByResourceGroupDatabase.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ResourceGroupBasedManagedInstanceLongTermRetentionBackupListByDatabase.json
     */
    /**
     * Sample code: Get all long term retention backups under the database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getAllLongTermRetentionBackupsUnderTheDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionManagedInstanceBackups()
            .listByResourceGroupDatabase("testResourceGroup", "japaneast", "testInstance", "testDatabase", 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 da amostra

Código de estado:: 200

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/Locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase/longTermRetentionManagedInstanceBackups/2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-08-23T08:00:00.000Z",
      "name": "2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-08-23T08:00:00.000Z",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase",
        "databaseDeletionTime": null,
        "backupTime": "2018-08-23T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/Locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase/longTermRetentionManagedInstanceBackups/2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-08-30T08:00:00.000Z",
      "name": "2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-08-30T08:00:00.000Z",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2017-03-10T08:00:00Z",
        "databaseName": "testDatabase",
        "databaseDeletionTime": null,
        "backupTime": "2018-08-30T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/Locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase/longTermRetentionManagedInstanceBackups/2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-09-06T08:00:00.000Z",
      "name": "2018-06-01T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2018-09-06T08:00:00.000Z",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "properties": {
        "managedInstanceName": "testInstance",
        "managedInstanceCreateTime": "2018-03-10T08:00:00Z",
        "databaseName": "testDatabase",
        "databaseDeletionTime": "2018-09-07T08:00:00Z",
        "backupTime": "2018-09-06T08:00:00Z",
        "backupStorageRedundancy": "Geo"
      }
    }
  ]
}

Definições

Name	Description
BackupStorageRedundancy	O tipo de redundância de armazenamento da cópia de segurança
databaseState	Se pretende consultar apenas bases de dados dinâmicas, apenas bases de dados eliminadas ou todas as bases de dados.
ManagedInstanceLongTermRetentionBackup	Uma cópia de segurança de retenção de longo prazo para uma base de dados gerida.
ManagedInstanceLongTermRetentionBackupListResult	Uma lista de cópias de segurança de retenção de longo prazo para bases de dados geridas.

BackupStorageRedundancy

O tipo de redundância de armazenamento da cópia de segurança

Name	Tipo	Description
Geo	string
GeoZone	string
Local	string
Zone	string

databaseState

Se pretende consultar apenas bases de dados dinâmicas, apenas bases de dados eliminadas ou todas as bases de dados.

Name	Tipo	Description
All	string
Deleted	string
Live	string

ManagedInstanceLongTermRetentionBackup

Uma cópia de segurança de retenção de longo prazo para uma base de dados gerida.

Name	Tipo	Description
id	string	ID do Recurso.
name	string	Nome do recurso.
properties.backupExpirationTime	string	O tempo em que a cópia de segurança de retenção de longo prazo expirará.
properties.backupStorageRedundancy	BackupStorageRedundancy	O tipo de redundância de armazenamento da cópia de segurança
properties.backupTime	string	O tempo que a cópia de segurança demorou
properties.databaseDeletionTime	string	A hora de eliminação da base de dados
properties.databaseName	string	O nome da base de dados à qual pertence a cópia de segurança
properties.managedInstanceCreateTime	string	A hora de criação da instância.
properties.managedInstanceName	string	A instância gerida à qual pertence a base de dados de cópia de segurança.
type	string	Tipo de recurso.

ManagedInstanceLongTermRetentionBackupListResult

Uma lista de cópias de segurança de retenção de longo prazo para bases de dados geridas.

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

Partilhar via

Long Term Retention Managed Instance Backups - List By Resource Group Database

Parâmetros do URI

Respostas

Exemplos

Get all long term retention backups under the database.

Pedido de amostra

Resposta da amostra

Definições

BackupStorageRedundancy

databaseState

ManagedInstanceLongTermRetentionBackup

ManagedInstanceLongTermRetentionBackupListResult

Recursos adicionais