Teams - Update

Referência

Service:: Core

API Version:: 7.1-preview.3

Atualize o nome e/ou descrição de uma equipe.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
organization	path	True	string	O nome da organização do Azure DevOps.
projectId	path	True	string	O nome ou a ID (GUID) do projeto de equipe que contém a equipe a ser atualizada.
teamId	path	True	string	O nome da ID da equipe a ser atualizada.
api-version	query	True	string	Versão da API a ser usada. Isso deve ser definido como '7.1-preview.3' para usar essa versão da api.

Corpo da solicitação

Nome	Tipo	Description
description	string	Descrição da equipe
id	string	Guid de Equipe (Identidade). Uma ID do Team Foundation.
identity	Identity	Identidade da equipe.
identityUrl	string	Url da API REST de identidade para essa equipe
name	string	Nome da equipe
projectId	string
projectName	string
url	string	URL da API REST da equipe

Respostas

Nome	Tipo	Description
200 OK	WebApiTeam	operação bem-sucedida

Segurança

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

Nome	Description
vso.project_write	Concede a capacidade de ler e atualizar projetos e equipes.

Exemplos

Sample Request

HTTP

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

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

Definições

Nome	Description
Identity
IdentityDescriptor	Um descritor de identidade é um wrapper para o tipo de identidade (SID do Windows, Passport) juntamente com um identificador exclusivo, como o SID ou PUID.
PropertiesCollection	A classe representa um recipiente de propriedades como uma coleção de pares chave-valor. Os valores de todos os tipos primitivos (qualquer tipo com um `TypeCode != TypeCode.Object`) exceto para `DBNull` são aceitos. Valores do tipo Byte[], Int32, Double, DateType e String preservam seu tipo, outros primitivos são reajustados como uma Cadeia de Caracteres. Byte[] esperado como cadeia de caracteres codificada em base64.
WebApiTeam

Identity

Nome	Tipo	Description
customDisplayName	string	O nome de exibição personalizado para a identidade (se houver). Definir essa propriedade como uma cadeia de caracteres vazia limpará o nome de exibição personalizado existente. Definir essa propriedade como nula não afetará o valor persistente existente (uma vez que os valores nulos não são enviados pela transmissão ou pelo banco de dados)
descriptor	IdentityDescriptor	Um descritor de identidade é um wrapper para o tipo de identidade (SID do Windows, Passport) juntamente com um identificador exclusivo, como o SID ou PUID.
id	string	Identificador de identidade. Também chamado de Chave de Armazenamento ou VSID
isActive	boolean	True se a identidade tiver uma associação em qualquer grupo do Azure Devops na organização.
isContainer	boolean	True se a identidade for um grupo.
masterId	string
memberIds	string[]	Id dos membros da identidade (somente grupos).
memberOf	IdentityDescriptor[]	Um descritor de identidade é um wrapper para o tipo de identidade (SID do Windows, Passport) juntamente com um identificador exclusivo, como o SID ou PUID.
members	IdentityDescriptor[]	Um descritor de identidade é um wrapper para o tipo de identidade (SID do Windows, Passport) juntamente com um identificador exclusivo, como o SID ou PUID.
metaTypeId	integer
properties	PropertiesCollection	A classe representa um recipiente de propriedades como uma coleção de pares chave-valor. Os valores de todos os tipos primitivos (qualquer tipo com um `TypeCode != TypeCode.Object`) exceto para `DBNull` são aceitos. Valores do tipo Byte[], Int32, Double, DateType e String preservam seu tipo, outros primitivos são reajustados como uma Cadeia de Caracteres. Byte[] esperado como cadeia de caracteres codificada em base64.
providerDisplayName	string	O nome de exibição da identidade, conforme especificado pelo provedor de identidade de origem.
resourceVersion	integer
socialDescriptor	string
subjectDescriptor	string	Descritor de assunto de uma entidade do Graph.
uniqueUserId	integer

IdentityDescriptor

Um descritor de identidade é um wrapper para o tipo de identidade (SID do Windows, Passport) juntamente com um identificador exclusivo, como o SID ou PUID.

Nome	Tipo	Description
identifier	string	O identificador exclusivo para essa identidade, não excedendo 256 caracteres, que serão persistidos.
identityType	string	Tipo de descritor (por exemplo, Windows, Passport etc.).

PropertiesCollection

A classe representa um recipiente de propriedades como uma coleção de pares chave-valor. Os valores de todos os tipos primitivos (qualquer tipo com um TypeCode != TypeCode.Object) exceto para DBNull são aceitos. Valores do tipo Byte[], Int32, Double, DateType e String preservam seu tipo, outros primitivos são reajustados como uma Cadeia de Caracteres. Byte[] esperado como cadeia de caracteres codificada em base64.

Nome	Tipo	Description
count	integer	A contagem de propriedades na coleção.
item	object
keys	string[]	O conjunto de chaves na coleção.
values	string[]	O conjunto de valores na coleção.

WebApiTeam

Nome	Tipo	Description
description	string	Descrição da equipe
id	string	Guid de Equipe (Identidade). Uma ID do Team Foundation.
identity	Identity	Identidade da equipe.
identityUrl	string	Url da API REST de identidade para essa equipe
name	string	Nome da equipe
projectId	string
projectName	string
url	string	URL da API REST da equipe