Eliminare una raccolta
L'operazione Delete Collection elimina una raccolta esistente in un database.
Nota
Questi articoli di riferimento sulle API illustrano come creare risorse usando l'API del piano dati di Azure Cosmos DB. Con l'API del piano dati è possibile configurare opzioni di base, ad esempio criteri di indicizzazione, chiavi di partizione molto simili a quelle che è possibile usare con gli SDK di Cosmos DB. Se è necessario il supporto completo delle funzionalità per tutte le risorse di Azure Cosmos DB, è consigliabile usare il provider di risorse Cosmos DB.
Richiesta
| Metodo | URI richiesta | Descrizione |
|---|---|---|
| DELETE | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/colls/{coll-id} | {databaseaccount} è il nome dell'account Azure Cosmos DB creato nella sottoscrizione. Il valore {db-id} è il nome/ID generato dall'utente del database, non l'ID generato dal sistema (rid). Il valore {coll-id} è il nome della raccolta da eliminare. |
Intestazioni
Delete Collection richiede le intestazioni elencate in Intestazioni di richiesta REST comuni di Azure Cosmos DB.
Corpo
Nessuno.
Risposta
Intestazioni
Vedere Intestazioni di risposta REST comuni di Azure Cosmos DB per le intestazioni restituite da tutte le risposte di Azure Cosmos DB.
Codici di stato
La seguente tabella elenca i codici di stato comuni restituiti da questa operazione. Per un elenco completo dei codici di stato, vedere Codici di stato HTTP.
| Codice | Descrizione |
|---|---|
| 204 No Content (Nessun contenuto) | L'operazione di eliminazione è riuscita. |
| 404 - Non trovato | La raccolta da eliminare non è più una risorsa, ovvero la raccolta è stata eliminata. |
Corpo
No.
Esempio
DELETE https://querydemo.documents.azure.com/dbs/testdb/colls/testcoll HTTP/1.1
x-ms.date: 04/20/2021
authorization: type%3dmaster%26ver%3d1.0%26sig%3dWmlMB62iSXF%2f0CUMyBD00AzOFH4LlcjzibmFC6zocxc%3d
Cache-Control: no-cache
User-Agent: Microsoft.Azure.Documents.Client/1.6.0.0 samples-net/3
x-ms-version: 2015-12-16
Accept: application/json
Host: querydemo.documents.azure.com
Cookie: x-ms-session-token#0=365; x-ms-session-token=365
Content-Length: 0
HTTP/1.1 204 No Content
Cache-Control: no-store, no-cache
Pragma: no-cache
Content-Length: 0
Content-Type: application/json
Content-Location: https://querydemo.documents.azure.com/dbs/testdb/colls/testcoll
Server: Microsoft-HTTPAPI/2.0
Strict-Transport-Security: max-age=31536000
x-ms-last-state-change-utc: Fri, 25 Mar 2016 22:54:09.213 GMT
x-ms-resource-quota: collections=5000;
x-ms-resource-usage: collections=28;
collection-partition-index: 0
collection-service-index: 0
x-ms-schemaversion: 1.1
x-ms-alt-content-path: dbs/testdb
x-ms-quorum-acked-lsn: 7850
x-ms-current-write-quorum: 3
x-ms-current-replica-set-size: 4
x-ms-request-charge: 4.95
x-ms-serviceversion: version=1.6.52.5
x-ms-activity-id: c341354d-7040-4d01-8531-ab66caf7a01c
x-ms-session-token: M:7851
Set-Cookie: x-ms-session-token#M=7851; Domain=querydemo.documents.azure.com; Path=/dbs/-6MXAA==/colls/-6MXAPvmWww=
Set-Cookie: x-ms-session-token=7851; Domain=querydemo.documents.azure.com; Path=/dbs/-6MXAA==/colls/-6MXAPvmWww=
x-ms-gatewayversion: version=1.6.52.5
Date: Mon, 28 Mar 2016 20:56:35 GMT