Bicep 자원 정의
계정/프로젝트/애플리케이션 리소스 유형은 다음을 대상으로 하는 작업과 함께 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 참조
각 API 버전의 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft를 만드는 것. CognitiveServices/accounts/projects/applications 리소스, 템플릿에 다음 Bicep를 추가하세요.
resource symbolicname 'Microsoft.CognitiveServices/accounts/projects/applications@2026-05-15-preview' = {
parent: resourceSymbolicName
name: 'string'
properties: {
agentIdentityBlueprint: {
clientId: 'string'
kind: 'string'
principalId: 'string'
subject: 'string'
tenantId: 'string'
type: 'string'
}
agents: [
{
agentId: 'string'
agentName: 'string'
}
]
authorizationPolicy: {
type: 'string'
// For remaining properties, see ApplicationAuthorizationPolicy objects
}
baseUrl: 'string'
defaultInstanceIdentity: {
clientId: 'string'
kind: 'string'
principalId: 'string'
subject: 'string'
tenantId: 'string'
type: 'string'
}
description: 'string'
displayName: 'string'
tags: {
{customized property}: 'string'
}
trafficRoutingPolicy: {
protocol: 'string'
rules: [
{
deploymentId: 'string'
description: 'string'
ruleId: 'string'
trafficPercentage: int
}
]
}
}
}
ApplicationAuthorizationPolicy 개체
형식 속성을 설정하여 개체의 형식을 지정합니다.
채널의 경우, 다음을 사용하세요:
{
type: 'Channels'
}
기본경우 다음을 사용합니다.
{
type: 'Default'
}
OrganizationScope의 경우 다음을 사용합니다.
{
type: 'OrganizationScope'
}
속성 값
Microsoft. CognitiveServices/계정/프로젝트/애플리케이션
| 이름 | Description | 가치 |
|---|---|---|
| 이름 | 리소스 이름 | 문자열(필수) |
| parent | Bicep에서는 자식 리소스의 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가해야 합니다. 자세한 내용은 부모 리소스외부의 자식 리소스 |
형식 리소스의 기호 이름: 계정/프로젝트 |
| properties | [필수] 엔터티의 추가 특성입니다. | AgenticApplicationProperties (필수) |
에이전트 적용 속성
| 이름 | Description | 가치 |
|---|---|---|
| agentIdentityBlueprint | 애플리케이션의 EntraId 에이전트 블루프린트입니다. | 할당된 ID |
| agents | 이 애플리케이션을 구성하는 에이전트 정의 목록으로, 상위 프로젝트 아래의 개체에 대한 참조로 반환됩니다. 이 응용 프로그램에서 나타내는 모든 에이전트-버전 쌍의 플랫 목록을 가져오려면 이 옵션을 사용합니다. | 에이전트 참조속성[] |
| 권한 부여 정책 | 이 에이전트 애플리케이션 인스턴스와 연관된 권한 부여 정책을 가져오거나 설정합니다. | 응용 프로그램 권한 부여 정책 |
| baseUrl | 애플리케이션의 전용 호출 엔드포인트입니다. | 문자열 |
| defaultInstanceIdentity | 애플리케이션의 (기본) 에이전트 인스턴스 ID입니다. | 할당된 ID |
| description | 자산 설명 텍스트입니다. | 문자열 |
| 표시 이름 | 애플리케이션의 표시 이름입니다. | 문자열 |
| tags | 태그 사전입니다. 태그를 추가, 제거 및 업데이트할 수 있습니다. | ResourceBaseTags |
| 트래픽라우팅 정책 | 애플리케이션의 배포에 대한 트래픽 라우팅 정책을 가져오거나 설정합니다. | ApplicationTrafficRoutingPolicy |
에이전트참조속성
| 이름 | Description | 가치 |
|---|---|---|
| agentId | 조직(구독) 내에서 에이전트의 고유 식별자를 가져옵니다. | 문자열 |
| 에이전트 이름 | 에이전트의 이름(프로젝트/앱 내에서 고유함)을 가져옵니다. | 문자열 |
응용 프로그램 권한 부여 정책
| 이름 | Description | 가치 |
|---|---|---|
| type | ChannelsBuiltInAuthorizationPolicy 유형을 'Channels'로 설정하세요. RoleBasedBuiltInAuthorizationPolicy 형식에 대해 '기본값'으로 설정합니다. OrganizationSharedBuiltInAuthorizationPolicy 형식에 대해 'OrganizationScope'로 설정합니다. | '채널' 'Default' 'OrganizationScope'(필수) |
ApplicationTrafficRoutingPolicy
| 이름 | Description | 가치 |
|---|---|---|
| protocol | 애플리케이션의 배포로 트래픽을 라우팅하는 데 사용되는 방법론입니다. | '고정비율' |
| 규칙 | 트래픽 라우팅 규칙의 컬렉션을 가져오거나 설정합니다. | 트래픽 라우팅 규칙[] |
할당된 ID
| 이름 | Description | 가치 |
|---|---|---|
| clientId | ID의 클라이언트 ID입니다. | 문자열(필수) |
| 친절한 | 이 개체에서 설명하는 Entra ID의 종류를 지정합니다. | '에이전트 블루프린트' '에이전트 사용자' '에이전트 인스턴스' 'Managed' 'None'(필수) |
| principalId | ID의 주체 ID입니다. | 문자열(필수) |
| 제목 | 이 ID 할당의 주체입니다. | 문자열 |
| tenantId | ID의 테넌트 ID입니다. | 문자열(필수) |
| type | 관리 관점에서 ID 유형 열거. | 'None' 'System' 'User'(필수) |
채널 내장인권한정책(ChannelsBuiltInAuthorizationPolicy)
| 이름 | Description | 가치 |
|---|---|---|
| type | 권한 부여 체계 유형입니다. | '채널' (필수) |
OrganizationSharedBuiltInAuthorizationPolicy
| 이름 | Description | 가치 |
|---|---|---|
| type | 권한 부여 체계 유형입니다. | 'OrganizationScope'(필수) |
ResourceBaseTags
| 이름 | Description | 가치 |
|---|
RoleBasedBuiltInAuthorizationPolicy
| 이름 | Description | 가치 |
|---|---|---|
| type | 권한 부여 체계 유형입니다. | 'Default'(필수) |
트래픽라우팅 규칙
| 이름 | Description | 가치 |
|---|---|---|
| deploymentId | 이 규칙에 의해 트래픽이 라우팅되는 배포의 고유 식별자입니다. | 문자열 |
| description | 이 트래픽 라우팅 규칙에 대한 사용자 제공 설명입니다. | 문자열 |
| ruleId입니다 | 이 트래픽 라우팅 규칙의 식별자입니다. | 문자열 |
| 트래픽백분율 | 이 인스턴스에 할당된 트래픽의 백분율을 가져오거나 설정합니다. | 정수 (int) |
ARM 템플릿 리소스 정의
계정/프로젝트/애플리케이션 리소스 유형은 다음을 대상으로 하는 작업과 함께 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 어를 참조하세요. 각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
사용 예제
리소스 형식
Microsoft를 만드는 것. CognitiveServices/accounts/projects/applications 리소스, 템플릿에 다음 JSON 파일을 추가하세요.
{
"type": "Microsoft.CognitiveServices/accounts/projects/applications",
"apiVersion": "2026-05-15-preview",
"name": "string",
"properties": {
"agentIdentityBlueprint": {
"clientId": "string",
"kind": "string",
"principalId": "string",
"subject": "string",
"tenantId": "string",
"type": "string"
},
"agents": [
{
"agentId": "string",
"agentName": "string"
}
],
"authorizationPolicy": {
"type": "string"
// For remaining properties, see ApplicationAuthorizationPolicy objects
},
"baseUrl": "string",
"defaultInstanceIdentity": {
"clientId": "string",
"kind": "string",
"principalId": "string",
"subject": "string",
"tenantId": "string",
"type": "string"
},
"description": "string",
"displayName": "string",
"tags": {
"{customized property}": "string"
},
"trafficRoutingPolicy": {
"protocol": "string",
"rules": [
{
"deploymentId": "string",
"description": "string",
"ruleId": "string",
"trafficPercentage": "int"
}
]
}
}
}
ApplicationAuthorizationPolicy 개체
형식 속성을 설정하여 개체의 형식을 지정합니다.
채널의 경우, 다음을 사용하세요:
{
"type": "Channels"
}
기본경우 다음을 사용합니다.
{
"type": "Default"
}
OrganizationScope의 경우 다음을 사용합니다.
{
"type": "OrganizationScope"
}
속성 값
Microsoft. CognitiveServices/계정/프로젝트/애플리케이션
| 이름 | Description | 가치 |
|---|---|---|
| API버전 | api 버전 | '2026-05-15-미리보기 |
| 이름 | 리소스 이름 | 문자열(필수) |
| properties | [필수] 엔터티의 추가 특성입니다. | AgenticApplicationProperties (필수) |
| type | 리소스 종류 | 'Microsoft. CognitiveServices/계정/프로젝트/애플리케이션' |
에이전트 적용 속성
| 이름 | Description | 가치 |
|---|---|---|
| agentIdentityBlueprint | 애플리케이션의 EntraId 에이전트 블루프린트입니다. | 할당된 ID |
| agents | 이 애플리케이션을 구성하는 에이전트 정의 목록으로, 상위 프로젝트 아래의 개체에 대한 참조로 반환됩니다. 이 응용 프로그램에서 나타내는 모든 에이전트-버전 쌍의 플랫 목록을 가져오려면 이 옵션을 사용합니다. | 에이전트 참조속성[] |
| 권한 부여 정책 | 이 에이전트 애플리케이션 인스턴스와 연관된 권한 부여 정책을 가져오거나 설정합니다. | 응용 프로그램 권한 부여 정책 |
| baseUrl | 애플리케이션의 전용 호출 엔드포인트입니다. | 문자열 |
| defaultInstanceIdentity | 애플리케이션의 (기본) 에이전트 인스턴스 ID입니다. | 할당된 ID |
| description | 자산 설명 텍스트입니다. | 문자열 |
| 표시 이름 | 애플리케이션의 표시 이름입니다. | 문자열 |
| tags | 태그 사전입니다. 태그를 추가, 제거 및 업데이트할 수 있습니다. | ResourceBaseTags |
| 트래픽라우팅 정책 | 애플리케이션의 배포에 대한 트래픽 라우팅 정책을 가져오거나 설정합니다. | ApplicationTrafficRoutingPolicy |
에이전트참조속성
| 이름 | Description | 가치 |
|---|---|---|
| agentId | 조직(구독) 내에서 에이전트의 고유 식별자를 가져옵니다. | 문자열 |
| 에이전트 이름 | 에이전트의 이름(프로젝트/앱 내에서 고유함)을 가져옵니다. | 문자열 |
응용 프로그램 권한 부여 정책
| 이름 | Description | 가치 |
|---|---|---|
| type | ChannelsBuiltInAuthorizationPolicy 유형을 'Channels'로 설정하세요. RoleBasedBuiltInAuthorizationPolicy 형식에 대해 '기본값'으로 설정합니다. OrganizationSharedBuiltInAuthorizationPolicy 형식에 대해 'OrganizationScope'로 설정합니다. | '채널' 'Default' 'OrganizationScope'(필수) |
ApplicationTrafficRoutingPolicy
| 이름 | Description | 가치 |
|---|---|---|
| protocol | 애플리케이션의 배포로 트래픽을 라우팅하는 데 사용되는 방법론입니다. | '고정비율' |
| 규칙 | 트래픽 라우팅 규칙의 컬렉션을 가져오거나 설정합니다. | 트래픽 라우팅 규칙[] |
할당된 ID
| 이름 | Description | 가치 |
|---|---|---|
| clientId | ID의 클라이언트 ID입니다. | 문자열(필수) |
| 친절한 | 이 개체에서 설명하는 Entra ID의 종류를 지정합니다. | '에이전트 블루프린트' '에이전트 사용자' '에이전트 인스턴스' 'Managed' 'None'(필수) |
| principalId | ID의 주체 ID입니다. | 문자열(필수) |
| 제목 | 이 ID 할당의 주체입니다. | 문자열 |
| tenantId | ID의 테넌트 ID입니다. | 문자열(필수) |
| type | 관리 관점에서 ID 유형 열거. | 'None' 'System' 'User'(필수) |
채널 내장인권한정책(ChannelsBuiltInAuthorizationPolicy)
| 이름 | Description | 가치 |
|---|---|---|
| type | 권한 부여 체계 유형입니다. | '채널' (필수) |
OrganizationSharedBuiltInAuthorizationPolicy
| 이름 | Description | 가치 |
|---|---|---|
| type | 권한 부여 체계 유형입니다. | 'OrganizationScope'(필수) |
ResourceBaseTags
| 이름 | Description | 가치 |
|---|
RoleBasedBuiltInAuthorizationPolicy
| 이름 | Description | 가치 |
|---|---|---|
| type | 권한 부여 체계 유형입니다. | 'Default'(필수) |
트래픽라우팅 규칙
| 이름 | Description | 가치 |
|---|---|---|
| deploymentId | 이 규칙에 의해 트래픽이 라우팅되는 배포의 고유 식별자입니다. | 문자열 |
| description | 이 트래픽 라우팅 규칙에 대한 사용자 제공 설명입니다. | 문자열 |
| ruleId입니다 | 이 트래픽 라우팅 규칙의 식별자입니다. | 문자열 |
| 트래픽백분율 | 이 인스턴스에 할당된 트래픽의 백분율을 가져오거나 설정합니다. | 정수 (int) |
Terraform(AzAPI 공급자) 리소스 정의
계정/프로젝트/애플리케이션 리소스 유형은 다음을 대상으로 하는 작업과 함께 배포할 수 있습니다.
- 자원 그룹 각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft를 만드는 것. CognitiveServices/accounts/projects/applications 리소스, 템플릿에 다음 Terraform을 추가하세요.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.CognitiveServices/accounts/projects/applications@2026-05-15-preview"
name = "string"
parent_id = "string"
body = {
properties = {
agentIdentityBlueprint = {
clientId = "string"
kind = "string"
principalId = "string"
subject = "string"
tenantId = "string"
type = "string"
}
agents = [
{
agentId = "string"
agentName = "string"
}
]
authorizationPolicy = {
type = "string"
// For remaining properties, see ApplicationAuthorizationPolicy objects
}
baseUrl = "string"
defaultInstanceIdentity = {
clientId = "string"
kind = "string"
principalId = "string"
subject = "string"
tenantId = "string"
type = "string"
}
description = "string"
displayName = "string"
tags = {
{customized property} = "string"
}
trafficRoutingPolicy = {
protocol = "string"
rules = [
{
deploymentId = "string"
description = "string"
ruleId = "string"
trafficPercentage = int
}
]
}
}
}
}
ApplicationAuthorizationPolicy 개체
형식 속성을 설정하여 개체의 형식을 지정합니다.
채널의 경우, 다음을 사용하세요:
{
type = "Channels"
}
기본경우 다음을 사용합니다.
{
type = "Default"
}
OrganizationScope의 경우 다음을 사용합니다.
{
type = "OrganizationScope"
}
속성 값
Microsoft. CognitiveServices/계정/프로젝트/애플리케이션
| 이름 | Description | 가치 |
|---|---|---|
| 이름 | 리소스 이름 | 문자열(필수) |
| parent_id | 이 리소스의 부모인 리소스의 ID입니다. | 유형의 리소스에 대한 ID: 계정/프로젝트 |
| properties | [필수] 엔터티의 추가 특성입니다. | AgenticApplicationProperties (필수) |
| type | 리소스 종류 | "Microsoft. CognitiveServices/accounts/projects/applications@2026-05-15-preview" |
에이전트 적용 속성
| 이름 | Description | 가치 |
|---|---|---|
| agentIdentityBlueprint | 애플리케이션의 EntraId 에이전트 블루프린트입니다. | 할당된 ID |
| agents | 이 애플리케이션을 구성하는 에이전트 정의 목록으로, 상위 프로젝트 아래의 개체에 대한 참조로 반환됩니다. 이 응용 프로그램에서 나타내는 모든 에이전트-버전 쌍의 플랫 목록을 가져오려면 이 옵션을 사용합니다. | 에이전트 참조속성[] |
| 권한 부여 정책 | 이 에이전트 애플리케이션 인스턴스와 연관된 권한 부여 정책을 가져오거나 설정합니다. | 응용 프로그램 권한 부여 정책 |
| baseUrl | 애플리케이션의 전용 호출 엔드포인트입니다. | 문자열 |
| defaultInstanceIdentity | 애플리케이션의 (기본) 에이전트 인스턴스 ID입니다. | 할당된 ID |
| description | 자산 설명 텍스트입니다. | 문자열 |
| 표시 이름 | 애플리케이션의 표시 이름입니다. | 문자열 |
| tags | 태그 사전입니다. 태그를 추가, 제거 및 업데이트할 수 있습니다. | ResourceBaseTags |
| 트래픽라우팅 정책 | 애플리케이션의 배포에 대한 트래픽 라우팅 정책을 가져오거나 설정합니다. | ApplicationTrafficRoutingPolicy |
에이전트참조속성
| 이름 | Description | 가치 |
|---|---|---|
| agentId | 조직(구독) 내에서 에이전트의 고유 식별자를 가져옵니다. | 문자열 |
| 에이전트 이름 | 에이전트의 이름(프로젝트/앱 내에서 고유함)을 가져옵니다. | 문자열 |
응용 프로그램 권한 부여 정책
| 이름 | Description | 가치 |
|---|---|---|
| type | ChannelsBuiltInAuthorizationPolicy 유형을 'Channels'로 설정하세요. RoleBasedBuiltInAuthorizationPolicy 형식에 대해 '기본값'으로 설정합니다. OrganizationSharedBuiltInAuthorizationPolicy 형식에 대해 'OrganizationScope'로 설정합니다. | '채널' 'Default' 'OrganizationScope'(필수) |
ApplicationTrafficRoutingPolicy
| 이름 | Description | 가치 |
|---|---|---|
| protocol | 애플리케이션의 배포로 트래픽을 라우팅하는 데 사용되는 방법론입니다. | '고정비율' |
| 규칙 | 트래픽 라우팅 규칙의 컬렉션을 가져오거나 설정합니다. | 트래픽 라우팅 규칙[] |
할당된 ID
| 이름 | Description | 가치 |
|---|---|---|
| clientId | ID의 클라이언트 ID입니다. | 문자열(필수) |
| 친절한 | 이 개체에서 설명하는 Entra ID의 종류를 지정합니다. | '에이전트 블루프린트' '에이전트 사용자' '에이전트 인스턴스' 'Managed' 'None'(필수) |
| principalId | ID의 주체 ID입니다. | 문자열(필수) |
| 제목 | 이 ID 할당의 주체입니다. | 문자열 |
| tenantId | ID의 테넌트 ID입니다. | 문자열(필수) |
| type | 관리 관점에서 ID 유형 열거. | 'None' 'System' 'User'(필수) |
채널 내장인권한정책(ChannelsBuiltInAuthorizationPolicy)
| 이름 | Description | 가치 |
|---|---|---|
| type | 권한 부여 체계 유형입니다. | '채널' (필수) |
OrganizationSharedBuiltInAuthorizationPolicy
| 이름 | Description | 가치 |
|---|---|---|
| type | 권한 부여 체계 유형입니다. | 'OrganizationScope'(필수) |
ResourceBaseTags
| 이름 | Description | 가치 |
|---|
RoleBasedBuiltInAuthorizationPolicy
| 이름 | Description | 가치 |
|---|---|---|
| type | 권한 부여 체계 유형입니다. | 'Default'(필수) |
트래픽라우팅 규칙
| 이름 | Description | 가치 |
|---|---|---|
| deploymentId | 이 규칙에 의해 트래픽이 라우팅되는 배포의 고유 식별자입니다. | 문자열 |
| description | 이 트래픽 라우팅 규칙에 대한 사용자 제공 설명입니다. | 문자열 |
| ruleId입니다 | 이 트래픽 라우팅 규칙의 식별자입니다. | 문자열 |
| 트래픽백분율 | 이 인스턴스에 할당된 트래픽의 백분율을 가져오거나 설정합니다. | 정수 (int) |