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
locationName
path True

string

Ubicación de la base de datos

managedInstanceName
path True

string

Nombre de la instancia administrada.

subscriptionId
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.

databaseState
query

DatabaseState

Si desea consultar solo bases de datos activas, simplemente bases de datos eliminadas o todas las bases de datos.

onlyLatestPerDatabase
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

ManagedInstanceLongTermRetentionBackupListResult

La solicitud se ha realizado correctamente.

Other Status Codes

ErrorResponse

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
BackupStorageAccessTier

BackupStorageAccessTier para la copia de seguridad de LTR

BackupStorageRedundancy

Tipo de cuenta de almacenamiento que se usa para almacenar copias de seguridad de esta base de datos.

createdByType

Tipo de identidad que creó el recurso.

DatabaseState

Si desea consultar solo bases de datos activas, simplemente bases de datos eliminadas o todas las bases de datos.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

ManagedInstanceLongTermRetentionBackup

Una copia de seguridad de retención a largo plazo para una base de datos administrada.

ManagedInstanceLongTermRetentionBackupListResult

La respuesta de una operación de lista de respaldo de Managed InstanceLongTermRetention.

systemData

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

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

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

BackupStorageAccessTier para la copia de seguridad de LTR

properties.backupStorageRedundancy

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

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

ManagedInstanceLongTermRetentionBackup[]

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

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

createdByType

Tipo de identidad que modificó por última vez el recurso.