Taskgroups - Update

参考

服务:: Distributed Task

API 版本:: 7.1

更新任务组。

PUT https://dev.azure.com/{organization}/{project}/_apis/distributedtask/taskgroups/{taskGroupId}?api-version=7.1

URI 参数

名称	在	必需	类型	说明
organization	path	True	string	Azure DevOps 组织的名称。
project	path	True	string	项目 ID 或项目名称
taskGroupId	path		string (uuid)	要更新的任务组的 ID。
api-version	query	True	string	要使用的 API 版本。这应设置为“7.1”才能使用此版本的 API。

请求正文

名称	类型	说明
author	string	设置任务组的作者名称。
category	string	设置任务组的类别。
comment	string	设置任务组的注释。
description	string	设置任务组的说明。
friendlyName	string	设置任务组的友好名称。
iconUrl	string	设置任务组的 URL 图标。
id	string (uuid)	设置此字段的唯一标识符。
inputs	TaskInputDefinition[]	设置任务组的输入。
instanceNameFormat	string	设置任务组的显示名称。
name	string	设置任务组的名称。
parentDefinitionId	string (uuid)	获取或设置父任务组 ID。创建草稿任务组时会用到它。
revision	integer (int32)	设置任务组的修订。
runsOn	string[]	设置任务组的 RunsOn。值可以是“Agent”、“Server”或“DeploymentGroup”。
tasks	TaskGroupStep[]	设置任务组的任务。
version	TaskVersion	设置任务组的版本。

响应

名称	类型	说明
200 OK	TaskGroup	成功作

安全性

oauth2

类型: oauth2
流向: accessCode
授权 URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
令牌 URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

作用域

名称	说明
vso.taskgroups_manage	授予读取、创建和管理任务组的能力。

示例

Update a task group

示例请求

HTTP

PUT https://dev.azure.com/fabrikam/MyFirstProject/_apis/distributedtask/taskgroups?api-version=7.1

{
  "tasks": [
    {
      "displayName": "PowerShell Script",
      "alwaysRun": false,
      "continueOnError": false,
      "enabled": true,
      "timeoutInMinutes": 0,
      "inputs": {
        "scriptType": "inlineScript",
        "inlineScript": "Write-Host \"New Script\""
      },
      "task": {
        "id": "e213ff0f-5d5c-4791-802d-52ea3e7be1f1",
        "versionSpec": "1.*",
        "definitionType": "task"
      }
    }
  ],
  "runsOn": [
    "Agent",
    "DeploymentGroup"
  ],
  "revision": 1,
  "createdBy": {
    "id": "4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
    "displayName": "Chuck Reinhart",
    "uniqueName": "fabfiber@outlook.com"
  },
  "createdOn": "2017-08-24T09:53:15.003Z",
  "modifiedBy": {
    "id": "4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
    "displayName": "Chuck Reinhart",
    "uniqueName": "fabfiber@outlook.com"
  },
  "modifiedOn": "2017-08-24T09:53:15.003Z",
  "comment": "Updated the task group",
  "id": "544d6e0b-a3d1-41ed-a8d6-f73c55a5eab8",
  "name": "My PowerShell TG",
  "version": {
    "major": 1,
    "minor": 0,
    "patch": 0,
    "isTest": false
  },
  "category": "Deploy",
  "definitionType": "metaTask",
  "instanceNameFormat": "Task group: TG"
}

示例响应

状态代码:: 200

