すべてのプロダクト
Search

このプロダクト

    Object Storage Service:GetAccessPoint

    ドキュメントセンター

    Object Storage Service:GetAccessPoint

    最終更新日:Jun 19, 2026

    指定したアクセスポイントの設定とステータスを照会します。

    使用上の注意

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

    リクエスト構文

    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

    リクエストヘッダー

    ヘッダー

    タイプ

    必須

    例

    説明

    x-oss-access-point-name

    String

    はい

    ap-01

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

    このリクエストには、Date や Authorization などの共通リクエストヘッダーも含まれます。詳細については、「共通リクエストヘッダー」をご参照ください。

    レスポンスヘッダー

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

    レスポンス要素

    要素

    タイプ

    例

    説明

    GetAccessPointResult

    コンテナ

    N/A

    アクセスポイント情報のコンテナ。

    親ノード：なし

    子ノード：AccessPointName、Bucket、AccountId、NetworkOrigin、VpcConfiguration、AccessPointArn、CreationDate、Alias、Status、Endpoints、PublicAccessBlockConfiguration

    AccessPointName

    String

    ap-01

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

    親ノード：GetAccessPointResult

    子ノード：なし

    Bucket

    String

    oss-example

    アクセスポイントに関連付けられているバケットの名前。

    親ノード：GetAccessPointResult

    子ノード：なし

    AccountId

    String

    111933544165xxxx

    アクセスポイントを所有する Alibaba Cloud アカウントの ID。

    親ノード：GetAccessPointResult

    子ノード：なし

    NetworkOrigin

    String

    vpc

    アクセスポイントのネットワーク起点。有効な値：

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

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

    親ノード：GetAccessPointResult

    子ノード：なし

    VpcConfiguration

    コンテナ

    N/A

    VPC 情報のコンテナ。

    親ノード：GetAccessPointResult

    子ノード：VpcId

    VpcId

    String

    vpc-t4nlw426y44rd3iq4xxxx

    VPC の ID。

    親ノード：VpcConfiguration

    子ノード：なし

    AccessPointArn

    String

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

    アクセスポイントの Alibaba Cloud リソースネーム (ARN)。

    親ノード：GetAccessPointResult

    子ノード：なし

    CreationDate

    String

    1626769503

    アクセスポイントが作成された時刻 (UNIX タイムスタンプ)。

    親ノード：GetAccessPointResult

    子ノード：なし

    Alias

    String

    ap-01-ossalias

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

    親ノード：GetAccessPointResult

    子ノード：なし

    Status

    enable

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

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

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

    • creating：アクセスポイントは作成中です。

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

    親ノード：GetAccessPointResult

    子ノード：なし

    Endpoints

    コンテナ

    N/A

    アクセスポイントのエンドポイント情報のコンテナ。

    親ノード：GetAccessPointResult

    子ノード：PublicEndpoint、InternalEndpoint

    PublicEndpoint

    String

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

    アクセスポイントのパブリックエンドポイント。

    親ノード：Endpoints

    子ノード：なし

    InternalEndpoint

    String

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

    アクセスポイントの内部エンドポイント。

    親ノード：Endpoints

    子ノード：なし

    PublicAccessBlockConfiguration

    コンテナ

    N/A

    パブリックアクセスブロック設定のコンテナ。

    親ノード：GetAccessPointResult

    子ノード：BlockPublicAccess

    BlockPublicAccess

    Boolean

    true

    アクセスポイントでパブリックアクセスブロックが有効になっているかどうかを指定します。

    • true：パブリックアクセスブロックが有効になっています。

    • false：パブリックアクセスブロックが無効になっています。

    親ノード：PublicAccessBlockConfiguration

    子ノード：なし

    例

    • リクエストの例

      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

    • 正常なレスポンスの例

      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

    GetAccessPoint 操作に対応する ossutil コマンドについては、 「get-access-point」をご参照ください。