Поделиться через


База данных Microsoft.DocumentDBУчетные записи 2021-01-15

Определение ресурса Bicep

Тип ресурса databaseAccounts можно развернуть с помощью операций, предназначенных для:

Список измененных свойств в каждой версии API см. в журнале изменений.

Формат ресурсов

Чтобы создать ресурс Microsoft.DocumentDB/databaseAccounts, добавьте в шаблон следующий код Bicep.

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts@2021-01-15' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  kind: 'string'
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  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'
      }
    ]
    networkAclBypass: 'string'
    networkAclBypassResourceIds: [
      'string'
    ]
    publicNetworkAccess: 'string'
    virtualNetworkRules: [
      {
        id: 'string'
        ignoreMissingVNetServiceEndpoint: bool
      }
    ]
  }
}

Объекты BackupPolicy

Задайте свойство type , чтобы указать тип объекта .

Для непрерывного использования используйте:

  type: 'Continuous'

В параметре Periodic используйте:

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

Значения свойств

databaseAccounts

Имя Описание Значение
name имя ресурса. строка (обязательно)

Ограничение символов: 3–44

Допустимые символы:
Строчные буквы, цифры и дефисы.

Начинается со строчной буквы или цифры.

Имя ресурса должно быть уникальным в Azure.
location Расположение группы ресурсов, к которой принадлежит ресурс. строка
tags Теги — это список пар "ключ-значение", описывающих ресурс. Эти теги можно использовать при просмотре и группировании ресурсов (между группами). Для ресурса можно указать не более 15 тегов. В каждом теге длина ключа нее должна превышать 128 символов, а длина значения — 256 символов. Например, для типа шаблона по умолчанию задано значение defaultExperience: Cassandra. Текущие значения defaultExperience также включают "Table", "Graph", "DocumentDB" и "MongoDB". Словарь имен и значений тегов. См . раздел Теги в шаблонах
kind Указывает тип учетной записи базы данных. Это можно задать только при создании учетной записи базы данных. GlobalDocumentDB
MongoDB
"Синтаксический анализ"
удостоверение Удостоверение ресурса. Управляемое удостоверение службы
properties Свойства для создания и обновления учетных записей базы данных Azure Cosmos DB. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (обязательно)

Управляемое удостоверение службы

Имя Описание Значение
тип Тип удостоверения, используемого для ресурса. Тип SystemAssigned,UserAssigned включает как неявно созданное удостоверение, так и набор удостоверений, назначаемых пользователем. Тип None удалит все удостоверения из службы. "Нет"
SystemAssigned
"SystemAssigned,UserAssigned"
UserAssigned
userAssignedIdentities Список удостоверений пользователей, связанных с ресурсом. Ссылки на ключ словаря удостоверений пользователей будут иметь идентификаторы ресурсов ARM в формате "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Имя Описание Значение
{настроенное свойство} Components1Jq1T4ISchemasManagedserviceidentityProper...

Components1Jq1T4ISchemasManagedserviceidentityProper...

Этот объект не содержит свойств, которые необходимо задать во время развертывания. Все свойства доступны только для чтения.

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...

Имя Описание Значение
apiProperties Свойства API. В настоящее время поддерживается только для API MongoDB. ApiProperties
backupPolicy Объект , представляющий политику для создания резервных копий в учетной записи. BackupPolicy
capabilities Список возможностей Cosmos DB для учетной записи Возможность[]
connectorOffer Тип предложения соединителя cassandra для учетной записи C* базы данных Cosmos DB. "Маленький"
consistencyPolicy Политика согласованности для учетной записи Cosmos DB. ConsistencyPolicy
cors Политика CORS для учетной записи базы данных Cosmos DB. CorsPolicy[]
databaseAccountOfferType Тип предложения для базы данных "Стандартный" (обязательно)
disableKeyBasedMetadataWriteAccess Отключение операций записи для ресурсов метаданных (базы данных, контейнеры, пропускная способность) с помощью ключей учетной записи bool
enableAnalyticalStorage Флаг, указывающий, следует ли включить аналитику хранилища. bool
enableAutomaticFailover Включает автоматическую отработку отказа региона записи в редких случаях, когда регион становится недоступным из-за сбоя. Автоматическая отработка отказа приведет к созданию нового региона записи для учетной записи и выбирается на основе приоритетов отработки отказа, настроенных для учетной записи. bool
enableCassandraConnector Включает соединитель cassandra в учетной записи C* Cosmos DB bool
enableFreeTier Флаг, указывающий, включен ли уровень "Бесплатный". bool
enableMultipleWriteLocations Позволяет учетной записи выполнять запись в нескольких расположениях. bool
ipRules Список IpRules. IpAddressOrRange[]
isVirtualNetworkFilterEnabled Флаг, указывающий, следует ли включать или отключать правила ACL для виртуальной сети. bool
keyVaultKeyUri Универсальный код ресурса (URI) хранилища ключей строка
Расположения Массив, содержащий расположения георепликации, включенные для учетной записи Cosmos DB. Location[] (обязательно)
networkAclBypass Указывает, каким службам разрешено обходить проверки брандмауэра. AzureServices
"Нет"
networkAclBypassResourceIds Массив, содержащий идентификаторы ресурсов для обхода сетевого списка управления доступом для учетной записи Cosmos DB. string[]
publicNetworkAccess Разрешены ли запросы из общедоступной сети "Отключено"
"Включено"
virtualNetworkRules Список правил ACL виртуальной сети, настроенных для учетной записи Cosmos DB. VirtualNetworkRule[]

