你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Microsoft.DevOpsInfrastructure 池 2023-10-30-preview

Bicep 资源定义

可以使用目标操作部署池资源类型:

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.DevOpsInfrastructure/pools 资源,请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.DevOpsInfrastructure/pools@2023-10-30-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    agentProfile: {
      resourcePredictions: any(Azure.Bicep.Types.Concrete.AnyType)
      kind: 'string'
      // For remaining properties, see AgentProfile objects
    }
    devCenterProjectResourceId: 'string'
    fabricProfile: {
      kind: 'string'
      // For remaining properties, see FabricProfile objects
    }
    maximumConcurrency: int
    organizationProfile: {
      kind: 'string'
      // For remaining properties, see OrganizationProfile objects
    }
    provisioningState: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

AgentProfile 对象

设置 类型 属性以指定对象的类型。

对于 有状态,请使用:

{
  kind: 'Stateful'
  maxAgentLifetime: 'string'
}

对于 无状态,请使用:

{
  kind: 'Stateless'
}

OrganizationProfile 对象

设置 类型 属性以指定对象的类型。

对于 AzureDevOps,请使用:

{
  kind: 'AzureDevOps'
  organizations: [
    {
      parallelism: int
      projects: [
        'string'
      ]
      url: 'string'
    }
  ]
}

FabricProfile 对象

设置 类型 属性以指定对象的类型。

对于 Vmss,请使用:

{
  images: [
    {
      aliases: [
        'string'
      ]
      buffer: 'string'
      resourceId: 'string'
    }
  ]
  kind: 'Vmss'
  networkProfile: {
    subnetId: 'string'
  }
  osProfile: {
    secretsManagementSettings: {
      certificateStoreLocation: 'string'
      keyExportable: bool
      observedCertificates: [
        'string'
      ]
    }
  }
  sku: {
    name: 'string'
    tier: 'string'
  }
}

属性值

AgentProfile

名字 描述 价值
对于 有状态类型,设置为“有状态”。 对于 StatelessAgentProfile类型,设置为“无状态”。 “有状态”
“无状态”(必需)
resourcePredictions 定义池缓冲区。 任何

AzureDevOpsOrganizationProfile

名字 描述 价值
OrganizationProfile 的鉴别器属性。 “AzureDevOps”(必需)
组织 池应位于的 Azure DevOps 组织列表。 组织[] (必需)

DevOpsAzureSku

名字 描述 价值
名字 池中计算机的 Azure SKU 名称。 string (必需)
池中计算机的 Azure SKU 层。 字符串

FabricProfile

名字 描述 价值
对于 VmssFabricProfile类型,设置为“Vmss”。 “Vmss”(必需)

ManagedServiceIdentity

名字 描述 价值
类型 托管服务标识的类型(其中允许 SystemAssigned 和 UserAssigned 类型)。 “None”
“SystemAssigned”
“SystemAssigned,UserAssigned”
“UserAssigned”(必需)
userAssignedIdentities 与资源关联的用户分配标识集。 userAssignedIdentities 字典密钥将为 ARM 资源 ID,格式为“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。 字典值可以是请求中的空对象({})。 UserAssignedIdentities

Microsoft.DevOpsInfrastructure/pools

名字 描述 价值
身份 分配给此资源的托管服务标识。 ManagedServiceIdentity
位置 资源所在的地理位置 string (必需)
名字 资源名称 字符串

约束:
模式 = ^[a-z][a-z0-9]*$ (必需)
性能 此资源的资源特定属性。 PoolProperties
标签 资源标记 标记名称和值的字典。 请参阅模板 中的 标记

NetworkProfile

名字 描述 价值
subnetId 要在其中放置池中创建的所有计算机的子网 ID。 string (必需)

组织

名字 描述 价值
排比 在此组织中,可以从池的最大并发性中最多创建多少台计算机。 int
项目 应在其中创建池的项目的可选列表。 string[]
url 应在其中创建池的 Azure DevOps 组织 URL。 string (必需)

OrganizationProfile

名字 描述 价值
对于 AzureDevOpsOrganizationProfile,请设置为“AzureDevOps”。 “AzureDevOps”(必需)

OsProfile

名字 描述 价值
secretsManagementSettings 池中计算机的机密管理设置。 SecretsManagementSettings (必需)

PoolImage

名字 描述 价值
别名 要引用图像的别名列表。 string[]
缓冲区 要分配给此映像的缓冲区的百分比。 字符串
resourceId 映像的资源 ID。 string (必需)

PoolProperties

名字 描述 价值
agentProfile 定义执行作业后计算机将如何处理。 AgentProfile (必需)
devCenterProjectResourceId 池所属的 DevCenter 项目的资源 ID。 string (必需)
fabricProfile 定义代理将运行的结构类型。 FabricProfile (必需)
maximumConcurrency 定义在任何给定时间可以创建多少个资源。 int

