Microsoft.DocumentDB mongo클러스터/사용자 2025-04-01-preview

Bicep 리소스 정의

mongoClusters/users 리소스 종류는 다음을 대상으로 하는 작업을 사용하여 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.DocumentDB/mongoClusters/users 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.DocumentDB/mongoClusters/users@2025-04-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    identityProvider: {
      type: 'string'
      // For remaining properties, see IdentityProvider objects
    }
    roles: [
      {
        db: 'string'
        role: 'string'
      }
    ]
  }
}

IdentityProvider 개체

형식 속성을 설정하여 개체의 형식을 지정합니다.

MicrosoftEntraID의 경우 다음을 사용합니다.

{
  properties: {
    principalType: 'string'
  }
  type: 'MicrosoftEntraID'
}

속성 값

Microsoft.DocumentDB/mongoClusters/사용자

데이터베이스 역할

엔트라아이덴티티제공자

EntraIdentityProvider속성

신원 제공자

사용자 속성

ARM 템플릿 리소스 정의

mongoClusters/users 리소스 종류는 다음을 대상으로 하는 작업을 사용하여 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.DocumentDB/mongoClusters/users 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.DocumentDB/mongoClusters/users",
  "apiVersion": "2025-04-01-preview",
  "name": "string",
  "properties": {
    "identityProvider": {
      "type": "string"
      // For remaining properties, see IdentityProvider objects
    },
    "roles": [
      {
        "db": "string",
        "role": "string"
      }
    ]
  }
}

IdentityProvider 개체

형식 속성을 설정하여 개체의 형식을 지정합니다.

MicrosoftEntraID의 경우 다음을 사용합니다.

{
  "properties": {
    "principalType": "string"
  },
  "type": "MicrosoftEntraID"
}

속성 값

Microsoft.DocumentDB/mongoClusters/사용자

데이터베이스 역할

엔트라아이덴티티제공자

EntraIdentityProvider속성

신원 제공자

사용자 속성

사용 예제

Terraform(AzAPI 공급자) 리소스 정의

mongoClusters/users 리소스 종류는 다음을 대상으로 하는 작업을 사용하여 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.DocumentDB/mongoClusters/users 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/mongoClusters/users@2025-04-01-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      identityProvider = {
        type = "string"
        // For remaining properties, see IdentityProvider objects
      }
      roles = [
        {
          db = "string"
          role = "string"
        }
      ]
    }
  }
}

IdentityProvider 개체

형식 속성을 설정하여 개체의 형식을 지정합니다.

MicrosoftEntraID의 경우 다음을 사용합니다.

{
  properties = {
    principalType = "string"
  }
  type = "MicrosoftEntraID"
}

속성 값

Microsoft.DocumentDB/mongoClusters/사용자

데이터베이스 역할

엔트라아이덴티티제공자

EntraIdentityProvider속성

신원 제공자

사용자 속성

사용 예제

Terraform 샘플

MongoDB (vCore) 사용자를 위한 Azure 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 = "westus3"
}

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

resource "azapi_resource" "userAssignedIdentity" {
  type                      = "Microsoft.ManagedIdentity/userAssignedIdentities@2023-01-31"
  parent_id                 = azapi_resource.resourceGroup.id
  name                      = var.resource_name
  location                  = var.location
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

data "azapi_client_config" "current" {}

resource "azapi_resource" "mongoClusterSSDv2" {
  type      = "Microsoft.DocumentDB/mongoClusters@2025-09-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = "${var.resource_name}-ssdv2"
  location  = var.location
  body = {
    properties = {
      authConfig = {
        allowedModes = ["MicrosoftEntraID"]
      }
      compute = {
        tier = "M30"
      }
      highAvailability = {
        targetMode = "Disabled"
      }
      serverVersion       = "6.0"
      publicNetworkAccess = "Disabled"
      sharding = {
        shardCount = 1
      }
      storage = {
        sizeGb = 64
        type   = "PremiumSSDv2"
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "mongoUser_EntraServicePrincipal" {
  type      = "Microsoft.DocumentDB/mongoClusters/users@2025-09-01"
  name      = azapi_resource.userAssignedIdentity.output.properties.principalId
  parent_id = azapi_resource.mongoClusterSSDv2.id

  body = {
    properties = {
      roles = [
        {
          role = "root"
          db   = "admin"
        }
      ]
      identityProvider = {
        type = "MicrosoftEntraID"
        properties = {
          principalType = "ServicePrincipal"
        }
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}