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

AWS X-Ray (Servicepräfix: xray) stellt die folgenden servicespezifischen Ressourcen, Aktionen und Bedingungskontextschlüssel für die Verwendung in IAM-Berechtigungsrichtlinien bereit.

Referenzen:

• Erfahren Sie, wie Sie diesen Service konfigurieren.

• Zeigen Sie eine Liste der API-Operationen an, die für diesen Service verfügbar sind.

• Erfahren Sie, wie Sie diesen Service und seine Ressourcen mithilfe von IAM-Berechtigungsrichtlinien schützen.

Von AWS X-Ray definierte Aktionen

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.

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.

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. Mit GetTraceSummaries können Sie eine Liste von Ablaufverfolgungs-IDs abrufen.	List
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
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	Gewährt die Berechtigung zum Abrufen der aktuellen Verschlüsselungskonfiguration für X-Ray-Daten	Read
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	Read
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	Read
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	Read
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 Ablaufverfolgungen abzurufen, übergeben Sie die Ablaufverfolgungs-IDs an BatchGetTraces.	Lesen
Link [nur Berechtigung]	Gewährt die Berechtigung zum Freigeben von X-Ray-Ressourcen für ein Überwachungs-Konto	Schreiben
ListResourcePolicies	Gewährt die Berechtigung zum Auflisten von Ressourcenrichtlinien	Auflisten
ListTagsForResource	Gewährt die Berechtigung zum Auflisten von Tags für eine X-Ray-Ressource	List	group
			sampling-rule
PutEncryptionConfig	Gewährt die Berechtigung zum Aktualisieren der Verschlüsselungskonfiguration für X-Ray-Daten	Berechtigungsverwaltung
PutResourcePolicy	Gewährt die Berechtigung zum Erstellen oder Aktualisieren von Ressourcenrichtlinien	Schreiben
PutTelemetryRecords	Gewährt die Berechtigung, AWS X-Ray-Daemon-Telemetrie an den Service zu senden	Write
PutTraceSegments	Gewährt die Berechtigung zum Upload von Segmentdokumenten in AWS X-Ray. Das X-Ray-SDK generiert Segmentdokumente und sendet diese an den X-Ray-Daemon, der sie in Batches hochlädt.	Write
TagResource	Gewährt die Berechtigung zum Hinzufügen von Tags zu einer X-Ray-Ressource	Markieren	group
			sampling-rule
				aws:TagKeys aws:RequestTag/${TagKey}
UntagResource	Gewährt die Berechtigung zum Entfernen von Tags aus einer X-Ray-Ressource	Markieren	group
			sampling-rule
				aws:TagKeys
UpdateGroup	Gewährt die Berechtigung zum Aktualisieren einer Gruppenressource	Write	group*
				aws:ResourceTag/${TagKey}
UpdateSamplingRule	Gewährt die Berechtigung zum Ändern der Konfiguration einer Samplingregel	Write	sampling-rule*
				aws:ResourceTag/${TagKey}

Von AWS X-Ray definierte Ressourcentypen

Die folgenden Ressourcentypen werden von diesem Service definiert und können im Element Resource von IAM-Berechtigungsrichtlinienanweisungen verwendet werden. Jede Aktion in der Tabelle "Actions" (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 Element Condition 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).

Eine Liste der globalen Bedingungsschlüssel, die für alle Services verfügbar sind, finden Sie unter Verfügbare globale Bedingungsschlüssel.

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