Skip to main content

Manage S3 access

Access to S3 resources is regulated by:

When an S3 action request is received, the user role is checked first. If the role is:

  • does not allow the action — access is denied;

  • allows the action — the presence and settings of the bucket policy are checked. If the bucket policy:

To access via API, automation tools, and FTP, use keys.

Learn more about access management in the Overview of access management in Selectel products guide.

Access within projects

All resources in S3 are created in a specific project. You can group resources by different projects and configure user permissions depending on which projects they need access to.

Access within roles

Access to S3 is granted by S3 roles and global roles. Learn more about role types in the Role reference.

Role groupRoleAccess
S3 roless3.adminManage all buckets in a project
s3.userManage a specific bucket and view the list of buckets
s3.bucket.userManage a specific bucket
data_migration.adminManage migrations in S3
data_migration.userView and run migrations in S3
data_migration.viewerView migrations in S3
object_storage:adminManage all buckets in the project
object_storage_userManage a specific bucket
Global rolesmemberManage S3 and other products, account, billing, and projects
billingManage billing in S3 and other products
iam.adminManage access to S3 and other products
iam.viewerView access to S3 and other products
readerView resources of S3 and all products, account, billing, and projects

S3 roles

s3.admin

The s3.admin role provides access to managing S3 within a project. It has no access to S3 in other projects or to other products in its project.

Access scopesProject
Assignable to
  • panel users;
  • service users
Available operations in S3
  • viewing the list of buckets in your project;

  • viewing the contents of buckets in your project;

  • managing buckets in your project:

    • creating buckets;
    • managing objects in buckets (uploading, modifying settings, deleting);
    • modifying bucket settings (managing versioning, enabling Object Lock, changing bucket type and addressing, configuring limits) *;
    • deleting buckets

* Managing access policies and bypassing temporary Object Lock restrictions in the control panel is not available.

s3.user

The s3.user role grants access to the S3 bucket if an access policy is configured in it that allows this user access to the bucket. The level of access is determined by the access policy settings. Does not have access to S3 in other projects or to other products within your project.

Access scopesProject
Who can be assigned toService users
Available operations in S3
  • viewing the list of buckets in your project;
  • operations in the bucket that are allowed by the access policy

s3.bucket.user

The s3.bucket.user role grants access to the S3 bucket if an access policy is configured in it that allows this user access to the bucket. The level of access is determined by the access policy settings. Does not have access to S3 in other projects or to other products within your project.

Access scopesProject
Who can be assigned toService users
Available operations in S3Operations in the bucket that are allowed by the access policy

data_migration.admin

The data_migration.admin role grants access to managing S3 migrations.

Access scopes
  • account;
  • project
Who can be assigned
  • console users;
  • service users;
  • user groups
Available operations in S3

In the Account access scope:

  • managing migrations (creation, modification, deletion) across all projects;
  • viewing the list of migrations and details for each migration across all projects;
  • checking connections to source and destination buckets across all projects;
  • managing migration execution (start, stop) across all projects

In the Project access scope:

  • managing migrations (creation, modification, deletion) within your project;
  • viewing the list of migrations and details for each migration within your project;
  • checking connections to source and destination buckets within your project;
  • managing migration execution (start, stop) within your project

data_migration.user

The data_migration.user role grants access to viewing created S3 migrations and managing their execution.

Access scopes
  • account;
  • project
Can be assigned to
  • control panel users;
  • service users;
  • user groups
Available operations in S3

In the Account access scope:

  • viewing the list of migrations and information about each migration across all projects;
  • checking connections to source and destination buckets across all projects;
  • managing migration execution (start, stop) across all projects

In the Project access scope:

  • viewing the list of migrations and information about each migration within your project;
  • checking connections to source and destination buckets within your project;
  • managing migration execution (start, stop) within your project

data_migration.viewer

The data_migration.viewer role grants access to view everything managed by data_migration.admin.

Access scopes
  • account;
  • project
Can be assigned to
  • control panel users;
  • service users;
  • user groups
Available operations in S3

In the Account access scope:

  • viewing the list of migrations and information about each migration across all projects

In the Project access scope:

  • viewing the list of migrations and information about each migration in your project

object_storage.admin

For your information

The object_storage:admin role will be deprecated soon and cannot be assigned to new users. Existing users with the object_storage:admin role can continue working.

Deprecated version of the s3.admin role. Has identical permissions.

object_storage_user

For your information

The object_storage_user role will be deprecated soon and cannot be assigned to new users. Existing users with the object_storage_user role can continue working.

Deprecated version of the s3.user role. Has identical permissions.

Global roles

member

The member role provides full access to all services. It does not provide access to managing panel users, service users, user groups, and federations.

Access scopes
  • account;
  • project
Who it can be assigned to
  • users;
  • service users;
  • user groups
Available operations in S3

In the Account access scope:

  • viewing the list of buckets across all projects;

  • managing buckets across all projects:

    • creation of buckets;
    • modification of bucket settings (managing access policies, versioning, enabling Object Lock, changing bucket type and addressing, configuring limits);
    • management of objects in buckets (uploading, modifying settings, deletion);
    • bypassing the temporary lock of Governance mode (Object Lock);
  • management of projects, their limits, and quotas;

  • billing management and viewing consumption;

  • exporting audit logs

In the Project access scope:

  • viewing the list of buckets in your project;

  • management of buckets in your project:

    • creation of buckets;
    • modification of bucket settings (managing access policies, versioning, enabling Object Lock, changing bucket type and addressing, configuring limits);
    • management of objects in buckets (uploading, modifying settings, deletion);
    • bypassing the temporary lock of Governance mode (Object Lock)

billing

The billing role provides access to billing management without access to service management.

Access scopesAccount
Who can be assigned to
  • panel users;
  • service users;
  • user groups
Available operations in S3
  • billing management;
  • viewing S3 consumption

iam.admin

The iam.admin role provides access to user management and does not provide access to product and billing management. It does not allow managing your own account: changing permissions, managing notifications, or deleting a user. The first user with the iam.admin role is created by the Account owner.

ScopesAccount
Who can be assigned to
  • users;
  • service users;
  • user groups
Available operations in S3

iam.viewer

The iam.viewer role provides access to view everything managed by iam.admin.

ScopesAccount
Who can be assigned to
  • users;
  • service users;
  • user groups
Available operations in S3Viewing panel users, service users, and user groups

reader

The reader role provides access to view everything managed by member within the same scope.

Scopes
  • account;
  • project
Who can be assigned
  • users;
  • service users;
  • user groups
Available operations in S3

In the Account access scope:

  • viewing buckets across all projects:

    • viewing the list of buckets;
    • viewing bucket settings;
    • viewing objects in buckets;
  • viewing all projects, their limits, and quotas;

  • viewing billing and usage data

In the Project access scope:

  • viewing the list of buckets in your project;

  • viewing buckets in your project:

    • viewing the list of buckets;
    • viewing bucket settings;
    • viewing objects in buckets

API Access Keys

Depending on the API type, the user will need: