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.
GetFinding
Ruft Informationen über den angegebenen Befund ab. GetFinding und GetFinding V2 werden beide access-analyzer:GetFinding
im Action
Element einer IAM-Richtlinienerklärung verwendet. Sie müssen über die Erlaubnis verfügen, die access-analyzer:GetFinding
Aktion auszuführen.
Anmerkung
GetFinding wird nur für externe Zugriffsanalysatoren unterstützt. Sie müssen GetFinding V2 für interne und ungenutzte Zugriffsanalysatoren verwenden.
Anforderungssyntax
GET /finding/id
?analyzerArn=analyzerArn
HTTP/1.1
URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
- analyzerArn
-
Der ARN des Analysators, der den Befund generiert hat.
Pattern:
[^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}
Erforderlich: Ja
- id
-
Die ID des abzurufenden Ergebnisses.
Erforderlich: Ja
Anforderungstext
Der Anforderung besitzt keinen Anforderungstext.
Antwortsyntax
HTTP/1.1 200
Content-type: application/json
{
"finding": {
"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"
}
}
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.
Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.
- AccessDeniedException
-
Sie haben keinen ausreichenden Zugriff zum Durchführen dieser Aktion.
HTTP Status Code: 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 Status Code: 404
- ThrottlingException
-
Fehler beim Überschreiten des Drosselungslimits.
- retryAfterSeconds
-
Die Sekunden, die auf einen erneuten Versuch gewartet werden müssen.
HTTP-Statuscode: 429
- ValidationException
-
Fehler bei der Gültigkeitsausnahme.
- fieldList
-
Eine Liste von Feldern, die nicht validiert wurden.
- reason
-
Der Grund für die Ausnahme.
HTTP Status Code: 400
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: