すべてのプロダクト
Search

このプロダクト

    Object Storage Service:GetAccessPoint

    ドキュメントセンター

    Object Storage Service:GetAccessPoint

    最終更新日:Feb 27, 2025

    アクセスポイントに関する情報をクエリします。

    使用上の注意

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

    リクエスト構文

    GET /?accessPoint HTTP/1.1
Date: GMT 日付
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 など、他の一般的なリクエストヘッダーが含まれています。 詳細については、「共通リクエストヘッダー」をご参照ください。

    レスポンスヘッダー

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

    レスポンス要素

    要素

    タイプ

    例

    説明

    GetAccessPointResult

    コンテナー

    N/A

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

    親ノード: なし

    子ノード: AccessPointName、Bucket、AccountId、NetworkOrigin、VpcConfiguration、AccessPointArn、CreationDate、Alias、Status、および Endpoints

    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 Resource Name (ARN)。

    親ノード: GetAccessPointResult

    子ノード: なし

    CreationDate

    String

    1626769503

    アクセスポイントが作成された時刻。値はタイムスタンプです。

    親ノード: 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

    ブール値

    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: OSS qn6q**************:77Dv****************

    • 成功レスポンスの例

      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」をご参照ください。