すべてのプロダクト
Search

このプロダクト

    Object Storage Service:ListAccessPoints

    ドキュメントセンター

    Object Storage Service:ListAccessPoints

    最終更新日:Jun 03, 2025

    ユーザーレベルまたはバケットレベルのアクセスポイントに関する情報をクエリします。

    使用方法

    デフォルトでは、Alibaba Cloud アカウントにはアクセスポイントに関する情報をクエリする権限があります。 RAM ユーザーまたは Security Token Service (STS) を使用してアクセスポイントに関する情報をクエリするには、oss:ListAccessPoints 権限が必要です。

    リクエスト構文

    ユーザーレベルのアクセスポイントに関する情報のクエリとバケットレベルのアクセスポイントに関する情報のクエリの違いは、リクエストホストにあります。 ユーザーレベルのアクセスポイントに関する情報のクエリに使用されるリクエストホストは、パブリックエンドポイント（例：oss-cn-hangzhou.aliyuncs.com）または内部エンドポイント（例：oss-cn-hangzhou-internal.aliyuncs.com）です。 バケットレベルのアクセスポイントに関する情報のクエリに使用されるリクエストホストは、バケットドメイン名（例：oss-example.oss-cn-hangzhou.aliyuncs.com）です。

    ユーザーレベルのアクセスポイントに関する情報をクエリする

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

    バケットレベルのアクセスポイントに関する情報をクエリする

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

    リクエストヘッダー

    ListAccessPoints リクエストのすべてのヘッダーは、共通のリクエストヘッダーです。 詳細については、「共通の HTTP ヘッダー」をご参照ください。

    リクエスト要素

    要素

    タイプ

    必須

    例

    説明

    max-keys

    文字列

    いいえ

    10

    返されるアクセスポイントの最大数。有効な値：

    • ユーザーレベルのアクセスポイントの場合: (0,1000]。

    • バケットレベルのアクセスポイントの場合: (0,100]。

    説明

    max-keys 要素の構成により、リストを一度に完了できない場合、NextContinuationToken 要素が次のリストのトークンとして応答に含まれます。

    continuation-token

    文字列

    いいえ

    abc

    リスト操作を開始する必要があるトークン。 このトークンは、応答の NextContinuationToken 要素から取得できます。

    レスポンスヘッダー

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

    レスポンス要素

    要素

    タイプ

    例

    説明

    ListAccessPointsResult

    コンテナー

    N/A

    リスト結果に関する情報を格納するコンテナー。

    親ノード: なし

    子ノード: IsTruncated、NextContinuationToken、AccountId、および AccessPoints

    IsTruncated

    ブール値

    true

    返された結果が切り捨てられているかどうかを示します。有効な値：

    • true: リクエストに対してすべての結果が返されるわけではないことを示します。

    • false: リクエストに対してすべての結果が返されることを示します。

    親ノード: ListAccessPointsResult

    子ノード: なし

    NextContinuationToken

    文字列

    abc

    この ListAccessPoints リクエストに後続の結果が含まれていることを示します。 リスト結果の取得を続行するには、NextContinuationToken を continuation-token に設定する必要があります。

    親ノード: ListAccessPointsResult

    子ノード: なし

    AccountId

    文字列

    111933544165****

    アクセスポイントが属する Alibaba Cloud アカウントの ID。

    親ノード: ListAccessPointsResult

    子ノード: なし

    AccessPoints

    コンテナー

    N/A

    すべてのアクセスポイントに関する情報を格納するコンテナー。

    親ノード: ListAccessPointsResult

    子ノード: AccessPoint

    AccessPoint

    コンテナー

    N/A

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

    親ノード: AccessPoints

    子ノード: Bucket、AccessPointName、Alias、NetworkOrigin、VpcConfiguration、および Status

    Bucket

    文字列

    oss-example

    アクセスポイントが構成されているバケットの名前。

    親ノード: AccessPoint

    子ノード: なし

    AccessPointName

    文字列

    ap-01

    アクセスポイントの名前。

    親ノード: AccessPoint

    子ノード: なし

    Alias

    文字列

    ap-01-ossalias

    アクセスポイントのエイリアス。

    親ノード: AccessPoint

    子ノード: なし

    NetworkOrigin

    文字列

    vpc

    アクセスポイントのネットワークオリジン。有効な値：

    • vpc: 特定の VPC ID を使用してアクセスポイントにアクセスできます。

    • internet: パブリックエンドポイントと内部エンドポイントを使用してアクセスポイントにアクセスできます。

    親ノード: AccessPoint

    子ノード: なし

    VpcConfiguration

    コンテナー

    N/A

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

    親ノード: AccessPoint

    子ノード: VpcId

    VpcId

    文字列

    vpc-t4nlw426y44rd3iq4****

    VPC の ID。

    親ノード: VpcConfiguration

    子ノード: なし

    Status

    enable

    アクセスポイントのステータス。有効な値：

    • enable: アクセスポイントが作成されています。

    • disable: アクセスポイントが無効になっています。

    • creating: アクセスポイントが作成されています。

    • deleting: アクセスポイントが削除されています。

    親ノード: AccessPoint

    子ノード: VpcId

    例

    • サンプルリクエスト

      ユーザーレベルのアクセスポイントに関する情報をクエリするためのサンプルリクエスト

      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

      バケットレベルのアクセスポイントに関する情報をクエリするためのサンプルリクエスト

      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****************

    • サンプルレスポンス

      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 操作に対応する ossutil コマンドについては、「list-access-points」をご参照ください。