Long Term Retention Managed Instance Backups - List By Instance

Lista 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=2025-01-01
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationName}/longTermRetentionManagedInstances/{managedInstanceName}/longTermRetentionManagedInstanceBackups?api-version=2025-01-01&onlyLatestPerDatabase={onlyLatestPerDatabase}&databaseState={databaseState}

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 (uuid)

A ID da assinatura de destino. O valor deve ser uma UUID.

api-version
query True

string

minLength: 1

A versão da API a ser usada para esta operação.

databaseState
query

DatabaseState

Se você deve consultar apenas bancos de dados ativos, 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

A solicitação foi bem-sucedida.

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Get all long term retention backups under the managed instance.

Solicitação de exemplo

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

Resposta de exemplo

{
  "value": [
    {
      "name": "55555555-6666-7777-8888-999999999999;131637960820000000;Archive",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase1/longTermRetentionManagedInstanceBackups/55555555-6666-7777-8888-999999999999;131637960820000000;Archive",
      "properties": {
        "backupStorageAccessTier": "Archive",
        "backupStorageRedundancy": "Geo",
        "backupTime": "2017-08-23T08:00:00Z",
        "databaseDeletionTime": null,
        "databaseName": "testDatabase1",
        "managedInstanceCreateTime": "2017-03-10T08:00:00Z",
        "managedInstanceName": "testInstance"
      }
    },
    {
      "name": "12341234-1234-1234-1234-123123123123;131657960820000000;Hot",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase2/longTermRetentionManagedInstanceBackups/12341234-1234-1234-1234-123123123123;131657960820000000;Hot",
      "properties": {
        "backupStorageAccessTier": "Hot",
        "backupStorageRedundancy": "Geo",
        "backupTime": "2017-08-30T08:00:00Z",
        "databaseDeletionTime": null,
        "databaseName": "testDatabase2",
        "managedInstanceCreateTime": "2017-03-10T08:00:00Z",
        "managedInstanceName": "testInstance"
      }
    },
    {
      "name": "43214321-4321-4321-4321-321321321321;131667960820000000",
      "type": "Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionDatabases/testDatabase3/longTermRetentionManagedInstanceBackups/43214321-4321-4321-4321-321321321321;131677960820000000;Archive",
      "properties": {
        "backupStorageAccessTier": "Archive",
        "backupStorageRedundancy": "Geo",
        "backupTime": "2017-09-06T08:00:00Z",
        "databaseDeletionTime": null,
        "databaseName": "testDatabase3",
        "managedInstanceCreateTime": "2017-03-10T08:00:00Z",
        "managedInstanceName": "testInstance"
      }
    }
  ]
}

Definições

Nome Description
BackupStorageAccessTier

O BackupStorageAccessTier para o backup ltr

BackupStorageRedundancy

O tipo de conta de armazenamento usado para armazenar backups para esse banco de dados.

createdByType

O tipo de identidade que criou o recurso.

DatabaseState

Se você deve consultar apenas bancos de dados ativos, apenas bancos de dados excluídos ou todos os bancos de dados.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

ManagedInstanceLongTermRetentionBackup

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

ManagedInstanceLongTermRetentionBackupListResult

A resposta de uma operação de lista de backup GerenciadaLonga Prazo.

systemData

Metadados relativos à criação e última modificação do recurso.

BackupStorageAccessTier

O BackupStorageAccessTier para o backup ltr

Valor Description
Hot

Quente

Archive

Arquivos

BackupStorageRedundancy

O tipo de conta de armazenamento usado para armazenar backups para esse banco de dados.

Valor Description
Geo

Geo

Local

Local

Zone

Zona

GeoZone

GeoZone

createdByType

O tipo de identidade que criou o recurso.

Valor Description
User
Application
ManagedIdentity
Key

DatabaseState

Se você deve consultar apenas bancos de dados ativos, apenas bancos de dados excluídos ou todos os bancos de dados.

Valor Description
All

Todos

Live

Ao Vivo

Deleted

Excluída

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

ManagedInstanceLongTermRetentionBackup

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

Nome Tipo Description
id

string (arm-id)

ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

O nome do recurso

properties.backupExpirationTime

string (date-time)

O tempo em que o backup de retenção de longo prazo expirará.

properties.backupStorageAccessTier

BackupStorageAccessTier

O BackupStorageAccessTier para o backup ltr

properties.backupStorageRedundancy

BackupStorageRedundancy

O tipo de redundância de armazenamento do backup

properties.backupTime

string (date-time)

O tempo em que o backup foi feito

properties.databaseDeletionTime

string (date-time)

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 (date-time)

A hora de criação da instância.

properties.managedInstanceName

string

A instância gerenciada à qual o banco de dados de backup pertence.

systemData

systemData

Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.

type

string

O tipo do recurso. Por exemplo, "Microsoft. Compute/virtualMachines" ou "Microsoft. ContasArmazenamento/Armazenamento"

ManagedInstanceLongTermRetentionBackupListResult

A resposta de uma operação de lista de backup GerenciadaLonga Prazo.

Nome Tipo Description
nextLink

string (uri)

O link para a próxima página de itens

value

ManagedInstanceLongTermRetentionBackup[]

Os itens Managed InstanceLongTermRetentionBackup nesta página

systemData

Metadados relativos à criação e última modificação do recurso.

Nome Tipo Description
createdAt

string (date-time)

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string (date-time)

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.