你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Bicep资源定义
帐户/项目/应用程序资源类型可以使用针对以下目标的作进行部署:
- 资源组 - 请参阅 资源组部署命令
有关每个 API 版本中已更改属性的列表,请参阅更改日志。
资源格式
去创造一个Microsoft。CognitiveServices/accounts/projects/applications resource ,把以下 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 属性以指定对象的类型。
对于 频道,请使用:
{
type: 'Channels'
}
对于 默认,请使用:
{
type: 'Default'
}
对于 OrganizationScope,请使用:
{
type: 'OrganizationScope'
}
属性值
Microsoft。认知服务/账户/项目/应用
| Name | Description | 价值 |
|---|---|---|
| 姓名 | 资源名称 | 字符串(必需) |
| 父级 | 在 Bicep 中,你可以指定子资源的父资源。 仅当子资源在父资源外部声明时,才需要添加此属性。 有关详细信息,请参阅 父资源外部的子资源。 |
类型资源的符号名称:帐户/项目 |
| 属性 | [必需]实体的其他属性。 | AgenticApplicationProperties (必备) |
AgenticApplicationProperties(代理应用属性)
| Name | Description | 价值 |
|---|---|---|
| agentIdentity蓝图 | 应用程序的 EntraId 代理蓝图。 | 已分配身份 |
| 代理 | 构成此应用程序的代理定义列表,作为对父项目下对象的引用返回;使用它来获取此应用程序表示的所有代理版本对的平面列表。 | 代理参考属性[] |
| authorizationPolicy | 获取或设置与此代理应用程序实例关联的授权策略。 | 应用程序授权策略 |
| baseUrl | 应用程序的专用调用终结点。 | 字符串 |
| defaultInstanceIdentity | 应用程序的(默认)代理实例标识。 | 已分配身份 |
| 描述 | 资产说明文本。 | 字符串 |
| displayName | 应用程序的显示名称。 | 字符串 |
| tags | 标记字典。 可以添加、删除和更新标记。 | ResourceBaseTags |
| trafficRoutingPolicy | 获取或设置应用程序部署的流量路由策略。 | 应用程序交通路由策略 |
代理参考属性
| Name | Description | 价值 |
|---|---|---|
| agentId | 获取组织(订阅)中代理的唯一标识符。 | 字符串 |
| agentName (代理名称) | 获取代理的名称(在项目/应用中唯一)。 | 字符串 |
应用程序授权策略
| Name | Description | 价值 |
|---|---|---|
| 类型 | 将 ChannelsBuiltInAuthorizationPolicy 类型设置为“Channels”。 将 类型 RoleBasedBuiltInAuthorizationPolicy 设置为“默认”。 将类型 OrganizationSharedBuiltInAuthorizationPolicy 设置为“OrganizationScope”。 | “通道” 'Default' 'OrganizationScope'(必需) |
应用程序交通路由策略
| Name | Description | 价值 |
|---|---|---|
| 协议 | 用于将流量路由到应用程序部署的方法。 | “固定比率” |
| 规则 | 获取或设置流量路由规则的集合。 | TrafficRoutingRule[] |
已分配身份
| Name | Description | 价值 |
|---|---|---|
| clientId | 标识的客户端 ID。 | 字符串(必需) |
| kind | 指定此对象描述的 Entra 标识类型。 | “代理蓝图” “代理用户” '代理实例' 'Managed' “无”(必需) |
| principalId | 标识的主体 ID。 | 字符串(必需) |
| 主题 | 此标识分配的主题。 | 字符串 |
| tenantId | 标识的租户 ID。 | 字符串(必需) |
| 类型 | 从管理角度枚举身份类型。 | 'None' 'System' “User”(必需) |
ChannelsBuiltIn授权政策
| Name | Description | 价值 |
|---|---|---|
| 类型 | 授权方案类型。 | “通道”(必备) |
OrganizationSharedBuiltInAuthorizationPolicy
| Name | Description | 价值 |
|---|---|---|
| 类型 | 授权方案类型。 | 'OrganizationScope'(必需) |
ResourceBaseTags
| Name | Description | 价值 |
|---|
RoleBasedBuiltInAuthorizationPolicy
| Name | Description | 价值 |
|---|---|---|
| 类型 | 授权方案类型。 | 'Default'(必填) |
TrafficRouting规则
| Name | Description | 价值 |
|---|---|---|
| deploymentId | 此规则将流量路由到的部署的唯一标识符。 | 字符串 |
| 描述 | 用户为此流量路由规则提供的说明。 | 字符串 |
| 规则 ID | 此流量路由规则的标识符。 | 字符串 |
| 流量百分比 | 获取或设置分配给此实例的流量百分比。 | int |
ARM 模板资源定义
帐户/项目/应用程序资源类型可以使用针对以下目标的作进行部署:
用法示例
资源格式
去创造一个Microsoft。CognitiveServices/accounts/projects/applications resource,在模板中添加以下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 属性以指定对象的类型。
对于 频道,请使用:
{
"type": "Channels"
}
对于 默认,请使用:
{
"type": "Default"
}
对于 OrganizationScope,请使用:
{
"type": "OrganizationScope"
}
属性值
Microsoft。认知服务/账户/项目/应用
| Name | Description | 价值 |
|---|---|---|
| apiVersion | API 版本 | '2026-05-15-预览' |
| 姓名 | 资源名称 | 字符串(必需) |
| 属性 | [必需]实体的其他属性。 | AgenticApplicationProperties (必备) |
| 类型 | 资源类型 | “Microsoft。认知服务/账户/项目/应用 |
AgenticApplicationProperties(代理应用属性)
| Name | Description | 价值 |
|---|---|---|
| agentIdentity蓝图 | 应用程序的 EntraId 代理蓝图。 | 已分配身份 |
| 代理 | 构成此应用程序的代理定义列表,作为对父项目下对象的引用返回;使用它来获取此应用程序表示的所有代理版本对的平面列表。 | 代理参考属性[] |
| authorizationPolicy | 获取或设置与此代理应用程序实例关联的授权策略。 | 应用程序授权策略 |
| baseUrl | 应用程序的专用调用终结点。 | 字符串 |
| defaultInstanceIdentity | 应用程序的(默认)代理实例标识。 | 已分配身份 |
| 描述 | 资产说明文本。 | 字符串 |
| displayName | 应用程序的显示名称。 | 字符串 |
| tags | 标记字典。 可以添加、删除和更新标记。 | ResourceBaseTags |
| trafficRoutingPolicy | 获取或设置应用程序部署的流量路由策略。 | 应用程序交通路由策略 |
代理参考属性
| Name | Description | 价值 |
|---|---|---|
| agentId | 获取组织(订阅)中代理的唯一标识符。 | 字符串 |
| agentName (代理名称) | 获取代理的名称(在项目/应用中唯一)。 | 字符串 |
应用程序授权策略
| Name | Description | 价值 |
|---|---|---|
| 类型 | 将 ChannelsBuiltInAuthorizationPolicy 类型设置为“Channels”。 将 类型 RoleBasedBuiltInAuthorizationPolicy 设置为“默认”。 将类型 OrganizationSharedBuiltInAuthorizationPolicy 设置为“OrganizationScope”。 | “通道” 'Default' 'OrganizationScope'(必需) |
应用程序交通路由策略
| Name | Description | 价值 |
|---|---|---|
| 协议 | 用于将流量路由到应用程序部署的方法。 | “固定比率” |
| 规则 | 获取或设置流量路由规则的集合。 | TrafficRoutingRule[] |
已分配身份
| Name | Description | 价值 |
|---|---|---|
| clientId | 标识的客户端 ID。 | 字符串(必需) |
| kind | 指定此对象描述的 Entra 标识类型。 | “代理蓝图” “代理用户” '代理实例' 'Managed' “无”(必需) |
| principalId | 标识的主体 ID。 | 字符串(必需) |
| 主题 | 此标识分配的主题。 | 字符串 |
| tenantId | 标识的租户 ID。 | 字符串(必需) |
| 类型 | 从管理角度枚举身份类型。 | 'None' 'System' “User”(必需) |
ChannelsBuiltIn授权政策
| Name | Description | 价值 |
|---|---|---|
| 类型 | 授权方案类型。 | “通道”(必备) |
OrganizationSharedBuiltInAuthorizationPolicy
| Name | Description | 价值 |
|---|---|---|
| 类型 | 授权方案类型。 | 'OrganizationScope'(必需) |
ResourceBaseTags
| Name | Description | 价值 |
|---|
RoleBasedBuiltInAuthorizationPolicy
| Name | Description | 价值 |
|---|---|---|
| 类型 | 授权方案类型。 | 'Default'(必填) |
TrafficRouting规则
| Name | Description | 价值 |
|---|---|---|
| deploymentId | 此规则将流量路由到的部署的唯一标识符。 | 字符串 |
| 描述 | 用户为此流量路由规则提供的说明。 | 字符串 |
| 规则 ID | 此流量路由规则的标识符。 | 字符串 |
| 流量百分比 | 获取或设置分配给此实例的流量百分比。 | int |
Terraform (AzAPI 提供程序)资源定义
帐户/项目/应用程序资源类型可以使用针对以下目标的作进行部署:
- 资源组 关于每个API版本中变更属性的列表,请参见 更改日志。
资源格式
去创造一个Microsoft。CognitiveServices/accounts/projects/applications resource ,将以下 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 属性以指定对象的类型。
对于 频道,请使用:
{
type = "Channels"
}
对于 默认,请使用:
{
type = "Default"
}
对于 OrganizationScope,请使用:
{
type = "OrganizationScope"
}
属性值
Microsoft。认知服务/账户/项目/应用
| Name | Description | 价值 |
|---|---|---|
| 姓名 | 资源名称 | 字符串(必需) |
| parent_id | 此资源的父资源的 ID。 | 类型资源的 ID:帐户/项目 |
| 属性 | [必需]实体的其他属性。 | AgenticApplicationProperties (必备) |
| 类型 | 资源类型 | “Microsoft。CognitiveServices/accounts/projects/applications@2026-05-15-preview” |
AgenticApplicationProperties(代理应用属性)
| Name | Description | 价值 |
|---|---|---|
| agentIdentity蓝图 | 应用程序的 EntraId 代理蓝图。 | 已分配身份 |
| 代理 | 构成此应用程序的代理定义列表,作为对父项目下对象的引用返回;使用它来获取此应用程序表示的所有代理版本对的平面列表。 | 代理参考属性[] |
| authorizationPolicy | 获取或设置与此代理应用程序实例关联的授权策略。 | 应用程序授权策略 |
| baseUrl | 应用程序的专用调用终结点。 | 字符串 |
| defaultInstanceIdentity | 应用程序的(默认)代理实例标识。 | 已分配身份 |
| 描述 | 资产说明文本。 | 字符串 |
| displayName | 应用程序的显示名称。 | 字符串 |
| tags | 标记字典。 可以添加、删除和更新标记。 | ResourceBaseTags |
| trafficRoutingPolicy | 获取或设置应用程序部署的流量路由策略。 | 应用程序交通路由策略 |
代理参考属性
| Name | Description | 价值 |
|---|---|---|
| agentId | 获取组织(订阅)中代理的唯一标识符。 | 字符串 |
| agentName (代理名称) | 获取代理的名称(在项目/应用中唯一)。 | 字符串 |
应用程序授权策略
| Name | Description | 价值 |
|---|---|---|
| 类型 | 将 ChannelsBuiltInAuthorizationPolicy 类型设置为“Channels”。 将 类型 RoleBasedBuiltInAuthorizationPolicy 设置为“默认”。 将类型 OrganizationSharedBuiltInAuthorizationPolicy 设置为“OrganizationScope”。 | “通道” 'Default' 'OrganizationScope'(必需) |
应用程序交通路由策略
| Name | Description | 价值 |
|---|---|---|
| 协议 | 用于将流量路由到应用程序部署的方法。 | “固定比率” |
| 规则 | 获取或设置流量路由规则的集合。 | TrafficRoutingRule[] |
已分配身份
| Name | Description | 价值 |
|---|---|---|
| clientId | 标识的客户端 ID。 | 字符串(必需) |
| kind | 指定此对象描述的 Entra 标识类型。 | “代理蓝图” “代理用户” '代理实例' 'Managed' “无”(必需) |
| principalId | 标识的主体 ID。 | 字符串(必需) |
| 主题 | 此标识分配的主题。 | 字符串 |
| tenantId | 标识的租户 ID。 | 字符串(必需) |
| 类型 | 从管理角度枚举身份类型。 | 'None' 'System' “User”(必需) |
ChannelsBuiltIn授权政策
| Name | Description | 价值 |
|---|---|---|
| 类型 | 授权方案类型。 | “通道”(必备) |
OrganizationSharedBuiltInAuthorizationPolicy
| Name | Description | 价值 |
|---|---|---|
| 类型 | 授权方案类型。 | 'OrganizationScope'(必需) |
ResourceBaseTags
| Name | Description | 价值 |
|---|
RoleBasedBuiltInAuthorizationPolicy
| Name | Description | 价值 |
|---|---|---|
| 类型 | 授权方案类型。 | 'Default'(必填) |
TrafficRouting规则
| Name | Description | 价值 |
|---|---|---|
| deploymentId | 此规则将流量路由到的部署的唯一标识符。 | 字符串 |
| 描述 | 用户为此流量路由规则提供的说明。 | 字符串 |
| 规则 ID | 此流量路由规则的标识符。 | 字符串 |
| 流量百分比 | 获取或设置分配给此实例的流量百分比。 | int |