Teams - Get Teams

Référence

Service:: Core

Version d'API:: 7.1

Obtenez une liste d’équipes.

GET https://dev.azure.com/{organization}/_apis/projects/{projectId}/teams?api-version=7.1

Avec des paramètres facultatifs:

GET https://dev.azure.com/{organization}/_apis/projects/{projectId}/teams?$mine={$mine}&$top={$top}&$skip={$skip}&$expandIdentity={$expandIdentity}&api-version=7.1

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
organization	path	True	string	Nom de l’organisation Azure DevOps.
projectId	path	True	string
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.
$expandIdentity	query		boolean	Valeur indiquant s’il faut ou non développer les informations d’identité dans l’objet WebApiTeam de résultat.
$mine	query		boolean	Si la valeur est true, toutes les équipes demandant l’utilisateur sont membres ; sinon, retournez l’accès en lecture à l’utilisateur de toutes les équipes.
$skip	query		integer (int32)	Nombre d’équipes à ignorer.
$top	query		integer (int32)	Nombre maximal d’équipes à retourner.

Réponses

Nom	Type	Description
200 OK	WebApiTeam[]	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.profile	Accorde la possibilité de lire votre profil, comptes, collections, projets, équipes et autres artefacts organisationnels de niveau supérieur.
vso.project	Accorde la possibilité de lire des projets et des équipes.

Exemples

Exemple de requête

HTTP

GET https://dev.azure.com/fabrikam/_apis/projects/eb6e4656-77fc-42a1-9181-4c6d8e9da5d1/teams?api-version=7.1

Exemple de réponse

Code d’état:: 200

{
  "value": [
    {
      "id": "564e8204-a90b-4432-883b-d4363c6125ca",
      "name": "Quality assurance",
      "url": "https://dev.azure.com/fabrikam/_apis/projects/eb6e4656-77fc-42a1-9181-4c6d8e9da5d1/teams/564e8204-a90b-4432-883b-d4363c6125ca",
      "description": "Testing staff",
      "identityUrl": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/564e8204-a90b-4432-883b-d4363c6125ca"
    },
    {
      "id": "66df9be7-3586-467b-9c5f-425b29afedfd",
      "name": "Fabrikam-Fiber-TFVC Team",
      "url": "https://dev.azure.com/fabrikam/_apis/projects/eb6e4656-77fc-42a1-9181-4c6d8e9da5d1/teams/66df9be7-3586-467b-9c5f-425b29afedfd",
      "description": "The default project team.",
      "identityUrl": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/66df9be7-3586-467b-9c5f-425b29afedfd"
    }
  ],
  "count": 2
}

Définitions

Nom	Description
Identity
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.
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.
WebApiTeam

Identity

Object

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	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.
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	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.
members	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.
metaTypeId	integer (int32)
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.
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

Object

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

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.

WebApiTeam

Object

Nom	Type	Description
description	string	Description de l’équipe
id	string (uuid)	Guid d’équipe (Identité). ID Team Foundation.
identity	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

Partager via

Teams - Get Teams

Paramètres URI

Réponses

Sécurité

oauth2

Étendues

Exemples

Exemple de requête

Exemple de réponse

Définitions

Identity

IdentityDescriptor

PropertiesCollection

WebApiTeam