约束:
最小值 = 1
最大值 = 10000 (必需)
organizationProfile 定义将使用池的组织。 OrganizationProfile (必需)
provisioningState 当前操作的状态。 “Accepted”
“Canceled”
“删除”
“Failed”
“预配”
“Succeeded”
“正在更新”

SecretsManagementSettings

名字 描述 价值
certificateStoreLocation 在计算机上存储证书的位置。 字符串
keyExportable 定义证书的密钥是否应可导出。 bool (必需)
observedCertificates 要安装在池中所有计算机上的证书列表。 string[] (必需)

状态

名字 描述 价值
AgentProfile 的鉴别器属性。 “有状态”(必需)
maxAgentLifetime 有状态计算机应该保留多长时间。 最大值为一周。 string (必需)

StatelessAgentProfile

名字 描述 价值
AgentProfile 的鉴别器属性。 “无状态”(必需)

TrackedResourceTags

名字 描述 价值

UserAssignedIdentities

名字 描述 价值

UserAssignedIdentity

名字 描述 价值

VmssFabricProfile

名字 描述 价值
图像 池中计算机的 VM 映像。 PoolImage[] (必需)
FabricProfile 的鉴别器属性。 “Vmss”(必需)
networkProfile 池中计算机的网络配置文件。 NetworkProfile
osProfile 池中计算机的 OS 配置文件。 OsProfile
sku 池中计算机的 Azure SKU。 DevOpsAzureSku (必需)

ARM 模板资源定义

可以使用目标操作部署池资源类型:

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.DevOpsInfrastructure/pools 资源,请将以下 JSON 添加到模板。

{
  "type": "Microsoft.DevOpsInfrastructure/pools",
  "apiVersion": "2023-10-30-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "agentProfile": {
      "resourcePredictions": {},
      "kind": "string"
      // For remaining properties, see AgentProfile objects
    },
    "devCenterProjectResourceId": "string",
    "fabricProfile": {
      "kind": "string"
      // For remaining properties, see FabricProfile objects
    },
    "maximumConcurrency": "int",
    "organizationProfile": {
      "kind": "string"
      // For remaining properties, see OrganizationProfile objects
    },
    "provisioningState": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

AgentProfile 对象

设置 类型 属性以指定对象的类型。

对于 有状态,请使用:

{
  "kind": "Stateful",
  "maxAgentLifetime": "string"
}

对于 无状态,请使用:

{
  "kind": "Stateless"
}

OrganizationProfile 对象

设置 类型 属性以指定对象的类型。

对于 AzureDevOps,请使用:

{
  "kind": "AzureDevOps",
  "organizations": [
    {
      "parallelism": "int",
      "projects": [ "string" ],
      "url": "string"
    }
  ]
}

FabricProfile 对象

设置 类型 属性以指定对象的类型。

对于 Vmss,请使用:

{
  "images": [
    {
      "aliases": [ "string" ],
      "buffer": "string",
      "resourceId": "string"
    }
  ],
  "kind": "Vmss",
  "networkProfile": {
    "subnetId": "string"
  },
  "osProfile": {
    "secretsManagementSettings": {
      "certificateStoreLocation": "string",
      "keyExportable": "bool",
      "observedCertificates": [ "string" ]
    }
  },
  "sku": {
    "name": "string",
    "tier": "string"
  }
}

属性值

AgentProfile

名字 描述 价值
对于 有状态类型,设置为“有状态”。 对于 StatelessAgentProfile类型,设置为“无状态”。 “有状态”
“无状态”(必需)
resourcePredictions 定义池缓冲区。 任何

AzureDevOpsOrganizationProfile

名字 描述 价值
OrganizationProfile 的鉴别器属性。 “AzureDevOps”(必需)
组织 池应位于的 Azure DevOps 组织列表。 组织[] (必需)

DevOpsAzureSku

名字 描述 价值
名字 池中计算机的 Azure SKU 名称。 string (必需)
池中计算机的 Azure SKU 层。 字符串

FabricProfile

名字 描述 价值
对于 VmssFabricProfile类型,设置为“Vmss”。 “Vmss”(必需)

ManagedServiceIdentity

名字 描述 价值
类型 托管服务标识的类型(其中允许 SystemAssigned 和 UserAssigned 类型)。 “None”
“SystemAssigned”
“SystemAssigned,UserAssigned”
“UserAssigned”(必需)
userAssignedIdentities 与资源关联的用户分配标识集。 userAssignedIdentities 字典密钥将为 ARM 资源 ID,格式为“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。 字典值可以是请求中的空对象({})。 UserAssignedIdentities

Microsoft.DevOpsInfrastructure/pools

