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\"}"