オブジェクトFCアクセスポイントの作成プロセス - Object Storage Service

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

使用方法

デフォルトでは、Alibaba Cloud アカウントにはオブジェクト FC アクセスポイントを作成する権限があります。 RAM ユーザーまたは Security Token Service (STS) を使用してオブジェクト FC アクセスポイントを作成するには、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 アクセスポイントの名前。オブジェクト FC アクセスポイントの名前は、次の要件を満たしている必要があります。

名前は 63 文字以下にする必要があります。
名前には、小文字、数字、およびハイフン (-) のみを含めることができ、ハイフン (-) で開始または終了することはできません。
名前は現在のリージョン内で一意である必要があります。

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

リクエスト要素

要素	タイプ	必須	例	説明
CreateAccessPointForObjectProcessConfiguration	コンテナー	はい	N/A	オブジェクト FC アクセスポイントに関する情報を格納するコンテナー。親ノード: なし子ノード: AccessPointName および ObjectProcessConfiguration
AccessPointName	String	はい	ap-01	オブジェクト FC アクセスポイントの名前。詳細については、「オブジェクト FC アクセスポイントの作成」をご参照ください。
ObjectProcessConfiguration	コンテナー	いいえ	N/A	オブジェクト FC アクセスポイントの処理情報を格納するコンテナー。親ノード: CreateAccessPointForObjectProcessConfiguration 子ノード: AllowedFeature および 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 が他のクラウドサービスのリソースにアクセスするために使用するロールの ARN (Alibaba Cloud Resource Name)。デフォルトのロールは `AliyunFCDefaultRole` です。詳細については、「関数をすばやく作成する」をご参照ください。親ノード: FunctionCompute 子ノード: なし
FunctionArn	String	いいえ	acs:fc:cn-qingdao:111933544165****:services/test-oss-fc.LATEST/functions/fc-01	関数の ARN。詳細については、「関数の ARN を取得する」をご参照ください。

レスポンスヘッダー

CreateAccessPointForObjectProcess リクエストへのレスポンスには、共通のレスポンスヘッダーのみが含まれます。詳細については、「共通の HTTP ヘッダー」をご参照ください。

レスポンス要素

要素	タイプ	例	説明
CreateAccessPointForObjectProcessResult	コンテナー	N/A	オブジェクト FC アクセスポイントに関する情報を格納するコンテナー。子ノード: AccessPointForObjectProcessArn および Alias
AccessPointForObjectProcessArn	String	acs:oss:cn-qingdao:119335441657143: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-hangzhou/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:119335441657143:accesspointforobjectprocess/fc-ap-01</AccessPointForObjectProcessArn>
  <AccessPointForObjectProcessAlias>fc-ap-01-3b00521f653d2b3223680ec39dbbe2****-opapalias</AccessPointForObjectProcessAlias>
</CreateAccessPointForObjectProcessResult>