名字 描述 价值
apiVersion API 版本 '2023-10-30-preview'
身份 分配给此资源的托管服务标识。 ManagedServiceIdentity
位置 资源所在的地理位置 string (必需)
名字 资源名称 字符串

约束:
模式 = ^[a-z][a-z0-9]*$ (必需)
性能 此资源的资源特定属性。 PoolProperties
标签 资源标记 标记名称和值的字典。 请参阅模板 中的 标记
类型 资源类型 “Microsoft.DevOpsInfrastructure/pools”

NetworkProfile

名字 描述 价值
subnetId 要在其中放置池中创建的所有计算机的子网 ID。 string (必需)

组织

名字 描述 价值
排比 在此组织中,可以从池的最大并发性中最多创建多少台计算机。 int
项目 应在其中创建池的项目的可选列表。 string[]
url 应在其中创建池的 Azure DevOps 组织 URL。 string (必需)

OrganizationProfile

名字 描述 价值
对于 AzureDevOpsOrganizationProfile,请设置为“AzureDevOps”。 “AzureDevOps”(必需)

OsProfile

名字 描述 价值
secretsManagementSettings 池中计算机的机密管理设置。 SecretsManagementSettings (必需)

PoolImage

名字 描述 价值
别名 要引用图像的别名列表。 string[]
缓冲区 要分配给此映像的缓冲区的百分比。 字符串
resourceId 映像的资源 ID。 string (必需)

PoolProperties

名字 描述 价值
agentProfile 定义执行作业后计算机将如何处理。 AgentProfile (必需)
devCenterProjectResourceId 池所属的 DevCenter 项目的资源 ID。 string (必需)
fabricProfile 定义代理将运行的结构类型。 FabricProfile (必需)
maximumConcurrency 定义在任何给定时间可以创建多少个资源。 int

约束:
最小值 = 1
最大值 = 10000 (必需)
organizationProfile 定义将使用池的组织。 OrganizationProfile (必需)
provisioningState 当前操作的状态。 “Accepted”
“Canceled”
“删除”
“Failed”
“预配”
“Succeeded”
“正在更新”

SecretsManagementSettings

名字 描述 价值
certificateStoreLocation 在计算机上存储证书的位置。 字符串
keyExportable 定义证书的密钥是否应可导出。 bool (必需)
observedCertificates 要安装在池中所有计算机上的证书列表。 string[] (必需)

状态

名字 描述 价值
AgentProfile 的鉴别器属性。 “有状态”(必需)
maxAgentLifetime 有状态计算机应该保留多长时间。 最大值为一周。 string (必需)

StatelessAgentProfile

名字 描述 价值
AgentProfile 的鉴别器属性。 “无状态”(必需)

TrackedResourceTags

名字 描述 价值

UserAssignedIdentities

名字 描述 价值

UserAssignedIdentity

名字 描述 价值

VmssFabricProfile

名字 描述 价值
图像 池中计算机的 VM 映像。 PoolImage[] (必需)
FabricProfile 的鉴别器属性。 “Vmss”(必需)
networkProfile 池中计算机的网络配置文件。 NetworkProfile
osProfile 池中计算机的 OS 配置文件。 OsProfile
sku 池中计算机的 Azure SKU。 DevOpsAzureSku (必需)

Terraform (AzAPI 提供程序)资源定义

可以使用目标操作部署池资源类型:

  • 资源组

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.DevOpsInfrastructure/pools 资源,请将以下 Terraform 添加到模板。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DevOpsInfrastructure/pools@2023-10-30-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  body = jsonencode({
    properties = {
      agentProfile = {
        resourcePredictions = ?
        kind = "string"
        // For remaining properties, see AgentProfile objects
      }
      devCenterProjectResourceId = "string"
      fabricProfile = {
        kind = "string"
        // For remaining properties, see FabricProfile objects
      }
      maximumConcurrency = int
      organizationProfile = {
        kind = "string"
        // For remaining properties, see OrganizationProfile objects
      }
      provisioningState = "string"
    }
  })
  tags = {
    {customized property} = "string"
  }
}

AgentProfile 对象

设置 类型 属性以指定对象的类型。

对于 有状态,请使用:

{
  kind = "Stateful"
  maxAgentLifetime = "string"
}

对于 无状态,请使用:

{
  kind = "Stateless"
}

OrganizationProfile 对象

设置 类型 属性以指定对象的类型。

对于 AzureDevOps,请使用:

{
  kind = "AzureDevOps"
  organizations = [
    {
      parallelism = int
      projects = [
        "string"
      ]
      url = "string"
    }
  ]
}

FabricProfile 对象

设置 类型 属性以指定对象的类型。

对于 Vmss,请使用:

