アクセスポイントを作成する - Object Storage Service - Alibaba Cloud ドキュメントセンター

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

使用上の注意

デフォルトでは、Alibaba Cloud アカウントにはアクセスポイントを作成する権限があります。 RAM ユーザーまたは Security Token Service (STS) を使用してアクセスポイントを作成するには、oss:CreateAccessPoint 権限が必要です。
1 つの Alibaba Cloud アカウントにつき、最大 1,000 個のアクセスポイントを作成できます。
1 つのバケットにつき最大 100 個のアクセスポイントを作成できます。

リクエスト構文

PUT /?accessPoint HTTP/1.1
Date: GMT 日付
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	コンテナー	はい	該当なし	アクセスポイントに関する情報を格納するコンテナー。親ノード: なし子ノード: AccessPointName、NetworkOrigin、VpcConfiguration
AccessPointName	文字列	はい	ap-01	アクセスポイントの名前。アクセスポイントの名前は、以下の要件を満たしている必要があります。 Alibaba Cloud アカウントのリージョン内で一意である必要があります。 -ossalias で終わることはできません。小文字、数字、およびハイフン (-) のみを含めることができます。ハイフン (-) で開始または終了することはできません。 3 ～ 19 文字の長さである必要があります。親ノード: CreateAccessPointConfiguration 子ノード: なし
NetworkOrigin	文字列	はい	vpc	アクセスポイントのネットワークオリジン。有効な値: vpc: 特定の VPC ID を使用してアクセスポイントにアクセスできます。 internet: パブリックエンドポイントと内部エンドポイントを使用してアクセスポイントにアクセスできます。親ノード: CreateAccessPointConfiguration 子ノード: なし
VpcConfiguration	コンテナー	いいえ	該当なし	VPC に関する情報を格納するコンテナー。親ノード: CreateAccessPointConfiguration 子ノード: VpcId
VpcId	文字列	いいえ	vpc-t4nlw426y44rd3iq4xxxx	VPC の ID。 VPC ID は、NetworkOrigin パラメーターを vpc に設定した場合にのみ必要です。重要アクセスポイントを使用して VPC を制限する場合は、VPC のリージョンが OSS でサポートされているゲートウェイエンドポイントのリージョンと一致していることを確認してください。そうしないと、認証リクエストを対応する VPC に関連付けることができず、認証エラーが発生します。詳細については、「OSS でサポートされているゲートウェイエンドポイントのリージョン」をご参照ください。親ノード: VpcId 子ノード: なし

レスポンスヘッダー

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

レスポンス要素

要素	タイプ	例	説明
CreateAccessPointResult	コンテナー	該当なし	アクセスポイントに関する情報を格納するコンテナー。子ノード: AccessPointArn と Alias
AccessPointArn	文字列	acs:oss:cn-hangzhou:128364106451xxxx:accesspoint/ap-01	アクセスポイントの Alibaba Cloud Resource Name (ARN)。
Alias	文字列	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>

ossutil

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