Deploymentgroups - Update

Référence

Service:: Distributed Task

Version d'API:: 7.1

Mettez à jour un groupe de déploiement.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
deploymentGroupId	path	True	integer (int32)	ID du groupe de déploiement.
organization	path	True	string	Nom de l’organisation Azure DevOps.
project	path	True	string	ID de projet ou nom du projet
api-version	query	True	string	Version de l’API à utiliser. Cette valeur doit être définie sur « 7.1 » pour utiliser cette version de l’API.

Corps de la demande

Nom	Type	Description
description	string	Description du groupe de déploiement.
name	string	Nom du groupe de déploiement.

Réponses

Nom	Type	Description
200 OK	DeploymentGroup	opération réussie

Sécurité

oauth2

Type: oauth2
Flux: accessCode
URL d’autorisation: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL du jeton: 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

Étendues

Nom	Description
vso.machinegroup_manage	Permet de gérer les pools de groupes de déploiement et d’agents

Exemples

Update a deployment group

Exemple de requête

HTTP

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

{
  "name": "MyDeploymentGroup1-Update1",
  "description": "Description of this deployment group is updated"
}

Exemple de réponse

Code d’état:: 200

{
  "machineCount": 0,
  "description": "Description of this deployment group is updated",
  "id": 11,
  "project": {
    "id": "91879ed9-819b-46f3-9e0b-52ed4b20c04c",
    "name": "DeploymentGroupRESTSample"
  },
  "name": "MyDeploymentGroup1-Update1",
  "pool": {
    "id": 6,
    "isHosted": false,
    "poolType": "deployment",
    "size": 0
  }
}

Définitions

Nom	Description
Demand
DeploymentGroup	Groupe de déploiement.
DeploymentGroupUpdateParameter	Paramètre de mise à jour du groupe de déploiement.
DeploymentMachine	Cible de déploiement.
IdentityRef
JObject	Représente un objet JSON.
JToken	Représente un jeton JSON abstrait.
PackageVersion
ProjectReference
PropertiesCollection	La classe représente un conteneur de propriétés sous la forme d’une collection de paires clé-valeur. Les valeurs de tous les types primitifs (n’importe quel type avec un `TypeCode != TypeCode.Object`) à l’exception de `DBNull` sont acceptées. Les valeurs de type Byte[], Int32, Double, DateType et String conservent leur type, d’autres primitives sont retunées sous forme de chaîne. Byte[] attendu comme chaîne encodée en base64.
ReferenceLinks	Classe à représenter une collection de liens de référence REST.
TaskAgent	Un agent de tâche.
TaskAgentAuthorization	Fournit les données nécessaires pour autoriser l’agent à l’aide de flux d’authentification OAuth 2.0.
TaskAgentCloudRequest
TaskAgentJobRequest	Demande de travail pour un agent.
TaskAgentPoolOptions	Paramètres et détails supplémentaires du pool
TaskAgentPoolReference
TaskAgentPoolType	Obtient ou définit le type du pool
TaskAgentPublicKey	Représente la partie clé publique d’une clé asymétrique RSA.
TaskAgentReference	Référence à un agent.
TaskAgentStatus	Indique si l’agent est en ligne ou non.
TaskAgentUpdate	Détails sur une mise à jour de l’agent.
TaskAgentUpdateReason
TaskAgentUpdateReasonType
TaskOrchestrationOwner
TaskResult	Résultat de cette demande.

Demand

Object

Nom	Type	Description
name	string
value	string

DeploymentGroup

Object

Groupe de déploiement.

Nom	Type	Description
description	string	Description du groupe de déploiement.
id	integer (int32)	Identificateur de groupe de déploiement.
machineCount	integer (int32)	Nombre de cibles de déploiement dans le groupe de déploiement.
machineTags	string[]	Liste des étiquettes uniques sur toutes les cibles de déploiement dans le groupe de déploiement.
machines	DeploymentMachine[]	Liste des cibles de déploiement dans le groupe de déploiement.
name	string	Nom du groupe de déploiement.
pool	TaskAgentPoolReference	Pool de déploiement dans lequel les agents de déploiement sont inscrits.
project	ProjectReference	Projet auquel appartient le groupe de déploiement.

