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à.
ListFindings
Recupera un elenco di risultati generati dall'analizzatore specificato. ListFindings e ListFindings V2 vengono entrambi utilizzati access-analyzer:ListFindings nell'Actionelemento di una dichiarazione di policy IAM. È necessario disporre dell'autorizzazione per eseguire l'access-analyzer:ListFindingsazione.
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.
Nota
ListFindings è supportato solo per gli analizzatori di accesso esterni. È necessario utilizzare ListFindings V2 per gli analizzatori di accesso interni e non utilizzati.
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}Obbligatorio: sì
- filter
-
Un filtro da abbinare per i risultati da restituire.
Tipo: mappa da stringa a Criterion oggetto
Obbligatorio: no
- maxResults
-
Il numero massimo di risultati da restituire nella risposta.
Tipo: Integer
Obbligatorio: no
- nextToken
-
Un token utilizzato per l'impaginazione dei risultati restituiti.
▬Tipo: stringa
Obbligatorio: no
- sort
-
Il criterio di ordinamento dei risultati restituiti.
Tipo: oggetto SortCriteria
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: String
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
- ResourceNotFoundException
-
La risorsa specificata non è stata trovata.
- resourceId
-
L'ID della risorsa.
- resourceType
-
Il tipo di risorsa.
Codice di stato HTTP: 404
- 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 uno degli AWS SDK specifici della lingua, consulta quanto segue:
