Targets - Get
按部署组中的 ID 获取部署目标
GET https://dev.azure.com/{organization}/{project}/_apis/distributedtask/deploymentgroups/{deploymentGroupId}/targets/{targetId}?api-version=7.1-preview.1
GET https://dev.azure.com/{organization}/{project}/_apis/distributedtask/deploymentgroups/{deploymentGroupId}/targets/{targetId}?$expand={$expand}&api-version=7.1-preview.1
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
deployment
|
path | True |
integer int32 |
部署目标所属的部署组的 ID。 |
organization
|
path | True |
string |
Azure DevOps 组织的名称。 |
project
|
path | True |
string |
项目 ID 或项目名称 |
target
|
path | True |
integer int32 |
要返回的部署目标的 ID。 |
api-version
|
query | True |
string |
要使用的 API 版本。 应将其设置为“7.1-preview.1”才能使用此版本的 API。 |
$expand
|
query |
在返回的对象中包含这些附加详细信息。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
成功的操作 |
安全性
oauth2
Type:
oauth2
Flow:
accessCode
Authorization URL:
https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token 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
Scopes
名称 | 说明 |
---|---|
vso.machinegroup_manage | 提供管理部署组和代理池的功能 |
示例
Get a deployment target by its ID
Sample Request
GET https://dev.azure.com/fabrikam/{project}/_apis/distributedtask/deploymentgroups/{deploymentGroupId}/targets/{targetId}?api-version=7.1-preview.1
Sample Response
{
"tags": [
"web"
],
"id": 5,
"agent": {
"_links": {
"self": {
"href": "https://dev.azure.com/fabrikam/_apis/distributedtask/pools/17/agents/5"
},
"web": {
"href": "https://dev.azure.com/fabrikam/_admin/_AgentPool#_a=agents&poolId=17&agentId=5"
}
},
"maxParallelism": 1,
"createdOn": "2018-02-19T09:19:41.053Z",
"authorization": {
"clientId": "0f386203-17f5-45a6-8c72-d35b54011fe3",
"publicKey": {
"exponent": "AQAB",
"modulus": "6O7UGxhRniv3tmXJ/1kaEkZdbcNQabJBJxj3EhPNsBJuduYZt3OixVTI/X5r1C2ogAr0nQon2UP3HKNQ9bkY7fNAY8VfggOTytu4ZfFcTJABvc5X8pHefWfO2DVqOUJH6HpyOtP5C+b2OGuhzTlEJHv6FrJPWxbK1HEo0w6VQg4CI8VqyCY9pvT6ZTrZTSg1Hp4uGF/kDHtUk0GvYWA2hZJyk/VbX7hH1PhwpRHuIEUsT0TcJzrR+7n0gdLDGeNLYqBMmTXIMm6jv7pUdnOumI9FK9hChw3JbP44jVxlxGbV8kh+IKAX/S3+pdkCNOiKzkXIDtUu/3vWiqx6+v8mIQ=="
}
},
"id": 5,
"name": "demoTarget1",
"version": "2.127.0",
"osDescription": "Microsoft Windows 10.0.14393 ",
"enabled": true,
"status": "online"
}
}
定义
名称 | 说明 |
---|---|
Demand | |
Deployment |
部署目标。 |
Deployment |
在返回的对象中包含这些附加详细信息。 |
Identity |
|
JObject |
表示 JSON 对象。 |
JToken |
表示抽象的 JSON 令牌。 |
Package |
|
Properties |
类将属性包表示为键值对的集合。 接受所有基元类型的值 (除 |
Reference |
表示 REST 引用链接集合的类。 |
Task |
任务代理。 |
Task |
提供使用 OAuth 2.0 身份验证流授权代理所需的数据。 |
Task |
|
Task |
代理的作业请求。 |
Task |
其他池设置和详细信息 |
Task |
|
Task |
获取或设置池的类型 |
Task |
表示 RSA 非对称密钥的公钥部分。 |
Task |
对代理的引用。 |
Task |
代理是否处于联机状态。 |
Task |
有关代理更新的详细信息。 |
Task |
|
Task |
|
Task |
|
Task |
此请求的结果。 |
Demand
名称 | 类型 | 说明 |
---|---|---|
name |
string |
|
value |
string |
DeploymentMachine
部署目标。
名称 | 类型 | 说明 |
---|---|---|
agent |
部署代理。 |
|
id |
integer |
部署目标标识符。 |
properties |
部署目标的属性。 |
|
tags |
string[] |
部署目标的标记。 |
DeploymentTargetExpands
在返回的对象中包含这些附加详细信息。
名称 | 类型 | 说明 |
---|---|---|
assignedRequest |
string |
包括分配给部署代理的作业请求。 |
capabilities |
string |
包括部署代理的功能。 |
lastCompletedRequest |
string |
包括部署代理上次完成的作业请求。 |
none |
string |
没有其他属性。 |
IdentityRef
名称 | 类型 | 说明 |
---|---|---|
_links |
此字段包含有关图形主题的零个或多个相关链接。 可以调用这些链接来获取有关此图主题的其他关系或更多详细信息。 |
|
descriptor |
string |
描述符是在系统运行时引用图形主题的主要方式。 此字段将唯一标识帐户和组织中的同一图形主题。 |
directoryAlias |
string |
已弃用 - 可通过查询 IdentityRef“_links”字典的“self”条目中引用的 Graph 用户来检索 |
displayName |
string |
这是图形主题的非唯一显示名称。 若要更改此字段,必须在源提供程序中更改其值。 |
id |
string |
|
imageUrl |
string |
已弃用 - 在 IdentityRef“_links”字典的“头像”条目中可用 |
inactive |
boolean |
已弃用 - 可以通过查询 GraphUser“_links”字典的“membershipState”条目中引用的 Graph 成员身份状态来检索 |
isAadIdentity |
boolean |
已弃用 - 可以从描述符的主题类型推断 (描述符.IsAadUserType/Descriptor.IsAadGroupType) |
isContainer |
boolean |
已弃用 - 可以从描述符的主题类型推断 (描述符.IsGroupType) |
isDeletedInOrigin |
boolean |
|
profileUrl |
string |
已弃用 - 未在 ToIdentityRef 的大多数预先存在的实现中使用 |
uniqueName |
string |
已弃用 - 改用 Domain+PrincipalName |
url |
string |
此 URL 是此图主题的源资源的完整路由。 |
JObject
表示 JSON 对象。
名称 | 类型 | 说明 |
---|---|---|
item |
表示抽象的 JSON 令牌。 |
|
type |
string |
获取此 JToken 的节点类型。 |
JToken
表示抽象的 JSON 令牌。
名称 | 类型 | 说明 |
---|---|---|
first |
获取此令牌的第一个子令牌。 |
|
hasValues |
boolean |
获取一个值,该值指示此令牌是否具有子令牌。 |
item |
表示抽象的 JSON 令牌。 |
|
last |
获取此令牌的最后一个子令牌。 |
|
next |
获取此节点的下一个同级标记。 |
|
parent |
string |
获取或设置父对象。 |
path |
string |
获取 JSON 令牌的路径。 |
previous |
获取此节点的上一个同级标记。 |
|
root |
获取此 JToken 的根 JToken。 |
|
type |
string |
获取此 JToken 的节点类型。 |
PackageVersion
名称 | 类型 | 说明 |
---|---|---|
major |
integer |
|
minor |
integer |
|
patch |
integer |
PropertiesCollection
类将属性包表示为键值对的集合。 接受所有基元类型的值 (除 TypeCode != TypeCode.Object
) 以外的 DBNull
任何类型。 Byte[]、Int32、Double、DateType 和 String 类型的值保留其类型,其他基元将重新优化为 String。 Byte[] 预期为 base64 编码字符串。
名称 | 类型 | 说明 |
---|---|---|
count |
integer |
集合中属性的计数。 |
item |
object |
|
keys |
string[] |
集合中的键集。 |
values |
string[] |
集合中的值集。 |
ReferenceLinks
表示 REST 引用链接集合的类。
名称 | 类型 | 说明 |
---|---|---|
links |
object |
链接的只读视图。 由于引用链接是只读的,因此我们只想将其公开为只读。 |
TaskAgent
任务代理。
名称 | 类型 | 说明 |
---|---|---|
_links |
表示 REST 引用链接集合的类。 |
|
accessPoint |
string |
此代理的接入点。 |
assignedAgentCloudRequest |
当前与此代理关联的代理云请求。 |
|
assignedRequest |
当前分配给此代理的请求。 |
|
authorization |
此代理的授权信息。 |
|
createdOn |
string |
创建此代理的日期。 |
enabled |
boolean |
此代理是否应运行作业。 |
id |
integer |
代理的标识符。 |
lastCompletedRequest |
此代理完成的最后一个请求。 |
|
maxParallelism |
integer |
此代理允许的最大作业并行度。 |
name |
string |
代理的名称。 |
osDescription |
string |
代理 OS。 |
pendingUpdate |
此代理的挂起更新。 |
|
properties |
类将属性包表示为键值对的集合。 接受所有基元类型的值 (除 |
|
provisioningState |
string |
此代理的预配状态。 |
status |
代理是否处于联机状态。 |
|
statusChangedOn |
string |
发生上次连接状态更改的日期。 |
systemCapabilities |
object |
此代理主机支持的系统定义功能。 警告:若要使用 PUT 方法设置功能,PUT 将完全覆盖现有功能。 |
userCapabilities |
object |
此代理主机支持的用户定义功能。 警告:若要使用 PUT 方法设置功能,PUT 将完全覆盖现有功能。 |
version |
string |
代理版本。 |
TaskAgentAuthorization
提供使用 OAuth 2.0 身份验证流授权代理所需的数据。
名称 | 类型 | 说明 |
---|---|---|
authorizationUrl |
string |
用于从配置的令牌服务获取访问令牌的终结点。 |
clientId |
string |
此代理的客户端标识符。 |
publicKey |
用于验证此代理身份的公钥。 |
TaskAgentCloudRequest
名称 | 类型 | 说明 |
---|---|---|
agent |
对代理的引用。 |
|
agentCloudId |
integer |
|
agentConnectedTime |
string |
|
agentData |
表示 JSON 对象。 |
|
agentSpecification |
表示 JSON 对象。 |
|
pool | ||
provisionRequestTime |
string |
|
provisionedTime |
string |
|
releaseRequestTime |
string |
|
requestId |
string |
TaskAgentJobRequest
代理的作业请求。
名称 | 类型 | 说明 |
---|---|---|
agentSpecification |
表示 JSON 对象。 |
|
assignTime |
string |
分配此请求的日期/时间。 |
data |
object |
有关请求的其他数据。 |
definition |
与此请求关联的管道定义 |
|
demands |
Demand[] |
满足此请求所需的要求列表。 |
finishTime |
string |
完成此请求的日期/时间。 |
hostId |
string |
触发此请求的主机。 |
jobId |
string |
由此请求生成的作业的 ID。 |
jobName |
string |
由此请求生成的作业的名称。 |
lockedUntil |
string |
代理续订锁的截止时间。 |
matchedAgents |
对代理的引用。 |
|
matchesAllAgentsInPool |
boolean |
|
orchestrationId |
string |
|
owner |
与此请求关联的管道 |
|
planGroup |
string |
|
planId |
string |
与此请求连接的业务流程计划的内部 ID。 |
planType |
string |
表示业务流程计划类型的内部详细信息。 |
poolId |
integer |
此请求面向的池的 ID |
priority |
integer |
|
queueId |
integer |
此请求面向的队列的 ID |
queueTime |
string |
此请求排队的日期/时间。 |
receiveTime |
string |
代理取消此请求的日期/时间。 |
requestId |
integer |
请求的 ID。 |
reservedAgent |
为此请求分配的代理。 |
|
result |
此请求的结果。 |
|
scopeId |
string |
管道的范围;匹配项目 ID。 |
serviceOwner |
string |
拥有此请求的服务。 |
statusMessage |
string |
|
userDelayed |
boolean |
TaskAgentPoolOptions
其他池设置和详细信息
名称 | 类型 | 说明 |
---|---|---|
elasticPool |
string |
由弹性池服务支持的 TaskAgentPool |
none |
string |
|
preserveAgentOnJobFailure |
string |
如果在 TaskAgentJobRequest 失败后保留代理进行调查,则设置为 true |
singleUseAgents |
string |
如果代理在每个 TaskAgentJobRequest 之后重新映像,则设置为 true |
TaskAgentPoolReference
名称 | 类型 | 说明 |
---|---|---|
id |
integer |
|
isHosted |
boolean |
获取或设置一个值,该值指示此池是否由服务管理。 |
isLegacy |
boolean |
确定池是否为旧池。 |
name |
string |
|
options |
其他池设置和详细信息 |
|
poolType |
获取或设置池的类型 |
|
scope |
string |
|
size |
integer |
获取池的当前大小。 |
TaskAgentPoolType
获取或设置池的类型
名称 | 类型 | 说明 |
---|---|---|
automation |
string |
典型的任务代理池 |
deployment |
string |
部署池 |
TaskAgentPublicKey
表示 RSA 非对称密钥的公钥部分。
名称 | 类型 | 说明 |
---|---|---|
exponent |
string[] |
获取或设置公钥的指数。 |
modulus |
string[] |
获取或设置公钥的模数。 |
TaskAgentReference
对代理的引用。
名称 | 类型 | 说明 |
---|---|---|
_links |
表示 REST 引用链接集合的类。 |
|
accessPoint |
string |
此代理的接入点。 |
enabled |
boolean |
此代理是否应运行作业。 |
id |
integer |
代理的标识符。 |
name |
string |
代理的名称。 |
osDescription |
string |
代理 OS。 |
provisioningState |
string |
此代理的预配状态。 |
status |
代理是否处于联机状态。 |
|
version |
string |
代理版本。 |
TaskAgentStatus
代理是否处于联机状态。
名称 | 类型 | 说明 |
---|---|---|
offline |
string |
|
online |
string |
TaskAgentUpdate
有关代理更新的详细信息。
名称 | 类型 | 说明 |
---|---|---|
currentState |
string |
此代理更新的当前状态。 |
reason |
此更新的原因。 |
|
requestTime |
string |
请求此更新的日期。 |
requestedBy |
请求此更新的标识。 |
|
sourceVersion |
更新的源代理版本。 |
|
targetVersion |
更新的目标代理版本。 |
TaskAgentUpdateReason
名称 | 类型 | 说明 |
---|---|---|
code |
TaskAgentUpdateReasonType
名称 | 类型 | 说明 |
---|---|---|
downgrade |
string |
|
manual |
string |
|
minAgentVersionRequired |
string |
TaskOrchestrationOwner
名称 | 类型 | 说明 |
---|---|---|
_links |
表示 REST 引用链接集合的类。 |
|
id |
integer |
|
name |
string |
TaskResult
此请求的结果。
名称 | 类型 | 说明 |
---|---|---|
abandoned |
string |
|
canceled |
string |
|
failed |
string |
|
skipped |
string |
|
succeeded |
string |
|
succeededWithIssues |
string |
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