Teams - Update

Riferimento

Service:: Core

API Version:: 7.1-preview.3

Aggiornare il nome e/o la descrizione di un team.

PATCH https://dev.azure.com/{organization}/_apis/projects/{projectId}/teams/{teamId}?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 contenente il team da aggiornare.
teamId	path	True	string	Nome dell'ID del team da aggiornare.
api-version	query	True	string	Versione dell'API da usare. Questa opzione deve essere impostata 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_write	Concede la possibilità di leggere e aggiornare progetti e team.

Esempio

Sample Request

HTTP

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

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

Definizioni

Nome	Descrizione
Identity
IdentityDescriptor	Un descrittore Identity è un wrapper per il tipo di identità (Windows SID, Passport) insieme a un identificatore univoco, ad esempio 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 sono accettati. I valori di tipo Byte[], Int32, Double, DateType e String mantengono il tipo, altre primitive vengono ritunate come String. Byte[] previsto come stringa codificata 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 influisce sul valore persistente esistente (poiché i valori Null non vengono inviati tramite la rete o al database)
descriptor	IdentityDescriptor	Un descrittore Identity è un wrapper per il tipo di identità (Windows SID, Passport) insieme a un identificatore univoco, ad esempio 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 qualsiasi gruppo Di 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 Identity è un wrapper per il tipo di identità (Windows SID, Passport) insieme a un identificatore univoco, ad esempio SID o PUID.
members	IdentityDescriptor[]	Un descrittore Identity è un wrapper per il tipo di identità (Windows SID, Passport) insieme a un identificatore univoco, ad esempio 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 sono accettati. I valori di tipo Byte[], Int32, Double, DateType e String mantengono il tipo, altre primitive vengono ritunate come String. Byte[] previsto come stringa codificata 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 Identity è un wrapper per il tipo di identità (Windows SID, Passport) insieme a un identificatore univoco, ad esempio SID o PUID.

Nome	Tipo	Descrizione
identifier	string	Identificatore univoco per questa identità, non superiore a 256 caratteri, che verranno mantenuti.
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 sono accettati. I valori di tipo Byte[], Int32, Double, DateType e String mantengono il tipo, altre primitive vengono ritunate come String. Byte[] previsto come stringa codificata base64.

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

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