PutAccessPointConfigForObjectProcess - Object Storage Service

Changes the configurations of an Object FC Access Point.

Usage notes

By default, an Alibaba Cloud account has the permissions to change the configurations of an Object FC Access Point. To change the configurations of an Object FC Access Point by using a RAM user or the access credentials provided by Security Token Service (STS), 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 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 PutAccessPointConfigForObjectProcess request, 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 information about the Object FC Access Point. Parent nodes: none Child nodes: AccessPointName and ObjectProcessConfiguration
ObjectProcessConfiguration	Container	No	N/A	The container that stores the processing information about the Object FC Access Point. Parent nodes: PutAccessPointConfigForObjectProcessConfiguration 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 information about Function Compute. Parent nodes: ContentTransformation Child nodes: FunctionAssumeRoleArn and FunctionArn
FunctionAssumeRoleArn	String	No	acs:oss:cn-qingdao:111933544165****:services/oss-fc.LATEST/functions/oss-fc-fc-02	The Alibaba Cloud Resource Name (ARN) of another function that you want to associate to an Object FC Access Point. For more information, see Obtain the ARN of a function. Parent nodes: FunctionCompute Child nodes: none
FunctionArn	String	No	acs:ram::111933544165****:role/aliyunfcdefaultrole	The 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.
PublicAccessBlockConfiguration	Container	Yes	N/A	The container in which the Block Public Access configurations are stored. 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

The response to a PutAccessPointConfigForObjectProcess request contains 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: OSS qn6q**************:77Dv****************
<?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:oss:cn-qingdao:111933544165****:services/oss-fc.LATEST/functions/oss-fc-fc-02</FunctionAssumeRoleArn>
            <FunctionArn>acs:ram::111933544165****:role/aliyunfcdefaultrole</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