ApiProperties

Имя Описание Значение
serverVersion Описывает serverVersion учетной записи MongoDB. '3.2'
'3.6'
'4.0'

BackupPolicy

Имя Описание Значение
тип Установка типа объекта Непрерывные
Периодическая (обязательно)

ContinuousModeBackupPolicy

Имя Описание Значение
тип Описывает режим резервного копирования. Continuous (обязательный)

PeriodicModeBackupPolicy

Имя Описание Значение
тип Описывает режим резервного копирования. "Periodic" (обязательно)
periodicModeProperties Значения конфигурации для резервного копирования в периодическом режиме PeriodicModeProperties

PeriodicModeProperties

Имя Описание Значение
backupIntervalInMinutes Целое число, представляющее интервал между двумя резервными копиями в минутах. INT

Ограничения:
Минимальное значение = 0
backupRetentionIntervalInHours Целое число, представляющее время (в часах) хранения каждой резервной копии. INT

Ограничения:
Минимальное значение = 0

Функция

Имя Описание Значение
name Имя возможности Cosmos DB. Например, "name": "EnableCassandra". Текущие значения также включают "EnableTable" и "EnableGremlin". строка

ConsistencyPolicy

Имя Описание Значение
defaultConsistencyLevel Уровень согласованности по умолчанию и параметры конфигурации учетной записи Cosmos DB. 'BoundedStaleness'
"ConsistentPrefix"
"В конечном счете"
"Сеанс"
Strong (обязательный)
maxIntervalInSeconds При использовании с уровнем согласованности Ограниченное устаревание это значение представляет допустимое время устаревание (в секундах). Допустимый диапазон для этого значения — от 5 до 86400. Требуется, если defaultConsistencyPolicy имеет значение BoundedStaleness. INT

Ограничения:
Минимальное значение = 5
Максимальное значение = 86400
maxStalenessPrefix При использовании с уровнем согласованности Ограниченное устаревание это значение представляет допустимое количество устаревших запросов. Допустимый диапазон — 1–2 147 483 647. Требуется, если defaultConsistencyPolicy имеет значение BoundedStaleness. INT

Ограничения:
Минимальное значение = 1
Максимальное значение = 2147483647

CorsPolicy

Имя Описание Значение
allowedHeaders Заголовки запросов, которые исходный домен может указывать в запросах CORS. строка
allowedMethods Методы (команды HTTP-запросов), которые может использовать исходный домен для выполнения запроса CORS. строка
allowedOrigins Домены источника, которым разрешено выполнять запрос к службе через CORS. строка (обязательно)
exposedHeaders Заголовки ответов, которые можете отправить в ответ на запрос CORS и предоставить отправителю запроса с помощью браузера. строка
maxAgeInSeconds Максимальная продолжительность хранения предварительных запросов OPTIONS в кэше браузера. INT

Ограничения:
Минимальное значение = 1
Максимальное значение = 2147483647

IpAddressOrRange

Имя Описание Значение
ipAddressOrRange Один IPv4-адрес или один диапазон IPv4-адресов в формате CIDR. Предоставленные IP-адреса должны быть хорошо отформатированы и не могут содержаться в одном из следующих диапазонов: 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0/16, так как они не применяются фильтром IP-адресов. Пример допустимых входных данных: "23.40.210.245" или "23.40.210.0/8". строка

Расположение

Имя Описание Значение
failoverPriority Приоритет отработки отказа региона. Приоритет отработки отказа 0 указывает регион записи. Максимальное значение приоритета отработки отказа = (общее число регионов — 1). Значения приоритета отработки отказа должны быть уникальными для каждого из регионов, в которых существует учетная запись базы данных. INT

Ограничения:
Минимальное значение = 0
isZoneRedundant Флаг, указывающий, является ли этот регион регионом AvailabilityZone bool
locationName Имя области. строка

VirtualNetworkRule

Имя Описание Значение
идентификатор Идентификатор ресурса подсети, например: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. строка
ignoreMissingVNetServiceEndpoint Создайте правило брандмауэра до включения конечной точки службы виртуальной сети. bool

Шаблоны быстрого запуска

Следующие шаблоны быстрого запуска развертывают этот тип ресурса.

Шаблон Описание
CI/CD с использованием Jenkins в Службе контейнеров Azure (AKS)

Развертывание в Azure
Контейнеры упрощают непрерывное создание и развертывание приложений. Управляя развертыванием этих контейнеров с помощью Kubernetes в Службе контейнеров Azure, вы можете получить реплицируемые управляемые кластеры контейнеров. Настроив непрерывную сборку для создания образов контейнеров и оркестрации, можно повысить скорость и надежность развертывания.
Веб-приложение с базой данных SQL, Azure Cosmos DB, поиском Azure

