Approvals - Update

Referencia

Service:: Approvals And Checks

API Version:: 7.1-preview.1

Actualizar aprobaciones.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
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.

Cuerpo de la solicitud

Nombre	Tipo	Description
body	ApprovalUpdateParameters[]

Respuestas

Nombre	Tipo	Description
200 OK	Approval[]	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_execute	Concede la capacidad de acceder a artefactos de compilación, incluidos los resultados de compilación, las definiciones y las solicitudes, y la capacidad de poner en cola una compilación, actualizar las propiedades de compilación y la capacidad de recibir notificaciones sobre eventos de compilación a través de enlaces de servicio.
vso.pipelineresources_use	Concede la capacidad de aprobar la solicitud de una canalización para usar un recurso protegido: grupo de agentes, entorno, cola, repositorio, archivos seguros, conexión de servicio y grupo de variables.

Ejemplos

Sample Request

HTTP

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

[
  {
    "approvalId": "aab27959-a5be-4ee3-97ca-f19b3602cd2f",
    "comment": "Approving",
    "status": "approved"
  }
]

Sample Response

Status code:: 200

request-Context: appId=cid-v1:a892bfef-0287-4640-9f5e-cffc90fbcf94
access-Control-Expose-Headers: Request-Context

Response Body

{
  "count": 1,
  "value": [
    {
      "id": "aab27959-a5be-4ee3-97ca-f19b3602cd2f",
      "steps": [
        {
          "assignedApprover": {
            "displayName": "User Name",
            "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
            "uniqueName": "uniqueName",
            "descriptor": "Descriptor"
          },
          "actualApprover": {
            "displayName": "User Name",
            "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
            "uniqueName": "uniqueName",
            "descriptor": "Descriptor"
          },
          "status": "approved",
          "comment": "Approving",
          "lastModifiedOn": "2020-11-19T09:57:54.252505Z",
          "order": 1,
          "lastModifiedBy": {
            "displayName": "User Name",
            "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
            "uniqueName": "uniqueName",
            "descriptor": "Descriptor"
          },
          "initiatedOn": "2020-11-19T09:51:16.7045043Z",
          "history": []
        }
      ],
      "status": "approved",
      "createdOn": "2020-11-19T09:51:16.703Z",
      "lastModifiedOn": "2020-11-19T09:57:54.252505Z",
      "executionOrder": "anyOrder",
      "minRequiredApprovers": 1,
      "blockedApprovers": [],
      "_links": {
        "self": {
          "href": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/approvals/aab27959-a5be-4ee3-97ca-f19b3602cd2f"
        }
      }
    }
  ]
}

Definiciones

Nombre	Description
Approval
ApprovalExecutionOrder	Orden en el que los aprobadores serán accionables.
ApprovalPermissions	Permisos de usuario actuales para el objeto de aprobación.
ApprovalStatus	Estado general de la aprobación.
ApprovalStep	Datos de un solo paso de aprobación.
ApprovalStepHistory	Datos de un único historial de pasos de aprobación.
ApprovalUpdateParameters	Datos para actualizar un objeto de aprobación o su paso individual.
IdentityRef
ReferenceLinks	Clase que se va a representar una colección de vínculos de referencia de REST.

Approval

Nombre	Tipo	Description
_links	ReferenceLinks	Obtiene los vínculos para acceder al objeto de aprobación.
blockedApprovers	IdentityRef[]	Identidades que no pueden aprobarse.
createdOn	string	Fecha en la que se creó la aprobación.
executionOrder	ApprovalExecutionOrder	Orden en el que los aprobadores serán accionables.
id	string	Identificador único de la aprobación.
instructions	string	Instrucciones para los aprobadores.
lastModifiedOn	string	Fecha en la que se modificó por última vez la aprobación.
minRequiredApprovers	integer	Número mínimo de aprobadores que deben aprobarse para que toda la aprobación se considere aprobada.
permissions	ApprovalPermissions	Permisos de usuario actuales para el objeto de aprobación.
status	ApprovalStatus	Estado general de la aprobación.
steps	ApprovalStep[]	Lista de pasos asociados a la aprobación.

ApprovalExecutionOrder

Orden en el que los aprobadores serán accionables.

Nombre	Tipo	Description
anyOrder	string	Indica que los aprobadores pueden aprobar en cualquier orden.
inSequence	string	Indica que los aprobadores solo pueden aprobar en un orden secuencial (orden en el que se asignaron).

ApprovalPermissions

Permisos de usuario actuales para el objeto de aprobación.

Nombre	Tipo	Description
none	string
queueBuild	string
reassign	string
resourceAdmin	string
update	string
view	string

ApprovalStatus

Estado general de la aprobación.

Nombre	Tipo	Description
all	string
approved	string	Indica que la aprobación es Aprobada.
canceled	string	Indica que la aprobación está cancelada.
completed	string
failed	string
pending	string	Indica que la aprobación está pendiente.
rejected	string	Indica que se rechaza la aprobación.
skipped	string	Indica que se omite la aprobación.
timedOut	string	Indica que se agota el tiempo de espera de aprobación.
undefined	string
uninitiated	string	Indica que la aprobación no está inicializada. Se usa en el caso de en el orden de ejecución en el que el aprobador determinado aún no es accionable.

ApprovalStep

Datos de un solo paso de aprobación.

Nombre	Tipo	Description
actualApprover	IdentityRef	Identidad que ha aprobado.
assignedApprover	IdentityRef	Identidad que debe aprobar.
comment	string	Comentario asociado a este paso.
history	ApprovalStepHistory[]	Historial del paso de aprobación
initiatedOn	string	Marca de tiempo en la que se inició este paso.
lastModifiedBy	IdentityRef	Identidad por la que este paso se modificó por última vez.
lastModifiedOn	string	Marca de tiempo en la que se modificó por última vez este paso.
order	integer	Orden en el que los aprobadores pueden aprobar.
permissions	ApprovalPermissions	Permisos de usuario actuales para el paso.
status	ApprovalStatus	Estado actual de este paso.

ApprovalStepHistory

Datos de un único historial de pasos de aprobación.

Nombre	Tipo	Description
assignedTo	IdentityRef	Identidad a la que se asignó esta aprobación
comment	string	Comentario asociado a este historial de pasos.
createdBy	IdentityRef	Identidad por la que se creó este historial de pasos.
createdOn	string	Marca de tiempo en la que se creó este historial de pasos.

ApprovalUpdateParameters

Datos para actualizar un objeto de aprobación o su paso individual.

Nombre	Tipo	Description
approvalId	string	Identificador de la aprobación que se va a actualizar.
assignedApprover	IdentityRef	Aprobador actual.
comment	string	Obtiene o establece el comentario.
reassignTo	IdentityRef	Aprobador reasignado.
status	ApprovalStatus	Obtiene o establece el estado.

IdentityRef

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.

ReferenceLinks

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.

Compartir a través de