すべてのプロダクト
Search

このプロダクト

    Object Storage Service:ListAccessPoints

    ドキュメントセンター

    Object Storage Service:ListAccessPoints

    最終更新日:Apr 08, 2024

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

    使用上の注意

    デフォルトでは、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
日付: GMT日付
Content-Length: ContentLength
Content-Type: application/xml
ホスト: oss-cn-hangzhou.aliyuncs.com
権限付与: SignatureValue

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

    GET /?accessPoint&max-keys=10&continuation-token=abcd HTTP/1.1
日付: GMT日付
Content-Length: ContentLength
Content-Type: application/xml
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
権限付与: SignatureValue

    リクエストヘッダー

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

    リクエスト要素

    要素

    データ型

    必須

    例

    説明

    max-keys

    String

    任意

    10

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

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

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

    説明

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

    continuation-token

    String

    任意

    こんにちは

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

    レスポンスヘッダー

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

    レスポンス要素

    要素

    データ型

    例

    説明

    ListAccessPointsResult

    Container

    N/A

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

    親ノード: なし

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

    IsTruncated

    Boolean

    true

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

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

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

    親ノード: ListAccessPointsResult

    子ノード: なし

    NextContinuationToken

    String

    こんにちは

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

    親ノード: ListAccessPointsResult

    子ノード: なし

    AccountId

    String

    111933544165 ****

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

    親ノード: ListAccessPointsResult

    子ノード: なし

    AccessPoints

    Container

    N/A

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

    親ノード: ListAccessPointsResult

    子ノード: AccessPoint

    AccessPoint

    Container

    N/A

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

    親ノード: AccessPoints

    子ノード: バケット、AccessPointName、エイリアス、NetworkOrigin、VpcConfiguration、およびステータス

    バケット

    String

    oss-example

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

    親ノード: AccessPoint

    子ノード: なし

    AccessPointName

    String

    ap-01

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

    親ノード: AccessPoint

    子ノード: なし

    Alias

    String

    ap-01-ossalias

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

    親ノード: AccessPoint

    子ノード: なし

    NetworkOrigin

    String

    vpc

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

    • vpc: 特定の仮想プライベートクラウド (VPC) IDを使用してアクセスポイントにアクセスできます。

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

    親ノード: AccessPoint

    子ノード: なし

    VpcConfiguration

    Container

    N/A

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

    親ノード: AccessPoint

    子ノード: VpcId

    VpcId

    String

    vpc-t4nlw426y44rd3iq4 ****

    VPC の ID です。

    親ノード: VpcConfiguration

    子ノード: なし

    Status

    enable

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

    • enable: アクセスポイントが作成されました。

    • disable: アクセスポイントは無効です。

    • 作成: アクセスポイントが作成中です。

    • deleting: アクセスポイントが削除されました。

    親ノード: AccessPoint

    子ノード: VpcId

    例

    • リクエストの例

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

      GET /?accessPoint&max-keys=10&continuation-token=abc HTTP/1.1
日付: 6月19日月曜日2023 03:15:40 GMT
コンテンツ-長さ: 36
Content-Type: application/xml
ホスト: oss-cn-hangzhou.aliyuncs.com
権限付与: OSS qn6qrrqxo2oawuk53otf ****:ceOEyZavKY4QcjoUWYSpYbJ3 ****

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

      GET /?accessPoint&max-keys=10&continuation-token=abc HTTP/1.1
日付: 6月19日月曜日2023 03:15:40 GMT
コンテンツ-長さ: 36
Content-Type: application/xml
ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
権限付与: OSS qn6qrrqxo2oawuk53otf ****:ceOEyZavKY4QcjoUWYSpYbJ3 ****

    • レスポンスの例

      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>
      <エイリアス> ap-01-ossalias</エイリアス>
      <NetworkOrigin>vpc</NetworkOrigin>
      <VpcConfiguration>
        <VpcId>vpc-t4nlw426y44rd3iq4 ****</VpcId>
      </VpcConfiguration>
      <Status>enable</Status>
    </AccessPoint>
    ...
  </AccessPoints>
</ListAccessPointsResult>