OSS アクセスポイントの作成 - CreateAccessPoint API - Object Storage Service

注意事項

デフォルトでは、Alibaba Cloud アカウントはこの権限を持っています。 RAM ユーザーまたは 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>

リクエストヘッダー

この操作では、共通リクエストヘッダーのみを使用します。

リクエスト要素

要素	タイプ	必須	例	説明
CreateAccessPointConfiguration	コンテナー	はい	該当なし	アクセスポイント設定のコンテナーです。親ノード：なし子ノード： AccessPointName、NetworkOrigin、VpcConfiguration
AccessPointName	文字列	はい	ap-01	アクセスポイント名。命名要件： Alibaba Cloud アカウントの同一リージョン内で一意である必要があります。 -ossalias で終わることはできません。小文字、数字、ハイフン (-) のみを含めることができます。ハイフンで開始または終了することはできません。長さは 3～19 文字です。親ノード： CreateAccessPointConfiguration 子ノード：なし
NetworkOrigin	文字列	はい	vpc	ネットワークオリジン。有効な値： vpc：特定の Virtual Private Cloud (VPC) 経由でアクセスポイントにアクセスします。 internet：パブリックエンドポイントまたは内部エンドポイント経由でアクセスポイントにアクセスします。親ノード： CreateAccessPointConfiguration 子ノード：なし
VpcConfiguration	コンテナー	いいえ	該当なし	VPC 設定のコンテナーです。親ノード： CreateAccessPointConfiguration 子ノード： VpcId
VpcId	文字列	いいえ	vpc-t4nlw426y44rd3iq4xxxx	VPC ID。 NetworkOrigin が vpc に設定されている場合にのみ必須です。重要アクセスポイントで VPC アクセスを制限する場合、VPC のリージョンが OSS ゲートウェイエンドポイントのリージョンと一致していることを確認してください。リージョンが一致しない場合、認証に失敗します。詳細については、「OSS でサポートされているゲートウェイエンドポイントのリージョン」をご参照ください。親ノード： VpcConfiguration 子ノード：なし

レスポンスヘッダー

この操作は、共通レスポンスヘッダーのみを返します。

レスポンス要素

要素	タイプ	例	説明
CreateAccessPointResult	コンテナー	該当なし	アクセスポイント作成結果のコンテナーです。子ノード： AccessPointArn、Alias
AccessPointArn	文字列	acs:oss:cn-hangzhou:128364106451xxxx:accesspoint/ap-01	アクセスポイントの Alibaba Cloud リソースネーム (ARN) です。
Alias	文字列	ap-01-45ee7945007a2f0bcb595f63e2215cxxxx-ossalias	アクセスポイントのエイリアスです。

例

リクエスト例

PUT /?accessPoint HTTP/1.1
Date: Mon, 19 Jun 2023 03:15:40 GMT
Content-Length: 292
Content-Type: application/xml
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e    
<?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: 281
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 API に対応する ossutil コマンドの詳細については、「create-access-point」をご参照ください。