Targets - Update

Referência

Service:: Task Agent

API Version:: 5.0-preview.1

Atualizar marcas de uma lista de destinos de implantação em um grupo de implantação.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
deploymentGroupId	path	True	integer int32	ID do grupo de implantação no qual os destinos de implantação são atualizados.
organization	path	True	string	O nome da organização do Azure DevOps.
project	path	True	string	ID do projeto ou nome do projeto
api-version	query	True	string	Versão da API a ser usada. Isso deve ser definido como '5.0-preview.1' para usar essa versão da api.

Corpo da solicitação

Nome	Tipo	Description
body	DeploymentTargetUpdateParameter[]	Destinos de implantação com marcas para udpdate.

Respostas

Nome	Tipo	Description
200 OK	DeploymentMachine[]	operação bem-sucedida

Segurança

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

Nome	Description
vso.machinegroup_manage	Fornece a capacidade de gerenciar pools de agentes e grupos de implantação

Exemplos

Update tags of a deployment target

Sample Request

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
  }
]

Sample Response

Status code:: 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"
      }
    }
  ]
}

Definições

Nome	Description
Demand
DeploymentMachine	Destino de implantação.
DeploymentTargetUpdateParameter	Parâmetro de atualização de destino de implantação.
IdentityRef
JObject
JToken
PackageVersion
PropertiesCollection	A classe representa um recipiente de propriedades como uma coleção de pares chave-valor. Os valores de todos os tipos primitivos (qualquer tipo com um `TypeCode != TypeCode.Object`) exceto para `DBNull` são aceitos. Valores do tipo Byte[], Int32, Double, DateType e String preservam seu tipo, outros primitivos são reajustados como uma Cadeia de Caracteres. Byte[] esperado como cadeia de caracteres codificada em base64.
ReferenceLinks	A classe para representar uma coleção de links de referência REST.
TaskAgent
TaskAgentAuthorization	Fornece dados necessários para autorizar o agente usando fluxos de autenticação OAuth 2.0.
TaskAgentCloudRequest
TaskAgentDelaySource
TaskAgentJobRequest
TaskAgentPoolReference
TaskAgentPoolType	Obtém ou define o tipo do pool
TaskAgentPublicKey	Representa a parte de chave pública de uma chave assimétrica RSA.
TaskAgentReference
TaskAgentStatus	Obtém o status de conectividade atual do agente.
TaskAgentUpdate
TaskAgentUpdateReason
TaskAgentUpdateReasonType
TaskOrchestrationOwner
TaskResult

Demand

Nome	Tipo	Description
name	string
value	string

DeploymentMachine

Destino de implantação.

Nome	Tipo	Description
agent	TaskAgent	Agente de implantação.
id	integer	Identificador de destino de implantação.
tags	string[]	Marcas do destino de implantação.

DeploymentTargetUpdateParameter

Parâmetro de atualização de destino de implantação.

Nome	Tipo	Description
id	integer	Identificador do destino de implantação.
tags	string[]

IdentityRef

Nome	Tipo	Description
_links	ReferenceLinks	Esse campo contém zero ou mais links interessantes sobre o assunto do grafo. Esses links podem ser invocados para obter relações adicionais ou informações mais detalhadas sobre esse assunto do grafo.
descriptor	string	O descritor é a principal maneira de referenciar o assunto do grafo enquanto o sistema está em execução. Esse campo identificará exclusivamente o mesmo assunto de grafo entre contas e organizações.
directoryAlias	string
displayName	string	Esse é o nome de exibição não exclusivo do assunto do grafo. Para alterar esse campo, você deve alterar seu valor no provedor de origem.
id	string
imageUrl	string
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string	Essa URL é a rota completa para o recurso de origem desta entidade de grafo.

JObject

Nome	Tipo	Description
item	JToken
type	string

JToken

Nome	Tipo	Description
first	JToken
hasValues	boolean
item	JToken
last	JToken
next	JToken
parent	string
path	string
previous	JToken
root	JToken
type	string

PackageVersion

Nome	Tipo	Description
major	integer
minor	integer
patch	integer

PropertiesCollection

A classe representa um recipiente de propriedades como uma coleção de pares chave-valor. Os valores de todos os tipos primitivos (qualquer tipo com um TypeCode != TypeCode.Object) exceto para DBNull são aceitos. Valores do tipo Byte[], Int32, Double, DateType e String preservam seu tipo, outros primitivos são reajustados como uma Cadeia de Caracteres. Byte[] esperado como cadeia de caracteres codificada em base64.

Nome	Tipo	Description
count	integer	A contagem de propriedades na coleção.
item	object
keys	string[]	O conjunto de chaves na coleção.
values	string[]	O conjunto de valores na coleção.

ReferenceLinks

A classe para representar uma coleção de links de referência REST.

Nome	Tipo	Description
links	object	A exibição somente leitura dos links. Como os links de referência são somente leitura, só queremos expô-los como somente leitura.

TaskAgent

