MembuatAccessPointUntukObjekProses - Object Storage Service

Membuat sebuah Titik Akses Objek FC.

Catatan penggunaan

Secara default, akun Alibaba Cloud memiliki izin untuk membuat sebuah Titik Akses Objek FC. Untuk membuat sebuah Titik Akses Objek FC menggunakan pengguna RAM atau Security Token Service (STS), Anda harus memiliki izin oss:CreateAccessPointForObjectProcess.
Anda dapat membuat hingga 1.000 Titik Akses Objek FC untuk satu akun Alibaba Cloud.
Anda dapat membuat hingga 100 Titik Akses Objek FC untuk satu bucket.

Sintaks permintaan

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>

Header permintaan

Header

Tipe

Diperlukan

Contoh

Deskripsi

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

String

fc-ap-01

Nama dari Titik Akses Objek FC. Nama dari Titik Akses Objek FC harus memenuhi persyaratan berikut:

Nama tidak boleh melebihi 63 karakter.
Nama hanya dapat berisi huruf kecil, angka, dan tanda hubung (-) serta tidak boleh dimulai atau diakhiri dengan tanda hubung (-).
Nama harus unik di wilayah saat ini.

Untuk informasi lebih lanjut tentang header permintaan umum lainnya yang termasuk dalam permintaan Membuat Access Point untuk Objek Proses, seperti Host dan Date, lihat Header HTTP Umum.

Elemen permintaan

Elemen	Tipe	Diperlukan	Contoh	Deskripsi
CreateAccessPointForObjectProcessConfiguration	Container	Ya	N/A	Kontainer yang menyimpan informasi tentang Titik Akses Objek FC. Node induk: tidak ada Node anak: AccessPointName dan ObjectProcessConfiguration
AccessPointName	String	Ya	ap-01	Nama dari Titik Akses Objek FC. Untuk informasi lebih lanjut, lihat Membuat Titik Akses Objek FC.
ObjectProcessConfiguration	Container	Tidak	N/A	Kontainer yang menyimpan informasi pemrosesan tentang Titik Akses Objek FC. Node induk: CreateAccessPointForObjectProcessConfiguration Node anak: AllowedFeature dan TransformationConfigurations
AllowedFeatures	Container	Tidak	N/A	Kontainer yang menyimpan fitur yang diizinkan. Node induk: ObjectProcessConfiguration Node anak: AllowedFeature
AllowedFeature	String	Tidak	GetObject-Range	Menentukan bahwa Function Compute mendukung permintaan Range GetObject. Node induk: AllowedFeatures Node anak: tidak ada
TransformationConfigurations	Container	Tidak	N/A	Kontainer yang menyimpan konfigurasi transformasi. Node induk: ObjectProcessConfiguration Node anak: TransformationConfiguration
TransformationConfiguration	Container	Tidak	N/A	Kontainer yang menyimpan konfigurasi transformasi. Node induk: TransformationConfigurations Node anak: Actions dan ContentTransformation
Actions	Container	Tidak	N/A	Kontainer yang menyimpan operasi. Node induk: TransformationConfiguration Node anak: Action
Action	String	Tidak	GetObject	Operasi API OSS yang didukung. Hanya operasi GetObject yang didukung. Node induk: Actions Node anak: tidak ada
ContentTransformation	Container	Tidak	N/A	Kontainer yang menyimpan konten dari konfigurasi transformasi. Node induk: TransformationConfiguration Node anak: FunctionCompute
FunctionCompute	Container	Tidak	N/A	Kontainer yang menyimpan informasi tentang Function Compute. Node induk: ContentTransformation Node anak: FunctionAssumeRoleArn dan FunctionArn
FunctionAssumeRoleArn	String	Tidak	acs:ram::111933544165****:role/aliyunfcdefaultrole	ARN dari peran yang digunakan oleh Function Compute untuk mengakses sumber daya Anda di layanan cloud lainnya. Peran default adalah `AliyunFCDefaultRole`. Untuk informasi lebih lanjut, lihat Buat fungsi dengan cepat. Node induk: FunctionCompute Node anak: tidak ada
FunctionArn	String	Tidak	acs:fc:cn-qingdao:111933544165****:services/test-oss-fc.LATEST/functions/fc-01	ARN dari fungsi. Untuk informasi lebih lanjut, lihat Dapatkan ARN dari suatu fungsi.

Header respons

Respons terhadap permintaan Membuat Access Point untuk Objek Proses hanya berisi header respons umum. Untuk informasi lebih lanjut, lihat Header HTTP Umum.

Elemen respons

Elemen	Tipe	Contoh	Deskripsi
CreateAccessPointForObjectProcessResult	Container	N/A	Kontainer yang menyimpan informasi tentang Titik Akses Objek FC. Node anak: AccessPointForObjectProcessArn dan Alias
AccessPointForObjectProcessArn	String	acs:oss:cn-qingdao:119335441657143:accesspointforobjectprocess/fc-ap-01	ARN dari Titik Akses Objek FC.
AccessPointForObjectProcessAlias	String	fc-ap-01-3b00521f653d2b3223680ec39dbbe2****-opapalias	Alias dari Titik Akses Objek FC.

Contoh

Permintaan Contoh

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>

Respons Contoh

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>