Opérations Actions Permission-only actions Types de ressources Clés de condition

Actions, ressources et clés de condition pour AWS X-Ray

AWS X-Ray (préfixe de service :xray) fournit les opérations, ressources, actions et clés de condition spécifiques au service suivantes à utiliser dans les politiques d'autorisation IAM.

Références :

Découvrez comment configurer ce service.
Affichez la liste des opérations d'API disponibles pour ce service.
Découvrez comment protéger ce service et ses ressources avec les stratégies d'autorisation IAM.
Consultez la référence d'autorisation de service programmatique pour ce service.

Rubriques

Opérations d'API définies par AWS X-Ray
Actions définies par AWS X-Ray
Permission-only actions pour AWS X-Ray
Types de ressources définis par AWS X-Ray
Clés de condition pour AWS X-Ray

Opérations d'API définies par AWS X-Ray

Le tableau suivant fait correspondre les opérations d'API aux actions IAM qu'elles autorisent. Seules les clés de condition qui ont des valeurs statiques pour l'API et l'action données sont répertoriées ; pour l'ensemble complet des clés de condition prises en charge par chaque action, consultez le tableau Actions.

Opération	Action IAM	Niveau d’accès
BatchGetTraces	xray:BatchGetTraces	List
CancelTraceRetrieval	xray:CancelTraceRetrieval	Lecture
CreateGroup	xray:CreateGroup	Écrire
CreateGroup	xray:TagResource	Marquage, écriture
CreateSamplingRule	xray:CreateSamplingRule	Écrire
CreateSamplingRule	xray:TagResource	Marquage, écriture
DeleteGroup	xray:DeleteGroup	Écrire
DeleteResourcePolicy	xray:DeleteResourcePolicy	Écrire
DeleteSamplingRule	xray:DeleteSamplingRule	Écrire
GetEncryptionConfig	xray:GetEncryptionConfig	Lecture
GetGroup	xray:GetGroup	Lecture
GetGroups	xray:GetGroups	Lecture
GetIndexingRules	xray:GetIndexingRules	Lecture
GetInsight	xray:GetInsight	Lecture
GetInsightEvents	xray:GetInsightEvents	Lecture
GetInsightImpactGraph	xray:GetInsightImpactGraph	Lecture
GetInsightSummaries	xray:GetInsightSummaries	Lecture
GetRetrievedTracesGraph	xray:GetRetrievedTracesGraph	Lecture
GetSamplingRules	xray:GetSamplingRules	Lecture
GetSamplingStatisticSummaries	xray:GetSamplingStatisticSummaries	Lecture
GetSamplingTargets	xray:GetSamplingTargets	Lecture
GetServiceGraph	xray:GetServiceGraph	Lecture
GetTimeSeriesServiceStatistics	xray:GetTimeSeriesServiceStatistics	Lecture
GetTraceGraph	xray:GetTraceGraph	Lecture
GetTraceSegmentDestination	xray:GetTraceSegmentDestination	Lecture
GetTraceSummaries	xray:GetTraceSummaries	Lecture
ListResourcePolicies	xray:ListResourcePolicies	List
ListRetrievedTraces	xray:ListRetrievedTraces	List
ListTagsForResource	xray:ListTagsForResource	List
PutEncryptionConfig	xray:PutEncryptionConfig	Gestion des autorisations, écriture
PutResourcePolicy	xray:PutResourcePolicy	Écrire
PutTelemetryRecords	xray:PutTelemetryRecords	Écrire
PutTraceSegments	xray:PutTraceSegments	Écrire
StartTraceRetrieval	xray:StartTraceRetrieval	Lecture
TagResource	xray:TagResource	Marquage, écriture
UntagResource	xray:UntagResource	Marquage, écriture
UpdateGroup	xray:UpdateGroup	Écrire
UpdateIndexingRule	xray:UpdateIndexingRule	Écrire
UpdateSamplingRule	xray:UpdateSamplingRule	Écrire
UpdateTraceSegmentDestination	xray:UpdateTraceSegmentDestination	Écrire

Actions définies par AWS X-Ray

Vous pouvez indiquer les actions suivantes dans l'élément Action d'une déclaration de politique IAM. Pour chaque action, le tableau répertorie les types de ressources et les clés de condition pris en charge par cette action. Utilisez des politiques pour accorder des autorisations permettant d'effectuer une opération dans AWS. Lorsque vous utilisez une action dans une politique, vous autorisez ou refusez généralement l'accès à l'opération d'API ou à la commande CLI portant le même nom. Toutefois, dans certains cas, une seule action contrôle l'accès à plusieurs opérations. D'autres opérations, quant à elles, requièrent plusieurs actions différentes.

