Aracılığıyla paylaş


Teams - Get Teams

Ekiplerin listesini alın.

GET https://dev.azure.com/{organization}/_apis/projects/{projectId}/teams?api-version=7.1
GET https://dev.azure.com/{organization}/_apis/projects/{projectId}/teams?$mine={$mine}&$top={$top}&$skip={$skip}&$expandIdentity={$expandIdentity}&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

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.

$expandIdentity
query

boolean

Sonuç WebApiTeam nesnesinde Kimlik bilgilerinin genişletilip genişletilmeyeceğini gösteren değer.

$mine
query

boolean

True ise, kullanıcının üye olduğunu isteyen tüm ekipleri döndür, aksi takdirde tüm teams kullanıcısının okuma erişimine sahip olduğunu döndür.

$skip
query

integer (int32)

Atlana takım sayısı.

$top
query

integer (int32)

Döndürülecek en fazla ekip sayısı.

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.profile Profilinizi, hesaplarınızı, koleksiyonlarınızı, projelerinizi, ekiplerinizi ve diğer üst düzey kuruluş yapıtlarınızı okuma olanağı sağlar.
vso.project Projeleri ve ekipleri okuma olanağı sağlar.

Örnekler

Örnek isteği

GET https://dev.azure.com/fabrikam/_apis/projects/eb6e4656-77fc-42a1-9181-4c6d8e9da5d1/teams?api-version=7.1

Örnek yanıt

{
  "value": [
    {
      "id": "564e8204-a90b-4432-883b-d4363c6125ca",
      "name": "Quality assurance",
      "url": "https://dev.azure.com/fabrikam/_apis/projects/eb6e4656-77fc-42a1-9181-4c6d8e9da5d1/teams/564e8204-a90b-4432-883b-d4363c6125ca",
      "description": "Testing staff",
      "identityUrl": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/564e8204-a90b-4432-883b-d4363c6125ca"
    },
    {
      "id": "66df9be7-3586-467b-9c5f-425b29afedfd",
      "name": "Fabrikam-Fiber-TFVC Team",
      "url": "https://dev.azure.com/fabrikam/_apis/projects/eb6e4656-77fc-42a1-9181-4c6d8e9da5d1/teams/66df9be7-3586-467b-9c5f-425b29afedfd",
      "description": "The default project team.",
      "identityUrl": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/66df9be7-3586-467b-9c5f-425b29afedfd"
    }
  ],
  "count": 2
}

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. TypeCode != TypeCode.Object dışındaki tüm ilkel türlerin (DBNullolan 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

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. TypeCode != TypeCode.Object dışındaki tüm ilkel türlerin (DBNullolan 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

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

sınıfı, anahtar-değer çiftleri koleksiyonu olarak bir özellik paketini temsil eder. TypeCode != TypeCode.Object dışındaki tüm ilkel türlerin (DBNullolan 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

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