Soft Deleted Sql Databases - List

Servicio:: Cosmos DB Resource Provider

Versión de la API:: 2026-04-01-preview

Lista todas las bases de datos SQL de Azure Cosmos DB eliminadas suavemente bajo una cuenta de base de datos eliminada suavemente. Esta llamada requiere 'Microsoft. Permiso de DocumentDB/ubicaciones/cuentasDe Base de Datos Borradas/Bases de Datos TSQL/lectura'.

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

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

Respuestas

Nombre	Tipo	Description
200 OK	SoftDeletedSqlDatabasesListResult	Operación de Azure completada con éxito.
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

CosmosDBSoftDeletedSqlDatabaseList

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:: 200

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.DocumentDB/locations/westus/softDeletedDatabaseAccounts/softdeleted-cosmosdb-1/softDeletedSqlDatabases/MyDatabase",
      "name": "MyDatabase",
      "type": "Microsoft.DocumentDB/locations/softDeletedDatabaseAccounts/softDeletedSqlDatabases",
      "properties": {
        "softDeletionMetadata": {
          "isSoftDeleted": true,
          "softDeletionStartTimestamp": 1729000530,
          "softDeletionResourceExpirationTimestamp": 1731592530
        },
        "resource": {
          "id": "MyDatabase",
          "_rid": "PD5DALigDgw="
        }
      }
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.DocumentDB/locations/westus/softDeletedDatabaseAccounts/softdeleted-cosmosdb-1/softDeletedSqlDatabases/TestDatabase",
      "name": "TestDatabase",
      "type": "Microsoft.DocumentDB/locations/softDeletedDatabaseAccounts/softDeletedSqlDatabases",
      "properties": {
        "softDeletionMetadata": {
          "isSoftDeleted": true,
          "softDeletionStartTimestamp": 1728668415,
          "softDeletionResourceExpirationTimestamp": 1731260415
        },
        "resource": {
          "id": "TestDatabase",
          "_rid": "PD5DALigDgy="
        }
      }
    }
  ]
}

Definiciones

Nombre	Description
createdByType	Tipo de identidad que creó el recurso.
ErrorResponse	Respuesta de error.
SoftDeletedSqlDatabaseGetResult	Una base de datos SQL de Azure Cosmos DB eliminada de forma suave.
SoftDeletedSqlDatabaseProperties	Las propiedades de una base de datos SQL con eliminación suave.
SoftDeletedSqlDatabaseResource	Objeto de recurso de base de datos SQL de Cosmos DB
SoftDeletedSqlDatabasesListResult	La respuesta de operación List, que contiene las bases de datos SQL eliminadas suavemente y sus propiedades.
SoftDeletionMetadata	Metadatos sobre la eliminación suave de un recurso.
systemData	Metadatos relativos a la creación y última modificación del recurso.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

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.

SoftDeletedSqlDatabaseGetResult

Objeto

Una base de datos SQL de Azure Cosmos DB eliminada de forma suave.

Nombre	Tipo	Description
id	string (arm-id)	Identificador completamente cualificado del recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nombre del recurso.
properties	SoftDeletedSqlDatabaseProperties	Propiedades específicas del recurso para este recurso.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

SoftDeletedSqlDatabaseProperties

Objeto

Las propiedades de una base de datos SQL con eliminación suave.

Nombre	Tipo	Description
resource	SoftDeletedSqlDatabaseResource	La información de recursos para la base de datos SQL eliminada suavemente.
softDeletionMetadata	SoftDeletionMetadata	Metadatos relacionados con la eliminación suave de la base de datos SQL.

SoftDeletedSqlDatabaseResource

Objeto

Objeto de recurso de base de datos SQL de Cosmos DB

Nombre	Tipo	Description
_rid	string	Una propiedad generada por el sistema. Identificador único.
id	string	Nombre de la base de datos SQL de Cosmos DB