StartPolicyGeneration - IAM Access Analyzer
Sintassi della richiestaParametri della richiesta URI:Corpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

StartPolicyGeneration

Avvia la richiesta di generazione della policy.

Sintassi della richiesta

PUT /policy/generation HTTP/1.1
Content-type: application/json

{
   "clientToken": "string",
   "cloudTrailDetails": { 
      "accessRole": "string",
      "endTime": "string",
      "startTime": "string",
      "trails": [ 
         { 
            "allRegions": boolean,
            "cloudTrailArn": "string",
            "regions": [ "string" ]
         }
      ]
   },
   "policyGenerationDetails": { 
      "principalArn": "string"
   }
}

Parametri della richiesta URI:

La richiesta non utilizza parametri URI.

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

clientToken

Un identificatore univoco (con distinzione tra maiuscole e minuscole) che fornisci per assicurare l'idempotenza della richiesta. L'idempotenza assicura che una richiesta API venga completata solo una volta. Con una richiesta idempotente, se la richiesta originale viene completata correttamente, i tentativi successivi con lo stesso token client restituiscono il risultato della richiesta originale riuscita e non hanno alcun effetto aggiuntivo.

Se non si specifica un token client, ne viene generato automaticamente uno dall'SDK. AWS

▬Tipo: stringa

Campo obbligatorio: no

cloudTrailDetails

Un CloudTrailDetails oggetto che contiene dettagli su un oggetto Trail che si desidera analizzare per generare politiche.

Tipo: oggetto CloudTrailDetails

Campo obbligatorio: no

policyGenerationDetails

Contiene l'ARN dell'entità IAM (utente o ruolo) per la quale si sta generando una policy.

Tipo: oggetto PolicyGenerationDetails

Campo obbligatorio: sì

Sintassi della risposta

HTTP/1.1 200
Content-type: application/json

{
   "jobId": "string"
}

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

jobId

Il JobId che viene restituito dall'StartPolicyGenerationoperazione. JobIdPuò essere utilizzato con GetGeneratedPolicy per recuperare le politiche generate o utilizzato con CancelPolicyGeneration per annullare la richiesta di generazione delle politiche.

▬Tipo: stringa

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

AccessDeniedException

Non disponi dell'autorizzazione di accesso sufficiente per eseguire questa operazione.

Codice di stato HTTP: 403

ConflictException

Un errore di eccezione in caso di conflitto.

resourceId

L'ID della risorsa.

resourceType

Il tipo di risorsa.

Codice di stato HTTP: 409

InternalServerException

Errore interno del server.

retryAfterSeconds

I secondi di attesa per riprovare.

Codice di stato HTTP: 500

ServiceQuotaExceededException

Errore relativo al preventivo di assistenza.

resourceId

L'ID della risorsa.

resourceType

Il tipo di risorsa.

Codice di stato HTTP: 402

ThrottlingException

Errore di limitazione superato.

retryAfterSeconds

I secondi di attesa per riprovare.

Codice di stato HTTP: 429

ValidationException

Errore di eccezione di convalida.

fieldList

Un elenco di campi che non sono stati convalidati.

reason

Il motivo dell'eccezione.

Codice di stato HTTP: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: