全部产品
Search
文档中心

对象存储 OSS:CreateAccessPointForObjectProcess

更新时间:Apr 28, 2024

调用CreateAccessPointForObjectProcess创建对象FC接入点。

注意事项

  • 阿里云账号默认拥有创建对象FC接入点的权限。如果您希望通过RAM用户或者STS的方式创建对象FC接入点,您必须拥有oss:CreateAccessPointForObjectProcess权限。

  • 单个阿里云账号支持创建1000个对象FC接入点。

  • 单个Bucket支持创建100个对象FC接入点。

请求语法

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>

请求头

名称

类型

是否必选

示例值

描述

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

字符串

fc-ap-01

填写对象FC接入点名称。接入点命名规范说明如下:

  • 命名长度不能超过63个字符

  • 只允许包含小写字母、数字、短横线(-),且不能以短横线开头或结尾。

  • 名称在当前地域必须唯一。

此接口涉及的公共请求头,例如Date、Host等。更多信息,请参见公共HTTP头定义

请求元素

名称

类型

是否必选

示例值

描述

CreateAccessPointForObjectProcessConfiguration

容器

不涉及

保存对象FC接入点信息的容器。

父节点:无

子节点:AccessPointName、ObjectProcessConfiguration

AccessPointName

字符串

ap-01

OSS接入点名称。更多信息,请参见创建接入点

ObjectProcessConfiguration

容器

不涉及

保存对象处理信息的容器。

父节点:CreateAccessPointForObjectProcessConfiguration

子节点:AllowedFeature、TransformationConfigurations

AllowedFeatures

容器

不涉及

保存通过对象FC接入点发起请求信息的容器。

父节点:ObjectProcessConfiguration

子节点:AllowedFeature

AllowedFeature

字符串

GetObject-Range

函数计算支持使用Range GetObject请求。

父节点:AllowedFeatures

子节点:无

TransformationConfigurations

容器

不涉及

保存转换配置信息的容器。

父节点:ObjectProcessConfiguration

子节点:TransformationConfiguration

TransformationConfiguration

容器

不涉及

保存转换配置信息的容器。

父节点:TransformationConfigurations

子节点:Actions、ContentTransformation

Actions

容器

不涉及

保存操作信息的容器。

父节点:TransformationConfiguration

子节点:Action

Action

字符串

GetObject

支持的OSS API操作,目前仅支持GetObject。

父节点:Actions

子节点:无

ContentTransformation

容器

不涉及

保存转换信息的容器。

父节点:TransformationConfiguration

子节点:FunctionCompute

FunctionCompute

容器

不涉及

保存函数计算信息的容器。

父节点:ContentTransformation

子节点:FunctionAssumeRoleArn、FunctionArn

FunctionAssumeRoleArn

字符串

acs:ram::111933544165****:role/aliyunfcdefaultrole

填写函数计算用于访问您在其他云产品中的资源的角色ARN。默认角色为AliyunFCDefaultRole。更多信息,请参见快速创建函数

父节点:FunctionCompute

子节点:无

FunctionArn

字符串

acs:fc:cn-qingdao:111933544165****:services/test-oss-fc.LATEST/functions/fc-01

填写函数ARN。更多信息,请参见获取函数ARN

响应头

此接口仅包含公共响应头。更多信息,请参见公共响应头(Common Response Headers)

响应元素

名称

类型

示例值

描述

CreateAccessPointForObjectProcessResult

容器

不涉及

保存对象FC接入点信息的容器。

子节点:AccessPointForObjectProcessArn,Alias

AccessPointForObjectProcessArn

字符串

acs:oss:cn-qingdao:119335441657143:accesspointforobjectprocess/fc-ap-01

对象FC接入点ARN。

AccessPointForObjectProcessAlias

字符串

fc-ap-01-3b00521f653d2b3223680ec39dbbe2****-opapalias

对象FC接入点别名。

示例

  • 请求示例

    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>
  • 返回示例

    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>