Leases - Get Retention Leases By Minimal Retention Leases
Retorna quaisquer concessões que correspondam ao MinimalRetentionLeases especificado
GET https://dev.azure.com/{organization}/{project}/_apis/build/retention/leases?leasesToFetch={leasesToFetch}&api-version=7.1-preview.2Parâmetros de URI
| Nome | Em | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
organization
|
path | True |
string |
O nome da organização do Azure DevOps. |
|
project
|
path | True |
string |
ID do projeto ou nome do projeto |
|
api-version
|
query | True |
string |
Versão da API a ser usada. Isso deve ser definido como '7.1-preview.2' para usar essa versão da API. |
|
leases
|
query | True |
string array (MinimalRetentionLease) |
Lista de MinimalRetentionLeases serializados em JSON separados por '|' |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
operação bem-sucedida |
Segurança
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
| Nome | Description |
|---|---|
| vso.build | Concede a capacidade de acessar artefatos de build, incluindo resultados de build, definições e solicitações e a capacidade de receber notificações sobre eventos de build por meio de ganchos de serviço. |
Definições
RetentionLease
Uma concessão de retenção válida impede que sistemas automatizados excluam uma execução de pipeline.
| Nome | Tipo | Description |
|---|---|---|
| createdOn |
string |
Quando a concessão foi criada. |
| definitionId |
integer |
A definição de pipeline da execução. |
| leaseId |
integer |
O identificador exclusivo dessa concessão. |
| ownerId |
string |
Cadeia de caracteres não exclusiva que identifica o proprietário de uma concessão de retenção. |
| protectPipeline |
boolean |
Se definida, essa concessão também impedirá que o pipeline seja excluído enquanto a concessão ainda for válida. |
| runId |
integer |
O pipeline é executado protegido por essa concessão. |
| validUntil |
string |
O último dia em que a concessão é considerada válida. |