Развертывание в Azure
Этот шаблон подготавливает веб-приложение, Базу данных SQL, Azure Cosmos DB, Поиск Azure и Application Insights.
Создание учетной записи Azure Cosmos DB для API Cassandra

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для API Cassandra в двух регионах с пространством ключей и таблицей с выделенной пропускной способностью.
Создание учетной записи azure Cosmos DB с автомасштабированием для API Cassandra

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для API Cassandra в двух регионах с пространством ключей и таблицей с автомасштабируемой пропускной способностью.
Создание учетной записи Azure CosmosDB

Развертывание в Azure
Этот шаблон ARM предназначен для быстрого создания учетной записи CosmosDB с минимальными необходимыми значениями.
Создание учетной записи Azure Cosmos DB в нескольких регионах

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для любого типа API базы данных с основным и дополнительным регионами с выбором уровня согласованности и типа отработки отказа.
Создание учетной записи Azure Cosmos DB бесплатного уровня

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB бесплатного уровня для API SQL с базой данных с общей пропускной способностью и контейнером.
Создание учетной записи Azure Cosmos DB для API Gremlin

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для API Gremlin в двух регионах с одной базой данных и одним графом с использованием выделенной пропускной способности.
Создание учетной записи Azure Cosmos DB для автомасштабирования API Gremlin

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для API Gremlin в двух регионах с одной базой данных и одним графом с использованием автомасштабирования пропускной способности.
Создание учетной записи Azure Cosmos для API MongoDB

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для API MongoDB 4.2 в двух регионах с использованием общей и выделенной пропускной способности с двумя коллекциями.
Создание учетной записи Azure Cosmos для автомасштабирования API MongoDB

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для API MongoDB 4.2 в двух регионах с использованием общей и выделенной автомасштабируемой пропускной способности.
Создание учетной записи Azure Cosmos DB с частной конечной точкой

Развертывание в Azure
Этот шаблон создаст учетную запись Cosmos, виртуальную сеть и частную конечную точку, чтобы предоставить учетную запись Cosmos виртуальной сети.
Создание учетной записи Azure Cosmos DB для API Core (SQL)

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos для API Core (SQL) с базой данных и контейнером с пропускной способностью с несколькими другими вариантами.
API SQL учетной записи Azure Cosmos DB с аналитическим хранилищем

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos для API Core (SQL) с базой данных и контейнером, настроенными с аналитическим хранилищем.
Создание API SQL учетной записи Azure Cosmos DB с автомасштабированием

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos для API Core (SQL) с базой данных и контейнером с автомасштабированием пропускной способности с несколькими другими вариантами.
Создание хранимых процедур API Azure Cosmos DB Core (SQL)

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для API Core (SQL) и контейнер с хранимой процедурой, триггером и определяемой пользователем функцией.
Создание минимальной учетной записи Azure Cosmos DB для API Core (SQL)

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для API Core (SQL) с указанием только минимальных обязательных свойств ресурса.
Создание Azure Cosmos с ПОМОЩЬЮ API SQL и нескольких контейнеров

Развертывание в Azure
Шаблон создает контейнер Cosmos с API SQL и позволяет добавлять контейнеры многообразия.
Создание учетной записи SQL Azure Cosmos DB с RBAC плоскости данных

Развертывание в Azure
Этот шаблон создает учетную запись SQL Cosmos DB, встроенное определение роли и встроенное назначение роли для удостоверения Azure Active Directory.
Создание бессерверной учетной записи Azure Cosmos DB для API SQL

Развертывание в Azure
Этот шаблон создает бессерверную учетную запись Azure Cosmos DB для API Core (SQL).
Создание учетной записи Azure Cosmos для API таблиц

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для API таблиц в двух регионах и одну таблицу с подготовленной пропускной способностью.
Создание учетной записи Azure Cosmos для API таблиц с автомасштабированием

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для API таблиц в двух регионах и одну таблицу с автомасштабируемой пропускной способностью.
Создание учетной записи Azure Cosmos без касания и веб-приложения Azure

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos, внедряет конечную точку Cosmos DB и ключи в параметры веб-приложения Azure, а затем развертывает веб-приложение ASP MVC из GitHub.
Создание учетной записи Cosmos DB с включенным Microsoft Defender

Развертывание в Azure
С помощью этого шаблона ARM можно развернуть учетную запись Azure Cosmos DB с включенным Microsoft Defender для Azure Cosmos DB. Microsoft Defender для Azure Cosmos DB — это собственный уровень безопасности Azure, который обнаруживает все попытки использования баз данных в учетных записях Azure Cosmos DB. Microsoft Defender для Azure Cosmos DB обнаруживает потенциальные внедрения кода SQL, известные злоумышленники на основе Microsoft Threat Intelligence, подозрительные шаблоны доступа и потенциальные эксплуатации базы данных с помощью скомпрометированных удостоверений или злоумышленников.
Развертывание Azure Data Explorer DB с подключением к Cosmos DB

Развертывание в Azure
Развертывание Azure Data Explorer DB с подключением к Cosmos DB.
Учетная запись Azure Cosmos DB с веб-приложением

Развертывание в Azure
Этот шаблон развертывает учетную запись Azure Cosmos DB, план службы приложений и создает веб-приложение в плане службы приложений. Он также добавляет два параметра приложения в веб-приложение, которые ссылаться на конечную точку учетной записи Azure Cosmos DB. Таким образом, решения, развернутые в веб-приложении, могут подключаться к конечной точке учетной записи Azure Cosmos DB с помощью этих параметров.

