Azure Cosmos DB: dokumentacja interfejsu API RESTAzure Cosmos DB: REST API Reference

  • Czas czytania: 2 min

Azure Cosmos DB to globalnie dystrybuowana wielomodelowa baza danych, która obsługuje modele danych dokumentów, grafów i wartości kluczy.Azure Cosmos DB is a globally distributed multi-model database that supports the document, graph, and key-value data models. Zawartość tej sekcji służy do tworzenia i wykonywania zapytań dotyczących zasobów dokumentów oraz zarządzania nimi przy użyciu interfejsu API SQL za pośrednictwem protokołu REST.The content in this section is for creating, querying, and managing document resources using the SQL API via REST.

Interfejs API REST Azure Cosmos DB zapewnia programistyczny dostęp do zasobów Azure Cosmos DB do tworzenia, wykonywania zapytań i usuwania baz danych, kolekcji dokumentów i dokumentów.The Azure Cosmos DB REST API provides programmatic access to Azure Cosmos DB resources to create, query, and delete databases, document collections, and documents. Aby wykonywać operacje na Azure Cosmos DB zasobach, należy wysyłać żądania HTTPS za pomocą obsługiwanej metody: GET , POST , PUT lub DELETE do punktu końcowego, który jest przeznaczony dla kolekcji zasobów lub określonego zasobu.To perform operations on Azure Cosmos DB resources, you send HTTPS requests with a supported method: GET, POST, PUT, or DELETE to an endpoint that targets a resource collection or a specific resource. W tej sekcji opisano sposób pracy z zasobami przy użyciu interfejsu API REST.This section explains how to work with resources by using the REST API.

Poniższe wideo zawiera doskonałe wprowadzenie do Azure Cosmos DB interfejsów API REST.The follow video gives a great introduction to Azure Cosmos DB REST APIs.

Obsługiwane wersje interfejsu API RESTSupported REST API Versions

W poniższej tabeli wymieniono obsługiwane wersje interfejsu API REST usługi Azure Cosmos DB.The following table lists the supported REST API versions by the Azure Cosmos DB service. Wersja musi być określona za pośrednictwem x-ms-version nagłówka w każdym żądaniu.The version must be specified via the x-ms-version header in every request. Jeśli nie zostanie określony, domyślnie jest to Najnowsza wersja usługi 2017-02-22 .If not specified, the service defaults to the latest version 2017-02-22.

WersjaVersion Wprowadzona zmianaChange introduced Data wycofaniaRetirement date
2018-12-312018-12-31 Automatyczne Migrowanie partycjonowanych kolekcjiPartitioned collections automatic migration
2018-09-172018-09-17 Złożone i dodatkowe indeksowanie przestrzenneComposite and additional spatial indexing
2018-08-312018-08-31 Ulepszenia dynamicznego skalowania kolekcjiDynamic collection scaling improvements
2018-06-182018-06-18 Obsługa zapisu w wieloregionachMulti-region write support
2017-11-152017-11-15 Silna spójność wieloregionowaMulti-region Strong Consistency
2017-05-032017-05-03 Duży klucz partycjiLarge partition key
2017-02-222017-02-22 Spójny prefiksConsistent prefix
2017-01-192017-01-19 Obniżona minimalna przepływność dla kolekcji partycjonowanych do 2500 RU/sLowered minimum throughput for partitioned collections to 2500 RU/s
2016-07-112016-07-11 Źródło zmianChange feed
2015-12-162015-12-16 Partycjonowane KolekcjePartitioned collections
2015-08-062015-08-06 UpsertUpsert
2015-06-032015-06-03 Zamów przez pomoc technicznąOrder By support
2015-04-082015-04-08 Ogólna dostępność DocumentDB (obecnie część Azure Cosmos DB)DocumentDB general availability (now part of Azure Cosmos DB)
2014-08-212014-08-21 Publiczna wersja zapoznawcza DocumentDB (obecnie część Azure Cosmos DB)DocumentDB public preview (now part of Azure Cosmos DB) 29 lutego, 2016February 29th, 2016

Zasoby Cosmos DBCosmos DB Resources

W poniższych artykułach opisano obsługiwane interfejsy API REST dla każdego typu zasobu.The following articles describe the supported REST APIs for each resource type. Ogólne informacje o modelu zasobów znajdują się w temacie model zasobów i identyfikatory URI zasobów Cosmos DB.For general information about the resource model, see Resource model and Cosmos DB resource URIs.

Aby dowiedzieć się, jak autoryzować żądania, zobacz Kontrola dostępu .See Access control for how to authorize requests. Aby uzyskać ogólne informacje na temat opcji żądania i odpowiedzi, zobacz następujące artykuły:For general information about request and response options, see the following articles:

Zobacz teżSee Also