View a markdown version of this page

Aktionen, Ressourcen und Bedingungsschlüssel für AWS X-Ray - Service-Authorization-Referenz

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.

Aktionen, Ressourcen und Bedingungsschlüssel für AWS X-Ray

AWS X-Ray (Dienstpräfix:xray) stellt die folgenden dienstspezifischen Ressourcen, Aktionen und Bedingungskontextschlüssel zur Verwendung in IAM-Berechtigungsrichtlinien bereit.

Referenzen:

Aktionen, die definiert sind von AWS X-Ray

Sie können die folgenden Aktionen im Element Action einer IAM-Richtlinienanweisung angeben. Verwenden Sie Richtlinien, um Berechtigungen zum Ausführen einer Operation in AWS zu erteilen. Wenn Sie eine Aktion in einer Richtlinie verwenden, erlauben oder verweigern Sie in der Regel den Zugriff auf die API-Operation oder den CLI-Befehl mit demselben Namen. Dabei kann es mitunter vorkommen, dass eine einzige Aktion den Zugriff auf mehr als eine Operation steuert. Alternativ erfordern einige Vorgänge mehrere verschiedene Aktionen.

In der Spalte Zugriffsebene der Tabelle Aktionen wird beschrieben, wie die Aktion klassifiziert ist (Liste, Lesen, Berechtigungsverwaltung oder Tagging). Diese Klassifizierung gibt an, welche Zugriffsebene die betreffende Aktion gewährt, wenn Sie sie in einer Richtlinie verwenden. Weitere Informationen zu Zugriffsebenen finden Sie unter Zugriffsebenen in Richtlinienzusammenfassungen.

Die Spalte Resource types (Ressourcentypen) der Aktionstabelle gibt an, ob die Aktion Berechtigungen auf Ressourcenebene unterstützt. Wenn es keinen Wert für diese Spalte gibt, müssen Sie alle Ressourcen ("*") im Element Resource Ihrer Richtlinienanweisung angeben. Wenn die Spalte einen Ressourcentyp enthält, können Sie einen ARN dieses Typs in einer Anweisung mit dieser Aktion angeben. Wenn für die Aktion eine oder mehrere Ressourcen erforderlich sind, muss der Aufrufer die Erlaubnis haben, die Aktion mit diesen Ressourcen zu verwenden. Erforderliche Ressourcen sind in der Tabelle mit einem Sternchen (*) gekennzeichnet. Wenn Sie den Ressourcenzugriff mit dem Element Resource in einer IAM-Richtlinie einschränken, müssen Sie für jeden erforderlichen Ressourcentyp einen ARN oder ein Muster angeben. Einige Aktionen unterstützen mehrere Ressourcentypen. Wenn der Ressourcentyp optional ist (nicht als erforderlich angegeben), können Sie sich für einen der optionalen Ressourcentypen entscheiden.

Die Spalte Bedingungsschlüssel der Tabelle der Aktionen enthält Schlüssel, die Sie im Element Condition einer Richtlinienanweisung angeben können. Weitere Informationen zu den Bedingungsschlüsseln, die den Ressourcen für den Service zugeordnet sind, finden Sie in der Spalte Bedingungsschlüssel der Tabelle der Ressourcentypen.

In der Spalte „Abhängige Aktionen“ der Tabelle „Aktionen“ werden zusätzliche Berechtigungen angezeigt, die möglicherweise erforderlich sind, um eine Aktion erfolgreich aufzurufen. Diese Berechtigungen sind möglicherweise zusätzlich zu der Berechtigung für die Aktion selbst erforderlich. Wenn eine Aktion abhängige Aktionen spezifiziert, können diese Abhängigkeiten für zusätzliche Ressourcen gelten, die für diese Aktion definiert wurden, nicht nur für die erste Ressource, die in der Tabelle aufgeführt ist.

Anmerkung

Die Ressourcenbedingungsschlüssel sind in der Tabelle Ressourcentypen enthalten. Sie finden einen Link zu dem Ressourcentyp, der für eine Aktion gilt, in der Spalte Ressourcentypen (*erforderlich) der Tabelle „Aktionen“. Der Ressourcentyp in der Tabelle „Ressourcentypen“ enthält die Spalte Bedingungsschlüssel. Das sind die Ressourcenbedingungsschlüssel, die für eine Aktion in der Tabelle „Aktionen“ gelten.

Details zu den Spalten in der folgenden Tabelle finden Sie in der Tabelle Aktionen

Aktionen Beschreibung Zugriffsebene Ressourcentypen (*erforderlich) Bedingungsschlüssel Abhängige Aktionen
BatchGetTraceSummaryById [nur Berechtigung] Gewährt die Berechtigung zum Abrufen von Metadaten einer Liste von Ablaufverfolgungen, die anhand der ID angegeben werden Lesen
BatchGetTraces Gewährt die Berechtigung zum Abrufen einer Liste von Traces, die anhand der ID angegeben werden. Jede Ablaufverfolgung ist eine Sammlung von Segmentdokumenten, die von einer einzigen Anforderung stammt. Wird verwendet GetTraceSummaries , um eine Liste von Trace-IDs abzurufen Auflisten
CancelTraceRetrieval Erteilt die Berechtigung, einen laufenden Auftrag zum Abrufen von Ablaufverfolgungen abzubrechen, der StartTraceRetrieval mithilfe der bereitgestellten RetrievalToken Methode initiiert wurde. Bei einem erfolgreichen Abbruch wird eine HTTP 200-Antwort zurückgegeben Lesen
CreateGroup Gewährt die Berechtigung zum Erstellen einer Gruppenressource mit einem Namen und einem Filterausdruck Write

