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 do URI

Name Em Obrigatório Tipo Descrição
locationName
path True

string

A localização da base 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 um UUID.

api-version
query True

string

minLength: 1

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

databaseState
query

DatabaseState

Seja para consultar apenas bancos de dados ativos, apenas bancos de dados excluídos ou todos os bancos de dados.

onlyLatestPerDatabase
query

boolean

Obter ou não apenas o backup mais recente para cada banco de dados.

Respostas

Name Tipo Descrição
200 OK

ManagedInstanceLongTermRetentionBackupListResult

O pedido foi bem-sucedido.

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Âmbitos

Name Descrição
user_impersonation personificar a sua conta de utilizador

Exemplos

Get all long term retention backups under the managed instance.

Pedido de amostra

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 da amostra

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

Name Descrição
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

Seja para consultar apenas bancos de dados ativos, apenas bancos de dados excluídos ou todos os bancos de dados.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

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 Managed InstanceLongTermRetentionBackup.

systemData

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

BackupStorageAccessTier

O BackupStorageAccessTier para o backup LTR

Valor Descrição
Hot

Quente

Archive

Arquivo

BackupStorageRedundancy

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

Valor Descrição
Geo

Geografia

Local

Local

Zone

Zona

GeoZone

GeoZona

createdByType

O tipo de identidade que criou o recurso.

Valor Descrição
User
Application
ManagedIdentity
Key

DatabaseState

Seja para consultar apenas bancos de dados ativos, apenas bancos de dados excluídos ou todos os bancos de dados.

Valor Descrição
All

Todos

Live

Ao vivo

Deleted

Eliminados

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Name Tipo Descrição
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Tipo Descrição
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O alvo do erro.

ErrorResponse

Resposta de erro

Name Tipo Descrição
error

ErrorDetail

O objeto de erro.

ManagedInstanceLongTermRetentionBackup

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

Name Tipo Descrição
id

string (arm-id)

ID de recurso totalmente qualificado 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 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 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)

O tempo 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. Computação/Máquinas Virtuais" ou "Microsoft. ContasArmazenamento/Armazenamento"

ManagedInstanceLongTermRetentionBackupListResult

A resposta de uma operação de lista Managed InstanceLongTermRetentionBackup.

Name Tipo Descrição
nextLink

string (uri)

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

value

ManagedInstanceLongTermRetentionBackup[]

Os itens Managed InstanceLongTermRetentionBackup nesta página

systemData

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

Name Tipo Descrição
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.