Teams - Create
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. |
project
|
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 |
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 |
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
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
{
"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 | |
Identity |
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. |
Properties |
La classe rappresenta un contenitore di proprietà come raccolta di coppie chiave-valore. I valori di tutti i tipi primitivi (qualsiasi tipo con un |
Web |
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 |
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 |
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 |
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 |
La classe rappresenta un contenitore di proprietà come raccolta di coppie chiave-valore. I valori di tutti i tipi primitivi (qualsiasi tipo con un |
|
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 |
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 |
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per