All Products
Search
Document Center

Object Storage Service:PutAccessPointConfigForObjectProcess

Last Updated:May 17, 2024

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