View a markdown version of this page

CheckNoNewAccess - IAM Access Analyzer

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à.

CheckNoNewAccess

Verifica se è consentito un nuovo accesso per una politica aggiornata rispetto alla politica esistente.

Puoi trovare esempi di policy di riferimento e imparare come impostare ed eseguire un controllo personalizzato delle policy per i nuovi accessi nell'archivio degli esempi di controlli di policy personalizzati di IAM Access Analyzer su cui si trovano. GitHub Le politiche di riferimento in questo repository sono pensate per essere passate al existingPolicyDocument parametro request.

Sintassi della richiesta

POST /policy/check-no-new-access HTTP/1.1 Content-type: application/json { "existingPolicyDocument": "string", "newPolicyDocument": "string", "policyType": "string" }

Parametri della richiesta URI:

La richiesta non utilizza parametri URI.

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

existingPolicyDocument

Il documento di policy JSON da utilizzare come contenuto per la policy esistente.

Tipo: stringa

Obbligatorio: sì

newPolicyDocument

Il documento di policy JSON da utilizzare come contenuto per la policy aggiornata.

Tipo: stringa

Obbligatorio: sì

policyType

Il tipo di policy da confrontare. Le politiche di identità concedono le autorizzazioni ai responsabili IAM. Le politiche di identità includono politiche gestite e in linea per ruoli, utenti e gruppi IAM.

Le politiche sulle risorse concedono le autorizzazioni sulle AWS risorse. Le politiche sulle risorse includono politiche di fiducia per i ruoli IAM e politiche sui bucket per i bucket Amazon S3. Puoi fornire un input generico come la politica di identità o la politica delle risorse o un input specifico come la policy gestita o la policy dei bucket di Amazon S3.

Tipo: stringa

Valori validi: IDENTITY_POLICY | RESOURCE_POLICY

Obbligatorio: sì

Sintassi della risposta

HTTP/1.1 200 Content-type: application/json { "message": "string", "reasons": [ { "description": "string", "statementId": "string", "statementIndex": number } ], "result": "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.

message

Il messaggio che indica se la policy aggiornata consente un nuovo accesso.

Tipo: stringa

reasons

Una descrizione del ragionamento alla base del risultato.

Tipo: matrice di oggetti ReasonSummary

result

Il risultato della verifica del nuovo accesso. Se il risultato èPASS, la politica aggiornata non consente alcun nuovo accesso. Se il risultato èFAIL, la politica aggiornata potrebbe consentire un nuovo accesso.

Tipo: stringa

Valori validi: PASS | FAIL

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Tipi di errore comuni.

AccessDeniedException

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

Codice di stato HTTP: 403

InternalServerException

Errore interno del server.

retryAfterSeconds

I secondi di attesa per riprovare.

Codice di stato HTTP: 500

InvalidParameterException

Il parametro specificato non è valido.

Codice di stato HTTP: 400

ThrottlingException

Errore relativo al superamento del limite di limitazione.

retryAfterSeconds

I secondi di attesa per riprovare.

Codice di stato HTTP: 429

UnprocessableEntityException

L'entità specificata non può essere elaborata.

Codice di stato HTTP: 422

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 uno degli AWS SDK specifici della lingua, consulta quanto segue: