Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# ListFindings
<a name="API_ListFindings"></a>

Ruft eine Liste von Ergebnissen ab, die vom angegebenen Analysator generiert wurden. ListFindings und ListFindings V2 werden beide `access-analyzer:ListFindings` im `Action` Element einer IAM-Richtlinienerklärung verwendet. Sie benötigen die Erlaubnis, die `access-analyzer:ListFindings` Aktion auszuführen.

Informationen zu Filterschlüsseln, mit denen Sie eine Ergebnisliste abrufen können, finden Sie unter [IAM Access Analyzer-Filterschlüssel](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-reference-filter-keys.html) im **IAM-Benutzerhandbuch**.

**Anmerkung**  
ListFindings wird nur für externe Access Analyzer unterstützt. Sie müssen ListFindings V2 für interne und ungenutzte Zugriffsanalysatoren verwenden.

## Anforderungssyntax
<a name="API_ListFindings_RequestSyntax"></a>

```
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"
   }
}
```

## URI-Anfrageparameter
<a name="API_ListFindings_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

## Anforderungstext
<a name="API_ListFindings_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [analyzerArn](#API_ListFindings_RequestSyntax) **   <a name="accessanalyzer-ListFindings-request-analyzerArn"></a>
Der [ARN des Analysators](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-getting-started.html#permission-resources), von dem Ergebnisse abgerufen werden sollen.  
Typ: Zeichenfolge  
Pattern: `[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}`   
Erforderlich: Ja

 ** [filter](#API_ListFindings_RequestSyntax) **   <a name="accessanalyzer-ListFindings-request-filter"></a>
Ein Filter, der für die Rückgabe der Ergebnisse abgeglichen werden muss.  
Typ: Zeichenkette zur [Criterion](API_Criterion.md) Objektzuordnung  
Erforderlich: Nein

 ** [maxResults](#API_ListFindings_RequestSyntax) **   <a name="accessanalyzer-ListFindings-request-maxResults"></a>
Die maximale Anzahl von Ergebnissen, die in der Antwort zurückgegeben werden sollen.  
Typ: Ganzzahl  
Erforderlich: Nein

 ** [nextToken](#API_ListFindings_RequestSyntax) **   <a name="accessanalyzer-ListFindings-request-nextToken"></a>
Ein Token, das für die Paginierung der zurückgegebenen Ergebnisse verwendet wird.  
Typ: Zeichenfolge  
Erforderlich: Nein

 ** [sort](#API_ListFindings_RequestSyntax) **   <a name="accessanalyzer-ListFindings-request-sort"></a>
Die Sortierreihenfolge für die zurückgegebenen Ergebnisse.  
Typ: [SortCriteria](API_SortCriteria.md) Objekt  
Erforderlich: Nein

## Antwortsyntax
<a name="API_ListFindings_ResponseSyntax"></a>

```
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"
}
```

## Antwortelemente
<a name="API_ListFindings_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [findings](#API_ListFindings_ResponseSyntax) **   <a name="accessanalyzer-ListFindings-response-findings"></a>
Eine Liste der vom Analyzer abgerufenen Ergebnisse, die den angegebenen Filterkriterien entsprechen, falls vorhanden.  
Typ: Array von [FindingSummary](API_FindingSummary.md)-Objekten

 ** [nextToken](#API_ListFindings_ResponseSyntax) **   <a name="accessanalyzer-ListFindings-response-nextToken"></a>
Ein Token, das für die Paginierung der zurückgegebenen Ergebnisse verwendet wird.  
Typ: Zeichenfolge

## Fehler
<a name="API_ListFindings_Errors"></a>

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md).

 ** AccessDeniedException **   
Sie haben keinen ausreichenden Zugriff zum Durchführen dieser Aktion.  
HTTP-Statuscode: 403

 ** InternalServerException **   
Interner Serverfehler.    
 ** retryAfterSeconds **   
Die Sekunden, die auf einen erneuten Versuch gewartet werden müssen.
HTTP Status Code: 500

 ** ResourceNotFoundException **   
Die angegebene Ressource konnte nicht gefunden werden.    
 ** resourceId **   
Die ID der Ressource.  
 ** resourceType **   
Der Ressourcentyp.
HTTP-Statuscode: 404

 ** ThrottlingException **   
Fehler beim Überschreiten des Drosselungslimits.    
 ** retryAfterSeconds **   
Die Sekunden, die auf einen erneuten Versuch gewartet werden müssen.
HTTP-Statuscode: 429

 ** ValidationException **   
Ausnahmefehler bei der Überprüfung.    
 ** fieldList **   
Eine Liste von Feldern, die nicht validiert wurden.  
 ** reason **   
Der Grund für die Ausnahme.
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_ListFindings_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/accessanalyzer-2019-11-01/ListFindings) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/accessanalyzer-2019-11-01/ListFindings)