RAM authorization

Updated at:
Copy as MD

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 general structure of a RAM policy, and the policy statement elements (Action, Resource, and Condition) defined by Function Compute for RAM permission policies. The RAM code (RamCode) for Function Compute is agentrun , and the supported authorization granularity is RESOURCE .

General structure of a policy

Permission policies support JSON format with the following general structure:

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

The following list describes the fields in the policy:

  • Version: Specifies the policy version number. It is fixed at 1.

  • Statement:

    • 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 actions defined by Function Compute. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the 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 condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys that are applicable across all RAM-integrated services. For more information, see Common condition keys.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

API

Access level

Resource type

Condition key

Dependent action

agentrun:CreateIMBot CreateIMBot create

*All Resource

*

None None
agentrun:UpdateFlowDraft UpdateFlowDraft update

*Flow

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/flows/{#flowId}

None None
agentrun:UpdateWorkspace UpdateWorkspace update

*Workspace

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}

None None
agentrun:GetTemplate GetTemplate get

*All Resource

*

None None
agentrun:GetModelProxy GetModelProxy get

*All Resource

*

None None
agentrun:DeleteBrowser DeleteBrowser delete

*All Resource

*

None None
agentrun:CreateCredential CreateCredential create

*All Resource

*

None None
agentrun:DeleteCredential DeleteCredential delete

*Credential

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/credentials/{#credentialName}

None None
agentrun:ResumeSandbox ResumeSandbox update

*All Resource

*

None None
agentrun:DeleteSandbox DeleteSandbox delete

*All Resource

*

None None
agentrun:DeleteCustomDomain DeleteCustomDomain delete

*All Resource

*

None None
agentrun:DeleteWorkspace DeleteWorkspace delete

*Workspace

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}

None None
agentrun:CreateFlow CreateFlow create

*Flow

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/flows/*

None None
agentrun:DeleteModelProxy DeleteModelProxy delete

*All Resource

*

None None
agentrun:GetSandbox GetSandbox get

*All Resource

*

None None
agentrun:DeleteAgentRuntimeEndpoint DeleteAgentRuntimeEndpoint delete

*Endpoint

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/runtimes/{#runtimeName}/runtime-endpoints/{#endpointName}

None None
agentrun:StopTemplateMCP StopTemplateMCP update

*All Resource

*

None None
agentrun:CreateKnowledgeBase CreateKnowledgeBase create

*Knowledgebase

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/knowledgebases/*

None None
agentrun:UpdateTool UpdateTool update

*Tool

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/tools/{#toolName}

None None
agentrun:GetBrowser GetBrowser get

*All Resource

*

None None
agentrun:GetAccessToken GetAccessToken get

*All Resource

*

None None
agentrun:GetFlow GetFlow get

*Flow

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/flows/{#flowId}

None None
agentrun:ListModelServices ListModelServices list

*ModelService

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/model-services/*

None None
agentrun:ListTemplates ListTemplates list

*All Resource

*

None None
agentrun:ListIMBots ListIMBots list

*All Resource

*

None None
agentrun:GetFlowEndpoint GetFlowEndpoint get

*All Resource

*

None None
agentrun:ListModelProxies ListModelProxies list

*All Resource

*

None None
agentrun:GetCredential GetCredential get

*Credential

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/credentials/{#credentialName}

None None
agentrun:GetModelService GetModelService get

*ModelService

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/model-services/{#modelServiceName}

None None
agentrun:GetFlowDraft GetFlowDraft get

*Flow

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/flows/{#flowId}

None None
agentrun:GetCodeInterpreter GetCodeInterpreter get

*All Resource

*

None None
agentrun:GetAgentRuntimeEndpoint GetAgentRuntimeEndpoint get

*Agent

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/runtimes/{#runtimeName}/runtime-endpoints/{#endpointName}

None None
agentrun:UpdateModelService UpdateModelService update

*All Resource

*

None None
agentrun:ListTools ListTools list

*All Resource

*

None None
agentrun:ListCredentials ListCredentials list

*Credential

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/credentials/*

None None
agentrun:GetMemoryCollection GetMemoryCollection get

*All Resource

*

None None
agentrun:ListFlowVersions ListFlowVersions list

*Flow

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/flows/{#flowId}

None None
agentrun:DeleteMemoryCollection DeleteMemoryCollection delete

*All Resource

*

None None
agentrun:UpdateAgentRuntimeEndpoint UpdateAgentRuntimeEndpoint update

*Endpoint

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/runtimes/{#runtimeName}/runtime-endpoints/{#endpointName}

None None
agentrun:CreateModelService CreateModelService create

*All Resource

*

None None
agentrun:DeleteAgentRuntime DeleteAgentRuntime delete

*Agent

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/runtimes/{#runtimeName}

None None
agentrun:DeleteFlowVersion DeleteFlowVersion delete

*Flow

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/flows/{#flowId}

None None
agentrun:ListAgentRuntimes ListAgentRuntimes list

*Agent

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/runtimes/*

None None
agentrun:GetIMBot GetIMBot get

*IMBot

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/runtimes/{#runtimeName}/im-bots/{#botName}

None None
agentrun:CreateTemplate CreateTemplate create

*All Resource

*

None None
agentrun:GetFlowVersion GetFlowVersion get

*Flow

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/flows/{#flowId}

None None
agentrun:ListModelProviders ListModelProviders list

*All Resource

*

None None
agentrun:DeleteTemplate DeleteTemplate delete

*All Resource

*

None None
agentrun:UpdateFlow UpdateFlow update

*Flow

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/flows/{#flowId}

None None
agentrun:ListMemoryCollections ListMemoryCollections list

*All Resource

*

None None
agentrun:ListFlowEndpoints ListFlowEndpoints list

*All Resource

*

None None
agentrun:CreateCustomDomain CreateCustomDomain create

*All Resource

*

None None
agentrun:UpdateWorkspaceDiscoveryEndpoints UpdateWorkspaceDiscoveryEndpoints update

*Workspace

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}

None None
agentrun:UpdateMemoryCollection UpdateMemoryCollection update

*All Resource

*

None None
agentrun:ListKnowledgeBases ListKnowledgeBases list

*Knowledgebase

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/knowledgebases/*

None None
agentrun:ActivateTemplateMCP ActivateTemplateMCP update

*All Resource

*

None None
agentrun:ConvertFlowDSL ConvertFlowDSL create

*Flow

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/flows/*

None None
agentrun:CreateModelProxy CreateModelProxy create

*All Resource

*

None None
agentrun:DeleteFlow DeleteFlow delete

*Flow

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/flows/{#flowId}

None None
agentrun:GetCustomDomain GetCustomDomain get

*All Resource

*

None None
agentrun:CreateAgentRuntime CreateAgentRuntime create

*Agent

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/runtimes/*

None None
agentrun:ListCustomDomains ListCustomDomains list

*All Resource

*

None None
agentrun:ListWorkspaces ListWorkspaces get

*All Resource

*

None None
agentrun:CreateAgentRuntimeEndpoint CreateAgentRuntimeEndpoint create

*All Resource

*

None None
agentrun:UpdateAgentRuntime UpdateAgentRuntime update

*Agent

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/runtimes/{#runtimeName}

None None
agentrun:PublishRuntimeVersion PublishRuntimeVersion none

*Agent

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/runtimes/{#runtimeName}

None None
agentrun:CreateBrowser CreateBrowser create

*All Resource

*

None None
agentrun:GetTool GetTool get

*Tool

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/tools/{#toolName}

None None
agentrun:CreateSandbox CreateSandbox create

*All Resource

*

None None
agentrun:UpdateModelProxy UpdateModelProxy update

*All Resource

*

None None
agentrun:DeleteModelService DeleteModelService delete

*All Resource

*

None None
agentrun:ListCodeInterpreters ListCodeInterpreters list

*All Resource

*

None None
agentrun:ListAgentRuntimeVersions ListAgentRuntimeVersions list

*All Resource

*

None None
agentrun:ListSandboxes ListSandboxes list

*All Resource

*

None None
agentrun:PauseSandbox PauseSandbox update

*All Resource

*

None None
agentrun:DeleteCodeInterpreter DeleteCodeInterpreter delete

*All Resource

*

None None
agentrun:CreateWorkspace CreateWorkspace create

*All Resource

*

None None
agentrun:CreateCodeInterpreter CreateCodeInterpreter create

*All Resource

*

None None
agentrun:ListAgentRuntimeEndpoints ListAgentRuntimeEndpoints list

*All Resource

*

None None
agentrun:PublishFlowVersion PublishFlowVersion create

*Flow

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/flows/{#flowId}

None None
agentrun:UpdateTemplate UpdateTemplate update

*All Resource

*

None None
agentrun:UpdateIMBot UpdateIMBot update

*IMBot

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/runtimes/{#runtimeName}/im-bots/{#botName}

None None
agentrun:UpdateKnowledgeBase UpdateKnowledgeBase update

*Knowledgebase

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/knowledgebases/{#knowledgeBaseName}

None None
agentrun:StopSandbox StopSandbox delete

*All Resource

*

None None
agentrun:CreateMemoryCollection CreateMemoryCollection create

*All Resource

*

None None
agentrun:UpdateCredential UpdateCredential update

*Credential

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/credentials/{#credentialName}

None None
agentrun:GetWorkspace GetWorkspace get

*Workspace

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}

None None
agentrun:DeleteIMBot DeleteIMBot delete

*IMBot

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/runtimes/{#runtimeName}/im-bots/{#botName}

None None
agentrun:CreateTool CreateTool create

*Tool

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/tools/*

None None
agentrun:ListBrowsers ListBrowsers list

*All Resource

*

None None
agentrun:CreateFlowEndpoint CreateFlowEndpoint create

*All Resource

*

None None
agentrun:GetKnowledgeBase GetKnowledgeBase get

*Knowledgebase

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/knowledgebases/{#knowledgeBaseName}

None None
agentrun:ListFlows ListFlows list

*Flow

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/flows/*

None None
agentrun:DeleteKnowledgeBase DeleteKnowledgeBase delete

*Knowledgebase

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/knowledgebases/{#knowledgeBaseName}

None None
agentrun:GetAgentRuntime GetAgentRuntime get

*Agent

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/runtimes/{#runtimeName}

None None
agentrun:GetWorkspaceDiscoveryEndpoints GetWorkspaceDiscoveryEndpoints get

*Workspace

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}

None None
agentrun:UpdateCustomDomain UpdateCustomDomain update

*All Resource

*

None None
agentrun:DeleteTool DeleteTool delete

*Tool

acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/tools/{#toolName}

None None

Resource

The following table lists the resources defined by Function Compute. Specify them in the Resource element of RAM policy statements to grant permissions for specific operations. They are uniquely identified by ARNs. Format: acs:{#ramcode}:{#regionId}:{#accountId}:{#resourceType}:

  • acs: The initialism of Alibaba Cloud service, which indicates the public cloud of Alibaba Cloud.

  • {#ramcode}: The code used in RAM to indicate an Alibaba Cloud service.

  • {#regionId}: The . If the resource covers all regions, set it to an asterisk (*).

  • {#accountId}: The ID of the Alibaba Cloud account. If the resource covers all Alibaba Cloud accounts, set it to an asterisk (*).

  • {#resourceType}: The service-defined resource identifier. It supports a hierarchical structure, which is similar to a file path. If the statement covers global resources, set it to an asterisk (*).

Resource type

ARN

IMBot
  • acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/runtimes/{#runtimeName}/im-bots/{#botName}
Flow
  • acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/flows/{#flowId}
  • acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/flows/*
Workspace
  • acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}
  • acs:agentrun:{#regionId}:{#accountId}:workspaces/*
SandboxTemplate
  • acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/template/{#templateName}
  • acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/template/*
ModelProxy
  • acs:agentrun:{#regionId}:{#accountId}:modelproxy/*
Credential
  • acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/credentials/{#credentialName}
  • acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/{#resourceType}/{#resourceName}
  • acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/credentials/*
Endpoint
  • acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/runtimes/{#runtimeName}/runtime-endpoints/{#endpointName}
Knowledgebase
  • acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/knowledgebases/*
  • acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/knowledgebases/{#knowledgeBaseName}
Tool
  • acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/tools/{#toolName}
  • acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/tools/*
ModelService
  • acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/model-services/*
  • acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/model-services/{#modelServiceName}
  • acs:agentrun:{#regionId}:{#accountId}:modelservice/*
FlowEndpoint
  • acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/flows/{#flowId}/endpoints/{#flowEndpointId}
  • acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/flows/{#flowId}/endpoints/*
Agent
  • acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/runtimes/{#runtimeName}/runtime-endpoints/{#endpointName}
  • acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/runtimes/{#runtimeName}
  • acs:agentrun:{#regionId}:{#accountId}:workspaces/{#workspaceName}/runtimes/*
MemoryCollection
  • acs:agentrun:{#regionId}:{#accountId}:memorycollection/*

Condition

Function Compute 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.

How to create custom RAM policies?

You can create custom policies and grant them to RAM users, RAM user groups, or RAM roles. For instructions, see: