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 |
|---|---|---|---|---|
|
location
|
path | True |
string |
A localização da base de dados |
|
managed
|
path | True |
string |
O nome da instância gerenciada. |
|
subscription
|
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. |
|
database
|
query |
Seja para consultar apenas bancos de dados ativos, apenas bancos de dados excluídos ou todos os bancos de dados. |
||
|
only
|
query |
boolean |
Obter ou não apenas o backup mais recente para cada banco de dados. |
Respostas
| Name | Tipo | Descrição |
|---|---|---|
| 200 OK |
O pedido foi bem-sucedido. |
|
| Other Status Codes |
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 |
|---|---|
|
Backup |
O BackupStorageAccessTier para o backup LTR |
|
Backup |
O tipo de conta de armazenamento usado para armazenar backups para esse banco de dados. |
|
created |
O tipo de identidade que criou o recurso. |
|
Database |
Seja para consultar apenas bancos de dados ativos, apenas bancos de dados excluídos ou todos os bancos de dados. |
|
Error |
O erro de gerenciamento de recursos informações adicionais. |
|
Error |
O detalhe do erro. |
|
Error |
Resposta de erro |
|
Managed |
Um backup de retenção de longo prazo para um banco de dados gerenciado. |
|
Managed |
A resposta de uma operação de lista Managed InstanceLongTermRetentionBackup. |
|
system |
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 |
O erro informações adicionais. |
|
| code |
string |
O código de erro. |
| details |
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 |
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 |
O BackupStorageAccessTier para o backup LTR |
|
| properties.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 |
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 |
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 |
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 |
O tipo de identidade que modificou o recurso pela última vez. |