Partager via


Builds - Get Retention Leases For Build

Obtient tous les baux de rétention qui s’appliquent à une build spécifique.

GET https://dev.azure.com/{organization}/{project}/_apis/build/builds/{buildId}/leases?api-version=7.1-preview.1

Paramètres URI

Nom Dans Obligatoire Type Description
buildId
path True

integer

int32

ID de la build.

organization
path True

string

Nom de l’organisation Azure DevOps.

project
path True

string

ID de projet ou nom du projet

api-version
query True

string

Version de l’API à utiliser. Cette valeur doit être définie sur « 7.1-preview.1 » pour utiliser cette version de l’API.

Réponses

Nom Type Description
200 OK

RetentionLease[]

opération réussie

Sécurité

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

Nom Description
vso.build Accorde la possibilité d’accéder aux artefacts de build, y compris les résultats de build, les définitions et les demandes, et la possibilité de recevoir des notifications sur les événements de build via des hooks de service.

Définitions

RetentionLease

Un bail de rétention valide empêche les systèmes automatisés de supprimer une exécution de pipeline.

Nom Type Description
createdOn

string

Lorsque le bail a été créé.

definitionId

integer

Définition du pipeline de l’exécution.

leaseId

integer

Identificateur unique de ce bail.

ownerId

string

Chaîne non unique qui identifie le propriétaire d’un bail de rétention.

protectPipeline

boolean

S’il est défini, ce bail empêche également la suppression du pipeline tant que le bail est toujours valide.

runId

integer

Exécution du pipeline protégée par ce bail.

validUntil

string

Dernier jour où le bail est considéré comme valide.