Environments - Add

Service:

Environments

API Version:

7.2-preview.1

Crear un entorno

POST https://dev.azure.com/{organization}/{project}/_apis/pipelines/environments?api-version=7.2-preview.1

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
organization	path	True	string	El nombre de la organización de Azure DevOps.
project	path	True	string	Id. de proyecto o nombre del proyecto
api-version	query	True	string	Versión de la API que se va a usar. Debe establecerse en "7.2-preview.1" para usar esta versión de la API.

Cuerpo de la solicitud

Nombre	Tipo	Description
description	string	Descripción del entorno.
name	string	Nombre del entorno.

Respuestas

Nombre	Tipo	Description
200 OK	EnvironmentInstance	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.build_execute	Concede la capacidad de acceder a los artefactos de compilación, incluidos los resultados de compilación, las definiciones y las solicitudes, y la capacidad de poner en cola una compilación, actualizar las propiedades de compilación y la capacidad de recibir notificaciones sobre eventos de compilación a través de enlaces de servicio.
vso.environment_manage	Proporciona la capacidad de administrar el entorno.

Definiciones

Nombre	Description
EnvironmentCreateParameter	Propiedades para crear el entorno.
EnvironmentInstance	Entorno.
EnvironmentResourceReference	EnvironmentResourceReference.
EnvironmentResourceType	Tipo de recurso.
IdentityRef
ProjectReference
ReferenceLinks

EnvironmentCreateParameter

Propiedades para crear el entorno.

Nombre	Tipo	Description
description	string	Descripción del entorno.
name	string	Nombre del entorno.

EnvironmentInstance

Entorno.

Nombre	Tipo	Description
createdBy	IdentityRef	Referencia de identidad del usuario que creó el entorno.
createdOn	string	Hora de creación del entorno
description	string	Descripción del entorno.
id	integer	Id. del entorno
lastModifiedBy	IdentityRef	Referencia de identidad del usuario que modificó por última vez el entorno.
lastModifiedOn	string	Hora de la última modificación del entorno
name	string	Nombre del entorno.
project	ProjectReference	Información del proyecto para el entorno.
resources	EnvironmentResourceReference[]	EnvironmentResourceReference.

EnvironmentResourceReference

EnvironmentResourceReference.

Nombre	Tipo	Description
id	integer	Identificador del recurso.
name	string	Nombre del recurso.
tags	string[]	Etiquetas de la referencia de recursos de entorno.
type	EnvironmentResourceType	Tipo de recurso.

EnvironmentResourceType

Tipo de recurso.

Nombre	Tipo	Description
generic	string	Tipo de recurso desconocido
kubernetes	string	Tipo de recurso de Kubernetes
undefined	string
virtualMachine	string	Tipo de recurso de máquina virtual

IdentityRef

Nombre	Tipo	Description
_links	ReferenceLinks
descriptor	string
directoryAlias	string
displayName	string
id	string
imageUrl	string
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string

ProjectReference

Nombre	Tipo	Description
id	string
name	string

ReferenceLinks

Nombre	Tipo	Description
links	object