All Products
Search
Document Center

Object Storage Service:Create Object FC Access Points

Last Updated:Mar 20, 2026

To process object data at read time — such as image transcoding, data masking, or format conversion — without modifying client code, use an Object FC Access Point. When a GetObject request arrives at the access point alias, OSS automatically triggers your Function Compute function, which processes the object and returns the transformed result to the caller.

This topic describes how to create an Object FC Access Point using the console or the REST API.

Prerequisites

Before you begin, ensure that you have:

  • A bucket in a supported region: China (Hangzhou), China (Shanghai), China (Qingdao), China (Beijing), China (Zhangjiakou), China (Hohhot), China (Shenzhen), China (Chengdu), China (Hong Kong), US (Silicon Valley), US (Virginia), Japan (Tokyo), South Korea (Seoul), Singapore, Malaysia (Kuala Lumpur), Indonesia (Jakarta), Germany (Frankfurt), or UK (London)

  • An OSS access point created in the same region as the bucket — this becomes the Supporting Access Point. See Create an access point

  • Function Compute activated in the same region as the bucket. See Create a service

  • The oss:WriteGetObjectResponse permission granted to the AliyunFCDefaultRole service-linked role. Add the following policy to the role. See Grant permissions to a RAM role:

      {
        "Statement": [
          {
            "Action": "oss:WriteGetObjectResponse",
            "Effect": "Allow",
            "Resource": "*"
          }
        ],
        "Version": "1"
      }
  • A function created in Function Compute. Function Compute can be triggered when you call GetObject using OSS SDK for Java, Python, or Go. Match the function runtime to the SDK you plan to use: Keep all other function parameters at their defaults. See Create a function

    SDKRequired runtime
    OSS SDK for JavaJava 11
    OSS SDK for PythonPython 3.10
    OSS SDK for GoGo 1
  • A RAM user with the following permissions: oss:CreateAccessPointForObjectProcess, oss:GetAccessPointForObjectProcess, oss:DeleteAccessPointForObjectProcess, oss:ListAccessPointsForObjectProcess, oss:PutAccessPointConfigForObjectProcess, oss:GetAccessPointConfigForObjectProcess, oss:PutAccessPointPolicyForObjectProcess, oss:GetAccessPointPolicyForObjectProcess, and oss:DeleteAccessPointPolicyForObjectProcess. See Common examples of RAM policies

Limits

ConstraintDetails
Creation methodOSS console or API only. OSS SDKs and ossutil are not supported.
Quota per Alibaba Cloud account1,000
Quota per bucket100
Modifications after creationPolicy only. The name and alias cannot be changed.
Anonymous accessNot supported

Create an Object FC Access Point in the console

  1. Log on to the OSS console.

  2. In the left navigation pane, click Object FC Access Points.

  3. Click Create Object FC Access Point.

  4. Configure the following parameters and click OK.

    ParameterDescription
    RegionThe region where the access point is located.
    Object FC Access Point NameA name for the access point. The name can be up to 63 characters, contain only lowercase letters, digits, and hyphens (-), not start or end with a hyphen, and be unique within the region.
    Supporting Access PointThe existing OSS access point to associate with this Object FC Access Point.
    Bucket NameDisplayed automatically based on the selected access point.
    OSS APISelect GetObject.
    Function to InvokeSelect the function you created and then select Support Range GetObject Requests.
    Function Version(Optional) Select a specific version of the function. Defaults to LATEST.
  5. Complete role authorization. The first time you create an Object FC Access Point, click RAM Quick Authorization and follow the on-screen instructions to authorize the AliyunOSSObjectFcForOSSDefaultRole role to access your OSS and Function Compute resources. Do not disable, modify, or delete this role or its attached policies.

  6. Click OK.

The access point is created within approximately 10 minutes. After creation, its alias appears on the Object FC Access Points page. The alias cannot be modified, deleted, or disabled.

Important

Function Compute is triggered only when you call GetObject using the alias of an Object FC Access Point. Non-GetObject operations using the alias are automatically routed to the associated OSS access point, which applies its own policy.

Use the REST API

To create an Object FC Access Point programmatically, call the CreateAccessPointForObjectProcess API operation. You must include the signature calculation in your code.

What's next

Write a request function