Actions, ressources et clés de condition pour les vecteurs Amazon S3

Amazon S3 Vectors (préfixe de service :s3vectors) 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 S3 Vectors

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 Niveau d'accès du tableau Actions décrit la manière dont l'action est classée (liste, lecture, gestion des autorisations ou balisage). Cette classification peut vous aider à comprendre le niveau d'accès accordé par une action utilisée dans une politique. Pour plus d'informations sur les niveaux d'accès, consultez la section Niveaux d'accès dans les résumés des politiques.

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.

La colonne Actions dépendantes du tableau Actions indique les autorisations supplémentaires requises pour lancer une action avec succès. Ces autorisations sont nécessaires en plus de l'autorisation pour l'action elle-même. Lorsqu'une action spécifie des actions dépendantes, ces dépendances peuvent s'appliquer à des ressources supplémentaires définies pour cette action, et pas uniquement à la première ressource répertoriée dans le tableau.

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
CreateIndex	Accorde l'autorisation de créer un nouvel index vectoriel dans un compartiment vectoriel spécifié	Écrire	Index*
CreateVectorBucket	Accorde l'autorisation de créer un nouveau bucket vectoriel	Écrire	VectorBucket*
				s3vectors:sseType s3vectors:kmsKeyArn
DeleteIndex	Accorde l'autorisation de supprimer un index vectoriel spécifié	Écrire	Index*
DeleteVectorBucket	Accorde l'autorisation de supprimer un compartiment vectoriel spécifié	Écrire	VectorBucket*
DeleteVectorBucketPolicy	Accorde l'autorisation de supprimer la politique de ressources IAM d'un bucket vectoriel spécifié	Gestion des autorisations	VectorBucket*
DeleteVectors	Accorde l'autorisation de supprimer un lot de vecteurs d'un index vectoriel spécifié	Écrire	Index*
GetIndex	Accorde l'autorisation d'obtenir les attributs d'un index vectoriel spécifié	Lecture	Index*
GetVectorBucket	Accorde l'autorisation d'obtenir les attributs d'un bucket vectoriel spécifié	Lecture	VectorBucket*
GetVectorBucketPolicy	Accorde l'autorisation d'obtenir la politique de ressources IAM pour un bucket vectoriel spécifique	Lecture	VectorBucket*
GetVectors	Accorde l'autorisation d'obtenir un lot de vecteurs à l'aide de leurs clés vectorielles	Lecture	Index*
ListIndexes	Accorde l'autorisation d'obtenir une liste paginée de tous les index d'un compartiment vectoriel spécifié	Liste	VectorBucket*
ListVectorBuckets	Permet d'obtenir une liste paginée de tous les compartiments vectoriels du compte	Liste
ListVectors	Accorde l'autorisation d'obtenir une liste paginée de tous les vecteurs dans un index vectoriel spécifié	Liste	Index*		s3vectors:GetVectors
PutVectorBucketPolicy	Accorde l'autorisation d'ajouter une politique de ressources IAM à un compartiment vectoriel spécifié	Gestion des autorisations	VectorBucket*
PutVectors	Accorde l'autorisation d'ajouter un lot de vecteurs à un index vectoriel spécifié	Écrire	Index*
QueryVectors	Accorde l'autorisation de trouver les voisins les plus proches approximatifs dans un index de vecteur de recherche spécifié pour un vecteur de requête donné	Lecture	Index*		s3vectors:GetVectors

Types de ressources définis par Amazon S3 Vectors

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
Index	arn:${Partition}:s3vectors:${Region}:${Account}:bucket/${BucketName}/index/${IndexName}
VectorBucket	arn:${Partition}:s3vectors:${Region}:${Account}:bucket/${BucketName}

Clés de condition pour les vecteurs Amazon S3

Amazon S3 Vectors définit les clés de condition suivantes qui peuvent être utilisées dans l'Conditionélément d'une politique 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 la section Clés contextuelles de condition AWS globales.

Clés de condition	Description	Type
s3vectors:kmsKeyArn	Filtre l'accès par l'ARN de la clé AWS KMS pour la clé utilisée pour chiffrer un bucket vectoriel	ARN
s3vectors:sseType	Filtre l'accès par type de chiffrement côté serveur	Chaîne