Targets - Update

Referencia

Servicio:: Task Agent

Versión de la API:: 5.0-preview.1

Actualice las etiquetas de una lista de destinos de implementación en un grupo de implementación.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
deploymentGroupId	path	True	integer int32	Identificador del grupo de implementación en el que se actualizan los destinos de implementación.
organization	path	True	string	El nombre de la organización de Azure DevOps.
project	path	True	string	Id. de proyecto o nombre del proyecto
api-version	query	True	string	Versión de la API que se va a usar. Debe establecerse en "5.0-preview.1" para usar esta versión de la API.

Cuerpo de la solicitud

Nombre	Tipo	Description
body	DeploymentTargetUpdateParameter[]	Destinos de implementación con etiquetas para udpdate.

Respuestas

Nombre	Tipo	Description
200 OK	DeploymentMachine[]	operación correcta

Seguridad

oauth2

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Dirección URL del token: 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

Ámbitos

Nombre	Description
vso.machinegroup_manage	Proporciona la capacidad de administrar grupos de agentes y grupos de implementación.

Ejemplos

Update tags of a deployment target

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre	Description
Demand
DeploymentMachine	Destino de implementación.
DeploymentTargetUpdateParameter	Parámetro de actualización de destino de implementación.
IdentityRef
JObject
JToken
PackageVersion
PropertiesCollection	La clase representa un contenedor de propiedades como una colección de pares clave-valor. Se aceptan valores de todos los tipos primitivos (cualquier tipo con un `TypeCode != TypeCode.Object`) excepto `DBNull` . Los valores de tipo Byte[], Int32, Double, DateType y String conservan su tipo; otros primitivos se vuelven a ajustar como string. Byte[] se esperaba como cadena codificada en base64.
ReferenceLinks	Clase que representa una colección de vínculos de referencia de REST.
TaskAgent
TaskAgentAuthorization	Proporciona los datos necesarios para autorizar el agente mediante flujos de autenticación de OAuth 2.0.
TaskAgentCloudRequest
TaskAgentDelaySource
TaskAgentJobRequest
TaskAgentPoolReference
TaskAgentPoolType	Obtiene o establece el tipo del grupo.
TaskAgentPublicKey	Representa la parte de la clave pública de una clave asimétrica RSA.
TaskAgentReference
TaskAgentStatus	Obtiene el estado de conectividad actual del agente.
TaskAgentUpdate
TaskAgentUpdateReason
TaskAgentUpdateReasonType
TaskOrchestrationOwner
TaskResult

Demand

Object

Nombre	Tipo	Description
name	string
value	string

DeploymentMachine

Object

Destino de implementación.

Nombre	Tipo	Description
agent	TaskAgent	Agente de implementación.
id	integer	Identificador de destino de implementación.
tags	string[]	Etiquetas del destino de implementación.

DeploymentTargetUpdateParameter

Object

Parámetro de actualización de destino de implementación.

Nombre	Tipo	Description
id	integer	Identificador del destino de implementación.
tags	string[]

IdentityRef

Object

Nombre	Tipo	Description
_links	ReferenceLinks	Este campo contiene cero o más vínculos interesantes sobre el tema del grafo. Estos vínculos se pueden invocar para obtener relaciones adicionales o información más detallada sobre este tema del grafo.
descriptor	string	El descriptor es la forma principal de hacer referencia al asunto del grafo mientras se ejecuta el sistema. Este campo identificará de forma única el mismo asunto del grafo en cuentas y organizaciones.
directoryAlias	string
displayName	string	Este es el nombre para mostrar no único del asunto del grafo. Para cambiar este campo, debe modificar su valor en el proveedor de origen.
id	string
imageUrl	string
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string	Esta dirección URL es la ruta completa al recurso de origen de este tema del grafo.

JObject

Object

Nombre	Tipo	Description
item	JToken
type	string

JToken

Object

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

PackageVersion

Object

Nombre	Tipo	Description
major	integer
minor	integer
patch	integer

PropertiesCollection

Object

La clase representa un contenedor de propiedades como una colección de pares clave-valor. Se aceptan valores de todos los tipos primitivos (cualquier tipo con un TypeCode != TypeCode.Object) excepto DBNull . Los valores de tipo Byte[], Int32, Double, DateType y String conservan su tipo; otros primitivos se vuelven a ajustar como string. Byte[] se esperaba como cadena codificada en base64.

Nombre	Tipo	Description
count	integer	Recuento de propiedades de la colección.
item	object
keys	string[]	Conjunto de claves de la colección.
values	string[]	Conjunto de valores de la colección.

ReferenceLinks

Object

Clase que representa una colección de vínculos de referencia de REST.

Nombre	Tipo	Description
links	object	Vista de solo lectura de los vínculos. Dado que los vínculos de referencia son de solo lectura, solo queremos exponerlos como de solo lectura.

TaskAgent

Object

