Sdílet prostřednictvím

Evaluations - Requeue Policy Evaluation

  • Reference
Služba:
Policy
Verze rozhraní API:
7.1-preview.1

Znovu zaváděte vyhodnocení zásad.

Některé zásady definují akci opětovného zařazení do fronty, která provádí určité operace specifické pro zásady. Tuto operaci můžete aktivovat aktualizací existujícího vyhodnocení zásad a nastavením pole PolicyEvaluationRecord.Status na Hodnotu Ve frontě. I když je možné provést jakékoli vyhodnocení zásad znovu na frontu, v současné době se v reakci na to provedou pouze zásady sestavení. Opětovným zařazením zásady sestavení do fronty zapíšete nové sestavení, které se má spustit (zruší se jakékoli existující sestavení, které je spuštěné).

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
evaluationId
 path True

string

uuid

ID vyhodnocení zásad, které se má načíst.
organization
 path True

string

Název organizace Azure DevOps.
project
 path True

string

ID projektu nebo název projektu
api-version
 query True

string

Verze rozhraní API, která se má použít. Aby se tato verze rozhraní API používala, měla by být nastavená na 7.1-preview.1.

Odpovědi

Name Typ Description
200 OK

PolicyEvaluationRecord

úspěšná operace

Zabezpečení

oauth2

Typ: oauth2
Tok: accessCode
URL autorizace: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL tokenu: 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

Rozsahy

Name Description
vso.code_write Uděluje možnost číst, aktualizovat a odstraňovat zdrojový kód, přistupovat k metadatům o potvrzeních, sadách změn, větvích a dalších artefaktech správy verzí. Uděluje také možnost vytvářet a spravovat žádosti o přijetí změn a revize kódu a přijímat oznámení o událostech správy verzí prostřednictvím služby Hooks.

Definice

Name Description
IdentityRef
JObject

Představuje objekt JSON.
PolicyConfiguration

Úplná konfigurace zásad s nastavením.
PolicyEvaluationRecord

Tento záznam zapouzdřuje aktuální stav zásady, protože se vztahuje na jednu konkrétní žádost o přijetí změn. Každá žádost o přijetí změn má jedinečný záznam PolicyEvaluationRecord pro každou žádost o přijetí změn, na kterou se zásady vztahují.
PolicyEvaluationStatus

Stav zásady (Spuštěno, Schváleno, Selhání atd.)
PolicyTypeRef

Odkaz na typ zásad.
ReferenceLinks

Třída představující kolekci odkazů REST.

IdentityRef

Object
Name Typ Description
_links

ReferenceLinks

Toto pole obsahuje nula nebo více zajímavých odkazů o předmětu grafu. Tyto odkazy mohou být vyvolány za účelem získání dalších relací nebo podrobnějších informací o tomto předmětu grafu.
descriptor

string

Popisovač je primárním způsobem, jak odkazovat na předmět grafu, když je systém spuštěný. Toto pole jednoznačně identifikuje stejný předmět grafu napříč účty i organizacemi.
directoryAlias

string

Zastaralé – lze načíst dotazem uživatele Graphu, na který odkazuje položka "self" slovníku IdentityRef "_links".
displayName

string

Toto je jedinečný zobrazovaný název předmětu grafu. Pokud chcete toto pole změnit, musíte změnit jeho hodnotu ve zdrojovém poskytovateli.
id

string

imageUrl

string

Zastaralé – k dispozici v položce avatar ve slovníku IdentityRef "_links".
inactive

boolean

Zastaralé – lze načíst dotazem na stav členství graphu, na který odkazuje položka membershipState slovníku GraphUser "_links".
isAadIdentity

boolean

Zastaralé – lze odvodit z typu předmětu popisovače (Descriptor.IsAadUserType/Descriptor.IsAadGroupType).
isContainer

boolean

Zastaralé – lze odvodit z typu předmětu popisovače (Descriptor.IsGroupType)
isDeletedInOrigin

boolean

profileUrl

string

Zastaralé – nepoužívá se ve většině existujících implementací ToIdentityRef
uniqueName

string

Zastaralé – místo toho použijte Domain+PrincipalName.
url

string

Tato adresa URL je úplná trasa ke zdrojovému prostředku tohoto předmětu grafu.

JObject

Object

Představuje objekt JSON.

Name Typ Description
item

string

type

string

Získá typ uzlu pro tento JToken.

PolicyConfiguration

Object

Úplná konfigurace zásad s nastavením.

Name Typ Description
_links

ReferenceLinks

Odkazy na jiné objekty související s tímto objektem.
createdBy

IdentityRef

Odkaz na identitu, která vytvořila zásadu.
createdDate

string

Datum a čas vytvoření zásady.
id

integer

ID konfigurace zásad.
isBlocking

boolean

Označuje, jestli zásady blokují.
isDeleted

boolean

Označuje, jestli byly zásady odstraněny (obnovitelné).
isEnabled

boolean

Označuje, jestli je zásada povolená.
isEnterpriseManaged

boolean

Pokud je tato zásada nastavená, vyžaduje k vytváření, úpravám nebo odstraňování oprávnění Spravovat zásady organizace.
revision

integer

ID revize konfigurace zásad
settings

JObject

Nastavení konfigurace zásad.
type

PolicyTypeRef

Typ konfigurace zásad.
url

string

Adresa URL, na které je možné načíst konfiguraci zásad.

PolicyEvaluationRecord

Object

Tento záznam zapouzdřuje aktuální stav zásady, protože se vztahuje na jednu konkrétní žádost o přijetí změn. Každá žádost o přijetí změn má jedinečný záznam PolicyEvaluationRecord pro každou žádost o přijetí změn, na kterou se zásady vztahují.

Name Typ Description
_links

ReferenceLinks

Odkazy na další související objekty
artifactId

string

Řetězec, který jednoznačně identifikuje cíl vyhodnocení zásad.
completedDate

string

Čas, kdy se tato zásada dokončila při vyhodnocování této žádosti o přijetí změn.
configuration

PolicyConfiguration

Obsahuje všechna konfigurační data pro zásady, které se vyhodnocují.
context

JObject

Interní kontextová data tohoto vyhodnocení zásad.
evaluationId

string

Identifikátor GUID, který jednoznačně identifikuje tento záznam vyhodnocení (jedna zásada spuštěná na jedné žádosti o přijetí změn).
startedDate

string

Čas, kdy se tato zásada poprvé vyhodnotila u této žádosti o přijetí změn.
status

PolicyEvaluationStatus

Stav zásady (Spuštěno, Schváleno, Selhání atd.)

PolicyEvaluationStatus

Enumeration

Stav zásady (Spuštěno, Schváleno, Selhání atd.)

Hodnota Description
approved

Pro tuto žádost o přijetí změn byly splněny zásady.
broken

Zásada zjistila neočekávanou chybu.
notApplicable

Tato zásada se na tuto žádost o přijetí změn nevztahuje.
queued

Zásada je buď zařazená do fronty, aby se spustila, nebo čeká na nějakou událost, než bude pokračovat.
rejected

Zásady tuto žádost o přijetí změn zamítly.
running

Zásady jsou aktuálně spuštěné.

PolicyTypeRef

Object

Odkaz na typ zásad.

Name Typ Description
displayName

string

Zobrazovaný název typu zásady
id

string

ID typu zásady.
url

string

Adresa URL, kde lze typ zásady načíst.
Object

Třída představující kolekci odkazů REST.

Name Typ Description
links

object

Zobrazení odkazů jen pro čtení. Vzhledem k tomu, že odkazy jsou jen pro čtení, chceme je zveřejnit jenom jako jen pro čtení.