Определение ресурса шаблона ARM

Тип ресурса databaseAccounts можно развернуть с помощью операций, предназначенных для:

Список измененных свойств в каждой версии API см. в журнале изменений.

Формат ресурсов

Чтобы создать ресурс Microsoft.DocumentDB/databaseAccounts, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.DocumentDB/databaseAccounts",
  "apiVersion": "2021-01-15",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "kind": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "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"
      }
    ],
    "networkAclBypass": "string",
    "networkAclBypassResourceIds": [ "string" ],
    "publicNetworkAccess": "string",
    "virtualNetworkRules": [
      {
        "id": "string",
        "ignoreMissingVNetServiceEndpoint": "bool"
      }
    ]
  }
}

Объекты BackupPolicy

Задайте свойство type , чтобы указать тип объекта .

Для непрерывного использования используйте:

  "type": "Continuous"

В параметре Periodic используйте:

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

Значения свойств

databaseAccounts

Имя Описание Значение
тип Тип ресурса Microsoft.DocumentDB/databaseAccounts
версия_API Версия API ресурсов '2021-01-15'
name имя ресурса. строка (обязательно)

Ограничение символов: 3–44

Допустимые символы:
Строчные буквы, цифры и дефисы.

Начинается со строчной буквы или цифры.

Имя ресурса должно быть уникальным в Azure.
location Расположение группы ресурсов, к которой принадлежит ресурс. строка
tags Теги — это список пар "ключ-значение", описывающих ресурс. Эти теги можно использовать при просмотре и группировании ресурсов (между группами). Для ресурса можно указать не более 15 тегов. В каждом теге длина ключа нее должна превышать 128 символов, а длина значения — 256 символов. Например, для типа шаблона по умолчанию задано значение defaultExperience: Cassandra. Текущие значения defaultExperience также включают "Table", "Graph", "DocumentDB" и "MongoDB". Словарь имен и значений тегов. См . раздел Теги в шаблонах
kind Указывает тип учетной записи базы данных. Это можно задать только при создании учетной записи базы данных. GlobalDocumentDB
MongoDB
"Синтаксический анализ"
удостоверение Удостоверение ресурса. Управляемое удостоверение службы
properties Свойства для создания и обновления учетных записей базы данных Azure Cosmos DB. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (обязательно)

Управляемое удостоверение службы

Имя Описание Значение
тип Тип удостоверения, используемого для ресурса. Тип SystemAssigned,UserAssigned включает как неявно созданное удостоверение, так и набор удостоверений, назначаемых пользователем. Тип None удалит все удостоверения из службы. "Нет"
SystemAssigned
"SystemAssigned,UserAssigned"
UserAssigned
userAssignedIdentities Список удостоверений пользователей, связанных с ресурсом. Ссылки на ключ словаря удостоверений пользователей будут иметь идентификаторы ресурсов ARM в формате "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Имя Описание Значение
{настроенное свойство} Components1Jq1T4ISchemasManagedserviceidentityProper...

Components1Jq1T4ISchemasManagedserviceidentityProper...

Этот объект не содержит свойств, которые необходимо задать во время развертывания. Все свойства доступны только для чтения.

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...

Имя Описание Значение
apiProperties Свойства API. В настоящее время поддерживается только для API MongoDB. ApiProperties
backupPolicy Объект , представляющий политику для создания резервных копий в учетной записи. BackupPolicy
capabilities Список возможностей Cosmos DB для учетной записи Возможность[]
connectorOffer Тип предложения соединителя cassandra для учетной записи C* базы данных Cosmos DB. "Маленький"
consistencyPolicy Политика согласованности для учетной записи Cosmos DB. ConsistencyPolicy
cors Политика CORS для учетной записи базы данных Cosmos DB. CorsPolicy[]
databaseAccountOfferType Тип предложения для базы данных "Стандартный" (обязательно)
disableKeyBasedMetadataWriteAccess Отключение операций записи для ресурсов метаданных (базы данных, контейнеры, пропускная способность) с помощью ключей учетной записи bool
enableAnalyticalStorage Флаг, указывающий, следует ли включить аналитику хранилища. bool
enableAutomaticFailover Включает автоматическую отработку отказа региона записи в редких случаях, когда регион становится недоступным из-за сбоя. Автоматическая отработка отказа приведет к созданию нового региона записи для учетной записи и выбирается на основе приоритетов отработки отказа, настроенных для учетной записи. bool
enableCassandraConnector Включает соединитель cassandra в учетной записи C* Cosmos DB bool
enableFreeTier Флаг, указывающий, включен ли уровень "Бесплатный". bool
enableMultipleWriteLocations Позволяет учетной записи выполнять запись в нескольких расположениях. bool
ipRules Список IpRules. IpAddressOrRange[]
isVirtualNetworkFilterEnabled Флаг, указывающий, следует ли включать или отключать правила ACL для виртуальной сети. bool
keyVaultKeyUri Универсальный код ресурса (URI) хранилища ключей строка
Расположения Массив, содержащий расположения георепликации, включенные для учетной записи Cosmos DB. Location[] (обязательно)
networkAclBypass Указывает, каким службам разрешено обходить проверки брандмауэра. AzureServices
"Нет"
networkAclBypassResourceIds Массив, содержащий идентификаторы ресурсов для обхода сетевого списка управления доступом для учетной записи Cosmos DB. string[]
publicNetworkAccess Разрешены ли запросы из общедоступной сети "Отключено"
"Включено"
virtualNetworkRules Список правил ACL виртуальной сети, настроенных для учетной записи Cosmos DB. VirtualNetworkRule[]

