Help Center/ Object Storage Service/ API Reference/ Permissions and Supported Actions/ Introduction
Updated on 2024-04-03 GMT+08:00
View PDF
Share

Introduction

This section describes fine-grained permissions management for your OBS. If your Huawei Cloud account does not require individual IAM users, skip this section.

By default, new IAM users do not have any permissions assigned. You need to add a user to one or more groups, and attach permissions policies or roles to these groups. Users inherit permissions from the groups to which they are added and can perform specified operations on cloud services based on the permissions.

For details about policies and roles related to OBS in IAM, see Permissions Management. For more information about the syntax structure and examples of IAM permissions, see IAM Permissions.

You can grant users permissions by using roles and policies. Roles are a type of coarse-grained authorization mechanism that defines permissions related to user responsibilities. Policies define API-based permissions for operations on specific resources under certain conditions, allowing for more fine-grained, secure access control of cloud resources.

  • Policy-based authorization is useful if you want to allow or deny the access to an API.
  • Because of the cache, it takes about 10 to 15 minutes for the OBS role to take effect after being granted to users, enterprise projects, and user groups. After an OBS policy is granted, it takes about 5 minutes for the policy to take effect.

An account has all of the permissions required to call all APIs, but IAM users must have the required permissions specifically assigned. The required permissions are determined by the actions supported by the API. Only users with the policies allowing for those actions can call the API successfully. For example, if an IAM user needs to create buckets using an API, the user must have been granted permissions that allow the obs:bucket:CreateBucket action.

Supported Actions

There are two kinds of policies: system-defined policies and custom policies. If the permissions preset in the system do not meet your requirements, you can create custom policies and apply these policies to user groups for refined access control. Operations supported by policies are specific to APIs. The following are common concepts related to policies:

  • Permissions: statements in a policy that allow or deny certain operations
  • APIs: REST APIs that can be called by a user who has been granted specific permissions
  • Actions: specific operations that are allowed or denied in a custom policy
  • IAM projects/Enterprise projects: the authorization scope of a custom policy. A custom policy can be applied to IAM projects or enterprise projects or both. Policies that contain actions for both IAM and enterprise projects can be used and applied for both IAM and Enterprise Management. Policies that contain actions only for IAM projects can be used and applied to IAM only. For differences between IAM projects and enterprise projects, see What Are the Differences Between IAM and Enterprise Management?

    The check mark (√) indicates that an action takes effect. The cross mark (x) indicates that an action does not take effect.

OBS supports the following actions in custom policies:

  • Bucket-related actions include actions supported by all OBS bucket-related APIs, such as the APIs for listing all buckets, creating and deleting buckets, configuring bucket policies, configuring cross-region replication, and configuring bucket logging.
  • Object-related actions include APIs for uploading, downloading, and deleting objects.