Teams - Get All Teams

Obtenga una lista de todos los equipos.

GET https://dev.azure.com/{organization}/_apis/teams?api-version=6.0-preview.3
GET https://dev.azure.com/{organization}/_apis/teams?$mine={$mine}&$top={$top}&$skip={$skip}&$expandIdentity={$expandIdentity}&api-version=6.0-preview.3

Parámetros de identificador URI

Nombre En Requerido Tipo Description
organization
path True

string

El nombre de la organización de Azure DevOps.

api-version
query True

string

Versión de la API que se va a usar. Debe establecerse en "6.0-preview.3" para usar esta versión de la API.

$expandIdentity
query

boolean

Valor que indica si se va a expandir información de identidad en el objeto WebApiTeam resultante.

$mine
query

boolean

Si es true, devuelva todos los equipos que solicitan el usuario es miembro. De lo contrario, devuelve todos los equipos a los que el usuario tiene acceso de lectura.

$skip
query

integer

int32

Número de equipos que se van a omitir.

$top
query

integer

int32

Número máximo de equipos que se van a devolver.

Respuestas

Nombre Tipo Description
200 OK

WebApiTeam[]

operación correcta

Seguridad

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

Nombre Description
vso.project Concede la capacidad de leer proyectos y equipos.

Ejemplos

Sample Request

GET https://dev.azure.com/fabrikam/_apis/teams?$mine=True&api-version=6.0-preview.3

Sample Response

{
  "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
}

Definiciones

Nombre Description
Identity
IdentityDescriptor

Un descriptor de identidad es un contenedor para el tipo de identidad (SID de Windows, Passport) junto con un identificador único, como el SID o PUID.

PropertiesCollection

La clase representa un contenedor de propiedades como una colección de pares clave-valor. Se aceptan valores de todos los tipos primitivos (cualquier tipo con un TypeCode != TypeCode.Object) excepto DBNull . Los valores de tipo Byte[], Int32, Double, DateType y String conservan su tipo; otros primitivos se vuelven a ajustar como string. Byte[] se esperaba como cadena codificada en base64.

WebApiTeam

Identity

Nombre Tipo Description
customDisplayName

string

Nombre para mostrar personalizado de la identidad (si existe). Al establecer esta propiedad en una cadena vacía, se borrará el nombre para mostrar personalizado existente. Establecer esta propiedad en null no afectará al valor persistente existente (ya que los valores NULL no se envían a través de la conexión ni a la base de datos).

descriptor

IdentityDescriptor

Un descriptor de identidad es un contenedor para el tipo de identidad (SID de Windows, Passport) junto con un identificador único, como el SID o PUID.

id

string

Identificador de identidad. También se denomina clave de almacenamiento o VSID

isActive

boolean

True si la identidad tiene una pertenencia a cualquier grupo de Azure Devops de la organización.

isContainer

boolean

True si la identidad es un grupo.

masterId

string

memberIds

string[]

Identificador de los miembros de la identidad (solo grupos).

memberOf

IdentityDescriptor[]

Un descriptor de identidad es un contenedor para el tipo de identidad (SID de Windows, Passport) junto con un identificador único, como el SID o PUID.

members

IdentityDescriptor[]

Un descriptor de identidad es un contenedor para el tipo de identidad (SID de Windows, Passport) junto con un identificador único, como el SID o PUID.

metaTypeId

integer

properties

PropertiesCollection

La clase representa un contenedor de propiedades como una colección de pares clave-valor. Se aceptan valores de todos los tipos primitivos (cualquier tipo con un TypeCode != TypeCode.Object) excepto DBNull . Los valores de tipo Byte[], Int32, Double, DateType y String conservan su tipo; otros primitivos se vuelven a ajustar como string. Byte[] se esperaba como cadena codificada en base64.

providerDisplayName

string

Nombre para mostrar de la identidad tal y como especifica el proveedor de identidades de origen.

resourceVersion

integer

socialDescriptor

string

subjectDescriptor

string

Descriptor de asunto de una entidad Graph.

uniqueUserId

integer

IdentityDescriptor

Un descriptor de identidad es un contenedor para el tipo de identidad (SID de Windows, Passport) junto con un identificador único, como el SID o PUID.

Nombre Tipo Description
identifier

string

Identificador único de esta identidad, que no supera los 256 caracteres, que se conservarán.

identityType

string

Tipo de descriptor (por ejemplo, Windows, Passport, etc.).

PropertiesCollection

La clase representa un contenedor de propiedades como una colección de pares clave-valor. Se aceptan valores de todos los tipos primitivos (cualquier tipo con un TypeCode != TypeCode.Object) excepto DBNull . Los valores de tipo Byte[], Int32, Double, DateType y String conservan su tipo; otros primitivos se vuelven a ajustar como string. Byte[] se esperaba como cadena codificada en base64.

Nombre Tipo Description
count

integer

Recuento de propiedades de la colección.

item

object

keys

string[]

Conjunto de claves de la colección.

values

string[]

Conjunto de valores de la colección.

WebApiTeam

Nombre Tipo Description
description

string

Descripción del equipo

id

string

Guid del equipo (identidad). Un identificador de Team Foundation.

identity

Identity

Identidad del equipo.

identityUrl

string

Dirección URL de la API REST de identidad a este equipo

name

string

Nombre del equipo

projectId

string

projectName

string

url

string

Dirección URL de la API REST de equipo