Löschen einer Auflistung
Der Delete Collection Vorgang löscht eine vorhandene Sammlung in einer Datenbank.
Hinweis
In diesen API-Referenzartikeln erfahren Sie, wie Sie Ressourcen mithilfe der Azure Cosmos DB-Datenebenen-API erstellen. Mit der Datenebenen-API können Sie grundlegende Optionen wie Indizierungsrichtlinie und Partitionsschlüssel ähnlich wie bei Cosmos DB SDKs konfigurieren. Wenn Sie vollständige Featureunterstützung für alle Azure Cosmos DB-Ressourcen benötigen, empfehlen wir die Verwendung des Cosmos DB-Ressourcenanbieters.
Anforderung
| Methode | Anforderungs-URI | BESCHREIBUNG |
|---|---|---|
| Delete | https://{databaseaccount}.documents.azure.com/dbs/{db-id}/colls/{coll-id} | {databaseaccount} ist der Name des Azure Cosmos DB-Kontos, das unter Ihrem Abonnement erstellt wurde. Der Wert {db-id} ist der vom Benutzer generierte Name/die ID der Datenbank, nicht die vom System generierte ID (rid). Der Wert {coll-id} ist der Name der zu löschenden Auflistung. |
Header
Für die Sammlung löschen sind die Header erforderlich, die unter Allgemeine Azure Cosmos DB-REST-Anforderungsheader aufgeführt sind.
Text
Keine.
Antwort
Header
Informationen zu Headern, die von allen Azure Cosmos DB-Antworten zurückgegeben werden, finden Sie unter Allgemeine Azure Cosmos DB-REST-Antwortheader .
Statuscodes
In der folgenden Tabelle sind die allgemeinen Statuscodes aufgeführt, die von diesem Vorgang zurückgegeben werden. Eine vollständige Liste der status Codes finden Sie unter HTTP-Statuscodes.
| Code | BESCHREIBUNG |
|---|---|
| 204 Kein Inhalt | Der Löschvorgang war erfolgreich. |
| 404 – Nicht gefunden | Die zu löschende Sammlung ist keine Ressource mehr, d. h. die Sammlung wurde gelöscht. |
Text
Keine.
Beispiel
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