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à.
Recupera un elenco di risultati generati dall'analizzatore specificato. ListFindings e ListFindings V2 vengono entrambi utilizzati access-analyzer:ListFindings
nell'Action
elemento di una dichiarazione di policy IAM. È necessario disporre dell'autorizzazione per eseguire l'access-analyzer:ListFindings
azione.
Per informazioni sulle chiavi di filtro che puoi utilizzare per recuperare un elenco di risultati, consulta le chiavi di filtro di IAM Access Analyzer nella IAM User Guide.
Sintassi della richiesta
POST /finding HTTP/1.1
Content-type: application/json
{
"analyzerArn": "string
",
"filter": {
"string
" : {
"contains": [ "string
" ],
"eq": [ "string
" ],
"exists": boolean
,
"neq": [ "string
" ]
}
},
"maxResults": number
,
"nextToken": "string
",
"sort": {
"attributeName": "string
",
"orderBy": "string
"
}
}
Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- analyzerArn
-
L'ARN dell'analizzatore da cui recuperare i risultati.
Tipo: stringa
Modello:
[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}
Campo obbligatorio: sì
- filter
-
Un filtro da abbinare per i risultati da restituire.
Tipo: mappa da stringa a Criterion oggetto
Campo obbligatorio: no
- maxResults
-
Il numero massimo di risultati da restituire nella risposta.
Tipo: integer
Campo obbligatorio: no
- nextToken
-
Un token utilizzato per l'impaginazione dei risultati restituiti.
Tipo: string
Campo obbligatorio: no
- sort
-
Il criterio di ordinamento dei risultati restituiti.
Tipo: oggetto SortCriteria
Campo obbligatorio: no
Sintassi della risposta
HTTP/1.1 200
Content-type: application/json
{
"findings": [
{
"action": [ "string" ],
"analyzedAt": "string",
"condition": {
"string" : "string"
},
"createdAt": "string",
"error": "string",
"id": "string",
"isPublic": boolean,
"principal": {
"string" : "string"
},
"resource": "string",
"resourceControlPolicyRestriction": "string",
"resourceOwnerAccount": "string",
"resourceType": "string",
"sources": [
{
"detail": {
"accessPointAccount": "string",
"accessPointArn": "string"
},
"type": "string"
}
],
"status": "string",
"updatedAt": "string"
}
],
"nextToken": "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.
- findings
-
Un elenco di risultati recuperati dall'analizzatore che corrispondono ai criteri di filtro specificati, se presenti.
Tipo: matrice di oggetti FindingSummary
- nextToken
-
Un token utilizzato per l'impaginazione dei risultati restituiti.
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
- InternalServerException
-
Errore interno del server.
Codice di stato HTTP: 500
- ResourceNotFoundException
-
La risorsa specificata non è stata trovata.
Codice di stato HTTP: 404
- ThrottlingException
-
Errore di limitazione superato.
Codice di stato HTTP: 429
- ValidationException
-
Errore di eccezione di convalida.
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: