Projects - Get

Referencia

Service:: Core

API Version:: 7.1-preview.4

Obtenga el proyecto con el identificador o el nombre especificados, opcionalmente, incluidas las funcionalidades.

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

With optional parameters:

GET https://dev.azure.com/{organization}/_apis/projects/{projectId}?includeCapabilities={includeCapabilities}&includeHistory={includeHistory}&api-version=7.1-preview.4

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
api-version	query	True	string	Versión de la API que se va a usar. Debe establecerse en "7.1-preview.4" para usar esta versión de la API.
includeCapabilities	query		boolean	Incluya funcionalidades (como el control de código fuente) en el resultado del proyecto de equipo (valor predeterminado: false).
includeHistory	query		boolean	Busque en proyectos cuyo nombre se haya cambiado (que tenía ese nombre en el pasado).

Respuestas

Nombre	Tipo	Description
200 OK	TeamProject	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.profile	Concede la capacidad de leer el perfil, las cuentas, las colecciones, los proyectos, los equipos y otros artefactos organizativos de nivel superior.
vso.project	Concede la capacidad de leer proyectos y equipos.

Definiciones

Nombre	Description
ProjectState	Estado actual del proyecto.
ProjectVisibility	Indica a quién está visible el proyecto.
ReferenceLinks	Clase que se va a representar una colección de vínculos de referencia de REST.
TeamProject	Representa un objeto Team Project.
WebApiTeamRef

ProjectState

Estado actual del proyecto.

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

ProjectVisibility

Indica a quién está visible el proyecto.

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

ReferenceLinks

Clase que se va a representar una colección de vínculos de referencia de REST.

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

TeamProject

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 de equipo predeterminada.
description	string	Descripción del proyecto (si existe).
id	string	Identificador del proyecto.
lastUpdateTime	string	Hora de la última actualización del proyecto.
name	string	Nombre del proyecto.
revision	integer	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

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