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

Object Storage Service:PutAccessPointConfigForObjectProcess

最終更新日:Jun 13, 2025

オブジェクト FC アクセスポイントの構成を変更します。

使用方法

デフォルトでは、Alibaba Cloud アカウントにはオブジェクト FC アクセスポイントの構成を変更する権限があります。 RAM ユーザーまたは Security Token Service (STS) によって提供されるアクセス認証情報を使用してオブジェクト FC アクセスポイントの構成を変更するには、oss:PutAccessPointConfigForObjectProcess 権限が必要です。

リクエスト構文

PUT /?accessPointConfigForObjectProcess HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
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"?>
<PutAccessPointConfigForObjectProcessConfiguration>
  <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>
  <PublicAccessBlockConfiguration>
    <BlockPublicAccess>true</BlockPublicAccess>
  </PublicAccessBlockConfiguration>
</PutAccessPointConfigForObjectProcessConfiguration>

リクエストヘッダー

要素

タイプ

必須

説明

x-oss-access-point-for-object-process-name

String

はい

fc-ap-01

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

  • 名前は 63 文字を超えることはできません。

  • 名前には、小文字、数字、およびハイフン (-) のみを含めることができ、ハイフン (-) で開始または終了することはできません。

  • 名前は、現在のリージョン内で一意である必要があります。

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

リクエスト要素

要素

タイプ

必須

説明

PutAccessPointConfigForObjectProcessConfiguration

コンテナー

はい

該当なし

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

親ノード: なし

子ノード: AccessPointName および ObjectProcessConfiguration

ObjectProcessConfiguration

コンテナー

いいえ

該当なし

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

親ノード: PutAccessPointConfigForObjectProcessConfiguration

子ノード: AllowedFeature および TransformationConfigurations

AllowedFeatures

コンテナー

いいえ

該当なし

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

親ノード: ObjectProcessConfiguration

子ノード: AllowedFeature

AllowedFeature

String

いいえ

GetObject-Range

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

親ノード: AllowedFeatures

子ノード: なし

TransformationConfigurations

コンテナー

いいえ

該当なし

変換構成を格納するコンテナー。

親ノード: ObjectProcessConfiguration

子ノード: TransformationConfiguration

TransformationConfiguration

コンテナー

いいえ

該当なし

変換構成を格納するコンテナー。

親ノード: TransformationConfigurations

子ノード: Actions および ContentTransformation

Actions

コンテナー

いいえ

該当なし

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

親ノード: TransformationConfiguration

子ノード: Action

Action

String

いいえ

GetObject

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

親ノード: Actions

子ノード: なし

ContentTransformation

コンテナー

いいえ

該当なし

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

親ノード: TransformationConfiguration

子ノード: FunctionCompute

FunctionCompute

コンテナー

いいえ

該当なし

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

親ノード: ContentTransformation

子ノード: FunctionAssumeRoleArn および FunctionArn

FunctionAssumeRoleArn

String

いいえ

acs:ram::111933544165****:role/aliyunossobjectfcforossdefaultrole

OSS が Function Compute リソースへのアクセスと管理に使用するロールの ARN (Alibaba Cloud Resource Name)。 デフォルトロールは AliyunOSSObjectFcForOSSDefaultRole です。 詳細については、「関数をすばやく作成する」をご参照ください。

親ノード: FunctionCompute

子ノード: なし

FunctionArn

String

いいえ

acs:oss:cn-qingdao:111933544165****:services/oss-fc.LATEST/functions/oss-fc-02

オブジェクト FC アクセスポイントに関連付ける別の関数の ARN。 詳細については、「関数の ARN を取得する」をご参照ください。

親ノード: FunctionCompute

子ノード: なし

PublicAccessBlockConfiguration

コンテナー

はい

該当なし

ブロックパブリックアクセス構成が格納されているコンテナー。

親ノード: PutAccessPointConfigForObjectProcessConfiguration

子ノード: BlockPublicAccess

BlockPublicAccess

ブール値

いいえ

true

オブジェクト FC アクセスポイントのブロックパブリックアクセスを有効にするかどうかを指定します。

  • true: ブロックパブリックアクセスを有効にします。

  • false (デフォルト): ブロックパブリックアクセスを無効にします。

親ノード: PublicAccessBlockConfiguration

子ノード: なし

レスポンスヘッダー

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

  • リクエスト例

    PUT /?accessPointConfigForObjectProcess HTTP/1.1
    Date: GMT Date
    Content-Length: 750
    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"?>
    <PutAccessPointConfigForObjectProcessConfiguration>
      <ObjectProcessConfiguration>
        <AllowedFeatures>
          <AllowedFeature>GetObject-Range</AllowedFeature>
        </AllowedFeatures>
        <TransformationConfigurations>
          <TransformationConfiguration>
            <Actions>
              <Action>GetObject</Action>
            </Actions>
            <ContentTransformation>
              <FunctionCompute>
                <FunctionAssumeRoleArn>acs:ram::111933544165****:role/aliyunossobjectfcforossdefaultrole</FunctionAssumeRoleArn>
                <FunctionArn>acs:oss:cn-qingdao:111933544165****:services/oss-fc.LATEST/functions/oss-fc-02</FunctionArn>
              </FunctionCompute>          
            </ContentTransformation>
          </TransformationConfiguration>
        </TransformationConfigurations>
      </ObjectProcessConfiguration>
      <PublicAccessBlockConfiguration>
        <BlockPublicAccess>true</BlockPublicAccess>
      </PublicAccessBlockConfiguration>
    </PutAccessPointConfigForObjectProcessConfiguration>
  • レスポンス例

    HTTP/1.1 200 OK
    x-oss-request-id: 5C1B138A109F4E405B2D****
    Date: Mon, 30 Oct 2023 03:15:40 GMT