Actions, ressources et clés de condition pour Amazon QLDB

PDF

Amazon QLDB (préfixe de service : qldb) fournit les ressources, les actions et les clés de contexte de condition spécifiques au service suivantes en vue de leur utilisation 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.

Actions définies par Amazon QLDB

Vous pouvez indiquer les actions suivantes dans l'élément Action d'une déclaration de politique IAM. 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.

La colonne Types de ressources indique si chaque action prend en charge les autorisations au niveau des ressources. S'il n'y a pas de valeur pour cette colonne, vous devez indiquer toutes les ressources (« * ») dans l'élément Resource de votre déclaration de politique. Si la colonne inclut un type de ressource, vous pouvez indiquer un ARN de ce type dans une déclaration avec cette action. Si l'action comporte une ou plusieurs ressources requises, l'appelant doit être autorisé à utiliser l'action avec ces ressources. Les ressources requises sont indiquées dans le tableau par un astérisque (*). Si vous limitez l'accès aux ressources avec l'Resourceélément dans une politique IAM, vous devez inclure un ARN ou un modèle pour chaque type de ressource requis. Certaines actions prennent en charge plusieurs types de ressources. Si le type de ressource est facultatif (non indiqué comme obligatoire), vous pouvez choisir d'utiliser l'un, mais pas l'autre.

La colonne Clés de condition inclut des clés que vous pouvez spécifier dans l'élément Condition d'une déclaration de politique. Pour plus d'informations sur les clés de condition associées aux ressources du service, consultez la colonne Clés de condition du tableau des types de ressources.

Note

Les clés de condition des ressources sont répertoriées dans le tableau Types de ressources. Vous pouvez trouver un lien vers le type de ressource qui s'applique à une action dans la colonne Types de ressources (* obligatoire) du tableau Actions. Le type de ressource indiqué dans le tableau Types de ressources inclut la colonne Clés de condition, qui contient les clés de condition de ressource qui s'appliquent à une action dans le tableau Actions.

Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Actions.

Actions	Description	Niveau d'accès	Types de ressources (*obligatoire)	Clés de condition	Actions dépendantes
CancelJournalKinesisStream	Accorde l'autorisation d'annuler un flux Kinesis de journal	Écriture	stream*
CreateLedger	Accorde l'autorisation de créer un registre.	Écriture	ledger*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteLedger	Accorde l'autorisation de supprimer un registre.	Écriture	ledger*
DescribeJournalKinesisStream	Accorde l'autorisation de décrire des informations sur un flux Kinesis de journal	Lecture	stream*
DescribeJournalS3Export	Accorde l'autorisation de décrire des informations sur une tâche d'exportation de journal	Lecture	ledger*
DescribeLedger	Accorde l'autorisation de décrire un registre.	Lecture	ledger*
ExecuteStatement [autorisation uniquement]	Accorde l'autorisation d'envoyer des commandes à un registre via la console	Écriture	ledger*
ExportJournalToS3	Accorde l'autorisation d'exporter le contenu du journal vers un compartiment Amazon S3	Écrire	ledger*
GetBlock	Accorde l'autorisation de récupérer un bloc d'un registre pour une donnée BlockAddress	Lecture	ledger*
GetDigest	Accorde l'autorisation de récupérer un résumé d'un registre pour une donnée BlockAddress	Lecture	ledger*
GetRevision	Accorde l'autorisation de récupérer une révision pour un identifiant de document donné et un numéro donné BlockAddress	Lecture	ledger*
InsertSampleData [autorisation uniquement]	Accorde l'autorisation d'insérer des exemples de données d'application via la console	Écriture	ledger*
ListJournalKinesisStreamsForLedger	Accorde l'autorisation de répertorier les flux Kinesis de journal pour un registre spécifié	Liste	stream*
ListJournalS3Exports	Accorde l'autorisation de répertorier les tâches d'exportation de journal pour tous les registres	Liste
ListJournalS3ExportsForLedger	Accorde l'autorisation de répertorier les tâches d'exportation de journal pour un registre spécifié	Liste	ledger*
ListLedgers	Accorde l'autorisation de répertorier les registres existants	Liste
ListTagsForResource	Accorde l'autorisation de répertorier les identifications d'une ressource.	Lecture	catalog
			ledger
			stream
			table
