Compartilhar via

Banco de dados Microsoft.DocumentDBContas 2020-09-01

  • Artigo

Definição de recurso do Bicep

O tipo de recurso databaseAccounts pode ser implantado com operações direcionadas:

Para obter uma lista das propriedades alteradas em cada versão da API, consulte log de alterações.

Formato de recurso

Para criar um recurso Microsoft.DocumentDB/databaseAccounts, adicione o Bicep a seguir ao modelo.

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts@2020-09-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  kind: 'string'
  properties: {
    apiProperties: {
      serverVersion: 'string'
    }
    backupPolicy: {
      type: 'string'
      // For remaining properties, see BackupPolicy objects
    }
    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
      }
    ]
  }
}

Objetos BackupPolicy

Defina a propriedade type para especificar o tipo de objeto.

Para Contínuo, use:

  type: 'Continuous'

Para Periodic, use:

  type: 'Periodic'
  periodicModeProperties: {
    backupIntervalInMinutes: int
    backupRetentionIntervalInHours: int
  }

Valores de propriedade

databaseAccounts

Name Descrição Valor
name O nome do recurso cadeia de caracteres (obrigatório)

Limite de caracteres: 3 a 44

Caracteres válidos:
Letras minúsculas, números e hifens.

Comece com letra minúscula ou número.

O nome do recurso deve ser exclusivo no Azure.
local O local do grupo de recursos ao qual o recurso pertence. string
marcas As marcas são uma lista de pares chave-valor que descrevem o recurso. Essas marcas podem ser usadas para exibir e agrupar esse recurso (entre grupos de recursos). Um máximo de 15 marcas pode ser fornecido para um recurso. Cada marca deve ter uma chave com no máximo 128 caracteres e um valor com no máximo 256 caracteres. Por exemplo, a experiência padrão para um tipo de modelo é definida com "defaultExperience": "Cassandra". Os valores atuais de "defaultExperience" também incluem "Table", "Graph", "DocumentDB" e "MongoDB". Dicionário de nomes e valores de marcas. Confira Marcas em modelos
kind Indica o tipo de conta de banco de dados. Isso só pode ser definido na criação da conta de banco de dados. 'GlobalDocumentDB'
'MongoDB'
'Analisar'
properties Propriedades para criar e atualizar contas de banco de dados do Azure Cosmos DB. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (obrigatório)

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...

Name Descrição Valor
apiProperties Propriedades específicas da API. Atualmente, há suporte apenas para a API do MongoDB. ApiProperties
backupPolicy O objeto que representa a política para fazer backups em uma conta. BackupPolicy
funcionalidades Lista de recursos do Cosmos DB para a conta Funcionalidade[]
connectorOffer O tipo de oferta do conector do Cassandra para a conta C* do banco de dados do Cosmos DB. 'Pequeno'
consistencyPolicy A política de consistência para a conta do Cosmos DB. ConsistencyPolicy
cors A política CORS para a conta de banco de dados do Cosmos DB. CorsPolicy[]
databaseAccountOfferType O tipo de oferta para o banco de dados 'Standard' (obrigatório)
disableKeyBasedMetadataWriteAccess Desabilitar operações de gravação em recursos de metadados (bancos de dados, contêineres, taxa de transferência) por meio de chaves de conta bool
enableAnalyticalStorage Sinalizador para indicar se deseja habilitar a análise de armazenamento. bool
enableAutomaticFailover Habilita o failover automático da região de gravação no evento raro em que a região está indisponível devido a uma interrupção. O failover automático resultará em uma nova região de gravação para a conta e será escolhido com base nas prioridades de failover configuradas para a conta. bool
enableCassandraConnector Habilita o conector do Cassandra na conta C* do Cosmos DB bool
enableFreeTier Sinalizador para indicar se a Camada Gratuita está habilitada. bool
enableMultipleWriteLocations Permite que a conta escreva em vários locais bool
ipRules Lista de IpRules. IpAddressOrRange[]
isVirtualNetworkFilterEnabled Sinalizador para indicar se as regras de ACL da Rede Virtual devem ser habilitadas/desabilitadas. bool
keyVaultKeyUri O URI do cofre de chaves string
Locais Uma matriz que contém os locais de georeplicação habilitados para a conta do Cosmos DB. Localização[] (obrigatório)
virtualNetworkRules Lista de regras de ACL de Rede Virtual configuradas para a conta do Cosmos DB. VirtualNetworkRule[]

ApiProperties

Name Descrição Valor
Versão do servidor Descreve o ServerVersion de uma conta do MongoDB. '3.2'
'3.6'

BackupPolicy

Name Descrição Valor
tipo Definir o tipo de objeto Contínuo
Periódico (obrigatório)

ContinuousModeBackupPolicy

Name Descrição Valor
tipo Descreve o modo de backups. 'Contínuo' (obrigatório)

PeriodicModeBackupPolicy

Name Descrição Valor
tipo Descreve o modo de backups. 'Periodic' (obrigatório)
periodicModeProperties Valores de configuração para backup de modo periódico PeriodicModeProperties

PeriodicModeProperties

Name Descrição Valor
backupIntervalInMinutes Um inteiro que representa o intervalo em minutos entre dois backups INT

