Teams - Update
Mettez à jour le nom et/ou la description d’une équipe.
PATCH https://dev.azure.com/{organization}/_apis/projects/{projectId}/teams/{teamId}?api-version=7.1Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Nom de l’organisation Azure DevOps. |
|
project
|
path | True |
string |
Nom ou ID (GUID) du projet d’équipe contenant l’équipe à mettre à jour. |
|
team
|
path | True |
string |
Nom de l’ID de l’équipe à mettre à jour. |
|
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 de l’équipe |
| id |
string (uuid) |
Guid d’équipe (Identité). ID Team Foundation. |
| identity |
Identité de l’équipe. |
|
| identityUrl |
string |
URL de l’API REST d’identité pour cette équipe |
| name |
string |
Nom de l’équipe |
| projectId |
string (uuid) |
|
| projectName |
string |
|
| url |
string |
URL de l’API REST d’équipe |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
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.project_write | Accorde la possibilité de lire et de mettre à jour des projets et des équipes. |
Exemples
Exemple de requête
PATCH https://dev.azure.com/fabrikam/_apis/projects/8e5a3cfb-fed3-46f3-8657-e3b175cd0305/teams/{teamId}?api-version=7.1
{
"name": "My new team",
"description": "Description of my team"
}
Exemple de réponse
{
"id": "8e8aa4ff-848a-474a-9033-93190137c8e4",
"name": "My New Team",
"url": "https://dev.azure.com/fabrikam/_apis/projects/8e5a3cfb-fed3-46f3-8657-e3b175cd0305/teams/8e8aa4ff-848a-474a-9033-93190137c8e4",
"description": "Description of my team",
"identityUrl": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/8e8aa4ff-848a-474a-9033-93190137c8e4"
}Définitions
| Nom | Description |
|---|---|
| Identity | |
|
Identity |
Un descripteur d’identité est un wrapper pour le type d’identité (SID Windows, Passport) ainsi qu’un identificateur unique tel que le SID ou puID. |
|
Properties |
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 |
|
Web |
Identity
| Nom | Type | Description |
|---|---|---|
| customDisplayName |
string |
Nom complet personnalisé de l’identité (le cas échéant). La définition de cette propriété sur une chaîne vide efface le nom d’affichage personnalisé existant. La définition de cette propriété sur Null n’affecte pas la valeur persistante existante (étant donné que les valeurs Null ne sont pas envoyées via le câble ou à la base de données) |
| descriptor |
Un descripteur d’identité est un wrapper pour le type d’identité (SID Windows, Passport) ainsi qu’un identificateur unique tel que le SID ou puID. |
|
| id |
string (uuid) |
Identificateur d’identité. Également appelé Clé de stockage ou VSID |
| isActive |
boolean |
True si l’identité est membre d’un groupe Azure Devops dans l’organisation. |
| isContainer |
boolean |
True si l’identité est un groupe. |
| masterId |
string (uuid) |
|
| memberIds |
string[] (uuid) |
ID des membres de l’identité (groupes uniquement). |
| memberOf |
Un descripteur d’identité est un wrapper pour le type d’identité (SID Windows, Passport) ainsi qu’un identificateur unique tel que le SID ou puID. |
|
| members |
Un descripteur d’identité est un wrapper pour le type d’identité (SID Windows, Passport) ainsi qu’un identificateur unique tel que le SID ou puID. |
|
| metaTypeId |
integer (int32) |
|
| properties |
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 |
|
| providerDisplayName |
string |
Nom complet de l’identité spécifiée par le fournisseur d’identité source. |
| resourceVersion |
integer (int32) |
|
| socialDescriptor |
string |
|
| subjectDescriptor |
string |
Descripteur d’objet d’une entité Graph. |
| uniqueUserId |
integer (int32) |
IdentityDescriptor
Un descripteur d’identité est un wrapper pour le type d’identité (SID Windows, Passport) ainsi qu’un identificateur unique tel que le SID ou puID.
| Nom | Type | Description |
|---|---|---|
| identifier |
string |
Identificateur unique de cette identité, qui ne dépasse pas 256 caractères, qui seront conservés. |
| identityType |
string |
Type de descripteur (par exemple, Windows, Passport, etc.). |
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.
| 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. |
WebApiTeam
| Nom | Type | Description |
|---|---|---|
| description |
string |
Description de l’équipe |
| id |
string (uuid) |
Guid d’équipe (Identité). ID Team Foundation. |
| identity |
Identité de l’équipe. |
|
| identityUrl |
string |
URL de l’API REST d’identité pour cette équipe |
| name |
string |
Nom de l’équipe |
| projectId |
string (uuid) |
|
| projectName |
string |
|
| url |
string |
URL de l’API REST d’équipe |