Targets - Get

Service:

Task Agent

API Version:

5.0-preview.1

依部署群組中的識別碼取得部署目標

GET https://dev.azure.com/{organization}/{project}/_apis/distributedtask/deploymentgroups/{deploymentGroupId}/targets/{targetId}?api-version=5.0-preview.1

With optional parameters:

GET https://dev.azure.com/{organization}/{project}/_apis/distributedtask/deploymentgroups/{deploymentGroupId}/targets/{targetId}?$expand={$expand}&api-version=5.0-preview.1

URI 參數

名稱	位於	必要	類型	Description
deploymentGroupId	path	True	integer int32	部署目標所屬部署群組的識別碼。
organization	path	True	string	Azure DevOps 組織的名稱。
project	path	True	string	專案識別碼或專案名稱
targetId	path	True	integer int32	要傳回之部署目標的識別碼。
api-version	query	True	string	要使用的 API 版本。 這應該設定為 '5.0-preview.1'，以使用此版本的 API。
$expand	query		DeploymentTargetExpands	在傳回的物件中包含這些其他詳細資料。

回應

名稱	類型	Description
200 OK	DeploymentMachine	成功作業

安全性

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

名稱	Description
vso.machinegroup_manage	提供管理部署群組和代理程式組件區的能力

範例

Get a deployment target by its ID

Sample Request

HTTP

GET https://dev.azure.com/fabrikam/{project}/_apis/distributedtask/deploymentgroups/{deploymentGroupId}/targets/{targetId}?api-version=5.0-preview.1

Sample Response

Status code:

200

{
  "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"
  }
}

定義

名稱	Description
Demand
DeploymentMachine	部署目標。
DeploymentTargetExpands	在傳回的物件中包含這些其他詳細資料。
IdentityRef
JObject
JToken
PackageVersion
PropertiesCollection	類別會將屬性包表示為索引鍵/值組的集合。 所有基本型別的值都會 (接受任何具有 TypeCode != TypeCode.Object) DBNull 的型別。 Byte[]、Int32、Double、DateType 和 String 類型的值會保留其類型，其他基本類型會重新調整為 String。 Byte[] 預期為 base64 編碼字串。
ReferenceLinks	表示 REST 參考連結集合的類別。
TaskAgent
TaskAgentAuthorization	提供使用 OAuth 2.0 驗證流程授權代理程式所需的資料。
TaskAgentCloudRequest
TaskAgentDelaySource
TaskAgentJobRequest
TaskAgentPoolReference
TaskAgentPoolType	取得或設定集區的型別
TaskAgentPublicKey	表示 RSA 非對稱金鑰的公開金鑰部分。
TaskAgentReference
TaskAgentStatus	取得代理程式的目前線上狀態。
TaskAgentUpdate
TaskAgentUpdateReason
TaskAgentUpdateReasonType
TaskOrchestrationOwner
TaskResult

Demand

名稱	類型	Description
name	string
value	string

DeploymentMachine

部署目標。

名稱	類型	Description
agent	TaskAgent	部署代理程式。
id	integer	部署目標識別碼。
tags	string[]	部署目標的標記。

DeploymentTargetExpands

在傳回的物件中包含這些其他詳細資料。

名稱	類型	Description
assignedRequest	string	包含指派給部署代理程式的作業要求。
capabilities	string	包含部署代理程式的功能。
lastCompletedRequest	string	包含部署代理程式的最後一個已完成作業要求。
none	string	沒有其他屬性。

IdentityRef

名稱	類型	Description
_links	ReferenceLinks	此欄位包含圖表主旨的相關零或更多有趣連結。 您可以叫用這些連結來取得其他關聯性，或取得此圖表主體的詳細資訊。
descriptor	string	描述項是在系統執行時參考圖形主旨的主要方式。 此欄位可唯一識別帳戶和組織之間的相同圖表主旨。
directoryAlias	string
displayName	string	這是圖形主體的非唯一顯示名稱。 若要變更此欄位，您必須變更來源提供者中的值。
id	string
imageUrl	string
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string	此 URL 是此圖形主體來源資源的完整路由。

JObject

名稱	類型	Description
item	JToken
type	string

JToken

名稱	類型	Description
first	JToken
hasValues	boolean
item	JToken
last	JToken
next	JToken
parent	string
path	string
previous	JToken
root	JToken
type	string

PackageVersion

名稱	類型	Description
major	integer
minor	integer
patch	integer

PropertiesCollection

類別會將屬性包表示為索引鍵/值組的集合。 所有基本型別的值都會 (接受任何具有 TypeCode != TypeCode.Object) DBNull 的型別。 Byte[]、Int32、Double、DateType 和 String 類型的值會保留其類型，其他基本類型會重新調整為 String。 Byte[] 預期為 base64 編碼字串。

名稱	類型	Description
count	integer	集合中屬性的計數。
item	object
keys	string[]	集合中的索引鍵集合。
values	string[]	集合中的值集。

ReferenceLinks

表示 REST 參考連結集合的類別。

名稱	類型	Description
links	object	連結的唯讀檢視。 因為參考連結是唯讀的，所以我們只想要將它們公開為唯讀。

TaskAgent

