Sdílet prostřednictvím


Teams - Get Team Members With Extended Properties

Získejte seznam členů pro konkrétní tým.

GET https://dev.azure.com/{organization}/_apis/projects/{projectId}/teams/{teamId}/members?api-version=7.1-preview.2
GET https://dev.azure.com/{organization}/_apis/projects/{projectId}/teams/{teamId}/members?$top={$top}&$skip={$skip}&api-version=7.1-preview.2

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
organization
path True

string

Název organizace Azure DevOps.

projectId
path True

string

Název nebo ID (GUID) týmového projektu, do které tým patří.

teamId
path True

string

Název nebo ID (GUID) týmu .

api-version
query True

string

Verze rozhraní API, která se má použít. Tato verze rozhraní API by měla být nastavená na 7.1-preview.2.

$skip
query

integer

int32
$top
query

integer

int32

Odpovědi

Name Typ Description
200 OK

TeamMember[]

úspěšná operace

Zabezpečení

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.profile Umožňuje číst váš profil, účty, kolekce, projekty, týmy a další artefakty organizace nejvyšší úrovně.
vso.project Uděluje možnost číst projekty a týmy.

Příklady

Sample Request

GET https://dev.azure.com/fabrikam/_apis/projects/eb6e4656-77fc-42a1-9181-4c6d8e9da5d1/teams/564e8204-a90b-4432-883b-d4363c6125ca/members?api-version=7.1-preview.2

Sample Response

{
  "value": [
    {
      "isTeamAdmin": false,
      "identity": {
        "id": "3b5f0c34-4aec-4bf4-8708-1d36f0dbc468",
        "displayName": "Christie Church",
        "uniqueName": "fabrikamfiber1@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/3b5f0c34-4aec-4bf4-8708-1d36f0dbc468",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=3b5f0c34-4aec-4bf4-8708-1d36f0dbc468"
      }
    },
    {
      "isTeamAdmin": false,
      "identity": {
        "id": "8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
        "displayName": "Chuck Reinhart",
        "uniqueName": "fabrikamfiber3@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=8c8c7d32-6b1b-47f4-b2e9-30b477b5ab3d"
      }
    },
    {
      "isTeamAdmin": true,
      "identity": {
        "id": "19d9411e-9a34-45bb-b985-d24d9d87c0c9",
        "displayName": "Johnnie McLeod",
        "uniqueName": "fabrikamfiber2@hotmail.com",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/19d9411e-9a34-45bb-b985-d24d9d87c0c9",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=19d9411e-9a34-45bb-b985-d24d9d87c0c9"
      }
    }
  ],
  "count": 3
}

Definice

Name Description
IdentityRef
ReferenceLinks

Třída představující kolekci odkazů REST.

TeamMember

IdentityRef

Name Typ Description
_links

ReferenceLinks

Toto pole neobsahuje žádný nebo více zajímavých odkazů na téma grafu. Tyto odkazy mohou být vyvolány za účelem získání dalších relací nebo podrobnějších informací o tomto předmětu grafu.

descriptor

string

Popisovač je primárním způsobem, jak odkazovat na předmět grafu, když je systém spuštěný. Toto pole jednoznačně identifikuje stejný předmět grafu v rámci účtů i organizací.

directoryAlias

string

Zastaralé – Dá se načíst dotazem na uživatele Graphu odkazovaného v položce "self" slovníku IdentityRef "_links"

displayName

string

Toto je jedinečný zobrazovaný název předmětu grafu. Pokud chcete toto pole změnit, musíte změnit jeho hodnotu ve zdrojovém poskytovateli.

id

string

imageUrl

string

Zastaralé – k dispozici v položce "avatar" ve slovníku IdentityRef "_links"

inactive

boolean

Zastaralé – Můžete ho načíst dotazem na stav členství v Graphu, na který odkazuje položka membershipState slovníku _links GraphUser.

isAadIdentity

boolean

Zastaralé – lze odvodit z typu předmětu popisovače (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)

isContainer

boolean

Zastaralé – Lze odvodit z typu předmětu popisovače (Descriptor.IsGroupType).

isDeletedInOrigin

boolean

profileUrl

string

Zastaralé – nepoužívá se ve většině dříve existujících implementací ToIdentityRef

uniqueName

string

Zastaralé – místo toho použijte Domain+PrincipalName.

url

string

Tato adresa URL představuje úplnou trasu ke zdrojovému prostředku tohoto předmětu grafu.

Třída představující kolekci odkazů REST.

Name Typ Description
links

object

Zobrazení odkazů jen pro čtení. Vzhledem k tomu, že odkazy jsou jen pro čtení, chceme je zveřejnit jenom jako odkazy jen pro čtení.

TeamMember

Name Typ Description
identity

IdentityRef

isTeamAdmin

boolean