Nombre	Tipo	Description
_links	ReferenceLinks	Clase que representa una colección de vínculos de referencia de REST.
accessPoint	string	Obtiene el punto de acceso del agente.
assignedAgentCloudRequest	TaskAgentCloudRequest	Obtiene la solicitud en la nube del agente que está asociada actualmente a este agente.
assignedRequest	TaskAgentJobRequest	Obtiene la solicitud que está asignada actualmente a este agente.
authorization	TaskAgentAuthorization	Obtiene o establece la información de autorización de este agente.
createdOn	string	Obtiene la fecha en la que se creó este agente.
enabled	boolean	Obtiene o establece un valor que indica si este agente debe habilitarse o no para la ejecución del trabajo.
id	integer	Obtiene el identificador del agente.
lastCompletedRequest	TaskAgentJobRequest	Obtiene la última solicitud que completó este agente.
maxParallelism	integer	Obtiene o establece el paralelismo de trabajo máximo permitido en este host.
name	string	Obtiene el nombre del agente.
oSDescription	string	Obtiene el sistema operativo del agente.
pendingUpdate	TaskAgentUpdate	Obtiene la actualización pendiente para este agente.
properties	PropertiesCollection	La clase representa un contenedor de propiedades como una colección de pares clave-valor. Se aceptan valores de todos los tipos primitivos (cualquier tipo con un `TypeCode != TypeCode.Object`) excepto `DBNull` . Los valores de tipo Byte[], Int32, Double, DateType y String conservan su tipo; otros primitivos se vuelven a ajustar como string. Byte[] se esperaba como cadena codificada en base64.
provisioningState	string	Obtiene o establece el estado de aprovisionamiento actual de este agente.
status	TaskAgentStatus	Obtiene el estado de conectividad actual del agente.
statusChangedOn	string	Obtiene la fecha en la que se produjo el último cambio de estado de conectividad.
systemCapabilities	object
userCapabilities	object
version	string	Obtiene la versión del agente.

TaskAgentAuthorization

Object

Proporciona los datos necesarios para autorizar el agente mediante flujos de autenticación de OAuth 2.0.

Nombre	Tipo	Description
authorizationUrl	string	Obtiene o establece el punto de conexión utilizado para obtener tokens de acceso del servicio de token configurado.
clientId	string	Obtiene o establece el identificador de cliente de este agente.
publicKey	TaskAgentPublicKey	Obtiene o establece la clave pública utilizada para comprobar la identidad de este agente.

TaskAgentCloudRequest

Object

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

TaskAgentDelaySource

Object

Nombre	Tipo	Description
delays	string[]
taskAgent	TaskAgentReference

TaskAgentJobRequest

Object

Nombre	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

Object

Nombre	Tipo	Description
id	integer
isHosted	boolean	Obtiene o establece un valor que indica si el servicio administra o no este grupo.
name	string
poolType	TaskAgentPoolType	Obtiene o establece el tipo del grupo.
scope	string
size	integer	Obtiene el tamaño actual del grupo.

TaskAgentPoolType

Enumeration

Obtiene o establece el tipo del grupo.

Valor	Description
automation
deployment

TaskAgentPublicKey

Object

Representa la parte de la clave pública de una clave asimétrica RSA.

Nombre	Tipo	Description
exponent	string[]	Obtiene o establece el exponente de la clave pública.
modulus	string[]	Obtiene o establece el módulo de la clave pública.

TaskAgentReference

Object

Nombre	Tipo	Description
_links	ReferenceLinks	Clase que representa una colección de vínculos de referencia de REST.
accessPoint	string	Obtiene el punto de acceso del agente.
enabled	boolean	Obtiene o establece un valor que indica si este agente debe habilitarse o no para la ejecución del trabajo.
id	integer	Obtiene el identificador del agente.
name	string	Obtiene el nombre del agente.
oSDescription	string	Obtiene el sistema operativo del agente.
provisioningState	string	Obtiene o establece el estado de aprovisionamiento actual de este agente.
status	TaskAgentStatus	Obtiene el estado de conectividad actual del agente.
version	string	Obtiene la versión del agente.

TaskAgentStatus

Enumeration

Obtiene el estado de conectividad actual del agente.

Valor	Description
offline
online

TaskAgentUpdate

Object

Nombre	Tipo	Description
currentState	string	El estado actual de esta actualización del agente
reason	TaskAgentUpdateReason	Motivo de esta actualización del agente
requestTime	string	Obtiene la fecha en la que se solicitó esta actualización del agente.
requestedBy	IdentityRef	La identidad que solicita la actualización del agente
sourceVersion	PackageVersion	Obtiene o establece la versión del agente de origen de la actualización del agente.
targetVersion	PackageVersion	Obtiene o establece la versión del agente de destino de la actualización del agente.

TaskAgentUpdateReason

Object

Nombre	Tipo	Description
code	TaskAgentUpdateReasonType

TaskAgentUpdateReasonType

Enumeration

Valor	Description
manual
minAgentVersionRequired

TaskOrchestrationOwner

Object

Nombre	Tipo	Description
_links	ReferenceLinks	Clase que representa una colección de vínculos de referencia de REST.
id	integer
name	string

TaskResult

Enumeration

Valor	Description
abandoned
canceled
failed
skipped
succeeded
succeededWithIssues

Compartir a través de

Targets - Update

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

oauth2

Ámbitos

Ejemplos

Update tags of a deployment target

Solicitud de ejemplo

Respuesta de muestra

Definiciones

Demand

DeploymentMachine

DeploymentTargetUpdateParameter

IdentityRef

JObject

JToken

PackageVersion

PropertiesCollection

ReferenceLinks

TaskAgent

TaskAgentAuthorization

TaskAgentCloudRequest

TaskAgentDelaySource

TaskAgentJobRequest

TaskAgentPoolReference

TaskAgentPoolType

TaskAgentPublicKey

TaskAgentReference

TaskAgentStatus

TaskAgentUpdate

TaskAgentUpdateReason

TaskAgentUpdateReasonType

TaskOrchestrationOwner

TaskResult