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.
ListAccessPreviewFindings
Ruft eine Liste der Access Preview-Ergebnisse ab, die von der angegebenen Zugriffsvorschau generiert wurden.
Anforderungssyntax
POST /access-preview/accessPreviewId HTTP/1.1
Content-type: application/json
{
"analyzerArn": "string",
"filter": {
"string" : {
"contains": [ "string" ],
"eq": [ "string" ],
"exists": boolean,
"neq": [ "string" ]
}
},
"maxResults": number,
"nextToken": "string"
}
URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
- accessPreviewId
-
Die eindeutige ID für die Zugriffsvorschau.
Pattern:
[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}Erforderlich: Ja
Anforderungstext
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
- analyzerArn
-
Der ARN des Analyzers, der zur Generierung des Zugriffs verwendet wurde.
Typ: Zeichenfolge
Pattern:
[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}Erforderlich: Ja
- filter
-
Kriterien zum Filtern der zurückgegebenen Ergebnisse.
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
Antwortsyntax
HTTP/1.1 200
Content-type: application/json
{
"findings": [
{
"action": [ "string" ],
"changeType": "string",
"condition": {
"string" : "string"
},
"createdAt": "string",
"error": "string",
"existingFindingId": "string",
"existingFindingStatus": "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"
}
],
"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 Ergebnisse von Access Preview, die den angegebenen Filterkriterien entsprechen.
Typ: Array von AccessPreviewFinding-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
- ConflictException
-
Ein Konfliktausnahmefehler.
- resourceId
-
Die ID der Ressource.
- resourceType
-
Der Ressourcentyp.
HTTP-Statuscode: 409
- 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: