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


Microsoft.DocumentDB databaseAccounts/sqlDatabases 2022-11-15-preview

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

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

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

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

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

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2022-11-15-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    options: {
      autoscaleSettings: {
        maxThroughput: int
      }
      throughput: int
    }
    resource: {
      createMode: 'string'
      id: 'string'
      restoreParameters: {
        restoreSource: 'string'
        restoreTimestampInUtc: 'string'
      }
    }
  }
}

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

databaseAccounts/sqlDatabases

Имя Описание Значение
name имя ресурса.

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

Дополнительные сведения см. в разделе Дочерний ресурс за пределами родительского ресурса.
Символьное имя ресурса типа databaseAccounts
удостоверение Удостоверение ресурса. Управляемое удостоверение службы
properties Свойства для создания и обновления базы данных SQL Azure Cosmos DB. SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetPro... (обязательно)

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

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

ManagedServiceIdentityUserAssignedIdentities

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

Components1Jq1T4ISchemasManagedserviceidentityProper...

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

SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetPro...

Имя Описание Значение
options Пара параметров "ключ-значение", применяемая к запросу. Это соответствует заголовкам, отправленным с запросом. CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions
ресурс Стандартный формат JSON базы данных SQL SqlDatabaseResourceOrSqlDatabaseGetPropertiesResourc... (обязательно)

CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions

Имя Описание Значение
autoscaleSettings Задает параметры автомасштабирования. АвтомасштабированиеПараметры
throughput Количество запросов в секунду. Например, "пропускная способность": 10000. INT

АвтомасштабированиеПараметры

Имя Описание Значение
maxThroughput Представляет максимальную пропускную способность. Ресурс может масштабироваться до . INT

SqlDatabaseResourceOrSqlDatabaseGetPropertiesResourc...

Имя Описание Значение
createMode Перечисление для указания режима создания ресурса. 'Default'
"Восстановить"
идентификатор Имя базы данных SQL Cosmos DB string (обязательно)
restoreParameters Параметры для указания сведений о восстановлении ResourceRestoreParameters

ResourceRestoreParameters

Имя Описание Значение
restoreSource Идентификатор восстанавливаемой учетной записи базы данных, из которой должно быть инициировано восстановление. Например: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccounts} строка
restoreTimestampInUtc Время восстановления учетной записи (формат ISO-8601). строка

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

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

Шаблон Описание
Создание учетной записи Azure Cosmos DB бесплатного уровня

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB бесплатного уровня для API SQL с базой данных с общей пропускной способностью и контейнером.
Создание учетной записи 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 Data Explorer DB с подключением к Cosmos DB

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

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

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

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

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

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

{
  "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases",
  "apiVersion": "2022-11-15-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "options": {
      "autoscaleSettings": {
        "maxThroughput": "int"
      },
      "throughput": "int"
    },
    "resource": {
      "createMode": "string",
      "id": "string",
      "restoreParameters": {
        "restoreSource": "string",
        "restoreTimestampInUtc": "string"
      }
    }
  }
}

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

databaseAccounts/sqlDatabases

Имя Описание Значение
тип Тип ресурса Microsoft.DocumentDB/databaseAccounts/sqlDatabases
версия_API Версия API ресурсов '2022-11-15-preview'
name имя ресурса.

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

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

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

ManagedServiceIdentityUserAssignedIdentities

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

Components1Jq1T4ISchemasManagedserviceidentityProper...

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

SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetPro...

Имя Описание Значение
options Пара параметров "ключ-значение", применяемая к запросу. Это соответствует заголовкам, отправленным с запросом. CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions
ресурс Стандартный формат JSON базы данных SQL SqlDatabaseResourceOrSqlDatabaseGetPropertiesResourc... (обязательно)

CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions

Имя Описание Значение
autoscaleSettings Задает параметры автомасштабирования. АвтомасштабированиеПараметры
throughput Количество запросов в секунду. Например, "пропускная способность": 10000. INT

АвтомасштабированиеПараметры

Имя Описание Значение
maxThroughput Представляет максимальную пропускную способность. Ресурс может масштабироваться до . INT

