アクセスポイントを作成します。
使用上の注意
デフォルトでは、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 | アクセスポイントの名前。 アクセスポイントの名前は、次の命名規則を満たす必要があります。
親ノード: CreateAccessPointConfiguration 子ノード: なし |
NetworkOrigin | String | 必須 | vpc | アクセスポイントのネットワークオリジン。 有効な値:
親ノード: 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>