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 Fundressource.
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.
- retryAfterSeconds
-
Die Sekunden, in denen auf einen erneuten Versuch gewartet werden muss.
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: