すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:CreateAccessPointForObjectProcess

最終更新日:Feb 23, 2024

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

使用上の注意

  • デフォルトでは、Alibaba CloudアカウントにはオブジェクトFCアクセスポイントを作成する権限があります。 RAMユーザーまたはSecurity Token Service (STS) を使用してオブジェクトFCアクセスポイントを作成するには、oss:CreateAccessPointForObjectProcess権限が必要です。

  • Alibaba Cloudアカウントに対して最大1,000のObject FCアクセスポイントを作成できます。

  • 1つのバケットに対して最大100のオブジェクトFCアクセスポイントを作成できます。

リクエスト構文

PUT /?accessPointForObjectProcess HTTP/1.1
日付: GMT日付
コンテンツ-長さ: 785
Content-Type: application/xml
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
x-oss-access-point-for-object-process-name: fc-ap-01
権限付与: SignatureValue

<?xml version="1.0" encoding="UTF-8"?>
<CreateAccessPointForObjectProcessConfiguration>
  <AccessPointName>ap-01</AccessPointName>
  <ObjectProcessConfiguration>
    <AllowedFeatures>
      <AllowedFeature>GetObject-Range</AllowedFeature>
    </AllowedFeatures>
    <TransformationConfigurations>
      <TransformationConfiguration>
        <アクション>
          <Action>GetObject</Action>
        </アクション>
        <ContentTransformation>
          <FunctionCompute>
            <FunctionAssumeRoleArn> 文字列 </FunctionAssumeRoleArn>
            <FunctionArn> 文字列 </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

Container

必須

N/A

オブジェクトFCアクセスポイントに関する情報を格納するコンテナー。

親ノード: なし

子ノード: AccessPointNameとObjectProcessConfiguration

AccessPointName

String

必須

ap-01

オブジェクトFCアクセスポイントの名前。 詳細については、「オブジェクトFCアクセスポイントの作成」をご参照ください。

ObjectProcessConfiguration

Container

任意

N/A

オブジェクトFCアクセスポイントに関する処理情報を格納するコンテナー。

親ノード: CreateAccessPointForObjectProcessConfiguration

子ノード: AllowedFeatureとTransformationConfigurations

AllowedFeatures

Container

任意

N/A

許可された機能を格納するコンテナー。

親ノード: ObjectProcessConfiguration

子ノード: AllowedFeature

AllowedFeature

String

任意

GetObject-Range

Function ComputeがRange GetObjectリクエストをサポートすることを指定します。

親ノード: AllowedFeatures

子ノード: なし

TransformationConfigurations

Container

任意

N/A

変換設定を格納するコンテナー。

親ノード: ObjectProcessConfiguration

子ノード: TransformationConfiguration

TransformationConfiguration

Container

任意

N/A

変換設定を格納するコンテナー。

親ノード: TransformationConfigurations

子ノード: アクションとContentTransformation

操作

Container

任意

N/A

操作を格納するコンテナー。

親ノード: TransformationConfiguration

子ノード: アクション

Action

String

任意

GetObject

サポートされているOSS API操作。 GetObject操作のみがサポートされています。

親ノード: アクション

子ノード: なし

ContentTransformation

Container

任意

N/A

変換設定の内容を格納するコンテナー。

親ノード: TransformationConfiguration

子ノード: FunctionCompute

FunctionCompute

Container

任意

N/A

Function Computeに関する情報を格納するコンテナー。

親ノード: ContentTransformation

子ノード: FunctionAssumeRoleArnおよびFunctionArn

FunctionAssumeRoleArn

String

任意

acs:ram::111933544165 ****:role/aliyunfcdefaultrole

Function Computeが他のクラウドサービスのリソースにアクセスするために使用するロールのAlibaba Cloud Resource Name (ARN) 。 デフォルトのロールはAliyunFCDefaultRoleです。 詳細については、「関数の迅速な作成」をご参照ください。

親ノード: FunctionCompute

子ノード: なし

FunctionArn

String

任意

acs:fc:cn-qingdao:111933544165 ****: サービス /test-oss-fc.LATEST /機能 /fc-01

関数のARN。The ARN of the function. 詳細については、「関数のARNの取得」をご参照ください。

レスポンスヘッダー

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

レスポンス要素

要素

データ型

説明

CreateAccessPointForObjectProcessResult

Container

N/A

オブジェクトFCアクセスポイントに関する情報を格納するコンテナー。

子ノード: AccessPointForObjectProcessArnとエイリアス

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
    日付: 10月30日月曜日2023 03:15:40 GMT
    コンテンツ-長さ: 785
    Content-Type: application/xml
    ホスト: oss-example.oss-cn-qingdao.aliyuncs.com
    x-oss-access-point-for-object-process-name: fc-ap-01
    権限付与: OSS qn6qrrqxo2oawuk53otf ****:ceOEyZavKY4QcjoUWYSpYbJ3 ****
    
    <?xml version="1.0" encoding="UTF-8"?>
    <CreateAccessPointForObjectProcessConfiguration>
      <AccessPointName>ap-01</AccessPointName>
      <ObjectProcessConfiguration>
        <AllowedFeatures>
          <AllowedFeature>GetObject-Range</AllowedFeature>
        </AllowedFeatures>
        <TransformationConfigurations>
          <TransformationConfiguration>
            <アクション>
              <Action>GetObject</Action>
            </アクション>
            <ContentTransformation>
              <FunctionCompute>
                <FunctionAssumeRoleArn>acs:ram::111933544165 ****:role/aliyunfcdefaultrole</FunctionAssumeRoleArn>
                <FunctionArn>acs:fc:cn-qingdao:111933544165 ****: サービス /test-oss-fc.LATEST /機能 /fc-01</FunctionArn>
              </FunctionCompute>          
            </ContentTransformation>
          </TransformationConfiguration>
        </TransformationConfigurations>
      </ObjectProcessConfiguration>
    </CreateAccessPointForObjectProcessConfiguration> 
  • レスポンスの例

    HTTP/1.1 200 OK
    x-oss-request-id: 5C1B138A109F4E405B2D ****
    日付: 10月30日月曜日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>