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.
GetFindingV2
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.
Anforderungssyntax
GET /findingv2/id?analyzerArn=analyzerArn&maxResults=maxResults&nextToken=nextToken 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
- maxResults
-
Die maximale Anzahl von Ergebnissen, die in der Antwort zurückgegeben werden sollen.
- nextToken
-
Ein Token, das für die Paginierung der zurückgegebenen Ergebnisse verwendet wird.
Anforderungstext
Der Anforderung besitzt keinen Anforderungstext.
Antwortsyntax
HTTP/1.1 200
Content-type: application/json
{
"analyzedAt": "string",
"createdAt": "string",
"error": "string",
"findingDetails": [
{ ... }
],
"findingType": "string",
"id": "string",
"nextToken": "string",
"resource": "string",
"resourceOwnerAccount": "string",
"resourceType": "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.
- analyzedAt
-
Der Zeitpunkt, zu dem die ressourcenbasierte Richtlinie oder IAM-Entität, die das Ergebnis generiert hat, analysiert wurde.
Typ: Zeitstempel
- createdAt
-
Der Zeitpunkt, zu dem das Ergebnis erstellt wurde.
Typ: Zeitstempel
- error
-
Ein Fehler.
Typ: Zeichenfolge
- findingDetails
-
Eine lokalisierte Meldung, die den Befund erklärt und Anleitungen zur Behebung des Fehlers enthält.
Typ: Array von FindingDetails-Objekten
- findingType
-
Der Typ des -Ergebnisses. Für Analysatoren mit externem Zugriff ist
ExternalAccessder Typ. Für ungenutzte Zugriffsanalysatoren kann der TypUnusedIAMRole,UnusedIAMUserAccessKeyUnusedIAMUserPassword, oder sein.UnusedPermissionTyp: Zeichenfolge
Zulässige Werte:
ExternalAccess | UnusedIAMRole | UnusedIAMUserAccessKey | UnusedIAMUserPassword | UnusedPermission - id
-
Die ID des abzurufenden Ergebnisses.
Typ: Zeichenfolge
- nextToken
-
Ein Token, das für die Paginierung der zurückgegebenen Ergebnisse verwendet wird.
Typ: Zeichenfolge
- resource
-
Die Ressource, die den Befund generiert hat.
Typ: Zeichenfolge
- resourceOwnerAccount
-
Die AWS-Konto ID, der die Ressource gehört.
Typ: Zeichenfolge
- resourceType
-
Der Typ der Ressource, die im Ergebnis identifiziert wurde.
Typ: Zeichenfolge
Zulässige Werte:
AWS::S3::Bucket | AWS::IAM::Role | AWS::SQS::Queue | AWS::Lambda::Function | AWS::Lambda::LayerVersion | AWS::KMS::Key | AWS::SecretsManager::Secret | AWS::EFS::FileSystem | AWS::EC2::Snapshot | AWS::ECR::Repository | AWS::RDS::DBSnapshot | AWS::RDS::DBClusterSnapshot | AWS::SNS::Topic | AWS::S3Express::DirectoryBucket | AWS::DynamoDB::Table | AWS::DynamoDB::Stream | AWS::IAM::User - status
-
Der Status des Ergebnisses.
Typ: Zeichenfolge
Zulässige Werte:
ACTIVE | ARCHIVED | RESOLVED - updatedAt
-
Der Zeitpunkt, zu dem das Ergebnis aktualisiert wurde.
Typ: Zeitstempel
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.
HTTP Status Code: 500
- ResourceNotFoundException
-
Die angegebene Ressource konnte nicht gefunden werden.
HTTP Status Code: 404
- ThrottlingException
-
Fehler beim Überschreiten des Drosselungslimits.
HTTP-Statuscode: 429
- ValidationException
-
Fehler bei der Gültigkeitsausnahme.
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:
