Approvals - Update

Riferimento

Service:: Approvals And Checks

API Version:: 7.1-preview.1

Aggiornare le approvazioni.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
organization	path	True	string	Nome dell'organizzazione di Azure DevOps.
project	path	True	string	ID progetto o nome progetto
api-version	query	True	string	Versione dell'API da usare. Questa opzione deve essere impostata su '7.1-preview.1' per usare questa versione dell'API.

Corpo della richiesta

Nome	Tipo	Descrizione
body	ApprovalUpdateParameters[]

Risposte

Nome	Tipo	Descrizione
200 OK	Approval[]	operazione riuscita

Sicurezza

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	Descrizione
vso.build_execute	Concede la possibilità di accedere agli artefatti di compilazione, inclusi i risultati della compilazione, le definizioni e le richieste e la possibilità di accodare una compilazione, aggiornare le proprietà di compilazione e la possibilità di ricevere notifiche sugli eventi di compilazione tramite hook del servizio.
vso.pipelineresources_use	Concede la possibilità di approvare la richiesta di una pipeline di usare una risorsa protetta: pool di agenti, ambiente, coda, repository, file protetti, connessione al servizio e gruppo di variabili

Esempio

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"
        }
      }
    }
  ]
}

Definizioni

Nome	Descrizione
Approval
ApprovalExecutionOrder	Ordine in cui i responsabili dell'approvazione saranno utilizzabili.
ApprovalPermissions	Autorizzazioni utente correnti per l'oggetto approvazione.
ApprovalStatus	Stato generale dell'approvazione.
ApprovalStep	Dati per un singolo passaggio di approvazione.
ApprovalStepHistory	Dati per una singola cronologia dei passaggi di approvazione.
ApprovalUpdateParameters	Dati per aggiornare un oggetto di approvazione o il relativo singolo passaggio.
IdentityRef
ReferenceLinks	Classe da rappresentare una raccolta di collegamenti di riferimento REST.

Approval

Nome	Tipo	Descrizione
_links	ReferenceLinks	Ottiene i collegamenti per accedere all'oggetto approvazione.
blockedApprovers	IdentityRef[]	Identità che non possono approvare.
createdOn	string	Data in cui è stata creata l'approvazione.
executionOrder	ApprovalExecutionOrder	Ordine in cui i responsabili dell'approvazione saranno utilizzabili.
id	string	Identificatore univoco dell'approvazione.
instructions	string	Istruzioni per i responsabili dell'approvazione.
lastModifiedOn	string	Data dell'ultima modifica dell'approvazione.
minRequiredApprovers	integer	Numero minimo di approvatori che devono approvare per l'intera approvazione da considerare approvati.
permissions	ApprovalPermissions	Autorizzazioni utente correnti per l'oggetto approvazione.
status	ApprovalStatus	Stato generale dell'approvazione.
steps	ApprovalStep[]	Elenco dei passaggi associati all'approvazione.

ApprovalExecutionOrder

Ordine in cui i responsabili dell'approvazione saranno utilizzabili.

Nome	Tipo	Descrizione
anyOrder	string	Indica che i responsabili dell'approvazione possono approvare in qualsiasi ordine.
inSequence	string	Indica che i responsabili dell'approvazione possono approvare solo in un ordine sequenziale(Ordine in cui sono stati assegnati).

ApprovalPermissions

Autorizzazioni utente correnti per l'oggetto approvazione.

Nome	Tipo	Descrizione
none	string
queueBuild	string
reassign	string
resourceAdmin	string
update	string
view	string

ApprovalStatus

Stato generale dell'approvazione.

Nome	Tipo	Descrizione
all	string
approved	string	Indica che l'approvazione è Approvata.
canceled	string	Indica che l'approvazione è Annullata.
completed	string
failed	string
pending	string	Indica che l'approvazione è in sospeso.
rejected	string	Indica che l'approvazione viene rifiutata.
skipped	string	Indica che l'approvazione viene ignorata.
timedOut	string	Indica che l'approvazione è timeout.
undefined	string
uninitiated	string	Indica che l'approvazione non è inizializzata. Usato in caso di ordine di esecuzione in sequenza in cui l'approvatore specificato non è ancora utilizzabile.

ApprovalStep

Dati per un singolo passaggio di approvazione.

Nome	Tipo	Descrizione
actualApprover	IdentityRef	Identità approvata.
assignedApprover	IdentityRef	Identità che deve approvare.
comment	string	Commento associato a questo passaggio.
history	ApprovalStepHistory[]	Cronologia del passaggio di approvazione
initiatedOn	string	Timestamp in cui è stato avviato questo passaggio.
lastModifiedBy	IdentityRef	Identità in base alla quale è stato modificato l'ultimo passaggio.
lastModifiedOn	string	Timestamp a cui è stato modificato l'ultimo passaggio.
order	integer	Ordine in cui i responsabili dell'approvazione possono approvare.
permissions	ApprovalPermissions	Autorizzazioni utente correnti per il passaggio.
status	ApprovalStatus	Stato corrente di questo passaggio.

ApprovalStepHistory

Dati per una singola cronologia dei passaggi di approvazione.

Nome	Tipo	Descrizione
assignedTo	IdentityRef	Identità assegnata a questa approvazione
comment	string	Commento associato alla cronologia dei passaggi.
createdBy	IdentityRef	Identità in base alla quale è stata creata la cronologia dei passaggi.
createdOn	string	Timestamp in cui è stata creata la cronologia dei passaggi.

ApprovalUpdateParameters

Dati per aggiornare un oggetto di approvazione o il relativo singolo passaggio.

Nome	Tipo	Descrizione
approvalId	string	ID dell'approvazione da aggiornare.
assignedApprover	IdentityRef	Approvazione corrente.
comment	string	Ottiene o imposta il commento.
reassignTo	IdentityRef	Reassigned Approver.
status	ApprovalStatus	Ottiene o imposta lo stato.

IdentityRef

Nome	Tipo	Descrizione
_links	ReferenceLinks	Questo campo contiene zero o più collegamenti interessanti sull'oggetto grafico. Questi collegamenti possono essere richiamati per ottenere relazioni aggiuntive o informazioni più dettagliate su questo argomento grafico.
descriptor	string	Il descrittore è il modo principale per fare riferimento all'oggetto del grafico durante l'esecuzione del sistema. Questo campo identificherà in modo univoco lo stesso soggetto grafo in account e organizzazioni.
directoryAlias	string	Deprecato: può essere recuperato eseguendo query sull'utente Graph a cui si fa riferimento nella voce "self" del dizionario IdentityRef "_links"
displayName	string	Si tratta del nome visualizzato non univoco dell'oggetto grafico. Per modificare questo campo, è necessario modificarlo nel provider di origine.
id	string
imageUrl	string	Deprecato - Disponibile nella voce "avatar" del dizionario IdentityRef "_links"
inactive	boolean	Deprecato: può essere recuperato eseguendo una query sullo stato di appartenenza Graph a cui fa riferimento nella voce "membershipState" del dizionario GraphUser "_links"
isAadIdentity	boolean	Deprecato: può essere dedotto dal tipo di soggetto del descrittore (Descrittore.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Deprecato: può essere dedotto dal tipo di soggetto del descrittore (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Deprecato : non in uso nella maggior parte delle implementazioni preesistenti di ToIdentityRef
uniqueName	string	Deprecato: usare invece Domain+PrincipalName
url	string	Questo URL è la route completa alla risorsa di origine di questo oggetto grafico.

ReferenceLinks

Classe da rappresentare una raccolta di collegamenti di riferimento REST.

Nome	Tipo	Descrizione
links	object	Visualizzazione di lettura dei collegamenti. Poiché i collegamenti di riferimento sono in sola lettura, si vuole esporre solo i collegamenti di riferimento come sola lettura.

Condividi tramite