Udostępnij przez


Microsoft.DocumentDB DatabaseAccounts/services

Definicja zasobu Bicep

Typ zasobu databaseAccounts/services można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DocumentDB/databaseAccounts/services, dodaj następujący kod Bicep do szablonu.

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts/services@2025-11-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    instanceCount: int
    instanceSize: 'string'
    serviceType: 'string'
    // For remaining properties, see ServiceResourceCreateUpdatePropertiesOrServiceResourceProperties objects
  }
}

ServiceResourceCreateUpdatePropertiesOrServiceResourceProperties, obiekty

Ustaw właściwość serviceType, aby określić typ obiektu.

W przypadku DataTransferużyj:

{
  serviceType: 'DataTransfer'
}

W przypadku GraphAPIComputeużyj:

{
  serviceType: 'GraphAPICompute'
}

W przypadku MaterializedViewsBuilderużyj:

{
  serviceType: 'MaterializedViewsBuilder'
}

W przypadku sqlDedicatedGatewayużyj:

{
  dedicatedGatewayType: 'string'
  serviceType: 'SqlDedicatedGateway'
}

Wartości właściwości

Microsoft.DocumentDB/databaseAccounts/services

Nazwa Opis Wartość
nazwa Nazwa zasobu struna

Ograniczenia:
Minimalna długość = 3
Maksymalna długość = 50 (wymagane)
nadrzędny W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym.

Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym.
Nazwa symboliczna zasobu typu: databaseAccounts
Właściwości Właściwości w usłudze ServiceResourceCreateUpdateParameters. ServiceResourceCreateUpdatePropertiesOrServiceResourceProperties

DataTransferServiceResourceCreateUpdatePropertiesOrDataTransferServiceResourceProperties

Nazwa Opis Wartość
typ usługi ServiceType dla usługi. "Transfer danych" (wymagany)

GraphAPIComputeServiceResourceCreateUpdatePropertiesOrGraphAPIComputeServiceResourceProperties

Nazwa Opis Wartość
typ usługi ServiceType dla usługi. "GraphAPICompute" (wymagane)

MaterializedViewsBuilderServiceResourceCreateUpdatePropertiesOrMaterializedViewsBuilderServiceResourceProperties

Nazwa Opis Wartość
typ usługi ServiceType dla usługi. "MaterializedViewsBuilder" (wymagane)

ServiceResourceCreateUpdatePropertiesOrServiceResourceProperties

Nazwa Opis Wartość
instanceCount (liczba wystąpień) Liczba wystąpień usługi. Int

Ograniczenia:
Minimalna wartość = 0
instanceSize (rozmiar wystąpienia) Typ wystąpienia usługi. "Cosmos.D16s"
"Cosmos.D4s"
"Cosmos.D8s"
typ usługi Ustaw wartość "DataTransfer" dla typu DataTransferServiceResourceCreateUpdatePropertiesOrDataTransferServiceResourceProperties. Ustaw wartość "GraphAPICompute" dla typu GraphAPIComputeServiceResourceCreateUpdatePropertiesOrGraphAPIComputeServiceResourceProperties. Ustaw wartość "MaterializedViewsBuilder" dla typu MaterializedViewsBuilderServiceResourceCreateUpdatePropertiesOrMaterializedViewsBuilderServiceResourceProperties. Ustaw wartość "SqlDedicatedGateway" dla typu SqlDedicatedGatewayServiceResourceCreateUpdatePropertiesOrSqlDedicatedGatewayServiceResourceProperties. "DataTransfer"
"GraphAPICompute"
"MaterializedViewsBuilder"
"SqlDedicatedGateway" (wymagane)

SqlDedicatedGatewayServiceResourceCreateUpdatePropertiesOrSqlDedicatedGatewayServiceResourceProperties

Nazwa Opis Wartość
dedicatedGatewayType DedicatedGatewayType dla usługi. "DistributedQuery"
"IntegratedCache"
typ usługi ServiceType dla usługi. "SqlDedicatedGateway" (wymagane)

Definicja zasobu szablonu usługi ARM

Typ zasobu databaseAccounts/services można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DocumentDB/databaseAccounts/services, dodaj następujący kod JSON do szablonu.

{
  "type": "Microsoft.DocumentDB/databaseAccounts/services",
  "apiVersion": "2025-11-01-preview",
  "name": "string",
  "properties": {
    "instanceCount": "int",
    "instanceSize": "string",
    "serviceType": "string"
    // For remaining properties, see ServiceResourceCreateUpdatePropertiesOrServiceResourceProperties objects
  }
}