Restrições:
Valor mínimo = 0
backupRetentionIntervalInHours Um inteiro que representa o tempo (em horas) em que cada backup é retido INT

Restrições:
Valor mínimo = 0

Funcionalidade

Name Descrição Valor
name Nome da funcionalidade do Cosmos DB. Por exemplo, "name": "EnableCassandra". Os valores atuais também incluem "EnableTable" e "EnableGremlin". string

ConsistencyPolicy

Name Descrição Valor
defaultConsistencyLevel O nível de consistência padrão e as definições de configuração da conta do Cosmos DB. 'BoundedStaleness'
'ConsistentPrefix'
'Eventual'
'Sessão'
'Strong' (obrigatório)
maxIntervalInSeconds Quando usado com o nível de consistência Desatualização Limitada, esse valor representa a quantidade de tempo de desatualização (em segundos) tolerada. O intervalo aceito para esse valor é de 5 a 86400. Obrigatório quando defaultConsistencyPolicy é definido como 'BoundedStaleness'. INT

Restrições:
Valor mínimo = 5
Valor máximo = 86400
maxStalenessPrefix Quando usado com o nível de consistência Desatualização Limitada, esse valor representa o número de solicitações obsoletas toleradas. O intervalo aceito para este valor é de 1 a 2,147,483,647. Obrigatório quando defaultConsistencyPolicy é definido como 'BoundedStaleness'. INT

Restrições:
Valor mínimo = 1
Valor máximo = 2147483647

CorsPolicy

Name Descrição Valor
allowedHeaders Os cabeçalhos de solicitação que o domínio de origem pode especificar na solicitação de CORS. string
allowedMethods Os métodos (verbos de solicitação HTTP) que podem usar o domínio de origem para uma solicitação CORS. string
allowedOrigins Os domínios de origem que têm permissão para fazer uma solicitação no serviço por meio do CORS. cadeia de caracteres (obrigatório)
exposedHeaders Os cabeçalhos de resposta que podem ser enviados em resposta à solicitação de CORS e expostos pelo navegador para o emissor da solicitação. string
maxAgeInSeconds A quantidade máxima de tempo pela qual um navegador deve armazenar em cache a solicitação OPTIONS de simulação. INT

Restrições:
Valor mínimo = 1
Valor máximo = 2147483647

IpAddressOrRange

Name Descrição Valor
ipAddressOrRange Um único endereço IPv4 ou um único intervalo de endereços IPv4 no formato CIDR. Os IPs fornecidos devem estar bem formatados e não podem estar contidos em um dos seguintes intervalos: 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0/16, pois eles não são aplicáveis pelo filtro de endereço IP. Exemplo de entradas válidas: "23.40.210.245" ou "23.40.210.0/8". string

Localização

Nome Descrição Valor
failoverPriority A prioridade de failover da região. Uma prioridade de failover de 0 indica uma região de gravação. O valor máximo para uma prioridade de failover = (número total de regiões – 1). Os valores de prioridade de failover devem ser exclusivos para cada uma das regiões em que a conta de banco de dados existe. INT

Restrições:
Valor mínimo = 0
isZoneRedundant Sinalizador para indicar se essa região é ou não uma região availabilityZone bool
locationName O nome da região. string

VirtualNetworkRule

Name Descrição Valor
id ID de recurso de uma sub-rede, por exemplo: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. string
ignoreMissingVNetServiceEndpoint Crie uma regra de firewall antes que a rede virtual tenha o ponto de extremidade de serviço de vnet habilitado. bool

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
CI/CD usando Jenkins no AKS (Serviço de Contêiner do Azure)

Implantar no Azure		 Os contêineres facilitam muito a criação e a implantação contínua de seus aplicativos. Ao orquestrar a implantação desses contêineres usando o Kubernetes no Serviço de Contêiner do Azure, você pode obter clusters replicáveis e gerenciáveis de contêineres. Ao configurar um build contínuo para produzir suas imagens de contêiner e orquestração, você pode aumentar a velocidade e a confiabilidade da implantação.
Aplicativo Web com um Banco de Dados SQL, Azure Cosmos DB, Azure Search

Implantar no Azure		 Esse modelo provisiona um Aplicativo Web, um Banco de Dados SQL, o Azure Cosmos DB, o Azure Search e o Application Insights.
Criar uma conta do Azure Cosmos DB para a API do Cassandra

Implantar no Azure		 Este modelo cria uma conta do Azure Cosmos DB para a API do Cassandra em duas regiões com um keyspace e uma tabela com taxa de transferência dedicada.
Criar uma conta de dimensionamento automático do Azure Cosmos DB para a API do Cassandra

Implantar no Azure		 Este modelo cria uma conta do Azure Cosmos DB para a API do Cassandra em duas regiões com um keyspace e uma tabela com taxa de transferência de dimensionamento automático.
Criar uma conta do Azure CosmosDB

Implantar no Azure		 Este modelo do ARM tem a intenção de criar uma conta do CosmosDB rapidamente com os valores mínimos necessários
Criar uma conta do Azure Cosmos DB em várias regiões