{
  "tasks": [
    {
      "displayName": "PowerShell Script",
      "alwaysRun": false,
      "continueOnError": false,
      "enabled": true,
      "timeoutInMinutes": 0,
      "inputs": {
        "scriptType": "inlineScript",
        "inlineScript": "\"Production script1\""
      },
      "task": {
        "id": "e213ff0f-5d5c-4791-802d-52ea3e7be1f1",
        "versionSpec": "1.*",
        "definitionType": "task"
      }
    },
    {
      "displayName": "PowerShell Script",
      "alwaysRun": false,
      "continueOnError": false,
      "enabled": true,
      "timeoutInMinutes": 0,
      "inputs": {
        "scriptType": "inlineScript",
        "inlineScript": "\"Production script2\""
      },
      "task": {
        "id": "e213ff0f-5d5c-4791-802d-52ea3e7be1f1",
        "versionSpec": "1.*",
        "definitionType": "task"
      }
    },
    {
      "displayName": "PowerShell Script",
      "alwaysRun": false,
      "continueOnError": false,
      "enabled": true,
      "timeoutInMinutes": 0,
      "inputs": {
        "scriptType": "inlineScript",
        "inlineScript": "Write-Host \"New Script\""
      },
      "task": {
        "id": "e213ff0f-5d5c-4791-802d-52ea3e7be1f1",
        "versionSpec": "1.*",
        "definitionType": "task"
      }
    }
  ],
  "runsOn": [
    "Agent",
    "DeploymentGroup"
  ],
  "revision": 2,
  "createdBy": {
    "id": "4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
    "displayName": "Chuck Reinhart",
    "uniqueName": "fabfiber@outlook.com"
  },
  "createdOn": "2017-08-24T09:53:15.003Z",
  "modifiedBy": {
    "id": "4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
    "displayName": "Chuck Reinhart",
    "uniqueName": "fabfiber@outlook.com"
  },
  "modifiedOn": "2017-08-24T09:53:15.94Z",
  "comment": "Updated the task group",
  "id": "544d6e0b-a3d1-41ed-a8d6-f73c55a5eab8",
  "name": "My PowerShell TG",
  "version": {
    "major": 1,
    "minor": 0,
    "patch": 0,
    "isTest": false
  },
  "category": "Deploy",
  "definitionType": "metaTask",
  "instanceNameFormat": "Task group: TG"
}

定义

名称	说明
AuthorizationHeader
DataSourceBinding
Demand
IdentityRef
JObject	表示 JSON 对象。
JToken	表示抽象 JSON 令牌。
ReferenceLinks	表示 REST 引用链接集合的类。
TaskCommandMode
TaskCommandRestrictions
TaskDefinitionReference
TaskExecution
TaskGroup
TaskGroupDefinition
TaskGroupStep	表示任务组中的任务。
TaskGroupUpdateParameter
TaskInputDefinition
TaskInputValidation
TaskOutputVariable
TaskReference	对任务的引用。
TaskRestrictions
TaskSourceDefinition
TaskVariableRestrictions
TaskVersion

AuthorizationHeader

Object

名称	类型	说明
name	string	获取或设置授权标头的名称。
value	string	获取或设置授权标头的值。

DataSourceBinding

Object

名称	类型	说明
callbackContextTemplate	string	此数据源支持的分页格式（ContinuationToken/SkipTop）。
callbackRequiredTemplate	string	需要后续调用？
dataSourceName	string	获取或设置数据源的名称。
endpointId	string	获取或设置终结点 ID。
endpointUrl	string	获取或设置服务终结点的 URL。
headers	AuthorizationHeader[]	获取或设置授权标头。
initialContextTemplate	string	定义查询参数的初始值
parameters	object	获取或设置数据源的参数。
requestContent	string	获取或设置 http 请求正文
requestVerb	string	获取或设置 http 请求谓词
resultSelector	string	获取或设置结果选择器。
resultTemplate	string	获取或设置结果模板。
target	string	获取或设置数据源的目标。

Demand

Object

名称	类型	说明
name	string
value	string

IdentityRef

Object

名称	类型	说明
_links	ReferenceLinks	此字段包含有关图形主题的零个或多个有趣的链接。可以调用这些链接以获取有关此图形主题的其他关系或更详细的信息。
descriptor	string	描述符是在系统运行时引用图形主题的主要方法。此字段将唯一标识帐户和组织中的同一图形主题。
directoryAlias	string	已弃用 - 可以通过查询 IdentityRef“_links”字典的“self”条目中引用的 Graph 用户来检索
displayName	string	这是图形主题的非唯一显示名称。若要更改此字段，必须在源提供程序中更改其值。
id	string
imageUrl	string	已弃用 - 在 IdentityRef“_links”字典的“虚拟形象”条目中可用
inactive	boolean	已弃用 - 可以通过查询 GraphUser“_links”字典的“membershipState”条目中引用的 Graph 成员身份状态来检索
isAadIdentity	boolean	已弃用 - 可以从描述符的主题类型推断（Descriptor.IsAadUserType/Descriptor.IsAadGroupType）
isContainer	boolean	已弃用 - 可以从描述符的主题类型推断（描述符.IsGroupType）
isDeletedInOrigin	boolean
profileUrl	string	已弃用 - 不在 ToIdentityRef 的大多数预先存在的实现中使用
uniqueName	string	已弃用 - 请改用 Domain+PrincipalName
url	string	此 URL 是指向此图形主题的源资源的完整路由。