PartiQLCreateIndex	Accorde l'autorisation de créer un index sur une table	Écriture	table*
PartiQLCreateTable	Accorde l'autorisation de créer une table.	Écriture	table*
				aws:RequestTag/${TagKey} aws:TagKeys
PartiQLDelete	Accorde l'autorisation de supprimer des documents d'une table	Écriture	table*
PartiQLDropIndex	Accorde l'autorisation de supprimer un index d'une table	Écriture	table*
				qldb:Purge
PartiQLDropTable	Accorde l'autorisation de supprimer une table	Écriture	table*
				qldb:Purge
PartiQLHistoryFunction	Accorde l'autorisation d'utiliser la fonction d'historique sur une table	Lecture	table*
PartiQLInsert	Accorde l'autorisation d'insérer des documents dans une table	Écrire	table*
PartiQLRedact	Accorde l'autorisation de censurer des révisions historiques	Écrire	table*
PartiQLSelect	Accorde l'autorisation de sélectionner des documents à partir d'une table	Lecture	catalog
			table
PartiQLUndropTable	Accorde l'autorisation d'annuler la suppression d'une table	Écriture	table*
PartiQLUpdate	Accorde l'autorisation de mettre à jour des documents existants dans une table	Écriture	table*
SendCommand	Accorde l'autorisation d'envoyer des commandes à un registre	Écrire	ledger*
ShowCatalog [autorisation uniquement]	Accorde l'autorisation d'afficher le catalogue d'un registre via la console	Écriture	ledger*
StreamJournalToKinesis	Octroie l'autorisation de diffuser le contenu du journal vers un flux de données Kinesis	Écriture	stream*
				aws:RequestTag/${TagKey} aws:TagKeys
TagResource	Accorde l'autorisation d'ajouter une ou plusieurs balises à une ressource	Balisage	catalog
			ledger
			stream
			table
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	Accorde l'autorisation de supprimer une ou plusieurs balises d'une ressource	Balisage	catalog
			ledger
			stream
			table
				aws:RequestTag/${TagKey} aws:TagKeys
UpdateLedger	Accorde l'autorisation de mettre à jour les propriétés d'un registre	Écriture	ledger*
UpdateLedgerPermissionsMode	Accorde l'autorisation de mettre à jour le mode d'autorisations sur un registre	Écriture	ledger*

Types de ressources définis par Amazon QLDB

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. Chaque action du tableau Actions identifie les types de ressources pouvant être spécifiés avec cette action. Un type de ressource peut également définir les clés de condition que vous pouvez inclure dans une politique. Ces clés sont affichées dans la dernière colonne du tableau. Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Types de ressources.

Types de ressources	ARN	Clés de condition
ledger	arn:${Partition}:qldb:${Region}:${Account}:ledger/${LedgerName}	aws:ResourceTag/${TagKey}
stream	arn:${Partition}:qldb:${Region}:${Account}:stream/${LedgerName}/${StreamId}	aws:ResourceTag/${TagKey}
table	arn:${Partition}:qldb:${Region}:${Account}:ledger/${LedgerName}/table/${TableId}	aws:ResourceTag/${TagKey}
catalog	arn:${Partition}:qldb:${Region}:${Account}:ledger/${LedgerName}/information_schema/user_tables	aws:ResourceTag/${TagKey}

Clés de condition pour Amazon QLDB

Amazon QLDB définit les clés de condition suivantes que vous pouvez utiliser dans l'élément Condition d'une stratégie IAM. Vous pouvez utiliser ces clés pour affiner les conditions d’application de la déclaration de politique. Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Clés de condition.

Pour afficher les clés de condition globales disponibles pour tous les services, consultez Clés de condition globales disponibles.

Clés de condition	Description	Type
aws:RequestTag/${TagKey}	Filtre l'accès en fonction de la paire de clés et de valeurs d'identification autorisée dans la demande.	Chaîne
aws:ResourceTag/${TagKey}	Filtre l'accès en fonction de la paire de clé et de valeur d'identification d'une ressource.	Chaîne
aws:TagKeys	Filtre l'accès en fonction d'une liste de clés d'identification autorisées dans la demande.	ArrayOfString
qldb:Purge	Filtre l'accès en fonction de la valeur de purge spécifiée dans une instruction DROP PartiQL	Chaîne