Microsoft.CognitiveServices 계정/배포 2024-04-01-preview

아티클
02/25/2025

Bicep 리소스 정의

다음을 대상으로 하는 작업으로 계정/배포 리소스 유형을 배포할 수 있습니다.

리소스 그룹 - 리소스 그룹 배포 명령 참조

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

리소스 형식

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

resource symbolicname 'Microsoft.CognitiveServices/accounts/deployments@2024-04-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    capacitySettings: {
      designatedCapacity: int
      priority: int
    }
    currentCapacity: int
    model: {
      format: 'string'
      name: 'string'
      source: 'string'
      version: 'string'
    }
    raiPolicyName: 'string'
    scaleSettings: {
      capacity: int
      scaleType: 'string'
    }
    versionUpgradeOption: 'string'
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

속성 값

DeploymentCapacitySettings

이름	묘사	값
designatedCapacity	지정된 용량입니다.	int 제약 조건: 최소값 = 0
우선권	이 용량 설정의 우선 순위입니다.	int 제약 조건: 최소값 = 0

DeploymentModel

이름	묘사	값
판	배포 모델 형식입니다.	문자열
이름	배포 모델 이름입니다.	문자열
근원	선택적. 배포 모델 원본 ARM 리소스 ID입니다.	문자열
버전	선택적. 배포 모델 버전입니다. 버전을 지정하지 않으면 기본 버전이 할당됩니다. 기본 버전은 모델에 따라 다르며 모델에 사용할 수 있는 새 버전이 있는 경우 변경될 수 있습니다. 모델의 기본 버전은 목록 모델 API에서 찾을 수 있습니다.	문자열

DeploymentProperties

이름	묘사	값
capacitySettings	내부 전용입니다.	DeploymentCapacitySettings
currentCapacity	현재 용량입니다.	int
모델	Cognitive Services 계정 배포 모델의 속성입니다.	DeploymentModel
raiPolicyName	RAI 정책의 이름입니다.	문자열
scaleSettings	Cognitive Services 계정 배포 모델의 속성입니다. (사용되지 않음, Deployment.sku를 대신 사용하세요.)	DeploymentScaleSettings
versionUpgradeOption	배포 모델 버전 업그레이드 옵션입니다.	'NoAutoUpgrade' 'OnceCurrentVersionExpired' 'OnceNewDefaultVersionAvailable'

DeploymentScaleSettings

이름	묘사	값
용량	배포 용량.	int
scaleType	배포 크기 조정 유형입니다.	'수동' 'Standard'

DeploymentTags

이름	묘사	값

Microsoft.CognitiveServices/accounts/deployments

이름	묘사	값
이름	리소스 이름	string(필수)
부모	Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가해야 합니다. 자세한 내용은 부모 리소스외부의 자식 리소스 참조하세요.	형식 리소스의 기호 이름: 계정
속성	Cognitive Services 계정 배포의 속성입니다.	DeploymentProperties
sku	SKU를 나타내는 리소스 모델 정의	Sku
태그	리소스 태그	태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.

Sku

이름	묘사	값
용량	SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다.	int
가족	서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다.	문자열
이름	SKU의 이름입니다. 예 - P3. 일반적으로 letter+number 코드입니다.	string(필수)
크기	SKU 크기입니다. 이름 필드가 계층과 다른 값의 조합인 경우 독립 실행형 코드입니다.	문자열
계층	이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다.	'기본' 'Enterprise' '무료' '프리미엄' 'Standard'

사용 예제

Azure 빠른 시작 샘플

다음 Azure 빠른 시작 템플릿에는 이 리소스 유형을 배포하기 위한 Bicep 샘플이 포함되어 있습니다.

