Teams - Get Team Members With Extended Properties

  • 参考
Service:
Core
API Version:
6.0

获取特定团队的成员列表。

GET https://dev.azure.com/{organization}/_apis/projects/{projectId}/teams/{teamId}/members?api-version=6.0
With optional parameters: 
GET https://dev.azure.com/{organization}/_apis/projects/{projectId}/teams/{teamId}/members?$top={$top}&$skip={$skip}&api-version=6.0

URI 参数

Name In Required Type Description
organization
 path True
  • string

Azure DevOps 组织的名称。
projectId
 path True
  • string

团队所属团队项目的名称或 ID (GUID) 。
teamId
 path True
  • string

团队的名称或 ID (GUID) 。
api-version
 query True
  • string

要使用的 API 版本。 这应设置为“6.0”以使用此版本的 API。
$skip
 query
  • integer
int32
$top
 query
  • integer
int32

响应

Name Type 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

Name 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=6.0

Sample Response

Status code:
200 
{
  "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
}

定义

IdentityRef
ReferenceLinks

表示 REST 引用链接集合的类。
TeamMember

IdentityRef

Name Type Description
_links

此字段包含有关图形主题的零个或多个有趣的链接。 可以调用这些链接以获取有关此图形主题的其他关系或更详细的信息。
descriptor
  • string

描述符是在系统运行时引用图形主题的主要方法。 此字段将唯一标识帐户和组织中的同一图形主题。
directoryAlias
  • string

已弃用 - 可以通过查询 IdentityRef“_links”字典的“self”条目中引用的 Graph 用户来检索
displayName
  • string

这是图形主题的非唯一显示名称。 若要更改此字段，必须在源提供程序中更改其值。
id
  • string
imageUrl
  • string

已弃用 - 在 IdentityRef“_links”字典的“头像”条目中可用
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 是此图形主题的源资源的完整路由。

表示 REST 引用链接集合的类。

Name Type Description
links
  • object

链接的只读视图。 由于引用链接是只读的，因此我们只想将其公开为只读链接。

TeamMember

Name Type Description
identity
isTeamAdmin
  • boolean