CreateAccessPointForObjectProcess - Object Storage Service - Alibaba Cloud ドキュメントセンター

オブジェクト FC アクセスポイントを作成します。

注意事項

デフォルトでは、Alibaba Cloud アカウントにはオブジェクト FC アクセスポイントを作成する権限があります。RAM ユーザーまたは Security Token Service (STS) を使用して作成するには、oss:CreateAccessPointForObjectProcess 権限が必要です。
1 つの Alibaba Cloud アカウントでは、最大 1,000 個のオブジェクト FC アクセスポイントを作成できます。
1 つのバケットでは、最大 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

String

はい

fc-ap-01

オブジェクト FC アクセスポイントの名前。次の要件を満たす必要があります。

名前は 63 文字以内である必要があります。
名前に使用できるのは、小文字、数字、ハイフン (-) のみです。また、名前の先頭や末尾にハイフン (-) は使用できません。
名前は、現在のリージョン内で一意である必要があります。

Host や Date などの共通リクエストヘッダーの詳細については、「共通HTTPヘッダー」をご参照ください。

リクエスト要素

要素	タイプ	必須	例	説明
CreateAccessPointForObjectProcessConfiguration	コンテナ	はい	N/A	オブジェクト FC アクセスポイントに関する情報を格納するコンテナ。親ノード：なし子ノード：AccessPointName、ObjectProcessConfiguration
AccessPointName	String	はい	ap-01	オブジェクト FC アクセスポイントの名前。詳細については、「オブジェクト FC アクセスポイントの作成」をご参照ください。
ObjectProcessConfiguration	コンテナ	いいえ	N/A	オブジェクト FC アクセスポイントの処理情報を格納するコンテナ。親ノード：CreateAccessPointForObjectProcessConfiguration 子ノード：AllowedFeatures、TransformationConfigurations
AllowedFeatures	コンテナ	いいえ	N/A	許可された機能を格納するコンテナ。親ノード：ObjectProcessConfiguration 子ノード：AllowedFeature
AllowedFeature	String	いいえ	GetObject-Range	Function Compute が Range GetObject リクエストをサポートすることを示します。親ノード：AllowedFeatures 子ノード：なし
TransformationConfigurations	コンテナ	いいえ	N/A	変換設定を格納するコンテナ。親ノード：ObjectProcessConfiguration 子ノード：TransformationConfiguration
TransformationConfiguration	コンテナ	いいえ	N/A	変換設定を格納するコンテナ。親ノード：TransformationConfigurations 子ノード：Actions、ContentTransformation
Actions	コンテナ	いいえ	N/A	操作を格納するコンテナ。親ノード：TransformationConfiguration 子ノード：Action
Action	String	いいえ	GetObject	OSS API 操作。GetObject のみがサポートされています。親ノード：Actions 子ノード：なし
ContentTransformation	コンテナ	いいえ	N/A	変換設定の内容を格納するコンテナ。親ノード：TransformationConfiguration 子ノード：FunctionCompute
FunctionCompute	コンテナ	いいえ	N/A	Function Compute の情報を格納するコンテナ。親ノード：ContentTransformation 子ノード：FunctionAssumeRoleArn、FunctionArn
FunctionAssumeRoleArn	String	いいえ	acs:ram::111933544165****:role/aliyunfcdefaultrole	Function Compute が他のクラウドサービスのリソースにアクセスするために使用するロールの Alibaba Cloud リソースネーム (ARN) です。デフォルトのロールは `AliyunFCDefaultRole` です。詳細については、「関数のクイック作成」をご参照ください。親ノード：FunctionCompute 子ノード：なし
FunctionArn	String	いいえ	acs:fc:cn-qingdao:111933544165****:services/test-oss-fc.LATEST/functions/fc-01	関数の ARN。詳細については、「関数ARNの取得」をご参照ください。

レスポンスヘッダー

この操作は、共通レスポンスヘッダーのみを返します。詳細については、「共通HTTPヘッダー」をご参照ください。

レスポンス要素

要素	タイプ	例	説明
CreateAccessPointForObjectProcessResult	コンテナ	N/A	オブジェクト FC アクセスポイントに関する情報を格納するコンテナ。子ノード：AccessPointForObjectProcessArn、AccessPointForObjectProcessAlias
AccessPointForObjectProcessArn	String	acs:oss:cn-qingdao:111933544165****:accesspointforobjectprocess/fc-ap-01	オブジェクト FC アクセスポイントの ARN。
AccessPointForObjectProcessAlias	String	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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-qingdao/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

<?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:111933544165****:accesspointforobjectprocess/fc-ap-01</AccessPointForObjectProcessArn>
  <AccessPointForObjectProcessAlias>fc-ap-01-3b00521f653d2b3223680ec39dbbe2****-opapalias</AccessPointForObjectProcessAlias>
</CreateAccessPointForObjectProcessResult>