JObject

Object

表示 JSON 对象。

名称	类型	说明
item	JToken	表示抽象 JSON 令牌。
type	string (JTokenType)	获取此 JToken 的节点类型。

JToken

Object

表示抽象 JSON 令牌。

名称	类型	说明
first	JToken	获取此令牌的第一个子令牌。
hasValues	boolean	获取一个值，该值指示此令牌是否具有子令牌。
item	JToken	表示抽象 JSON 令牌。
last	JToken	获取此令牌的最后一个子令牌。
next	JToken	获取此节点的下一个同级标记。
parent	string (JContainer)	获取或设置父级。
path	string	获取 JSON 令牌的路径。
previous	JToken	获取此节点的上一个同级标记。
root	JToken	获取此 JToken 的根 JToken。
type	string (JTokenType)	获取此 JToken 的节点类型。

ReferenceLinks

Object

表示 REST 引用链接集合的类。

名称	类型	说明
links	object	链接的只读视图。由于引用链接是只读的，因此我们只想将其公开为只读链接。

TaskCommandMode

枚举

值	说明
any
restricted

TaskCommandRestrictions

Object

名称	类型	说明
mode	TaskCommandMode

TaskDefinitionReference

Object

名称	类型	说明
definitionType	string	获取或设置定义类型。值可以是“task”或“metaTask”。
id	string (uuid)	获取或设置任务的唯一标识符。
versionSpec	string	获取或设置任务的版本规范。

TaskExecution

Object

名称	类型	说明
execTask	TaskReference	要运行的实用工具任务。指定这意味着此任务定义只是调用另一个任务的元任务。这对于调用 powershell 和命令行等实用工具任务的任务非常有用
platformInstructions	object	如果任务要运行代码，则会提供类型/脚本等...按平台提供的信息。例如，它可能如下所示。 net45： { typeName： “Microsoft.TeamFoundation.Automation.Tasks.PowerShellTask”， assemblyName： “Microsoft.TeamFoundation.Automation.Tasks.PowerShell.dll” } net20： { typeName： “Microsoft.TeamFoundation.Automation.Tasks.PowerShellTask”， assemblyName： “Microsoft.TeamFoundation.Automation.Tasks.PowerShell.dll” } java： { jar： “powershelltask.tasks.automation.teamfoundation.microsoft.com”， } node： { script： “powershellhost.js”， }

TaskGroup

Object

名称	类型	说明
agentExecution	TaskExecution
author	string
category	string
comment	string	获取或设置注释。
contentsUploaded	boolean
contributionIdentifier	string
contributionVersion	string
createdBy	IdentityRef	获取或设置创建者的标识。
createdOn	string (date-time)	获取或设置创建日期。
dataSourceBindings	DataSourceBinding[]
definitionType	string
deleted	boolean	获取或设置为“true”，以指示为已删除，否则为“false”。
demands	Demand[]
deprecated	boolean
description	string
disabled	boolean
execution	<string, JObject>
friendlyName	string
groups	TaskGroupDefinition[]
helpMarkDown	string
helpUrl	string
hostType	string
iconUrl	string
id	string (uuid)
inputs	TaskInputDefinition[]
instanceNameFormat	string
minimumAgentVersion	string
modifiedBy	IdentityRef	获取或设置修改的标识。
modifiedOn	string (date-time)	获取或设置修改日期。
name	string
outputVariables	TaskOutputVariable[]
owner	string	获取或设置所有者。
packageLocation	string
packageType	string
parentDefinitionId	string (uuid)	获取或设置父任务组 ID。创建草稿任务组时会用到它。
postJobExecution	<string, JObject>
preJobExecution	<string, JObject>
preview	boolean
releaseNotes	string
restrictions	TaskRestrictions
revision	integer (int32)	获取或设置修订。
runsOn	string[]
satisfies	string[]
serverOwned	boolean
showEnvironmentVariables	boolean
sourceDefinitions	TaskSourceDefinition[]
sourceLocation	string
tasks	TaskGroupStep[]	获取或设置任务。
version	TaskVersion
visibility	string[]