ApiProperties

Имя Описание Значение
serverVersion Описывает serverVersion учетной записи MongoDB. '3.2'
'3.6'
'4.0'

BackupPolicy

Имя Описание Значение
тип Установка типа объекта Непрерывные
Периодическая (обязательно)

ContinuousModeBackupPolicy

Имя Описание Значение
тип Описывает режим резервного копирования. Continuous (обязательный)

PeriodicModeBackupPolicy

Имя Описание Значение
тип Описывает режим резервного копирования. "Periodic" (обязательно)
periodicModeProperties Значения конфигурации для резервного копирования в периодическом режиме PeriodicModeProperties

PeriodicModeProperties

Имя Описание Значение
backupIntervalInMinutes Целое число, представляющее интервал между двумя резервными копиями в минутах. INT

Ограничения:
Минимальное значение = 0
backupRetentionIntervalInHours Целое число, представляющее время (в часах) хранения каждой резервной копии. INT

Ограничения:
Минимальное значение = 0

Функция

Имя Описание Значение
name Имя возможности Cosmos DB. Например, "name": "EnableCassandra". Текущие значения также включают "EnableTable" и "EnableGremlin". строка

ConsistencyPolicy

Имя Описание Значение
defaultConsistencyLevel Уровень согласованности по умолчанию и параметры конфигурации учетной записи Cosmos DB. 'BoundedStaleness'
"ConsistentPrefix"
"В конечном счете"
"Сеанс"
Strong (обязательный)
maxIntervalInSeconds При использовании с уровнем согласованности Ограниченное устаревание это значение представляет допустимое время устаревание (в секундах). Допустимый диапазон для этого значения — от 5 до 86400. Требуется, если defaultConsistencyPolicy имеет значение BoundedStaleness. INT

Ограничения:
Минимальное значение = 5
Максимальное значение = 86400
maxStalenessPrefix При использовании с уровнем согласованности Ограниченное устаревание это значение представляет допустимое количество устаревших запросов. Допустимый диапазон — 1–2 147 483 647. Требуется, если defaultConsistencyPolicy имеет значение BoundedStaleness. INT

Ограничения:
Минимальное значение = 1
Максимальное значение = 2147483647

CorsPolicy

Имя Описание Значение
allowedHeaders Заголовки запросов, которые исходный домен может указывать в запросах CORS. строка
allowedMethods Методы (команды HTTP-запросов), которые может использовать исходный домен для выполнения запроса CORS. строка
allowedOrigins Домены источника, которым разрешено выполнять запрос к службе через CORS. строка (обязательно)
exposedHeaders Заголовки ответов, которые можете отправить в ответ на запрос CORS и предоставить отправителю запроса с помощью браузера. строка
maxAgeInSeconds Максимальная продолжительность хранения предварительных запросов OPTIONS в кэше браузера. INT

Ограничения:
Минимальное значение = 1
Максимальное значение = 2147483647

IpAddressOrRange

Имя Описание Значение
ipAddressOrRange Один IPv4-адрес или один диапазон IPv4-адресов в формате CIDR. Предоставленные IP-адреса должны быть хорошо отформатированы и не могут содержаться в одном из следующих диапазонов: 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0/16, так как они не применяются фильтром IP-адресов. Пример допустимых входных данных: "23.40.210.245" или "23.40.210.0/8". строка

Расположение

Имя Описание Значение
failoverPriority Приоритет отработки отказа региона. Приоритет отработки отказа 0 указывает регион записи. Максимальное значение приоритета отработки отказа = (общее число регионов — 1). Значения приоритета отработки отказа должны быть уникальными для каждого из регионов, в которых существует учетная запись базы данных. INT

Ограничения:
Минимальное значение = 0
isZoneRedundant Флаг, указывающий, является ли этот регион регионом AvailabilityZone bool
locationName Имя области. строка

VirtualNetworkRule

Имя Описание Значение
идентификатор Идентификатор ресурса подсети, например : /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. строка
ignoreMissingVNetServiceEndpoint Создайте правило брандмауэра, прежде чем в виртуальной сети включена конечная точка службы виртуальной сети. bool

Шаблоны быстрого запуска

Следующие шаблоны быстрого запуска развертывают этот тип ресурса.

Шаблон Описание
CI/CD с использованием Jenkins в Службе контейнеров Azure (AKS)

Развертывание в Azure
Контейнеры упрощают непрерывную сборку и развертывание приложений. Управляя развертыванием этих контейнеров с помощью Kubernetes в Службе контейнеров Azure, вы можете создать реплицируемые управляемые кластеры контейнеров. Настроив непрерывную сборку для создания образов контейнеров и оркестрации, вы можете повысить скорость и надежность развертывания.
Веб-приложение с базой данных SQL, Azure Cosmos DB, поискОм Azure

