Leases - Add

Referencia

Servicio:: Build

Versión de la API:: 7.1-preview.2

Agrega nuevas concesiones para las ejecuciones de canalización.

POST https://dev.azure.com/{organization}/{project}/_apis/build/retention/leases?api-version=7.1-preview.2

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.1-preview.2" para usar esta versión de la API.

Cuerpo de la solicitud

Nombre	Tipo	Description
body	NewRetentionLease[]

Respuestas

Nombre	Tipo	Description
200 OK	RetentionLease[]	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.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.

Definiciones

Nombre	Description
NewRetentionLease	Información necesaria para crear una nueva concesión de retención.
RetentionLease	Una concesión de retención válida impide que los sistemas automatizados eliminen una ejecución de canalización.

NewRetentionLease

Object

Información necesaria para crear una nueva concesión de retención.

Nombre	Tipo	Description
daysValid	integer	Número de días que se deben considerar válidos para la concesión. Una concesión de retención válida durante más de 100 años (36500 días) se mostrará como conservar la compilación "para siempre".
definitionId	integer	Definición de canalización de la ejecución.
ownerId	string	Cadena proporcionada por el usuario que identifica al propietario de una concesión de retención.
protectPipeline	boolean	Si se establece, esta concesión también impedirá que se elimine la canalización mientras la concesión sigue siendo válida.
runId	integer	Ejecución de canalización para proteger.

RetentionLease