Implantar no Azure		 Este modelo cria uma conta do Azure Cosmos DB para qualquer tipo de API de banco de dados com uma região primária e secundária com a opção de nível de consistência e tipo de failover.
Criar uma conta de camada gratuita do Azure Cosmos DB

Implantar no Azure		 Este modelo cria uma conta de camada gratuita do Azure Cosmos DB para a API do SQL com um banco de dados com taxa de transferência compartilhada e contêiner.
Criar uma conta do Azure Cosmos DB para a API do Gremlin

Implantar no Azure		 Este modelo cria uma conta do Azure Cosmos DB para a API do Gremlin em duas regiões com um banco de dados e um grafo usando a taxa de transferência dedicada.
Criar uma conta do Azure Cosmos DB para dimensionamento automático da API do Gremlin

Implantar no Azure		 Esse modelo cria uma conta do Azure Cosmos DB para a API do Gremlin em duas regiões com um banco de dados e um grafo usando a taxa de transferência de dimensionamento automático.
Criar uma conta do Azure Cosmos para a API do MongoDB

Implantar no Azure		 Este modelo cria uma conta do Azure Cosmos DB para a API 4.2 do MongoDB em duas regiões usando a taxa de transferência compartilhada e dedicada com duas coleções.
Criar uma conta do Azure Cosmos para dimensionamento automático da API do MongoDB

Implantar no Azure		 Este modelo cria uma conta do Azure Cosmos DB para a API 4.2 do MongoDB em duas regiões usando a taxa de transferência de dimensionamento automático compartilhada e dedicada.
Criar uma conta do Azure Cosmos DB com um ponto de extremidade privado

Implantar no Azure		 Esse modelo criará uma conta do Cosmos, uma rede virtual e um ponto de extremidade privado expondo a conta do Cosmos à rede virtual.
Criar uma conta do Azure Cosmos DB para a API do Core (SQL)

Implantar no Azure		 Esse modelo cria uma conta do Azure Cosmos para a API do Core (SQL) com um banco de dados e um contêiner com taxa de transferência com várias outras opções.
API do SQL da conta do Azure Cosmos DB com repositório analítico

Implantar no Azure		 Esse modelo cria uma conta do Azure Cosmos para a API do Core (SQL) com um banco de dados e um contêiner configurados com o repositório analítico.
Criar uma API de SQL da conta do Azure Cosmos DB com dimensionamento automático

Implantar no Azure		 Esse modelo cria uma conta do Azure Cosmos para a API core (SQL) com um banco de dados e um contêiner com taxa de transferência de dimensionamento automático com várias outras opções.
Criar procedimentos armazenados da API do Azure Cosmos DB Core (SQL)

Implantar no Azure		 Esse modelo cria uma conta do Azure Cosmos DB para a API do Core (SQL) e um contêiner com um procedimento armazenado, um gatilho e uma função definida pelo usuário.
Criar uma conta mínima do Azure Cosmos DB para a API do Core (SQL)

Implantar no Azure		 Esse modelo cria uma conta do Azure Cosmos DB para a API Core (SQL) enquanto especifica apenas as propriedades mínimas de recurso necessárias.
Criar o Azure Cosmos com a API do SQL e vários contêineres

Implantar no Azure		 O modelo cria um contêiner do Cosmos com uma API do SQL e permite adicionar contêineres mulitple.
Criar uma conta SQL do Azure Cosmos DB com o RBAC do plano de dados

Implantar no Azure		 Este modelo criará uma conta do SQL Cosmos, uma definição de função mantida nativamente e uma atribuição de função mantida nativamente para uma identidade do AAD.
Criar uma conta do Azure Cosmos DB sem servidor para a API do SQL

Implantar no Azure		 Este modelo cria uma conta do Azure Cosmos DB sem servidor para a API Core (SQL).
Criar uma conta do Azure Cosmos para a API de Tabela

Implantar no Azure		 Esse modelo cria uma conta do Azure Cosmos DB para a API de Tabela em duas regiões e uma única tabela com taxa de transferência provisionada.
Criar uma conta do Azure Cosmos para a API de Tabela com dimensionamento automático

Implantar no Azure		 Esse modelo cria uma conta do Azure Cosmos DB para a API de Tabela em duas regiões e uma única tabela com taxa de transferência de dimensionamento automático.
Criar uma conta do Azure Cosmos com toque zero e um Aplicativo Web do Azure

Implantar no Azure		 Esse modelo cria uma conta do Azure Cosmos, injeta o ponto de extremidade e as chaves do Cosmos DB nas configurações do Aplicativo Web do Azure e implanta um aplicativo Web ASP MVC do GitHub.
Criar uma conta do Cosmos DB com o Microsoft Defender habilitado

Implantar no Azure		 Usando esse modelo do ARM, você pode implantar uma conta do Azure Cosmos DB com o Microsoft Defender para Azure Cosmos DB habilitado. O Microsoft Defender para Azure Cosmos DB é uma camada de segurança nativa do Azure que detecta qualquer tentativa de explorar bancos de dados nas suas contas do Azure Cosmos DB. O Microsoft Defender para Azure Cosmos DB detecta possíveis injeções de SQL, atores mal-intencionados conhecidos com base na Inteligência contra Ameaças da Microsoft, padrões de acesso suspeitos e possíveis explorações do banco de dados por meio de identidades comprometidas ou pessoas mal-intencionadas.
Implantar o BD do Azure Data Explorer com a conexão do Cosmos DB