{
  images = [
    {
      aliases = [
        "string"
      ]
      buffer = "string"
      resourceId = "string"
    }
  ]
  kind = "Vmss"
  networkProfile = {
    subnetId = "string"
  }
  osProfile = {
    secretsManagementSettings = {
      certificateStoreLocation = "string"
      keyExportable = bool
      observedCertificates = [
        "string"
      ]
    }
  }
  sku = {
    name = "string"
    tier = "string"
  }
}

属性值

AgentProfile

名字 描述 价值
对于 有状态类型,设置为“有状态”。 对于 StatelessAgentProfile类型,设置为“无状态”。 “有状态”
“无状态”(必需)
resourcePredictions 定义池缓冲区。 任何

AzureDevOpsOrganizationProfile

名字 描述 价值
OrganizationProfile 的鉴别器属性。 “AzureDevOps”(必需)
组织 池应位于的 Azure DevOps 组织列表。 组织[] (必需)

DevOpsAzureSku

名字 描述 价值
名字 池中计算机的 Azure SKU 名称。 string (必需)
池中计算机的 Azure SKU 层。 字符串

FabricProfile

名字 描述 价值
对于 VmssFabricProfile类型,设置为“Vmss”。 “Vmss”(必需)

ManagedServiceIdentity

名字 描述 价值
类型 托管服务标识的类型(其中允许 SystemAssigned 和 UserAssigned 类型)。 “None”
“SystemAssigned”
“SystemAssigned,UserAssigned”
“UserAssigned”(必需)
userAssignedIdentities 与资源关联的用户分配标识集。 userAssignedIdentities 字典密钥将为 ARM 资源 ID,格式为“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。 字典值可以是请求中的空对象({})。 UserAssignedIdentities

Microsoft.DevOpsInfrastructure/pools

名字 描述 价值
身份 分配给此资源的托管服务标识。 ManagedServiceIdentity
位置 资源所在的地理位置 string (必需)
名字 资源名称 字符串

约束:
模式 = ^[a-z][a-z0-9]*$ (必需)
性能 此资源的资源特定属性。 PoolProperties
标签 资源标记 标记名称和值的字典。
类型 资源类型 “Microsoft.DevOpsInfrastructure/pools@2023-10-30-preview”

NetworkProfile

名字 描述 价值
subnetId 要在其中放置池中创建的所有计算机的子网 ID。 string (必需)

组织

名字 描述 价值
排比 在此组织中,可以从池的最大并发性中最多创建多少台计算机。 int
项目 应在其中创建池的项目的可选列表。 string[]
url 应在其中创建池的 Azure DevOps 组织 URL。 string (必需)

OrganizationProfile

名字 描述 价值
对于 AzureDevOpsOrganizationProfile,请设置为“AzureDevOps”。 “AzureDevOps”(必需)

OsProfile

名字 描述 价值
secretsManagementSettings 池中计算机的机密管理设置。 SecretsManagementSettings (必需)

PoolImage

名字 描述 价值
别名 要引用图像的别名列表。 string[]
缓冲区 要分配给此映像的缓冲区的百分比。 字符串
resourceId 映像的资源 ID。 string (必需)

PoolProperties

名字 描述 价值
agentProfile 定义执行作业后计算机将如何处理。 AgentProfile (必需)
devCenterProjectResourceId 池所属的 DevCenter 项目的资源 ID。 string (必需)
fabricProfile 定义代理将运行的结构类型。 FabricProfile (必需)
maximumConcurrency 定义在任何给定时间可以创建多少个资源。 int

约束:
最小值 = 1
最大值 = 10000 (必需)
organizationProfile 定义将使用池的组织。 OrganizationProfile (必需)
provisioningState 当前操作的状态。 “Accepted”
“Canceled”
“删除”
“Failed”
“预配”
“Succeeded”
“正在更新”

SecretsManagementSettings

名字 描述 价值
certificateStoreLocation 在计算机上存储证书的位置。 字符串
keyExportable 定义证书的密钥是否应可导出。 bool (必需)
observedCertificates 要安装在池中所有计算机上的证书列表。 string[] (必需)

状态

名字 描述 价值
AgentProfile 的鉴别器属性。 “有状态”(必需)
maxAgentLifetime 有状态计算机应该保留多长时间。 最大值为一周。 string (必需)

StatelessAgentProfile

名字 描述 价值
AgentProfile 的鉴别器属性。 “无状态”(必需)

TrackedResourceTags

名字 描述 价值

UserAssignedIdentities

名字 描述 价值

UserAssignedIdentity

名字 描述 价值

VmssFabricProfile

名字 描述 价值
图像 池中计算机的 VM 映像。 PoolImage[] (必需)
FabricProfile 的鉴别器属性。 “Vmss”(必需)
networkProfile 池中计算机的网络配置文件。 NetworkProfile
osProfile 池中计算机的 OS 配置文件。 OsProfile
sku 池中计算机的 Azure SKU。 DevOpsAzureSku (必需)