ServiceResourceCreateUpdatePropertiesOrServiceResourceProperties, obiekty

Ustaw właściwość serviceType, aby określić typ obiektu.

W przypadku DataTransferużyj:

{
  "serviceType": "DataTransfer"
}

W przypadku GraphAPIComputeużyj:

{
  "serviceType": "GraphAPICompute"
}

W przypadku MaterializedViewsBuilderużyj:

{
  "serviceType": "MaterializedViewsBuilder"
}

W przypadku sqlDedicatedGatewayużyj:

{
  "dedicatedGatewayType": "string",
  "serviceType": "SqlDedicatedGateway"
}

Wartości właściwości

Microsoft.DocumentDB/databaseAccounts/services

Nazwa Opis Wartość
apiVersion (wersja interfejsu api) Wersja interfejsu API "2025-11-01-podgląd"
nazwa Nazwa zasobu struna

Ograniczenia:
Minimalna długość = 3
Maksymalna długość = 50 (wymagane)
Właściwości Właściwości w usłudze ServiceResourceCreateUpdateParameters. ServiceResourceCreateUpdatePropertiesOrServiceResourceProperties
typ Typ zasobu "Microsoft.DocumentDB/databaseAccounts/services"

DataTransferServiceResourceCreateUpdatePropertiesOrDataTransferServiceResourceProperties

Nazwa Opis Wartość
typ usługi ServiceType dla usługi. "Transfer danych" (wymagany)

GraphAPIComputeServiceResourceCreateUpdatePropertiesOrGraphAPIComputeServiceResourceProperties

Nazwa Opis Wartość
typ usługi ServiceType dla usługi. "GraphAPICompute" (wymagane)

MaterializedViewsBuilderServiceResourceCreateUpdatePropertiesOrMaterializedViewsBuilderServiceResourceProperties

Nazwa Opis Wartość
typ usługi ServiceType dla usługi. "MaterializedViewsBuilder" (wymagane)

ServiceResourceCreateUpdatePropertiesOrServiceResourceProperties

Nazwa Opis Wartość
instanceCount (liczba wystąpień) Liczba wystąpień usługi. Int

Ograniczenia:
Minimalna wartość = 0
instanceSize (rozmiar wystąpienia) Typ wystąpienia usługi. "Cosmos.D16s"
"Cosmos.D4s"
"Cosmos.D8s"
typ usługi Ustaw wartość "DataTransfer" dla typu DataTransferServiceResourceCreateUpdatePropertiesOrDataTransferServiceResourceProperties. Ustaw wartość "GraphAPICompute" dla typu GraphAPIComputeServiceResourceCreateUpdatePropertiesOrGraphAPIComputeServiceResourceProperties. Ustaw wartość "MaterializedViewsBuilder" dla typu MaterializedViewsBuilderServiceResourceCreateUpdatePropertiesOrMaterializedViewsBuilderServiceResourceProperties. Ustaw wartość "SqlDedicatedGateway" dla typu SqlDedicatedGatewayServiceResourceCreateUpdatePropertiesOrSqlDedicatedGatewayServiceResourceProperties. "DataTransfer"
"GraphAPICompute"
"MaterializedViewsBuilder"
"SqlDedicatedGateway" (wymagane)

SqlDedicatedGatewayServiceResourceCreateUpdatePropertiesOrSqlDedicatedGatewayServiceResourceProperties

Nazwa Opis Wartość
dedicatedGatewayType DedicatedGatewayType dla usługi. "DistributedQuery"
"IntegratedCache"
typ usługi ServiceType dla usługi. "SqlDedicatedGateway" (wymagane)

Przykłady użycia

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu databaseAccounts/services można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DocumentDB/databaseAccounts/services, dodaj następujący program Terraform do szablonu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/databaseAccounts/services@2025-11-01-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      instanceCount = int
      instanceSize = "string"
      serviceType = "string"
      // For remaining properties, see ServiceResourceCreateUpdatePropertiesOrServiceResourceProperties objects
    }
  }
}

ServiceResourceCreateUpdatePropertiesOrServiceResourceProperties, obiekty

Ustaw właściwość serviceType, aby określić typ obiektu.

W przypadku DataTransferużyj:

{
  serviceType = "DataTransfer"
}

W przypadku GraphAPIComputeużyj:

{
  serviceType = "GraphAPICompute"
}

W przypadku MaterializedViewsBuilderużyj:

{
  serviceType = "MaterializedViewsBuilder"
}

W przypadku sqlDedicatedGatewayużyj:

{
  dedicatedGatewayType = "string"
  serviceType = "SqlDedicatedGateway"
}

Wartości właściwości

