Policy Sets - Evaluate Policies

Servizio:

Dev Test Labs

Versione API:

2018-09-15

Valuta i criteri del lab.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DevTestLab/labs/{labName}/policysets/{name}/evaluatePolicies?api-version=2018-09-15

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
labName	path	True	string	Nome del lab.
name	path	True	string	Nome del set di criteri
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Tipo	Descrizione
policies	EvaluatePoliciesProperties[]	Criteri da valutare.

Risposte

Nome	Tipo	Descrizione
200 OK	EvaluatePoliciesResponse	Operazione di Azure completata correttamente.
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

PolicySets_EvaluatePolicies

Esempio di richiesta

HTTP

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/resourceGroupName/providers/Microsoft.DevTestLab/labs/{labName}/policysets/{policySetName}/evaluatePolicies?api-version=2018-09-15

{
  "policies": [
    {
      "factName": "LabVmCount",
      "valueOffset": "1"
    }
  ]
}

Risposta di esempio

Codice di stato:

200

{
  "results": [
    {
      "hasError": true,
      "policyViolations": [
        {
          "code": "MaxValuePolicy",
          "message": "You cannot exceed the limit (1) of virtual machines that can be created in this lab."
        }
      ]
    }
  ]
}

Definizioni

Nome	Descrizione
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
EvaluatePoliciesProperties	Proprietà per la valutazione di un set di criteri.
EvaluatePoliciesRequest	Corpo della richiesta per la valutazione di un set di criteri.
EvaluatePoliciesResponse	Corpo della risposta per la valutazione di un set di criteri.
PolicySetResult	Risultato di una valutazione del set di criteri.
PolicyViolation	Violazione dei criteri.

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

EvaluatePoliciesProperties

Object

Proprietà per la valutazione di un set di criteri.

Nome	Tipo	Descrizione
factData	string	Dati dei fatti.
factName	string	Nome del fatto.
userObjectId	string	Utente per il quale verranno valutati i criteri
valueOffset	string	Offset del valore.

EvaluatePoliciesRequest

Object

Corpo della richiesta per la valutazione di un set di criteri.

Nome	Tipo	Descrizione
policies	EvaluatePoliciesProperties[]	Criteri da valutare.

EvaluatePoliciesResponse

Object

Corpo della risposta per la valutazione di un set di criteri.

Nome	Tipo	Descrizione
results	PolicySetResult[]	Risultati della valutazione di un set di criteri.

PolicySetResult

Object

Risultato di una valutazione del set di criteri.

Nome	Tipo	Descrizione
hasError	boolean	Valore che indica se la valutazione del set di criteri ha rilevato violazioni.
policyViolations	PolicyViolation[]	Elenco di violazioni dei criteri.

PolicyViolation

Object

Violazione dei criteri.

Nome	Tipo	Descrizione
code	string	Codice della violazione dei criteri.
message	string	Messaggio della violazione dei criteri.