Teams - Update

Referencia

Servicio:: Core

Versión de la API:: 7.1

Actualice el nombre o la descripción de un equipo.

PATCH https://dev.azure.com/{organization}/_apis/projects/{projectId}/teams/{teamId}?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	Nombre o identificador (GUID) del proyecto de equipo que contiene el equipo que se va a actualizar.
teamId	path	True	string	Nombre del identificador del equipo que se va a actualizar.
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.

Cuerpo de la solicitud

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

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.project_write	Concede la capacidad de leer y actualizar proyectos y equipos.

Ejemplos

Solicitud de ejemplo

HTTP

PATCH https://dev.azure.com/fabrikam/_apis/projects/8e5a3cfb-fed3-46f3-8657-e3b175cd0305/teams/{teamId}?api-version=7.1

{
  "name": "My new team",
  "description": "Description of my team"
}

Respuesta de muestra

status code:: 200

{
  "id": "8e8aa4ff-848a-474a-9033-93190137c8e4",
  "name": "My New Team",
  "url": "https://dev.azure.com/fabrikam/_apis/projects/8e5a3cfb-fed3-46f3-8657-e3b175cd0305/teams/8e8aa4ff-848a-474a-9033-93190137c8e4",
  "description": "Description of my team",
  "identityUrl": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/8e8aa4ff-848a-474a-9033-93190137c8e4"
}

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 - Update

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

oauth2

Ámbitos

Ejemplos

Solicitud de ejemplo

Respuesta de muestra

Definiciones

Identity

IdentityDescriptor

PropertiesCollection

WebApiTeam