Teams - Create

Başvuru

Service:: Core

API Version:: 7.1-preview.3

Ekip projesinde ekip oluşturma.

Olası hata senaryoları Geçersiz proje adı/kimliği (proje yok) 404 Geçersiz ekip adı veya açıklaması 400 Ekip zaten var 400 Yetersiz ayrıcalıklar 400

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
organization	path	True	string	Azure DevOps kuruluşunun adı.
projectId	path	True	string	Ekibin oluşturulacağı takım projesinin adı veya kimliği (GUID).
api-version	query	True	string	Kullanılacak API'nin sürümü. Bu, api'nin bu sürümünü kullanmak için '7.1-preview.3' olarak ayarlanmalıdır.

İstek Gövdesi

Name	Tür	Description
description	string	Ekip açıklaması
id	string	Ekip (Kimlik) Guid'i. Team Foundation Kimliği.
identity	Identity	Ekip kimliği.
identityUrl	string	Bu ekibin Kimlik REST API'si Url'si
name	string	Takımın adı
projectId	string
projectName	string
url	string	Ekip REST API Url'si

Yanıtlar

Name	Tür	Description
200 OK	WebApiTeam	başarılı işlem

Güvenlik

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

Name	Description
vso.project_manage	Proje ve ekip oluşturma, okuma, güncelleştirme ve silme olanağı sağlar.

Örnekler

Sample Request

HTTP

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

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": "",
  "identityUrl": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/8e8aa4ff-848a-474a-9033-93190137c8e4"
}

Tanımlar

Name	Description
Identity
IdentityDescriptor	Kimlik tanımlayıcısı, kimlik türü (Windows SID, Passport) için sarmalayıcı ve SID veya PUID gibi benzersiz bir tanımlayıcıdır.
PropertiesCollection	sınıfı, anahtar-değer çiftleri koleksiyonu olarak bir özellik çantasını temsil eder. Dışındaki `DBNull` tüm ilkel türlerin (ile herhangi bir `TypeCode != TypeCode.Object`türü) değerleri kabul edilir. Byte[], Int32, Double, DateType ve String türündeki değerler türlerini korur, diğer temel öğeler Dize olarak döndürüler. Byte[] base64 kodlanmış dizesi olarak bekleniyor.
WebApiTeam

Identity

Name	Tür	Description
customDisplayName	string	Kimliğin özel görünen adı (varsa). Bu özelliğin boş bir dizeye ayarlanması, mevcut özel görünen adı temizler. Bu özelliğin null olarak ayarlanması mevcut kalıcı değeri etkilemez (null değerler kablo üzerinden veya veritabanına gönderilmediğinden)
descriptor	IdentityDescriptor	Kimlik tanımlayıcısı, kimlik türü (Windows SID, Passport) için sarmalayıcı ve SID veya PUID gibi benzersiz bir tanımlayıcıdır.
id	string	Kimlik Tanımlayıcısı. Depolama Anahtarı veya VSID olarak da adlandırılır
isActive	boolean	Kimliğin kuruluştaki herhangi bir Azure Devops grubunda üyeliği varsa True.
isContainer	boolean	Kimlik bir grupsa True.
masterId	string
memberIds	string[]	Kimlik üyelerinin kimliği (yalnızca gruplar).
memberOf	IdentityDescriptor[]	Kimlik tanımlayıcısı, kimlik türü (Windows SID, Passport) için sarmalayıcı ve SID veya PUID gibi benzersiz bir tanımlayıcıdır.
members	IdentityDescriptor[]	Kimlik tanımlayıcısı, kimlik türü (Windows SID, Passport) için sarmalayıcı ve SID veya PUID gibi benzersiz bir tanımlayıcıdır.
metaTypeId	integer
properties	PropertiesCollection	sınıfı, anahtar-değer çiftleri koleksiyonu olarak bir özellik çantasını temsil eder. Dışındaki `DBNull` tüm ilkel türlerin (ile herhangi bir `TypeCode != TypeCode.Object`türü) değerleri kabul edilir. Byte[], Int32, Double, DateType ve String türündeki değerler türlerini korur, diğer temel öğeler Dize olarak döndürüler. Byte[] base64 kodlanmış dizesi olarak bekleniyor.
providerDisplayName	string	Kaynak kimlik sağlayıcısı tarafından belirtilen kimliğin görünen adı.
resourceVersion	integer
socialDescriptor	string
subjectDescriptor	string	Graph varlığının konu tanımlayıcısı.
uniqueUserId	integer

IdentityDescriptor

Kimlik tanımlayıcısı, kimlik türü (Windows SID, Passport) için sarmalayıcı ve SID veya PUID gibi benzersiz bir tanımlayıcıdır.

Name	Tür	Description
identifier	string	Bu kimliğin benzersiz tanımlayıcısı 256 karakteri aşmaz ve kalıcı olur.
identityType	string	Tanımlayıcının türü (örneğin, Windows, Passport vb.).

PropertiesCollection

sınıfı, anahtar-değer çiftleri koleksiyonu olarak bir özellik çantasını temsil eder. Dışındaki DBNull tüm ilkel türlerin (ile herhangi bir TypeCode != TypeCode.Objecttürü) değerleri kabul edilir. Byte[], Int32, Double, DateType ve String türündeki değerler türlerini korur, diğer temel öğeler Dize olarak döndürüler. Byte[] base64 kodlanmış dizesi olarak bekleniyor.

Name	Tür	Description
count	integer	Koleksiyondaki özelliklerin sayısı.
item	object
keys	string[]	Koleksiyondaki anahtar kümesi.
values	string[]	Koleksiyondaki değer kümesi.

WebApiTeam

Name	Tür	Description
description	string	Ekip açıklaması
id	string	Ekip (Kimlik) Guid'i. Team Foundation Kimliği.
identity	Identity	Ekip kimliği.
identityUrl	string	Bu ekibin Kimlik REST API'si Url'si
name	string	Takımın adı
projectId	string
projectName	string
url	string	Ekip REST API Url'si

Share via