Soft Deleted Sql Databases - Purge

Service:: Cosmos DB Resource Provider

Version d'API:: 2026-04-01-preview

Supprime définitivement une base de données SQL Azure Cosmos DB supprimée de façon douce.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/locations/{location}/softDeletedDatabaseAccounts/{accountName}/softDeletedSqlDatabases/{databaseName}?softDeleteActionKind=PermanentDeleteResource&api-version=2026-04-01-preview

Avec des paramètres facultatifs:

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/locations/{location}/softDeletedDatabaseAccounts/{accountName}/softDeletedSqlDatabases/{databaseName}?api-version=2026-04-01-preview&softDeleteActionKind={softDeleteActionKind}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
accountName	path	True	string minLength: 3 maxLength: 50 pattern: ^[a-z0-9]+(-[a-z0-9]+)*	Nom du compte de base de données Cosmos DB.
databaseName	path	True	string pattern: ^[^/\\#?]+$	Nom de la base de données SQL de Cosmos DB.
location	path	True	string minLength: 1	Nom de la région Azure.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	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.
softDeleteActionKind	query		SoftDeleteActionKind	Le genre d’action de suppression douce à effectuer.

Réponses

Nom	Type	Description
202 Accepted		Suppression de ressource acceptée. En-têtes Location: string Retry-After: integer
204 No Content		La ressource n’existe pas.
Other Status Codes	ErrorResponse	Réponse d’erreur inattendue.

Nom

Type

Description

202 Accepted

Suppression de ressource acceptée.

En-têtes

Location: string
Retry-After: integer

204 No Content

La ressource n’existe pas.

Other Status Codes

ErrorResponse

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	Usurper l’identité de votre compte utilisateur

Exemples

CosmosDBSoftDeletedSqlDatabasePurge

Exemple de requête

HTTP

DELETE https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.DocumentDB/locations/West US/softDeletedDatabaseAccounts/softdeleted-cosmosdb-1/softDeletedSqlDatabases/MyDatabase?api-version=2026-04-01-preview

Exemple de réponse

Code d’état:: 202

Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.DocumentDB/locations/westus/operationResults/purge-database-operation-id?api-version=2026-04-01-preview
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.DocumentDB/locations/westus/operationResults/purge-database-operation-id?api-version=2026-04-01-preview

Code d’état:: 204

Code d’état:: default

{
  "error": {
    "code": "BadRequest",
    "message": "The soft-deleted SQL database cannot be purged yet. Minimum retention period has not elapsed."
  }
}

Définitions

Nom	Description
ErrorResponse	Réponse d’erreur.
SoftDeleteActionKind	Le genre d’action de suppression douce à effectuer.

ErrorResponse

Objet

Réponse d’erreur.

Nom	Type	Description
code	string	Code d’erreur.
message	string	Message d’erreur indiquant pourquoi l’opération a échoué.

SoftDeleteActionKind

Énumération

Le genre d’action de suppression douce à effectuer.

Valeur	Description
RestoreSoftDeletedResource	Restaure la ressource supprimée en état actif/en ligne.
PermanentDeleteResource	Supprime définitivement la ressource supprimée en douceur.