Läs på engelska

Dela via

Azure Cosmos DB: REST API-referens

  • Artikel
  • 2023-08-05

Azure Cosmos DB är en globalt distribuerad databas med flera modeller som stöder datamodeller för dokument, diagram och nyckelvärden. Innehållet i det här avsnittet handlar om att skapa, fråga och hantera dokumentresurser med hjälp av SQL-API :et via REST.

Rest-API:et för Azure Cosmos DB ger programmatisk åtkomst till Azure Cosmos DB-resurser för att skapa, köra frågor mot och ta bort databaser, dokumentsamlingar och dokument. Om du vill utföra åtgärder på Azure Cosmos DB-resurser skickar du HTTPS-begäranden med en metod som stöds: GET, POST, PUTeller DELETE till en slutpunkt som är avsedd för en resurssamling eller en specifik resurs. Det här avsnittet beskriver hur du arbetar med resurser med hjälp av REST-API:et.

Anteckning

Dessa API-referensartiklar visar hur du skapar resurser med hjälp av Azure Cosmos DB-dataplans-API:et. Med API:et för dataplanet kan du konfigurera grundläggande alternativ, till exempel indexeringsprincip, partitionsnycklar ungefär som du kan med Cosmos DB-SDK:er. Om du behöver fullständigt funktionsstöd för alla Azure Cosmos DB-resurser rekommenderar vi att du använder Cosmos DB-resursprovidern. API-referensartiklar visas nedan.

REST API-versioner som stöds

I följande tabell visas de REST API-versioner som stöds av Azure Cosmos DB-tjänsten. Versionen måste anges via x-ms-version rubriken i varje begäran. Den senaste versionen används när rubriken inte anges.

Version Ändring introducerad Indragningsdatum
2018-12-31 Automatisk migrering av partitionerade samlingar
2018-09-17 Sammansatt och ytterligare rumslig indexering
2018-08-31 Förbättringar av dynamisk samlingsskalning
2018-06-18 Stöd för skrivning i flera regioner
2017-11-15 Stark konsekvens i flera regioner
2017-05-03 Stor partitionsnyckel
2017-02-22 Konsekvent prefix
2017-01-19 Minskat minsta dataflöde för partitionerade samlingar till 2 500 RU/s
2016-07-11 Ändringsflöde
2015-12-16 Partitionerade samlingar
2015-08-06 Upsert
2015-06-03 Beställ efter support
2015-04-08 Allmän tillgänglighet för DocumentDB (nu en del av Azure Cosmos DB)
2014-08-21 Offentlig förhandsversion av DocumentDB (nu en del av Azure Cosmos DB) den 29 februari 2016

Cosmos DB-resurser

I följande artiklar beskrivs de REST-API:er som stöds för varje resurstyp. Allmän information om resursmodellen finns i Resursmodell och Cosmos DB-resurs-URI:er.

Information om hur du auktoriserar begäranden finns i Åtkomstkontroll . Allmän information om alternativ för begäranden och svar finns i följande artiklar:

Se även