Bicep 파일	묘사
기본 에이전트 설정 API 키	이 템플릿 집합은 AI 서비스/AOAI 연결에 대한 API 키 인증을 사용하여 기본 설정으로 Azure AI 에이전트 서비스를 설정하는 방법을 보여 줍니다. 에이전트는 Microsoft에서 완전히 관리하는 다중 테넌트 검색 및 스토리지 리소스를 사용합니다. 이러한 기본 Azure 리소스를 표시하거나 제어할 수 없습니다.
기본 에이전트 설치 ID	이 템플릿 집합은 AI 서비스/AOAI 연결에 대한 관리 ID 인증을 사용하여 기본 설정으로 Azure AI 에이전트 서비스를 설정하는 방법을 보여 줍니다. 에이전트는 Microsoft에서 완전히 관리하는 다중 테넌트 검색 및 스토리지 리소스를 사용합니다. 이러한 기본 Azure 리소스를 표시하거나 제어할 수 없습니다.
관리형 가상 네트워크 사용하여 보안 Azure AI Studio 배포	이 템플릿은 강력한 네트워크 및 ID 보안 제한을 사용하여 안전한 Azure AI Studio 환경을 만듭니다.
사용자 관리 ID 사용하여 네트워크 보안 에이전트	이 템플릿 집합은 AI 서비스/AOAI 연결에 대한 사용자 관리 ID 인증을 사용하여 가상 네트워크 격리로 Azure AI 에이전트 서비스를 설정하고 프라이빗 네트워크 링크를 설정하여 에이전트를 보안 데이터에 연결하는 방법을 보여 줍니다.
표준 에이전트 설치	이 템플릿 집합은 표준 설정으로 Azure AI 에이전트 서비스를 설정하는 방법을 보여 줍니다. 즉, 프로젝트/허브 연결에 대한 관리 ID 인증 및 공용 인터넷 액세스를 사용하도록 설정했습니다. 에이전트는 고객 소유의 단일 테넌트 검색 및 스토리지 리소스를 사용합니다. 이 설정을 사용하면 이러한 리소스에 대한 모든 권한과 가시성이 있지만 사용량에 따라 비용이 발생합니다.

ARM 템플릿 리소스 정의

다음을 대상으로 하는 작업으로 계정/배포 리소스 유형을 배포할 수 있습니다.

리소스 그룹 - 리소스 그룹 배포 명령 참조

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

리소스 형식

