Teams - Get Team Members With Extended Properties
取得特定小組的成員清單。
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
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
organization
|
path | True |
string |
Azure DevOps 組織的名稱。 |
project
|
path | True |
string |
小組所屬小組專案的名稱或識別碼 (GUID) 。 |
team
|
path | True |
string |
小組 的名稱或識別碼 (GUID) 。 |
api-version
|
query | True |
string |
要使用的 API 版本。 這應該設定為 '7.1-preview.2',以使用此版本的 API。 |
$skip
|
query |
integer int32 |
||
$top
|
query |
integer int32 |
回應
名稱 | 類型 | Description |
---|---|---|
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
名稱 | Description |
---|---|
vso.profile | 授與讀取設定檔、帳戶、集合、專案、小組和其他最上層組織成品的能力。 |
vso.project | 授與讀取專案和小組的能力。 |
範例
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
}
定義
名稱 | Description |
---|---|
Identity |
|
Reference |
表示 REST 參考連結集合的類別。 |
Team |
IdentityRef
名稱 | 類型 | Description |
---|---|---|
_links |
此欄位包含圖表主旨的相關零或更多有趣連結。 您可以叫用這些連結來取得其他關聯性,或取得此圖表主體的詳細資訊。 |
|
descriptor |
string |
描述項是在系統執行時參考圖形主旨的主要方式。 此欄位可唯一識別帳戶和組織之間的相同圖表主旨。 |
directoryAlias |
string |
已被取代 - 您可以藉由查詢 IdentityRef 「_links」 字典的 「self」 專案中參考的 Graph 使用者來擷取 |
displayName |
string |
這是圖形主體的非唯一顯示名稱。 若要變更此欄位,您必須變更來源提供者中的值。 |
id |
string |
|
imageUrl |
string |
已淘汰 - 可在 IdentityRef 「_links」 字典的 「avatar」 專案中使用 |
inactive |
boolean |
已被取代 - 您可以藉由查詢 GraphUser 「_links」 字典的 「membershipState」 專案中所參考的 Graph 成員資格狀態來擷取 |
isAadIdentity |
boolean |
已被取代 - 可以從描述元的主旨類型推斷 (描述元.IsAadUserType/Descriptor.IsAadGroupType) |
isContainer |
boolean |
已被取代 - 可以從描述元的主旨類型推斷 (描述元.IsGroupType) |
isDeletedInOrigin |
boolean |
|
profileUrl |
string |
已被取代 - 不在 ToIdentityRef 的大部分預先存在實作中使用 |
uniqueName |
string |
已被取代 - 請改用 Domain+PrincipalName |
url |
string |
此 URL 是此圖形主體來源資源的完整路由。 |
ReferenceLinks
表示 REST 參考連結集合的類別。
名稱 | 類型 | Description |
---|---|---|
links |
object |
連結的唯讀檢視。 因為參考連結是唯讀的,所以我們只想要將它們公開為唯讀。 |
TeamMember
名稱 | 類型 | Description |
---|---|---|
identity | ||
isTeamAdmin |
boolean |
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應