Restorable Sql Resources - List
Retourne la liste des combinaisons de base de données et conteneur qui existent sur le compte au timestamp et à l’emplacement donnés. Cela est utile dans des scénarios de validation des ressources qui existent à un timestamp et à un emplacement donnés. Cette API nécessite l’autorisation « Microsoft.DocumentDB/locations/restorableDatabaseAccounts/.../read ».
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableSqlResources?api-version=2023-11-15
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{instanceId}/restorableSqlResources?api-version=2023-11-15&restoreLocation={restoreLocation}&restoreTimestampInUtc={restoreTimestampInUtc}
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
instance
|
path | True |
string |
GUID instanceId d’un compte de base de données restaurable. |
location
|
path | True |
string |
Région Cosmos DB, avec des espaces entre les mots et chaque mot en majuscules. |
subscription
|
path | True |
string |
ID de l’abonnement cible. |
api-version
|
query | True |
string |
Version de l’API à utiliser pour cette opération. |
restore
|
query |
string |
Emplacement où se trouvent les ressources restaurables. |
|
restore
|
query |
string |
Timestamp où les ressources restaurables existaient. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
L’opération s’est terminée avec succès. |
|
Other Status Codes |
Réponse d’erreur décrivant la raison de l’échec de l’opération. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nom | Description |
---|---|
user_impersonation | Emprunter l’identité de votre compte d’utilisateur |
Exemples
CosmosDBRestorableSqlResourceList
Sample Request
GET https://management.azure.com/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDB/locations/WestUS/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorableSqlResources?api-version=2023-11-15&restoreLocation=WestUS&restoreTimestampInUtc=06/01/2022 4:56
Sample Response
{
"value": [
{
"id": "/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorablesqlresources/Database1",
"type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorablesqlresources",
"name": "Database1",
"databaseName": "Database1",
"collectionNames": [
"Container1"
]
},
{
"id": "/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorablesqlresources/Database2",
"type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorablesqlresources",
"name": "Database2",
"databaseName": "Database2",
"collectionNames": [
"Container1",
"Container2"
]
},
{
"id": "/subscriptions/2296c272-5d55-40d9-bc05-4d56dc2d7588/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/d9b26648-2f53-4541-b3d8-3044f4f9810d/restorablesqlresources/Database3",
"type": "Microsoft.DocumentDB/locations/restorableDatabaseAccounts/restorablesqlresources",
"name": "Database3",
"databaseName": "Database3",
"collectionNames": []
}
]
}
Définitions
Nom | Description |
---|---|
Cloud |
Réponse d’erreur du service. |
Error |
Réponse d’erreur. |
Restorable |
Bases de données spécifiques à restaurer. |
Restorable |
Réponse de l’opération List, contenant les ressources SQL restaurables. |
CloudError
Réponse d’erreur du service.
Nom | Type | Description |
---|---|---|
error |
Réponse d’erreur. |
ErrorResponse
Réponse d’erreur.
Nom | Type | Description |
---|---|---|
code |
string |
Code d’erreur. |
message |
string |
Message d’erreur indiquant la raison de l’échec de l’opération. |
RestorableSqlResourcesGetResult
Bases de données spécifiques à restaurer.
Nom | Type | Description |
---|---|---|
collectionNames |
string[] |
Noms des collections disponibles pour la restauration. |
databaseName |
string |
Nom de la base de données disponible pour la restauration. |
id |
string |
Identificateur de ressource unique de la ressource ARM. |
name |
string |
Nom de la ressource ARM. |
type |
string |
Type de ressource Azure. |
RestorableSqlResourcesListResult
Réponse de l’opération List, contenant les ressources SQL restaurables.
Nom | Type | Description |
---|---|---|
value |
Liste des ressources SQL restaurables, incluant les noms de base de données et de collection. |