Actions	Description	Types de ressources (*obligatoire)	Clés de condition	Niveau d’accès
BatchGetTraces	Accorde l'autorisation de récupérer une liste des suivis spécifiés par ID. Chaque suivi est un ensemble de documents de segment provenant d'une seule demande. GetTraceSummaries À utiliser pour obtenir une liste des identifiants de trace			List
CancelTraceRetrieval	Accorde l'autorisation d'annuler une tâche de récupération de traces en cours initiée StartTraceRetrieval à l'aide du RetrievalToken Une annulation réussie renverra une réponse HTTP 200			Lecture
CreateGroup	Accorde l'autorisation de créer une ressource de groupe avec un nom et une expression de filtre.	group*	aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey} aws:TagKeys	Écriture
CreateSamplingRule	Accorde l'autorisation de créer une règle permettant de contrôler le comportement d'échantillonnage pour les applications instrumentées.	sampling-rule*	aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey} aws:TagKeys	Écriture
DeleteGroup	Accorde l'autorisation de supprimer une ressource de groupe.	group*	aws:ResourceTag/${TagKey}	Écrire
DeleteResourcePolicy	Accorde l'autorisation de supprimer des politiques de ressource		xray:ResourcePolicyName	Écrire
DeleteSamplingRule	Accorde l'autorisation de supprimer une règle d'échantillonnage.	sampling-rule*	aws:ResourceTag/${TagKey}	Écrire
GetEncryptionConfig	Accorde l'autorisation de récupérer la configuration de chiffrement actuelle pour les X-Ray données			Lecture
GetGroup	Accorde l'autorisation de récupérer les détails des ressources de groupe.	group*	aws:ResourceTag/${TagKey}	Lecture
GetGroups	Accorde l'autorisation de récupérer tous les détails du groupe actif.			Lecture
GetIndexingRules	Accorde l'autorisation de récupérer toutes les règles d'indexation. Les règles d'indexation sont utilisées pour déterminer le taux d'échantillonnage côté serveur pour les intervalles ingérés via la destination et indexés par CloudWatchLogs X-Ray			Lecture
GetInsight	Accorde l'autorisation de récupérer les détails d'une information spécifique.			Lecture
GetInsightEvents	Accorde l'autorisation de récupérer les événements d'une information spécifique.			Lecture
GetInsightImpactGraph	Accorde l'autorisation de récupérer la partie du graphe de service qui est affectée pour une information spécifique.			Lecture
GetInsightSummaries	Accorde l'autorisation de récupérer le résumé de toutes les informations pour un groupe et une plage de temps à l'aide de filtres facultatifs.			Lecture
GetRetrievedTracesGraph	Accorde l'autorisation de récupérer un graphe de service pour les traces en fonction de ce qui est spécifié dans le groupe RetrievalToken de CloudWatch journaux Transaction Search			Lecture
GetSamplingRules	Accorde l'autorisation de récupérer toutes les règles d'échantillonnage.			Lecture
GetSamplingStatisticSummaries	Accorde l'autorisation de récupérer des informations sur les résultats d'échantillonnage récents pour toutes les règles d'échantillonnage.			Lecture
GetSamplingTargets	Accorde l'autorisation de demander un quota d'échantillonnage pour les règles que le service utilise pour échantillonner les demandes.			Lecture
GetServiceGraph	Accorde l'autorisation de récupérer un document qui décrit les services qui traitent les demandes entrantes et les services en aval qu'ils appellent comme résultat.			Lecture
GetTimeSeriesServiceStatistics	Accorde l'autorisation de récupérer une agrégation des statistiques de service définies par une plage de temps spécifique mises en compartiments dans des intervalles de temps.			Lecture
GetTraceGraph	Accorde l'autorisation de récupérer un graphe de service pour un ou plusieurs ID de suivi spécifiques.			Lecture
GetTraceSegmentDestination	Accorde l'autorisation de récupérer la destination actuelle des données envoyées à une PutTraceSegments OpenTelemetry API			Lecture
GetTraceSummaries	Accorde l'autorisation de récupérer les ID et les métadonnées pour les suivis disponibles pour une période spécifiée à l'aide d'un filtre facultatif. Pour obtenir les traces complètes, transmettez les identifiants de trace à BatchGetTraces			Lecture
ListResourcePolicies	Accorde l'autorisation de répertorier les politiques de ressource			List
ListRetrievedTraces	Accorde l'autorisation de récupérer une liste de traces pour une donnée RetrievalToken à partir du groupe de CloudWatch journaux Transaction Search			List
ListTagsForResource	Accorde l'autorisation de répertorier les balises d'une X-Ray ressource	group	aws:ResourceTag/${TagKey}	List
ListTagsForResource		sampling-rule	aws:ResourceTag/${TagKey}	List
PutEncryptionConfig	Accorde l'autorisation de mettre à jour la configuration de chiffrement des X-Ray données			Gestion des autorisations, écriture
PutResourcePolicy	Accorde l'autorisation de créer ou de mettre à jour des politiques de ressource		xray:ResourcePolicyName	Écrire
PutSpans	Accorde l'autorisation de télécharger des OpenTelemetry spans vers AWS X-Ray		logs:LogGeneratingResourceArns	Écrire
PutTelemetryRecords	Accorde l'autorisation d'envoyer la télémétrie du AWS X-Ray démon au service			Écrire
PutTraceSegments	Accorde l'autorisation de télécharger des documents segmentés vers AWS X-Ray. Le X-Ray SDK génère des documents segmentés et les envoie au X-Ray daemon, qui les télécharge par lots		logs:LogGeneratingResourceArns	Écrire
StartTraceRetrieval	Accorde l'autorisation de lancer un processus de récupération de traces en utilisant la plage de temps spécifiée et pour les identifiants de trace donnés dans le groupe de CloudWatch journaux Transaction Search			Lecture
TagResource	Accorde l'autorisation d'ajouter des balises à une X-Ray ressource	group	aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey} aws:TagKeys	Marquage, écriture
TagResource		sampling-rule	aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey} aws:TagKeys	Marquage, écriture
UntagResource	Accorde l'autorisation de supprimer des balises d'une X-Ray ressource	group	aws:ResourceTag/${TagKey} aws:TagKeys	Marquage, écriture
UntagResource		sampling-rule	aws:ResourceTag/${TagKey} aws:TagKeys	Marquage, écriture
UpdateGroup	Accorde l'autorisation de mettre à jour une ressource de groupe.	group*	aws:ResourceTag/${TagKey}	Écrire
UpdateIndexingRule	Accorde l'autorisation de modifier la configuration d'une règle d'indexation			Écrire
UpdateSamplingRule	Accorde l'autorisation de modifier la configuration d'une règle d'échantillonnage.	sampling-rule*	aws:ResourceTag/${TagKey}	Écrire
UpdateTraceSegmentDestination	Accorde l'autorisation de modifier la destination des données envoyées à une PutTraceSegments OpenTelemetry API		xray:TraceSegmentDestination	Écrire

