Azure Cosmos DB: referencia de la API REST

  • Artículo

Azure Cosmos DB es una base de datos multimodelo distribuida globalmente que admite los modelos de datos de documento, gráfico y clave-valor. El contenido de esta sección es para crear, consultar y administrar recursos de documentos mediante la API de SQL a través de REST.

La API de REST de Azure Cosmos DB proporciona acceso mediante programación a recursos de Azure Cosmos DB para crear, consultar y eliminar bases de datos, colecciones de documentos y documentos. Para realizar operaciones en recursos de Azure Cosmos DB, envíe solicitudes HTTPS con un método admitido: GET, POST, PUTo DELETE a un punto de conexión que tenga como destino una colección de recursos o un recurso específico. En esta sección se explica cómo trabajar con recursos mediante la API REST.

Nota:

En estos artículos de referencia de API se muestra cómo crear recursos mediante la API del plano de datos de Azure Cosmos DB. Con la API del plano de datos, puede configurar opciones básicas, como la directiva de indexación, las claves de partición del mismo modo que puede usar los SDK de Cosmos DB. Si necesita compatibilidad completa con características para todos los recursos de Azure Cosmos DB, se recomienda usar el proveedor de recursos de Cosmos DB. A continuación se enumeran los artículos de referencia de API.

Versiones admitidas de la API REST

En la tabla siguiente se enumeran las versiones admitidas de la API REST por el servicio Azure Cosmos DB. La versión debe especificarse a través del x-ms-version encabezado en cada solicitud. Cuando no se proporciona el encabezado, se utiliza la última versión.

Versión Cambio introducido Fecha de retirada
2018-12-31 Migración automática de colecciones con particiones
2018-09-17 Indexación espacial compuesta y adicional
2018-08-31 Mejoras de escalado de recopilación dinámica
2018-06-18 Compatibilidad con escrituras de varias regiones
2017-11-15 Coherencia fuerte en varias regiones
2017-05-03 Clave de partición grande
2017-02-22 De prefijo coherente
2017-01-19 Rendimiento mínimo reducido para colecciones con particiones a 2500 RU/s
2016-07-11 Fuente de cambios
2015-12-16 Colecciones con particiones
2015-08-06 Upsert
2015-06-03 Order By support
2015-04-08 Disponibilidad general de DocumentDB (ahora parte de Azure Cosmos DB)
2014-08-21 Versión preliminar pública de DocumentDB (ahora parte de Azure Cosmos DB) 29 de febrero de 2016

Recursos de Cosmos DB

En los artículos siguientes se describen las API REST admitidas para cada tipo de recurso. Para obtener información general sobre el modelo de recursos, consulte Modelo derecursos y URI de recursos de Cosmos DB.

Consulte Control de acceso para obtener información sobre cómo autorizar solicitudes. Para obtener información general sobre las opciones de solicitud y respuesta, consulte los siguientes artículos:

Consulte también