Database Accounts - Update
Atualiza as propriedades de uma conta de banco de dados existente do Azure Cosmos DB.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{accountName}?api-version=2025-10-15
Parâmetros de URI
| Nome | Em | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
account
|
path | True |
string minLength: 3maxLength: 50 pattern: ^[a-z0-9]+(-[a-z0-9]+)* |
Nome da conta do banco de dados do Cosmos DB. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
|
subscription
|
path | True |
string minLength: 1 |
A ID da assinatura de destino. |
|
api-version
|
query | True |
string minLength: 1 |
A versão da API a ser usada para esta operação. |
Corpo da solicitação
| Nome | Tipo | Description |
|---|---|---|
| identity |
Identidade do recurso. |
|
| location |
string |
O local do grupo de recursos ao qual o recurso pertence. |
| properties.analyticalStorageConfiguration |
Propriedades específicas do armazenamento analítico. |
|
| properties.apiProperties |
Propriedades específicas da API. Atualmente, há suporte apenas para a API do MongoDB. |
|
| properties.backupPolicy | BackupPolicy: |
O objeto que representa a política para fazer backups em uma conta. |
| properties.capabilities |
Lista de recursos do Cosmos DB para a conta |
|
| properties.capacity |
O objeto que representa todas as propriedades relacionadas à imposição de capacidade em uma conta. |
|
| properties.connectorOffer |
O tipo de oferta do conector do Cassandra para a conta C* do banco de dados do Cosmos DB. |
|
| properties.consistencyPolicy |
A política de consistência da conta do Cosmos DB. |
|
| properties.cors |
A política CORS para a conta de banco de dados do Cosmos DB. |
|
| properties.customerManagedKeyStatus |
string |
Indica o status do recurso chave gerenciada pelo cliente na conta. Caso haja erros, a propriedade fornece diretrizes de solução de problemas. |
| properties.defaultIdentity |
string |
A identidade padrão para acessar o cofre de chaves usado em recursos como chaves gerenciadas pelo cliente. A identidade padrão precisa ser definida explicitamente pelos usuários. Pode ser "FirstPartyIdentity", "SystemAssignedIdentity" e muito mais. |
| properties.defaultPriorityLevel |
Enumerar para indicar o nível de prioridade padrão da solicitação para execução baseada em prioridade. |
|
| properties.disableKeyBasedMetadataWriteAccess |
boolean |
Desabilitar operações de gravação em recursos de metadados (bancos de dados, contêineres, taxa de transferência) por meio de chaves de conta |
| properties.disableLocalAuth |
boolean |
Opte pela autenticação local e verifique se apenas a MSI e o AAD podem ser usados exclusivamente para autenticação. |
| properties.enableAnalyticalStorage |
boolean |
Sinalizar para indicar se a análise de armazenamento deve ser habilitada. |
| properties.enableAutomaticFailover |
boolean |
Habilita o failover automático da região de gravação no evento raro em que a região está indisponível devido a uma interrupção. O failover automático resultará em uma nova região de gravação para a conta e será escolhido com base nas prioridades de failover configuradas para a conta. |
| properties.enableBurstCapacity |
boolean |
Sinalizar para indicar a habilitação/desabilitação do recurso capacidade de intermitência na conta |
| properties.enableCassandraConnector |
boolean |
Habilita o conector do Cassandra na conta do C* do Cosmos DB |
| properties.enableFreeTier |
boolean |
Sinalizar para indicar se a Camada Livre está habilitada. |
| properties.enableMultipleWriteLocations |
boolean |
Permite que a conta escreva em vários locais |
| properties.enablePartitionMerge |
boolean |
Sinalizar para indicar a habilitação/desabilitação do recurso mesclagem de partição na conta |
| properties.enablePerRegionPerPartitionAutoscale |
boolean |
Sinalizador para indicar a habilitação/desabilitação do recurso PerRegionPerPartitionAutoscale na conta |
| properties.enablePriorityBasedExecution |
boolean |
Sinalizar para indicar a habilitação/desabilitação do recurso de Visualização de Execução Baseada em Prioridade na conta |
| properties.ipRules |
Lista de IpRules. |
|
| properties.isVirtualNetworkFilterEnabled |
boolean |
Sinalizar para indicar se as regras de ACL da Rede Virtual devem ser habilitadas/desabilitadas. |
| properties.keyVaultKeyUri |
string |
O URI do cofre de chaves |
| properties.locations |
Location[] |
Uma matriz que contém os locais de georeplicação habilitados para a conta do Cosmos DB. |
| properties.minimalTlsVersion |
Indica a versão mínima de TLS permitida. O valor padrão é Tls 1.2. As APIs cassandra e mongo só funcionam com tls 1.2. |
|
| properties.networkAclBypass |
Indica quais serviços têm permissão para ignorar verificações de firewall. |
|
| properties.networkAclBypassResourceIds |
string[] |
Uma matriz que contém as IDs de Recurso para Bypass de Acl de Rede para a conta do Cosmos DB. |
| properties.publicNetworkAccess |
Se as solicitações da Rede Pública são permitidas |
|
| properties.virtualNetworkRules |
Lista de regras de ACL de Rede Virtual configuradas para a conta do Cosmos DB. |
|
| tags |
object |
As tags são uma lista de pares de chave-valor que descrevem o recurso. Essas marcas podem ser usadas na exibição e agrupamento desse recurso (entre grupos de recursos). Um máximo de 15 marcas pode ser fornecido para um recurso. Cada marca deve ter uma chave não maior que 128 caracteres e o valor não seja maior que 256 caracteres. Por exemplo, a experiência padrão para um tipo de modelo é definida com "defaultExperience": "Cassandra". Os valores atuais de "defaultExperience" também incluem "Tabela", "Gráfico", "Banco de Dados de Documentos" e "MongoDB". |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
A operação de atualização da conta de banco de dados será concluída de forma assíncrona. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Escopos
| Nome | Description |
|---|---|
| user_impersonation | Representar sua conta de usuário |
Exemplos
CosmosDBDatabaseAccountPatch
Solicitação de exemplo
PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.DocumentDB/databaseAccounts/ddb1?api-version=2025-10-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,
"minimalTlsVersion": "Tls"
}
}
Resposta de exemplo
{
"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,
"minimalTlsVersion": "Tls"
}
}
Definições
| Nome | Description |
|---|---|
|
Account |
Os metadados relacionados a uma chave de acesso para uma determinada conta de banco de dados. |
|
Analytical |
Propriedades específicas do armazenamento analítico. |
|
Analytical |
Descreve os tipos de esquema para armazenamento analítico. |
|
Api |
|
|
Backup |
O objeto que representa o estado da migração entre as políticas de backup. |
|
Backup |
Descreve o status da migração entre tipos de política de backup. |
|
Backup |
Descreve o modo de backups. |
|
Backup |
Enumeração para indicar o tipo de redundância de armazenamento de backup. |
| Capability |
Objeto de funcionalidade do Cosmos DB |
| Capacity |
O objeto que representa todas as propriedades relacionadas à imposição de capacidade em uma conta. |
|
Connector |
O tipo de oferta do conector cassandra para a conta de banco de dados C* do Cosmos DB. |
|
Consistency |
A política de consistência para a conta de banco de dados do Cosmos DB. |
|
Continuous |
O objeto que representa a política de backup de modo contínuo. |
|
Continuous |
Valores de configuração para backup de modo periódico |
|
Continuous |
Enumeração para indicar o tipo de camada de backup contínuo. |
|
Cors |
A política CORS para a conta de banco de dados do Cosmos DB. |
|
created |
O tipo de identidade que criou o recurso. |
|
Create |
Enumerar para indicar o modo de criação da conta. |
|
Database |
Uma conta de banco de dados do Azure Cosmos DB. |
|
Database |
Os metadados relacionados a cada chave de acesso para a conta de banco de dados do Cosmos DB fornecida. |
|
Database |
Indica o tipo de conta de banco de dados. Isso só pode ser definido na criação da conta de banco de dados. |
|
Database |
O tipo de oferta para a conta de banco de dados do Cosmos DB. |
|
Database |
Parâmetros para aplicar patches nas propriedades da conta de banco de dados do Azure Cosmos DB. |
|
Database |
Bases de dados específicas para restaurar. |
|
Default |
O nível de consistência padrão e as configurações da conta do Cosmos DB. |
|
Default |
Enumeração para indicar prioridade padrãoNível de solicitações |
|
Failover |
A política de failover para uma determinada região de uma conta de banco de dados. |
|
Gremlin |
Bancos de dados específicos do Gremlin para restaurar. |
|
Ip |
Objeto IpAddressOrRange |
| Location |
Uma região na qual a conta de banco de dados do Azure Cosmos DB é implantada. |
|
Managed |
Identidade do recurso. |
|
Minimal |
Indica a versão mínima de TLS permitida. O valor padrão é Tls 1.2. As APIs cassandra e mongo só funcionam com tls 1.2. |
|
Network |
Indica quais serviços têm permissão para ignorar verificações de firewall. |
|
Periodic |
O objeto que representa a política de backup de modo periódico. |
|
Periodic |
Valores de configuração para backup de modo periódico |
|
Private |
Uma conexão de ponto de extremidade privado |
|
Private |
Ponto de extremidade privado ao qual a conexão pertence. |
|
Private |
Estado de conexão da conexão de ponto de extremidade privado. |
|
Public |
Se as solicitações da Rede Pública são permitidas |
|
Resource |
O tipo de identidade usado para o recurso. O tipo 'SystemAssigned,UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'None' removerá as identidades do serviço. |
|
Restore |
Descreve o modo da restauração. |
|
Restore |
Parâmetros para indicar as informações sobre a restauração. |
|
Server |
Descreve a versão da conta do MongoDB. |
|
system |
Metadados relativos à criação e última modificação do recurso. |
|
User |
A lista de identidades de usuário associadas ao recurso. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
|
Virtual |
Objeto de regra de ACL de rede virtual |
AccountKeyMetadata
Os metadados relacionados a uma chave de acesso para uma determinada conta de banco de dados.
| Nome | Tipo | Description |
|---|---|---|
| generationTime |
string (date-time) |
Tempo de geração em UTC da chave no formato ISO-8601. Se o valor estiver ausente do objeto, significa que a última regeneração de chave foi acionada antes de 2022-06-18. |
AnalyticalStorageConfiguration
Propriedades específicas do armazenamento analítico.
| Nome | Tipo | Description |
|---|---|---|
| schemaType |
Descreve os tipos de esquema para armazenamento analítico. |
AnalyticalStorageSchemaType
Descreve os tipos de esquema para armazenamento analítico.
| Valor | Description |
|---|---|
| WellDefined | |
| FullFidelity |
ApiProperties
| Nome | Tipo | Description |
|---|---|---|
| serverVersion |
Descreve a versão da conta do MongoDB. |
BackupPolicyMigrationState
O objeto que representa o estado da migração entre as políticas de backup.
| Nome | Tipo | Description |
|---|---|---|
| startTime |
string (date-time) |
Hora em que a migração da política de backup foi iniciada (formato ISO-8601). |
| status |
Descreve o status da migração entre tipos de política de backup. |
|
| targetType |
Descreve o tipo de política de backup de destino da migração da política de backup. |
BackupPolicyMigrationStatus
Descreve o status da migração entre tipos de política de backup.
| Valor | Description |
|---|---|
| Invalid | |
| InProgress | |
| Completed | |
| Failed |
BackupPolicyType
Descreve o modo de backups.
| Valor | Description |
|---|---|
| Periodic | |
| Continuous |
BackupStorageRedundancy
Enumeração para indicar o tipo de redundância de armazenamento de backup.
| Valor | Description |
|---|---|
| Geo | |
| Local | |
| Zone |
Capability
Objeto de funcionalidade do Cosmos DB
| Nome | Tipo | Description |
|---|---|---|
| name |
string |
Nome da funcionalidade do Cosmos DB. Por exemplo, "name": "EnableCassandra". Os valores atuais também incluem "EnableTable" e "EnableGremlin". |
Capacity
O objeto que representa todas as propriedades relacionadas à imposição de capacidade em uma conta.
| Nome | Tipo | Description |
|---|---|---|
| totalThroughputLimit |
integer (int32) minimum: -1 |
O limite total de taxa de transferência imposto na conta. Um totalthroughputLimit de 2000 impõe um limite estrito de taxa de transferência máxima que pode ser provisionado nessa conta para 2000. Um totalThroughputLimit de -1 não indica limites de provisionamento de taxa de transferência. |
ConnectorOffer
O tipo de oferta do conector cassandra para a conta de banco de dados C* do Cosmos DB.
| Valor | Description |
|---|---|
| Small |
ConsistencyPolicy
A política de consistência para a conta de banco de dados do Cosmos DB.
| Nome | Tipo | Description |
|---|---|---|
| defaultConsistencyLevel |
O nível de consistência padrão e as configurações da conta do Cosmos DB. |
|
| maxIntervalInSeconds |
integer (int32) minimum: 5maximum: 86400 |
Quando usado com o nível de consistência de Desatualização Limitada, esse valor representa o tempo de desatualização (em segundos) tolerado. O intervalo aceito para esse valor é de 5 a 86400. Necessário quando defaultConsistencyPolicy é definido como 'BoundedStaleness'. |
| maxStalenessPrefix |
integer (int64) minimum: 1maximum: 2147483647 |
Quando usado com o nível de consistência Desatualização Limitada, esse valor representa o número de solicitações obsoletas toleradas. O intervalo aceito para esse valor é 1 – 2.147.483.647. Necessário quando defaultConsistencyPolicy é definido como 'BoundedStaleness'. |
ContinuousModeBackupPolicy
O objeto que representa a política de backup de modo contínuo.
| Nome | Tipo | Description |
|---|---|---|
| continuousModeProperties |
Valores de configuração para backup de modo contínuo |
|
| migrationState |
O objeto que representa o estado da migração entre as políticas de backup. |
|
| type |
string:
Continuous |
Descreve o modo de backups. |
ContinuousModeProperties
Valores de configuração para backup de modo periódico
| Nome | Tipo | Description |
|---|---|---|
| tier |
Enumeração para indicar o tipo de modo de backup contínuo |
ContinuousTier
Enumeração para indicar o tipo de camada de backup contínuo.
| Valor | Description |
|---|---|
| Continuous7Days | |
| Continuous30Days |
CorsPolicy
A política CORS para a conta de banco de dados do Cosmos DB.
| Nome | Tipo | Description |
|---|---|---|
| allowedHeaders |
string |
Os cabeçalhos de solicitação que o domínio de origem pode especificar na solicitação CORS. |
| allowedMethods |
string |
Os métodos (verbos de solicitação HTTP) que o domínio de origem pode usar para uma solicitação CORS. |
| allowedOrigins |
string |
Os domínios de origem que têm permissão para fazer uma solicitação no serviço por meio do CORS. |
| exposedHeaders |
string |
Os cabeçalhos de resposta que podem ser enviados na resposta à solicitação CORS e expostos pelo navegador ao emissor da solicitação. |
| maxAgeInSeconds |
integer (int64) minimum: 1maximum: 2147483647 |
O tempo máximo de tempo que um navegador deve armazenar em cache a solicitação OPTIONS de pré-vôo. |
createdByType
O tipo de identidade que criou o recurso.
| Valor | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
CreateMode
Enumerar para indicar o modo de criação da conta.
| Valor | Description |
|---|---|
| Default | |
| Restore |
DatabaseAccountGetResults
Uma conta de banco de dados do Azure Cosmos DB.
| Nome | Tipo | Valor padrão | Description |
|---|---|---|---|
| id |
string |
O identificador de recurso exclusivo do recurso do ARM. |
|
| identity |
Identidade do recurso. |
||
| kind | GlobalDocumentDB |
Indica o tipo de conta de banco de dados. Isso só pode ser definido na criação da conta de banco de dados. |
|
| location |
string |
O local do grupo de recursos ao qual o recurso pertence. |
|
| name |
string |
O nome do recurso do ARM. |
|
| properties.analyticalStorageConfiguration |
Propriedades específicas do armazenamento analítico. |
||
| properties.apiProperties |
Propriedades específicas da API. |
||
| properties.backupPolicy | BackupPolicy: |
O objeto que representa a política para fazer backups em uma conta. |
|
| properties.capabilities |
Lista de recursos do Cosmos DB para a conta |
||
| properties.capacity |
O objeto que representa todas as propriedades relacionadas à imposição de capacidade em uma conta. |
||
| properties.connectorOffer |
O tipo de oferta do conector do Cassandra para a conta C* do banco de dados do Cosmos DB. |
||
| properties.consistencyPolicy |
A política de consistência para a conta de banco de dados do Cosmos DB. |
||
| properties.cors |
A política CORS para a conta de banco de dados do Cosmos DB. |
||
| properties.createMode | Default |
Enumerar para indicar o modo de criação da conta. |
|
| properties.customerManagedKeyStatus |
string |
Indica o status do recurso chave gerenciada pelo cliente na conta. Caso haja erros, a propriedade fornece diretrizes de solução de problemas. |
|
| properties.databaseAccountOfferType |
O tipo de oferta para a conta de banco de dados do Cosmos DB. Valor padrão: Padrão. |
||
| properties.defaultIdentity |
string |
A identidade padrão para acessar o cofre de chaves usado em recursos como chaves gerenciadas pelo cliente. A identidade padrão precisa ser definida explicitamente pelos usuários. Pode ser "FirstPartyIdentity", "SystemAssignedIdentity" e muito mais. |
|
| properties.defaultPriorityLevel |
Enumerar para indicar o nível de prioridade padrão da solicitação para execução baseada em prioridade. |
||
| properties.disableKeyBasedMetadataWriteAccess |
boolean |
Desabilitar operações de gravação em recursos de metadados (bancos de dados, contêineres, taxa de transferência) por meio de chaves de conta |
|
| properties.disableLocalAuth |
boolean |
Opte pela autenticação local e verifique se apenas a MSI e o AAD podem ser usados exclusivamente para autenticação. |
|
| properties.documentEndpoint |
string |
O ponto de extremidade de conexão para a conta de banco de dados do Cosmos DB. |
|
| properties.enableAnalyticalStorage |
boolean |
Sinalizar para indicar se a análise de armazenamento deve ser habilitada. |
|
| properties.enableAutomaticFailover |
boolean |
Habilita o failover automático da região de gravação no evento raro em que a região está indisponível devido a uma interrupção. O failover automático resultará em uma nova região de gravação para a conta e será escolhido com base nas prioridades de failover configuradas para a conta. |
|
| properties.enableBurstCapacity |
boolean |
Sinalizar para indicar a habilitação/desabilitação do recurso capacidade de intermitência na conta |
|
| properties.enableCassandraConnector |
boolean |
Habilita o conector do Cassandra na conta do C* do Cosmos DB |
|
| properties.enableFreeTier |
boolean |
Sinalizar para indicar se a Camada Livre está habilitada. |
|
| properties.enableMultipleWriteLocations |
boolean |
Permite que a conta escreva em vários locais |
|
| properties.enablePartitionMerge |
boolean |
Sinalizar para indicar a habilitação/desabilitação do recurso mesclagem de partição na conta |
|
| properties.enablePerRegionPerPartitionAutoscale |
boolean |
Sinalizador para indicar a habilitação/desabilitação do recurso PerRegionPerPartitionAutoscale na conta |
|
| properties.enablePriorityBasedExecution |
boolean |
Sinalizar para indicar a habilitação/desabilitação do recurso de Visualização de Execução Baseada em Prioridade na conta |
|
| properties.failoverPolicies |
Uma matriz que contém as regiões ordenadas por suas prioridades de failover. |
||
| properties.instanceId |
string |
Um identificador exclusivo atribuído à conta de banco de dados |
|
| properties.ipRules |
Lista de IpRules. |
||
| properties.isVirtualNetworkFilterEnabled |
boolean |
Sinalizar para indicar se as regras de ACL da Rede Virtual devem ser habilitadas/desabilitadas. |
|
| properties.keyVaultKeyUri |
string |
O URI do cofre de chaves |
|
| properties.keyVaultKeyUriVersion |
string |
A versão da Chave Gerenciada pelo Cliente que está sendo usada atualmente pela conta |
|
| properties.keysMetadata |
O objeto que representa os metadados para as chaves de conta da conta do Cosmos DB. |
||
| properties.locations |
Location[] |
Uma matriz que contém todos os locais habilitados para a conta do Cosmos DB. |
|
| properties.minimalTlsVersion |
Indica a versão mínima de TLS permitida. O valor padrão é Tls 1.2. As APIs cassandra e mongo só funcionam com tls 1.2. |
||
| properties.networkAclBypass |
Indica quais serviços têm permissão para ignorar verificações de firewall. |
||
| properties.networkAclBypassResourceIds |
string[] (arm-id) |
Uma matriz que contém as IDs de Recurso para Bypass de Acl de Rede para a conta do Cosmos DB. |
|
| properties.privateEndpointConnections |
Lista de conexões de ponto de extremidade privado configuradas para a conta do Cosmos DB. |
||
| properties.provisioningState |
string |
O status da conta do Cosmos DB no momento em que a operação foi chamada. O status pode ser um dos seguintes. 'Criando' – a conta do Cosmos DB está sendo criada. Quando uma conta está no estado Criando, somente as propriedades especificadas como entrada para a operação Criar conta do Cosmos DB são retornadas. 'Bem-sucedido' – a conta do Cosmos DB está ativa para uso. 'Atualizando' – a conta do Cosmos DB está sendo atualizada. 'Excluir' – a conta do Cosmos DB está sendo excluída. 'Falha' – a conta do Cosmos DB falhou na criação. 'DeletionFailed' – falha na exclusão da conta do Cosmos DB. |
|
| properties.publicNetworkAccess |
Se as solicitações da Rede Pública são permitidas |
||
| properties.readLocations |
Location[] |
Uma matriz que contém os locais de leitura habilitados para a conta do Cosmos DB. |
|
| properties.restoreParameters |
Parâmetros para indicar as informações sobre a restauração. |
||
| properties.virtualNetworkRules |
Lista de regras de ACL de Rede Virtual configuradas para a conta do Cosmos DB. |
||
| properties.writeLocations |
Location[] |
Uma matriz que contém o local de gravação da conta do Cosmos DB. |
|
| systemData |
Os metadados do sistema relacionados a esse recurso. |
||
| tags |
object |
As tags são uma lista de pares de chave-valor que descrevem o recurso. Essas marcas podem ser usadas na exibição e agrupamento desse recurso (entre grupos de recursos). Um máximo de 15 marcas pode ser fornecido para um recurso. Cada marca deve ter uma chave não maior que 128 caracteres e o valor não seja maior que 256 caracteres. Por exemplo, a experiência padrão para um tipo de modelo é definida com "defaultExperience": "Cassandra". Os valores atuais de "defaultExperience" também incluem "Tabela", "Gráfico", "Banco de Dados de Documentos" e "MongoDB". |
|
| type |
string |
O tipo de recurso do Azure. |
DatabaseAccountKeysMetadata
Os metadados relacionados a cada chave de acesso para a conta de banco de dados do Cosmos DB fornecida.
| Nome | Tipo | Description |
|---|---|---|
| primaryMasterKey |
Os metadados relacionados à chave de Read-Write primária para a conta de banco de dados do Cosmos DB fornecida. |
|
| primaryReadonlyMasterKey |
Os metadados relacionados à chave de Read-Only primária para a conta de banco de dados do Cosmos DB fornecida. |
|
| secondaryMasterKey |
Os metadados relacionados à Chave de Read-Write Secundária para a conta de banco de dados do Cosmos DB fornecida. |
|
| secondaryReadonlyMasterKey |
Os metadados relacionados à Chave de Read-Only Secundária para a conta de banco de dados do Cosmos DB fornecida. |
DatabaseAccountKind
Indica o tipo de conta de banco de dados. Isso só pode ser definido na criação da conta de banco de dados.
| Valor | Description |
|---|---|
| GlobalDocumentDB | |
| MongoDB | |
| Parse |
DatabaseAccountOfferType
O tipo de oferta para a conta de banco de dados do Cosmos DB.
| Valor | Description |
|---|---|
| Standard |
DatabaseAccountUpdateParameters
Parâmetros para aplicar patches nas propriedades da conta de banco de dados do Azure Cosmos DB.
| Nome | Tipo | Description |
|---|---|---|
| identity |
Identidade do recurso. |
|
| location |
string |
O local do grupo de recursos ao qual o recurso pertence. |
| properties.analyticalStorageConfiguration |
Propriedades específicas do armazenamento analítico. |
|
| properties.apiProperties |
Propriedades específicas da API. Atualmente, há suporte apenas para a API do MongoDB. |
|
| properties.backupPolicy | BackupPolicy: |
O objeto que representa a política para fazer backups em uma conta. |
| properties.capabilities |
Lista de recursos do Cosmos DB para a conta |
|
| properties.capacity |
O objeto que representa todas as propriedades relacionadas à imposição de capacidade em uma conta. |
|
| properties.connectorOffer |
O tipo de oferta do conector do Cassandra para a conta C* do banco de dados do Cosmos DB. |
|
| properties.consistencyPolicy |
A política de consistência da conta do Cosmos DB. |
|
| properties.cors |
A política CORS para a conta de banco de dados do Cosmos DB. |
|
| properties.customerManagedKeyStatus |
string |
Indica o status do recurso chave gerenciada pelo cliente na conta. Caso haja erros, a propriedade fornece diretrizes de solução de problemas. |
| properties.defaultIdentity |
string |
A identidade padrão para acessar o cofre de chaves usado em recursos como chaves gerenciadas pelo cliente. A identidade padrão precisa ser definida explicitamente pelos usuários. Pode ser "FirstPartyIdentity", "SystemAssignedIdentity" e muito mais. |
| properties.defaultPriorityLevel |
Enumerar para indicar o nível de prioridade padrão da solicitação para execução baseada em prioridade. |
|
| properties.disableKeyBasedMetadataWriteAccess |
boolean |
Desabilitar operações de gravação em recursos de metadados (bancos de dados, contêineres, taxa de transferência) por meio de chaves de conta |
| properties.disableLocalAuth |
boolean |
Opte pela autenticação local e verifique se apenas a MSI e o AAD podem ser usados exclusivamente para autenticação. |
| properties.enableAnalyticalStorage |
boolean |
Sinalizar para indicar se a análise de armazenamento deve ser habilitada. |
| properties.enableAutomaticFailover |
boolean |
Habilita o failover automático da região de gravação no evento raro em que a região está indisponível devido a uma interrupção. O failover automático resultará em uma nova região de gravação para a conta e será escolhido com base nas prioridades de failover configuradas para a conta. |
| properties.enableBurstCapacity |
boolean |
Sinalizar para indicar a habilitação/desabilitação do recurso capacidade de intermitência na conta |
| properties.enableCassandraConnector |
boolean |
Habilita o conector do Cassandra na conta do C* do Cosmos DB |
| properties.enableFreeTier |
boolean |
Sinalizar para indicar se a Camada Livre está habilitada. |
| properties.enableMultipleWriteLocations |
boolean |
Permite que a conta escreva em vários locais |
| properties.enablePartitionMerge |
boolean |
Sinalizar para indicar a habilitação/desabilitação do recurso mesclagem de partição na conta |
| properties.enablePerRegionPerPartitionAutoscale |
boolean |
Sinalizador para indicar a habilitação/desabilitação do recurso PerRegionPerPartitionAutoscale na conta |
| properties.enablePriorityBasedExecution |
boolean |
Sinalizar para indicar a habilitação/desabilitação do recurso de Visualização de Execução Baseada em Prioridade na conta |
| properties.ipRules |
Lista de IpRules. |
|
| properties.isVirtualNetworkFilterEnabled |
boolean |
Sinalizar para indicar se as regras de ACL da Rede Virtual devem ser habilitadas/desabilitadas. |
| properties.keyVaultKeyUri |
string |
O URI do cofre de chaves |
| properties.keysMetadata |
Essa propriedade é ignorada durante a operação de atualização, pois os metadados são somente leitura. O objeto representa os metadados das Chaves de Conta da conta do Cosmos DB. |
|
| properties.locations |
Location[] |
Uma matriz que contém os locais de georeplicação habilitados para a conta do Cosmos DB. |
| properties.minimalTlsVersion |
Indica a versão mínima de TLS permitida. O valor padrão é Tls 1.2. As APIs cassandra e mongo só funcionam com tls 1.2. |
|
| properties.networkAclBypass |
Indica quais serviços têm permissão para ignorar verificações de firewall. |
|
| properties.networkAclBypassResourceIds |
string[] |
Uma matriz que contém as IDs de Recurso para Bypass de Acl de Rede para a conta do Cosmos DB. |
| properties.publicNetworkAccess |
Se as solicitações da Rede Pública são permitidas |
|
| properties.virtualNetworkRules |
Lista de regras de ACL de Rede Virtual configuradas para a conta do Cosmos DB. |
|
| tags |
object |
As tags são uma lista de pares de chave-valor que descrevem o recurso. Essas marcas podem ser usadas na exibição e agrupamento desse recurso (entre grupos de recursos). Um máximo de 15 marcas pode ser fornecido para um recurso. Cada marca deve ter uma chave não maior que 128 caracteres e o valor não seja maior que 256 caracteres. Por exemplo, a experiência padrão para um tipo de modelo é definida com "defaultExperience": "Cassandra". Os valores atuais de "defaultExperience" também incluem "Tabela", "Gráfico", "Banco de Dados de Documentos" e "MongoDB". |
DatabaseRestoreResource
Bases de dados específicas para restaurar.
| Nome | Tipo | Description |
|---|---|---|
| collectionNames |
string[] |
Os nomes das coleções disponíveis para restauração. |
| databaseName |
string |
O nome do banco de dados disponível para restauração. |
DefaultConsistencyLevel
O nível de consistência padrão e as configurações da conta do Cosmos DB.
| Valor | Description |
|---|---|
| Eventual | |
| Session | |
| BoundedStaleness | |
| Strong | |
| ConsistentPrefix |
DefaultPriorityLevel
Enumeração para indicar prioridade padrãoNível de solicitações
| Valor | Description |
|---|---|
| High | |
| Low |
FailoverPolicy
A política de failover para uma determinada região de uma conta de banco de dados.
| Nome | Tipo | Description |
|---|---|---|
| failoverPriority |
integer (int32) minimum: 0 |
A prioridade de failover da região. Uma prioridade de failover de 0 indica uma região de gravação. O valor máximo para uma prioridade de failover = (número total de regiões – 1). Os valores de prioridade de failover devem ser exclusivos para cada uma das regiões nas quais a conta de banco de dados existe. |
| id |
string |
O identificador exclusivo da região para a qual a conta de banco de dados é replicada. Exemplo: <accountName-locationName<>>. |
| locationName |
string |
O nome da região em que a conta de banco de dados existe. |
GremlinDatabaseRestoreResource
Bancos de dados específicos do Gremlin para restaurar.
| Nome | Tipo | Description |
|---|---|---|
| databaseName |
string |
O nome do banco de dados gremlin disponível para restauração. |
| graphNames |
string[] |
Os nomes dos grafos disponíveis para restauração. |
IpAddressOrRange
Objeto IpAddressOrRange
| Nome | Tipo | Description |
|---|---|---|
| ipAddressOrRange |
string |
Um único endereço IPv4 ou um único intervalo de endereços IPv4 no formato CIDR. Os IPs fornecidos devem ser bem formatados e não podem ser contidos em um dos seguintes intervalos: 10.0.0.0/8, 100.64.0.0/10, 172.16.0.0/12, 192.168.0.0/16, pois eles não são aplicáveis pelo filtro de endereço IP. Exemplo de entradas válidas: "23.40.210.245" ou "23.40.210.0/8". |
Location
Uma região na qual a conta de banco de dados do Azure Cosmos DB é implantada.
| Nome | Tipo | Description |
|---|---|---|
| documentEndpoint |
string |
O ponto de extremidade de conexão para a região específica. Exemplo: https://< accountName-locationName.documents.azure.com:443/><> |
| failoverPriority |
integer (int32) minimum: 0 |
A prioridade de failover da região. Uma prioridade de failover de 0 indica uma região de gravação. O valor máximo para uma prioridade de failover = (número total de regiões – 1). Os valores de prioridade de failover devem ser exclusivos para cada uma das regiões nas quais a conta de banco de dados existe. |
| id |
string |
O identificador exclusivo da região dentro da conta de banco de dados. Exemplo: <accountName-locationName<>>. |
| isZoneRedundant |
boolean |
Sinalizador para indicar se essa região é ou não uma região de AvailabilityZone |
| locationName |
string |
O nome da região. |
| provisioningState |
string |
O status da conta do Cosmos DB no momento em que a operação foi chamada. O status pode ser um dos seguintes. 'Criando' – a conta do Cosmos DB está sendo criada. Quando uma conta está no estado Criando, somente as propriedades especificadas como entrada para a operação Criar conta do Cosmos DB são retornadas. 'Bem-sucedido' – a conta do Cosmos DB está ativa para uso. 'Atualizando' – a conta do Cosmos DB está sendo atualizada. 'Excluir' – a conta do Cosmos DB está sendo excluída. 'Falha' – a conta do Cosmos DB falhou na criação. 'DeletionFailed' – falha na exclusão da conta do Cosmos DB. |
ManagedServiceIdentity
Identidade do recurso.
| Nome | Tipo | Description |
|---|---|---|
| principalId |
string |
A ID principal da identidade atribuída ao sistema. Essa propriedade será fornecida apenas para uma identidade atribuída pelo sistema. |
| tenantId |
string |
A ID do locatário da identidade atribuída pelo sistema. Essa propriedade será fornecida apenas para uma identidade atribuída pelo sistema. |
| type |
O tipo de identidade usado para o recurso. O tipo 'SystemAssigned,UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'None' removerá as identidades do serviço. |
|
| userAssignedIdentities |
A lista de identidades de usuário associadas ao recurso. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
MinimalTlsVersion
Indica a versão mínima de TLS permitida. O valor padrão é Tls 1.2. As APIs cassandra e mongo só funcionam com tls 1.2.
| Valor | Description |
|---|---|
| Tls | |
| Tls11 | |
| Tls12 |
NetworkAclBypass
Indica quais serviços têm permissão para ignorar verificações de firewall.
| Valor | Description |
|---|---|
| None | |
| AzureServices |
PeriodicModeBackupPolicy
O objeto que representa a política de backup de modo periódico.
| Nome | Tipo | Description |
|---|---|---|
| migrationState |
O objeto que representa o estado da migração entre as políticas de backup. |
|
| periodicModeProperties |
Valores de configuração para backup de modo periódico |
|
| type |
string:
Periodic |
Descreve o modo de backups. |
PeriodicModeProperties
Valores de configuração para backup de modo periódico
| Nome | Tipo | Description |
|---|---|---|
| backupIntervalInMinutes |
integer (int32) minimum: 0 |
Um inteiro que representa o intervalo em minutos entre dois backups |
| backupRetentionIntervalInHours |
integer (int32) minimum: 0 |
Um inteiro que representa o tempo (em horas) em que cada backup é mantido |
| backupStorageRedundancy |
Enumeração para indicar o tipo de residência de backup |
PrivateEndpointConnection
Uma conexão de ponto de extremidade privado
| Nome | Tipo | Description |
|---|---|---|
| id |
string |
ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| name |
string |
O nome do recurso |
| properties.groupId |
string |
ID do grupo do ponto de extremidade privado. |
| properties.privateEndpoint |
Ponto de extremidade privado ao qual a conexão pertence. |
|
| properties.privateLinkServiceConnectionState |
Estado de conexão da conexão de ponto de extremidade privado. |
|
| properties.provisioningState |
string |
Estado de provisionamento do ponto de extremidade privado. |
| type |
string |
O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
PrivateEndpointProperty
Ponto de extremidade privado ao qual a conexão pertence.
| Nome | Tipo | Description |
|---|---|---|
| id |
string |
ID do recurso do ponto de extremidade privado. |
PrivateLinkServiceConnectionStateProperty
Estado de conexão da conexão de ponto de extremidade privado.
| Nome | Tipo | Description |
|---|---|---|
| actionsRequired |
string |
Qualquer ação necessária além do fluxo de trabalho básico (aprovar/rejeitar/desconectar) |
| description |
string |
A descrição da conexão do serviço de link privado. |
| status |
string |
O status da conexão do serviço de link privado. |
PublicNetworkAccess
Se as solicitações da Rede Pública são permitidas
| Valor | Description |
|---|---|
| Enabled | |
| Disabled | |
| SecuredByPerimeter |
ResourceIdentityType
O tipo de identidade usado para o recurso. O tipo 'SystemAssigned,UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'None' removerá as identidades do serviço.
| Valor | Description |
|---|---|
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned,UserAssigned | |
| None |
RestoreMode
Descreve o modo da restauração.
| Valor | Description |
|---|---|
| PointInTime |
RestoreParameters
Parâmetros para indicar as informações sobre a restauração.
| Nome | Tipo | Description |
|---|---|---|
| databasesToRestore |
Lista de bancos de dados específicos disponíveis para restauração. |
|
| gremlinDatabasesToRestore |
Lista de bancos de dados gremlin específicos disponíveis para restauração. |
|
| restoreMode |
Descreve o modo da restauração. |
|
| restoreSource |
string |
A ID da conta de banco de dados restaurável da qual a restauração deve ser iniciada. Por exemplo: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} |
| restoreTimestampInUtc |
string (date-time) |
Tempo para o qual a conta precisa ser restaurada (formato ISO-8601). |
| restoreWithTtlDisabled |
boolean |
Especifica se a conta restaurada terá o TempoTo-Live desabilitado após a restauração bem-sucedida. |
| sourceBackupLocation |
string |
O local de backup de origem para restauração. |
| tablesToRestore |
string[] |
Lista de tabelas específicas disponíveis para restauração. |
ServerVersion
Descreve a versão da conta do MongoDB.
| Valor | Description |
|---|---|
| 3.2 | |
| 3.6 | |
| 4.0 | |
| 4.2 | |
| 5.0 | |
| 6.0 | |
| 7.0 |
systemData
Metadados relativos à criação e última modificação do recurso.
| Nome | Tipo | Description |
|---|---|---|
| createdAt |
string (date-time) |
O carimbo de data/hora da criação de recursos (UTC). |
| createdBy |
string |
A identidade que criou o recurso. |
| createdByType |
O tipo de identidade que criou o recurso. |
|
| lastModifiedAt |
string (date-time) |
O carimbo de data/hora da última modificação do recurso (UTC) |
| lastModifiedBy |
string |
A identidade que modificou o recurso pela última vez. |
| lastModifiedByType |
O tipo de identidade que modificou o recurso pela última vez. |
UserAssignedIdentities
A lista de identidades de usuário associadas ao recurso. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
| Nome | Tipo | Description |
|---|---|---|
|
|
VirtualNetworkRule
Objeto de regra de ACL de rede virtual
| Nome | Tipo | Description |
|---|---|---|
| id |
string (arm-id) |
ID de recurso de uma sub-rede, por exemplo: /subscriptions/{subscriptionId}/resourceGroups/{groupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}. |
| ignoreMissingVNetServiceEndpoint |
boolean |
Crie uma regra de firewall antes que a rede virtual tenha o ponto de extremidade de serviço da vnet habilitado. |