Permission-only actions pour AWS X-Ray

Les actions suivantes sont définies par une opération d'API AWS X-Ray mais ne sont pas directement invocables par le biais d'une quelconque opération d'API. Ils ne peuvent être utilisés dans les déclarations de politique IAM que pour accorder ou refuser des autorisations.

Actions	Description	Niveau d’accès
BatchGetTraceSummaryById	Accorde l'autorisation de récupérer des métadonnées pour une liste des suivis spécifiés par ID	Lecture
GetDistinctTraceGraphs	Accorde l'autorisation de récupérer des graphes de service distincts pour un ou plusieurs ID de suivi spécifiques	Lecture
Link	Accorde l'autorisation de partager X-Ray des ressources avec un compte de surveillance	Écrire
PutSpansForIndexing	Accorde l'autorisation de télécharger des plages AWS X-Ray à indexer	Écrire

Types de ressources définis par AWS X-Ray

Ce service définit les types de ressources suivants, qui peuvent être utilisés dans l' Resource élément des déclarations de politique d'autorisation IAM.

Types de ressources	ARN	Clés de condition
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}

Clés de condition pour AWS X-Ray

AWS X-Ray définit les clés de condition suivantes qui peuvent être utilisées dans l'Conditionélément d'une politique IAM.

Clés de condition	Description	Type
aws:RequestTag/${TagKey}	Filtre l'accès en fonction des identifications transmises dans la demande	String
aws:ResourceTag/${TagKey}	Filtre l'accès en fonction des identifications associées à la ressource	String
aws:TagKeys	Filtre l'accès en fonction des clés d'identification qui sont transmises dans la demande	ArrayOfString
logs:LogGeneratingResourceArns	Filtre l'accès par LogGeneratingResourceArn requête	ArrayOfARN
xray:ResourcePolicyName	Filtre l'accès par PolicyName requête	String
xray:TraceSegmentDestination	Filtre l'accès par TraceSegmentDestination type dans la demande	String

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

AWS WorkSpaces Instances gérées (workspaces-instances)

AWS Billing (billing)