すべてのプロダクト
Search

このプロダクト

    Object Storage Service:GetAccessPoint

    ドキュメントセンター

    Object Storage Service:GetAccessPoint

    最終更新日:Apr 08, 2024

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

    使用上の注意

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

    リクエスト構文

    GET /?accessPoint HTTP/1.1
日付: GMT日付
Content-Length: ContentLength
Content-Type: ContentType
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
x-oss-access-point-name: apname
権限付与: SignatureValue

    リクエストヘッダー

    ヘッダー

    データ型

    必須

    例

    説明

    x-oss-アクセスポイント名

    String

    必須

    ap-01

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

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

    レスポンスヘッダー

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

    レスポンス要素

    要素

    データ型

    例

    説明

    GetAccessPointResult

    Container

    N/A

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

    親ノード: なし

    子ノード: AccessPointName、Bucket、AccountId、NetworkOrigin、VpcConfiguration、AccessPointArn、CreationDate、Alias、Status、およびエンドポイント

    AccessPointName

    String

    ap-01

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

    親ノード: GetAccessPointResult

    子ノード: なし

    バケット

    String

    oss-example

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

    親ノード: GetAccessPointResult

    子ノード: なし

    AccountId

    String

    111933544165xxxx

    アクセスポイントが設定されているAlibaba CloudアカウントのID。

    親ノード: GetAccessPointResult

    子ノード: なし

    NetworkOrigin

    String

    vpc

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

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

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

    親ノード: GetAccessPointResult

    子ノード: なし

    VpcConfiguration

    Container

    N/A

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

    親ノード: GetAccessPointResult

    子ノード: VpcId

    VpcId

    String

    vpc-t4nlw426y44rd3iq4xxxx

    VPC の ID です。

    親ノード: VpcConfiguration

    子ノード: なし

    AccessPointArn

    String

    arn:acs:oss:cn-hangzhou:111933544165xxxx: アクセスポイント /ap-01

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

    親ノード: GetAccessPointResult

    子ノード: なし

    CreationDate

    String

    1626769503

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

    親ノード: GetAccessPointResult

    子ノード: なし

    Alias

    String

    ap-01-ossalias

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

    親ノード: GetAccessPointResult

    子ノード: なし

    Status

    enable

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

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

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

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

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

    親ノード: GetAccessPointResult

    子ノード: なし

    エンドポイント

    Container

    N/A

    アクセスポイントに関するネットワークオリジン情報を格納するコンテナー。

    親ノード: GetAccessPointResult

    子ノード: PublicEndpointおよびInternalEndpoint

    PublicEndpoint

    String

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

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

    親ノード: エンドポイント

    子ノード: なし

    InternalEndpoint

    String

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

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

    親ノード: エンドポイント

    子ノード: なし

    PublicAccessBlockConfiguration

    Container

    N/A

    ブロックパブリックアクセス設定を格納するコンテナー。

    親ノード: GetAccessPointResult

    子ノード: BlockPublicAccess

    BlockPublicAccess

    Boolean

    true

    アクセスポイントに対してブロックパブリックアクセスが有効かどうかを示します。

    • true: ブロックパブリックアクセスが有効です。

    • false: ブロックパブリックアクセスは無効です。

    親ノード: PublicAccessBlockConfiguration

    子ノード: なし

    例

    • リクエストの例

      GET /?accessPoint HTTP/1.1
日付: 6月19日月曜日2023 03:15:40 GMT
コンテンツ-長さ: 10
Content-Type: application/xml
ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
x-oss-access-point-name: ap-01
権限付与: OSS qn6qrrqxo2oawuk53otfxxxx:ceOEyZavKY4QcjoUWYSpYbJ3xxxx

    • 通常のレスポンス例

      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>
  <エイリアス> ap-01-ossalias</エイリアス>
  <Status>enable</Status>
  <エンドポイント>
    <PublicEndpoin t>ap-01.oss-cn-hangzhou.oss-accesspoint.aliyuncs.com</PublicEndpoint>
    <InternalEndpoin t>ap-01.oss-cn-hangzhou-internal.oss-accesspoint.aliyuncs.com</InternalEndpoint>
  </エンドポイント>
  <PublicAccessBlockConfiguration>
    <BlockPublicAccess>true</BlockPublicAccess>
  </PublicAccessBlockConfiguration>
</GetAccessPointResult>