Microsoft.CognitiveServices/accounts/deployments 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.CognitiveServices/accounts/deployments",
  "apiVersion": "2024-04-01-preview",
  "name": "string",
  "properties": {
    "capacitySettings": {
      "designatedCapacity": "int",
      "priority": "int"
    },
    "currentCapacity": "int",
    "model": {
      "format": "string",
      "name": "string",
      "source": "string",
      "version": "string"
    },
    "raiPolicyName": "string",
    "scaleSettings": {
      "capacity": "int",
      "scaleType": "string"
    },
    "versionUpgradeOption": "string"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

속성 값

DeploymentCapacitySettings

이름	묘사	값
designatedCapacity	지정된 용량입니다.	int 제약 조건: 최소값 = 0
우선권	이 용량 설정의 우선 순위입니다.	int 제약 조건: 최소값 = 0

DeploymentModel

이름	묘사	값
판	배포 모델 형식입니다.	문자열
이름	배포 모델 이름입니다.	문자열
근원	선택적. 배포 모델 원본 ARM 리소스 ID입니다.	문자열
버전	선택적. 배포 모델 버전입니다. 버전을 지정하지 않으면 기본 버전이 할당됩니다. 기본 버전은 모델에 따라 다르며 모델에 사용할 수 있는 새 버전이 있는 경우 변경될 수 있습니다. 모델의 기본 버전은 목록 모델 API에서 찾을 수 있습니다.	문자열

DeploymentProperties

이름	묘사	값
capacitySettings	내부 전용입니다.	DeploymentCapacitySettings
currentCapacity	현재 용량입니다.	int
모델	Cognitive Services 계정 배포 모델의 속성입니다.	DeploymentModel
raiPolicyName	RAI 정책의 이름입니다.	문자열
scaleSettings	Cognitive Services 계정 배포 모델의 속성입니다. (사용되지 않음, Deployment.sku를 대신 사용하세요.)	DeploymentScaleSettings
versionUpgradeOption	배포 모델 버전 업그레이드 옵션입니다.	'NoAutoUpgrade' 'OnceCurrentVersionExpired' 'OnceNewDefaultVersionAvailable'

DeploymentScaleSettings

이름	묘사	값
용량	배포 용량.	int
scaleType	배포 크기 조정 유형입니다.	'수동' 'Standard'

DeploymentTags

이름	묘사	값

Microsoft.CognitiveServices/accounts/deployments

이름	묘사	값
apiVersion	api 버전	'2024-04-01-preview'
이름	리소스 이름	string(필수)
속성	Cognitive Services 계정 배포의 속성입니다.	DeploymentProperties
sku	SKU를 나타내는 리소스 모델 정의	Sku
태그	리소스 태그	태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
형	리소스 종류	'Microsoft.CognitiveServices/accounts/deployments'

Sku

이름	묘사	값
용량	SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다.	int
가족	서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다.	문자열
이름	SKU의 이름입니다. 예 - P3. 일반적으로 letter+number 코드입니다.	string(필수)
크기	SKU 크기입니다. 이름 필드가 계층과 다른 값의 조합인 경우 독립 실행형 코드입니다.	문자열
계층	이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다.	'기본' 'Enterprise' '무료' '프리미엄' 'Standard'

사용 예제

Azure 빠른 시작 템플릿

다음 Azure 빠른 시작 템플릿은 이 리소스 유형을 배포할 있습니다.

템플렛	묘사
기본 에이전트 설정 API 키 Azure 배포	이 템플릿 집합은 AI 서비스/AOAI 연결에 대한 API 키 인증을 사용하여 기본 설정으로 Azure AI 에이전트 서비스를 설정하는 방법을 보여 줍니다. 에이전트는 Microsoft에서 완전히 관리하는 다중 테넌트 검색 및 스토리지 리소스를 사용합니다. 이러한 기본 Azure 리소스를 표시하거나 제어할 수 없습니다.
기본 에이전트 설치 ID Azure 배포	이 템플릿 집합은 AI 서비스/AOAI 연결에 대한 관리 ID 인증을 사용하여 기본 설정으로 Azure AI 에이전트 서비스를 설정하는 방법을 보여 줍니다. 에이전트는 Microsoft에서 완전히 관리하는 다중 테넌트 검색 및 스토리지 리소스를 사용합니다. 이러한 기본 Azure 리소스를 표시하거나 제어할 수 없습니다.
관리형 가상 네트워크 사용하여 보안 Azure AI Studio 배포 Azure 배포	이 템플릿은 강력한 네트워크 및 ID 보안 제한을 사용하여 안전한 Azure AI Studio 환경을 만듭니다.
사용자 관리 ID 사용하여 네트워크 보안 에이전트 Azure 배포	이 템플릿 집합은 AI 서비스/AOAI 연결에 대한 사용자 관리 ID 인증을 사용하여 가상 네트워크 격리로 Azure AI 에이전트 서비스를 설정하고 프라이빗 네트워크 링크를 설정하여 에이전트를 보안 데이터에 연결하는 방법을 보여 줍니다.
표준 에이전트 설치 Azure 배포	이 템플릿 집합은 표준 설정으로 Azure AI 에이전트 서비스를 설정하는 방법을 보여 줍니다. 즉, 프로젝트/허브 연결에 대한 관리 ID 인증 및 공용 인터넷 액세스를 사용하도록 설정했습니다. 에이전트는 고객 소유의 단일 테넌트 검색 및 스토리지 리소스를 사용합니다. 이 설정을 사용하면 이러한 리소스에 대한 모든 권한과 가시성이 있지만 사용량에 따라 비용이 발생합니다.

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

다음을 대상으로 하는 작업으로 계정/배포 리소스 유형을 배포할 수 있습니다.

리소스 그룹

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

리소스 형식

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.CognitiveServices/accounts/deployments@2024-04-01-preview"
  name = "string"
  sku = {
    capacity = int
    family = "string"
    name = "string"
    size = "string"
    tier = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      capacitySettings = {
        designatedCapacity = int
        priority = int
      }
      currentCapacity = int
      model = {
        format = "string"
        name = "string"
        source = "string"
        version = "string"
      }
      raiPolicyName = "string"
      scaleSettings = {
        capacity = int
        scaleType = "string"
      }
      versionUpgradeOption = "string"
    }
  })
}