Implantar no Azure		 Implantar o BD do Azure Data Explorer com a conexão do Cosmos DB.
Conta do Azure Cosmos DB com Aplicativo Web

Implantar no Azure		 Este modelo implanta uma conta do Azure Cosmos DB, um Plano do Serviço de Aplicativo e cria um aplicativo Web no Plano do Serviço de Aplicativo. Ele também adiciona duas configurações de aplicativo ao aplicativo Web que fazem referência ao ponto de extremidade da conta do Azure Cosmos DB. Dessa forma, as soluções implantadas no aplicativo Web podem se conectar ao ponto de extremidade da conta do Azure Cosmos DB usando essas configurações.

Definição de recurso de modelo do ARM

O tipo de recurso databaseAccounts pode ser implantado com operações direcionadas:

Para obter uma lista das propriedades alteradas em cada versão da API, consulte log de alterações.

Formato de recurso

Para criar um recurso Microsoft.DocumentDB/databaseAccounts, adicione o JSON a seguir ao modelo.

{
  "type": "Microsoft.DocumentDB/databaseAccounts",
  "apiVersion": "2020-09-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "kind": "string",
  "properties": {
    "apiProperties": {
      "serverVersion": "string"
    },
    "backupPolicy": {
      "type": "string"
      // For remaining properties, see BackupPolicy objects
    },
    "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"
      }
    ]
  }
}

Objetos BackupPolicy

Defina a propriedade type para especificar o tipo de objeto.

Para Contínuo, use:

  "type": "Continuous"

Para Periodic, use:

  "type": "Periodic",
  "periodicModeProperties": {
    "backupIntervalInMinutes": "int",
    "backupRetentionIntervalInHours": "int"
  }

Valores de propriedade

databaseAccounts

Name Descrição Valor
tipo O tipo de recurso 'Microsoft.DocumentDB/databaseAccounts'
apiVersion A versão da API do recurso '2020-09-01'
name O nome do recurso cadeia de caracteres (obrigatório)

Limite de caracteres: 3 a 44

Caracteres válidos:
Letras minúsculas, números e hifens.

Comece com letra minúscula ou número.

O nome do recurso deve ser exclusivo no Azure.
local O local do grupo de recursos ao qual o recurso pertence. string
marcas As marcas são uma lista de pares chave-valor que descrevem o recurso. Essas marcas podem ser usadas para exibir e agrupar esse recurso (entre grupos de recursos). No máximo 15 marcas podem ser fornecidas para um recurso. Cada marca deve ter uma chave com no máximo 128 caracteres e um valor com no máximo 256 caracteres. Por exemplo, a experiência padrão para um tipo de modelo é definida com "defaultExperience": "Cassandra". Os valores atuais de "defaultExperience" também incluem "Table", "Graph", "DocumentDB" e "MongoDB". Dicionário de nomes e valores de marcas. Consulte Marcas em modelos
kind Indica o tipo de conta de banco de dados. Isso só pode ser definido na criação da conta de banco de dados. 'GlobalDocumentDB'
'MongoDB'
'Analisar'
properties Propriedades para criar e atualizar contas de banco de dados do Azure Cosmos DB. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (obrigatório)

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...

Name Descrição Valor
apiProperties Propriedades específicas da API. Atualmente, há suporte apenas para a API do MongoDB. ApiProperties
backupPolicy O objeto que representa a política para fazer backups em uma conta. BackupPolicy
funcionalidades Lista de recursos do Cosmos DB para a conta Funcionalidade[]
connectorOffer O tipo de oferta do conector do Cassandra para a conta C* do banco de dados do Cosmos DB. 'Pequeno'
consistencyPolicy A política de consistência para a conta do Cosmos DB. ConsistencyPolicy
cors A política CORS para a conta de banco de dados do Cosmos DB. CorsPolicy[]
databaseAccountOfferType O tipo de oferta para o banco de dados 'Standard' (obrigatório)
disableKeyBasedMetadataWriteAccess Desabilitar operações de gravação em recursos de metadados (bancos de dados, contêineres, taxa de transferência) por meio de chaves de conta bool
enableAnalyticalStorage Sinalizador para indicar se deseja habilitar a análise de armazenamento. bool
enableAutomaticFailover Habilita o failover automático da região de gravação no evento raro em que a região está indisponível devido a uma interrupção. O failover automático resultará em uma nova região de gravação para a conta e será escolhido com base nas prioridades de failover configuradas para a conta. bool
enableCassandraConnector Habilita o conector do Cassandra na conta C* do Cosmos DB bool
enableFreeTier Sinalizador para indicar se a Camada Gratuita está habilitada. bool
enableMultipleWriteLocations Permite que a conta escreva em vários locais bool
ipRules Lista de IpRules. IpAddressOrRange[]
isVirtualNetworkFilterEnabled Sinalizador para indicar se as regras de ACL da Rede Virtual devem ser habilitadas/desabilitadas. bool
keyVaultKeyUri O URI do cofre de chaves string
Locais Uma matriz que contém os locais de georeplicação habilitados para a conta do Cosmos DB. Localização[] (obrigatório)
virtualNetworkRules Lista de regras de ACL de Rede Virtual configuradas para a conta do Cosmos DB. VirtualNetworkRule[]

