Teams - Update

Referencia

Service:: Core

API Version:: 6.0

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

PATCH https://dev.azure.com/{organization}/_apis/projects/{projectId}/teams/{teamId}?api-version=6.0

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
organization	path	True	string	El 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 "6.0" para usar esta versión de la API.

Cuerpo de la solicitud

Nombre	Tipo	Description
description	string	Descripción del equipo
id	string	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
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

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

Ejemplos

Sample Request

HTTP

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

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

Sample Response

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 ) `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 una cadena. Byte[] se esperaba como cadena codificada en base64.
WebApiTeam

Identity

Nombre	Tipo	Description
customDisplayName	string	Nombre para mostrar personalizado para 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	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
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 ) `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 una cadena. Byte[] se esperaba como cadena codificada en base64.
providerDisplayName	string	Nombre para mostrar de la identidad según lo especificado por 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 ) TypeCode != TypeCode.Objectexcepto .DBNull Los valores de tipo Byte[], Int32, Double, DateType y String conservan su tipo; otros primitivos se vuelven a ajustar como una cadena. 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). 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