Teams - Create
Создайте команду в командном проекте.
Возможные сценарии сбоя Недопустимое имя или идентификатор проекта (проект не существует) 404 Недопустимое имя команды или описание 400 Команда уже существует 400 Недостаточные привилегии 400
POST https://dev.azure.com/{organization}/_apis/projects/{projectId}/teams?api-version=7.1-preview.3
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
organization
|
path | True |
string |
Название организации Azure DevOps. |
project
|
path | True |
string |
Имя или идентификатор (GUID) командного проекта, в котором создается команда. |
api-version
|
query | True |
string |
Используемая версия API. Для использования этой версии API необходимо задать значение 7.1-preview.3. |
Текст запроса
Имя | Тип | Описание |
---|---|---|
description |
string |
Описание команды |
id |
string |
Guid команды (удостоверение). Идентификатор Team Foundation. |
identity |
Удостоверение команды. |
|
identityUrl |
string |
URL-адрес REST API удостоверений для этой команды |
name |
string |
Имя команды |
projectId |
string |
|
projectName |
string |
|
url |
string |
URL-адрес REST API для команды |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
успешная операция |
Безопасность
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_manage | Предоставляет возможность создавать, читать, обновлять и удалять проекты и команды. |
Примеры
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"
}
Определения
Имя | Описание |
---|---|
Identity | |
Identity |
Дескриптор удостоверения — это оболочка для типа удостоверения (Идентификатор безопасности Windows, Passport) вместе с уникальным идентификатором, таким как SID или PUID. |
Properties |
Класс представляет контейнер свойств в виде коллекции пар "ключ-значение". Принимаются значения всех примитивных типов (любого типа с |
Web |
Identity
Имя | Тип | Описание |
---|---|---|
customDisplayName |
string |
Настраиваемое отображаемое имя для удостоверения (если оно есть). Если задать для этого свойства пустую строку, существующее пользовательское отображаемое имя будет очищено. Присвоение этому свойству значения NULL не повлияет на существующее сохраненное значение (так как значения NULL не отправляются по сети или в базу данных). |
descriptor |
Дескриптор удостоверения — это оболочка для типа удостоверения (Идентификатор безопасности Windows, Passport) вместе с уникальным идентификатором, таким как SID или PUID. |
|
id |
string |
Идентификатор удостоверения. Также называется ключом хранилища или VSID. |
isActive |
boolean |
Значение true, если удостоверение является членом любой группы Azure Devops в организации. |
isContainer |
boolean |
Значение true, если удостоверение является группой. |
masterId |
string |
|
memberIds |
string[] |
Идентификатор членов удостоверения (только для групп). |
memberOf |
Дескриптор удостоверения — это оболочка для типа удостоверения (Идентификатор безопасности Windows, Passport) вместе с уникальным идентификатором, таким как SID или PUID. |
|
members |
Дескриптор удостоверения — это оболочка для типа удостоверения (Идентификатор безопасности Windows, Passport) вместе с уникальным идентификатором, таким как SID или PUID. |
|
metaTypeId |
integer |
|
properties |
Класс представляет контейнер свойств в виде коллекции пар "ключ-значение". Принимаются значения всех примитивных типов (любого типа с |
|
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 |
Удостоверение команды. |
|
identityUrl |
string |
URL-адрес REST API удостоверений для этой команды |
name |
string |
Имя команды |
projectId |
string |
|
projectName |
string |
|
url |
string |
URL-адрес REST API для команды |
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по