Развертывание в Azure
Этот шаблон подготавливает веб-приложение, базу данных SQL, Azure Cosmos DB, поиск Azure и Application Insights.
Создание учетной записи Azure Cosmos DB для API Cassandra

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для API Cassandra в двух регионах с пространством ключей и таблицей с выделенной пропускной способностью.
Создание учетной записи автомасштабирования Azure Cosmos DB для API Cassandra

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для API Cassandra в двух регионах с пространством ключей и таблицей с автомасштабируемой пропускной способностью.
Создание учетной записи Azure CosmosDB

Развертывание в Azure
Этот шаблон ARM предназначен для быстрого создания учетной записи CosmosDB с минимальными необходимыми значениями.
Создание учетной записи Azure Cosmos DB в нескольких регионах

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для любого типа API базы данных с основным и вторичным регионами с выбором уровня согласованности и типа отработки отказа.
Создание учетной записи Azure Cosmos DB бесплатного уровня

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB бесплатного уровня для API SQL с базой данных с общей пропускной способностью и контейнером.
Создание учетной записи Azure Cosmos DB для API Gremlin

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для API Gremlin в двух регионах с одной базой данных и одним графом с использованием выделенной пропускной способности.
Создание учетной записи Azure Cosmos DB для автомасштабирования API Gremlin

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для API Gremlin в двух регионах с одной базой данных и одним графом с использованием автомасштабируемой пропускной способности.
Создание учетной записи Azure Cosmos для API MongoDB

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для API MongoDB 4.2 в двух регионах с использованием общей и выделенной пропускной способности с двумя коллекциями.
Создание учетной записи Azure Cosmos для автомасштабирования API MongoDB

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для API MongoDB 4.2 в двух регионах с использованием общей и выделенной пропускной способности автомасштабирования.
Создание учетной записи Azure Cosmos DB с частной конечной точкой

Развертывание в Azure
Этот шаблон создаст учетную запись Cosmos, виртуальную сеть и частную конечную точку, предоставляющую учетную запись Cosmos виртуальной сети.
Создание учетной записи Azure Cosmos DB для API Core (SQL)

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos для API Core (SQL) с базой данных и контейнером с пропускной способностью с несколькими другими вариантами.
API SQL учетной записи Azure Cosmos DB с аналитическим хранилищем

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos для API Core (SQL) с базой данных и контейнером, настроенными с аналитическим хранилищем.
Создание API SQL учетной записи Azure Cosmos DB с автомасштабированием

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos для API Core (SQL) с базой данных и контейнером с автомасштабируемой пропускной способностью с несколькими другими вариантами.
Создание хранимых процедур API Azure Cosmos DB Core (SQL)

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для API Core (SQL) и контейнер с хранимой процедурой, триггером и определяемой пользователем функцией.
Создание минимальной учетной записи Azure Cosmos DB для API Core (SQL)

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для API Core (SQL) с указанием только минимальных обязательных свойств ресурса.
Создание Azure Cosmos с ПОМОЩЬЮ API SQL и нескольких контейнеров

Развертывание в Azure
Шаблон создает контейнер Cosmos с API SQL и позволяет добавлять многообразные контейнеры.
Создание учетной записи SQL Azure Cosmos DB с помощью RBAC плоскости данных

Развертывание в Azure
Этот шаблон создает учетную запись SQL Cosmos DB, встроенное определение роли и встроенное назначение роли для удостоверения Azure Active Directory.
Создание бессерверной учетной записи Azure Cosmos DB для API SQL

Развертывание в Azure
Этот шаблон создает бессерверную учетную запись Azure Cosmos DB для API Core (SQL).
Создание учетной записи Azure Cosmos для API таблиц

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для API таблиц в двух регионах и одну таблицу с подготовленной пропускной способностью.
Создание учетной записи Azure Cosmos для API таблиц с автомасштабированием

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB для API таблиц в двух регионах и одну таблицу с автомасштабируемой пропускной способностью.
Создание учетной записи Azure Cosmos и веб-приложения Azure

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos, внедряет конечную точку и ключи Cosmos DB в параметры веб-приложения Azure, а затем развертывает веб-приложение ASP MVC из GitHub.
Создание учетной записи Cosmos DB с включенным Microsoft Defender

Развертывание в Azure
С помощью этого шаблона ARM можно развернуть учетную запись Azure Cosmos DB с включенным Microsoft Defender для Azure Cosmos DB. Microsoft Defender для Azure Cosmos DB — это собственный уровень безопасности Azure, который обнаруживает все попытки использования баз данных в учетных записях Azure Cosmos DB. Microsoft Defender для Azure Cosmos DB обнаруживает потенциальные внедрения КОДА SQL, известные злоумышленники на основе Microsoft Threat Intelligence, подозрительные шаблоны доступа и потенциальную эксплуатацию базы данных с помощью скомпрометированных удостоверений или вредоносных участников программы предварительной оценки.
Развертывание Azure Data Explorer DB с подключением к Cosmos DB