ApiProperties

Name Descrição Valor
Versão do servidor Descreve o ServerVersion de uma conta do MongoDB. '3.2'
'3.6'

BackupPolicy

Name Descrição Valor
tipo Definir o tipo de objeto Contínuo
Periódico (obrigatório)

ContinuousModeBackupPolicy

Name Descrição Valor
tipo Descreve o modo de backups. 'Contínuo' (obrigatório)

PeriodicModeBackupPolicy

Name Descrição Valor
tipo Descreve o modo de backups. 'Periodic' (obrigatório)
periodicModeProperties Valores de configuração para backup de modo periódico PeriodicModeProperties

PeriodicModeProperties

Name Descrição Valor
backupIntervalInMinutes Um inteiro que representa o intervalo em minutos entre dois backups INT

Restrições:
Valor mínimo = 0
backupRetentionIntervalInHours Um inteiro que representa o tempo (em horas) em que cada backup é retido INT

Restrições:
Valor mínimo = 0

Funcionalidade

Name Descrição Valor
name Nome da funcionalidade do Cosmos DB. Por exemplo, "name": "EnableCassandra". Os valores atuais também incluem "EnableTable" e "EnableGremlin". string

ConsistencyPolicy

Name Descrição Valor
defaultConsistencyLevel O nível de consistência padrão e as configurações da conta do Cosmos DB. 'BoundedStaleness'
'ConsistentPrefix'
'Eventual'
'Session'
'Strong' (obrigatório)
maxIntervalInSeconds Quando usado com o nível de consistência Desatualização Limitada, esse valor representa a quantidade de tempo de desatualização (em segundos) tolerada. O intervalo aceito para esse valor é de 5 a 86400. Obrigatório quando defaultConsistencyPolicy é definido como 'BoundedStaleness'. INT

Restrições:
Valor mínimo = 5
Valor máximo = 86400
maxStalenessPrefix Quando usado com o nível de consistência Desatualização Limitada, esse valor representa o número de solicitações obsoletas toleradas. O intervalo aceito para este valor é de 1 a 2,147,483,647. Obrigatório quando defaultConsistencyPolicy é definido como 'BoundedStaleness'. INT

Restrições:
Valor mínimo = 1
Valor máximo = 2147483647

CorsPolicy

Name Descrição Valor
allowedHeaders Os cabeçalhos de solicitação que o domínio de origem pode especificar na solicitação de CORS. string
allowedMethods Os métodos (verbos de solicitação HTTP) que podem usar o domínio de origem para uma solicitação CORS. string
allowedOrigins Os domínios de origem que têm permissão para fazer uma solicitação no serviço por meio do CORS. cadeia de caracteres (obrigatório)
exposedHeaders Os cabeçalhos de resposta que podem ser enviados em resposta à solicitação de CORS e expostos pelo navegador para o emissor da solicitação. string
maxAgeInSeconds A quantidade máxima de tempo pela qual um navegador deve armazenar em cache a solicitação OPTIONS de simulação. INT

Restrições:
Valor mínimo = 1
Valor máximo = 2147483647

IpAddressOrRange

Name Descrição Valor
ipAddressOrRange Um único endereço IPv4 ou um único intervalo de endereços IPv4 no formato CIDR. Os IPs fornecidos devem ser bem formatados e não podem ser contidos em um dos seguintes intervalos: 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0/16, pois eles não são aplicáveis pelo filtro de endereço IP. Exemplo de entradas válidas: "23.40.210.245" ou "23.40.210.0/8". string

Localização

Nome Descrição Valor
failoverPriority A prioridade de failover da região. Uma prioridade de failover de 0 indica uma região de gravação. O valor máximo para uma prioridade de failover = (número total de regiões – 1). Os valores de prioridade de failover devem ser exclusivos para cada uma das regiões nas quais a conta de banco de dados existe. INT

Restrições:
Valor mínimo = 0
isZoneRedundant Sinalizador para indicar se essa região é ou não uma região availabilityZone bool
locationName O nome da região. string

VirtualNetworkRule

Name Descrição Valor
id ID de recurso de uma sub-rede, por exemplo: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. string
ignoreMissingVNetServiceEndpoint Crie uma regra de firewall antes que a rede virtual tenha o ponto de extremidade de serviço de vnet habilitado. bool

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
CI/CD usando Jenkins no AKS (Serviço de Contêiner do Azure)

Implantar no Azure		 Os contêineres facilitam a criação e a implantação contínua de seus aplicativos. Ao orquestrar a implantação desses contêineres usando o Kubernetes no Serviço de Contêiner do Azure, você pode obter clusters de contêineres replicáveis e gerenciáveis. Ao configurar um build contínuo para produzir suas imagens de contêiner e orquestração, você pode aumentar a velocidade e a confiabilidade de sua implantação.
Aplicativo Web com um Banco de Dados SQL, Azure Cosmos DB, Azure Search

Implantar no Azure		 Esse modelo provisiona um Aplicativo Web, um Banco de Dados SQL, o Azure Cosmos DB, o Azure Search e o Application Insights.
Criar uma conta do Azure Cosmos DB para a API do Cassandra

