Teams - Create

Hizmet:

Core

API Sürümü:

7.1

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

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' olarak ayarlanmalıdır.

İstek Gövdesi

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

Yanıtlar

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

Güvenlik

oauth2

Tür: oauth2
Akış: accessCode
Yetkilendirme URL’si: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Belirteç URL'si: 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

Kapsamlar

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

Örnekler

Örnek isteği

HTTP

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

{
  "name": "My new team"
}

Örnek yanıt

Durum kodu:

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) ve SID veya PUID gibi benzersiz bir tanımlayıcı için sarmalayıcıdır.
PropertiesCollection	sınıfı, anahtar-değer çiftleri koleksiyonu olarak bir özellik paketini temsil eder. DBNull dışındaki tüm ilkel türlerin (TypeCode != TypeCode.Objectolan herhangi bir 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 yeniden dönüştürülür. Byte[] base64 kodlanmış dize olarak bekleniyor.
WebApiTeam

Identity

Object

Name	Tür	Description
customDisplayName	string	Kimliğin özel görünen adı (varsa). Bu özelliği boş bir dize olarak ayarlamak, var olan ö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) ve SID veya PUID gibi benzersiz bir tanımlayıcı için sarmalayıcıdır.
id	string (uuid)	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 (uuid)
memberIds	string[] (uuid)	Kimlik üyelerinin kimliği (yalnızca gruplar).
memberOf	IdentityDescriptor[]	Kimlik tanımlayıcısı, kimlik türü (Windows SID, Passport) ve SID veya PUID gibi benzersiz bir tanımlayıcı için sarmalayıcıdır.
members	IdentityDescriptor[]	Kimlik tanımlayıcısı, kimlik türü (Windows SID, Passport) ve SID veya PUID gibi benzersiz bir tanımlayıcı için sarmalayıcıdır.
metaTypeId	integer (int32)
properties	PropertiesCollection	sınıfı, anahtar-değer çiftleri koleksiyonu olarak bir özellik paketini temsil eder. DBNull dışındaki tüm ilkel türlerin (TypeCode != TypeCode.Objectolan herhangi bir 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 yeniden dönüştürülür. Byte[] base64 kodlanmış dize olarak bekleniyor.
providerDisplayName	string	Kaynak kimlik sağlayıcısı tarafından belirtilen kimliğin görünen adı.
resourceVersion	integer (int32)
socialDescriptor	string
subjectDescriptor	string	Graph varlığının konu tanımlayıcısı.
uniqueUserId	integer (int32)

IdentityDescriptor

Object

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

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

PropertiesCollection

Object

sınıfı, anahtar-değer çiftleri koleksiyonu olarak bir özellik paketini temsil eder. DBNull dışındaki tüm ilkel türlerin (TypeCode != TypeCode.Objectolan herhangi bir 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 yeniden dönüştürülür. Byte[] base64 kodlanmış dize olarak bekleniyor.

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

WebApiTeam

Object

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