调用CreateGatewayCacheDisk在网关下创建缓存盘_云存储网关(CSG)-阿里云帮助中心

接口说明

使用该接口时，需要注意如下事项：

仅对线上网关有效
如果网关是预付费，该接口会返回一个buyURL，需要完成支付后，缓存盘会被自动创建完成。
如果网关是后付费，该接口会返回对应创建缓存盘的任务ID。

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	CreateGatewayCacheDisk	系统规定参数。取值：CreateGatewayCacheDisk。
GatewayId	String	是	gw-000eg44nmxbsfwbvq***	网关ID。
CacheDiskCategory	String	否	cloud_efficiency	缓存盘的类型。取值范围： cloud_efficiency：高效云盘（默认值）。 cloud_ssd：SSD云盘。 cloud_essd：ESSD云盘。
CacheDiskSizeInGB	Long	是	100	缓存盘的容量大小。单位：GB。缓存盘容量要求：基础型网关缓存盘容量区间为40 GB~4096 GB。标准型网关缓存盘容量区间为40 GB~8192 GB。增强型和性能型网关缓存盘容量区间为40 GB~32768 GB。当CacheDiskCategory取值为cloud_essd且PerformanceLevel取值为PL2时，缓存盘容量下限为461 GB。当CacheDiskCategory取值为cloud_essd且PerformanceLevel取值为PL3时，缓存盘容量下限为1261 GB。
PerformanceLevel	String	否	PL1	ESSD云盘性能等级。当CacheDiskCategory取值为cloud_essd时需要传入此参数。取值范围： PL1 PL2 PL3

返回数据

名称	类型	示例值	描述
BuyURL	String	https://common-buy.aliyun.com/?commodityCode=hcs_sgw_csg_pre&request={"gateway_id":"gw-0007va9bnidei3s8a***","directBuy":"false","gateway_class":"standard","cache_cloud_efficiency_size":0}&regionId=cn-hangzhou#/buy	预付费情况下, 售卖链接。
TaskId	String	t-0001xv7je357xv4st***	按量付费情况下，创建缓存盘的任务ID。
RequestId	String	8E69E1A1-9076-4C8C-8ADF-ACD253886E22	请求ID。
Message	String	successful	请求结果描述。
Code	String	200	状态码。状态码为200表示请求成功。
Success	Boolean	true	请求是否成功。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateGatewayCacheDisk
&GatewayId=gw-000eg44nmxbsfwbvq***
&CacheDiskCategory=cloud_efficiency
&CacheDiskSizeInGB=100
&PerformanceLevel=PL1
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateGatewayCacheDiskResponse>
    <BuyURL>https://common-buy.aliyun.com/?commodityCode=hcs_sgw_csg_pre&amp;request={"gateway_id":"gw-0007va9bnidei3s8a***","directBuy":"false","gateway_class":"standard","cache_cloud_efficiency_size":0}&amp;regionId=cn-hangzhou#/buy</BuyURL>
    <TaskId>t-0001xv7je357xv4st***</TaskId>
    <RequestId>8E69E1A1-9076-4C8C-8ADF-ACD253886E22</RequestId>
    <Message>successful</Message>
    <Code>200</Code>
    <Success>true</Success>
</CreateGatewayCacheDiskResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "BuyURL" : "https://common-buy.aliyun.com/?commodityCode=hcs_sgw_csg_pre&request={\"gateway_id\":\"gw-0007va9bnidei3s8a***\",\"directBuy\":\"false\",\"gateway_class\":\"standard\",\"cache_cloud_efficiency_size\":0}&regionId=cn-hangzhou#/buy",
  "TaskId" : "t-0001xv7je357xv4st***",
  "RequestId" : "8E69E1A1-9076-4C8C-8ADF-ACD253886E22",
  "Message" : "successful",
  "Code" : "200",
  "Success" : true
}

错误码

HttpCode	错误码	错误信息	描述
400	LocationCloudRequired	You must specify a cloud gateway. Try again later.	需要网关为线上网关，请检查后重试。
400	BadRequest	Invalid request. You must specify valid parameters in the request.	非法请求，请检查请求参数。
400	GatewayOperationNotAllowed	You cannot perform the operation when the gateway is in the current state.	网关当前状态不允许执行该操作。
400	InvalidCacheDiskCategory	The category that you specified for the cache disk is invalid. You must specify a valid category.	无效的缓存盘类型。
400	CacheSizeLimitForBasic	The specified scale-up size exceeds the maximum limit. The maximum scale-up size of cache disks for a Basic gateway is 4 TB.	扩容量超过最大缓存盘上限，基础型网关缓存盘上限为4 TB。
400	CacheSizeLimitForStandard	The specified scale-up size exceeds the maximum limit. The maximum scale-up size of cache disks for a Standard gateway is 8 TB.	扩容量超过最大缓存盘上限，标准型网关缓存盘上限为8 TB。
400	CacheSizeLimit	The maximum size of cache disks for the gateway is 32 TB.	网关缓存盘大小上限32 TB。

访问错误中心查看更多错误码。