다음을 통해 공유


Microsoft.DocumentDB 가넷 클러스터

Bicep 리소스 정의

garnetClusters 리소스 유형은 다음을 대상으로 하는 작업과 함께 배포할 수 있습니다.

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

리소스 형식

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

resource symbolicname 'Microsoft.DocumentDB/garnetClusters@2025-11-01-preview' = {
  scope: resourceSymbolicName or scope
  location: 'string'
  name: 'string'
  properties: {
    allocationState: 'string'
    availabilityZone: bool
    clusterType: 'string'
    extensions: [
      'string'
    ]
    nodeCount: int
    nodeSku: 'string'
    provisionError: {}
    replicationFactor: int
    subnetId: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

속성 값

Microsoft.DocumentDB/garnetClusters

이름 Description 가치
location 리소스가 있는 지리적 위치 string(필수)
이름 리소스 이름 string

Constraints:
최소 길이 = 1
최대 길이 = 100
패턴 = ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$(필수)
properties Garnet 캐시 클러스터의 속성입니다. ClusterResourceProperties
scope 배포 범위와 다른 범위에서 리소스를 만들 때 사용합니다. 이 속성을 리소스의 기호 이름으로 설정하여 확장 리소스를 적용합니다.
tags 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.

ClusterResourceProperties

이름 Description 가치
할당상태 클러스터 및 데이터 센터 리소스의 할당 상태입니다. 활성은 클러스터의 가상 머신이 할당되었음을 의미하고, 할당 취소는 가상 머신과 리소스가 할당 취소됨을 의미합니다. 'Active'
'할당 취소됨'
availabilityZone(가용성) 데이터 센터에 가용성 영역이 지원되는 경우 가넷 클러스터 가상 머신을 호스트하는 Virtual Machine ScaleSet에 적용합니다. bool
clusterType 클러스터의 유형입니다. 프로덕션으로 설정하면 클러스터에서 일부 작업이 허용되지 않을 수 있습니다. 'NonProduction'
'생산'
extensions 클러스터에서 추가 또는 업데이트할 확장입니다. 문자열[]
노드 개수 노드 수 정수 (int)
노드 스쿠 클러스터에 사용되는 Virtual Machine SKU입니다. 기본값은 Standard_DS14_v2 문자열
프로비저닝 오류 리소스 프로비저닝과 관련된 오류입니다. ErrorDetailAutoGenerated
replicationFactor 클러스터에서 유지 관리하는 데이터의 복사본 수 정수 (int)
subnetId 이 클러스터의 관리 서비스에 연결된 네트워크 인터페이스가 있어야 하는 서브넷의 리소스 ID입니다. 서브넷은 데이터 센터에 위임될 모든 서브넷으로 라우팅할 수 있어야 합니다. 리소스 ID는 '/subscriptions/<구독 ID>/resourceGroups/<리소스 그룹>/providers/Microsoft.Network/virtualNetworks/<가상 네트워크>/subnets/<서브넷>형식이어야 합니다. 문자열

ErrorDetailAutoGenerated (오류 세부 정보자동 생성)

이름 Description 가치

TrackedResourceTags

이름 Description 가치

ARM 템플릿 리소스 정의

garnetClusters 리소스 유형은 다음을 대상으로 하는 작업과 함께 배포할 수 있습니다.

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

리소스 형식

Microsoft.DocumentDB/garnetClusters 리소스를 생성하려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.DocumentDB/garnetClusters",
  "apiVersion": "2025-11-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "allocationState": "string",
    "availabilityZone": "bool",
    "clusterType": "string",
    "extensions": [ "string" ],
    "nodeCount": "int",
    "nodeSku": "string",
    "provisionError": {
    },
    "replicationFactor": "int",
    "subnetId": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

속성 값

Microsoft.DocumentDB/garnetClusters

이름 Description 가치
API버전 api 버전 '2025-11-01-미리보기'
location 리소스가 있는 지리적 위치 string(필수)
이름 리소스 이름 string

Constraints:
최소 길이 = 1
최대 길이 = 100
패턴 = ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$(필수)
properties Garnet 캐시 클러스터의 속성입니다. ClusterResourceProperties
tags 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
type 리소스 종류 'Microsoft.DocumentDB/garnetClusters'

ClusterResourceProperties

이름 Description 가치
할당상태 클러스터 및 데이터 센터 리소스의 할당 상태입니다. 활성은 클러스터의 가상 머신이 할당되었음을 의미하고, 할당 취소는 가상 머신과 리소스가 할당 취소됨을 의미합니다. 'Active'
'할당 취소됨'
availabilityZone(가용성) 데이터 센터에 가용성 영역이 지원되는 경우 가넷 클러스터 가상 머신을 호스트하는 Virtual Machine ScaleSet에 적용합니다. bool
clusterType 클러스터의 유형입니다. 프로덕션으로 설정하면 클러스터에서 일부 작업이 허용되지 않을 수 있습니다. 'NonProduction'
'생산'
extensions 클러스터에서 추가 또는 업데이트할 확장입니다. 문자열[]
노드 개수 노드 수 정수 (int)
노드 스쿠 클러스터에 사용되는 Virtual Machine SKU입니다. 기본값은 Standard_DS14_v2 문자열
프로비저닝 오류 리소스 프로비저닝과 관련된 오류입니다. ErrorDetailAutoGenerated
replicationFactor 클러스터에서 유지 관리하는 데이터의 복사본 수 정수 (int)
subnetId 이 클러스터의 관리 서비스에 연결된 네트워크 인터페이스가 있어야 하는 서브넷의 리소스 ID입니다. 서브넷은 데이터 센터에 위임될 모든 서브넷으로 라우팅할 수 있어야 합니다. 리소스 ID는 '/subscriptions/<구독 ID>/resourceGroups/<리소스 그룹>/providers/Microsoft.Network/virtualNetworks/<가상 네트워크>/subnets/<서브넷>형식이어야 합니다. 문자열

ErrorDetailAutoGenerated (오류 세부 정보자동 생성)

이름 Description 가치

TrackedResourceTags

이름 Description 가치

사용 예제

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

garnetClusters 리소스 유형은 다음을 대상으로 하는 작업과 함께 배포할 수 있습니다.

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

리소스 형식

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/garnetClusters@2025-11-01-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      allocationState = "string"
      availabilityZone = bool
      clusterType = "string"
      extensions = [
        "string"
      ]
      nodeCount = int
      nodeSku = "string"
      provisionError = {
      }
      replicationFactor = int
      subnetId = "string"
    }
  }
}

