RAM authorization

Updated at:

Resource Access Management (RAM) is a service provided by Alibaba Cloud to manage user identities and resource access permissions. Using RAM helps you avoid sharing your Alibaba Cloud account keys with other users and allows you to grant users the least privilege access. RAM uses permission policies to define authorizations. This topic describes the actions, resources, and conditions that Hologres defines for RAM permission policies. The RamCode of Hologres is hologram , and the supported authorization granularity is RESOURCE . For the resource authorization scope of each action, see the Action table.

General structure of a policy

Permission policies support the JSON format. The following example shows the structure of a policy that uses the Action element. Values in angle brackets (<>) are placeholders. Replace them with actual values.

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "<Effect>",
      "Action": "<Action>",
      "Resource": "<Resource>",
      "Condition": {
        "<Condition_operator>": {
          "<Condition_key>": [
            "<Condition_value>"
          ]
        }
      }
    }
  ]
}        

The following list describes the fields and placeholders in the policy:

  • Effect: Specifies the authorization result. Valid values: Allow and Deny.

  • Action: Specifies one or more operations that are allowed or denied.

  • Resource: Specifies the specific objects affected by the operations. You can use Alibaba Cloud Resource Names (ARNs) to describe specific resources.

  • Condition: Specifies the conditions for the authorization to take effect. This field is optional.

  • Condition operator: Specifies the conditional operators. Different types of conditions support different conditional operators.

  • Condition_key: Specifies the condition keys.

  • Condition_value: Specifies the condition values.

Action

The following table lists the RAM actions defined by Hologres. These actions can be used in the Action element of RAM permission policies.

  • Action: A specific RAM permission point. In most cases, it has the same name as the corresponding OpenAPI.

  • OpenAPI: The OpenAPI associated with the RAM action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that support authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding ARN in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The product-level condition keys supported by the action. Common condition keys are not included. For more information, see Common condition keys.

  • Dependent action: Other action permissions required to perform the action.

Action

OpenAPI

Access level

Resource type

Condition key

Dependent action

hologram:GetInstanceModel GetInstanceModel get

*All Resource

*

None None
hologram:GetWarehouseDetail GetWarehouseDetail get

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:RevokeTablePermission RevokeTablePermission update

*All Resource

*

None None
hologram:GetUpgradeable GetUpgradeable get

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:MigrateInstanceZone MigrateInstanceZone update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:GetLastUpgradeRecord GetLastUpgradeRecord get

*All Resource

*

None None
hologram:RestartInstance RestartInstance update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:GetExecuteStatementEnabled GetExecuteStatementEnabled get

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:GrantDatabasePermission GrantDatabasePermission update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:ListInstanceModel ListInstanceModel none

*All Resource

*

