Leases - Update

Referência

Serviço:: Build

Versão da API:: 7.1

Atualiza o status de proteção de pipeline ou duração de uma concessão de retenção.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
leaseId	path	True	integer (int32)	A ID da concessão a ser atualizada.
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' para usar essa versão da api.

Corpo da solicitação

Nome	Tipo	Description
daysValid	integer (int32)	O número de dias para considerar a concessão válida. Uma concessão de retenção válida por mais de 100 anos (36500 dias) será exibida como mantendo a compilação "para sempre".
protectPipeline	boolean	Se definido, essa concessão também impedirá que o pipeline seja excluído enquanto a concessão ainda for válida.

Respostas

Nome	Tipo	Description
200 OK	RetentionLease	operação bem-sucedida

Segurança

oauth2

Tipo: oauth2
Flow: accessCode
URL de Autorização: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL do 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

Escopos

Nome	Description
vso.build_execute	Concede a capacidade de acessar artefatos de build, incluindo resultados de build, definições e solicitações, e a capacidade de enfileirar um build, atualizar propriedades de build e a capacidade de receber notificações sobre eventos de build por meio de ganchos de serviço.

Definições

Nome	Description
RetentionLease	Uma concessão de retenção válida impede que sistemas automatizados excluam uma execução de pipeline.
RetentionLeaseUpdate	Uma atualização dos parâmetros de retenção de uma concessão de retenção.

RetentionLease

Objeto

Uma concessão de retenção válida impede que sistemas automatizados excluam uma execução de pipeline.

Nome	Tipo	Description
createdOn	string (date-time)	Quando a concessão foi criada.
definitionId	integer (int32)	A definição de pipeline da execução.
leaseId	integer (int32)	O identificador exclusivo para essa 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 definido, essa concessão também impedirá que o pipeline seja excluído enquanto a concessão ainda for válida.
runId	integer (int32)	O pipeline é executado protegido por essa concessão.
validUntil	string (date-time)	No último dia, a concessão é considerada válida.

RetentionLeaseUpdate