Long Term Retention Backups - Get By Resource Group

Service:

SQL Database

API Version:

2021-11-01

Obtém um backup 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 de URI

Nome	Em	Obrigatório	Tipo	Description
backupName	path	True	string	O nome do backup.
locationName	path	True	string	O local do banco de dados.
longTermRetentionDatabaseName	path	True	string	O nome do banco 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. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.
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.

Respostas

Nome	Tipo	Description
200 OK	LongTermRetentionBackup	Recuperou o backup com êxito.
Other Status Codes		Respostas de erro: *** 400 InvalidLongTermRetentionBackupId – Identificador de backup de retenção de longo prazo inválido para BDs SQL. 400 InvalidParameterValue - Um valor inválido foi dado a um parâmetro. 400 LongTermRetentionMismatchingSubscriptionId - A ID de assinatura fornecida não correspondeu à ID na outra entrada 400 LongTermRetentionMismatchingResourceGroupName - O nome do grupo de recursos fornecido não correspondeu ao nome na outra entrada 400 LongTermRetentionMismatchingServerName - O nome do servidor fornecido não correspondeu ao nome na outra entrada 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. 404 ResourceNotFound – O recurso solicitado não foi encontrado.

Exemplos

Get the long term retention backup.

Sample Request

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

import com.azure.core.util.Context;

/** 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", 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

{
  "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

Nome	Description
BackupStorageRedundancy	O tipo de redundância de armazenamento do backup copiado
LongTermRetentionBackup	Um backup 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

LongTermRetentionBackup

Um backup de retenção de longo prazo.

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.requestedBackupStorageRedundancy	BackupStorageRedundancy	O tipo de redundância de armazenamento do backup
properties.serverCreateTime	string	A hora de criação do servidor.
properties.serverName	string	O nome do servidor ao qual o banco de dados de backup pertence.
type	string	Tipo de recurso.