None None
hologram:GrantTablePermission GrantTablePermission update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:ChangeResourceGroup ChangeResourceGroup update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:UpdateBackupDataDesc UpdateBackupDataDesc update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:ResumeHoloWarehouse ResumeHoloWarehouse update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:UpdateInstancePort UpdateInstancePort update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:ListInstances ListInstances list

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/*

None None
hologram:DeleteModelService DeleteModelService delete

*All Resource

*

None None
hologram:UpdateHoloWebLoginSetting UpdateHoloWebLoginSetting update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:UpdateInstanceNetworkType UpdateInstanceNetworkType update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:UpdateModelService UpdateModelService update

*All Resource

*

None None
hologram:DeleteBackupData DeleteBackupData delete

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:DisableSupportAccount DisableSupportAccount update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:ListWarehouseScheduleTask ListWarehouseScheduleTask list

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:ListWarehouses ListWarehouses list

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:UpdateMaintenanceWindow UpdateMaintenanceWindow update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:ListBackupData ListBackupData list

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:GetCertificateAttribute GetCertificateAttribute get

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:UntagResources UntagResources update

*All Resource

*

None None
hologram:RevokeDatabasePermission RevokeDatabasePermission update

*All Resource

*

None None
hologram:ListOperationEvents ListOperationEvents list

*All Resource

*

None None
hologram:DropUser DropUser delete

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#instanceId}

None None
hologram:UpgradeInstance UpgradeInstance update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:CreateDatabase CreateDatabase list

*All Resource

*

None None
hologram:GetUpgradeStatus GetUpgradeStatus get

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:UpdateScheduledBackupConfig UpdateScheduledBackupConfig update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:GetInstance GetInstance get

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:RebalanceHoloWarehouse RebalanceHoloWarehouse update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:DisableWarehouseAutoScale DisableWarehouseAutoScale update

*All Resource

*

None None
hologram:DeleteWarehouseScheduleTask DeleteWarehouseScheduleTask delete

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:CreateHoloWarehouse CreateHoloWarehouse create

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:CreateWarehouse CreateWarehouse create

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:ScaleHoloWarehouse ScaleHoloWarehouse update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:CreateModelService CreateModelService create

*All Resource

*

None None
hologram:ListModelCatalog ListModelCatalog list

*All Resource

*

None None
hologram:ListLeaderInstances ListLeaderInstances list

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:GrantSchemaPermission GrantSchemaPermission list

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:BindLeaderInstance BindLeaderInstance update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:PrepareUpgrade PrepareUpgrade update

*HoloInstance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:RenewInstance RenewInstance update

*All Resource

*

None None
hologram:DeleteInstance DeleteInstance delete

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:RestartHoloWarehouse RestartHoloWarehouse update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:CreateWarehouseScheduleTask CreateWarehouseScheduleTask create

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:EnableHiveAccess EnableHiveAccess update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:DeleteHoloWarehouse DeleteHoloWarehouse delete

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:DescribeTags DescribeTags get

*All Resource

*

None None
hologram:EnableSSL EnableSSL none

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:ScaleInstance ScaleInstance update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:RenewSSLCertificate RenewSSLCertificate none

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:ListMigrationZones ListMigrationZones list

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:GetHoloWebLoginSetting GetHoloWebLoginSetting get

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:DiscardUpgrade DiscardUpgrade delete

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:RevokeSchemaPermission RevokeSchemaPermission update

*All Resource

*

None None
hologram:RenameHoloWarehouse RenameHoloWarehouse update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:UpdateAutoUpgrade UpdateAutoUpgrade update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:GetScheduledBackupConfig GetScheduledBackupConfig get

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:ListFollowerInstances ListFollowerInstances list

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:DisableExecuteStatement DisableExecuteStatement none

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:UpdateOperationEventScheduleTime UpdateOperationEventScheduleTime update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:DisableHiveAccess DisableHiveAccess update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:EnableExecuteStatement EnableExecuteStatement none

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:ListUpgradeReleaseVersions ListUpgradeReleaseVersions list

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:CreateManualBackup CreateManualBackup create

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:SuspendHoloWarehouse SuspendHoloWarehouse update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:TagResources TagResources update

*All Resource

*

None None
hologram:UnBindLeaderInstance UnBindLeaderInstance update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:DeleteModelResource DeleteModelResource delete

*All Resource

*

None None
hologram:EnableWarehouseAutoScale EnableWarehouseAutoScale create

*All Resource

*

None None
hologram:StopInstance StopInstance update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:CreateUser CreateUser create

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:ListDatabases ListDatabases list

*All Resource

*

None None
hologram:GetRootCertificate GetRootCertificate none

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:ExecuteStatement ExecuteStatement none

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:DisableSSL DisableSSL none

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:CreateExternalDatabase CreateExternalDatabase list

*All Resource

*

None None
hologram:ResumeInstance ResumeInstance update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:UpdateInstanceName UpdateInstanceName update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:ListRegions ListRegions list

*All Resource

*

None None
hologram:CreateInstance CreateInstance create

*All Resource

*

None None
hologram:EnableSupportAccount EnableSupportAccount update

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:DisableOperationEvent DisableOperationEvent update

*All Resource

*

None None
hologram:ListWarehouseScheduleEvent ListWarehouseScheduleEvent list

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None
hologram:UpdateWarehouseScheduleTask UpdateWarehouseScheduleTask create

*Instance

acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

None None

Resource

The following table lists the resource types and ARN formats defined by Hologres. The Resource element of RAM policy statements specifies the resources to which the statement applies. Notes:

  • {#} in an ARN is a variable placeholder. Replace it with the actual value. For example, replace {#ramcode} with the actual RAM code of the cloud service.

  • * in an ARN indicates all. For example:

    • {#resourceType} set to *: all resources.

    • {#regionId} set to *: all regions.

    • {#accountId} set to *: all Alibaba Cloud accounts.

Resource type

ARN

Instance
  • acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}
  • acs:hologram:{#regionId}:{#accountId}:instance/*
  • acs:hologram:*:{#accountId}:instance/*
  • acs:hologram:*:{#accountId}:instance/{#InstanceId}
HoloInstance
  • acs:hologram:{#regionId}:{#accountId}:instance/{#InstanceId}

Condition

Hologres does not define product-level condition keys. However, you can use Alibaba Cloud common condition keys for access control. For more information, see Common condition keys.

References

For information about conditional operators, custom policies, and authorization operations, see the following documents: