Manual Interventions - Get

参考

服务:: Release

API 版本:: 7.1

获取给定版本的手动干预和手动干预 ID。

GET https://vsrm.dev.azure.com/{organization}/{project}/_apis/Release/releases/{releaseId}/manualinterventions/{manualInterventionId}?api-version=7.1

URI 参数

名称	在	必需	类型	说明
manualInterventionId	path	True	integer (int32)	手动干预的 ID。
organization	path	True	string	Azure DevOps 组织的名称。
project	path	True	string	项目 ID 或项目名称
releaseId	path	True	integer (int32)	版本的 ID。
api-version	query	True	string	要使用的 API 版本。这应设置为“7.1”才能使用此版本的 API。

响应

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

安全性

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.release	授予读取发布项目（包括文件夹、发布、发布定义和发布环境）的能力。

示例

Get manual intervention

示例请求

HTTP

GET https://vsrm.dev.azure.com/fabrikam/A13d3daac-03b8-4a23-9cc4-2c3de65dab63/_apis/Release/releases/{releaseId}/manualinterventions/{manualInterventionId}?api-version=7.1

示例响应

状态代码:: 200

{
  "id": 1,
  "status": "pending",
  "taskInstanceId": "c6500104-7b44-4188-9e1c-8a0a0714152e",
  "comments": null,
  "instructions": "",
  "createdOn": "2017-08-28T13:11:10.007Z",
  "modifiedOn": "2017-08-28T13:11:10.007Z",
  "release": {
    "id": 37,
    "name": "Release-1",
    "_links": {}
  },
  "releaseDefinition": {
    "id": 29,
    "name": "Fabrikam-web-with-MI",
    "_links": {}
  },
  "releaseEnvironment": {
    "id": 100,
    "name": "PROD",
    "_links": {}
  },
  "name": "Manual Intervention"
}

定义

名称	说明
IdentityRef
ManualIntervention
ManualInterventionStatus	获取或设置手动干预的状态。
ProjectReference
ReferenceLinks	表示 REST 引用链接集合的类。
ReleaseDefinitionShallowReference
ReleaseEnvironmentShallowReference
ReleaseShallowReference

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 是指向此图形主题的源资源的完整路由。

ManualIntervention

Object

名称	类型	说明
approver	IdentityRef	获取或设置应批准的身份。
comments	string	获取或设置审批的注释。
createdOn	string (date-time)	获取其创建日期。
id	integer (int32)	获取手动干预的唯一标识符。
instructions	string	获取或设置审批说明。
modifiedOn	string (date-time)	获取修改日期。
name	string	获取或设置名称。
release	ReleaseShallowReference	获取 releaseReference 进行手动干预。
releaseDefinition	ReleaseDefinitionShallowReference	获取 releaseDefinitionReference 进行手动干预。
releaseEnvironment	ReleaseEnvironmentShallowReference	获取 releaseEnvironmentReference 进行手动干预。
status	ManualInterventionStatus	获取或设置手动干预的状态。
taskInstanceId	string (uuid)	获取任务实例标识符。
url	string	获取用于访问手动干预的 URL。

ManualInterventionStatus

枚举

获取或设置手动干预的状态。

值	说明
approved	手动干预已获得批准。
canceled	手动干预已取消。
pending	手动干预处于挂起状态。
rejected	手动干预被拒绝。
unknown	手动干预没有状态集。

ProjectReference

Object

名称	类型	说明
id	string (uuid)	获取此字段的唯一标识符。
name	string	获取项目的名称。

ReferenceLinks

Object

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

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

ReleaseDefinitionShallowReference

Object

名称	类型	说明
_links	ReferenceLinks	获取指向发布定义的相关资源、API 和视图的链接。
id	integer (int32)	获取发布定义的唯一标识符。
name	string	获取或设置发布定义的名称。
path	string	获取或设置发布定义的路径。
projectReference	ProjectReference	获取或设置项目引用。
url	string	获取用于访问发布定义的 REST API URL。

ReleaseEnvironmentShallowReference

Object

名称	类型	说明
_links	ReferenceLinks	获取指向发布环境的相关资源、API 和视图的链接。
id	integer (int32)	获取发布环境的唯一标识符。
name	string	获取或设置发布环境的名称。
url	string	获取用于访问发布环境的 REST API URL。

ReleaseShallowReference

Object

名称	类型	说明
_links	ReferenceLinks	获取指向发布的相关资源、API 和视图的链接。
id	integer (int32)	获取发布的唯一标识符。
name	string	获取或设置发布的名称。
url	string	获取用于访问发布的 REST API URL。

通过

Manual Interventions - Get

URI 参数

响应

安全性

oauth2

作用域

示例

Get manual intervention

示例请求

示例响应

定义

IdentityRef

ManualIntervention

ManualInterventionStatus

ProjectReference

ReferenceLinks

ReleaseDefinitionShallowReference

ReleaseEnvironmentShallowReference

ReleaseShallowReference