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
Ruft eine Liste der Ergebnisse 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 müssen berechtigt sein, die access-analyzer:ListFindings Aktion auszuführen.
Weitere Informationen zu Filterschlüsseln, mit denen Sie eine Ergebnisliste abrufen können, finden Sie im IAM-Benutzerhandbuch unter IAM Access Analyzer-Filterschlüssel.
Anmerkung
ListFindings wird nur für externe Zugriffsanalysatoren unterstützt. Sie müssen ListFindings V2 für interne und ungenutzte Zugriffsanalysatoren verwenden.
Anforderungssyntax
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
Die Anforderung verwendet keine URI-Parameter.
Anforderungstext
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
- analyzerArn
-
Der ARN des Analyzers, von dem die Ergebnisse abgerufen werden sollen.
Typ: Zeichenfolge
Pattern:
[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}Erforderlich: Ja
- filter
-
Ein Filter, der den Ergebnissen entspricht, die zurückgegeben werden.
Typ: Zuordnung von Zeichenfolge zu Criterion Objekt
Erforderlich: Nein
- maxResults
-
Die maximale Anzahl von Ergebnissen, die in der Antwort zurückgegeben werden sollen.
Typ: Ganzzahl
Erforderlich: Nein
- nextToken
-
Ein Token, das für die Paginierung der zurückgegebenen Ergebnisse verwendet wird.
Typ: Zeichenfolge
Erforderlich: Nein
- sort
-
Die Sortierreihenfolge für die zurückgegebenen Ergebnisse.
Typ: SortCriteria Objekt
Erforderlich: Nein
Antwortsyntax
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
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
-
Eine Liste der vom Analyzer abgerufenen Ergebnisse, die den angegebenen Filterkriterien entsprechen, falls vorhanden.
Typ: Array von FindingSummary-Objekten
- nextToken
-
Ein Token, das für die Paginierung der zurückgegebenen Ergebnisse verwendet wird.
Typ: Zeichenfolge
Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehlertypen.
- 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 der Drosselungsgrenze.
- retryAfterSeconds
-
Die Sekunden, die auf einen erneuten Versuch gewartet werden müssen.
HTTP-Statuscode: 429
- ValidationException
-
Fehler bei der Gültigkeitsprü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:
Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden:
