Teams - Get Teams

Referencia

Servicio:: Core

Versión de la API:: 7.1

Obtenga una lista de equipos.

GET https://dev.azure.com/{organization}/_apis/projects/{projectId}/teams?api-version=7.1

Con parámetros opcionales:

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
organization	path	True	string	Nombre de la organización de Azure DevOps.
projectId	path	True	string
api-version	query	True	string	Versión de la API que se va a usar. Debe establecerse en "7.1" 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, devuelve todos los equipos que solicitan el usuario es miembro; de lo contrario, devuelve todo el usuario de teams 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

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Dirección URL del token: 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

Ámbitos

Nombre	Description
vso.profile	Concede la capacidad de leer el perfil, las cuentas, las colecciones, los proyectos, los equipos y otros artefactos de la organización de nivel superior.
vso.project	Concede la capacidad de leer proyectos y equipos.

Ejemplos

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:: 200

{
  "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 para `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

Object

Nombre	Tipo	Description
customDisplayName	string	Nombre para mostrar personalizado de la identidad (si existe). Si establece 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 (uuid)	Identificador de identidad. También denominado 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 (uuid)
memberIds	string[] (uuid)	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 (int32)
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 para `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 como especifica el proveedor de identidades de origen.
resourceVersion	integer (int32)
socialDescriptor	string
subjectDescriptor	string	Descriptor de asunto de una entidad Graph.
uniqueUserId	integer (int32)

IdentityDescriptor

Object

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

Object

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 para 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 (int32)	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

Object

Nombre	Tipo	Description
description	string	Descripción del equipo
id	string (uuid)	Guid del equipo (identidad). 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 (uuid)
projectName	string
url	string	Dirección URL de la API REST de equipo

Compartir a través de

Teams - Get Teams

Parámetros de identificador URI

Respuestas

Seguridad

oauth2

Ámbitos

Ejemplos

Solicitud de ejemplo

Respuesta de muestra

Definiciones

Identity

IdentityDescriptor

PropertiesCollection

WebApiTeam