すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:CreateAccessPoint

最終更新日:Apr 08, 2024

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

使用上の注意

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

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

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

リクエスト構文

PUT /?accessPoint HTTP/1.1
日付: GMT日付
Content-Length: ContentLength
Content-Type: application/xml
ホスト: BucketName.oss-cn-hangzhou.aliyuncs.com
権限付与: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<CreateAccessPointConfiguration>
  	<AccessPointName>ap-01</AccessPointName>
    <NetworkOrigin>vpc</NetworkOrigin>
    <VpcConfiguration>
      <VpcId>vpc-t4nlw426y44rd3iq4 ****</VpcId>
    </VpcConfiguration>
</CreateAccessPointConfiguration> 

リクエストヘッダー

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

リクエスト要素

要素

データ型

必須

説明

CreateAccessPointConfiguration

Container

必須

N/A

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

親ノード: なし

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

AccessPointName

String

必須

ap-01

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

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

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

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

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

親ノード: CreateAccessPointConfiguration

子ノード: なし

NetworkOrigin

String

必須

vpc

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

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

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

親ノード: CreateAccessPointConfiguration

子ノード: なし

VpcConfiguration

Container

任意

N/A

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

親ノード: CreateAccessPointConfiguration

子ノード: VpcId

VpcId

String

任意

vpc-t4nlw426y44rd3iq4 ****

NetworkOrigin要素がVPCに設定されている場合にのみ必要なvpcのID。

親ノード: VpcId

子ノード: なし

レスポンスヘッダー

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

レスポンス要素

要素

データ型

説明

CreateAccessPointResult

Container

N/A

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

子ノード: AccessPointArnとAlias

AccessPointArn

String

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

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

Alias

String

ap-01-45ee7945007a2f0bcb595f63e2215c ****-ossalias

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

  • リクエストの例

    PUT /?accessPoint HTTP/1.1
    日付: 6月19日月曜日2023 03:15:40 GMT
    コンテンツ長: 0
    Content-Type: application/xml
    ホスト: oss-example.oss-cn-hangzhou.aliyuncs.com
    権限付与: OSS qn6qrrqxo2oawuk53otf ****:ceOEyZavKY4QcjoUWYSpYbJ3 ****
    <?xml version="1.0" encoding="UTF-8"?>
    <CreateAccessPointConfiguration>
      	<AccessPointName>ap-01</AccessPointName>
        <NetworkOrigin>vpc</NetworkOrigin>
        <VpcConfiguration>
          <VpcId>vpc-t4nlw426y44rd3iq4 ****</VpcId>
        </VpcConfiguration>
    </CreateAccessPointConfiguration> 
  • レスポンスの例

    HTTP/1.1 200 OK
    x-oss-request-id: 5C1B138A109F4E405B2D ****
    日付: 6月19日月曜日2023 03:15:40 GMT
    コンテンツ長: 0
    接続: キープアライブ
    サーバー: AliyunOSS
    <?xml version="1.0" encoding="UTF-8"?>
    <CreateAccessPointResult>
      <AccessPointArn>acs:oss:cn-hangzhou:128364106451 ****:accesspoint/ap-01</AccessPointArn>
      <エイリアス> ap-01-45ee7945007a2f0bcb595f63e2215c ****-ossalias</エイリアス>
    </CreateAccessPointResult>