Long Term Retention Managed Instance Backups - List By Instance
Enumera las copias de seguridad de retención a largo plazo para una instancia administrada determinada.
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 identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
location
|
path | True |
string |
Ubicación de la base de datos |
|
managed
|
path | True |
string |
Nombre de la instancia administrada. |
|
subscription
|
path | True |
string (uuid) |
Identificador de la suscripción de destino. El valor debe ser un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versión de API que se usará para esta operación. |
|
database
|
query |
Si desea consultar solo bases de datos activas, simplemente bases de datos eliminadas o todas las bases de datos. |
||
|
only
|
query |
boolean |
Indica si solo se va a obtener la copia de seguridad más reciente de cada base de datos. |
Respuestas
| Nombre | Tipo | Description |
|---|---|---|
| 200 OK |
La solicitud se ha realizado correctamente. |
|
| Other Status Codes |
Una respuesta de error inesperada. |
Seguridad
azure_auth
Flujo OAuth2 de Azure Active Directory.
Tipo:
oauth2
Flujo:
implicit
Dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize
Ámbitos
| Nombre | Description |
|---|---|
| user_impersonation | suplantar la cuenta de usuario |
Ejemplos
Get all long term retention backups under the managed instance.
Solicitud de ejemplo
GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionManagedInstanceBackups?api-version=2025-01-01
Respuesta de muestra
{
"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"
}
}
]
}
Definiciones
| Nombre | Description |
|---|---|
|
Backup |
BackupStorageAccessTier para la copia de seguridad de LTR |
|
Backup |
Tipo de cuenta de almacenamiento que se usa para almacenar copias de seguridad de esta base de datos. |
|
created |
Tipo de identidad que creó el recurso. |
|
Database |
Si desea consultar solo bases de datos activas, simplemente bases de datos eliminadas o todas las bases de datos. |
|
Error |
Información adicional sobre el error de administración de recursos. |
|
Error |
Detalle del error. |
|
Error |
Respuesta de error |
|
Managed |
Una copia de seguridad de retención a largo plazo para una base de datos administrada. |
|
Managed |
La respuesta de una operación de lista de respaldo de Managed InstanceLongTermRetention. |
|
system |
Metadatos relativos a la creación y última modificación del recurso. |
BackupStorageAccessTier
BackupStorageAccessTier para la copia de seguridad de LTR
| Valor | Description |
|---|---|
| Hot |
Caliente |
| Archive |
Archivo |
BackupStorageRedundancy
Tipo de cuenta de almacenamiento que se usa para almacenar copias de seguridad de esta base de datos.
| Valor | Description |
|---|---|
| Geo |
Geo |
| Local |
Local |
| Zone |
Zona |
| GeoZone |
GeoZone |
createdByType
Tipo de identidad que creó el recurso.
| Valor | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DatabaseState
Si desea consultar solo bases de datos activas, simplemente bases de datos eliminadas o todas las bases de datos.
| Valor | Description |
|---|---|
| All |
Todos |
| Live |
En directo |
| Deleted |
Borrado |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
| Nombre | Tipo | Description |
|---|---|---|
| info |
object |
Información adicional. |
| type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
| Nombre | Tipo | Description |
|---|---|---|
| additionalInfo |
Información adicional del error. |
|
| code |
string |
Código de error. |
| details |
Detalles del error. |
|
| message |
string |
El mensaje de error. |
| target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
| Nombre | Tipo | Description |
|---|---|---|
| error |
Objeto de error. |
ManagedInstanceLongTermRetentionBackup
Una copia de seguridad de retención a largo plazo para una base de datos administrada.
| Nombre | Tipo | Description |
|---|---|---|
| id |
string (arm-id) |
Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Nombre del recurso |
| properties.backupExpirationTime |
string (date-time) |
El tiempo en que expirará la copia de seguridad de retención a largo plazo. |
| properties.backupStorageAccessTier |
BackupStorageAccessTier para la copia de seguridad de LTR |
|
| properties.backupStorageRedundancy |
El tipo de redundancia de almacenamiento de la copia de seguridad |
|
| properties.backupTime |
string (date-time) |
Hora en que se realizó la copia de seguridad |
| properties.databaseDeletionTime |
string (date-time) |
Hora de eliminación de la base de datos |
| properties.databaseName |
string |
Nombre de la base de datos a la que pertenece la copia de seguridad |
| properties.managedInstanceCreateTime |
string (date-time) |
Hora de creación de la instancia. |
| properties.managedInstanceName |
string |
Instancia administrada a la que pertenece la base de datos de copia de seguridad. |
| systemData |
Azure Resource Manager metadatos que contienen información createdBy y modifiedBy. |
|
| type |
string |
Tipo de recurso. Por ejemplo, "Microsoft. Compute/virtualMachines" o "Microsoft. CuentasAlmacenamiento/Almacenamiento" |
ManagedInstanceLongTermRetentionBackupListResult
La respuesta de una operación de lista de respaldo de Managed InstanceLongTermRetention.
| Nombre | Tipo | Description |
|---|---|---|
| nextLink |
string (uri) |
El enlace a la siguiente página de artículos |
| value |
Los elementos de Managed InstanceLongTermRetentionBackup en esta página |
systemData
Metadatos relativos a la creación y última modificación del recurso.
| Nombre | Tipo | Description |
|---|---|---|
| createdAt |
string (date-time) |
Marca de tiempo de creación de recursos (UTC). |
| createdBy |
string |
Identidad que creó el recurso. |
| createdByType |
Tipo de identidad que creó el recurso. |
|
| lastModifiedAt |
string (date-time) |
La marca de tiempo de la última modificación del recurso (UTC) |
| lastModifiedBy |
string |
Identidad que modificó por última vez el recurso. |
| lastModifiedByType |
Tipo de identidad que modificó por última vez el recurso. |