Projects - Update

Servicio:

Core

Versión de la API:

7.1

Actualice el nombre, la abreviatura, la descripción o la restauración de un proyecto existente.

PATCH https://dev.azure.com/{organization}/_apis/projects/{projectId}?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 (uuid)	Identificador del proyecto 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
_links	ReferenceLinks	Vínculos a otros objetos relacionados con este objeto.
abbreviation	string	Abreviatura del proyecto.
capabilities	object	Conjunto de funcionalidades que tiene este proyecto (como la plantilla de proceso & control de versiones).
defaultTeam	WebApiTeamRef	Referencia superficial al equipo predeterminado.
defaultTeamImageUrl	string	Dirección URL a la imagen de identidad del equipo predeterminada.
description	string	Descripción del proyecto (si existe).
id	string (uuid)	Identificador del proyecto.
lastUpdateTime	string (date-time)	Hora de última actualización del proyecto.
name	string	Nombre del proyecto.
revision	integer (int64)	Revisión del proyecto.
state	ProjectState	Estado del proyecto.
url	string	Dirección URL a la versión completa del objeto.
visibility	ProjectVisibility	Visibilidad del proyecto.

Respuestas

Nombre	Tipo	Description
200 OK	OperationReference	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.

Definiciones

Nombre	Description
OperationReference	Referencia de una operación asincrónica.
OperationStatus	Estado actual de la operación.
ProjectState	Estado actual del proyecto.
ProjectVisibility	Indica a quién está visible el proyecto.
ReferenceLinks	Clase que representa una colección de vínculos de referencia rest.
TeamProject	Representa un objeto Team Project.
WebApiTeamRef

OperationReference

Object

Referencia de una operación asincrónica.

Nombre	Tipo	Description
id	string (uuid)	Identificador único de la operación.
pluginId	string (uuid)	Identificador único del complemento.
status	OperationStatus	Estado actual de la operación.
url	string	Dirección URL para obtener el objeto de operación completa.

OperationStatus

Enumeración

Estado actual de la operación.

Valor	Description
cancelled	El usuario canceló la operación.
failed	La operación se completó con un error.
inProgress	La operación está en curso.
notSet	La operación no tiene un estado establecido.
queued	La operación se ha puesto en cola.
succeeded	La operación se completó correctamente.

ProjectState

Enumeración

Estado actual del proyecto.

Valor	Description
all	Todos los proyectos, independientemente del estado, excepto Eliminado.
createPending	Project se ha puesto en cola para su creación, pero el proceso aún no se ha iniciado.
deleted	Se ha eliminado el proyecto.
deleting	Project está en proceso de eliminación.
new	Project está en proceso de creación.
unchanged	El proyecto no se ha cambiado.
wellFormed	Project se crea completamente y está listo para usarse.

ProjectVisibility

Enumeración

Indica a quién está visible el proyecto.

Valor	Description
private	El proyecto solo es visible para los usuarios con acceso explícito.
public	El proyecto es visible para todos.

ReferenceLinks

Object

Clase que representa una colección de vínculos de referencia rest.

Nombre	Tipo	Description
links	object	Vista de solo lectura de los vínculos. Dado que los vínculos de referencia son de solo lectura, solo queremos exponerlos como de solo lectura.

TeamProject

Object

Representa un objeto Team Project.

Nombre	Tipo	Description
_links	ReferenceLinks	Vínculos a otros objetos relacionados con este objeto.
abbreviation	string	Abreviatura del proyecto.
capabilities	object	Conjunto de funcionalidades que tiene este proyecto (como la plantilla de proceso & control de versiones).
defaultTeam	WebApiTeamRef	Referencia superficial al equipo predeterminado.
defaultTeamImageUrl	string	Dirección URL a la imagen de identidad del equipo predeterminada.
description	string	Descripción del proyecto (si existe).
id	string (uuid)	Identificador del proyecto.
lastUpdateTime	string (date-time)	Hora de última actualización del proyecto.
name	string	Nombre del proyecto.
revision	integer (int64)	Revisión del proyecto.
state	ProjectState	Estado del proyecto.
url	string	Dirección URL a la versión completa del objeto.
visibility	ProjectVisibility	Visibilidad del proyecto.

WebApiTeamRef

Object

Nombre	Tipo	Description
id	string (uuid)	Guid del equipo (identidad). Identificador de Team Foundation.
name	string	Nombre del equipo
url	string	Dirección URL de la API REST de equipo