group*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateSamplingRule Gewährt die Berechtigung zum Erstellen einer Regel zur Steuerung des Samplingverhaltens für instrumentierte Anwendungen Write

sampling-rule*

aws:RequestTag/${TagKey}

aws:TagKeys

DeleteGroup Gewährt die Berechtigung zum Löschen einer Gruppenressource Schreiben

group*

aws:ResourceTag/${TagKey}

DeleteResourcePolicy Gewährt die Berechtigung zum Löschen von Ressourcenrichtlinien Schreiben

xray:ResourcePolicyName

DeleteSamplingRule Gewährt die Berechtigung zum Löschen einer Samplingregel Schreiben

sampling-rule*

aws:ResourceTag/${TagKey}

GetDistinctTraceGraphs [nur Berechtigung] Gewährt die Berechtigung zum Abrufen eines Servicediagramms für eine oder mehrere bestimmte Ablaufverfolgungs-IDs Lesen
GetEncryptionConfig Erteilt die Berechtigung zum Abrufen der aktuellen Verschlüsselungskonfiguration für X-Ray Daten Lesen
GetGroup Gewährt die Berechtigung zum Abrufen von Gruppen-Ressourcendetails Read

group*

aws:ResourceTag/${TagKey}

GetGroups Gewährt die Berechtigung zum Abrufen aller aktiven Gruppendetails Lesen
GetIndexingRules Erteilt die Berechtigung zum Abrufen aller Indizierungsregeln. Indizierungsregeln werden verwendet, um die serverseitige Samplingrate für Spans zu bestimmen, die über das Ziel aufgenommen und von indexiert wurden CloudWatchLogs X-Ray Lesen
GetInsight Gewährt die Berechtigung zum Abrufen der Details eines bestimmten Einblicks Read
GetInsightEvents Gewährt die Berechtigung zum Abrufen der Ereignisse eines bestimmten Einblicks Read
GetInsightImpactGraph Gewährt die Berechtigung zum Abrufen des Teils des Servicediagramms, der bei einem bestimmten Einblick betroffen ist Read
GetInsightSummaries Gewährt die Berechtigung zum Abrufen der Zusammenfassung aller Einblicke für eine Gruppe und einen Zeitbereich mit optionalen Filtern Lesen
GetRetrievedTracesGraph Erteilt die Berechtigung zum Abrufen eines Service-Graphen für Ablaufverfolgungen auf der Grundlage der angegebenen Daten RetrievalToken aus der Transaktionssuche-Protokollgruppe CloudWatch Lesen
GetSamplingRules Gewährt die Berechtigung zum Abrufen aller Samplingregeln Read
GetSamplingStatisticSummaries Gewährt die Berechtigung zum Abrufen von Informationen über aktuelle Samplingergebnisse für alle Samplingregeln Read
GetSamplingTargets Gewährt die Berechtigung zum Anfordern einer Samplingquote für Regeln, die der Service für das Sampling von Anforderungen verwendet Read
GetServiceGraph Gewährt die Berechtigung zum Abrufen eines Dokuments, das Services zur Verarbeitung eingehender Anforderungen beschreibt sowie infolgedessen aufgerufene Downstream-Services. Read
GetTimeSeriesServiceStatistics Gewährt die Berechtigung, eine Zusammenfassung der Servicestatistiken abzurufen, die durch einen bestimmten Zeitraum definiert sind, der in Zeitintervallen untGewährt ist. Read
GetTraceGraph Gewährt die Berechtigung zum Abrufen eines Servicediagramms für eine oder mehrere bestimmte Trace-IDs Lesen
GetTraceSegmentDestination Erteilt die Berechtigung, das aktuelle Ziel der an PutTraceSegments eine OpenTelemetry API gesendeten Daten abzurufen Lesen
GetTraceSummaries Gewährt die Berechtigung, IDs und Metadaten für Ablaufverfolgungen, die für einen bestimmten Zeitraum verfügbar sind, mithilfe eines optionalen Filters abzurufen. Um die vollständigen Traces zu erhalten, übergeben Sie die Trace-IDs an BatchGetTraces Lesen
Erteilt die Erlaubnis, X-Ray Ressourcen mit einem Monitoring-Konto gemeinsam zu nutzen Schreiben
ListResourcePolicies Gewährt die Berechtigung zum Auflisten von Ressourcenrichtlinien Auflisten
ListRetrievedTraces Erteilt die Berechtigung, eine Trace-Liste für ein bestimmtes Objekt RetrievalToken aus der Transaction CloudWatch Search-Protokollgruppe abzurufen Auflisten
ListTagsForResource Erteilt die Berechtigung, Tags für eine X-Ray Ressource aufzulisten Auflisten

