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:
-
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.
Themen
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. Wird verwendet GetTraceSummaries , um eine Trace-Liste abzurufen IDs | 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 | |||
CreateSamplingRule | Gewährt die Berechtigung zum Erstellen einer Regel zur Steuerung des Samplingverhaltens für instrumentierte Anwendungen | Write | |||
DeleteGroup | Gewährt die Berechtigung zum Löschen einer Gruppenressource | Schreiben | |||
DeleteResourcePolicy | Gewährt die Berechtigung zum Löschen von Ressourcenrichtlinien | Schreiben | |||
DeleteSamplingRule | Gewährt die Berechtigung zum Löschen einer Samplingregel | Schreiben | |||
GetDistinctTraceGraphs [nur Berechtigung] | Erteilt die Berechtigung, unterschiedliche Servicediagramme für eine oder mehrere spezifische Ablaufverfolgungen abzurufen 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 | |||
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 CloudWatchLogs Ziel aufgenommen und von X-Ray indexiert wurden | 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 Traces auf der Grundlage der angegebenen Daten RetrievalToken aus der Transaktionssuch-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. | Lesen | |||
GetTraceGraph | Erteilt die Berechtigung zum Abrufen eines Service-Graphen für eine oder mehrere bestimmte Ablaufverfolgungen IDs | Lesen | |||
GetTraceSegmentDestination | Erteilt die Berechtigung zum Abrufen des aktuellen Ziels von Daten, PutTraceSegments die an eine OpenTelemetry API gesendet wurden | Lesen | |||
GetTraceSummaries | Erteilt mithilfe eines optionalen Filters die Berechtigung zum Abrufen von IDs und Metadaten für Traces, die für einen bestimmten Zeitraum verfügbar sind. Um die vollständigen Traces zu erhalten, übergeben Sie den Trace 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 | |||
ListRetrievedTraces | Erteilt die Berechtigung, eine Liste von Traces für eine bestimmte Person RetrievalToken aus der CloudWatch Transaktionssuchprotokollgruppe abzurufen | Auflisten | |||
ListTagsForResource | Gewährt die Berechtigung zum Auflisten von Tags für eine X-Ray-Ressource | List | |||
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 | |||
PutSpans | Erteilt die Erlaubnis, OpenTelemetry Spans auf X-Ray hochzuladen AWS | Schreiben | |||
PutSpansForIndexing [nur Berechtigung] | Erteilt die Erlaubnis, Spans auf AWS X-Ray hochzuladen, damit sie indexiert werden können | Schreiben | |||
PutTelemetryRecords | Erteilt die Erlaubnis, AWS X-Ray-Daemon-Telemetrie an den Dienst zu senden | Schreiben | |||
PutTraceSegments | Erteilt die Erlaubnis, Segmentdokumente auf AWS X-Ray hochzuladen. Das X-Ray-SDK generiert Segmentdokumente und sendet diese an den X-Ray-Daemon, der sie in Batches hochlädt. | Schreiben | |||
StartTraceRetrieval | Erteilt die Berechtigung, für den angegebenen Zeitraum und für den angegebenen Trace in der CloudWatch Transaktionssuchprotokollgruppe einen Prozess zum Abrufen von IDs Traces einzuleiten | Lesen | |||
TagResource | Gewährt die Berechtigung zum Hinzufügen von Tags zu einer X-Ray-Ressource | Markieren | |||
UntagResource | Gewährt die Berechtigung zum Entfernen von Tags aus einer X-Ray-Ressource | Markieren | |||
UpdateGroup | Gewährt die Berechtigung zum Aktualisieren einer Gruppenressource | Schreiben | |||
UpdateIndexingRule | Erteilt die Berechtigung, die Konfiguration einer Indizierungsregel zu ändern | Schreiben | |||
UpdateSamplingRule | Gewährt die Berechtigung zum Ändern der Konfiguration einer Samplingregel | Schreiben | |||
UpdateTraceSegmentDestination | Erteilt die Erlaubnis, das Ziel von Daten zu ändern, die an eine API PutTraceSegments gesendet werden OpenTelemetry | Schreiben |
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}
|
|
sampling-rule |
arn:${Partition}:xray:${Region}:${Account}:sampling-rule/${SamplingRuleName}
|
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).
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 |