Teams - Create

Riferimento

Service:: Core

API Version:: 7.1-preview.3

Creare un team in un progetto team.

Possibili scenari di errore Nome/ID progetto non valido (progetto non esistente) 404 Nome team non valido o descrizione 400 Team esiste già 400 Privilegi insufficienti 400

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
organization	path	True	string	Nome dell'organizzazione di Azure DevOps.
projectId	path	True	string	Nome o ID (GUID) del progetto team in cui creare il team.
api-version	query	True	string	Versione dell'API da usare. Deve essere impostato su '7.1-preview.3' per usare questa versione dell'API.

Corpo della richiesta

Nome	Tipo	Descrizione
description	string	Descrizione del team
id	string	Guid del team (identità). ID Team Foundation.
identity	Identity	Identità del team.
identityUrl	string	URL dell'API REST di identità per questo team
name	string	Nome della squadra
projectId	string
projectName	string
url	string	URL DELL'API REST del team

Risposte

Nome	Tipo	Descrizione
200 OK	WebApiTeam	operazione riuscita

Sicurezza

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

Nome	Descrizione
vso.project_manage	Concede la possibilità di creare, leggere, aggiornare ed eliminare progetti e team.

Esempio

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"
}

Definizioni

Nome	Descrizione
Identity
IdentityDescriptor	Un descrittore di identità è un wrapper per il tipo di identità (SID di Windows, Passport) insieme a un identificatore univoco, ad esempio il SID o PUID.
PropertiesCollection	La classe rappresenta un contenitore di proprietà come raccolta di coppie chiave-valore. I valori di tutti i tipi primitivi (qualsiasi tipo con un `TypeCode != TypeCode.Object`) ad eccezione `DBNull` di vengono accettati. I valori di tipo Byte[], Int32, Double, DateType e String mantengono il tipo, le altre primitive vengono riattivate come String. Byte[] previsto come stringa con codifica Base64.
WebApiTeam

Identity

Nome	Tipo	Descrizione
customDisplayName	string	Nome visualizzato personalizzato per l'identità (se presente). L'impostazione di questa proprietà su una stringa vuota cancella il nome visualizzato personalizzato esistente. L'impostazione di questa proprietà su Null non influirà sul valore persistente esistente (poiché i valori Null non vengono inviati tramite rete o al database)
descriptor	IdentityDescriptor	Un descrittore di identità è un wrapper per il tipo di identità (SID di Windows, Passport) insieme a un identificatore univoco, ad esempio il SID o PUID.
id	string	Identificatore di identità. Chiamata anche chiave di archiviazione o VSID
isActive	boolean	True se l'identità ha un'appartenenza a un gruppo Azure Devops nell'organizzazione.
isContainer	boolean	True se l'identità è un gruppo.
masterId	string
memberIds	string[]	ID dei membri dell'identità (solo gruppi).
memberOf	IdentityDescriptor[]	Un descrittore di identità è un wrapper per il tipo di identità (SID di Windows, Passport) insieme a un identificatore univoco, ad esempio il SID o PUID.
members	IdentityDescriptor[]	Un descrittore di identità è un wrapper per il tipo di identità (SID di Windows, Passport) insieme a un identificatore univoco, ad esempio il SID o PUID.
metaTypeId	integer
properties	PropertiesCollection	La classe rappresenta un contenitore di proprietà come raccolta di coppie chiave-valore. I valori di tutti i tipi primitivi (qualsiasi tipo con un `TypeCode != TypeCode.Object`) ad eccezione `DBNull` di vengono accettati. I valori di tipo Byte[], Int32, Double, DateType e String mantengono il tipo, le altre primitive vengono riattivate come String. Byte[] previsto come stringa con codifica Base64.
providerDisplayName	string	Nome visualizzato per l'identità come specificato dal provider di identità di origine.
resourceVersion	integer
socialDescriptor	string
subjectDescriptor	string	Descrittore soggetto di un'entità Graph.
uniqueUserId	integer

IdentityDescriptor

Un descrittore di identità è un wrapper per il tipo di identità (SID di Windows, Passport) insieme a un identificatore univoco, ad esempio il SID o PUID.

Nome	Tipo	Descrizione
identifier	string	Identificatore univoco per questa identità, non superiore a 256 caratteri, che verranno salvati in modo permanente.
identityType	string	Tipo di descrittore (ad esempio, Windows, Passport e così via).

PropertiesCollection

La classe rappresenta un contenitore di proprietà come raccolta di coppie chiave-valore. I valori di tutti i tipi primitivi (qualsiasi tipo con un TypeCode != TypeCode.Object) ad eccezione DBNull di vengono accettati. I valori di tipo Byte[], Int32, Double, DateType e String mantengono il tipo, le altre primitive vengono riattivate come String. Byte[] previsto come stringa con codifica Base64.

Nome	Tipo	Descrizione
count	integer	Conteggio delle proprietà nell'insieme.
item	object
keys	string[]	Set di chiavi nell'insieme.
values	string[]	Set di valori nell'insieme.

WebApiTeam

Nome	Tipo	Descrizione
description	string	Descrizione del team
id	string	Guid del team (identità). ID Team Foundation.
identity	Identity	Identità del team.
identityUrl	string	URL dell'API REST di identità per questo team
name	string	Nome della squadra
projectId	string
projectName	string
url	string	URL DELL'API REST del team