CreateAccessPointForObjectProcess - 对象存储 OSS

调用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>