Implantar no Azure		 Este modelo cria uma conta do Azure Cosmos DB para a API do Cassandra em duas regiões com um keyspace e uma tabela com taxa de transferência dedicada.
Criar conta do Azure Cosmos DB de dimensionamento automático para a API do Cassandra

Implantar no Azure		 Este modelo cria uma conta do Azure Cosmos DB para a API do Cassandra em duas regiões com um keyspace e uma tabela com taxa de transferência de dimensionamento automático.
Criar uma conta do Azure CosmosDB

Implantar no Azure		 Este modelo do ARM tem a intenção de criar uma conta do CosmosDB rapidamente com os valores mínimos necessários
Criar uma conta do Azure Cosmos DB em várias regiões

Implantar no Azure		 Este modelo cria uma conta do Azure Cosmos DB para qualquer tipo de API de banco de dados com uma região primária e secundária com escolha de nível de consistência e tipo de failover.
Criar uma conta de camada gratuita do Azure Cosmos DB

Implantar no Azure		 Este modelo cria uma conta do Azure Cosmos DB de camada livre para a API do SQL com um banco de dados com taxa de transferência compartilhada e contêiner.
Criar uma conta do Azure Cosmos DB para a API do Gremlin

Implantar no Azure		 Este modelo cria uma conta do Azure Cosmos DB para a API do Gremlin em duas regiões com um banco de dados e um grafo usando taxa de transferência dedicada.
Criar uma conta do Azure Cosmos DB para dimensionamento automático da API do Gremlin

Implantar no Azure		 Este modelo cria uma conta do Azure Cosmos DB para a API do Gremlin em duas regiões com um banco de dados e um grafo usando a taxa de transferência de dimensionamento automático.
Criar uma conta do Azure Cosmos para a API do MongoDB

Implantar no Azure		 Este modelo cria uma conta do Azure Cosmos DB para a API 4.2 do MongoDB em duas regiões usando taxa de transferência compartilhada e dedicada com duas coleções.
Criar uma conta do Azure Cosmos para dimensionamento automático da API do MongoDB

Implantar no Azure		 Este modelo cria uma conta do Azure Cosmos DB para a API 4.2 do MongoDB em duas regiões usando a taxa de transferência de dimensionamento automático compartilhada e dedicada.
Criar uma conta do Azure Cosmos DB com um ponto de extremidade privado

Implantar no Azure		 Esse modelo criará uma conta do Cosmos, uma rede virtual e um ponto de extremidade privado expondo a conta do Cosmos à rede virtual.
Criar uma conta do Azure Cosmos DB para a API do Core (SQL)

Implantar no Azure		 Esse modelo cria uma conta do Azure Cosmos para a API do Core (SQL) com um banco de dados e um contêiner com taxa de transferência com várias outras opções.
API do SQL da conta do Azure Cosmos DB com repositório analítico

Implantar no Azure		 Esse modelo cria uma conta do Azure Cosmos para a API do Core (SQL) com um banco de dados e um contêiner configurados com o repositório analítico.
Criar uma API de SQL de conta do Azure Cosmos DB com dimensionamento automático

Implantar no Azure		 Este modelo cria uma API de conta do Azure Cosmos para Core (SQL) com um banco de dados e um contêiner com taxa de transferência de dimensionamento automático com várias outras opções.
Criar procedimentos armazenados da API do SQL (Azure Cosmos DB Core)

Implantar no Azure		 Este modelo cria uma conta do Azure Cosmos DB para a API do Core (SQL) e um contêiner com um procedimento armazenado, gatilho e função definida pelo usuário.
Criar uma conta mínima do Azure Cosmos DB para a API do Core (SQL)

Implantar no Azure		 Esse modelo cria uma conta do Azure Cosmos DB para a API Core (SQL), especificando apenas as propriedades mínimas de recurso necessárias.
Criar o Azure Cosmos com a API do SQL e vários contêineres

Implantar no Azure		 O modelo cria um contêiner do Cosmos com uma API do SQL e permite adicionar contêineres mulitple.
Criar uma conta SQL do Azure Cosmos DB com o RBAC do plano de dados

Implantar no Azure		 Este modelo criará uma conta do SQL Cosmos, uma definição de função mantida nativamente e uma atribuição de função mantida nativamente para uma identidade do AAD.
Criar uma conta do Azure Cosmos DB sem servidor para a API do SQL

Implantar no Azure		 Este modelo cria uma conta do Azure Cosmos DB sem servidor para a API Core (SQL).
Criar uma conta do Azure Cosmos para a API de Tabela

Implantar no Azure		 Este modelo cria uma conta do Azure Cosmos DB para a API de Tabela em duas regiões e uma única tabela com taxa de transferência provisionada.
Criar uma conta do Azure Cosmos para a API de Tabela com dimensionamento automático

Implantar no Azure		 Esse modelo cria uma conta do Azure Cosmos DB para a API de Tabela em duas regiões e uma única tabela com taxa de transferência de dimensionamento automático.
Criar uma conta do Azure Cosmos com toque zero e um Aplicativo Web do Azure