group

sampling-rule

PutEncryptionConfig Erteilt die Erlaubnis, die Verschlüsselungskonfiguration für X-Ray Daten zu aktualisieren Berechtigungsverwaltung
PutResourcePolicy Gewährt die Berechtigung zum Erstellen oder Aktualisieren von Ressourcenrichtlinien Schreiben

xray:ResourcePolicyName

PutSpans Erteilt die Erlaubnis zum Hochladen von OpenTelemetry Spans auf AWS X-Ray Schreiben

logs:LogGeneratingResourceArns

PutSpansForIndexing [nur Berechtigung] Erteilt die Erlaubnis, Spans hochzuladen, die indexiert werden AWS X-Ray sollen Schreiben
PutTelemetryRecords Erteilt die Erlaubnis, AWS X-Ray Daemon-Telemetrie an den Dienst zu senden Schreiben
PutTraceSegments Erteilt die Berechtigung zum Hochladen von Segmentdokumenten in. AWS X-Ray Das X-Ray SDK generiert Segmentdokumente und sendet sie an den X-Ray Daemon, der sie stapelweise hochlädt Schreiben

logs:LogGeneratingResourceArns

StartTraceRetrieval Erteilt die Berechtigung, einen Prozess zum Abrufen von Traces im angegebenen Zeitraum und für die angegebenen Trace-IDs in der Transaktionssuchprotokollgruppe einzuleiten CloudWatch Lesen
TagResource Erteilt die Berechtigung zum Hinzufügen von Tags zu einer Ressource X-Ray Tagging

group

sampling-rule

aws:TagKeys

aws:RequestTag/${TagKey}

UntagResource Erteilt die Erlaubnis, Tags aus einer X-Ray Ressource zu entfernen Tagging

group

sampling-rule

aws:TagKeys

UpdateGroup Gewährt die Berechtigung zum Aktualisieren einer Gruppenressource Schreiben

group*

aws:ResourceTag/${TagKey}

UpdateIndexingRule Erteilt die Berechtigung, die Konfiguration einer Indizierungsregel zu ändern Schreiben
UpdateSamplingRule Gewährt die Berechtigung zum Ändern der Konfiguration einer Samplingregel Schreiben

sampling-rule*

aws:ResourceTag/${TagKey}

UpdateTraceSegmentDestination Erteilt die Erlaubnis, das Ziel von Daten zu ändern, die an eine API PutTraceSegments gesendet werden OpenTelemetry Schreiben

xray:TraceSegmentDestination

Ressourcentypen, definiert durch AWS X-Ray

Die folgenden Ressourcentypen werden von diesem Service definiert und können im Element Resource von IAM-Berechtigungsrichtlinienanweisungen verwendet werden. Jede Aktion in der Tabelle „Aktionen“ identifiziert die Ressourcentypen, die mit der Aktion angegeben werden können. Ein Ressourcentyp kann auch definieren, welche Bedingungsschlüssel Sie in einer Richtlinie einschließen können. Diese Schlüssel werden in der letzten Spalte der Tabelle der Ressourcentypen angezeigt. Details zu den Spalten in der folgenden Tabelle finden Sie in der Tabelle Resource types.

Ressourcentypen ARN Bedingungsschlüssel
group arn:${Partition}:xray:${Region}:${Account}:group/${GroupName}/${Id}

aws:ResourceTag/${TagKey}

sampling-rule arn:${Partition}:xray:${Region}:${Account}:sampling-rule/${SamplingRuleName}

aws:ResourceTag/${TagKey}

Bedingungsschlüssel für AWS X-Ray

AWS X-Ray definiert die folgenden Bedingungsschlüssel, die im Condition Element einer IAM-Richtlinie verwendet werden können. Diese Schlüssel können Sie verwenden, um die Bedingungen zu verfeinern, unter denen die Richtlinienanweisung angewendet wird. Details zu den Spalten in der folgenden Tabelle finden Sie in der Tabelle Condition keys (Bedingungsschlüssel).

Informationen zu den globalen Bedingungsschlüsseln, die für alle Dienste verfügbar sind, finden Sie unter Kontextschlüssel für AWS globale Bedingungen.

Bedingungsschlüssel Beschreibung Typ
aws:RequestTag/${TagKey} Filtert den Zugriff durch die Tags, die in der Anfrage übergeben werden Zeichenfolge
aws:ResourceTag/${TagKey} Filtert den Zugriff basierend auf den Tags, die der Ressource zugeordnet sind. Zeichenfolge
aws:TagKeys Filtert den Zugriff basierend auf den Tag-Schlüssel, die in der Anfrage übergeben werden ArrayOfString
logs:LogGeneratingResourceArns Filtert den Zugriff nach LogGeneratingResourceArn in der Anfrage ArrayOfARN
xray:ResourcePolicyName Filtert den Zugriff nach PolicyName in der Anfrage Zeichenfolge
xray:TraceSegmentDestination Filtert den Zugriff nach TraceSegmentDestination Typ in der Anfrage Zeichenfolge