create-access-point_对象存储(OSS)-阿里云帮助中心

create-access-point用于为存储空间（Bucket）创建接入点。

注意事项

阿里云账号默认拥有创建接入点所需的权限。如果您需要通过RAM用户或者STS的方式进行创建，您必须拥有oss:CreateAccessPoint权限。具体操作，请参见为RAM用户授权自定义的权限策略。
单个阿里云账号支持创建1000个接入点。
单个Bucket支持创建100个接入点。

命令格式

ossutil api create-access-point --bucket value --create-access-point-configuration value [flags]

参数	类型	说明
--bucket	string	Bucket名称。
--create-access-point-configuration	string	保存接入点信息的容器。

说明

create-access-point命令对应API接口CreateAccessPoint。关于API中的具体参数含义，请参见CreateAccessPoint。

--create-access-point-configuration

--create-access-point-configuration配置选项既支持XML语法也支持JSON语法，当选项值包含file://前缀时，表示从文件中读取配置。

XML语法：

<CreateAccessPointConfiguration>
  <VpcConfiguration>
    <VpcId>string</VpcId>
  </VpcConfiguration>
  <AccessPointName>string</AccessPointName>
  <NetworkOrigin>string</NetworkOrigin>
</CreateAccessPointConfiguration>

JSON语法：

{
  "AccessPointName": "string",
  "NetworkOrigin": "string",
  "VpcConfiguration": {
    "VpcId": "string"
  }
}

说明

关于支持的全局命令行选项，请参见支持的全局命令行选项。

使用示例

为存储空间examplebucket创建接入点名称为"ap-01"的接入点。

使用XML配置文件，create-access-point-configuration.xml内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<CreateAccessPointConfiguration>
    <AccessPointName>ap-01</AccessPointName>
    <NetworkOrigin>internet</NetworkOrigin>
</CreateAccessPointConfiguration>

命令示例如下：

ossutil api create-access-point --bucket examplebucket --create-access-point-configuration file://create-access-point-configuration.xml

使用JSON配置文件，create-access-point-configuration.json 内容如下：

{
  "AccessPointName": "ap-01",
  "NetworkOrigin": "internet"
}

命令示例如下：

ossutil api create-access-point --bucket examplebucket --create-access-point-configuration file://create-access-monitor-configuration.json

使用JSON配置参数，命令示例如下：

ossutil api create-access-point --bucket examplebucket --create-access-point-configuration  "{\"AccessPointName\":\"ap-01\",\"NetworkOrigin\":\"internet\"}"