調用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接入點名稱。接入點命名規范說明如下:
|
此接口涉及的公共請求頭,例如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。默認角色為 父節點: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>