Развертывание в Azure
Развертывание Azure Data Explorer DB с подключением к Cosmos DB.
Учетная запись Azure Cosmos DB с веб-приложением

Развертывание в Azure
Этот шаблон развертывает учетную запись Azure Cosmos DB, план службы приложений и создает веб-приложение в плане службы приложений. Он также добавляет два параметра приложения в веб-приложение, которые ссылаться на конечную точку учетной записи Azure Cosmos DB. Таким образом, решения, развернутые в веб-приложении, могут подключаться к конечной точке учетной записи Azure Cosmos DB с помощью этих параметров.

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса databaseAccounts можно развернуть с помощью операций, предназначенных для:

  • Группы ресурсов

Список измененных свойств в каждой версии API см. в журнале изменений.

Формат ресурсов

Чтобы создать ресурс Microsoft.DocumentDB/databaseAccounts, добавьте в шаблон следующую terraform.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/databaseAccounts@2021-01-15"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  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"
        }
      ]
      networkAclBypass = "string"
      networkAclBypassResourceIds = [
        "string"
      ]
      publicNetworkAccess = "string"
      virtualNetworkRules = [
        {
          id = "string"
          ignoreMissingVNetServiceEndpoint = bool
        }
      ]
    }
    kind = "string"
  })
}

Объекты BackupPolicy

Задайте свойство type , чтобы указать тип объекта .

Для непрерывного использования используйте:

  type = "Continuous"

В параметре Periodic используйте:

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

Значения свойств

databaseAccounts

Имя Описание Значение
тип Тип ресурса "Microsoft.DocumentDB/databaseAccounts@2021-01-15"
name имя ресурса. строка (обязательно)

Ограничение символов: 3–44

Допустимые символы:
Строчные буквы, цифры и дефисы.

Начинается со строчной буквы или цифры.

Имя ресурса должно быть уникальным в Azure.
location Расположение группы ресурсов, к которой принадлежит ресурс. строка
parent_id Чтобы выполнить развертывание в группе ресурсов, используйте идентификатор этой группы ресурсов. строка (обязательно)
tags Теги — это список пар "ключ-значение", описывающих ресурс. Эти теги можно использовать при просмотре и группировании ресурсов (между группами). Для ресурса можно указать не более 15 тегов. В каждом теге длина ключа нее должна превышать 128 символов, а длина значения — 256 символов. Например, для типа шаблона по умолчанию задано значение defaultExperience: Cassandra. Текущие значения defaultExperience также включают "Table", "Graph", "DocumentDB" и "MongoDB". Словарь имен и значений тегов.
kind Указывает тип учетной записи базы данных. Это можно задать только при создании учетной записи базы данных. GlobalDocumentDB
MongoDB
"Анализ"
удостоверение Удостоверение ресурса. Управляемое удостоверение службы
properties Свойства для создания и обновления учетных записей базы данных Azure Cosmos DB. DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou... (обязательно)

Управляемое удостоверение службы

Имя Описание Значение
тип Тип удостоверения, используемого для ресурса. Тип SystemAssigned,UserAssigned включает как неявно созданное удостоверение, так и набор удостоверений, назначаемых пользователем. Тип None удалит все удостоверения из службы. "SystemAssigned"
"SystemAssigned,UserAssigned"
UserAssigned
identity_ids Список удостоверений пользователей, связанных с ресурсом. Ссылки на ключ словаря удостоверений пользователей будут иметь идентификаторы ресурсов ARM в формате "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". Массив идентификаторов удостоверений пользователей.

ManagedServiceIdentityUserAssignedIdentities

Имя Описание Значение
{настроенное свойство} Components1Jq1T4ISchemasManagedserviceidentityProper...

Components1Jq1T4ISchemasManagedserviceidentityProper...

Этот объект не содержит свойств, которые необходимо задать во время развертывания. Все свойства доступны только для чтения.

DatabaseAccountCreateUpdatePropertiesOrDatabaseAccou...

Имя Описание Значение
apiProperties Свойства API. В настоящее время поддерживается только для API MongoDB. ApiProperties
backupPolicy Объект , представляющий политику для создания резервных копий в учетной записи. BackupPolicy
capabilities Список возможностей Cosmos DB для учетной записи Возможность[]
connectorOffer Тип предложения соединителя cassandra для учетной записи C* базы данных Cosmos DB. "Маленький"
consistencyPolicy Политика согласованности для учетной записи Cosmos DB. ConsistencyPolicy
cors Политика CORS для учетной записи базы данных Cosmos DB. CorsPolicy[]
databaseAccountOfferType Тип предложения для базы данных "Стандартный" (обязательно)
disableKeyBasedMetadataWriteAccess Отключение операций записи с ресурсами метаданных (базами данных, контейнерами, пропускной способностью) с помощью ключей учетной записи bool
enableAnalyticalStorage Флаг, указывающий, следует ли включать аналитику хранилища. bool
enableAutomaticFailover Включает автоматическую отработку отказа региона записи в редких случаях, когда регион становится недоступным из-за сбоя. Автоматическая отработка отказа приведет к созданию нового региона записи для учетной записи и будет выбрана на основе приоритетов отработки отказа, настроенных для учетной записи. bool
enableCassandraConnector Включает соединитель cassandra в учетной записи C* Cosmos DB. bool
enableFreeTier Флаг, указывающий, включен ли уровень "Бесплатный". bool
enableMultipleWriteLocations Позволяет учетной записи выполнять запись в нескольких расположениях. bool
ipRules Список IpRules. IpAddressOrRange[]
isVirtualNetworkFilterEnabled Флаг, указывающий, следует ли включать или отключать правила ACL виртуальной сети. bool
keyVaultKeyUri Универсальный код ресурса (URI) хранилища ключей строка
Расположения Массив, содержащий расположения георепликации, включенные для учетной записи Cosmos DB. Location[] (обязательно)
networkAclBypass Указывает, какие службы могут обходить проверки брандмауэра. "AzureServices"
"None"
networkAclBypassResourceIds Массив, содержащий идентификаторы ресурсов для обхода сетевого списка ACL для учетной записи Cosmos DB. string[]
publicNetworkAccess Разрешены ли запросы из общедоступной сети "Отключено"
"Включено"
virtualNetworkRules Список правил ACL виртуальной сети, настроенных для учетной записи Cosmos DB. VirtualNetworkRule[]

