View a markdown version of this page

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

CreateAccessPreview

Erstellt eine Zugriffsvorschau, mit der Sie eine Vorschau der IAM Access Analyzer-Ergebnisse für Ihre Ressource anzeigen können, bevor Sie Ressourcenberechtigungen bereitstellen.

Anforderungssyntax

PUT /access-preview HTTP/1.1 Content-type: application/json { "analyzerArn": "string", "clientToken": "string", "configurations": { "string" : { ... } } }

URI-Anfrageparameter

Die Anforderung verwendet keine URI-Parameter.

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

analyzerArn

Der ARN des Account Analyzers, der zur Generierung der Zugriffsvorschau verwendet wurde. Sie können nur eine Zugriffsvorschau für Analysatoren mit einem bestimmten Account Typ und Active Status erstellen.

Typ: Zeichenfolge

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

Erforderlich: Ja

clientToken

Ein Client-Token.

Typ: Zeichenfolge

Erforderlich: Nein

configurations

Konfiguration der Zugriffskontrolle für Ihre Ressource, die zum Generieren der Zugriffsvorschau verwendet wird. Die Zugriffsvorschau enthält Ergebnisse für den externen Zugriff auf die Ressource mit der vorgeschlagenen Zugriffskontrollkonfiguration. Die Konfiguration muss genau ein Element enthalten.

Typ: Zuordnung von Zeichenfolge zu Configuration Objekt

Erforderlich: Ja

Antwortsyntax

HTTP/1.1 200 Content-type: application/json { "id": "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.

id

Die eindeutige ID für die Zugriffsvorschau.

Typ: Zeichenfolge

Pattern: [a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehlertypen.

AccessDeniedException

Sie haben keinen ausreichenden Zugriff zum Durchführen dieser Aktion.

HTTP-Statuscode: 403

ConflictException

Ein Konfliktausnahmefehler.

resourceId

Die ID der Ressource.

resourceType

Der Ressourcentyp.

HTTP-Statuscode: 409

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

ServiceQuotaExceededException

Das Serviceangebot wurde nicht erfüllt.

resourceId

Die Ressourcen-ID.

resourceType

Der Ressourcentyp.

HTTP-Statuscode: 402

ThrottlingException

Fehler beim Überschreiten der Drosselungsgrenze.

retryAfterSeconds

Die Sekunden, die auf einen erneuten Versuch gewartet werden müssen.

HTTP-Statuscode: 429

ValidationException

Fehler bei der Gültigkeitsprüfung.

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