Base de datos Microsoft.DocumentDBCuentas 2020-04-01
- Más reciente
- 2024-05-15
- 2024-05-15-preview
- 2024-02-15-preview
- 2023-11-15
- 2023-11-15-preview
- 2023-09-15
- 2023-09-15-preview
- 2023-04-15
- 15-03-2023
- 2023-03-15-preview
- 2023-03-01-preview
- 2022-11-15
- 2022-11-15-preview
- 2022-08-15
- 2022-08-15-preview
- 2022-05-15
- 2022-05-15-preview
- 2022-02-15-preview
- 2021-11-15-preview
- 2021-10-15
- 2021-10-15-preview
- 2021-07-01-preview
- 2021-06-15
- 2021-05-15
- 2021-04-15
- 2021-04-01-preview
- 2021-03-15
- 2021-03-01-preview
- 15-01-2021
- 01-09-2020
- 2020-06-01-preview
- 2020-04-01
- 2020-03-01
- 2019-12-12
- 2019-08-01
- 2016-03-31
- 2016-03-19
- 2015-11-06
- 2015-04-08
- 2015-04-01
Definición de recursos de Bicep
El tipo de recurso databaseAccounts se puede implementar con operaciones destinadas a:
- Grupos de recursos: consulte los comandos de implementación del grupo de recursos.
Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.DocumentDB/databaseAccounts, agregue el siguiente bicep a la plantilla.
resource symbolicname 'Microsoft.DocumentDB/databaseAccounts@2020-04-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
kind: 'string'
properties: {
apiProperties: {
serverVersion: 'string'
}
capabilities: [
{
name: 'string'
}
]
connectorOffer: 'Small'
consistencyPolicy: {
defaultConsistencyLevel: 'string'
maxIntervalInSeconds: int
maxStalenessPrefix: int
}
cors: [
{
allowedHeaders: 'string'
allowedMethods: 'string'
allowedOrigins: 'string'
exposedHeaders: 'string'
maxAgeInSeconds: int
}
]
databaseAccountOfferType: 'Standard'
disableKeyBasedMetadataWriteAccess: bool
enableAnalyticalStorage: bool
enableAutomaticFailover: bool
enableCassandraConnector: bool
enableFreeTier: bool
enableMultipleWriteLocations: bool
ipRules: [
{
ipAddressOrRange: 'string'
}
]
isVirtualNetworkFilterEnabled: bool
keyVaultKeyUri: 'string'
locations: [
{
failoverPriority: int
isZoneRedundant: bool
locationName: 'string'
}
]
virtualNetworkRules: [
{
id: 'string'
ignoreMissingVNetServiceEndpoint: bool
}
]
}
}
Valores de propiedad
databaseAccounts
| Nombre | Descripción | Value |
|---|---|---|
| name | El nombre del recurso | string (obligatorio) Límite de caracteres: 3-44 Caracteres válidos: Letras minúsculas, números y guiones. Comience con una letra minúscula o un número. El nombre del recurso debe ser único en Azure. |
| ubicación | Ubicación del grupo de recursos al que pertenece el recurso. | string |
| etiquetas | Las etiquetas son una lista de pares clave-valor que describen el recurso. Estas etiquetas pueden utilizarse para visualizar y agrupar este recurso a través de grupos de recursos. Se puede proporcionar un máximo de 15 etiquetas para un recurso. Cada etiqueta debe tener una clave no superior a 128 caracteres y un valor no superior a 256 caracteres. Por ejemplo, la experiencia predeterminada para un tipo de plantilla se establece con "defaultExperience": "Cassandra". Los valores actuales "defaultExperience" también incluyen "Table", "Graph", "DocumentDB" y "MongoDB". | Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas. |
| kind | Indica el tipo de cuenta de base de datos. Esto solo se puede establecer en la creación de la cuenta de base de datos. | "GlobalDocumentDB" "MongoDB" 'Parse' |
| properties | Propiedades para crear y actualizar cuentas de base de datos de Azure Cosmos DB. | DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (obligatorio) |
DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...
| Nombre | Descripción | Valor |
|---|---|---|
| apiProperties | Propiedades específicas de la API. Actualmente, solo se admite para la API de MongoDB. | ApiProperties |
| capabilities | Lista de funcionalidades de Cosmos DB para la cuenta | Funcionalidad[] |
| connectorOffer | Tipo de oferta del conector cassandra para la cuenta de C* de base de datos de Cosmos DB. | "Pequeño" |
| consistencyPolicy | Directiva de coherencia de la cuenta de Cosmos DB. | ConsistencyPolicy |
| cors | Directiva de CORS para la cuenta de base de datos de Cosmos DB. | CorsPolicy[] |
| databaseAccountOfferType | Tipo de oferta de la base de datos | 'Standard' (obligatorio) |
| disableKeyBasedMetadataWriteAccess | Deshabilitación de operaciones de escritura en recursos de metadatos (bases de datos, contenedores, rendimiento) a través de claves de cuenta | bool |
| enableAnalyticalStorage | Marca para indicar si se va a habilitar el análisis de almacenamiento. | bool |
| enableAutomaticFailover | Habilita la conmutación automática por error de la región de escritura en el caso poco frecuente de que la región no esté disponible debido a una interrupción. La conmutación automática por error dará lugar a una nueva región de escritura para la cuenta y se elige en función de las prioridades de conmutación por error configuradas para la cuenta. | bool |
| enableCassandraConnector | Habilita el conector cassandra en la cuenta de C* de Cosmos DB. | bool |
| enableFreeTier | Marca para indicar si el nivel gratis está habilitado. | bool |
| enableMultipleWriteLocations | Permite que la cuenta escriba en varias ubicaciones. | bool |
| ipRules | Lista de IpRules. | IpAddressOrRange[] |
| isVirtualNetworkFilterEnabled | Marca para indicar si se deben habilitar o deshabilitar reglas de ACL de red virtual. | bool |
| keyVaultKeyUri | URI del almacén de claves | string |
| locations | Matriz que contiene las ubicaciones de georeplicación habilitadas para la cuenta de Cosmos DB. | Location[] (obligatorio) |
| virtualNetworkRules | Lista de reglas de ACL de red virtual configuradas para la cuenta de Cosmos DB. | VirtualNetworkRule[] |
ApiProperties
| Nombre | Descripción | Valor |
|---|---|---|
| serverVersion | Describe serverVersion de una cuenta de MongoDB. | '3.2' '3.6' |
Capacidad
| Nombre | Descripción | Value |
|---|---|---|
| name | Nombre de la funcionalidad de Cosmos DB. Por ejemplo, "name": "EnableCassandra". Los valores actuales también incluyen "EnableTable" y "EnableGremlin". | string |
ConsistencyPolicy
| Nombre | Descripción | Valor |
|---|---|---|
| defaultConsistencyLevel | Los valores de configuración y nivel de coherencia predeterminados de la cuenta de Cosmos DB. | 'BoundedStaleness' 'ConsistentPrefix' 'Eventual' 'Sesión' 'Fuerte' (obligatorio) |
| maxIntervalInSeconds | Cuando se usa con el nivel de coherencia obsolescencia limitada, este valor representa la cantidad de tiempo de obsolescencia (en segundos) tolerada. El intervalo aceptado para este valor es 5 - 86400. Obligatorio cuando defaultConsistencyPolicy está establecido en "BoundedStaleness". | int Restricciones: Valor mínimo = 5 Valor máximo = 86400 |
| maxStalenessPrefix | Cuando se usa con el nivel de coherencia obsolescencia limitada, este valor representa el número de solicitudes obsoletas toleradas. El intervalo aceptado para este valor es de 1 - 2.147.483.647. Obligatorio cuando defaultConsistencyPolicy está establecido en "BoundedStaleness". | int Restricciones: Valor mínimo = 1 Valor máximo = 2147483647 |
CorsPolicy
| Nombre | Descripción | Valor |
|---|---|---|
| allowedHeaders | los encabezados de solicitud que el dominio de origen puede especificar en la solicitud de CORS. | string |
| allowedMethods | los métodos (verbos de solicitud HTTP) que el dominio de origen puede usar para una solicitud de CORS. | string |
| allowedOrigins | Los dominios de origen que pueden realizar una solicitud en el servicio a través de CORS. | string (obligatorio) |
| exposedHeaders | los encabezados de respuesta que se pueden enviar en la respuesta a la solicitud de CORS y que el explorador expone al emisor de la solicitud. | string |
| maxAgeInSeconds | el tiempo máximo que un explorador debe almacenar en la memoria caché la solicitud preparatoria OPTIONS. | int Restricciones: Valor mínimo = 1 Valor máximo = 2147483647 |
IpAddressOrRange
| Nombre | Descripción | Valor |
|---|---|---|
| ipAddressOrRange | Una sola dirección IPv4 o un único intervalo de direcciones IPv4 en formato CIDR. Las direcciones IP proporcionadas deben tener un formato correcto y no se pueden incluir en uno de los siguientes intervalos: 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0/16, ya que no son aplicables por el filtro de direcciones IP. Ejemplo de entradas válidas: "23.40.210.245" o "23.40.210.0/8". | string |
Location
| Nombre | Descripción | Valor |
|---|---|---|
| failoverPriority | Prioridad de conmutación por error de la región. Una prioridad de conmutación por error de 0 indica una región de escritura. Valor máximo de una prioridad de conmutación por error = (número total de regiones - 1). Los valores de prioridad de conmutación por error deben ser únicos para cada una de las regiones en las que existe la cuenta de base de datos. | int Restricciones: Valor mínimo = 0 |
| isZoneRedundant | Marca para indicar si esta región es o no una región AvailabilityZone | bool |
| locationName | El nombre de la región. | string |
VirtualNetworkRule
| Nombre | Descripción | Value |
|---|---|---|
| id | Identificador de recurso de una subred, por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. | string |
| ignoreMissingVNetServiceEndpoint | Cree una regla de firewall antes de que la red virtual tenga habilitado el punto de conexión de servicio de red virtual. | bool |
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
| Plantilla | Descripción |
|---|---|
CI/CD mediante Jenkins en Azure Container Service (AKS) |
Los contenedores facilitan la compilación e implementación continua de las aplicaciones. Mediante la orquestación de la implementación de esos contenedores mediante Kubernetes en Azure Container Service, puede lograr clústeres replicables y administrables de contenedores. Mediante la configuración de una compilación continua para producir las imágenes y la orquestación de contenedores, puede aumentar la velocidad y la confiabilidad de la implementación. |
| Aplicación web con una instancia de SQL Database, Azure Cosmos DB, Azure Search |
Esta plantilla aprovisiona una aplicación web, una instancia de SQL Database, Azure Cosmos DB, Azure Search y Application Insights. |
| Creación de una cuenta de Azure Cosmos DB para Cassandra API |
Esta plantilla crea una cuenta de Azure Cosmos DB para Cassandra API en dos regiones con un espacio de claves y una tabla con rendimiento dedicado. |
| Creación de una cuenta de Azure Cosmos DB de escalado automático para Cassandra API |
Esta plantilla crea una cuenta de Azure Cosmos DB para Cassandra API en dos regiones con un espacio de claves y una tabla con rendimiento de escalado automático. |
| Creación de una cuenta de Azure CosmosDB |
Esta plantilla de ARM está intención de crear una cuenta de CosmosDB rápidamente con los valores mínimos necesarios. |
| Creación de una cuenta de Azure Cosmos DB en varias regiones |
Esta plantilla crea una cuenta de Azure Cosmos DB para cualquier tipo de API de base de datos con una región primaria y secundaria que elija el nivel de coherencia y el tipo de conmutación por error. |
| Creación de una cuenta de Azure Cosmos DB de nivel gratis |
Esta plantilla crea una cuenta de Azure Cosmos DB de nivel gratuito para SQL API con una base de datos con rendimiento compartido y contenedor. |
| Creación de una cuenta de Azure Cosmos DB para Gremlin API |
Esta plantilla crea una cuenta de Azure Cosmos DB para Gremlin API en dos regiones con una base de datos y un grafo mediante el rendimiento dedicado. |
| Creación de una cuenta de Azure Cosmos DB para el escalado automático de Gremlin API |
Esta plantilla crea una cuenta de Azure Cosmos DB para Gremlin API en dos regiones con una base de datos y un grafo mediante el rendimiento de escalado automático. |
| Creación de una cuenta de Azure Cosmos para mongoDB API |
Esta plantilla crea una cuenta de Azure Cosmos DB para MongoDB API 4.2 en dos regiones mediante el rendimiento compartido y dedicado con dos colecciones. |
| Creación de una cuenta de Azure Cosmos para la escalabilidad automática de mongoDB API |
Esta plantilla crea una cuenta de Azure Cosmos DB para MongoDB API 4.2 en dos regiones mediante el rendimiento de escalado automático compartido y dedicado. |
| Creación de una cuenta de Azure Cosmos DB con un punto de conexión privado |
Esta plantilla creará una cuenta de Cosmos, una red virtual y un punto de conexión privado que exponga la cuenta de Cosmos a la red virtual. |
| Creación de una cuenta de Azure Cosmos DB para Core (SQL) API |
Esta plantilla crea una cuenta de Azure Cosmos para Core (SQL) API con una base de datos y un contenedor con rendimiento con varias otras opciones. |
| API de SQL de la cuenta de Azure Cosmos DB con almacén analítico |
Esta plantilla crea una cuenta de Azure Cosmos para Core (SQL) API con una base de datos y un contenedor configurados con almacén analítico. |
| Creación de una API de SQL de cuenta de Azure Cosmos DB con escalabilidad automática |
Esta plantilla crea una cuenta de Azure Cosmos para Core (SQL) API con una base de datos y un contenedor con rendimiento de escalabilidad automática con varias otras opciones. |
| Creación de procedimientos almacenados de la API de Azure Cosmos DB Core (SQL) |
Esta plantilla crea una cuenta de Azure Cosmos DB para Core (SQL) API y un contenedor con un procedimiento almacenado, un desencadenador y una función definida por el usuario. |
| Creación de una cuenta mínima de Azure Cosmos DB para Core (SQL) API |
Esta plantilla crea una cuenta de Azure Cosmos DB para core (SQL) API mientras solo se especifican las propiedades de recursos necesarias mínimas. |
| Creación de Azure Cosmos con SQL API y varios contenedores |
La plantilla crea un contenedor de Cosmos con una API de SQL y permite agregar contenedores de mulitple. |
| Creación de una cuenta sql de Azure Cosmos DB con RBAC del plano de datos |
Esta plantilla creará una cuenta de SQL Cosmos, una definición de rol mantenida de forma nativa y una asignación de roles mantenida de forma nativa para una identidad de AAD. |
| Creación de una cuenta de Azure Cosmos DB sin servidor para SQL API |
Esta plantilla crea una cuenta de Azure Cosmos DB sin servidor para core (SQL). |
| Creación de una cuenta de Azure Cosmos para Table API |
Esta plantilla crea una cuenta de Azure Cosmos DB para Table API en dos regiones y una sola tabla con rendimiento aprovisionado. |
| Creación de una cuenta de Azure Cosmos para Table API con escalabilidad automática |
Esta plantilla crea una cuenta de Azure Cosmos DB para Table API en dos regiones y una sola tabla con rendimiento de escalado automático. |
| Creación de una cuenta de Azure Cosmos táctil cero y una aplicación web de Azure |
Esta plantilla crea una cuenta de Azure Cosmos, inserta el punto de conexión y las claves de Cosmos DB en la configuración de Azure Web App y, a continuación, implementa una aplicación web asp MVC desde GitHub. |
| Creación de una cuenta de Cosmos DB con Microsoft Defender habilitado |
Con esta plantilla de ARM, puede implementar una cuenta de Azure Cosmos DB con Microsoft Defender para Azure Cosmos DB habilitado. Microsoft Defender para Azure Cosmos DB es una capa de seguridad nativa de Azure que detecta intentos de aprovechar una vulnerabilidad de seguridad de las bases de datos de las cuentas de Azure Cosmos DB. Microsoft Defender para Azure Cosmos DB detecta posibles inyecciones de SQL, actores malintencionados conocidos basados en inteligencia sobre amenazas de Microsoft, patrones de acceso sospechosos y posibles vulnerabilidades de la base de datos a través de identidades comprometidas o usuarios internos malintencionados. |
| Implementación de Azure Data Explorer DB con conexión de Cosmos DB |
Implemente Azure Data Explorer DB con la conexión de Cosmos DB. |
| Cuenta de Azure Cosmos DB con aplicación web |
Esta plantilla implementa una cuenta de Azure Cosmos DB, un plan de App Service y crea una aplicación web en el plan de App Service. También agrega dos configuraciones de aplicación a la aplicación web que hacen referencia al punto de conexión de la cuenta de Azure Cosmos DB. De esta manera, las soluciones implementadas en la aplicación web pueden conectarse al punto de conexión de la cuenta de Azure Cosmos DB mediante esa configuración. |
Definición de recursos de plantilla de ARM
El tipo de recurso databaseAccounts se puede implementar con operaciones destinadas a:
- Grupos de recursos: consulte los comandos de implementación del grupo de recursos.
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.DocumentDB/databaseAccounts, agregue el siguiente json a la plantilla.
{
"type": "Microsoft.DocumentDB/databaseAccounts",
"apiVersion": "2020-04-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"kind": "string",
"properties": {
"apiProperties": {
"serverVersion": "string"
},
"capabilities": [
{
"name": "string"
}
],
"connectorOffer": "Small",
"consistencyPolicy": {
"defaultConsistencyLevel": "string",
"maxIntervalInSeconds": "int",
"maxStalenessPrefix": "int"
},
"cors": [
{
"allowedHeaders": "string",
"allowedMethods": "string",
"allowedOrigins": "string",
"exposedHeaders": "string",
"maxAgeInSeconds": "int"
}
],
"databaseAccountOfferType": "Standard",
"disableKeyBasedMetadataWriteAccess": "bool",
"enableAnalyticalStorage": "bool",
"enableAutomaticFailover": "bool",
"enableCassandraConnector": "bool",
"enableFreeTier": "bool",
"enableMultipleWriteLocations": "bool",
"ipRules": [
{
"ipAddressOrRange": "string"
}
],
"isVirtualNetworkFilterEnabled": "bool",
"keyVaultKeyUri": "string",
"locations": [
{
"failoverPriority": "int",
"isZoneRedundant": "bool",
"locationName": "string"
}
],
"virtualNetworkRules": [
{
"id": "string",
"ignoreMissingVNetServiceEndpoint": "bool"
}
]
}
}
Valores de propiedad
databaseAccounts
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de recurso | 'Microsoft.DocumentDB/databaseAccounts' |
| apiVersion | La versión de la API de recursos | '2020-04-01' |
| name | El nombre del recurso | string (obligatorio) Límite de caracteres: 3-44 Caracteres válidos: Letras minúsculas, números y guiones. Comience con una letra minúscula o un número. El nombre del recurso debe ser único en Azure. |
| ubicación | Ubicación del grupo de recursos al que pertenece el recurso. | string |
| etiquetas | Las etiquetas son una lista de pares clave-valor que describen el recurso. Estas etiquetas pueden utilizarse para visualizar y agrupar este recurso a través de grupos de recursos. Se puede proporcionar un máximo de 15 etiquetas para un recurso. Cada etiqueta debe tener una clave no superior a 128 caracteres y un valor no superior a 256 caracteres. Por ejemplo, la experiencia predeterminada para un tipo de plantilla se establece con "defaultExperience": "Cassandra". Los valores actuales "defaultExperience" también incluyen "Table", "Graph", "DocumentDB" y "MongoDB". | Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas. |
| kind | Indica el tipo de cuenta de base de datos. Esto solo se puede establecer en la creación de la cuenta de base de datos. | 'GlobalDocumentDB' "MongoDB" 'Analizar' |
| properties | Propiedades para crear y actualizar cuentas de base de datos de Azure Cosmos DB. | DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (obligatorio) |
DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...
| Nombre | Descripción | Valor |
|---|---|---|
| apiProperties | Propiedades específicas de la API. Actualmente, solo se admite para la API de MongoDB. | ApiProperties |
| capabilities | Lista de funcionalidades de Cosmos DB para la cuenta | Funcionalidad[] |
| connectorOffer | Tipo de oferta del conector cassandra para la cuenta de C* de base de datos de Cosmos DB. | 'Pequeño' |
| consistencyPolicy | Directiva de coherencia de la cuenta de Cosmos DB. | ConsistencyPolicy |
| cors | Directiva de CORS para la cuenta de base de datos de Cosmos DB. | CorsPolicy[] |
| databaseAccountOfferType | Tipo de oferta de la base de datos | 'Standard' (obligatorio) |
| disableKeyBasedMetadataWriteAccess | Deshabilitación de operaciones de escritura en recursos de metadatos (bases de datos, contenedores, rendimiento) a través de claves de cuenta | bool |
| enableAnalyticalStorage | Marca para indicar si se va a habilitar el análisis de almacenamiento. | bool |
| enableAutomaticFailover | Habilita la conmutación automática por error de la región de escritura en el caso poco frecuente de que la región no esté disponible debido a una interrupción. La conmutación automática por error dará lugar a una nueva región de escritura para la cuenta y se elige en función de las prioridades de conmutación por error configuradas para la cuenta. | bool |
| enableCassandraConnector | Habilita el conector cassandra en la cuenta de C* de Cosmos DB. | bool |
| enableFreeTier | Marca para indicar si el nivel gratis está habilitado. | bool |
| enableMultipleWriteLocations | Permite que la cuenta escriba en varias ubicaciones. | bool |
| ipRules | Lista de IpRules. | IpAddressOrRange[] |
| isVirtualNetworkFilterEnabled | Marca para indicar si se deben habilitar o deshabilitar reglas de ACL de red virtual. | bool |
| keyVaultKeyUri | URI del almacén de claves | string |
| locations | Matriz que contiene las ubicaciones de georeplicación habilitadas para la cuenta de Cosmos DB. | Location[] (obligatorio) |
| virtualNetworkRules | Lista de reglas de ACL de red virtual configuradas para la cuenta de Cosmos DB. | VirtualNetworkRule[] |
ApiProperties
| Nombre | Descripción | Valor |
|---|---|---|
| serverVersion | Describe serverVersion de una cuenta de MongoDB. | '3.2' '3.6' |
Capacidad
| Nombre | Descripción | Value |
|---|---|---|
| name | Nombre de la funcionalidad de Cosmos DB. Por ejemplo, "name": "EnableCassandra". Los valores actuales también incluyen "EnableTable" y "EnableGremlin". | string |
ConsistencyPolicy
| Nombre | Descripción | Valor |
|---|---|---|
| defaultConsistencyLevel | Los valores de configuración y nivel de coherencia predeterminados de la cuenta de Cosmos DB. | 'BoundedStaleness' 'ConsistentPrefix' 'Eventual' 'Sesión' 'Fuerte' (obligatorio) |
| maxIntervalInSeconds | Cuando se usa con el nivel de coherencia obsolescencia limitada, este valor representa la cantidad de tiempo de obsolescencia (en segundos) tolerada. El intervalo aceptado para este valor es 5 - 86400. Obligatorio cuando defaultConsistencyPolicy está establecido en "BoundedStaleness". | int Restricciones: Valor mínimo = 5 Valor máximo = 86400 |
| maxStalenessPrefix | Cuando se usa con el nivel de coherencia obsolescencia limitada, este valor representa el número de solicitudes obsoletas toleradas. El intervalo aceptado para este valor es de 1 - 2.147.483.647. Obligatorio cuando defaultConsistencyPolicy está establecido en "BoundedStaleness". | int Restricciones: Valor mínimo = 1 Valor máximo = 2147483647 |
CorsPolicy
| Nombre | Descripción | Valor |
|---|---|---|
| allowedHeaders | los encabezados de solicitud que el dominio de origen puede especificar en la solicitud de CORS. | string |
| allowedMethods | los métodos (verbos de solicitud HTTP) que el dominio de origen puede usar para una solicitud de CORS. | string |
| allowedOrigins | Los dominios de origen que pueden realizar una solicitud en el servicio a través de CORS. | string (obligatorio) |
| exposedHeaders | los encabezados de respuesta que se pueden enviar en la respuesta a la solicitud de CORS y que el explorador expone al emisor de la solicitud. | string |
| maxAgeInSeconds | el tiempo máximo que un explorador debe almacenar en la memoria caché la solicitud preparatoria OPTIONS. | int Restricciones: Valor mínimo = 1 Valor máximo = 2147483647 |
IpAddressOrRange
| Nombre | Descripción | Valor |
|---|---|---|
| ipAddressOrRange | Una sola dirección IPv4 o un único intervalo de direcciones IPv4 en formato CIDR. Las direcciones IP proporcionadas deben tener un formato correcto y no se pueden incluir en uno de los siguientes intervalos: 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0/16, ya que no son aplicables por el filtro de direcciones IP. Ejemplo de entradas válidas: "23.40.210.245" o "23.40.210.0/8". | string |
Location
| Nombre | Descripción | Valor |
|---|---|---|
| failoverPriority | Prioridad de conmutación por error de la región. Una prioridad de conmutación por error de 0 indica una región de escritura. Valor máximo de una prioridad de conmutación por error = (número total de regiones - 1). Los valores de prioridad de conmutación por error deben ser únicos para cada una de las regiones en las que existe la cuenta de base de datos. | int Restricciones: Valor mínimo = 0 |
| isZoneRedundant | Marca para indicar si esta región es o no una región AvailabilityZone | bool |
| locationName | El nombre de la región. | string |
VirtualNetworkRule
| Nombre | Descripción | Value |
|---|---|---|
| id | Identificador de recurso de una subred, por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. | string |
| ignoreMissingVNetServiceEndpoint | Cree una regla de firewall antes de que la red virtual tenga habilitado el punto de conexión de servicio de red virtual. | bool |
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
| Plantilla | Descripción |
|---|---|
| CI/CD mediante Jenkins en Azure Container Service (AKS) |
Los contenedores facilitan la compilación e implementación continua de las aplicaciones. Mediante la orquestación de la implementación de esos contenedores mediante Kubernetes en Azure Container Service, puede lograr clústeres replicables y administrables de contenedores. Mediante la configuración de una compilación continua para producir las imágenes y la orquestación de contenedores, puede aumentar la velocidad y la confiabilidad de la implementación. |
| Aplicación web con una instancia de SQL Database, Azure Cosmos DB, Azure Search |
Esta plantilla aprovisiona una aplicación web, una instancia de SQL Database, Azure Cosmos DB, Azure Search y Application Insights. |
| Creación de una cuenta de Azure Cosmos DB para Cassandra API |
Esta plantilla crea una cuenta de Azure Cosmos DB para Cassandra API en dos regiones con un espacio de claves y una tabla con rendimiento dedicado. |
| Creación de una cuenta de Azure Cosmos DB de escalado automático para Cassandra API |
Esta plantilla crea una cuenta de Azure Cosmos DB para Cassandra API en dos regiones con un espacio de claves y una tabla con rendimiento de escalado automático. |
| Creación de una cuenta de Azure CosmosDB |
Esta plantilla de ARM está intención de crear una cuenta de CosmosDB rápidamente con los valores mínimos necesarios. |
| Creación de una cuenta de Azure Cosmos DB en varias regiones |
Esta plantilla crea una cuenta de Azure Cosmos DB para cualquier tipo de API de base de datos con una región primaria y secundaria que elija el nivel de coherencia y el tipo de conmutación por error. |
| Creación de una cuenta de Azure Cosmos DB de nivel gratis |
Esta plantilla crea una cuenta de Azure Cosmos DB de nivel gratuito para SQL API con una base de datos con rendimiento compartido y contenedor. |
| Creación de una cuenta de Azure Cosmos DB para Gremlin API |
Esta plantilla crea una cuenta de Azure Cosmos DB para Gremlin API en dos regiones con una base de datos y un grafo mediante el rendimiento dedicado. |
| Creación de una cuenta de Azure Cosmos DB para el escalado automático de Gremlin API |
Esta plantilla crea una cuenta de Azure Cosmos DB para Gremlin API en dos regiones con una base de datos y un grafo mediante el rendimiento de escalado automático. |
| Creación de una cuenta de Azure Cosmos para mongoDB API |
Esta plantilla crea una cuenta de Azure Cosmos DB para MongoDB API 4.2 en dos regiones mediante el rendimiento compartido y dedicado con dos colecciones. |
| Creación de una cuenta de Azure Cosmos para la escalabilidad automática de mongoDB API |
Esta plantilla crea una cuenta de Azure Cosmos DB para MongoDB API 4.2 en dos regiones mediante el rendimiento de escalado automático compartido y dedicado. |
| Creación de una cuenta de Azure Cosmos DB con un punto de conexión privado |
Esta plantilla creará una cuenta de Cosmos, una red virtual y un punto de conexión privado que exponga la cuenta de Cosmos a la red virtual. |
| Creación de una cuenta de Azure Cosmos DB para Core (SQL) API |
Esta plantilla crea una cuenta de Azure Cosmos para Core (SQL) API con una base de datos y un contenedor con rendimiento con varias otras opciones. |
| API de SQL de la cuenta de Azure Cosmos DB con almacén analítico |
Esta plantilla crea una cuenta de Azure Cosmos para Core (SQL) API con una base de datos y un contenedor configurados con almacén analítico. |
| Creación de una API de SQL de cuenta de Azure Cosmos DB con escalabilidad automática |
Esta plantilla crea una cuenta de Azure Cosmos para Core (SQL) API con una base de datos y un contenedor con rendimiento de escalabilidad automática con varias otras opciones. |
| Creación de procedimientos almacenados de la API de Azure Cosmos DB Core (SQL) |
Esta plantilla crea una cuenta de Azure Cosmos DB para Core (SQL) API y un contenedor con un procedimiento almacenado, un desencadenador y una función definida por el usuario. |
| Creación de una cuenta mínima de Azure Cosmos DB para Core (SQL) API |
Esta plantilla crea una cuenta de Azure Cosmos DB para core (SQL) API mientras solo se especifican las propiedades de recursos necesarias mínimas. |
| Creación de Azure Cosmos con SQL API y varios contenedores |
La plantilla crea un contenedor de Cosmos con una API de SQL y permite agregar contenedores de mulitple. |
| Creación de una cuenta sql de Azure Cosmos DB con RBAC del plano de datos |
Esta plantilla creará una cuenta de SQL Cosmos, una definición de rol mantenida de forma nativa y una asignación de roles mantenida de forma nativa para una identidad de AAD. |
| Creación de una cuenta de Azure Cosmos DB sin servidor para SQL API |
Esta plantilla crea una cuenta de Azure Cosmos DB sin servidor para core (SQL). |
| Creación de una cuenta de Azure Cosmos para Table API |
Esta plantilla crea una cuenta de Azure Cosmos DB para Table API en dos regiones y una sola tabla con rendimiento aprovisionado. |
| Creación de una cuenta de Azure Cosmos para Table API con escalabilidad automática |
Esta plantilla crea una cuenta de Azure Cosmos DB para Table API en dos regiones y una sola tabla con rendimiento de escalado automático. |
| Creación de una cuenta de Azure Cosmos táctil cero y una aplicación web de Azure |
Esta plantilla crea una cuenta de Azure Cosmos, inserta el punto de conexión y las claves de Cosmos DB en la configuración de Azure Web App y, a continuación, implementa una aplicación web asp MVC desde GitHub. |
| Creación de una cuenta de Cosmos DB con Microsoft Defender habilitado |
Con esta plantilla de ARM, puede implementar una cuenta de Azure Cosmos DB con Microsoft Defender para Azure Cosmos DB habilitado. Microsoft Defender para Azure Cosmos DB es una capa de seguridad nativa de Azure que detecta intentos de aprovechar una vulnerabilidad de seguridad de las bases de datos de las cuentas de Azure Cosmos DB. Microsoft Defender para Azure Cosmos DB detecta posibles inyecciones de SQL, actores malintencionados conocidos basados en inteligencia sobre amenazas de Microsoft, patrones de acceso sospechosos y posibles vulnerabilidades de la base de datos a través de identidades comprometidas o usuarios internos malintencionados. |
| Implementación de Azure Data Explorer DB con conexión de Cosmos DB |
Implemente Azure Data Explorer DB con la conexión de Cosmos DB. |
| Cuenta de Azure Cosmos DB con aplicación web |
Esta plantilla implementa una cuenta de Azure Cosmos DB, un plan de App Service y crea una aplicación web en el plan de App Service. También agrega dos configuraciones de aplicación a la aplicación web que hacen referencia al punto de conexión de la cuenta de Azure Cosmos DB. De esta manera, las soluciones implementadas en la aplicación web pueden conectarse al punto de conexión de la cuenta de Azure Cosmos DB mediante esa configuración. |
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso databaseAccounts se puede implementar con operaciones destinadas a:
- Grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.DocumentDB/databaseAccounts, agregue el siguiente terraform a la plantilla.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DocumentDB/databaseAccounts@2020-04-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
apiProperties = {
serverVersion = "string"
}
capabilities = [
{
name = "string"
}
]
connectorOffer = "Small"
consistencyPolicy = {
defaultConsistencyLevel = "string"
maxIntervalInSeconds = int
maxStalenessPrefix = int
}
cors = [
{
allowedHeaders = "string"
allowedMethods = "string"
allowedOrigins = "string"
exposedHeaders = "string"
maxAgeInSeconds = int
}
]
databaseAccountOfferType = "Standard"
disableKeyBasedMetadataWriteAccess = bool
enableAnalyticalStorage = bool
enableAutomaticFailover = bool
enableCassandraConnector = bool
enableFreeTier = bool
enableMultipleWriteLocations = bool
ipRules = [
{
ipAddressOrRange = "string"
}
]
isVirtualNetworkFilterEnabled = bool
keyVaultKeyUri = "string"
locations = [
{
failoverPriority = int
isZoneRedundant = bool
locationName = "string"
}
]
virtualNetworkRules = [
{
id = "string"
ignoreMissingVNetServiceEndpoint = bool
}
]
}
kind = "string"
})
}
Valores de propiedad
databaseAccounts
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de recurso | "Microsoft.DocumentDB/databaseAccounts@2020-04-01" |
| name | El nombre del recurso | string (obligatorio) Límite de caracteres: 3-44 Caracteres válidos: Letras minúsculas, números y guiones. Comience con una letra minúscula o un número. El nombre del recurso debe ser único en Azure. |
| ubicación | Ubicación del grupo de recursos al que pertenece el recurso. | string |
| parent_id | Para realizar la implementación en un grupo de recursos, use el identificador de ese grupo de recursos. | string (obligatorio) |
| etiquetas | Las etiquetas son una lista de pares clave-valor que describen el recurso. Estas etiquetas pueden utilizarse para visualizar y agrupar este recurso a través de grupos de recursos. Se puede proporcionar un máximo de 15 etiquetas para un recurso. Cada etiqueta debe tener una clave no superior a 128 caracteres y un valor no superior a 256 caracteres. Por ejemplo, la experiencia predeterminada para un tipo de plantilla se establece con "defaultExperience": "Cassandra". Los valores actuales "defaultExperience" también incluyen "Table", "Graph", "DocumentDB" y "MongoDB". | Diccionario de nombres y valores de etiqueta. |
| kind | Indica el tipo de cuenta de base de datos. Esto solo se puede establecer en la creación de la cuenta de base de datos. | "GlobalDocumentDB" "MongoDB" "Analizar" |
| properties | Propiedades para crear y actualizar cuentas de base de datos de Azure Cosmos DB. | DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (obligatorio) |
DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...
| Nombre | Descripción | Valor |
|---|---|---|
| apiProperties | Propiedades específicas de la API. Actualmente, solo se admite para la API de MongoDB. | ApiProperties |
| capabilities | Lista de funcionalidades de Cosmos DB para la cuenta | Funcionalidad[] |
| connectorOffer | Tipo de oferta del conector cassandra para la cuenta de C* de base de datos de Cosmos DB. | "Pequeño" |
| consistencyPolicy | Directiva de coherencia de la cuenta de Cosmos DB. | ConsistencyPolicy |
| cors | Directiva de CORS para la cuenta de base de datos de Cosmos DB. | CorsPolicy[] |
| databaseAccountOfferType | Tipo de oferta de la base de datos | "Estándar" (obligatorio) |
| disableKeyBasedMetadataWriteAccess | Deshabilitación de operaciones de escritura en recursos de metadatos (bases de datos, contenedores, rendimiento) a través de claves de cuenta | bool |
| enableAnalyticalStorage | Marca para indicar si se va a habilitar el análisis de almacenamiento. | bool |
| enableAutomaticFailover | Habilita la conmutación automática por error de la región de escritura en el caso poco frecuente de que la región no esté disponible debido a una interrupción. La conmutación automática por error dará lugar a una nueva región de escritura para la cuenta y se elige en función de las prioridades de conmutación por error configuradas para la cuenta. | bool |
| enableCassandraConnector | Habilita el conector cassandra en la cuenta de C* de Cosmos DB. | bool |
| enableFreeTier | Marca para indicar si el nivel gratis está habilitado. | bool |
| enableMultipleWriteLocations | Permite que la cuenta escriba en varias ubicaciones. | bool |
| ipRules | Lista de IpRules. | IpAddressOrRange[] |
| isVirtualNetworkFilterEnabled | Marca para indicar si se deben habilitar o deshabilitar reglas de ACL de red virtual. | bool |
| keyVaultKeyUri | URI del almacén de claves | string |
| locations | Matriz que contiene las ubicaciones de georeplicación habilitadas para la cuenta de Cosmos DB. | Location[] (obligatorio) |
| virtualNetworkRules | Lista de reglas de ACL de red virtual configuradas para la cuenta de Cosmos DB. | VirtualNetworkRule[] |
ApiProperties
| Nombre | Descripción | Valor |
|---|---|---|
| serverVersion | Describe serverVersion de una cuenta de MongoDB. | "3.2" "3.6" |
Capacidad
| Nombre | Descripción | Value |
|---|---|---|
| name | Nombre de la funcionalidad de Cosmos DB. Por ejemplo, "name": "EnableCassandra". Los valores actuales también incluyen "EnableTable" y "EnableGremlin". | string |
ConsistencyPolicy
| Nombre | Descripción | Valor |
|---|---|---|
| defaultConsistencyLevel | Los valores de configuración y nivel de coherencia predeterminados de la cuenta de Cosmos DB. | "BoundedStaleness" "ConsistentPrefix" "Eventual" "Sesión" "Fuerte" (obligatorio) |
| maxIntervalInSeconds | Cuando se usa con el nivel de coherencia obsolescencia limitada, este valor representa la cantidad de tiempo de obsolescencia (en segundos) tolerada. El intervalo aceptado para este valor es 5 - 86400. Obligatorio cuando defaultConsistencyPolicy está establecido en "BoundedStaleness". | int Restricciones: Valor mínimo = 5 Valor máximo = 86400 |
| maxStalenessPrefix | Cuando se usa con el nivel de coherencia obsolescencia limitada, este valor representa el número de solicitudes obsoletas toleradas. El intervalo aceptado para este valor es de 1 - 2.147.483.647. Obligatorio cuando defaultConsistencyPolicy está establecido en "BoundedStaleness". | int Restricciones: Valor mínimo = 1 Valor máximo = 2147483647 |
CorsPolicy
| Nombre | Descripción | Valor |
|---|---|---|
| allowedHeaders | los encabezados de solicitud que el dominio de origen puede especificar en la solicitud de CORS. | string |
| allowedMethods | los métodos (verbos de solicitud HTTP) que el dominio de origen puede usar para una solicitud de CORS. | string |
| allowedOrigins | Los dominios de origen que pueden realizar una solicitud en el servicio a través de CORS. | string (obligatorio) |
| exposedHeaders | los encabezados de respuesta que se pueden enviar en la respuesta a la solicitud de CORS y que el explorador expone al emisor de la solicitud. | string |
| maxAgeInSeconds | el tiempo máximo que un explorador debe almacenar en la memoria caché la solicitud preparatoria OPTIONS. | int Restricciones: Valor mínimo = 1 Valor máximo = 2147483647 |
IpAddressOrRange
| Nombre | Descripción | Valor |
|---|---|---|
| ipAddressOrRange | Una sola dirección IPv4 o un único intervalo de direcciones IPv4 en formato CIDR. Las direcciones IP proporcionadas deben tener un formato correcto y no se pueden incluir en uno de los siguientes intervalos: 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0/16, ya que no son aplicables por el filtro de direcciones IP. Ejemplo de entradas válidas: "23.40.210.245" o "23.40.210.0/8". | string |
Location
| Nombre | Descripción | Valor |
|---|---|---|
| failoverPriority | Prioridad de conmutación por error de la región. Una prioridad de conmutación por error de 0 indica una región de escritura. Valor máximo de una prioridad de conmutación por error = (número total de regiones - 1). Los valores de prioridad de conmutación por error deben ser únicos para cada una de las regiones en las que existe la cuenta de base de datos. | int Restricciones: Valor mínimo = 0 |
| isZoneRedundant | Marca para indicar si esta región es una región availabilityZone o no | bool |
| locationName | El nombre de la región. | string |
VirtualNetworkRule
| Nombre | Descripción | Value |
|---|---|---|
| id | Identificador de recurso de una subred, por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. | string |
| ignoreMissingVNetServiceEndpoint | Cree una regla de firewall antes de que la red virtual tenga habilitado el punto de conexión de servicio de red virtual. | bool |