Consumers - Get Consumer Action

参考

服务:: Service Hooks

API 版本:: 7.1

获取有关特定使用者作的详细信息。

GET https://dev.azure.com/{organization}/_apis/hooks/consumers/{consumerId}/actions/{consumerActionId}?api-version=7.1

具有可选参数:

GET https://dev.azure.com/{organization}/_apis/hooks/consumers/{consumerId}/actions/{consumerActionId}?publisherId={publisherId}&api-version=7.1

URI 参数

名称	在	必需	类型	说明
consumerActionId	path	True	string	consumerActionId 的 ID。
consumerId	path	True	string	使用者的 ID。
organization	path	True	string	Azure DevOps 组织的名称。
api-version	query	True	string	要使用的 API 版本。这应设置为“7.1”才能使用此版本的 API。
publisherId	query		string

响应

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

安全性

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.work	授予读取工作项、查询、版块、区域和迭代路径以及其他工作项跟踪相关元数据的能力。此外，还授予执行查询、搜索工作项以及通过服务挂钩接收有关工作项事件的通知的能力。
vso.build	授予访问生成项目（包括生成结果、定义和请求）的能力，以及通过服务挂钩接收有关生成事件的通知的能力。
vso.code	授予读取有关提交、更改集、分支和其他版本控制项目的源代码和元数据的能力。此外，还可以通过服务挂钩搜索代码并获取有关版本控制事件的通知。

示例

示例请求

HTTP

GET https://dev.azure.com/fabrikam/_apis/hooks/consumers/zendesk/actions/createPrivateComment?api-version=7.1

示例响应

状态代码:: 200

{
  "id": "createPrivateComment",
  "consumerId": "zendesk",
  "url": "https://dev.azure.com/fabrikam/_apis/hooks/consumers/zendesk/actions/createPrivateComment",
  "name": "Create a private comment in a ticket",
  "description": "Create a private comment in a ticket. <a href='http://go.microsoft.com/fwlink/?LinkId=396756'>Learn more.</a>",
  "supportedEventTypes": [
    "workitem.commented"
  ],
  "supportedResourceVersions": {
    "workitem.commented": [
      "1.0-preview.1"
    ]
  },
  "inputDescriptors": []
}

定义

名称	说明
ConsumerAction	定义使用者作的数据协定。
InputDataType	获取或设置要验证的数据类型。
InputDescriptor	描述订阅的输入。
InputMode	应输入此输入值的模式
InputValidation	描述哪些值对订阅输入有效
InputValue	有关输入的单个值的信息
InputValues	有关给定订阅输入的可能/允许值的信息
InputValuesError	与订阅输入值相关的错误信息。
ReferenceLinks	表示 REST 引用链接集合的类。

ConsumerAction

Object

定义使用者作的数据协定。

名称	类型	说明
_links	ReferenceLinks	参考链接
allowResourceVersionOverride	boolean	获取或设置指示创建或编辑订阅时是否可以重写资源版本的标志。
consumerId	string	获取或设置此作所属的使用者的标识符。
description	string	获取或设置此作的本地化说明。
id	string	获取或设置此作的标识符。
inputDescriptors	InputDescriptor[]	获取或设置此作的输入描述符。
name	string	获取或设置此作的本地化名称。
supportedEventTypes	string[]	获取或设置此作支持的事件标识符。
supportedResourceVersions	object	获取或设置此作支持的资源版本。
url	string	此资源的 URL

InputDataType

枚举

获取或设置要验证的数据类型。

值	说明
boolean	表示 true 或 false 的值。
guid	表示 Guid。
none	未指定任何数据类型。
number	表示数值。
string	表示文本值。
uri	表示 URI。

InputDescriptor

Object

描述订阅的输入。

名称	类型	说明
dependencyInputIds	string[]	此输入值所依赖的所有输入的 ID。
description	string	此输入用途的说明
groupName	string	此输入所属的组本地化名称，并可以显示为容器的标头，该标头将包含组中的所有输入。
hasDynamicValueInformation	boolean	如果为 true，则此输入的值信息是动态的，应在依赖项输入的值发生更改时提取。
id	string	订阅输入的标识符
inputMode	InputMode	应输入此输入值的模式
isConfidential	boolean	获取此输入是否为机密，例如密码或应用程序密钥
name	string	本地化名称，可以显示为订阅输入的标签
properties	object	服务提供程序可以使用的输入的自定义属性
type	string	输入值的基础数据类型。指定此值时，InputMode、验证和值是可选的。
useInDefaultDescription	boolean	获取此输入是否包含在默认生成的作说明中。
validation	InputValidation	用于验证此输入值的信息
valueHint	string	输入值的提示。它可以在 UI 中用作输入占位符。
values	InputValues	有关此输入的可能值的信息

InputMode

枚举

应输入此输入值的模式

值	说明
checkBox	应显示复选框（对于 true/false 值）
combo	应显示选择/组合控件
none	不应在 UI 中显示此输入
passwordBox	应显示密码输入框
radioButtons	应显示单选按钮
textArea	应显示多行文本区域
textBox	应显示输入文本框

InputValidation

Object

描述哪些值对订阅输入有效

名称	类型	说明
dataType	InputDataType	获取或设置要验证的数据类型。
isRequired	boolean	获取或设置此字段是否为必需字段。
maxLength	integer (int32)	获取或设置此描述符的最大长度。
maxValue	string (decimal)	获取或设置此描述符的最小值。
minLength	integer (int32)	获取或设置此描述符的最小长度。
minValue	string (decimal)	获取或设置此描述符的最小值。
pattern	string	获取或设置要验证的模式。
patternMismatchErrorMessage	string	获取或设置模式不匹配时的错误。

InputValue

Object

有关输入的单个值的信息

名称	类型	说明
data	object	有关此输入的任何其他数据
displayValue	string	要显示此值的文本
value	string	要存储此输入的值

InputValues

Object

有关给定订阅输入的可能/允许值的信息

名称	类型	说明
defaultValue	string	用于此输入的默认值
error	InputValuesError	计算动态值时遇到的错误。
inputId	string	输入的 ID
isDisabled	boolean	应禁用此输入
isLimitedToPossibleValues	boolean	如果该值限制为 PossibleValues （True）中的值之一，或者是 PossibleValues 中的值只是一个建议（False）
isReadOnly	boolean	应将此输入设为只读
possibleValues	InputValue[]	此输入可以采用的可能值

InputValuesError

Object

与订阅输入值相关的错误信息。

名称	类型	说明
message	string	错误消息。

ReferenceLinks

Object

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

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

通过

Consumers - Get Consumer Action

URI 参数

响应

安全性

oauth2

作用域

示例

示例请求

示例响应

定义

ConsumerAction

InputDataType

InputDescriptor

InputMode

InputValidation

InputValue

InputValues

InputValuesError

ReferenceLinks

其他资源