Long Term Retention Backups - Get By Resource Group

Serviço:

SQL Database

Versão da API:

2021-11-01

Obtém uma cópia de segurança de retenção de longo prazo.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionServers/{longTermRetentionServerName}/longTermRetentionDatabases/{longTermRetentionDatabaseName}/longTermRetentionBackups/{backupName}?api-version=2021-11-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
backupName	path	True	string	O nome da cópia de segurança.
locationName	path	True	string	A localização da base de dados.
longTermRetentionDatabaseName	path	True	string	O nome da base de dados
longTermRetentionServerName	path	True	string	O nome do servidor
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.

Respostas

Name	Tipo	Description
200 OK	LongTermRetentionBackup	A cópia de segurança foi obtida com êxito.
Other Status Codes		Respostas de Erro: *** 400 InvalidLongTermRetentionBackupId – Identificador de cópia de segurança de retenção de longo prazo inválido para BDs SQL. 400 InvalidParameterValue – foi atribuído um valor inválido a um parâmetro. 400 LongTermRetentionMismatchingSubscriptionId – o ID de subscrição fornecido não corresponde ao ID na outra entrada 400 LongTermRetentionMismatchingResourceGroupName - O nome do grupo de recursos fornecido não corresponde ao nome na outra entrada 400 LongTermRetentionMismatchingServerName - O nome do servidor fornecido não corresponde ao nome na outra entrada 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 backup.

Pedido de amostra

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase/longTermRetentionBackups/55555555-6666-7777-8888-999999999999;131637960820000000?api-version=2021-11-01

Java

/**
 * Samples for LongTermRetentionBackups GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ResourceGroupBasedLongTermRetentionBackupGet.json
     */
    /**
     * Sample code: Get the long term retention backup.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getTheLongTermRetentionBackup(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getLongTermRetentionBackups().getByResourceGroupWithResponse(
            "testResourceGroup", "japaneast", "testserver", "testDatabase",
            "55555555-6666-7777-8888-999999999999;131637960820000000", 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

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testResourceGroup/providers/Microsoft.Sql/locations/japaneast/longTermRetentionServers/testserver/longTermRetentionDatabases/testDatabase/longTermRetentionBackups/2017-03-10T08:00:00.000Z;55555555-6666-7777-8888-999999999999;2017-09-06T08:00:00.000Z",
  "name": "2017-03-10T08:00:00.000Z;55555555-6666-7777-8888-999999999999;131637960820000000",
  "type": "Microsoft.Sql/locations/longTermRetentionServers/longTermRetentionDatabases/longTermRetentionBackups",
  "properties": {
    "serverName": "testserver",
    "serverCreateTime": "2017-03-10T08:00:00Z",
    "databaseName": "testDatabase",
    "databaseDeletionTime": null,
    "backupTime": "2017-09-06T08:00:00Z",
    "backupStorageRedundancy": "Geo"
  }
}

Definições

Name	Description
BackupStorageRedundancy	O tipo de redundância de armazenamento da cópia de segurança copiada
LongTermRetentionBackup	Uma cópia de segurança de retenção de longo prazo.

BackupStorageRedundancy

Enumeration

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

Valor	Description
Geo
GeoZone
Local
Zone

LongTermRetentionBackup

Object

Uma cópia de segurança de retenção de longo prazo.

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 foi tomada
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.requestedBackupStorageRedundancy	BackupStorageRedundancy	O tipo de redundância de armazenamento da cópia de segurança
properties.serverCreateTime	string	A hora de criação do servidor.
properties.serverName	string	O nome do servidor ao qual pertence a base de dados de cópia de segurança.
type	string	Tipo de recurso.