DeploymentGroupUpdateParameter

Object

Paramètre de mise à jour du groupe de déploiement.

Nom	Type	Description
description	string	Description du groupe de déploiement.
name	string	Nom du groupe de déploiement.

DeploymentMachine

Object

Cible de déploiement.

Nom	Type	Description
agent	TaskAgent	Agent de déploiement.
id	integer (int32)	Identificateur cible de déploiement.
properties	PropertiesCollection	Propriétés de la cible de déploiement.
tags	string[]	Balises de la cible de déploiement.

IdentityRef

Object

Nom	Type	Description
_links	ReferenceLinks	Ce champ contient zéro ou plus de liens intéressants sur le sujet du graphe. Ces liens peuvent être appelés pour obtenir des relations supplémentaires ou des informations plus détaillées sur ce sujet de graphique.
descriptor	string	Le descripteur est le principal moyen de référencer l’objet du graphique pendant l’exécution du système. Ce champ identifie de manière unique le même sujet de graphique sur les comptes et les organisations.
directoryAlias	string	Déconseillé : peut être récupéré en interrogeant l’utilisateur Graph référencé dans l’entrée « auto » du dictionnaire IdentityRef « _links »
displayName	string	Il s’agit du nom complet non unique de l’objet du graphique. Pour modifier ce champ, vous devez modifier sa valeur dans le fournisseur source.
id	string
imageUrl	string	Déconseillé - Disponible dans l’entrée « avatar » du dictionnaire IdentityRef « _links »
inactive	boolean	Déconseillé : peut être récupéré en interrogeant l’état d’appartenance Graph référencé dans l’entrée « membershipState » du dictionnaire GraphUser « _links »
isAadIdentity	boolean	Déconseillé : peut être déduit du type d’objet du descripteur (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Déconseillé : peut être déduit du type d’objet du descripteur (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Déconseillé : non utilisé dans la plupart des implémentations préexistantes de ToIdentityRef
uniqueName	string	Déconseillé : utiliser Domain+PrincipalName à la place
url	string	Cette URL est l’itinéraire complet vers la ressource source de ce sujet de graphe.

JObject

Object

Représente un objet JSON.

Nom	Type	Description
item	JToken	Représente un jeton JSON abstrait.
type	string (JTokenType)	Obtient le type de nœud de ce JToken.

JToken

Object

Représente un jeton JSON abstrait.

Nom	Type	Description
first	JToken	Obtenez le premier jeton enfant de ce jeton.
hasValues	boolean	Obtient une valeur indiquant si ce jeton a des jetons enfants.
item	JToken	Représente un jeton JSON abstrait.
last	JToken	Obtenez le dernier jeton enfant de ce jeton.
next	JToken	Obtient le jeton frère suivant de ce nœud.
parent	string (JContainer)	Obtient ou définit le parent.
path	string	Obtient le chemin d’accès du jeton JSON.
previous	JToken	Obtient le jeton frère précédent de ce nœud.
root	JToken	Obtient le JToken racine de ce JToken.
type	string (JTokenType)	Obtient le type de nœud de ce JToken.

PackageVersion

Object

Nom	Type	Description
major	integer (int32)
minor	integer (int32)
patch	integer (int32)

ProjectReference

Object

Nom	Type	Description
id	string (uuid)
name	string

PropertiesCollection

Object

La classe représente un conteneur de propriétés sous la forme d’une collection de paires clé-valeur. Les valeurs de tous les types primitifs (n’importe quel type avec un TypeCode != TypeCode.Object) à l’exception de DBNull sont acceptées. Les valeurs de type Byte[], Int32, Double, DateType et String conservent leur type, d’autres primitives sont retunées sous forme de chaîne. Byte[] attendu comme chaîne encodée en base64.

Nom	Type	Description
count	integer (int32)	Nombre de propriétés dans la collection.
item	object
keys	string[]	Jeu de clés dans la collection.
values	string[]	Ensemble de valeurs dans la collection.

ReferenceLinks

Object

Classe à représenter une collection de liens de référence REST.

Nom	Type	Description
links	object	Vue en lecture seule des liens. Étant donné que les liens de référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.

TaskAgent

Object

Un agent de tâche.

Nom	Type	Description
_links	ReferenceLinks	Classe à représenter une collection de liens de référence REST.
accessPoint	string	Point d’accès de cet agent.
assignedAgentCloudRequest	TaskAgentCloudRequest	Demande cloud de l’agent actuellement associée à cet agent.
assignedRequest	TaskAgentJobRequest	Demande actuellement affectée à cet agent.
authorization	TaskAgentAuthorization	Informations d’autorisation pour cet agent.
createdOn	string (date-time)	Date à laquelle cet agent a été créé.
enabled	boolean	Indique si cet agent doit exécuter ou non des travaux.
id	integer (int32)	Identificateur de l’agent.
lastCompletedRequest	TaskAgentJobRequest	Dernière requête qui a été effectuée par cet agent.
maxParallelism	integer (int32)	Parallélisme maximal de travail autorisé pour cet agent.
name	string	Nom de l’agent.
osDescription	string	Système d’exploitation de l’agent.
pendingUpdate	TaskAgentUpdate	Mise à jour en attente pour cet agent.
properties	PropertiesCollection	La classe représente un conteneur de propriétés sous la forme d’une collection de paires clé-valeur. Les valeurs de tous les types primitifs (n’importe quel type avec un `TypeCode != TypeCode.Object`) à l’exception de `DBNull` sont acceptées. Les valeurs de type Byte[], Int32, Double, DateType et String conservent leur type, d’autres primitives sont retunées sous forme de chaîne. Byte[] attendu comme chaîne encodée en base64.
provisioningState	string	État d’approvisionnement de cet agent.
status	TaskAgentStatus	Indique si l’agent est en ligne ou non.
statusChangedOn	string (date-time)	Date à laquelle la dernière modification de l’état de connectivité s’est produite.
systemCapabilities	object	Fonctionnalités définies par le système prises en charge par l’hôte de cet agent. Avertissement : Pour définir des fonctionnalités à l’aide de la méthode PUT, PUT remplace complètement les fonctionnalités existantes.
userCapabilities	object	Fonctionnalités définies par l’utilisateur prises en charge par l’hôte de cet agent. Avertissement : Pour définir des fonctionnalités à l’aide de la méthode PUT, PUT remplace complètement les fonctionnalités existantes.
version	string	Version de l’agent.

TaskAgentAuthorization

Object

Fournit les données nécessaires pour autoriser l’agent à l’aide de flux d’authentification OAuth 2.0.

Nom	Type	Description
authorizationUrl	string	Point de terminaison utilisé pour obtenir des jetons d’accès à partir du service de jetons configuré.
clientId	string (uuid)	Identificateur du client pour cet agent.
publicKey	TaskAgentPublicKey	Clé publique utilisée pour vérifier l’identité de cet agent.

TaskAgentCloudRequest

Object

Nom	Type	Description
agent	TaskAgentReference	Référence à un agent.
agentCloudId	integer (int32)
agentConnectedTime	string (date-time)
agentData	JObject	Représente un objet JSON.
agentSpecification	JObject	Représente un objet JSON.
pool	TaskAgentPoolReference
provisionRequestTime	string (date-time)
provisionedTime	string (date-time)
releaseRequestTime	string (date-time)
requestId	string (uuid)

TaskAgentJobRequest

Object

Demande de travail pour un agent.

Nom	Type	Description
agentSpecification	JObject	Représente un objet JSON.
assignTime	string (date-time)	Date/heure auxquelles cette requête a été attribuée.
data	object	Données supplémentaires sur la demande.
definition	TaskOrchestrationOwner	Définition de pipeline associée à cette requête
demands	Demand[]	Liste des demandes requises pour répondre à cette demande.
finishTime	string (date-time)	Date/heure de fin de cette requête.
hostId	string (uuid)	Hôte qui a déclenché cette requête.
jobId	string (uuid)	ID du travail résultant de cette requête.
jobName	string	Nom du travail résultant de cette requête.
lockedUntil	string (date-time)	Échéance pour que l’agent renouvelle le verrou.
matchedAgents	TaskAgentReference[]	Référence à un agent.
matchesAllAgentsInPool	boolean
orchestrationId	string
owner	TaskOrchestrationOwner	Pipeline associé à cette requête
planGroup	string
planId	string (uuid)	ID interne du plan d’orchestration connecté à cette requête.
planType	string	Détails internes représentant le type de plan d’orchestration.
poolId	integer (int32)	ID du pool cible cette requête
priority	integer (int32)
queueId	integer (int32)	ID de la file d’attente cible cette requête
queueTime	string (date-time)	Date/heure à laquelle cette requête a été mise en file d’attente.
receiveTime	string (date-time)	Date/heure à laquelle cette demande a été réapparaîte par un agent.
requestId	integer (int64)	ID de la requête.
reservedAgent	TaskAgentReference	Agent alloué pour cette demande.
result	TaskResult	Résultat de cette demande.
scopeId	string (uuid)	Étendue du pipeline ; correspond à l’ID du projet.
serviceOwner	string (uuid)	Service propriétaire de cette requête.
statusMessage	string
userDelayed	boolean

TaskAgentPoolOptions

Énumération

Paramètres et détails supplémentaires du pool

Valeur	Description
elasticPool	TaskAgentPool soutenu par le service de pool élastique
none
preserveAgentOnJobFailure	Défini sur true si les agents sont conservés pour l’examen après un échec TaskAgentJobRequest
singleUseAgents	Défini sur true si les agents sont recréés après chaque tâche TaskAgentJobRequest

TaskAgentPoolReference

Object

Nom	Type	Description
id	integer (int32)
isHosted	boolean	Obtient ou définit une valeur indiquant si ce pool est géré ou non par le service.
isLegacy	boolean	Détermine si le pool est hérité.
name	string
options	TaskAgentPoolOptions	Paramètres et détails supplémentaires du pool
poolType	TaskAgentPoolType	Obtient ou définit le type du pool
scope	string (uuid)
size	integer (int32)	Obtient la taille actuelle du pool.

TaskAgentPoolType

Énumération

Obtient ou définit le type du pool

Valeur	Description
automation	Un pool classique d’agents de tâche
deployment	Un pool de déploiement

TaskAgentPublicKey

Object

Représente la partie clé publique d’une clé asymétrique RSA.

Nom	Type	Description
exponent	string[] (byte)	Obtient ou définit l’exposant de la clé publique.
modulus	string[] (byte)	Obtient ou définit le module de la clé publique.

TaskAgentReference

Object

Référence à un agent.

Nom	Type	Description
_links	ReferenceLinks	Classe à représenter une collection de liens de référence REST.
accessPoint	string	Point d’accès de cet agent.
enabled	boolean	Indique si cet agent doit exécuter ou non des travaux.
id	integer (int32)	Identificateur de l’agent.
name	string	Nom de l’agent.
osDescription	string	Système d’exploitation de l’agent.
provisioningState	string	État d’approvisionnement de cet agent.
status	TaskAgentStatus	Indique si l’agent est en ligne ou non.
version	string	Version de l’agent.

TaskAgentStatus

Énumération

Indique si l’agent est en ligne ou non.

Valeur	Description
offline
online

TaskAgentUpdate

Object

Détails sur une mise à jour de l’agent.

Nom	Type	Description
currentState	string	État actuel de cette mise à jour de l’agent.
reason	TaskAgentUpdateReason	Raison de cette mise à jour.
requestTime	string (date-time)	Date à laquelle cette mise à jour a été demandée.
requestedBy	IdentityRef	Identité qui a demandé cette mise à jour.
sourceVersion	PackageVersion	Version de l’agent source de la mise à jour.
targetVersion	PackageVersion	Version de l’agent cible de la mise à jour.

TaskAgentUpdateReason

Object

Nom	Type	Description
code	TaskAgentUpdateReasonType

TaskAgentUpdateReasonType

Énumération

Valeur	Description
downgrade
manual
minAgentVersionRequired

TaskOrchestrationOwner

Object

Nom	Type	Description
_links	ReferenceLinks	Classe à représenter une collection de liens de référence REST.
id	integer (int32)
name	string

TaskResult

Énumération

Résultat de cette demande.

Valeur	Description
abandoned
canceled
failed
skipped
succeeded
succeededWithIssues