すべてのプロダクト
Search

このプロダクト

    Object Storage Service:CreateAccessPoint

    ドキュメントセンター

    Object Storage Service:CreateAccessPoint

    最終更新日:Sep 25, 2024

    アクセスポイントを作成します。

    使用上の注意

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

    • Alibaba Cloudアカウントに最大1,000のアクセスポイントを作成できます。

    • バケットに最大100のアクセスポイントを作成できます。

    リクエスト構文

    PUT /?accessPoint HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<CreateAccessPointConfiguration>
  	<AccessPointName>ap-01</AccessPointName>
    <NetworkOrigin>vpc</NetworkOrigin>
    <VpcConfiguration>
      <VpcId>vpc-t4nlw426y44rd3iq4xxxx</VpcId>
    </VpcConfiguration>
</CreateAccessPointConfiguration>

    リクエストヘッダー

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

    リクエスト要素

    要素

    データ型

    必須

    例

    説明

    CreateAccessPointConfiguration

    Container

    あり

    非該当

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

    親ノード: なし

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

    AccessPointName

    String

    あり

    ap-01

    アクセスポイントの名前。 アクセスポイントの名前は、次の要件を満たす必要があります。

    • 名前は、Alibaba Cloudアカウントのリージョンで一意である必要があります。

    • 名前は-ossaliasで終わることはできません。

    • 名前には、小文字、数字、ハイフン (-) のみを使用できます。 ハイフン (-) で開始または終了することはできません。

    • 名前は3 ~ 19文字である必要があります。

    親ノード: CreateAccessPointConfiguration

    子ノード: なし

    NetworkOrigin

    String

    あり

    vpc

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

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

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

    親ノード: CreateAccessPointConfiguration

    子ノード: なし

    VpcConfiguration

    Container

    なし

    非該当

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

    親ノード: CreateAccessPointConfiguration

    子ノード: VpcId

    VpcId

    String

    なし

    vpc-t4nlw426y44rd3iq4xxxx

    VPC の ID です。 VPC IDは、NetworkOriginパラメーターをvpcに設定した場合にのみ必要です。

    重要

    アクセスポイントを使用してVPCを制限する場合は、VPCのリージョンがOSSでサポートされているゲートウェイエンドポイントのリージョンと一致していることを確認してください。 そうしないと、認証リクエストを対応するVPCに関連付けることができず、認証が失敗します。 詳細については、「OSSでサポートされているゲートウェイエンドポイントのリージョン」をご参照ください。

    親ノード: VpcId

    子ノード: なし

    レスポンスヘッダー

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

    レスポンス要素

    要素

    データ型

    例

    説明

    CreateAccessPointResult

    Container

    非該当

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

    子ノード: AccessPointArnとAlias

    AccessPointArn

    String

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

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

    Alias

    String

    ap-01-45ee7945007a2f0bcb595f63e2215cxxxx-ossalias

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

    例

    • リクエストの例

      PUT /?accessPoint HTTP/1.1
Date: Mon, 19 Jun 2023 03:15:40 GMT
Content-Length: 0
Content-Type: application/xml
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS qn6q**************:77Dv****************    
<?xml version="1.0" encoding="UTF-8"?>
<CreateAccessPointConfiguration>
  	<AccessPointName>ap-01</AccessPointName>
    <NetworkOrigin>vpc</NetworkOrigin>
    <VpcConfiguration>
      <VpcId>vpc-t4nlw426y44rd3iq4xxxx</VpcId>
    </VpcConfiguration>
</CreateAccessPointConfiguration>

    • 正常に処理された場合のレスポンス例

      HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2Dxxxx
Date: Mon, 19 Jun 2023 03:15:40 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<CreateAccessPointResult>
  <AccessPointArn>acs:oss:cn-hangzhou:128364106451xxxx:accesspoint/ap-01</AccessPointArn>
  <Alias>ap-01-45ee7945007a2f0bcb595f63e2215cxxxx-ossalias</Alias>
</CreateAccessPointResult>