名稱	類型	Description
_links	ReferenceLinks	表示 REST 參考連結集合的類別。
accessPoint	string	取得代理程式的存取點。
assignedAgentCloudRequest	TaskAgentCloudRequest	取得目前與此代理程式相關聯的代理程式雲端要求
assignedRequest	TaskAgentJobRequest	取得目前指派給這個代理程式的要求。
authorization	TaskAgentAuthorization	取得或設定這個代理程式的授權資訊。
createdOn	string	取得建立此代理程式的日期。
enabled	boolean	取得或設定值，指出是否應該啟用此代理程式來執行作業。
id	integer	取得代理程式的識別碼。
lastCompletedRequest	TaskAgentJobRequest	取得這個代理程式已完成的最後一個要求。
maxParallelism	integer	取得或設定此主機上允許的最大作業平行處理原則。
name	string	取得代理程式的名稱。
oSDescription	string	取得代理程式的 OS。
pendingUpdate	TaskAgentUpdate	取得這個代理程式的擱置更新。
properties	PropertiesCollection	類別會將屬性包表示為索引鍵/值組的集合。 所有基本型別的值都會 (接受任何具有 TypeCode != TypeCode.Object) DBNull 的型別。 Byte[]、Int32、Double、DateType 和 String 類型的值會保留其類型，其他基本類型會重新調整為 String。 Byte[] 預期為 base64 編碼字串。
provisioningState	string	取得或設定這個代理程式的目前布建狀態
status	TaskAgentStatus	取得代理程式的目前線上狀態。
statusChangedOn	string	取得上次發生線上狀態變更的日期。
systemCapabilities	object
userCapabilities	object
version	string	取得代理程式的版本。

TaskAgentAuthorization

提供使用 OAuth 2.0 驗證流程授權代理程式所需的資料。

名稱	類型	Description
authorizationUrl	string	取得或設定用來從已設定權杖服務取得存取權杖的端點。
clientId	string	取得或設定這個代理程式的用戶端識別碼。
publicKey	TaskAgentPublicKey	取得或設定用來驗證此代理程式的身分識別的公開金鑰。

TaskAgentCloudRequest

名稱	類型	Description
agent	TaskAgentReference
agentCloudId	integer
agentConnectedTime	string
agentData	JObject
agentSpecification	JObject
pool	TaskAgentPoolReference
provisionRequestTime	string
provisionedTime	string
releaseRequestTime	string
requestId	string

TaskAgentDelaySource

名稱	類型	Description
delays	string[]
taskAgent	TaskAgentReference

TaskAgentJobRequest

名稱	類型	Description
agentDelays	TaskAgentDelaySource[]
agentSpecification	JObject
assignTime	string
data	object
definition	TaskOrchestrationOwner
demands	Demand[]
expectedDuration	string
finishTime	string
hostId	string
jobId	string
jobName	string
lockedUntil	string
matchedAgents	TaskAgentReference[]
orchestrationId	string
owner	TaskOrchestrationOwner
planGroup	string
planId	string
planType	string
poolId	integer
queueId	integer
queueTime	string
receiveTime	string
requestId	integer
reservedAgent	TaskAgentReference
result	TaskResult
scopeId	string
serviceOwner	string

TaskAgentPoolReference

名稱	類型	Description
id	integer
isHosted	boolean	取得或設定值，指出此集區是否由服務管理。
name	string
poolType	TaskAgentPoolType	取得或設定集區的型別
scope	string
size	integer	取得集區的目前大小。

TaskAgentPoolType

取得或設定集區的型別

名稱	類型	Description
automation	string
deployment	string

TaskAgentPublicKey

表示 RSA 非對稱金鑰的公開金鑰部分。

名稱	類型	Description
exponent	string[]	取得或設定公開金鑰的指數。
modulus	string[]	取得或設定公開金鑰的模數。

TaskAgentReference

名稱	類型	Description
_links	ReferenceLinks	表示 REST 參考連結集合的類別。
accessPoint	string	取得代理程式的存取點。
enabled	boolean	取得或設定值，指出是否應該啟用此代理程式來執行作業。
id	integer	取得代理程式的識別碼。
name	string	取得代理程式的名稱。
oSDescription	string	取得代理程式的 OS。
provisioningState	string	取得或設定這個代理程式的目前布建狀態
status	TaskAgentStatus	取得代理程式的目前線上狀態。
version	string	取得代理程式的版本。

TaskAgentStatus

取得代理程式的目前線上狀態。

名稱	類型	Description
offline	string
online	string

TaskAgentUpdate

名稱	類型	Description
currentState	string	此代理程式更新的目前狀態
reason	TaskAgentUpdateReason	此代理程式更新的原因
requestTime	string	取得要求此代理程式更新的日期。
requestedBy	IdentityRef	要求代理程式更新的身分識別
sourceVersion	PackageVersion	取得或設定代理程式更新的來源代理程式版本
targetVersion	PackageVersion	取得或設定代理程式更新的目標代理程式版本

TaskAgentUpdateReason

名稱	類型	Description
code	TaskAgentUpdateReasonType

TaskAgentUpdateReasonType

名稱	類型	Description
manual	string
minAgentVersionRequired	string

TaskOrchestrationOwner

名稱	類型	Description
_links	ReferenceLinks	表示 REST 參考連結集合的類別。
id	integer
name	string

TaskResult

名稱	類型	Description
abandoned	string
canceled	string
failed	string
skipped	string
succeeded	string
succeededWithIssues	string