實(shí)例創(chuàng)建
用戶購買商品并付款成功后,云市場會(huì)調(diào)用該SPI,進(jìn)行實(shí)例創(chuàng)建。
每次創(chuàng)建的應(yīng)用實(shí)例需要返回一個(gè)標(biāo)識(instanceId),后續(xù)的續(xù)費(fèi)、過期等操作云市場會(huì)繼續(xù)使用此標(biāo)識。
instanceId的值建議直接使用云市場傳入的orderBizId。
請避免阻塞此接口,若耗時(shí)較長,可使用隊(duì)列做緩沖,設(shè)置instanceId=0,然后立即返回。若操作失敗也請?jiān)O(shè)置instanceId=0,云市場都會(huì)再次調(diào)用(最多重試120次),直到獲取到真實(shí)的instanceId。
該接口可能會(huì)被多次調(diào)用,如果被重復(fù)調(diào)用,請保證接口的冪等性。
有額外計(jì)費(fèi)項(xiàng)的商品,在接口參數(shù)中會(huì)增加額外計(jì)費(fèi)項(xiàng)參數(shù),額外計(jì)費(fèi)項(xiàng)參數(shù)會(huì)作為一級參數(shù),與現(xiàn)有其他參數(shù)在同一級。額外計(jì)費(fèi)項(xiàng)參數(shù)Key與商品發(fā)布時(shí)指定的額外計(jì)費(fèi)項(xiàng)Key一致,參數(shù)值為用戶訂購時(shí)選擇的額外計(jì)費(fèi)項(xiàng)值。比如在商規(guī)格上有額外計(jì)費(fèi)項(xiàng)Key “Count”和“Num”兩個(gè),用戶下單時(shí)分別指定Count值2 && Num值3,那么參數(shù)列表中也會(huì)增加這參數(shù)Count值2和參數(shù)Num值3。服務(wù)商需要根據(jù)額外計(jì)費(fèi)項(xiàng)值為用戶做初始化,并記錄當(dāng)前的額外計(jì)費(fèi)項(xiàng)值。
參數(shù)
參數(shù) | 必選 | 類型及范圍 | 說明 |
action | true | String | 固定值:createInstance |
aliUid | true | String | 購買商品的阿里云用戶標(biāo)識 |
orderBizId | true | String | 云市場業(yè)務(wù)實(shí)例ID |
orderId | true | String | 云市場訂單ID |
productCode | true | String | 云市場商品code |
skuId | true | String | 商品規(guī)格ID |
trial | true | Boolean | 是否試用 |
expiredOn | false | DateTime | 過期時(shí)間(yyyy-MM-dd HH:mm:ss) |
template | false | String | 模板ID,適用于模板類建站商品 |
token | true | String | 安全令牌 |
返回值
參數(shù)名稱 | 參數(shù)說明 | 是否必選 | 類型及范圍 | key 名稱 | key 說明 |
instanceId | 實(shí)例 ID,服務(wù)商提供的標(biāo)識 | true | String | - | - |
hostInfo | 展示在買家控制臺已購買服務(wù)詳情的主機(jī)&備案信息 | false | JSON | name | 主機(jī)名 |
ip | 服務(wù)器IP | ||||
innerIp | 服務(wù)器內(nèi)網(wǎng)IP | ||||
username | 服務(wù)器賬號 | ||||
password | 服務(wù)器密碼 | ||||
cname | 服務(wù)器CNAME | ||||
tempDomain | 臨時(shí)域名 | ||||
ftpUsername | ftp用戶名 | ||||
ftpPassword | ftp密碼 | ||||
region | 機(jī)房信息 | ||||
beianInfo | 備案地址 | ||||
databaseInfo | 數(shù)據(jù)庫信息 | ||||
appInfo | 展示在買家控制臺已購買服務(wù)詳情的應(yīng)用信息 | false | JSON | frontEndUrl | 前臺地址 |
adminUrl | 管理地址 | ||||
username | 管理員賬號 | ||||
password | 管理員密碼 | ||||
authUrl | 免登地址 | ||||
info | 展示在買家控制臺已購買服務(wù)詳情的備注信息 | false | JSON | - | 自定義Key-Value數(shù)據(jù) |
調(diào)用示例
http://example.aliyundoc.com?
token=097a56e26a93c874140bbcdf403f****&action=createInstance&aliUid=12312****&orderId=100001&orderBizId=1&productCode=cmjj000123&skuId=sku-1
返回示例
{
"instanceId": "1",
"hostInfo": {
"name": "linux server",
"ip": "127.0.0.1",
"username": "user",
"password": "user_password"
},
"appInfo": {
"frontEndUrl": "http://example.com/",
"adminUrl": "http://example.com/admin",
"username": "admin",
"password": "admin_password"
},
"info": {
"key1": "my custom info"
}
}
常見問題
1. 創(chuàng)建實(shí)例時(shí),如何通過參數(shù)識別用戶購買的商品以及規(guī)格信息
productCode參數(shù)是用戶購買的商品編碼,對應(yīng)服務(wù)商控制臺商品管理頁面的商品編碼列。
如果商品有多個(gè)商品規(guī)格,skuId字段對應(yīng)商品的規(guī)格code,對應(yīng)商品發(fā)布-商品銷售信息的規(guī)格code。