Implantar no Azure		 Esse modelo cria uma conta do Azure Cosmos, injeta o ponto de extremidade e as chaves do Cosmos DB nas configurações do Aplicativo Web do Azure e implanta um aplicativo Web ASP MVC do GitHub.
Criar uma conta do Cosmos DB com o Microsoft Defender habilitado

Implantar no Azure		 Usando esse modelo do ARM, você pode implantar uma conta do Azure Cosmos DB com o Microsoft Defender para Azure Cosmos DB habilitado. O Microsoft Defender para Azure Cosmos DB é uma camada de segurança nativa do Azure que detecta qualquer tentativa de explorar bancos de dados nas suas contas do Azure Cosmos DB. O Microsoft Defender para Azure Cosmos DB detecta possíveis injeções de SQL, atores mal-intencionados conhecidos com base na Inteligência contra Ameaças da Microsoft, padrões de acesso suspeitos e possíveis explorações do banco de dados por meio de identidades comprometidas ou pessoas mal-intencionadas.
Implantar o BD do Azure Data Explorer com a conexão do Cosmos DB

Implantar no Azure		 Implantar o BD do Azure Data Explorer com a conexão do Cosmos DB.
Conta do Azure Cosmos DB com Aplicativo Web

Implantar no Azure		 Este modelo implanta uma conta do Azure Cosmos DB, um Plano do Serviço de Aplicativo e cria um aplicativo Web no Plano do Serviço de Aplicativo. Ele também adiciona duas configurações de aplicativo ao aplicativo Web que fazem referência ao ponto de extremidade da conta do Azure Cosmos DB. Dessa forma, as soluções implantadas no aplicativo Web podem se conectar ao ponto de extremidade da conta do Azure Cosmos DB usando essas configurações.

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso databaseAccounts pode ser implantado com operações direcionadas:

  • Grupos de recursos

Para obter uma lista das propriedades alteradas em cada versão da API, consulte log de alterações.

Formato de recurso

Para criar um recurso Microsoft.DocumentDB/databaseAccounts, adicione o Terraform a seguir ao modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/databaseAccounts@2020-09-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      apiProperties = {
        serverVersion = "string"
      }
      backupPolicy = {
        type = "string"
        // For remaining properties, see BackupPolicy objects
      }
      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"
  })
}

Objetos BackupPolicy

Defina a propriedade type para especificar o tipo de objeto.

Para Contínuo, use:

  type = "Continuous"

Para Periodic, use:

  type = "Periodic"
  periodicModeProperties = {
    backupIntervalInMinutes = int
    backupRetentionIntervalInHours = int
  }

Valores de propriedade

databaseAccounts

Name Descrição Valor
tipo O tipo de recurso "Microsoft.DocumentDB/databaseAccounts@2020-09-01"
name O nome do recurso cadeia de caracteres (obrigatório)

Limite de caracteres: 3 a 44

Caracteres válidos:
Letras minúsculas, números e hifens.

Comece com letra minúscula ou número.

O nome do recurso deve ser exclusivo no Azure.
local O local do grupo de recursos ao qual o recurso pertence. string
parent_id Para implantar em um grupo de recursos, use a ID desse grupo de recursos. cadeia de caracteres (obrigatório)
marcas As marcas são uma lista de pares chave-valor que descrevem o recurso. Essas marcas podem ser usadas para exibir e agrupar esse recurso (entre grupos de recursos). Um máximo de 15 marcas pode ser fornecido para um recurso. Cada marca deve ter uma chave com no máximo 128 caracteres e um valor com no máximo 256 caracteres. Por exemplo, a experiência padrão para um tipo de modelo é definida com "defaultExperience": "Cassandra". Os valores atuais de "defaultExperience" também incluem "Table", "Graph", "DocumentDB" e "MongoDB". Dicionário de nomes e valores de marcas.
kind Indica o tipo de conta de banco de dados. Isso só pode ser definido na criação da conta de banco de dados. "GlobalDocumentDB"
"MongoDB"
"Analisar"
properties Propriedades para criar e atualizar contas de banco de dados do Azure Cosmos DB. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (obrigatório)

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...

Name Descrição Valor
apiProperties Propriedades específicas da API. Atualmente, há suporte apenas para a API do MongoDB. ApiProperties
backupPolicy O objeto que representa a política para fazer backups em uma conta. BackupPolicy
funcionalidades Lista de recursos do Cosmos DB para a conta Capability[]
connectorOffer O tipo de oferta do conector do Cassandra para a conta C* do banco de dados do Cosmos DB. "Pequeno"
consistencyPolicy A política de consistência para a conta do Cosmos DB. ConsistencyPolicy
cors A política cors para a conta de banco de dados do Cosmos DB. CorsPolicy[]
databaseAccountOfferType O tipo de oferta para o banco de dados "Standard" (obrigatório)
disableKeyBasedMetadataWriteAccess Desabilitar operações de gravação em recursos de metadados (bancos de dados, contêineres, taxa de transferência) por meio de chaves de conta bool
enableAnalyticalStorage Sinalizador para indicar se a análise de armazenamento deve ser habilitada. bool
enableAutomaticFailover Habilita o failover automático da região de gravação no evento raro em que a região está indisponível devido a uma interrupção. O failover automático resultará em uma nova região de gravação para a conta e será escolhido com base nas prioridades de failover configuradas para a conta. bool
enableCassandraConnector Habilita o conector do Cassandra na conta C* do Cosmos DB bool
enableFreeTier Sinalizador para indicar se a Camada Gratuita está habilitada. bool
enableMultipleWriteLocations Permite que a conta escreva em vários locais bool
ipRules Lista de IpRules. IpAddressOrRange[]
isVirtualNetworkFilterEnabled Sinalizador para indicar se as regras de ACL da Rede Virtual devem ser habilitadas/desabilitadas. bool
keyVaultKeyUri O URI do cofre de chaves string
Locais Uma matriz que contém os locais de georeplicação habilitados para a conta do Cosmos DB. Localização[] (obrigatório)
virtualNetworkRules Lista de regras de ACL de Rede Virtual configuradas para a conta do Cosmos DB. VirtualNetworkRule[]