Nome	Tipo	Description
_links	ReferenceLinks	A classe para representar uma coleção de links de referência REST.
accessPoint	string	Obtém o ponto de acesso do agente.
assignedAgentCloudRequest	TaskAgentCloudRequest	Obtém a Solicitação de Nuvem do Agente que está associada atualmente a esse agente
assignedRequest	TaskAgentJobRequest	Obtém a solicitação que está atribuída atualmente a esse agente.
authorization	TaskAgentAuthorization	Obtém ou define as informações de autorização para esse agente.
createdOn	string	Obtém a data em que esse agente foi criado.
enabled	boolean	Obtém ou define um valor que indica se esse agente deve ou não ser habilitado para execução do trabalho.
id	integer	Obtém o identificador do agente.
lastCompletedRequest	TaskAgentJobRequest	Obtém a última solicitação que foi concluída por esse agente.
maxParallelism	integer	Obtém ou define o paralelismo máximo de trabalho permitido neste host.
name	string	Obtém o nome do agente.
oSDescription	string	Obtém o sistema operacional do agente.
pendingUpdate	TaskAgentUpdate	Obtém a atualização pendente para este agente.
properties	PropertiesCollection	A classe representa um recipiente de propriedades como uma coleção de pares chave-valor. Os valores de todos os tipos primitivos (qualquer tipo com um `TypeCode != TypeCode.Object`) exceto para `DBNull` são aceitos. Valores do tipo Byte[], Int32, Double, DateType e String preservam seu tipo, outros primitivos são reajustados como uma Cadeia de Caracteres. Byte[] esperado como cadeia de caracteres codificada em base64.
provisioningState	string	Obtém ou define o estado de provisionamento atual desse agente
status	TaskAgentStatus	Obtém o status de conectividade atual do agente.
statusChangedOn	string	Obtém a data em que a última alteração de status de conectividade ocorreu.
systemCapabilities	object
userCapabilities	object
version	string	Obtém a versão do agente.

TaskAgentAuthorization

Fornece dados necessários para autorizar o agente usando fluxos de autenticação OAuth 2.0.

Nome	Tipo	Description
authorizationUrl	string	Obtém ou define o ponto de extremidade usado para obter tokens de acesso do serviço de token configurado.
clientId	string	Obtém ou define o identificador do cliente para esse agente.
publicKey	TaskAgentPublicKey	Obtém ou define a chave pública usada para verificar a identidade desse agente.

TaskAgentCloudRequest

Nome	Tipo	Description
agent	TaskAgentReference
agentCloudId	integer
agentConnectedTime	string
agentData	JObject
agentSpecification	JObject
pool	TaskAgentPoolReference
provisionRequestTime	string
provisionedTime	string
releaseRequestTime	string
requestId	string

TaskAgentDelaySource

Nome	Tipo	Description
delays	string[]
taskAgent	TaskAgentReference

TaskAgentJobRequest

Nome	Tipo	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

Nome	Tipo	Description
id	integer
isHosted	boolean	Obtém ou define um valor que indica se esse pool é gerenciado ou não pelo serviço.
name	string
poolType	TaskAgentPoolType	Obtém ou define o tipo do pool
scope	string
size	integer	Obtém o tamanho atual do pool.

TaskAgentPoolType

Obtém ou define o tipo do pool

Nome	Tipo	Description
automation	string
deployment	string

TaskAgentPublicKey

Representa a parte de chave pública de uma chave assimétrica RSA.

Nome	Tipo	Description
exponent	string[]	Obtém ou define o expoente para a chave pública.
modulus	string[]	Obtém ou define o módulo para a chave pública.

TaskAgentReference

Nome	Tipo	Description
_links	ReferenceLinks	A classe para representar uma coleção de links de referência REST.
accessPoint	string	Obtém o ponto de acesso do agente.
enabled	boolean	Obtém ou define um valor que indica se esse agente deve ou não ser habilitado para execução do trabalho.
id	integer	Obtém o identificador do agente.
name	string	Obtém o nome do agente.
oSDescription	string	Obtém o sistema operacional do agente.
provisioningState	string	Obtém ou define o estado de provisionamento atual desse agente
status	TaskAgentStatus	Obtém o status de conectividade atual do agente.
version	string	Obtém a versão do agente.

TaskAgentStatus

Obtém o status de conectividade atual do agente.

Nome	Tipo	Description
offline	string
online	string

TaskAgentUpdate

Nome	Tipo	Description
currentState	string	O estado atual desta atualização do agente
reason	TaskAgentUpdateReason	O motivo dessa atualização do agente
requestTime	string	Obtém a data em que essa atualização do agente foi solicitada.
requestedBy	IdentityRef	A identidade que solicita a atualização do agente
sourceVersion	PackageVersion	Obtém ou define a versão do agente de origem da atualização do agente
targetVersion	PackageVersion	Obtém ou define a versão do agente de destino da atualização do agente

TaskAgentUpdateReason

Nome	Tipo	Description
code	TaskAgentUpdateReasonType

TaskAgentUpdateReasonType

Nome	Tipo	Description
manual	string
minAgentVersionRequired	string

TaskOrchestrationOwner

Nome	Tipo	Description
_links	ReferenceLinks	A classe para representar uma coleção de links de referência REST.
id	integer
name	string

TaskResult

Nome	Tipo	Description
abandoned	string
canceled	string
failed	string
skipped	string
succeeded	string
succeededWithIssues	string