Teams - Create

Referenz

Service:: Core

API Version:: 7.1-preview.3

Erstellen Sie ein Team in einem Teamprojekt.

Mögliche Fehlerszenarien Ungültiger Projektname/ID (Projekt ist nicht vorhanden) 404 Ungültiger Teamname oder Beschreibung 400 Team bereits vorhanden 400 Unzureichende Berechtigungen 400

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
organization	path	True	string	Der Name der Azure DevOps-Organisation.
projectId	path	True	string	Der Name oder die ID (GUID) des Teamprojekts, in dem das Team erstellt werden soll.
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.

Anforderungstext

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

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_manage	Ermöglicht das Erstellen, Lesen, Aktualisieren und Löschen von Projekten und Teams.

Beispiele

Sample Request

HTTP

POST https://dev.azure.com/fabrikam/_apis/projects/8e5a3cfb-fed3-46f3-8657-e3b175cd0305/teams?api-version=7.1-preview.3

{
  "name": "My new team"
}

Sample Response

Status code:: 200

{
  "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": "",
  "identityUrl": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/8e8aa4ff-848a-474a-9033-93190137c8e4"
}

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