Actions, resources, and condition keys for Amazon S3 Vectors
Amazon S3 Vectors (service prefix: s3vectors) provides the following
service-specific operations, resources, actions, and condition keys for use in IAM permission
policies.
References:
-
Learn how to configure this service.
-
View a list of the API operations available for this service.
-
Learn how to secure this service and its resources by using IAM permission policies.
-
View the programmatic service authorization reference
for this service.
Topics
Actions defined by Amazon S3 Vectors
You can specify the following actions in the Action element of an IAM
policy statement. Use policies to grant permissions to perform an operation in AWS. When
you use an action in a policy, you usually allow or deny access to the API operation or CLI
command with the same name. However, in some cases, a single action controls access to more
than one operation. Alternatively, some operations require several different actions.
| Actions | Description | Resource types (*required) | Condition keys | Access level |
|---|---|---|---|---|
Grants permission to create a new vector index within a specified vector bucket |
Write |
|||
Grants permission to create a new vector bucket |
Write |
|||
Grants permission to delete a specified vector index |
Write |
|||
Grants permission to delete a specified vector bucket |
Write |
|||
Grants permission to delete the IAM resource policy from a specified vector bucket |
Permissions management, Write |
|||
Grants permission to delete a batch of vectors from a specified vector index |
Write |
|||
Grants permission to get the attributes of a specified vector index |
Read |
|||
Grants permission to get the attributes of a specified vector bucket |
Read |
|||
Grants permission to get the IAM resource policy for a specific vector bucket |
Read |
|||
Grants permission to get a batch of vectors by their vector keys |
Read |
|||
Grants permission to get a paginated list of all indexes in a specified vector bucket |
List |
|||
Grants permission to list tags for specified S3Vector resource |
List |
|||
Grants permission to get a paginated list of all vector buckets in the account |
List |
|||
Grants permission to get a paginated list of all vectors in a specified vector index |
List |
|||
Grants permission to add an IAM resource policy to a specified vector bucket |
Permissions management, Write |
|||
Grants permission to add a batch of vectors to a specified vector index |
Write |
|||
Grants permission to find approximate nearest neighbors within a specified search vector index for a given query vector |
Read |
|||
Grants permission to tag a S3Vector resource |
Tagging, Write |
|||
Grants permission to untag a S3Vector resource |
Tagging, Write |
|||
Resource types defined by Amazon S3 Vectors
The following resource types are defined by this service and can be used in the
Resource element of IAM permission policy statements.
| Resource types | ARN | Condition keys |
|---|---|---|
arn:${Partition}:s3vectors:${Region}:${Account}:bucket/${BucketName}/index/${IndexName} |
||
arn:${Partition}:s3vectors:${Region}:${Account}:bucket/${BucketName} |
Condition keys for Amazon S3 Vectors
Amazon S3 Vectors defines the following condition keys that can be used in the
Condition element of an IAM policy.
| Condition keys | Description | Type |
|---|---|---|
Filters access by the tags that are passed in the request |
String |
|
Filters access by the tags associated with the resource |
String |
|
Filters access by the tag keys that are passed in the request |
ArrayOfString |
|
Filters access by the tags associated with the vector bucket |
String |
|
Filters access by the AWS KMS key ARN for the key used to encrypt a vector bucket |
ARN |
|
Filters access by server-side encryption type |
String |