Teams - Update

Ссылка

Service:: Core

API Version:: 7.1-preview.3

Обновите имя и описание команды.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
organization	path	True	string	Название организации Azure DevOps.
projectId	path	True	string	Имя или идентификатор (GUID) командного проекта, содержащего команду для обновления.
teamId	path	True	string	Имя идентификатора обновляемой команды.
api-version	query	True	string	Используемая версия API. Для использования этой версии API необходимо задать значение 7.1-preview.3.

Текст запроса

Имя	Тип	Описание
description	string	Описание команды
id	string	Guid команды (удостоверение). Идентификатор Team Foundation.
identity	Identity	Удостоверение команды.
identityUrl	string	URL-адрес REST API удостоверений для этой команды
name	string	Имя команды
projectId	string
projectName	string
url	string	URL-адрес REST API для команды

Ответы

Имя	Тип	Описание
200 OK	WebApiTeam	успешная операция

Безопасность

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

Имя	Описание
vso.project_write	Предоставляет возможность чтения и обновления проектов и команд.

Примеры

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

Определения

Имя	Описание
Identity
IdentityDescriptor	Дескриптор удостоверения — это оболочка для типа удостоверения (Идентификатор безопасности Windows, Passport) вместе с уникальным идентификатором, таким как SID или PUID.
PropertiesCollection	Класс представляет контейнер свойств в виде коллекции пар "ключ-значение". Принимаются значения всех примитивных типов (любого типа с `TypeCode != TypeCode.Object`), кроме `DBNull` . Значения типа Byte[], Int32, Double, DateType и String сохраняют свой тип, другие примитивы перенастраиваются как String. Byte[] — строка в кодировке Base64.
WebApiTeam

Identity

Имя	Тип	Описание
customDisplayName	string	Настраиваемое отображаемое имя для удостоверения (если оно есть). Если задать для этого свойства пустую строку, существующее пользовательское отображаемое имя будет очищено. Присвоение этому свойству значения NULL не повлияет на существующее сохраненное значение (так как значения NULL не отправляются по сети или в базу данных).
descriptor	IdentityDescriptor	Дескриптор удостоверения — это оболочка для типа удостоверения (Идентификатор безопасности Windows, Passport) вместе с уникальным идентификатором, таким как SID или PUID.
id	string	Идентификатор удостоверения. Также называется ключом хранилища или VSID.
isActive	boolean	Значение true, если удостоверение является членом любой группы Azure Devops в организации.
isContainer	boolean	Значение true, если удостоверение является группой.
masterId	string
memberIds	string[]	Идентификатор членов удостоверения (только для групп).
memberOf	IdentityDescriptor[]	Дескриптор удостоверения — это оболочка для типа удостоверения (Идентификатор безопасности Windows, Passport) вместе с уникальным идентификатором, таким как SID или PUID.
members	IdentityDescriptor[]	Дескриптор удостоверения — это оболочка для типа удостоверения (Идентификатор безопасности Windows, Passport) вместе с уникальным идентификатором, таким как SID или PUID.
metaTypeId	integer
properties	PropertiesCollection	Класс представляет контейнер свойств в виде коллекции пар "ключ-значение". Принимаются значения всех примитивных типов (любого типа с `TypeCode != TypeCode.Object`), кроме `DBNull` . Значения типа Byte[], Int32, Double, DateType и String сохраняют свой тип, другие примитивы перенастраиваются как String. Byte[] — строка в кодировке Base64.
providerDisplayName	string	Отображаемое имя удостоверения, указанное поставщиком удостоверений источника.
resourceVersion	integer
socialDescriptor	string
subjectDescriptor	string	Дескриптор субъекта сущности Graph.
uniqueUserId	integer

IdentityDescriptor

Дескриптор удостоверения — это оболочка для типа удостоверения (Идентификатор безопасности Windows, Passport) вместе с уникальным идентификатором, таким как SID или PUID.

Имя	Тип	Описание
identifier	string	Уникальный идентификатор для этого удостоверения, не превышающий 256 символов, который будет сохранен.
identityType	string	Тип дескриптора (например, Windows, Passport и т. д.).

PropertiesCollection

Класс представляет контейнер свойств в виде коллекции пар "ключ-значение". Принимаются значения всех примитивных типов (любого типа с TypeCode != TypeCode.Object), кроме DBNull . Значения типа Byte[], Int32, Double, DateType и String сохраняют свой тип, другие примитивы перенастраиваются как String. Byte[] — строка в кодировке Base64.

Имя	Тип	Описание
count	integer	Количество свойств в коллекции.
item	object
keys	string[]	Набор ключей в коллекции.
values	string[]	Набор значений в коллекции.

WebApiTeam

Имя	Тип	Описание
description	string	Описание команды
id	string	Guid команды (удостоверение). Идентификатор Team Foundation.
identity	Identity	Удостоверение команды.
identityUrl	string	URL-адрес REST API удостоверений для этой команды
name	string	Имя команды
projectId	string
projectName	string
url	string	URL-адрес REST API для команды