Evaluations - Requeue Policy Evaluation

Servicio:

Policy

Versión de la API:

7.1-preview.1

Vuelva a poner en cola la evaluación de la directiva.

Algunas directivas definen una acción de "requeue" que realiza alguna operación específica de la directiva. Puede desencadenar esta operación actualizando una evaluación de directiva existente y estableciendo el campo PolicyEvaluationRecord.Status en Queued. Aunque se puede volver a poner en cola cualquier evaluación de directiva, actualmente solo las directivas de compilación realizan cualquier acción en respuesta. Al volver a poner en cola una directiva de compilación, se pondrá en cola una nueva compilación para ejecutarse (cancelando cualquier compilación existente que se esté ejecutando).

PATCH https://dev.azure.com/{organization}/{project}/_apis/policy/evaluations/{evaluationId}?api-version=7.1-preview.1

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
evaluationId	path	True	string uuid	Identificador de la evaluación de directivas que se va a recuperar.
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.1" para usar esta versión de la API.

Respuestas

Nombre	Tipo	Description
200 OK	PolicyEvaluationRecord	operación correcta

Seguridad

oauth2

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Dirección URL del 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

Ámbitos

Nombre	Description
vso.code_write	Concede la capacidad de leer, actualizar y eliminar código fuente, acceder a metadatos sobre confirmaciones, conjuntos de cambios, ramas y otros artefactos de control de versiones. También concede la capacidad de crear y administrar solicitudes de incorporación de cambios y revisiones de código y recibir notificaciones sobre eventos de control de versiones a través de enlaces de servicio.

Definiciones

Nombre	Description
IdentityRef
JObject	Representa un objeto JSON.
PolicyConfiguration	Configuración de directiva completa con valores.
PolicyEvaluationRecord	Este registro encapsula el estado actual de una directiva, ya que se aplica a una solicitud de incorporación de cambios específica. Cada solicitud de incorporación de cambios tiene una directivaEvaluationRecord única para cada solicitud de incorporación de cambios a la que se aplica la directiva.
PolicyEvaluationStatus	Estado de la directiva (En ejecución, Aprobado, Erróneo, etc.)
PolicyTypeRef	Referencia de tipo de directiva.
ReferenceLinks	Clase que se va a representar una colección de vínculos de referencia de REST.

IdentityRef

Object

Nombre	Tipo	Description
_links	ReferenceLinks	Este campo contiene cero o más vínculos interesantes sobre el tema del grafo. Estos vínculos se pueden invocar para obtener relaciones adicionales o información más detallada sobre este tema del grafo.
descriptor	string	El descriptor es la forma principal de hacer referencia al asunto del grafo mientras se ejecuta el sistema. Este campo identificará de forma única el mismo asunto del grafo en cuentas y organizaciones.
directoryAlias	string	En desuso: se puede recuperar consultando al usuario de Graph al que se hace referencia en la entrada "self" del diccionario identityRef "_links".
displayName	string	Este es el nombre para mostrar no único del asunto del grafo. Para cambiar este campo, debe modificar su valor en el proveedor de origen.
id	string
imageUrl	string	En desuso: disponible en la entrada "avatar" del diccionario "_links" de IdentityRef
inactive	boolean	En desuso: se puede recuperar consultando el estado de pertenencia de Graph al que se hace referencia en la entrada "membershipState" del diccionario GraphUser "_links".
isAadIdentity	boolean	En desuso: se puede deducir del tipo de asunto del descriptor (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	En desuso: se puede deducir del tipo de sujeto del descriptor (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	En desuso: no en uso en la mayoría de las implementaciones preexistentes de ToIdentityRef
uniqueName	string	En desuso: use Domain+PrincipalName en su lugar.
url	string	Esta dirección URL es la ruta completa al recurso de origen de este tema del grafo.

JObject

Object

Representa un objeto JSON.

Nombre	Tipo	Description
item	string
type	string	Obtiene el tipo de nodo para este JToken.

PolicyConfiguration

Object

Configuración de directiva completa con valores.

Nombre	Tipo	Description
_links	ReferenceLinks	Vínculos a otros objetos relacionados con este objeto.
createdBy	IdentityRef	Referencia a la identidad que creó la directiva.
createdDate	string	Fecha y hora en que se creó la directiva.
id	integer	Identificador de configuración de directiva.
isBlocking	boolean	Indica si la directiva está bloqueando.
isDeleted	boolean	Indica si la directiva se ha eliminado (temporalmente).
isEnabled	boolean	Indica si la directiva está habilitada.
isEnterpriseManaged	boolean	Si se establece, esta directiva requiere el permiso "Administrar directivas empresariales" para crear, editar o eliminar.
revision	integer	Identificador de revisión de configuración de directiva.
settings	JObject	Opciones de configuración de directiva.
type	PolicyTypeRef	Tipo de configuración de directiva.
url	string	Dirección URL donde se puede recuperar la configuración de la directiva.

PolicyEvaluationRecord

Object

Este registro encapsula el estado actual de una directiva, ya que se aplica a una solicitud de incorporación de cambios específica. Cada solicitud de incorporación de cambios tiene una directivaEvaluationRecord única para cada solicitud de incorporación de cambios a la que se aplica la directiva.

Nombre	Tipo	Description
_links	ReferenceLinks	Vínculos a otros objetos relacionados
artifactId	string	Cadena que identifica de forma única el destino de una evaluación de directiva.
completedDate	string	Hora en la que esta directiva terminó de evaluarse en esta solicitud de incorporación de cambios.
configuration	PolicyConfiguration	Contiene todos los datos de configuración de la directiva que se está evaluando.
context	JObject	Datos de contexto internos de esta evaluación de directiva.
evaluationId	string	Guid que identifica de forma única este registro de evaluación (una directiva que se ejecuta en una solicitud de incorporación de cambios).
startedDate	string	Hora en que esta directiva se evaluó por primera vez en esta solicitud de incorporación de cambios.
status	PolicyEvaluationStatus	Estado de la directiva (En ejecución, Aprobado, Erróneo, etc.)

PolicyEvaluationStatus

Enumeration

Estado de la directiva (En ejecución, Aprobado, Erróneo, etc.)

Valor	Description
approved	La directiva se ha cumplido para esta solicitud de incorporación de cambios.
broken	La directiva ha encontrado un error inesperado.
notApplicable	La directiva no se aplica a esta solicitud de incorporación de cambios.
queued	La directiva se pone en cola para ejecutarse o está esperando algún evento antes de avanzar.
rejected	La directiva ha rechazado esta solicitud de incorporación de cambios.
running	La directiva se está ejecutando actualmente.

PolicyTypeRef

Object

Referencia de tipo de directiva.

Nombre	Tipo	Description
displayName	string	Nombre para mostrar del tipo de directiva.
id	string	Identificador de tipo de directiva.
url	string	Dirección URL donde se puede recuperar el tipo de directiva.

ReferenceLinks

Object

Clase que se va a representar una colección de vínculos de referencia de REST.

Nombre	Tipo	Description
links	object	Vista de lectura de los vínculos. Dado que los vínculos de referencia son de solo lectura, solo queremos exponerlos como de solo lectura.