Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:ListAccessPoints

Son Güncelleme:Oct 01, 2026

Kullanıcı düzeyinde veya paket düzeyindeki erişim noktası bilgilerini sorgular.

Kullanım notları

Bir Alibaba Cloud hesabı, varsayılan olarak erişim noktası bilgilerini sorgulama iznine sahiptir. Bu işlemi bir RAM kullanıcısı olarak veya Security Token Service (STS) kullanarak gerçekleştirmek için oss:ListAccessPoints iznine sahip olmanız gerekir.

İstek sözdizimi

Kullanıcı düzeyi ve paket düzeyi erişim noktası sorguları yalnızca istek ana bilgisayarında farklılık gösterir. Kullanıcı düzeyi erişim noktaları için ana bilgisayar genel bir uç nokta (örneğin: oss-cn-hangzhou.aliyuncs.com) veya dahili bir uç noktadır (örneğin: oss-cn-hangzhou-internal.aliyuncs.com). Paket düzeyi erişim noktaları için ana bilgisayar bir paket alan adıdır (örneğin: oss-example.oss-cn-hangzhou.aliyuncs.com).

Kullanıcı düzeyi erişim noktalarının bilgilerini sorgulama

GET /?accessPoint&max-keys=10&continuation-token=abcd HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: oss-cn-hangzhou.aliyuncs.com 
Authorization: SignatureValue

Paket düzeyi erişim noktalarının bilgilerini sorgulama

GET /?accessPoint&max-keys=10&continuation-token=abcd HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss-cn-hangzhou.aliyuncs.com 
Authorization: SignatureValue

İstek üstbilgileri

Bir ListAccessPoints isteği yalnızca ortak istek üstbilgilerini kullanır. Daha fazla bilgi için bkz. Ortak HTTP üstbilgileri.

İstek öğeleri

Öğe

Tür

Gerekli

Örnek

Açıklama

max-keys

String

Hayır

10

Döndürülecek maksimum erişim noktası sayısı. Geçerli değerler:

  • Kullanıcı düzeyi erişim noktaları için: (0.1000].

  • Paket düzeyi erişim noktaları için: (0.100].

Not

Sonuçlar max-keys sınırı nedeniyle kesilirse yanıt, sonraki listeleme isteği için belirteç olarak NextContinuationToken öğesini içerir.

continuation-token

String

Hayır

abc

Listelemenin başladığı belirteç. Bu belirteci önceki yanıttaki NextContinuationToken öğesinden edinin.

Yanıt üstbilgileri

Bir ListAccessPoints yanıtı yalnızca ortak yanıt üstbilgilerini içerir. Daha fazla bilgi için bkz. Ortak HTTP üstbilgileri.

Yanıt öğeleri

Öğe

Tür

Örnek

Açıklama

ListAccessPointsResult

Container

Yok

Liste sonucu için kapsayıcı.

Üst düğümler: yok

Alt düğümler: IsTruncated, NextContinuationToken, AccountId ve AccessPoints

IsTruncated

Boolean

true

Sonuçların kesilip kesilmediğini belirtir. Geçerli değerler:

  • true: Tüm sonuçlar döndürülmez.

  • false: Tüm sonuçlar döndürülür.

Üst düğümler: ListAccessPointsResult

Alt düğümler: yok

NextContinuationToken

String

abc

Sonraki listeleme isteğinde kullanılacak belirteç. Sonraki sonuçları almak için continuation-token değerini bu değere ayarlayın.

Üst düğümler: ListAccessPointsResult

Alt düğümler: yok

AccountId

String

111933544165****

Erişim noktasına sahip olan Alibaba Cloud hesabının ID'si.

Üst düğümler: ListAccessPointsResult

Alt düğümler: yok

AccessPoints

Container

Yok

Tüm erişim noktaları için kapsayıcı.

Üst düğümler: ListAccessPointsResult

Alt düğümler: AccessPoint

AccessPoint

Container

Yok

Tek bir erişim noktası için kapsayıcı.

Üst düğümler: AccessPoints

Alt düğümler: Bucket, AccessPointName, Alias, NetworkOrigin, VpcConfiguration ve Status

Bucket

String

oss-example

Erişim noktasıyla ilişkili paketin adı.

Üst düğümler: AccessPoint

Alt düğümler: yok

AccessPointName

String

ap-01

Erişim noktasının adı.

Üst düğümler: AccessPoint

Alt düğümler: yok

Alias

String

ap-01-ossalias

Erişim noktasının takma adı.

Üst düğümler: AccessPoint

Alt düğümler: yok

NetworkOrigin

String

vpc

Erişim noktasının ağ kökeni. Geçerli değerler:

  • vpc: Erişim noktasına yalnızca belirtilen bir sanal özel cloud (VPC) ID'sinden erişilebilir.

  • internet: Erişim noktasına genel ve dahili uç noktalardan erişilebilir.

Üst düğümler: AccessPoint

Alt düğümler: yok

VpcConfiguration

Container

Yok

VPC yapılandırması için kapsayıcı.

Üst düğümler: AccessPoint

Alt düğümler: VpcId

VpcId

String

vpc-t4nlw426y44rd3iq4****

VPC ID'si.

Üst düğümler: VpcConfiguration

Alt düğümler: yok

Status

enable

Erişim noktasının durumu. Geçerli değerler:

  • enable: Erişim noktası oluşturuldu.

  • disable: Erişim noktası devre dışı bırakıldı.

  • creating: Erişim noktası oluşturuluyor.

  • deleting: Erişim noktası siliniyor.

Üst düğümler: AccessPoint

Alt düğümler: VpcId

Örnekler

  • Örnek istekler

    Kullanıcı düzeyi erişim noktalarının bilgilerini sorgulamaya yönelik örnek istek

    GET /?accessPoint&max-keys=10&continuation-token=abc HTTP/1.1
    Date: Mon, 19 Jun 2023 03:15:40 GMT
    Content-Length: 36
    Content-Type: application/xml
    Host: oss-cn-hangzhou.aliyuncs.com 
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e    

    Paket düzeyi erişim noktalarının bilgilerini sorgulamaya yönelik örnek istek

    GET /?accessPoint&max-keys=10&continuation-token=abc HTTP/1.1
    Date: Mon, 19 Jun 2023 03:15:40 GMT
    Content-Length: 36
    Content-Type: application/xml
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com 
    Authorization: OSS qn6q**************:77Dv****************    
  • Örnek yanıt

    HTTP/1.1 200
    <?xml version="1.0" encoding="UTF-8"?>
    <ListAccessPointsResult>
      <IsTruncated>true</IsTruncated>
      <NextContinuationToken>abc</NextContinuationToken>
      <AccountId>111933544165****</AccountId>
      <AccessPoints>
        <AccessPoint>
          <Bucket>oss-example</Bucket>
          <AccessPointName>ap-01</AccessPointName>
          <Alias>ap-01-ossalias</Alias>
          <NetworkOrigin>vpc</NetworkOrigin>
          <VpcConfiguration>
            <VpcId>vpc-t4nlw426y44rd3iq4****</VpcId>
          </VpcConfiguration>
          <Status>enable</Status>
        </AccessPoint>
        ...
      </AccessPoints>
    </ListAccessPointsResult>

ossutil

ListAccessPoints işlemine karşılık gelen ossutil komutu hakkında bilgi için bkz. list-access-points.