ApiProperties

Имя Описание Значение
serverVersion Описывает ServerVersion учетной записи MongoDB. "3.2"
"3.6"
"4.0"

BackupPolicy

Имя Описание Значение
тип Установка типа объекта Непрерывные
Периодическая (обязательно)

ContinuousModeBackupPolicy

Имя Описание Значение
тип Описывает режим резервного копирования. "Непрерывный" (обязательно)

PeriodicModeBackupPolicy

Имя Описание Значение
тип Описывает режим резервного копирования. "Periodic" (обязательно)
periodicModeProperties Значения конфигурации для резервного копирования в периодическом режиме PeriodicModeProperties

PeriodicModeProperties

Имя Описание Значение
backupIntervalInMinutes Целое число, представляющее интервал между двумя резервными копиями в минутах. INT

Ограничения:
Минимальное значение = 0
backupRetentionIntervalInHours Целое число, представляющее время (в часах) хранения каждой резервной копии. INT

Ограничения:
Минимальное значение = 0

Функция

Имя Описание Значение
name Имя возможности Cosmos DB. Например, "name": "EnableCassandra". Текущие значения также включают "EnableTable" и "EnableGremlin". строка

ConsistencyPolicy

Имя Описание Значение
defaultConsistencyLevel Уровень согласованности по умолчанию и параметры конфигурации учетной записи Cosmos DB. "BoundedStaleness"
"ConsistentPrefix"
"В конечном счете"
"Сеанс"
"Strong" (обязательно)
maxIntervalInSeconds При использовании с уровнем согласованности с ограниченным устареванием это значение представляет допустимое время устаревание (в секундах). Допустимый диапазон для этого значения — 5–86400. Требуется, если defaultConsistencyPolicy имеет значение BoundedStaleness. INT

Ограничения:
Минимальное значение = 5
Максимальное значение = 86400
maxStalenessPrefix При использовании с уровнем согласованности с ограниченным устареванием это значение представляет количество допустимых устаревших запросов. Допустимый диапазон — 1–2 147 483 647. Требуется, если defaultConsistencyPolicy имеет значение BoundedStaleness. INT

Ограничения:
Минимальное значение = 1
Максимальное значение = 2147483647

CorsPolicy

Имя Описание Значение
allowedHeaders Заголовки запросов, которые исходный домен может указывать в запросах CORS. строка
allowedMethods Методы (команды HTTP-запросов), которые может использовать исходный домен для выполнения запроса CORS. строка
allowedOrigins Домены-источники, которым разрешено выполнять запрос к службе через CORS. string (обязательно)
exposedHeaders Заголовки ответов, которые можете отправить в ответ на запрос CORS и предоставить отправителю запроса с помощью браузера. строка
maxAgeInSeconds Максимальная продолжительность хранения предварительных запросов OPTIONS в кэше браузера. INT

Ограничения:
Минимальное значение = 1
Максимальное значение = 2147483647

IpAddressOrRange

Имя Описание Значение
ipAddressOrRange Один IPv4-адрес или один диапазон адресов IPv4 в формате CIDR. Предоставленные IP-адреса должны быть хорошо отформатированы и не могут содержаться в одном из следующих диапазонов: 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0/16, так как они не применяются фильтром IP-адресов. Пример допустимых входных данных: "23.40.210.245" или "23.40.210.0/8". строка

Расположение

Имя Описание Значение
failoverPriority Приоритет отработки отказа региона. Приоритет отработки отказа 0 указывает регион записи. Максимальное значение для приоритета отработки отказа = (общее количество регионов — 1). Значения приоритета отработки отказа должны быть уникальными для каждого региона, в котором существует учетная запись базы данных. INT

Ограничения:
Минимальное значение = 0
isZoneRedundant Флаг, указывающий, является ли этот регион регионом AvailabilityZone bool
locationName Имя области. строка

VirtualNetworkRule

Имя Описание Значение
идентификатор Идентификатор ресурса подсети, например : /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. строка
ignoreMissingVNetServiceEndpoint Создайте правило брандмауэра, прежде чем в виртуальной сети включена конечная точка службы виртуальной сети. bool