SqlDatabaseResourceOrSqlDatabaseGetPropertiesResourc...

Имя Описание Значение
createMode Перечисление для указания режима создания ресурса. 'Default'
"Восстановить"
идентификатор Имя базы данных SQL Cosmos DB string (обязательно)
restoreParameters Параметры для указания сведений о восстановлении ResourceRestoreParameters

ResourceRestoreParameters

Имя Описание Значение
restoreSource Идентификатор восстанавливаемой учетной записи базы данных, из которой должно быть инициировано восстановление. Например: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccounts} строка
restoreTimestampInUtc Время восстановления учетной записи (формат ISO-8601). строка

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

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

Шаблон Описание
Создание учетной записи Azure Cosmos DB бесплатного уровня

Развертывание в Azure
Этот шаблон создает учетную запись Azure Cosmos DB бесплатного уровня для API SQL с базой данных с общей пропускной способностью и контейнером.
Создание учетной записи 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 Data Explorer DB с подключением к Cosmos DB

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

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

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

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

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

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

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2022-11-15-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      options = {
        autoscaleSettings = {
          maxThroughput = int
        }
        throughput = int
      }
      resource = {
        createMode = "string"
        id = "string"
        restoreParameters = {
          restoreSource = "string"
          restoreTimestampInUtc = "string"
        }
      }
    }
  })
}

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

databaseAccounts/sqlDatabases

Имя Описание Значение
тип Тип ресурса "Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2022-11-15-preview"
name имя ресурса. строка (обязательно)
location Расположение группы ресурсов, к которой принадлежит ресурс. строка
parent_id Идентификатор ресурса, который является родительским для этого ресурса. Идентификатор ресурса типа databaseAccounts
tags Теги — это список пар "ключ-значение", описывающих ресурс. Эти теги можно использовать при просмотре и группировании ресурсов (между группами). Для ресурса можно указать не более 15 тегов. В каждом теге длина ключа нее должна превышать 128 символов, а длина значения — 256 символов. Например, для типа шаблона по умолчанию задано значение defaultExperience: Cassandra. Текущие значения defaultExperience также включают "Table", "Graph", "DocumentDB" и "MongoDB". Словарь имен и значений тегов.
удостоверение Удостоверение ресурса. Управляемое удостоверение службы
properties Свойства для создания и обновления базы данных SQL Azure Cosmos DB. SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetPro... (обязательно)

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

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

ManagedServiceIdentityUserAssignedIdentities

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

Components1Jq1T4ISchemasManagedserviceidentityProper...

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

SqlDatabaseCreateUpdatePropertiesOrSqlDatabaseGetPro...

Имя Описание Значение
options Пара параметров "ключ-значение", применяемая к запросу. Это соответствует заголовкам, отправленным вместе с запросом. CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions
ресурс Стандартный формат JSON базы данных SQL SqlDatabaseResourceOrSqlDatabaseGetPropertiesResourc... (обязательно)

CreateUpdateOptionsOrSqlDatabaseGetPropertiesOptions

Имя Описание Значение
autoscaleSettings Задает параметры автомасштабирования. АвтомасштабированиеПараметры
throughput Количество запросов в секунду. Например, "пропускная способность": 10000. INT

АвтомасштабированиеПараметры

Имя Описание Значение
maxThroughput Представляет максимальную пропускную способность. Ресурс может масштабироваться до . INT

SqlDatabaseResourceOrSqlDatabaseGetPropertiesResourc...

Имя Описание Значение
createMode Перечисление для указания режима создания ресурса. "По умолчанию"
"Восстановить"
идентификатор Имя базы данных SQL Cosmos DB string (обязательно)
restoreParameters Параметры для указания сведений о восстановлении ResourceRestoreParameters

ResourceRestoreParameters

Имя Описание Значение
restoreSource Идентификатор восстанавливаемой учетной записи базы данных, из которой должно быть инициировано восстановление. Например: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccounts} строка
restoreTimestampInUtc Время восстановления учетной записи (формат ISO-8601). строка