Microsoft.DocumentDB/databaseAccounts/services

Nazwa Opis Wartość
nazwa Nazwa zasobu struna

Ograniczenia:
Minimalna długość = 3
Maksymalna długość = 50 (wymagane)
parent_id (identyfikator rodzica) Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. Identyfikator zasobu typu: databaseAccounts
Właściwości Właściwości w usłudze ServiceResourceCreateUpdateParameters. ServiceResourceCreateUpdatePropertiesOrServiceResourceProperties
typ Typ zasobu "Microsoft.DocumentDB/databaseAccounts/services@2025-11-01-preview"

DataTransferServiceResourceCreateUpdatePropertiesOrDataTransferServiceResourceProperties

Nazwa Opis Wartość
typ usługi ServiceType dla usługi. "Transfer danych" (wymagany)

GraphAPIComputeServiceResourceCreateUpdatePropertiesOrGraphAPIComputeServiceResourceProperties

Nazwa Opis Wartość
typ usługi ServiceType dla usługi. "GraphAPICompute" (wymagane)

MaterializedViewsBuilderServiceResourceCreateUpdatePropertiesOrMaterializedViewsBuilderServiceResourceProperties

Nazwa Opis Wartość
typ usługi ServiceType dla usługi. "MaterializedViewsBuilder" (wymagane)

ServiceResourceCreateUpdatePropertiesOrServiceResourceProperties

Nazwa Opis Wartość
instanceCount (liczba wystąpień) Liczba wystąpień usługi. Int

Ograniczenia:
Minimalna wartość = 0
instanceSize (rozmiar wystąpienia) Typ wystąpienia usługi. "Cosmos.D16s"
"Cosmos.D4s"
"Cosmos.D8s"
typ usługi Ustaw wartość "DataTransfer" dla typu DataTransferServiceResourceCreateUpdatePropertiesOrDataTransferServiceResourceProperties. Ustaw wartość "GraphAPICompute" dla typu GraphAPIComputeServiceResourceCreateUpdatePropertiesOrGraphAPIComputeServiceResourceProperties. Ustaw wartość "MaterializedViewsBuilder" dla typu MaterializedViewsBuilderServiceResourceCreateUpdatePropertiesOrMaterializedViewsBuilderServiceResourceProperties. Ustaw wartość "SqlDedicatedGateway" dla typu SqlDedicatedGatewayServiceResourceCreateUpdatePropertiesOrSqlDedicatedGatewayServiceResourceProperties. "DataTransfer"
"GraphAPICompute"
"MaterializedViewsBuilder"
"SqlDedicatedGateway" (wymagane)

SqlDedicatedGatewayServiceResourceCreateUpdatePropertiesOrSqlDedicatedGatewayServiceResourceProperties

Nazwa Opis Wartość
dedicatedGatewayType DedicatedGatewayType dla usługi. "DistributedQuery"
"IntegratedCache"
typ usługi ServiceType dla usługi. "SqlDedicatedGateway" (wymagane)

Przykłady użycia

Przykłady programu Terraform

Podstawowy przykład wdrażania dedykowanej bramy SQL w ramach konta usługi Cosmos DB.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "databaseAccount" {
  type      = "Microsoft.DocumentDB/databaseAccounts@2021-10-15"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    kind = "GlobalDocumentDB"
    properties = {
      capabilities = [
      ]
      consistencyPolicy = {
        defaultConsistencyLevel = "BoundedStaleness"
        maxIntervalInSeconds    = 5
        maxStalenessPrefix      = 100
      }
      databaseAccountOfferType           = "Standard"
      defaultIdentity                    = "FirstPartyIdentity"
      disableKeyBasedMetadataWriteAccess = false
      disableLocalAuth                   = false
      enableAnalyticalStorage            = false
      enableAutomaticFailover            = false
      enableFreeTier                     = false
      enableMultipleWriteLocations       = false
      ipRules = [
      ]
      isVirtualNetworkFilterEnabled = false
      locations = [
        {
          failoverPriority = 0
          isZoneRedundant  = false
          locationName     = "West Europe"
        },
      ]
      networkAclBypass = "None"
      networkAclBypassResourceIds = [
      ]
      publicNetworkAccess = "Enabled"
      virtualNetworkRules = [
      ]
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "service" {
  type      = "Microsoft.DocumentDB/databaseAccounts/services@2022-05-15"
  parent_id = azapi_resource.databaseAccount.id
  name      = "SqlDedicatedGateway"
  body = {
    properties = {
      instanceCount = 1
      instanceSize  = "Cosmos.D4s"
      serviceType   = "SqlDedicatedGateway"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}