ApiProperties

Name Descrição Valor
Versão do servidor Descreve o ServerVersion de uma conta do MongoDB. "3.2"
"3.6"

BackupPolicy

Name Descrição Valor
tipo Definir o tipo de objeto Contínuo
Periódico (obrigatório)

ContinuousModeBackupPolicy

Name Descrição Valor
tipo Descreve o modo de backups. "Contínuo" (obrigatório)

PeriodicModeBackupPolicy

Name Descrição Valor
tipo Descreve o modo de backups. "Periódico" (obrigatório)
periodicModeProperties Valores de configuração para backup de modo periódico PeriodicModeProperties

PeriodicModeProperties

Name Descrição Valor
backupIntervalInMinutes Um inteiro que representa o intervalo em minutos entre dois backups INT

Restrições:
Valor mínimo = 0
backupRetentionIntervalInHours Um inteiro que representa o tempo (em horas) em que cada backup é retido INT

Restrições:
Valor mínimo = 0

Funcionalidade

Name Descrição Valor
name Nome da funcionalidade do Cosmos DB. Por exemplo, "name": "EnableCassandra". Os valores atuais também incluem "EnableTable" e "EnableGremlin". string

ConsistencyPolicy

Name Descrição Valor
defaultConsistencyLevel O nível de consistência padrão e as configurações da conta do Cosmos DB. "BoundedStaleness"
"ConsistentPrefix"
"Eventual"
"Sessão"
"Forte" (obrigatório)
maxIntervalInSeconds Quando usado com o nível de consistência Desatualização Limitada, esse valor representa a quantidade de tempo de desatualização (em segundos) tolerada. O intervalo aceito para esse valor é de 5 a 86400. Obrigatório quando defaultConsistencyPolicy é definido como 'BoundedStaleness'. INT

Restrições:
Valor mínimo = 5
Valor máximo = 86400
maxStalenessPrefix Quando usado com o nível de consistência Desatualização Limitada, esse valor representa o número de solicitações obsoletas toleradas. O intervalo aceito para este valor é de 1 a 2,147,483,647. Obrigatório quando defaultConsistencyPolicy é definido como 'BoundedStaleness'. INT

Restrições:
Valor mínimo = 1
Valor máximo = 2147483647

CorsPolicy

Name Descrição Valor
allowedHeaders Os cabeçalhos de solicitação que o domínio de origem pode especificar na solicitação de CORS. string
allowedMethods Os métodos (verbos de solicitação HTTP) que podem usar o domínio de origem para uma solicitação CORS. string
allowedOrigins Os domínios de origem que têm permissão para fazer uma solicitação no serviço por meio do CORS. cadeia de caracteres (obrigatório)
exposedHeaders Os cabeçalhos de resposta que podem ser enviados em resposta à solicitação de CORS e expostos pelo navegador para o emissor da solicitação. string
maxAgeInSeconds A quantidade máxima de tempo pela qual um navegador deve armazenar em cache a solicitação OPTIONS de simulação. INT

Restrições:
Valor mínimo = 1
Valor máximo = 2147483647

IpAddressOrRange

Name Descrição Valor
ipAddressOrRange Um único endereço IPv4 ou um único intervalo de endereços IPv4 no formato CIDR. Os IPs fornecidos devem ser bem formatados e não podem ser contidos em um dos seguintes intervalos: 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0/16, pois eles não são aplicáveis pelo filtro de endereço IP. Exemplo de entradas válidas: "23.40.210.245" ou "23.40.210.0/8". string

Localização

Nome Descrição Valor
failoverPriority A prioridade de failover da região. Uma prioridade de failover de 0 indica uma região de gravação. O valor máximo para uma prioridade de failover = (número total de regiões – 1). Os valores de prioridade de failover devem ser exclusivos para cada uma das regiões nas quais a conta de banco de dados existe. INT

Restrições:
Valor mínimo = 0
isZoneRedundant Sinalizador para indicar se essa região é ou não uma região availabilityZone bool
locationName O nome da região. string

VirtualNetworkRule

Name Descrição Valor
id ID de recurso de uma sub-rede, por exemplo: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. string
ignoreMissingVNetServiceEndpoint Crie uma regra de firewall antes que a rede virtual tenha o ponto de extremidade de serviço de vnet habilitado. bool