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. |
project
|
path | True |
string |
Der Name oder die ID (GUID) des Teamprojekts, das das zu aktualisierende Team enthält. |
team
|
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 |
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 |
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 | |
Identity |
Ein Identitätsdeskriptor ist ein Wrapper für den Identitätstyp (Windows SID, Passport) und einen eindeutigen Bezeichner wie die SID oder PUID. |
Properties |
Die Klasse stellt einen Eigenschaftenbehälter als Sammlung von Schlüsselwertpaaren dar. Werte aller Grundtypen (beliebiger Typ mit einem |
Web |
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 |
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 |
Ein Identitätsdeskriptor ist ein Wrapper für den Identitätstyp (Windows SID, Passport) und einen eindeutigen Bezeichner wie die SID oder PUID. |
|
members |
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 |
Die Klasse stellt einen Eigenschaftenbehälter als Sammlung von Schlüsselwertpaaren dar. Werte aller Grundtypen (beliebiger Typ mit einem |
|
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 |
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 |