全部产品
Search
文档中心

Object Storage Service:GetAccessPoint

更新时间:Jun 26, 2025

Mengambil informasi tentang titik akses.

Catatan penggunaan

Secara default, akun Alibaba Cloud memiliki izin untuk mengambil informasi tentang titik akses. Untuk mengambil informasi tentang titik akses menggunakan pengguna RAM atau Security Token Service (STS), Anda harus memiliki izin oss:GetAccessPoint.

Sintaks permintaan

GET /?accessPoint HTTP/1.1
Date: Tanggal GMT
Content-Length: PanjangKonten
Content-Type: JenisKonten
Host: NamaBucket.oss-cn-hangzhou.aliyuncs.com
x-oss-access-point-name: apname
Authorization: NilaiTandaTangan

Header permintaan

Header

Tipe

Diperlukan

Contoh

Deskripsi

x-oss-access-point-name

String

Ya

ap-01

Nama dari titik akses.

Permintaan ini mencakup header permintaan umum lainnya, seperti Date dan Authorization. Untuk informasi lebih lanjut, lihat Header Permintaan Umum.

Header respons

Respons terhadap permintaan GetAccessPoint hanya mencakup header respons umum. Untuk informasi lebih lanjut, lihat Header Respons Umum.

Elemen respons

Elemen

Tipe

Contoh

Deskripsi

GetAccessPointResult

Container

N/A

Kontainer yang menyimpan informasi tentang titik akses.

Node induk: tidak ada

Node anak: AccessPointName, Bucket, AccountId, NetworkOrigin, VpcConfiguration, AccessPointArn, CreationDate, Alias, Status, dan Endpoints

AccessPointName

String

ap-01

Nama dari titik akses.

Node induk: GetAccessPointResult

Node anak: tidak ada

Bucket

String

oss-example

Nama bucket untuk mana titik akses dikonfigurasi.

Node induk: GetAccessPointResult

Node anak: tidak ada

AccountId

String

111933544165xxxx

ID akun Alibaba Cloud untuk mana titik akses dikonfigurasi.

Node induk: GetAccessPointResult

Node anak: tidak ada

NetworkOrigin

String

vpc

Asal jaringan dari titik akses. Nilai valid:

  • vpc: Anda dapat menggunakan ID virtual private cloud (VPC) tertentu untuk mengakses titik akses.

  • internet: Anda dapat menggunakan endpoint publik dan internal untuk mengakses titik akses.

Node induk: GetAccessPointResult

Node anak: tidak ada

VpcConfiguration

Container

N/A

Kontainer yang menyimpan informasi tentang VPC.

Node induk: GetAccessPointResult

Node anak: VpcId

VpcId

String

vpc-t4nlw426y44rd3iq4xxxx

ID dari VPC.

Node induk: VpcConfiguration

Node anak: tidak ada

AccessPointArn

String

arn:acs:oss:cn-hangzhou:111933544165xxxx:accesspoint/ap-01

Nama Sumber Daya Alibaba Cloud (ARN) dari titik akses.

Node induk: GetAccessPointResult

Node anak: tidak ada

CreationDate

String

1626769503

Waktu ketika titik akses dibuat. Nilainya adalah timestamp.

Node induk: GetAccessPointResult

Node anak: tidak ada

Alias

String

ap-01-ossalias

Alias dari titik akses.

Node induk: GetAccessPointResult

Node anak: tidak ada

Status

enable

Status dari titik akses. Nilai valid:

  • enable: Titik akses telah dibuat.

  • disable: Titik akses dinonaktifkan.

  • creating: Titik akses sedang dibuat.

  • deleting: Titik akses dihapus.

Node induk: GetAccessPointResult

Node anak: tidak ada

Endpoints

Container

N/A

Kontainer yang menyimpan informasi asal jaringan tentang titik akses.

Node induk: GetAccessPointResult

Node anak: PublicEndpoint dan InternalEndpoint

PublicEndpoint

String

ap-01.oss-cn-hangzhou.oss-accesspoint.aliyuncs.com

Endpoint publik dari titik akses.

Node induk: Endpoints

Node anak: tidak ada

InternalEndpoint

String

ap-01.oss-cn-hangzhou-internal.oss-accesspoint.aliyuncs.com

Endpoint internal dari titik akses.

Node induk: Endpoints

Node anak: tidak ada

PublicAccessBlockConfiguration

Container

N/A

Kontainer yang menyimpan konfigurasi Block Public Access.

Node induk: GetAccessPointResult

Node anak: BlockPublicAccess

BlockPublicAccess

Boolean

true

Menunjukkan apakah Block Public Access diaktifkan untuk titik akses.

  • true: Block Public Access diaktifkan.

  • false: Block Public Access dinonaktifkan.

Node induk: PublicAccessBlockConfiguration

Node anak: tidak ada

Contoh

  • Contoh Permintaan

    GET /?accessPoint HTTP/1.1
    Date: Mon, 19 Jun 2023 03:15:40 GMT
    Content-Length: 10
    Content-Type: application/xml
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com
    x-oss-access-point-name: ap-01
    Authorization: OSS qn6q**************:77Dv****************    
  • Contoh Respons Sukses

    HTTP/1.1 200
    <?xml version="1.0" encoding="UTF-8"?>
    <GetAccessPointResult>
      <AccessPointName>ap-01</AccessPointName>
      <Bucket>oss-example</Bucket>
      <AccountId>111933544165xxxx</AccountId>
      <NetworkOrigin>vpc</NetworkOrigin>
      <VpcConfiguration>
         <VpcId>vpc-t4nlw426y44rd3iq4xxxx</VpcId>
      </VpcConfiguration>
      <AccessPointArn>arn:acs:oss:cn-hangzhou:111933544165xxxx:accesspoint/ap-01</AccessPointArn>
      <CreationDate>1626769503</CreationDate>
      <Alias>ap-01-ossalias</Alias>
      <Status>enable</Status>
      <Endpoints>
        <PublicEndpoint>ap-01.oss-cn-hangzhou.oss-accesspoint.aliyuncs.com</PublicEndpoint>
        <InternalEndpoint>ap-01.oss-cn-hangzhou-internal.oss-accesspoint.aliyuncs.com</InternalEndpoint>
      </Endpoints>
      <PublicAccessBlockConfiguration>
        <BlockPublicAccess>true</BlockPublicAccess>
      </PublicAccessBlockConfiguration>
    </GetAccessPointResult>

ossutil

Untuk informasi tentang perintah ossutil yang sesuai dengan operasi GetAccessPoint, lihat get-access-point.