GetFindingRecommendation - IAM Access Analyzer

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.

GetFindingRecommendation

Ruft Informationen zu einer Ergebnisempfehlung für das angegebene Analysegerät ab.

Anforderungssyntax

GET /recommendation/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 zur Generierung der Ergebnisempfehlung verwendet wurde.

Pattern: [^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}

Erforderlich: Ja

id

Die eindeutige ID für die Ergebnisempfehlung.

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 2048 Zeichen.

Erforderlich: Ja

maxResults

Die maximale Anzahl von Ergebnissen, die in der Antwort zurückgegeben werden sollen.

Gültiger Bereich: Mindestwert 1. Maximaler Wert von 1 000.

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 { "completedAt": "string", "error": { "code": "string", "message": "string" }, "nextToken": "string", "recommendationType": "string", "recommendedSteps": [ { ... } ], "resourceArn": "string", "startedAt": "string", "status": "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.

completedAt

Der Zeitpunkt, zu dem der Abruf der Ergebnisempfehlung abgeschlossen war.

Typ: Zeitstempel

error

Detaillierte Informationen über den Grund, warum das Abrufen einer Empfehlung für das Ergebnis fehlgeschlagen ist.

Typ: RecommendationError Objekt

nextToken

Ein Token, das für die Paginierung der zurückgegebenen Ergebnisse verwendet wird.

Typ: Zeichenfolge

recommendationType

Die Art der Empfehlung für das Ergebnis.

Typ: Zeichenfolge

Zulässige Werte: UnusedPermissionRecommendation

recommendedSteps

Eine Gruppe von empfohlenen Schritten für das Ergebnis.

Typ: Array von RecommendedStep-Objekten

resourceArn

Der ARN der Ressource, aus der der Befund stammt.

Typ: Zeichenfolge

Pattern: arn:[^:]*:[^:]*:[^:]*:[^:]*:.*

startedAt

Der Zeitpunkt, zu dem der Abruf der Befundempfehlung gestartet wurde.

Typ: Zeitstempel

status

Der Status des Abrufs der Feststellungsempfehlung.

Typ: Zeichenfolge

Zulässige Werte: SUCCEEDED | FAILED | IN_PROGRESS

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