Freigeben über


Teams - Update

Aktualisieren Sie den Namen und/oder die Beschreibung eines Teams.

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

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, das das zu aktualisierende Team enthält.

teamId
path True

string

Der Name der ID des zu aktualisierenden Teams.

api-version
query True

string

Version der zu verwendenden API. Dies sollte auf "7.1" festgelegt werden, um diese Version der API zu verwenden.

Anforderungstext

Name Typ Beschreibung
description

string

Teambeschreibung

id

string (uuid)

Team-GUID. Eine Team Foundation-ID.

identity

Identity

Teamidentität.

identityUrl

string

ID-REST-API-URL zu diesem Team

name

string

Teamname

projectId

string (uuid)

projectName

string

url

string

Team-REST-API-URL

Antworten

Name Typ Beschreibung
200 OK

WebApiTeam

Erfolgreicher Vorgang

Sicherheit

oauth2

Typ: oauth2
Ablauf: accessCode
Autorisierungs-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

Bereiche

Name Beschreibung
vso.project_write Gewährt die Möglichkeit, Projekte und Teams zu lesen und zu aktualisieren.

Beispiele

Beispielanforderung

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

{
  "name": "My new team",
  "description": "Description of my team"
}

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
Identity
IdentityDescriptor

Ein Identitätsdeskriptor ist ein Wrapper für den Identitätstyp (Windows SID, Passport) und einen eindeutigen Bezeichner wie die SID oder PUID.

PropertiesCollection

Die Klasse stellt einen Eigenschaftenbehälter als Sammlung von Schlüsselwertpaaren dar. Werte aller Grundtypen (beliebiger 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 Zeichenfolge neu abgestimmt. 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) und einen eindeutigen Bezeichner wie die SID oder PUID.

id

string (uuid)

Identitätsbezeichner. Auch als Speicherschlüssel oder VSID bezeichnet

isActive

boolean

True, wenn die Identität eine Mitgliedschaft in einer beliebigen Azure Devops-Gruppe in der Organisation hat.

isContainer

boolean

True, wenn die Identität eine Gruppe ist.

masterId

string (uuid)

memberIds

string[] (uuid)

ID der Mitglieder der Identität (nur Gruppen).

memberOf

IdentityDescriptor[]

Ein Identitätsdeskriptor ist ein Wrapper für den Identitätstyp (Windows SID, Passport) und einen eindeutigen Bezeichner wie die SID oder PUID.

members

IdentityDescriptor[]

Ein Identitätsdeskriptor ist ein Wrapper für den Identitätstyp (Windows SID, Passport) und einen eindeutigen Bezeichner wie die SID oder PUID.

metaTypeId

integer (int32)

properties

PropertiesCollection

Die Klasse stellt einen Eigenschaftenbehälter als Sammlung von Schlüsselwertpaaren dar. Werte aller Grundtypen (beliebiger 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 Zeichenfolge neu abgestimmt. Byte[] als base64-codierte Zeichenfolge erwartet.

providerDisplayName

string

Der Anzeigename für die Identität, wie vom Quellidentitätsanbieter angegeben.

resourceVersion

integer (int32)

socialDescriptor

string

subjectDescriptor

string

Betreffdeskriptor einer Graph-Entität.

uniqueUserId

integer (int32)

IdentityDescriptor

Ein Identitätsdeskriptor ist ein Wrapper für den Identitätstyp (Windows SID, Passport) und einen eindeutigen Bezeichner wie die SID oder PUID.

Name Typ Beschreibung
identifier

string

Der eindeutige Bezeichner für diese Identität, nicht mehr als 256 Zeichen, die beibehalten werden.

identityType

string

Typ des Deskriptors (z. B. Windows, Passport usw.).

PropertiesCollection

Die Klasse stellt einen Eigenschaftenbehälter als Sammlung von Schlüsselwertpaaren dar. Werte aller Grundtypen (beliebiger 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 Zeichenfolge neu abgestimmt. Byte[] als base64-codierte Zeichenfolge erwartet.

Name Typ Beschreibung
count

integer (int32)

Die Anzahl der Eigenschaften in der Auflistung.

item

object

keys

string[]

Der Satz von Schlüsseln in der Auflistung.

values

string[]

Der Wertesatz in der Auflistung.

WebApiTeam

Name Typ Beschreibung
description

string

Teambeschreibung

id

string (uuid)

Team-GUID. Eine Team Foundation-ID.

identity

Identity

Teamidentität.

identityUrl

string

ID-REST-API-URL zu diesem Team

name

string

Teamname

projectId

string (uuid)

projectName

string

url

string

Team-REST-API-URL