Soft Deleted Sql Databases - Restore

Servicio:
Cosmos DB Resource Provider
Versión de la API:
2026-04-01-preview

Restaura una base de datos SQL de Azure Cosmos DB eliminada de forma suave.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/locations/{location}/softDeletedDatabaseAccounts/{accountName}/softDeletedSqlDatabases/{databaseName}?softDeleteActionKind=RestoreSoftDeletedResource&api-version=2026-04-01-preview
Con parámetros opcionales: 
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}

Parámetros de identificador URI

Nombre En Requerido Tipo Description
accountName
 path True

string

minLength: 3
maxLength: 50
pattern: ^[a-z0-9]+(-[a-z0-9]+)*

Nombre de la cuenta de base de datos de Cosmos DB.
databaseName
 path True

string

pattern: ^[^/\\#?]+$

Nombre de la base de datos SQL de Cosmos DB.
location
 path True

string

minLength: 1

Nombre de la región de Azure.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
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 la API que se va a usar para esta operación.
softDeleteActionKind
 query

SoftDeleteActionKind

El tipo de acción de borrado suave que se puede realizar.

Respuestas

Nombre Tipo Description
202 Accepted

Eliminación de recursos aceptada.

Encabezados

  • Location: string
  • Retry-After: integer
204 No Content

El recurso no existe.
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 su cuenta de usuario

Ejemplos

CosmosDBSoftDeletedSqlDatabaseRestore

Solicitud de ejemplo

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

Respuesta de muestra

status code:
202 
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.DocumentDB/locations/westus/operationResults/restore-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/restore-operation-id?api-version=2026-04-01-preview
status code:
204

Definiciones

Nombre Description
ErrorResponse

Respuesta de error.
SoftDeleteActionKind

El tipo de acción de borrado suave que se puede realizar.

ErrorResponse

Objeto

Respuesta de error.

Nombre Tipo Description
code

string

Código de error.
message

string

Mensaje de error que indica por qué se produjo un error en la operación.

SoftDeleteActionKind

Enumeración

El tipo de acción de borrado suave que se puede realizar.

Valor Description
RestoreSoftDeletedResource

Restaura el recurso eliminado suavemente a estado activo/online.
PermanentDeleteResource

Elimina permanentemente el recurso que se borró de forma suave.