속성 값

DeploymentCapacitySettings

이름	묘사	값
designatedCapacity	지정된 용량입니다.	int 제약 조건: 최소값 = 0
우선권	이 용량 설정의 우선 순위입니다.	int 제약 조건: 최소값 = 0

DeploymentModel

이름	묘사	값
판	배포 모델 형식입니다.	문자열
이름	배포 모델 이름입니다.	문자열
근원	선택적. 배포 모델 원본 ARM 리소스 ID입니다.	문자열
버전	선택적. 배포 모델 버전입니다. 버전을 지정하지 않으면 기본 버전이 할당됩니다. 기본 버전은 모델에 따라 다르며 모델에 사용할 수 있는 새 버전이 있는 경우 변경될 수 있습니다. 모델의 기본 버전은 목록 모델 API에서 찾을 수 있습니다.	문자열

DeploymentProperties

이름	묘사	값
capacitySettings	내부 전용입니다.	DeploymentCapacitySettings
currentCapacity	현재 용량입니다.	int
모델	Cognitive Services 계정 배포 모델의 속성입니다.	DeploymentModel
raiPolicyName	RAI 정책의 이름입니다.	문자열
scaleSettings	Cognitive Services 계정 배포 모델의 속성입니다. (사용되지 않음, Deployment.sku를 대신 사용하세요.)	DeploymentScaleSettings
versionUpgradeOption	배포 모델 버전 업그레이드 옵션입니다.	'NoAutoUpgrade' 'OnceCurrentVersionExpired' 'OnceNewDefaultVersionAvailable'

DeploymentScaleSettings

이름	묘사	값
용량	배포 용량.	int
scaleType	배포 크기 조정 유형입니다.	'수동' 'Standard'

DeploymentTags

이름	묘사	값

Microsoft.CognitiveServices/accounts/deployments

이름	묘사	값
이름	리소스 이름	string(필수)
parent_id	이 리소스의 부모인 리소스의 ID입니다.	유형의 리소스 ID: 계정
속성	Cognitive Services 계정 배포의 속성입니다.	DeploymentProperties
sku	SKU를 나타내는 리소스 모델 정의	Sku
태그	리소스 태그	태그 이름 및 값의 사전입니다.
형	리소스 종류	"Microsoft.CognitiveServices/accounts/deployments@2024-04-01-preview"

Sku

이름	묘사	값
용량	SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다.	int
가족	서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다.	문자열
이름	SKU의 이름입니다. 예 - P3. 일반적으로 letter+number 코드입니다.	string(필수)
크기	SKU 크기입니다. 이름 필드가 계층과 다른 값의 조합인 경우 독립 실행형 코드입니다.	문자열
계층	이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다.	'기본' 'Enterprise' '무료' '프리미엄' 'Standard'

다음을 통해 공유

Microsoft.CognitiveServices 계정/배포 2024-04-01-preview

Bicep 리소스 정의

리소스 형식

속성 값

DeploymentCapacitySettings

DeploymentModel

DeploymentProperties

DeploymentScaleSettings

DeploymentTags

Microsoft.CognitiveServices/accounts/deployments

Sku

사용 예제

Azure 빠른 시작 샘플

ARM 템플릿 리소스 정의

리소스 형식

속성 값

DeploymentCapacitySettings

DeploymentModel

DeploymentProperties

DeploymentScaleSettings

DeploymentTags

Microsoft.CognitiveServices/accounts/deployments

Sku

사용 예제

Azure 빠른 시작 템플릿

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

리소스 형식

속성 값

DeploymentCapacitySettings

DeploymentModel

DeploymentProperties

DeploymentScaleSettings

DeploymentTags

Microsoft.CognitiveServices/accounts/deployments

Sku

피드백

추가 리소스