CreateAccessPointForObjectProcess - Object Storage Service

調用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	Function Compute支援使用Range GetObject請求。父節點：AllowedFeatures 子節點：無
TransformationConfigurations	容器	否	不涉及	儲存轉換配置資訊的容器。父節點：ObjectProcessConfiguration 子節點：TransformationConfiguration
TransformationConfiguration	容器	否	不涉及	儲存轉換配置資訊的容器。父節點：TransformationConfigurations 子節點：Actions、ContentTransformation
Actions	容器	否	不涉及	儲存操作資訊的容器。父節點：TransformationConfiguration 子節點：Action
Action	字串	否	GetObject	支援的OSS API操作，目前僅支援GetObject。父節點：Actions 子節點：無
ContentTransformation	容器	否	不涉及	儲存轉換資訊的容器。父節點：TransformationConfiguration 子節點：FunctionCompute
FunctionCompute	容器	否	不涉及	儲存Function Compute資訊的容器。父節點：ContentTransformation 子節點：FunctionAssumeRoleArn、FunctionArn
FunctionAssumeRoleArn	字串	否	acs:ram::111933544165****:role/aliyunfcdefaultrole	填寫Function Compute用於訪問您在其他雲產品中的資源的角色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>