GetFinding - IAM Access Analyzer
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

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 entsprechende Genehmigung verfügen, um die access-analyzer:GetFinding Aktion ausführen zu können.

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.

finding

Ein finding Objekt, das Details zu den Ergebnissen enthält.

Typ: Finding Objekt

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-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

Fehler bei der Validierungsausnahme.

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 einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: