CreateAccessPointForObjectProcess - Object Storage Service

Creates an Object FC Access Point.

Usage notes

By default, an Alibaba Cloud account has the permissions to create an Object FC Access Point. To create an Object FC Access Point by using a RAM user or Security Token Service (STS), you must have the oss:CreateAccessPointForObjectProcess permission.
You can create up to 1,000 Object FC Access Points for an Alibaba Cloud account.
You can create up to 100 Object FC Access Points for a bucket.

Request syntax

PUT /?accessPointForObjectProcess HTTP/1.1
Date: GMT Date
Content-Length: 785
Content-Type: application/xml
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
x-oss-access-point-for-object-process-name: fc-ap-01
Authorization: SignatureValue

<?xml version="1.0" encoding="UTF-8"?>
<CreateAccessPointForObjectProcessConfiguration>
  <AccessPointName>ap-01</AccessPointName>
  <ObjectProcessConfiguration>
    <AllowedFeatures>
      <AllowedFeature>GetObject-Range</AllowedFeature>
    </AllowedFeatures>
    <TransformationConfigurations>
      <TransformationConfiguration>
        <Actions>
          <Action>GetObject</Action>
        </Actions>
        <ContentTransformation>
          <FunctionCompute>
            <FunctionAssumeRoleArn>string</FunctionAssumeRoleArn>
            <FunctionArn>string</FunctionArn>
          </FunctionCompute>          
        </ContentTransformation>
      </TransformationConfiguration>
    </TransformationConfigurations>
  </ObjectProcessConfiguration>
</CreateAccessPointForObjectProcessConfiguration>

Request headers

Header

Type

Required

Example

Description

x-oss-access-point-for-object-process-name

String

Yes

fc-ap-01

The name of the Object FC Access Point. The name of an Object FC Access Point must meet the following requirements:

The name cannot exceed 63 characters in length.
The name can contain only lowercase letters, digits, and hyphens (-) and cannot start or end with a hyphen (-).
The name must be unique in the current region.

For more information about other common request headers included in a CreateAccessPointForObjectProcess request, such as Host and Date, see Common HTTP headers.

Request elements

Element	Type	Required	Example	Description
CreateAccessPointForObjectProcessConfiguration	Container	Yes	N/A	The container that stores information about the Object FC Access Point. Parent nodes: none Child nodes: AccessPointName and ObjectProcessConfiguration
AccessPointName	String	Yes	ap-01	The name of the Object FC Access Point. For more information, see Create Object FC Access Points.
ObjectProcessConfiguration	Container	No	N/A	The container that stores the processing information about the Object FC Access Point. Parent nodes: CreateAccessPointForObjectProcessConfiguration Child nodes: AllowedFeature and TransformationConfigurations
AllowedFeatures	Container	No	N/A	The container that stores allowed features. Parent nodes: ObjectProcessConfiguration Child nodes: AllowedFeature
AllowedFeature	String	No	GetObject-Range	Specifies that Function Compute supports Range GetObject requests. Parent nodes: AllowedFeatures Child nodes: none
TransformationConfigurations	Container	No	N/A	The container that stores the transformation configurations. Parent nodes: ObjectProcessConfiguration Child nodes: TransformationConfiguration
TransformationConfiguration	Container	No	N/A	The container that stores the transformation configurations. Parent nodes: TransformationConfigurations Child nodes: Actions and ContentTransformation
Actions	Container	No	N/A	The container that stores the operations. Parent nodes: TransformationConfiguration Child nodes: Action
Action	String	No	GetObject	The supported OSS API operations. Only the GetObject operation is supported. Parent nodes: Actions Child nodes: none
ContentTransformation	Container	No	N/A	The container that stores the content of the transformation configurations. Parent nodes: TransformationConfiguration Child nodes: FunctionCompute
FunctionCompute	Container	No	N/A	The container that stores the information about Function Compute. Parent nodes: ContentTransformation Child nodes: FunctionAssumeRoleArn and FunctionArn
FunctionAssumeRoleArn	String	No	acs:ram::111933544165****:role/aliyunfcdefaultrole	The Alibaba Cloud Resource Name (ARN) of the role that Function Compute uses to access your resources in other cloud services. The default role is `AliyunFCDefaultRole`. For more information, see Quickly create a function. Parent nodes: FunctionCompute Child nodes: none
FunctionArn	String	No	acs:fc:cn-qingdao:111933544165****:services/test-oss-fc.LATEST/functions/fc-01	The ARN of the function. For more information, see Obtain the ARN of a function.

Response headers

The response to a CreateAccessPointForObjectProcess request contains only common response headers. For more information, see Common HTTP headers.

Response elements

Element	Type	Example	Description
CreateAccessPointForObjectProcessResult	Container	N/A	The container that stores information about the Object FC Access Point. Child nodes: AccessPointForObjectProcessArn and Alias
AccessPointForObjectProcessArn	String	acs:oss:cn-qingdao:119335441657143:accesspointforobjectprocess/fc-ap-01	The ARN of the Object FC Access Point.
AccessPointForObjectProcessAlias	String	fc-ap-01-3b00521f653d2b3223680ec39dbbe2****-opapalias	The alias of the Object FC Access Point.

Examples

Sample request

PUT /?accessPointForObjectProcess HTTP/1.1
Date: Mon, 30 Oct 2023 03:15:40 GMT
Content-Length: 785
Content-Type: application/xml
Host: oss-example.oss-cn-qingdao.aliyuncs.com
x-oss-access-point-for-object-process-name: fc-ap-01
Authorization: OSS qn6q**************:77Dv****************

<?xml version="1.0" encoding="UTF-8"?>
<CreateAccessPointForObjectProcessConfiguration>
  <AccessPointName>ap-01</AccessPointName>
  <ObjectProcessConfiguration>
    <AllowedFeatures>
      <AllowedFeature>GetObject-Range</AllowedFeature>
    </AllowedFeatures>
    <TransformationConfigurations>
      <TransformationConfiguration>
        <Actions>
          <Action>GetObject</Action>
        </Actions>
        <ContentTransformation>
          <FunctionCompute>
            <FunctionAssumeRoleArn>acs:ram::111933544165****:role/aliyunfcdefaultrole</FunctionAssumeRoleArn>
            <FunctionArn>acs:fc:cn-qingdao:111933544165****:services/test-oss-fc.LATEST/functions/fc-01</FunctionArn>
          </FunctionCompute>          
        </ContentTransformation>
      </TransformationConfiguration>
    </TransformationConfigurations>
  </ObjectProcessConfiguration>
</CreateAccessPointForObjectProcessConfiguration>

Sample response

HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Mon, 30 Oct 2023 03:15:40 GMT
<?xml version="1.0" encoding="UTF-8"?>
<CreateAccessPointForObjectProcessResult>
  <AccessPointForObjectProcessArn>acs:oss:cn-qingdao:119335441657143:accesspointforobjectprocess/fc-ap-01</AccessPointForObjectProcessArn>
  <AccessPointForObjectProcessAlias>fc-ap-01-3b00521f653d2b3223680ec39dbbe2****-opapalias</AccessPointForObjectProcessAlias>
</CreateAccessPointForObjectProcessResult>