Database Accounts - Update
Обновляет свойства существующей учетной записи базы данных Azure Cosmos DB.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}?api-version=2026-03-15
Параметры URI
| Имя | В | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
account
|
path | True |
string minLength: 3maxLength: 50 pattern: ^[a-z0-9]+(-[a-z0-9]+)* |
Имя учетной записи базы данных Cosmos DB. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Имя группы ресурсов. Имя нечувствительно к регистру. |
|
subscription
|
path | True |
string (uuid) |
Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID). |
|
api-version
|
query | True |
string minLength: 1 |
Версия API, используемая для данной операции. |
Текст запроса
| Имя | Тип | Описание |
|---|---|---|
| identity |
Удостоверение ресурса. |
|
| location |
string |
Расположение группы ресурсов, к которой принадлежит ресурс. |
| properties.analyticalStorageConfiguration |
Конкретные свойства аналитического хранилища. |
|
| properties.apiProperties |
Определенные свойства API. В настоящее время поддерживается только для API MongoDB. |
|
| properties.backupPolicy | BackupPolicy: |
Объект, представляющий политику для создания резервных копий в учетной записи. |
| properties.capabilities |
Список возможностей Cosmos DB для учетной записи |
|
| properties.capacity |
Объект, представляющий все свойства, связанные с применением емкости в учетной записи. |
|
| properties.connectorOffer |
Тип предложения соединителя cassandra для учетной записи базы данных Cosmos DB C*. |
|
| properties.consistencyPolicy |
Политика согласованности для учетной записи Cosmos DB. |
|
| properties.cors |
Политика CORS для учетной записи базы данных Cosmos DB. |
|
| properties.customerManagedKeyStatus |
string |
Указывает состояние функции управляемого клиентом ключа в учетной записи. В случае возникновения ошибок свойство предоставляет рекомендации по устранению неполадок. |
| properties.defaultIdentity |
string |
Удостоверение по умолчанию для доступа к хранилищу ключей, используемого в таких функциях, как управляемые клиентом ключи. Удостоверение по умолчанию должно быть явно задано пользователями. Это может быть "FirstPartyIdentity", "SystemAssignedIdentity" и многое другое. |
| properties.defaultPriorityLevel |
Перечисление, указывающее уровень приоритета по умолчанию для выполнения на основе приоритета. |
|
| properties.disableKeyBasedMetadataWriteAccess |
boolean |
Отключение операций записи с ресурсами метаданных (базами данных, контейнерами, пропускной способностью) с помощью ключей учетной записи |
| properties.disableLocalAuth |
boolean |
Отказ от локальной проверки подлинности и обеспечение использования только MSI и AAD можно использовать исключительно для проверки подлинности. |
| properties.enableAnalyticalStorage |
boolean |
Пометка, указывающее, следует ли включить аналитику хранилища. |
| properties.enableAutomaticFailover |
boolean |
Включает автоматическую отработку отказа области записи в редких случаях, когда регион недоступен из-за сбоя. Автоматическая отработка отказа приведет к новому региону записи для учетной записи и выбирается на основе приоритетов отработки отказа, настроенных для учетной записи. |
| properties.enableBurstCapacity |
boolean |
Флаг, указывающий включение и отключение функции предварительной версии емкости для учетной записи |
| properties.enableCassandraConnector |
boolean |
Включает соединитель cassandra в учетной записи Cosmos DB C* |
| properties.enableFreeTier |
boolean |
Пометка, чтобы указать, включен ли уровень "Бесплатный". |
| properties.enableMultipleWriteLocations |
boolean |
Позволяет учетной записи записывать в нескольких расположениях |
| properties.enablePartitionMerge |
boolean |
Флаг, указывающий включение и отключение функции слияния секций в учетной записи |
| properties.enablePerRegionPerPartitionAutoscale |
boolean |
Флаг, указывающий включение и отключение Per-Region функции автомасштабирования для секции в учетной записи |
| properties.enablePriorityBasedExecution |
boolean |
Флаг, указывающий включение и отключение функции предварительной версии выполнения на основе приоритета в учетной записи |
| properties.enforceHierarchicalPartitionKeyIdLastLevel |
boolean |
Флаг, указывающий на включение/отключение иерархического идентификатора ключа раздела на последнем уровне применения аккаунта. |
| properties.ipRules |
Список IpRules. |
|
| properties.isVirtualNetworkFilterEnabled |
boolean |
Флаг, указывающий на включение или отключение правил ACL виртуальная сеть. |
| properties.keyVaultKeyUri |
string |
Универсальный код ресурса (URI) хранилища ключей |
| properties.locations |
Location[] |
Массив, содержащий расположения георепликации, включенные для учетной записи Cosmos DB. |
| properties.minimalTlsVersion |
Указывает минимальную разрешенную версию TLS. По умолчанию используется tls 1.0, за исключением Cassandra и API Mongo, которые работают только с TLS 1.2. |
|
| properties.networkAclBypass |
Указывает, какие службы разрешены для обхода проверок брандмауэра. |
|
| properties.networkAclBypassResourceIds |
string[] |
Массив, содержащий идентификаторы ресурсов для обхода сетевого списка для учетной записи Cosmos DB. |
| properties.publicNetworkAccess |
Разрешены ли запросы из общедоступной сети |
|
| properties.virtualNetworkRules |
Список правил ACL виртуальная сеть, настроенных для аккаунта Cosmos DB. |
|
| tags |
object |
Теги — это список пар ключ-значение, которые описывают ресурс. Эти теги можно использовать для просмотра и группировки этого ресурса (между группами ресурсов). Для ресурса может быть предоставлено не более 15 тегов. Каждый тег должен иметь ключ не более 128 символов и значения не более 256 символов. Например, взаимодействие по умолчанию для типа шаблона задается с помощью "defaultExperience": "Cassandra". Текущие значения "defaultExperience" также включают "Table", "Graph", "DocumentDB" и "MongoDB". |
Ответы
| Имя | Тип | Описание |
|---|---|---|
| 200 OK |
Запрос выполнен успешно. Заголовки Location: string |
|
| Other Status Codes |
Непредвиденное сообщение об ошибке. |
Безопасность
azure_auth
Поток OAuth2 в Azure Active Directory.
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
| Имя | Описание |
|---|---|
| user_impersonation | выдать себя за учетную запись пользователя |
Примеры
CosmosDBDatabaseAccountPatch
Образец запроса
PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1?api-version=2026-03-15
{
"location": "westus",
"tags": {
"dept": "finance"
},
"identity": {
"type": "SystemAssigned,UserAssigned",
"userAssignedIdentities": {
"/subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/eu2cgroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {}
}
},
"properties": {
"ipRules": [
{
"ipAddressOrRange": "23.43.230.120"
},
{
"ipAddressOrRange": "110.12.240.0/12"
}
],
"isVirtualNetworkFilterEnabled": true,
"virtualNetworkRules": [
{
"id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"ignoreMissingVNetServiceEndpoint": false
}
],
"consistencyPolicy": {
"defaultConsistencyLevel": "BoundedStaleness",
"maxIntervalInSeconds": 10,
"maxStalenessPrefix": 200
},
"defaultIdentity": "FirstPartyIdentity",
"enableFreeTier": false,
"enableAnalyticalStorage": true,
"enableBurstCapacity": true,
"enablePriorityBasedExecution": true,
"defaultPriorityLevel": "Low",
"enablePerRegionPerPartitionAutoscale": true,
"analyticalStorageConfiguration": {
"schemaType": "WellDefined"
},
"backupPolicy": {
"type": "Periodic",
"periodicModeProperties": {
"backupIntervalInMinutes": 240,
"backupRetentionIntervalInHours": 720,
"backupStorageRedundancy": "Local"
}
},
"networkAclBypass": "AzureServices",
"networkAclBypassResourceIds": [
"/subscriptions/subId/resourcegroups/rgName/providers/Microsoft.Synapse/workspaces/workspaceName"
],
"capacity": {
"totalThroughputLimit": 2000
},
"enablePartitionMerge": true,
"enforceHierarchicalPartitionKeyIdLastLevel": false,
"minimalTlsVersion": "Tls"
}
}
Пример ответа
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1",
"name": "ddb1",
"location": "West US",
"type": "Microsoft.DocumentDB/databaseAccounts",
"kind": "GlobalDocumentDB",
"tags": {
"dept": "finance"
},
"identity": {
"type": "SystemAssigned,UserAssigned",
"principalId": "52f4fef3-3c3f-4ff3-b52e-b5c9eeb68656",
"tenantId": "33e01921-4d64-4f8c-a055-5bdaffd5e33d",
"userAssignedIdentities": {
"/subscriptions/fa5fc227-a624-475e-b696-cdd604c735bc/resourceGroups/eu2cgroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/id1": {
"clientId": "fbe75b66-01c5-4f87-a220-233af3270436",
"principalId": "33e01921-4d64-4f8c-a055-5bdaffd5e33d"
}
}
},
"properties": {
"provisioningState": "Succeeded",
"documentEndpoint": "https://ddb1.documents.azure.com:443/",
"databaseAccountOfferType": "Standard",
"ipRules": [
{
"ipAddressOrRange": "23.43.230.120"
},
{
"ipAddressOrRange": "110.12.240.0/12"
}
],
"isVirtualNetworkFilterEnabled": true,
"disableKeyBasedMetadataWriteAccess": false,
"consistencyPolicy": {
"defaultConsistencyLevel": "BoundedStaleness",
"maxIntervalInSeconds": 10,
"maxStalenessPrefix": 200
},
"writeLocations": [
{
"id": "ddb1-eastus",
"locationName": "East US",
"documentEndpoint": "https://ddb1-eastus.documents.azure.com:443/",
"provisioningState": "Succeeded",
"failoverPriority": 0
}
],
"readLocations": [
{
"id": "ddb1-eastus",
"locationName": "East US",
"documentEndpoint": "https://ddb1-eastus.documents.azure.com:443/",
"provisioningState": "Succeeded",
"failoverPriority": 0
}
],
"locations": [
{
"id": "ddb1-eastus",
"locationName": "East US",
"documentEndpoint": "https://ddb1-eastus.documents.azure.com:443/",
"provisioningState": "Succeeded",
"failoverPriority": 0
}
],
"failoverPolicies": [
{
"id": "ddb1-eastus",
"locationName": "East US",
"failoverPriority": 0
}
],
"virtualNetworkRules": [
{
"id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
"ignoreMissingVNetServiceEndpoint": false
}
],
"privateEndpointConnections": [
{
"id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.DocumentDB/databaseAccounts/account1/privateEndpointConnections/pe1",
"properties": {
"privateEndpoint": {
"id": "/subscriptions/subId/resourceGroups/rg/providers/Microsoft.Network/privateEndpoints/pe1"
},
"privateLinkServiceConnectionState": {
"status": "Approved",
"actionsRequired": "None"
}
}
}
],
"cors": [],
"defaultIdentity": "FirstPartyIdentity",
"enableFreeTier": false,
"apiProperties": {},
"enableAnalyticalStorage": true,
"enableBurstCapacity": true,
"enablePriorityBasedExecution": true,
"defaultPriorityLevel": "Low",
"analyticalStorageConfiguration": {
"schemaType": "WellDefined"
},
"backupPolicy": {
"type": "Periodic",
"periodicModeProperties": {
"backupIntervalInMinutes": 240,
"backupRetentionIntervalInHours": 720,
"backupStorageRedundancy": "Local"
}
},
"networkAclBypass": "AzureServices",
"networkAclBypassResourceIds": [
"/subscriptions/subId/resourcegroups/rgName/providers/Microsoft.Synapse/workspaces/workspaceName"
],
"capacity": {
"totalThroughputLimit": 2000
},
"keysMetadata": {
"primaryMasterKey": {
"generationTime": "2022-02-25T20:30:11Z"
},
"secondaryMasterKey": {
"generationTime": "2022-02-25T20:30:11Z"
},
"primaryReadonlyMasterKey": {
"generationTime": "2022-02-25T20:30:11Z"
},
"secondaryReadonlyMasterKey": {
"generationTime": "2022-02-25T20:30:11Z"
}
},
"enablePartitionMerge": true,
"enforceHierarchicalPartitionKeyIdLastLevel": false,
"minimalTlsVersion": "Tls"
}
}
Определения
| Имя | Описание |
|---|---|
|
Account |
Метаданные, относящиеся к ключу доступа для данной учетной записи базы данных. |
|
Analytical |
Конкретные свойства аналитического хранилища. |
|
Analytical |
Описывает типы схемы для аналитического хранилища. |
|
Api |
|
|
Backup |
Объект, представляющий состояние миграции между политиками резервного копирования. |
|
Backup |
Описывает состояние миграции между типами политик резервного копирования. |
|
Backup |
Описывает режим резервных копий. |
|
Backup |
Enum для указания типа избыточности хранилища резервных копий. |
| Capability |
Объект возможностей Cosmos DB |
| Capacity |
Объект, представляющий все свойства, связанные с применением емкости в учетной записи. |
|
Connector |
Тип предложения соединителя cassandra для учетной записи базы данных Cosmos DB C*. |
|
Consistency |
Политика согласованности для учетной записи базы данных Cosmos DB. |
|
Continuous |
Объект, представляющий политику резервного копирования в непрерывном режиме. |
|
Continuous |
Значения конфигурации для периодического резервного копирования в режиме |
|
Continuous |
Enum, чтобы указать тип уровня непрерывного резервного копирования. |
|
Cors |
Политика CORS для учетной записи базы данных Cosmos DB. |
|
created |
Тип учётной записи, создавшей ресурс. |
|
Create |
Перечисление, указывающее режим создания учетной записи. |
|
Database |
Учетная запись базы данных Azure Cosmos DB. |
|
Database |
Метаданные, относящиеся к каждому ключу доступа для данной учетной записи базы данных Cosmos DB. |
|
Database |
Указывает тип учетной записи базы данных. Это можно задать только при создании учетной записи базы данных. |
|
Database |
Параметры для исправления свойств учетной записи базы данных Azure Cosmos DB. |
|
Database |
Конкретные базы данных для восстановления. |
|
Default |
Уровень согласованности по умолчанию и параметры конфигурации учетной записи Cosmos DB. |
|
Default |
Перечисление для указания приоритета по умолчаниюУровень запросов |
|
Error |
Реакция на ошибку. |
|
Failover |
Политика отработки отказа для заданного региона учетной записи базы данных. |
|
Gremlin |
Конкретные базы данных Gremlin для восстановления. |
|
Ip |
Объект IpAddressOrRange |
| Location |
Регион, в котором развернута учетная запись базы данных Azure Cosmos DB. |
|
Managed |
Удостоверение ресурса. |
|
Managed |
|
|
Minimal |
Указывает минимальную разрешенную версию TLS. По умолчанию используется tls 1.0, за исключением Cassandra и API Mongo, которые работают только с TLS 1.2. |
|
Network |
Указывает, какие службы разрешены для обхода проверок брандмауэра. |
|
Periodic |
Объект, представляющий политику периодического резервного копирования. |
|
Periodic |
Значения конфигурации для периодического резервного копирования в режиме |
|
Private |
Подключение к частной конечной точке |
|
Private |
Частная конечная точка, к которой принадлежит подключение. |
|
Private |
Состояние подключения подключения к частной конечной точке. |
|
Public |
Разрешены ли запросы из общедоступной сети |
|
Resource |
Тип удостоверения, используемого для ресурса. Тип SystemAssigned,UserAssigned включает как неявное созданное удостоверение, так и набор назначенных пользователем удостоверений. Тип "Нет" удаляет все удостоверения из службы. |
|
Restore |
Описывает режим восстановления. |
|
Restore |
Параметры для указания сведений о восстановлении. |
|
Server |
Описывает версию учетной записи MongoDB. |
|
system |
Метаданные, относящиеся к созданию и последнему изменении ресурса. |
|
Virtual |
Объект правила ACL виртуальной сети |
AccountKeyMetadata
Метаданные, относящиеся к ключу доступа для данной учетной записи базы данных.
| Имя | Тип | Описание |
|---|---|---|
| generationTime |
string (date-time) |
Время генерации в UTC ключа в формате ISO-8601. Если значение отсутствует в объекте, это означает, что последняя регенерация ключа была сработала до 18.06.2022. |
AnalyticalStorageConfiguration
Конкретные свойства аналитического хранилища.
| Имя | Тип | Описание |
|---|---|---|
| schemaType |
Описывает типы схемы для аналитического хранилища. |
AnalyticalStorageSchemaType
Описывает типы схемы для аналитического хранилища.
| Значение | Описание |
|---|---|
| WellDefined | |
| FullFidelity |
ApiProperties
| Имя | Тип | Описание |
|---|---|---|
| serverVersion |
Описывает версию учетной записи MongoDB. |
BackupPolicyMigrationState
Объект, представляющий состояние миграции между политиками резервного копирования.
| Имя | Тип | Описание |
|---|---|---|
| startTime |
string (date-time) |
Время начала миграции политики резервного копирования (формат ISO-8601). |
| status |
Описывает состояние миграции между типами политик резервного копирования. |
|
| targetType |
Описывает тип целевой политики резервного копирования миграции политики резервного копирования. |
BackupPolicyMigrationStatus
Описывает состояние миграции между типами политик резервного копирования.
| Значение | Описание |
|---|---|
| Invalid | |
| InProgress | |
| Completed | |
| Failed |
BackupPolicyType
Описывает режим резервных копий.
| Значение | Описание |
|---|---|
| Periodic | |
| Continuous |
BackupStorageRedundancy
Enum для указания типа избыточности хранилища резервных копий.
| Значение | Описание |
|---|---|
| Geo | |
| Local | |
| Zone |
Capability
Объект возможностей Cosmos DB
| Имя | Тип | Описание |
|---|---|---|
| name |
string |
Имя возможности Cosmos DB. Например, "name": "EnableCassandra". Текущие значения также включают EnableTable и EnableGremlin. |
Capacity
Объект, представляющий все свойства, связанные с применением емкости в учетной записи.
| Имя | Тип | Описание |
|---|---|---|
| totalThroughputLimit |
integer (int32) minimum: -1 |
Общее ограничение пропускной способности, установленное для учетной записи. Общий объем пропускной способности 2000 года в 2000 году накладывает строгий предел максимальной пропускной способности, который может быть подготовлен для этой учетной записи в 2000 году. Общий объем -1 -1 не ограничивает подготовку пропускной способности. |
ConnectorOffer
Тип предложения соединителя cassandra для учетной записи базы данных Cosmos DB C*.
| Значение | Описание |
|---|---|
| Small |
ConsistencyPolicy
Политика согласованности для учетной записи базы данных Cosmos DB.
| Имя | Тип | Описание |
|---|---|---|
| defaultConsistencyLevel |
Уровень согласованности по умолчанию и параметры конфигурации учетной записи Cosmos DB. |
|
| maxIntervalInSeconds |
integer (int32) minimum: 5maximum: 86400 |
При использовании с уровнем согласованности с ограниченной устаревшей степенью согласованности это значение представляет допустимое время устаревания (в секундах). Допустимый диапазон для этого значения составляет 5 – 86400. Требуется, если для defaultConsistencyPolicy задано значение BoundedStaleness. |
| maxStalenessPrefix |
integer (int64) minimum: 1maximum: 2147483647 |
При использовании с уровнем согласованности с ограниченной устаревшим состоянием это значение представляет количество устаревших запросов, допустимых. Допустимый диапазон для этого значения составляет 1 – 2 147 483 647. Требуется, если для defaultConsistencyPolicy задано значение BoundedStaleness. |
ContinuousModeBackupPolicy
Объект, представляющий политику резервного копирования в непрерывном режиме.
| Имя | Тип | Описание |
|---|---|---|
| continuousModeProperties |
Значения конфигурации для резервного копирования в непрерывном режиме |
|
| migrationState |
Объект, представляющий состояние миграции между политиками резервного копирования. |
|
| type |
string:
Continuous |
Описывает режим резервных копий. |
ContinuousModeProperties
Значения конфигурации для периодического резервного копирования в режиме
| Имя | Тип | Описание |
|---|---|---|
| tier |
Перечисление для указания типа режима резервного копирования Continuos |
ContinuousTier
Enum, чтобы указать тип уровня непрерывного резервного копирования.
| Значение | Описание |
|---|---|
| Continuous7Days | |
| Continuous30Days |
CorsPolicy
Политика CORS для учетной записи базы данных Cosmos DB.
| Имя | Тип | Описание |
|---|---|---|
| allowedHeaders |
string |
Заголовки запроса, указанные в исходном домене, могут указываться в запросе CORS. |
| allowedMethods |
string |
Методы (команды HTTP-запроса), которые домен-источник может использовать для запроса CORS. |
| allowedOrigins |
string |
Домены источника, которые разрешены запрашивать службу через CORS. |
| exposedHeaders |
string |
Заголовки ответа, которые могут быть отправлены в ответ на запрос CORS и предоставляются браузером издателю запроса. |
| maxAgeInSeconds |
integer (int64) minimum: 1maximum: 2147483647 |
Максимальное время, которое браузер должен кэшировать запрос preflight OPTIONS. |
createdByType
Тип учётной записи, создавшей ресурс.
| Значение | Описание |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
CreateMode
Перечисление, указывающее режим создания учетной записи.
| Значение | Описание |
|---|---|
| Default | |
| Restore |
DatabaseAccountGetResults
Учетная запись базы данных Azure Cosmos DB.
| Имя | Тип | Default value | Описание |
|---|---|---|---|
| id |
string (arm-id) |
Полный идентификатор ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
|
| identity |
Удостоверение ресурса. |
||
| kind | GlobalDocumentDB |
Указывает тип учетной записи базы данных. Это можно задать только при создании учетной записи базы данных. |
|
| location |
string |
Расположение группы ресурсов, к которой принадлежит ресурс. |
|
| name |
string |
Имя ресурса. |
|
| properties.analyticalStorageConfiguration |
Конкретные свойства аналитического хранилища. |
||
| properties.apiProperties |
Определенные свойства API. |
||
| properties.backupPolicy | BackupPolicy: |
Объект, представляющий политику для создания резервных копий в учетной записи. |
|
| properties.capabilities |
Список возможностей Cosmos DB для учетной записи |
||
| properties.capacity |
Объект, представляющий все свойства, связанные с применением емкости в учетной записи. |
||
| properties.connectorOffer |
Тип предложения соединителя cassandra для учетной записи базы данных Cosmos DB C*. |
||
| properties.consistencyPolicy |
Политика согласованности для учетной записи базы данных Cosmos DB. |
||
| properties.cors |
Политика CORS для учетной записи базы данных Cosmos DB. |
||
| properties.createMode | Default |
Перечисление, указывающее режим создания учетной записи. |
|
| properties.customerManagedKeyStatus |
string |
Указывает состояние функции управляемого клиентом ключа в учетной записи. В случае возникновения ошибок свойство предоставляет рекомендации по устранению неполадок. |
|
| properties.databaseAccountOfferType |
enum:
Standard |
Тип предложения для учетной записи базы данных Cosmos DB. Значение по умолчанию: Стандартное. |
|
| properties.defaultIdentity |
string |
Удостоверение по умолчанию для доступа к хранилищу ключей, используемого в таких функциях, как управляемые клиентом ключи. Удостоверение по умолчанию должно быть явно задано пользователями. Это может быть "FirstPartyIdentity", "SystemAssignedIdentity" и многое другое. |
|
| properties.defaultPriorityLevel |
Перечисление, указывающее уровень приоритета по умолчанию для выполнения на основе приоритета. |
||
| properties.disableKeyBasedMetadataWriteAccess |
boolean |
Отключение операций записи с ресурсами метаданных (базами данных, контейнерами, пропускной способностью) с помощью ключей учетной записи |
|
| properties.disableLocalAuth |
boolean |
Отказ от локальной проверки подлинности и обеспечение использования только MSI и AAD можно использовать исключительно для проверки подлинности. |
|
| properties.documentEndpoint |
string |
Конечная точка подключения для учетной записи базы данных Cosmos DB. |
|
| properties.enableAnalyticalStorage |
boolean |
Пометка, указывающее, следует ли включить аналитику хранилища. |
|
| properties.enableAutomaticFailover |
boolean |
Включает автоматическую отработку отказа области записи в редких случаях, когда регион недоступен из-за сбоя. Автоматическая отработка отказа приведет к новому региону записи для учетной записи и выбирается на основе приоритетов отработки отказа, настроенных для учетной записи. |
|
| properties.enableBurstCapacity |
boolean |
Флаг, указывающий включение и отключение функции предварительной версии емкости для учетной записи |
|
| properties.enableCassandraConnector |
boolean |
Включает соединитель cassandra в учетной записи Cosmos DB C* |
|
| properties.enableFreeTier |
boolean |
Пометка, чтобы указать, включен ли уровень "Бесплатный". |
|
| properties.enableMultipleWriteLocations |
boolean |
Позволяет учетной записи записывать в нескольких расположениях |
|
| properties.enablePartitionMerge |
boolean |
Флаг, указывающий включение и отключение функции слияния секций в учетной записи |
|
| properties.enablePerRegionPerPartitionAutoscale |
boolean |
Флаг, указывающий включение и отключение Per-Region функции автомасштабирования для секции в учетной записи |
|
| properties.enablePriorityBasedExecution |
boolean |
Флаг, указывающий включение и отключение функции предварительной версии выполнения на основе приоритета в учетной записи |
|
| properties.enforceHierarchicalPartitionKeyIdLastLevel |
boolean |
Флаг, указывающий на включение/отключение иерархического идентификатора ключа раздела на последнем уровне применения аккаунта. |
|
| properties.failoverPolicies |
Массив, содержащий регионы, упорядоченные по приоритетам отработки отказа. |
||
| properties.instanceId |
string |
Уникальный идентификатор, присвоенный учетной записи базы данных |
|
| properties.ipRules |
Список IpRules. |
||
| properties.isVirtualNetworkFilterEnabled |
boolean |
Флаг, указывающий на включение или отключение правил ACL виртуальная сеть. |
|
| properties.keyVaultKeyUri |
string |
Универсальный код ресурса (URI) хранилища ключей |
|
| properties.keyVaultKeyUriVersion |
string |
Версия ключа, управляемого клиентом, используемая в данный момент учетной записью |
|
| properties.keysMetadata |
Объект, представляющий метаданные для ключей учетной записи учетной записи Cosmos DB. |
||
| properties.locations |
Location[] |
Массив, содержащий все расположения, включенные для учетной записи Cosmos DB. |
|
| properties.minimalTlsVersion |
Указывает минимальную разрешенную версию TLS. По умолчанию используется tls 1.0, за исключением Cassandra и API Mongo, которые работают только с TLS 1.2. |
||
| properties.networkAclBypass |
Указывает, какие службы разрешены для обхода проверок брандмауэра. |
||
| properties.networkAclBypassResourceIds |
string[] (arm-id) |
Массив, содержащий идентификаторы ресурсов для обхода сетевого списка для учетной записи Cosmos DB. |
|
| properties.privateEndpointConnections |
Список подключений к частным конечным точкам, настроенных для учетной записи Cosmos DB. |
||
| properties.provisioningState |
string |
Состояние подготовки ресурса. |
|
| properties.publicNetworkAccess |
Разрешены ли запросы из общедоступной сети |
||
| properties.readLocations |
Location[] |
Массив, содержащий места чтения, включенные для учетной записи Cosmos DB. |
|
| properties.restoreParameters |
Параметры для указания сведений о восстановлении. |
||
| properties.virtualNetworkRules |
Список правил ACL виртуальная сеть, настроенных для аккаунта Cosmos DB. |
||
| properties.writeLocations |
Location[] |
Массив, содержащий расположение записи для учетной записи Cosmos DB. |
|
| systemData |
Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy. |
||
| tags |
object |
Теги — это список пар ключ-значение, которые описывают ресурс. Эти теги можно использовать для просмотра и группировки этого ресурса (между группами ресурсов). Для ресурса может быть предоставлено не более 15 тегов. Каждый тег должен иметь ключ не более 128 символов и значения не более 256 символов. Например, взаимодействие по умолчанию для типа шаблона задается с помощью "defaultExperience": "Cassandra". Текущие значения "defaultExperience" также включают "Table", "Graph", "DocumentDB" и "MongoDB". |
|
| type |
string |
Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts" |
DatabaseAccountKeysMetadata
Метаданные, относящиеся к каждому ключу доступа для данной учетной записи базы данных Cosmos DB.
| Имя | Тип | Описание |
|---|---|---|
| primaryMasterKey |
Метаданные, связанные с первичным ключом Read-Write для указанной учетной записи базы данных Cosmos DB. |
|
| primaryReadonlyMasterKey |
Метаданные, связанные с первичным ключом Read-Only для указанной учетной записи базы данных Cosmos DB. |
|
| secondaryMasterKey |
Метаданные, связанные с ключом вторичной Read-Write для указанной учетной записи базы данных Cosmos DB. |
|
| secondaryReadonlyMasterKey |
Метаданные, связанные с ключом вторичной Read-Only для указанной учетной записи базы данных Cosmos DB. |
DatabaseAccountKind
Указывает тип учетной записи базы данных. Это можно задать только при создании учетной записи базы данных.
| Значение | Описание |
|---|---|
| GlobalDocumentDB | |
| MongoDB | |
| Parse |
DatabaseAccountUpdateParameters
Параметры для исправления свойств учетной записи базы данных Azure Cosmos DB.
| Имя | Тип | Описание |
|---|---|---|
| identity |
Удостоверение ресурса. |
|
| location |
string |
Расположение группы ресурсов, к которой принадлежит ресурс. |
| properties.analyticalStorageConfiguration |
Конкретные свойства аналитического хранилища. |
|
| properties.apiProperties |
Определенные свойства API. В настоящее время поддерживается только для API MongoDB. |
|
| properties.backupPolicy | BackupPolicy: |
Объект, представляющий политику для создания резервных копий в учетной записи. |
| properties.capabilities |
Список возможностей Cosmos DB для учетной записи |
|
| properties.capacity |
Объект, представляющий все свойства, связанные с применением емкости в учетной записи. |
|
| properties.connectorOffer |
Тип предложения соединителя cassandra для учетной записи базы данных Cosmos DB C*. |
|
| properties.consistencyPolicy |
Политика согласованности для учетной записи Cosmos DB. |
|
| properties.cors |
Политика CORS для учетной записи базы данных Cosmos DB. |
|
| properties.customerManagedKeyStatus |
string |
Указывает состояние функции управляемого клиентом ключа в учетной записи. В случае возникновения ошибок свойство предоставляет рекомендации по устранению неполадок. |
| properties.defaultIdentity |
string |
Удостоверение по умолчанию для доступа к хранилищу ключей, используемого в таких функциях, как управляемые клиентом ключи. Удостоверение по умолчанию должно быть явно задано пользователями. Это может быть "FirstPartyIdentity", "SystemAssignedIdentity" и многое другое. |
| properties.defaultPriorityLevel |
Перечисление, указывающее уровень приоритета по умолчанию для выполнения на основе приоритета. |
|
| properties.disableKeyBasedMetadataWriteAccess |
boolean |
Отключение операций записи с ресурсами метаданных (базами данных, контейнерами, пропускной способностью) с помощью ключей учетной записи |
| properties.disableLocalAuth |
boolean |
Отказ от локальной проверки подлинности и обеспечение использования только MSI и AAD можно использовать исключительно для проверки подлинности. |
| properties.enableAnalyticalStorage |
boolean |
Пометка, указывающее, следует ли включить аналитику хранилища. |
| properties.enableAutomaticFailover |
boolean |
Включает автоматическую отработку отказа области записи в редких случаях, когда регион недоступен из-за сбоя. Автоматическая отработка отказа приведет к новому региону записи для учетной записи и выбирается на основе приоритетов отработки отказа, настроенных для учетной записи. |
| properties.enableBurstCapacity |
boolean |
Флаг, указывающий включение и отключение функции предварительной версии емкости для учетной записи |
| properties.enableCassandraConnector |
boolean |
Включает соединитель cassandra в учетной записи Cosmos DB C* |
| properties.enableFreeTier |
boolean |
Пометка, чтобы указать, включен ли уровень "Бесплатный". |
| properties.enableMultipleWriteLocations |
boolean |
Позволяет учетной записи записывать в нескольких расположениях |
| properties.enablePartitionMerge |
boolean |
Флаг, указывающий включение и отключение функции слияния секций в учетной записи |
| properties.enablePerRegionPerPartitionAutoscale |
boolean |
Флаг, указывающий включение и отключение Per-Region функции автомасштабирования для секции в учетной записи |
| properties.enablePriorityBasedExecution |
boolean |
Флаг, указывающий включение и отключение функции предварительной версии выполнения на основе приоритета в учетной записи |
| properties.enforceHierarchicalPartitionKeyIdLastLevel |
boolean |
Флаг, указывающий на включение/отключение иерархического идентификатора ключа раздела на последнем уровне применения аккаунта. |
| properties.ipRules |
Список IpRules. |
|
| properties.isVirtualNetworkFilterEnabled |
boolean |
Флаг, указывающий на включение или отключение правил ACL виртуальная сеть. |
| properties.keyVaultKeyUri |
string |
Универсальный код ресурса (URI) хранилища ключей |
| properties.keysMetadata |
Это свойство игнорируется во время операции обновления, так как метаданные доступны только для чтения. Объект представляет метаданные для ключей учетной записи Cosmos DB. |
|
| properties.locations |
Location[] |
Массив, содержащий расположения георепликации, включенные для учетной записи Cosmos DB. |
| properties.minimalTlsVersion |
Указывает минимальную разрешенную версию TLS. По умолчанию используется tls 1.0, за исключением Cassandra и API Mongo, которые работают только с TLS 1.2. |
|
| properties.networkAclBypass |
Указывает, какие службы разрешены для обхода проверок брандмауэра. |
|
| properties.networkAclBypassResourceIds |
string[] |
Массив, содержащий идентификаторы ресурсов для обхода сетевого списка для учетной записи Cosmos DB. |
| properties.publicNetworkAccess |
Разрешены ли запросы из общедоступной сети |
|
| properties.virtualNetworkRules |
Список правил ACL виртуальная сеть, настроенных для аккаунта Cosmos DB. |
|
| tags |
object |
Теги — это список пар ключ-значение, которые описывают ресурс. Эти теги можно использовать для просмотра и группировки этого ресурса (между группами ресурсов). Для ресурса может быть предоставлено не более 15 тегов. Каждый тег должен иметь ключ не более 128 символов и значения не более 256 символов. Например, взаимодействие по умолчанию для типа шаблона задается с помощью "defaultExperience": "Cassandra". Текущие значения "defaultExperience" также включают "Table", "Graph", "DocumentDB" и "MongoDB". |
DatabaseRestoreResource
Конкретные базы данных для восстановления.
| Имя | Тип | Описание |
|---|---|---|
| collectionNames |
string[] |
Имена коллекций, доступных для восстановления. |
| databaseName |
string |
Имя базы данных, доступной для восстановления. |
DefaultConsistencyLevel
Уровень согласованности по умолчанию и параметры конфигурации учетной записи Cosmos DB.
| Значение | Описание |
|---|---|
| Eventual | |
| Session | |
| BoundedStaleness | |
| Strong | |
| ConsistentPrefix |
DefaultPriorityLevel
Перечисление для указания приоритета по умолчаниюУровень запросов
| Значение | Описание |
|---|---|
| High | |
| Low |
ErrorResponse
Реакция на ошибку.
| Имя | Тип | Описание |
|---|---|---|
| code |
string |
Код ошибки. |
| message |
string |
Сообщение об ошибке, указывающее, почему операция завершилась ошибкой. |
FailoverPolicy
Политика отработки отказа для заданного региона учетной записи базы данных.
| Имя | Тип | Описание |
|---|---|---|
| failoverPriority |
integer (int32) minimum: 0 |
Приоритет отработки отказа региона. Приоритет отработки отказа 0 указывает регион записи. Максимальное значение для приоритета отработки отказа = (общее число регионов - 1). Значения приоритета отработки отказа должны быть уникальными для каждого региона, в котором существует учетная запись базы данных. |
| id |
string |
Уникальный идентификатор региона, в который выполняется репликация учетной записи базы данных. Пример: <accountName-locationName><>. |
| locationName |
string |
Название региона, в котором существует учетная запись базы данных. |
GremlinDatabaseRestoreResource
Конкретные базы данных Gremlin для восстановления.
| Имя | Тип | Описание |
|---|---|---|
| databaseName |
string |
Имя базы данных gremlin, доступной для восстановления. |
| graphNames |
string[] |
Имена графов, доступных для восстановления. |
IpAddressOrRange
Объект IpAddressOrRange
| Имя | Тип | Описание |
|---|---|---|
| ipAddressOrRange |
string |
Один 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". |
Location
Регион, в котором развернута учетная запись базы данных Azure Cosmos DB.
| Имя | Тип | Описание |
|---|---|---|
| documentEndpoint |
string |
Конечная точка подключения для определенного региона. Пример: https://< accountName-locationName.documents.azure.com:443/><> |
| failoverPriority |
integer (int32) minimum: 0 |
Приоритет отработки отказа региона. Приоритет отработки отказа 0 указывает регион записи. Максимальное значение для приоритета отработки отказа = (общее число регионов - 1). Значения приоритета отработки отказа должны быть уникальными для каждого региона, в котором существует учетная запись базы данных. |
| id |
string |
Уникальный идентификатор региона в учетной записи базы данных. Пример: <accountName-locationName><>. |
| isZoneRedundant |
boolean |
Флаг, указывающий, является ли этот регион регионом availabilityZone |
| locationName |
string |
Имя региона. |
| provisioningState |
string |
Состояние подготовки ресурса. |
ManagedServiceIdentity
Удостоверение ресурса.
| Имя | Тип | Описание |
|---|---|---|
| principalId |
string |
Основной идентификатор назначенного системой идентификатора. Это свойство будет предоставлено только для назначаемого системой удостоверения. |
| tenantId |
string |
Идентификатор клиента назначенного системой удостоверения. Это свойство будет предоставлено только для назначаемого системой удостоверения. |
| type |
Тип удостоверения, используемого для ресурса. Тип SystemAssigned,UserAssigned включает как неявное созданное удостоверение, так и набор назначенных пользователем удостоверений. Тип "Нет" удаляет все удостоверения из службы. |
|
| userAssignedIdentities |
Список удостоверений пользователей, связанных с ресурсом. Ссылки на ключ словаря удостоверений пользователя будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". |
ManagedServiceIdentityUserAssignedIdentities
| Имя | Тип | Описание |
|---|---|---|
| clientId |
string |
Идентификатор клиента назначаемого пользователем удостоверения. |
| principalId |
string |
Идентификатор субъекта назначаемого пользователем удостоверения. |
MinimalTlsVersion
Указывает минимальную разрешенную версию TLS. По умолчанию используется tls 1.0, за исключением Cassandra и API Mongo, которые работают только с TLS 1.2.
| Значение | Описание |
|---|---|
| Tls | |
| Tls11 | |
| Tls12 |
NetworkAclBypass
Указывает, какие службы разрешены для обхода проверок брандмауэра.
| Значение | Описание |
|---|---|
| None | |
| AzureServices |
PeriodicModeBackupPolicy
Объект, представляющий политику периодического резервного копирования.
| Имя | Тип | Описание |
|---|---|---|
| migrationState |
Объект, представляющий состояние миграции между политиками резервного копирования. |
|
| periodicModeProperties |
Значения конфигурации для периодического резервного копирования в режиме |
|
| type |
string:
Periodic |
Описывает режим резервных копий. |
PeriodicModeProperties
Значения конфигурации для периодического резервного копирования в режиме
| Имя | Тип | Описание |
|---|---|---|
| backupIntervalInMinutes |
integer (int32) minimum: 0 |
Целое число, представляющее интервал в минутах между двумя резервными копиями |
| backupRetentionIntervalInHours |
integer (int32) minimum: 0 |
Целое число, представляющее время (в часах), которое сохраняется каждой резервной копии. |
| backupStorageRedundancy |
Перечисление, указывающее тип расположения резервного копирования |
PrivateEndpointConnection
Подключение к частной конечной точке
| Имя | Тип | Описание |
|---|---|---|
| id |
string (arm-id) |
Полный идентификатор ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Имя ресурса. |
| properties.groupId |
string |
Идентификатор группы частной конечной точки. |
| properties.privateEndpoint |
Частная конечная точка, к которой принадлежит подключение. |
|
| properties.privateLinkServiceConnectionState |
Состояние подключения подключения к частной конечной точке. |
|
| properties.provisioningState |
string |
Состояние подготовки частной конечной точки. |
| systemData |
Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy. |
|
| type |
string |
Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts" |
PrivateEndpointProperty
Частная конечная точка, к которой принадлежит подключение.
| Имя | Тип | Описание |
|---|---|---|
| id |
string |
Идентификатор ресурса частной конечной точки. |
PrivateLinkServiceConnectionStateProperty
Состояние подключения подключения к частной конечной точке.
| Имя | Тип | Описание |
|---|---|---|
| actionsRequired |
string |
Любое действие, которое требуется за рамки базового рабочего процесса (утверждение/ отклонение или отключение) |
| description |
string |
Описание подключения службы приватного канала. |
| status |
string |
Состояние подключения службы приватного канала. |
PublicNetworkAccess
Разрешены ли запросы из общедоступной сети
| Значение | Описание |
|---|---|
| Enabled | |
| Disabled | |
| SecuredByPerimeter |
ResourceIdentityType
Тип удостоверения, используемого для ресурса. Тип SystemAssigned,UserAssigned включает как неявное созданное удостоверение, так и набор назначенных пользователем удостоверений. Тип "Нет" удаляет все удостоверения из службы.
| Значение | Описание |
|---|---|
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned,UserAssigned | |
| None |
RestoreMode
Описывает режим восстановления.
| Значение | Описание |
|---|---|
| PointInTime |
RestoreParameters
Параметры для указания сведений о восстановлении.
| Имя | Тип | Описание |
|---|---|---|
| databasesToRestore |
Список определенных баз данных, доступных для восстановления. |
|
| gremlinDatabasesToRestore |
Список конкретных баз данных gremlin, доступных для восстановления. |
|
| restoreMode |
Описывает режим восстановления. |
|
| restoreSource |
string |
Идентификатор учетной записи базы данных, из которой необходимо инициировать восстановление. Например: /subscriptions/{subscriptionId}/providers/Microsoft. DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} |
| restoreTimestampInUtc |
string (date-time) |
Время восстановления учетной записи (формат ISO-8601). |
| restoreWithTtlDisabled |
boolean |
Указывает, будет ли восстановленная учетная запись иметь время-To-Live отключена при успешном восстановлении. |
| sourceBackupLocation |
string |
Исходное расположение резервного копирования для восстановления. |
| tablesToRestore |
string[] |
Список определенных таблиц, доступных для восстановления. |
ServerVersion
Описывает версию учетной записи MongoDB.
| Значение | Описание |
|---|---|
| 3.2 | |
| 3.6 | |
| 4.0 | |
| 4.2 | |
| 5.0 | |
| 6.0 | |
| 7.0 |
systemData
Метаданные, относящиеся к созданию и последнему изменении ресурса.
| Имя | Тип | Описание |
|---|---|---|
| createdAt |
string (date-time) |
Метка времени создания ресурса (UTC). |
| createdBy |
string |
Идентификатор, создавший ресурс. |
| createdByType |
Тип учётной записи, создавшей ресурс. |
|
| lastModifiedAt |
string (date-time) |
Метка времени последнего изменения ресурса (UTC) |
| lastModifiedBy |
string |
Идентификатор, который последний раз изменил ресурс. |
| lastModifiedByType |
Тип удостоверения, который последний раз изменил ресурс. |
VirtualNetworkRule
Объект правила ACL виртуальной сети
| Имя | Тип | Описание |
|---|---|---|
| id |
string (arm-id) |
Идентификатор ресурса подсети, например: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft. Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. |
| ignoreMissingVNetServiceEndpoint |
boolean |
Создайте правило брандмауэра до включения конечной точки службы виртуальной сети. |