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

PDF

Amazon WorkDocs (préfixe de service :workdocs) fournit les ressources, actions et clés de contexte de condition spécifiques aux services 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.

Actions définies par Amazon WorkDocs

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
AbortDocumentVersionUpload	Accorde l'autorisation d'abandonner le téléchargement de la version de document spécifiée qui a été précédemment lancé par InitiateDocumentVersionUpload	Écrire
ActivateUser	Accorde l'autorisation d'activer l'utilisateur spécifié. Seuls les utilisateurs actifs peuvent accéder à Amazon WorkDocs	Écrire
AddNotificationPermissions [autorisation uniquement]	Accorde l'autorisation d'ajouter des principaux autorisés à s'abonner aux notifications d'appel APIs pour un site donné WorkDocs	Écrire
AddResourcePermissions	Accorde l'autorisation de créer un jeu d'autorisations pour le dossier ou document spécifié	Écrire
AddUserToGroup [autorisation uniquement]	Accorde l'autorisation d'ajouter un utilisateur à un groupe	Écrire
CheckAlias [autorisation uniquement]	Accorde l'autorisation de vérifier un alias	Lecture
CreateComment	Accorde l'autorisation d'ajouter un nouveau commentaire à la version du document spécifiée	Écrire
CreateCustomMetadata	Accorde l'autorisation d'ajouter une ou plusieurs propriétés personnalisées à la ressource spécifiée	Écrire
CreateFolder	Accorde l'autorisation de créer un dossier avec le nom spécifié et le dossier parent	Écrire
CreateInstance [autorisation uniquement]	Accorde l'autorisation de créer une instance	Écrire
CreateLabels	Accorde l'autorisation d'ajouter des étiquettes à la ressource donnée	Écrire
CreateNotificationSubscription	Accorde l'autorisation de configurer WorkDocs pour utiliser les notifications Amazon SNS	Écrire
CreateUser	Accorde l'autorisation de créer un utilisateur dans un répertoire Simple AD ou Microsoft AD	Écrire
DeactivateUser	Accorde l'autorisation de désactiver l'utilisateur spécifié, ce qui révoque l'accès de l'utilisateur à Amazon WorkDocs	Écrire
DeleteComment	Accorde l'autorisation de supprimer le commentaire spécifié de la version du document	Écrire
DeleteCustomMetadata	Accorde l'autorisation de supprimer les métadonnées personnalisées de la ressource spécifiée	Écrire
DeleteDocument	Accorde l'autorisation de supprimer définitivement le document spécifié et ses métadonnées associées	Écrire
DeleteDocumentVersion	Accorde l'autorisation de supprimer les versions d'un document spécifié	Écrire
DeleteFolder	Accorde l'autorisation de supprimer définitivement le dossier spécifié et son contenu	Écrire
DeleteFolderContents	Accorde l'autorisation de supprimer le contenu du dossier spécifié	Écrire
DeleteInstance [autorisation uniquement]	Accorde l'autorisation de supprimer une instance	Écrire
DeleteLabels	Accorde l'autorisation de supprimer une ou plusieurs étiquettes d'une ressource	Écrire
DeleteNotificationPermissions [autorisation uniquement]	Accorde l'autorisation de supprimer les principaux autorisés à s'abonner aux notifications d'appel APIs pour un site donné WorkDocs	Écrire
DeleteNotificationSubscription	Accorde l'autorisation de supprimer l'abonnement spécifié de l'organisation spécifiée	Écrire
DeleteUser	Accorde l'autorisation de supprimer l'utilisateur spécifié d'un répertoire Simple AD ou Microsoft AD	Écrire
DeregisterDirectory [autorisation uniquement]	Accorde l'autorisation d'annuler l'enregistrement d'un répertoire	Écrire
DescribeActivities	Accorde l'autorisation de récupérer les activités d'un utilisateur dans un laps de temps donné	Liste
DescribeAvailableDirectories [autorisation uniquement]	Accorde l'autorisation de décrire les répertoires disponibles	Liste
DescribeComments	Accorde l'autorisation de répertorier tous les commentaires pour la version de document spécifiée	Liste
DescribeDocumentVersions	Accorde l'autorisation de récupérer les versions de document pour le document spécifié	Liste
DescribeFolderContents	Accorde l'autorisation de décrire le contenu du dossier spécifié, y compris ses documents et sous-dossiers	Liste
DescribeGroups	Accorde l'autorisation de décrire les groupes d'utilisateurs	Liste
DescribeInstanceExports [autorisation uniquement]	Accorde l'autorisation de décrire l'historique des exportations pour une instance	Liste
DescribeInstances [autorisation uniquement]	Accorde l'autorisation de décrire les instances	Liste
DescribeNotificationPermissions [autorisation uniquement]	Accorde l'autorisation de décrire les principaux autorisés à s'abonner aux notifications d'appel APIs pour un site donné WorkDocs	Liste
DescribeNotificationSubscriptions	Accorde l'autorisation de répertorier les abonnements de notification spécifiés	Liste
DescribeResourcePermissions	Accorde l'autorisation d'afficher une description des autorisations de ressource spécifiées	Liste
DescribeRootFolders	Accorde l'autorisation de décrire les dossiers racine	Liste
DescribeUsers	Accorde l'autorisation d'afficher une description des utilisateurs spécifiés. Vous pouvez décrire tous les utilisateurs ou filtrer les résultats (par exemple, par statut ou organisation)	Liste
DownloadDocumentVersion [autorisation uniquement]	Accorde l'autorisation de télécharger une version de document spécifiée	Lecture
GetCurrentUser	Accorde l'autorisation de récupérer les détails de l'utilisateur actuel	Lecture
GetDocument	Accorde l'autorisation de récupérer l'objet de document spécifié	Lecture
GetDocumentPath	Accorde l'autorisation de récupérer les informations de chemin (la hiérarchie du dossier racine) pour le document demandé	Lecture
GetDocumentVersion	Accorde l'autorisation de récupérer la version des métadonnées du document spécifié	Lecture
GetFolder	Accorde l'autorisation de récupérer les métadonnées du dossier spécifié	Lecture
GetFolderPath	Accorde l'autorisation de récupérer les informations de chemin (la hiérarchie du dossier racine) pour le dossier spécifié	Lecture
GetGroup [autorisation uniquement]	Accorde l'autorisation de récupérer des détails pour le groupe spécifié	Lecture
GetResources	Accorde l'autorisation d'obtenir une collection de ressources	Lecture
InitiateDocumentVersionUpload	Accorde l'autorisation de créer un nouvel objet de document et un nouvel objet de version	Écrire
RegisterDirectory [autorisation uniquement]	Accorde l'autorisation d'enregistrer un répertoire	Écrire
RemoveAllResourcePermissions	Accorde l'autorisation de supprimer toutes les autorisations de la ressource spécifiée	Écrire
RemoveResourcePermission	Accorde l'autorisation de supprimer l'autorisation pour le principal spécifié de la ressource indiquée	Écrire
RestoreDocumentVersions	Accorde l'autorisation de restaurer les versions d'un document spécifié	Écrire
SearchResources	Accorde l'autorisation de rechercher les métadonnées et le contenu des ressources	Liste
StartInstanceExport [autorisation uniquement]	Accorde l'autorisation de démarrer une exportation pour une instance	Écrire	organization*
UpdateDocument	Accorde l'autorisation de mettre à jour les attributs spécifiés du document spécifié	Écrire
UpdateDocumentVersion	Accorde l'autorisation de modifier l'état de la version de document en ACTIVE	Écrire
UpdateFolder	Accorde l'autorisation de mettre à jour les attributs spécifiés du dossier spécifié	Écrire
UpdateInstanceAlias [autorisation uniquement]	Accorde l'autorisation de mettre à jour un alias d'instance	Écrire
UpdateUser	Accorde l'autorisation de mettre à jour les attributs spécifiés de l'utilisateur spécifié, et accorde ou révoque les privilèges administratifs au site Amazon WorkDocs	Écrire
UpdateUserAdministrativeSettings [autorisation uniquement]	Octroie l'autorisation de mettre à jour les paramètres administratifs d'un utilisateur.	Écrire

Types de ressources définis par Amazon WorkDocs

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
organization	arn:${Partition}:workdocs:${Region}:${Account}:organization/${ResourceId}

Clés de condition pour Amazon WorkDocs

WorkDocs ne possède aucune clé de contexte spécifique au service pouvant être utilisée dans l'Conditionélément des déclarations de politique. Pour accéder à la liste des clés de condition globales disponibles pour tous les services, consultez Clés de condition disponibles.