Leases - Get

Service:

Build

API Version:

7.1-preview.2

Devuelve los detalles de la concesión de retención según un identificador de concesión.

GET 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
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.

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	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 recibir notificaciones sobre eventos de compilación a través de enlaces de servicio.

Definiciones

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.