Teams - Get All Teams

Referenz

Service:: Core

API Version:: 7.1-preview.3

Rufen Sie eine Liste aller Teams ab.

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

With optional parameters:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
organization	path	True	string	Der Name der Azure DevOps-Organisation.
api-version	query	True	string	Version der zu verwendenden API. Dies sollte auf "7.1-preview.3" festgelegt werden, um diese Version der API zu verwenden.
$expandIdentity	query		boolean	Ein Wert, der angibt, ob Identitätsinformationen im WebApiTeam-Ergebnisobjekt erweitert werden sollen oder nicht.
$mine	query		boolean	Wenn true, geben Sie alle Teams zurück, die Benutzer als Mitglied anfordern. Andernfalls wird zurückgegeben, dass alle Teams-Benutzer Lesezugriff haben.
$skip	query		integer int32	Anzahl der zu überspringenden Teams.
$top	query		integer int32	Maximale Anzahl von Teams, die zurückgegeben werden sollen.

Antworten

Name	Typ	Beschreibung
200 OK	WebApiTeam[]	Erfolgreicher Vorgang

Sicherheit

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

Name	Beschreibung
vso.project	Ermöglicht das Lesen von Projekten und Teams.

Beispiele

Sample Request

HTTP

GET https://dev.azure.com/fabrikam/_apis/teams?$mine=True&api-version=7.1-preview.3

Sample Response

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

Definitionen

Name	Beschreibung
Identity
IdentityDescriptor	Ein Identitätsdeskriptor ist ein Wrapper für den Identitätstyp (Windows SID, Passport) zusammen mit einem eindeutigen Bezeichner wie der SID oder PUID.
PropertiesCollection	Die -Klasse stellt einen Eigenschaftenbehälter als Sammlung von Schlüssel-Wert-Paaren dar. Werte aller primitiven Typen (jeder Typ mit einem `TypeCode != TypeCode.Object`) mit Ausnahme von `DBNull` werden akzeptiert. Werte vom Typ Byte[], Int32, Double, DateType und String behalten ihren Typ bei, andere Grundtypen werden als String umgestimmt. Byte[] als base64-codierte Zeichenfolge erwartet.
WebApiTeam

Identity

Name	Typ	Beschreibung
customDisplayName	string	Der benutzerdefinierte Anzeigename für die Identität (falls vorhanden). Wenn Sie diese Eigenschaft auf eine leere Zeichenfolge festlegen, wird der vorhandene benutzerdefinierte Anzeigename gelöscht. Das Festlegen dieser Eigenschaft auf NULL wirkt sich nicht auf den vorhandenen dauerhaften Wert aus (da NULL-Werte nicht über die Verbindung oder an die Datenbank gesendet werden).
descriptor	IdentityDescriptor	Ein Identitätsdeskriptor ist ein Wrapper für den Identitätstyp (Windows SID, Passport) zusammen mit einem eindeutigen Bezeichner wie der SID oder PUID.
id	string	Identitätsbezeichner. Auch als Speicherschlüssel oder VSID bezeichnet
isActive	boolean	True, wenn die Identität eine Mitgliedschaft in einer Azure Devops-Gruppe im organization hat.
isContainer	boolean	True, wenn es sich bei der Identität um eine Gruppe handelt.
masterId	string
memberIds	string[]	ID der Mitglieder der Identität (nur Gruppen).
memberOf	IdentityDescriptor[]	Ein Identitätsdeskriptor ist ein Wrapper für den Identitätstyp (Windows SID, Passport) zusammen mit einem eindeutigen Bezeichner wie der SID oder PUID.
members	IdentityDescriptor[]	Ein Identitätsdeskriptor ist ein Wrapper für den Identitätstyp (Windows SID, Passport) zusammen mit einem eindeutigen Bezeichner wie der SID oder PUID.
metaTypeId	integer
properties	PropertiesCollection	Die -Klasse stellt einen Eigenschaftenbehälter als Sammlung von Schlüssel-Wert-Paaren dar. Werte aller primitiven Typen (jeder Typ mit einem `TypeCode != TypeCode.Object`) mit Ausnahme von `DBNull` werden akzeptiert. Werte vom Typ Byte[], Int32, Double, DateType und String behalten ihren Typ bei, andere Grundtypen werden als String umgestimmt. Byte[] als base64-codierte Zeichenfolge erwartet.
providerDisplayName	string	Der Vom Quellidentitätsanbieter angegebene Anzeigename für die Identität.
resourceVersion	integer
socialDescriptor	string
subjectDescriptor	string	Betreffdeskriptor einer Graph-Entität.
uniqueUserId	integer

IdentityDescriptor

Ein Identitätsdeskriptor ist ein Wrapper für den Identitätstyp (Windows SID, Passport) zusammen mit einem eindeutigen Bezeichner wie der SID oder PUID.

Name	Typ	Beschreibung
identifier	string	Der eindeutige Bezeichner für diese Identität mit maximal 256 Zeichen, der beibehalten wird.
identityType	string	Deskriptortyp (z. B. Windows, Passport usw.).

PropertiesCollection

Die -Klasse stellt einen Eigenschaftenbehälter als Sammlung von Schlüssel-Wert-Paaren dar. Werte aller primitiven Typen (jeder Typ mit einem TypeCode != TypeCode.Object) mit Ausnahme von DBNull werden akzeptiert. Werte vom Typ Byte[], Int32, Double, DateType und String behalten ihren Typ bei, andere Grundtypen werden als String umgestimmt. Byte[] als base64-codierte Zeichenfolge erwartet.

Name	Typ	Beschreibung
count	integer	Die Anzahl der Eigenschaften in der Auflistung.
item	object
keys	string[]	Der Schlüsselsatz in der Auflistung.
values	string[]	Der Wertsatz in der Auflistung.

WebApiTeam

Name	Typ	Beschreibung
description	string	Teambeschreibung
id	string	Team (Identität) Guid. Eine Team Foundation-ID.
identity	Identity	Teamidentität.
identityUrl	string	Identitäts-REST-API-URL für dieses Team
name	string	Teamname
projectId	string
projectName	string
url	string	Team-REST-API-URL

Share via