PutAccessPointConfigForObjectProcess - Object Storage Service

Usage notes

By default, an Alibaba Cloud account has the permissions to modify the configuration of an Object FC Access Point. To perform this operation as a RAM user or by using Security Token Service (STS) credentials, you must have the oss:PutAccessPointConfigForObjectProcess permission.

Request syntax

PUT /?accessPointConfigForObjectProcess HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
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"?>
<PutAccessPointConfigForObjectProcessConfiguration>
  <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>
  <PublicAccessBlockConfiguration>
    <BlockPublicAccess>true</BlockPublicAccess>
  </PublicAccessBlockConfiguration>
</PutAccessPointConfigForObjectProcessConfiguration>

Request headers

Element

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 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 common request headers such as Host and Date, see Common response headers.

Request elements

Element	Type	Required	Example	Description
PutAccessPointConfigForObjectProcessConfiguration	Container	Yes	N/A	The container that stores the Object FC Access Point configuration. Parent nodes: none Child nodes: AccessPointName and ObjectProcessConfiguration
ObjectProcessConfiguration	Container	No	N/A	The container that stores the processing configuration of the Object FC Access Point. Parent nodes: PutAccessPointConfigForObjectProcessConfiguration Child nodes: AllowedFeature and TransformationConfigurations
AllowedFeatures	Container	No	N/A	The container that stores the allowed features. Parent nodes: ObjectProcessConfiguration Child nodes: AllowedFeature
AllowedFeature	String	No	GetObject-Range	Indicates 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 a single transformation configuration. 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 OSS API operation to process. Only GetObject is supported. Parent nodes: Actions Child nodes: none
ContentTransformation	Container	No	N/A	The container that stores the content transformation details. Parent nodes: TransformationConfiguration Child nodes: FunctionCompute
FunctionCompute	Container	No	N/A	The container that stores Function Compute configuration. Parent nodes: ContentTransformation Child nodes: FunctionAssumeRoleArn and FunctionArn
FunctionAssumeRoleArn	String	No	acs:ram::111933544165****:role/aliyunossobjectfcforossdefaultrole	The ARN of the RAM role that OSS assumes to access your Function Compute resources. Default: `AliyunOSSObjectFcForOSSDefaultRole`. For details, see Quickly create a function. Parent nodes: FunctionCompute Child nodes: none
FunctionArn	String	No	acs:oss:cn-qingdao:111933544165****:services/oss-fc.LATEST/functions/oss-fc-02	The ARN of the function to associate with the Object FC Access Point. For details, see Get a function ARN. Parent nodes: FunctionCompute Child nodes: none
PublicAccessBlockConfiguration	Container	Yes	N/A	The container that stores the Block Public Access configuration. Parent nodes: PutAccessPointConfigForObjectProcessConfiguration Child nodes: BlockPublicAccess
BlockPublicAccess	Boolean	No	true	Specifies whether to enable Block Public Access for the Object FC Access Point. true: enables Block Public Access. false (default): disables Block Public Access. Parent nodes: PublicAccessBlockConfiguration Child nodes: none

Response headers

This operation returns only common response headers. For more information, see Common response headers.

Examples

Sample request

PUT /?accessPointConfigForObjectProcess HTTP/1.1
Date: GMT Date
Content-Length: 750
Content-Type: application/xml
Host: oss-example.oss-cn-qingdao.aliyuncs.com
x-oss-access-point-for-object-process-name: fc-ap-01
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<?xml version="1.0" encoding="UTF-8"?>
<PutAccessPointConfigForObjectProcessConfiguration>
  <ObjectProcessConfiguration>
    <AllowedFeatures>
      <AllowedFeature>GetObject-Range</AllowedFeature>
    </AllowedFeatures>
    <TransformationConfigurations>
      <TransformationConfiguration>
        <Actions>
          <Action>GetObject</Action>
        </Actions>
        <ContentTransformation>
          <FunctionCompute>
            <FunctionAssumeRoleArn>acs:ram::111933544165****:role/aliyunossobjectfcforossdefaultrole</FunctionAssumeRoleArn>
            <FunctionArn>acs:oss:cn-qingdao:111933544165****:services/oss-fc.LATEST/functions/oss-fc-02</FunctionArn>
          </FunctionCompute>          
        </ContentTransformation>
      </TransformationConfiguration>
    </TransformationConfigurations>
  </ObjectProcessConfiguration>
  <PublicAccessBlockConfiguration>
    <BlockPublicAccess>true</BlockPublicAccess>
  </PublicAccessBlockConfiguration>
</PutAccessPointConfigForObjectProcessConfiguration>

Sample response

HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D****
Date: Mon, 30 Oct 2023 03:15:40 GMT