Leases - Update

Service:

Build

API Version:

7.1-preview.2

Novedades el estado de protección de canalización o duración de una concesión de retención.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
leaseId	path	True	integer int32	Identificador de la concesión que se va a actualizar.
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
daysValid	integer	Número de días que se deben tener en cuenta la concesión válida. Una concesión de retención válida durante más de 100 años (36500 días) se mostrará como retención de la compilación "para siempre".
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.

Respuestas

Nombre	Tipo	Description
200 OK	RetentionLease	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 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
RetentionLease	Una concesión de retención válida impide que los sistemas automatizados eliminen una ejecución de canalización.
RetentionLeaseUpdate	Actualización de los parámetros de retención de una 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.

Nombre	Tipo	Description
createdOn	string	Cuando se creó la concesión.
definitionId	integer	Definición de canalización de la ejecución.
leaseId	integer	Identificador único de esta concesión.
ownerId	string	Cadena no única 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	La canalización se ejecuta protegida por esta concesión.
validUntil	string	El último día en que el contrato de arrendamiento se considera válido.

RetentionLeaseUpdate

Actualización de los parámetros de retención de una concesión de retención.

Nombre	Tipo	Description
daysValid	integer	Número de días que se deben tener en cuenta la concesión válida. Una concesión de retención válida durante más de 100 años (36500 días) se mostrará como retención de la compilación "para siempre".
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.