Targets - Update

參考

服務:: Task Agent

API 版本:: 5.0-preview.1

更新部署群組中部署目標清單的標記。

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

URI 參數

名稱	位於	必要	類型	Description
deploymentGroupId	path	True	integer int32	部署目標更新所在之部署群組的識別碼。
organization	path	True	string	Azure DevOps 組織的名稱。
project	path	True	string	專案識別碼或專案名稱
api-version	query	True	string	要使用的 API 版本。這應該設定為 '5.0-preview.1'，以使用此版本的 API。

要求本文

名稱	類型	Description
body	DeploymentTargetUpdateParameter[]	部署目標，其標籤為 udpdate。

回應

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

安全性

oauth2

類型: oauth2
Flow: 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

範圍

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

範例

Update tags of a deployment target

範例要求

HTTP

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

[
  {
    "tags": [
      "db",
      "web",
      "newTag5248232320667898861"
    ],
    "id": 7
  },
  {
    "tags": [
      "db",
      "newTag5248232320667898861"
    ],
    "id": 6
  }
]

範例回覆

狀態碼:: 200

{
  "count": 2,
  "value": [
    {
      "tags": [
        "db",
        "newTag5248232320667898861"
      ],
      "id": 6,
      "agent": {
        "_links": {
          "self": {
            "href": "https://dev.azure.com/fabrikam/_apis/distributedtask/pools/17/agents/6"
          },
          "web": {
            "href": "https://dev.azure.com/fabrikam/_admin/_AgentPool#_a=agents&poolId=17&agentId=6"
          }
        },
        "maxParallelism": 1,
        "createdOn": "2018-02-19T09:23:58.267Z",
        "id": 6,
        "name": "demoTarget2",
        "version": "2.127.0",
        "osDescription": "Microsoft Windows 10.0.14393 ",
        "enabled": true,
        "status": "offline"
      }
    },
    {
      "tags": [
        "db",
        "newTag5248232320667898861",
        "web"
      ],
      "id": 7,
      "agent": {
        "_links": {
          "self": {
            "href": "https://dev.azure.com/fabrikam/_apis/distributedtask/pools/17/agents/7"
          },
          "web": {
            "href": "https://dev.azure.com/fabrikam/_admin/_AgentPool#_a=agents&poolId=17&agentId=7"
          }
        },
        "maxParallelism": 1,
        "createdOn": "2018-02-19T09:26:48.11Z",
        "id": 7,
        "name": "demoTarget11",
        "version": "2.127.0",
        "osDescription": "Microsoft Windows 10.0.14393 ",
        "enabled": true,
        "status": "offline"
      }
    }
  ]
}

定義

名稱	Description
Demand
DeploymentMachine	部署目標。
DeploymentTargetUpdateParameter	部署目標更新參數。
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

Object

名稱	類型	Description
name	string
value	string

DeploymentMachine

Object

部署目標。

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

DeploymentTargetUpdateParameter

Object

部署目標更新參數。

名稱	類型	Description
id	integer	部署目標的識別碼。
tags	string[]

IdentityRef

Object

名稱	類型	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

Object

名稱	類型	Description
item	JToken
type	string

JToken

Object

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

PackageVersion

Object

名稱	類型	Description
major	integer
minor	integer
patch	integer

PropertiesCollection

Object

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

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

ReferenceLinks

Object

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

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

TaskAgent

Object

名稱	類型	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

Object

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

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

TaskAgentCloudRequest

Object

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

TaskAgentDelaySource

Object

名稱	類型	Description
delays	string[]
taskAgent	TaskAgentReference

TaskAgentJobRequest

Object

名稱	類型	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

Object

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

TaskAgentPoolType

Enumeration

取得或設定集區的型別

值	Description
automation
deployment

TaskAgentPublicKey

Object

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

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

TaskAgentReference

Object

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

TaskAgentStatus

Enumeration

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

值	Description
offline
online

TaskAgentUpdate

Object

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

TaskAgentUpdateReason

Object

名稱	類型	Description
code	TaskAgentUpdateReasonType

TaskAgentUpdateReasonType

Enumeration

值	Description
manual
minAgentVersionRequired

TaskOrchestrationOwner

Object

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

TaskResult

Enumeration

值	Description
abandoned
canceled
failed
skipped
succeeded
succeededWithIssues

共用方式為

Targets - Update

URI 參數

要求本文

回應

安全性

oauth2

範圍

範例

Update tags of a deployment target

範例要求

範例回覆

定義

Demand

DeploymentMachine

DeploymentTargetUpdateParameter

IdentityRef

JObject

JToken

PackageVersion

PropertiesCollection

ReferenceLinks

TaskAgent

TaskAgentAuthorization

TaskAgentCloudRequest

TaskAgentDelaySource

TaskAgentJobRequest

TaskAgentPoolReference

TaskAgentPoolType

TaskAgentPublicKey

TaskAgentReference

TaskAgentStatus

TaskAgentUpdate

TaskAgentUpdateReason

TaskAgentUpdateReasonType

TaskOrchestrationOwner

TaskResult