Long Term Retention Managed Instance Backups - List By Instance
Répertorie les sauvegardes de rétention à long terme pour une instance managée donnée.
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}
Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
location
|
path | True |
string |
Emplacement de la base de données |
|
managed
|
path | True |
string |
Nom de l’instance managée. |
|
subscription
|
path | True |
string (uuid) |
ID de l’abonnement cible. La valeur doit être un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Version de l’API à utiliser pour cette opération. |
|
database
|
query |
S’il faut interroger uniquement des bases de données actives, simplement supprimer des bases de données ou toutes les bases de données. |
||
|
only
|
query |
boolean |
Indique s’il faut obtenir ou non uniquement la dernière sauvegarde pour chaque base de données. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
La demande a réussi. |
|
| Other Status Codes |
Réponse d’erreur inattendue. |
Sécurité
azure_auth
Flux OAuth2 d’Azure Active Directory.
Type:
oauth2
Flux:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
| Nom | Description |
|---|---|
| user_impersonation | emprunter l’identité de votre compte d’utilisateur |
Exemples
Get all long term retention backups under the managed instance.
Exemple de requête
GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/japaneast/longTermRetentionManagedInstances/testInstance/longTermRetentionManagedInstanceBackups?api-version=2025-01-01
Exemple de réponse
{
"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"
}
}
]
}
Définitions
| Nom | Description |
|---|---|
|
Backup |
BackupStorageAccessTier pour la sauvegarde LTR |
|
Backup |
Type de compte de stockage utilisé pour stocker des sauvegardes pour cette base de données. |
|
created |
Type d’identité qui a créé la ressource. |
|
Database |
S’il faut interroger uniquement des bases de données actives, simplement supprimer des bases de données ou toutes les bases de données. |
|
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
|
Error |
Détail de l’erreur. |
|
Error |
Réponse d’erreur |
|
Managed |
Sauvegarde de rétention à long terme pour une base de données managée. |
|
Managed |
La réponse d’une opération de liste ManagedInstanceLongTermRetention. |
|
system |
Métadonnées relatives à la création et à la dernière modification de la ressource. |
BackupStorageAccessTier
BackupStorageAccessTier pour la sauvegarde LTR
| Valeur | Description |
|---|---|
| Hot |
Chaud |
| Archive |
L'archive |
BackupStorageRedundancy
Type de compte de stockage utilisé pour stocker des sauvegardes pour cette base de données.
| Valeur | Description |
|---|---|
| Geo |
Zone géographique |
| Local |
Local |
| Zone |
Zone |
| GeoZone |
GeoZone |
createdByType
Type d’identité qui a créé la ressource.
| Valeur | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DatabaseState
S’il faut interroger uniquement des bases de données actives, simplement supprimer des bases de données ou toutes les bases de données.
| Valeur | Description |
|---|---|
| All |
Tous |
| Live |
En direct |
| Deleted |
Supprimé |
ErrorAdditionalInfo
Informations supplémentaires sur l’erreur de gestion des ressources.
| Nom | Type | Description |
|---|---|---|
| info |
object |
Informations supplémentaires. |
| type |
string |
Type d’informations supplémentaire. |
ErrorDetail
Détail de l’erreur.
| Nom | Type | Description |
|---|---|---|
| additionalInfo |
Informations supplémentaires sur l’erreur. |
|
| code |
string |
Code d’erreur. |
| details |
Détails de l’erreur. |
|
| message |
string |
Message d’erreur. |
| target |
string |
Cible d’erreur. |
ErrorResponse
Réponse d’erreur
| Nom | Type | Description |
|---|---|---|
| error |
Objet d’erreur. |
ManagedInstanceLongTermRetentionBackup
Sauvegarde de rétention à long terme pour une base de données managée.
| Nom | Type | Description |
|---|---|---|
| id |
string (arm-id) |
ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} » |
| name |
string |
Nom de la ressource |
| properties.backupExpirationTime |
string (date-time) |
Heure d’expiration de la sauvegarde de rétention à long terme. |
| properties.backupStorageAccessTier |
BackupStorageAccessTier pour la sauvegarde LTR |
|
| properties.backupStorageRedundancy |
Type de redondance de stockage de la sauvegarde |
|
| properties.backupTime |
string (date-time) |
Heure à laquelle la sauvegarde a été effectuée |
| properties.databaseDeletionTime |
string (date-time) |
Heure de suppression de la base de données |
| properties.databaseName |
string |
Nom de la base de données à laquelle appartient la sauvegarde |
| properties.managedInstanceCreateTime |
string (date-time) |
Heure de création de l’instance. |
| properties.managedInstanceName |
string |
Instance managée à laquelle appartient la base de données de sauvegarde. |
| systemData |
Azure Resource Manager : métadonnées contenant des informations createdBy et modifiedBy. |
|
| type |
string |
Type de la ressource. Par exemple : « Microsoft. Calcul/virtualMachines » ou « Microsoft. StorageAccounts" |
ManagedInstanceLongTermRetentionBackupListResult
La réponse d’une opération de liste ManagedInstanceLongTermRetention.
| Nom | Type | Description |
|---|---|---|
| nextLink |
string (uri) |
Lien vers la page suivante des éléments |
| value |
Les éléments de sauvegarde ManagedInstanceLongTermRetentionBackup sur cette page |
systemData
Métadonnées relatives à la création et à la dernière modification de la ressource.
| Nom | Type | Description |
|---|---|---|
| createdAt |
string (date-time) |
Horodatage de la création de ressources (UTC). |
| createdBy |
string |
Identité qui a créé la ressource. |
| createdByType |
Type d’identité qui a créé la ressource. |
|
| lastModifiedAt |
string (date-time) |
Horodatage de la dernière modification de ressource (UTC) |
| lastModifiedBy |
string |
Identité qui a modifié la ressource pour la dernière fois. |
| lastModifiedByType |
Type d’identité qui a modifié la ressource pour la dernière fois. |