All Products
Search

This Product

    Object Storage Service:GetAccessPoint

    Document Center

    Object Storage Service:GetAccessPoint

    Last Updated:Jun 19, 2026

    Mengambil konfigurasi dan status titik akses tertentu.

    Usage notes

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

    Request syntax

    GET /?accessPoint HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: ContentType
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
x-oss-access-point-name: apname
Authorization: SignatureValue

    Request headers

    Header

    Type

    Required

    Example

    Description

    x-oss-access-point-name

    String

    Yes

    ap-01

    Nama titik akses.

    Permintaan ini juga mencakup header permintaan umum seperti Date dan Authorization. Untuk informasi selengkapnya, lihat Common request headers.

    Response headers

    Tanggapan hanya berisi header respons umum. Untuk informasi selengkapnya, lihat Common response headers.

    Response elements

    Element

    Type

    Example

    Description

    GetAccessPointResult

    Container

    N/A

    Kontainer untuk informasi titik akses.

    Parent nodes: none

    Child nodes: AccessPointName, Bucket, AccountId, NetworkOrigin, VpcConfiguration, AccessPointArn, CreationDate, Alias, Status, dan Endpoints

    AccessPointName

    String

    ap-01

    Nama titik akses.

    Parent nodes: GetAccessPointResult

    Child nodes: none

    Bucket

    String

    oss-example

    Nama bucket yang terkait dengan titik akses.

    Parent nodes: GetAccessPointResult

    Child nodes: none

    AccountId

    String

    111933544165xxxx

    ID Akun Alibaba Cloud yang memiliki titik akses tersebut.

    Parent nodes: GetAccessPointResult

    Child nodes: none

    NetworkOrigin

    String

    vpc

    Origin jaringan dari titik akses. Nilai yang valid:

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

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

    Parent nodes: GetAccessPointResult

    Child nodes: none

    VpcConfiguration

    Container

    N/A

    Kontainer untuk informasi VPC.

    Parent nodes: GetAccessPointResult

    Child nodes: VpcId

    VpcId

    String

    vpc-t4nlw426y44rd3iq4xxxx

    ID VPC.

    Parent nodes: VpcConfiguration

    Child nodes: none

    AccessPointArn

    String

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

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

    Parent nodes: GetAccessPointResult

    Child nodes: none

    CreationDate

    String

    1626769503

    Waktu pembuatan titik akses, dalam format Unix timestamp.

    Parent nodes: GetAccessPointResult

    Child nodes: none

    Alias

    String

    ap-01-ossalias

    Alias titik akses.

    Parent nodes: GetAccessPointResult

    Child nodes: none

    Status

    enable

    Status titik akses. Nilai yang valid:

    • enable: Titik akses telah dibuat.

    • disable: Titik akses dinonaktifkan.

    • creating: Titik akses sedang dibuat.

    • deleting: Titik akses sedang dihapus.

    Parent nodes: GetAccessPointResult

    Child nodes: none

    Endpoints

    Container

    N/A

    Kontainer untuk informasi titik akhir titik akses.

    Parent nodes: GetAccessPointResult

    Child nodes: PublicEndpoint dan InternalEndpoint

    PublicEndpoint

    String

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

    Titik akhir publik dari titik akses.

    Parent nodes: Endpoints

    Child nodes: none

    InternalEndpoint

    String

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

    Titik akhir internal dari titik akses.

    Parent nodes: Endpoints

    Child nodes: none

    PublicAccessBlockConfiguration

    Container

    N/A

    Kontainer untuk konfigurasi Blokir Akses Publik.

    Parent nodes: GetAccessPointResult

    Child nodes: BlockPublicAccess

    BlockPublicAccess

    Boolean

    true

    Menentukan apakah Blokir Akses Publik diaktifkan untuk titik akses.

    • true: Blokir Akses Publik diaktifkan.

    • false: Blokir Akses Publik dinonaktifkan.

    Parent nodes: PublicAccessBlockConfiguration

    Child nodes: none

    Examples

    • Sample request

      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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    • Sample success response

      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.