TaskGroupDefinition

Object

名称	类型	说明
displayName	string
isExpanded	boolean
name	string
tags	string[]
visibleRule	string

TaskGroupStep

Object

表示任务组中的任务。

名称	类型	说明
alwaysRun	boolean	获取或设置为“true”以始终运行任务，否则为“false”。
condition	string	获取或设置任务的条件。
continueOnError	boolean	获取或设置为“true”以在错误时继续，否则为“false”。
displayName	string	获取或设置显示名称。
enabled	boolean	获取或设置为启用或未启用任务。
environment	object	获取环境变量的字典。
inputs	object	获取或设置输入的字典。
retryCountOnTaskFailure	integer (int32)	获取或设置最大重试次数
task	TaskDefinitionReference	获取或设置任务的引用。
timeoutInMinutes	integer (int32)	获取或设置任务在服务器取消之前允许在代理上执行的最长时间（以分钟为单位）。零值表示无限超时。

TaskGroupUpdateParameter

Object

名称	类型	说明
author	string	设置任务组的作者名称。
category	string	设置任务组的类别。
comment	string	设置任务组的注释。
description	string	设置任务组的说明。
friendlyName	string	设置任务组的友好名称。
iconUrl	string	设置任务组的 URL 图标。
id	string (uuid)	设置此字段的唯一标识符。
inputs	TaskInputDefinition[]	设置任务组的输入。
instanceNameFormat	string	设置任务组的显示名称。
name	string	设置任务组的名称。
parentDefinitionId	string (uuid)	获取或设置父任务组 ID。创建草稿任务组时会用到它。
revision	integer (int32)	设置任务组的修订。
runsOn	string[]	设置任务组的 RunsOn。值可以是“Agent”、“Server”或“DeploymentGroup”。
tasks	TaskGroupStep[]	设置任务组的任务。
version	TaskVersion	设置任务组的版本。

TaskInputDefinition

Object

名称	类型	说明
aliases	string[]
defaultValue	string
groupName	string
helpMarkDown	string
label	string
name	string
options	object
properties	object
required	boolean
type	string
validation	TaskInputValidation
visibleRule	string

TaskInputValidation

Object

名称	类型	说明
expression	string	条件表达式
message	string	说明验证失败时用户如何更正的消息

TaskOutputVariable

Object

名称	类型	说明
description	string
name	string

TaskReference

Object

对任务的引用。

名称	类型	说明
id	string (uuid)	任务定义的 ID。对应于 task.json 文件的 ID 值。示例：CmdLineV2 { “id”： “D9BAFED4-0B18-4F58-968D-86655B4D2CE9” }
inputs	object	特定于任务定义的输入的字典。对应于 task.json 文件的输入值。
name	string	任务定义的名称。对应于 task.json 文件的名称值。示例：CmdLineV2 { “name”： “CmdLine” }
version	string	任务定义的版本。对应于 task.json 文件的版本值。示例：CmdLineV2 { “version”： { “Major”： 2， “Minor”： 212， “Patch”： 0 } }

TaskRestrictions

Object

名称	类型	说明
commands	TaskCommandRestrictions
settableVariables	TaskVariableRestrictions

TaskSourceDefinition

Object

名称	类型	说明
authKey	string
endpoint	string
keySelector	string
selector	string
target	string

TaskVariableRestrictions

Object

名称	类型	说明
allowed	string[]

TaskVersion

Object

名称	类型	说明
isTest	boolean
major	integer (int32)
minor	integer (int32)
patch	integer (int32)

通过

Taskgroups - Update

URI 参数

请求正文

响应

安全性

oauth2

作用域

示例

Update a task group

示例请求

示例响应

定义

AuthorizationHeader

DataSourceBinding

Demand

IdentityRef

JObject

JToken

ReferenceLinks

TaskCommandMode

TaskCommandRestrictions

TaskDefinitionReference

TaskExecution

TaskGroup

TaskGroupDefinition

TaskGroupStep

TaskGroupUpdateParameter

TaskInputDefinition

TaskInputValidation

TaskOutputVariable

TaskReference

TaskRestrictions

TaskSourceDefinition

TaskVariableRestrictions

TaskVersion

其他资源