속성 값

Microsoft.DocumentDB/garnetClusters

이름 Description 가치
location 리소스가 있는 지리적 위치 string(필수)
이름 리소스 이름 string

Constraints:
최소 길이 = 1
최대 길이 = 100
패턴 = ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$(필수)
parent_id 이 확장 리소스를 적용할 리소스의 ID입니다. string(필수)
properties Garnet 캐시 클러스터의 속성입니다. ClusterResourceProperties
tags 리소스 태그 태그 이름 및 값의 사전입니다.
type 리소스 종류 "Microsoft.DocumentDB/garnetClusters@2025-11-01-preview"

ClusterResourceProperties

이름 Description 가치
할당상태 클러스터 및 데이터 센터 리소스의 할당 상태입니다. 활성은 클러스터의 가상 머신이 할당되었음을 의미하고, 할당 취소는 가상 머신과 리소스가 할당 취소됨을 의미합니다. 'Active'
'할당 취소됨'
availabilityZone(가용성) 데이터 센터에 가용성 영역이 지원되는 경우 가넷 클러스터 가상 머신을 호스트하는 Virtual Machine ScaleSet에 적용합니다. bool
clusterType 클러스터의 유형입니다. 프로덕션으로 설정하면 클러스터에서 일부 작업이 허용되지 않을 수 있습니다. 'NonProduction'
'생산'
extensions 클러스터에서 추가 또는 업데이트할 확장입니다. 문자열[]
노드 개수 노드 수 정수 (int)
노드 스쿠 클러스터에 사용되는 Virtual Machine SKU입니다. 기본값은 Standard_DS14_v2 문자열
프로비저닝 오류 리소스 프로비저닝과 관련된 오류입니다. ErrorDetailAutoGenerated
replicationFactor 클러스터에서 유지 관리하는 데이터의 복사본 수 정수 (int)
subnetId 이 클러스터의 관리 서비스에 연결된 네트워크 인터페이스가 있어야 하는 서브넷의 리소스 ID입니다. 서브넷은 데이터 센터에 위임될 모든 서브넷으로 라우팅할 수 있어야 합니다. 리소스 ID는 '/subscriptions/<구독 ID>/resourceGroups/<리소스 그룹>/providers/Microsoft.Network/virtualNetworks/<가상 네트워크>/subnets/<서브넷>형식이어야 합니다. 문자열

ErrorDetailAutoGenerated (오류 세부 정보자동 생성)

이름 Description 가치

TrackedResourceTags

이름 Description 가치