顧客が製品の購入を完了すると、Alibaba Cloud Marketplace はこのサービスプロバイダーインターフェイス (SPI) を呼び出してインスタンスを作成します。
-
各アプリケーションインスタンスに一意の識別子 (
instanceId) を返します。Alibaba Cloud Marketplace は、更新や有効期限切れなどの後続の操作にこの識別子を使用します。 -
orderBizIdパラメーターの値をinstanceIdとして使用することを推奨します。 -
この呼び出しをブロックしないでください。操作に時間がかかる場合は、キューを使用してバッファリングし、
instanceId=0を設定してすぐに返します。操作が失敗した場合も、instanceId=0を設定します。Alibaba Cloud Marketplace は、有効なinstanceIdを受信するまで呼び出しを再試行します (最大 120 回)。 -
この呼び出しは複数回実行される可能性があります。エンドポイントがべき等であることを確認してください。
-
追加課金項目を含む製品の場合、API リクエストには、これらの項目のパラメータが他のパラメータと同じレベルで含まれます。パラメータキーは、製品の公開時に指定したキーと一致し、値は顧客が選択した内容です。たとえば、「Count」と「Num」というキーを持つ 2 つの追加課金項目があり、顧客が Count = 2 および Num = 3 で注文した場合、これらのパラメータとその値がリクエストに含まれます。サービスを初期化し、これらの値を記録する必要があります。
パラメータ
|
パラメータ |
必須 |
タイプ |
説明 |
|
action |
true |
String |
実行する操作。値は |
|
aliUid |
true |
String |
顧客の Alibaba Cloud アカウント ID。 |
|
orderBizId |
true |
String |
Alibaba Cloud Marketplace ビジネスインスタンス ID。 |
|
orderId |
true |
String |
Alibaba Cloud Marketplace 注文 ID。 |
|
ecsInstanceId |
false |
String |
Elastic Compute Service (ECS) インスタンス ID。このパラメータは、イメージベースの製品のインスタンスに必要です。 |
|
productCode |
true |
String |
Alibaba Cloud Marketplace 製品コード。 |
|
skuId |
true |
String |
製品仕様の ID。 |
|
trial |
true |
Boolean |
購入がトライアルかどうかを示します。 |
|
expiredOn |
false |
DateTime |
インスタンスの有効期限。形式： |
|
template |
false |
String |
テンプレート ID。このパラメータは、テンプレートベースの Web サイトビルダー製品に適用されます。 |
|
token |
true |
String |
トークン。 |
レスポンス
|
パラメータ |
説明 |
必須 |
タイプ |
キー |
キーの説明 |
|
instanceId |
サービスプロバイダーがインスタンスに割り当てる一意の識別子。 |
true |
String |
- |
- |
|
hostInfo |
購入者コンソールの [購入済みサービス] ページに表示されるホストおよび ICP 登録情報。 |
false |
JSON |
name |
ホスト名 |
|
ip |
サーバーの IP アドレス。 |
||||
|
innerIp |
サーバーのプライベート IP アドレス。 |
||||
|
username |
サーバーアカウントのユーザー名。 |
||||
|
password |
サーバーアカウントのパスワード。 |
||||
|
cname |
サーバーの CNAME。 |
||||
|
tempDomain |
一時ドメイン名。 |
||||
|
ftpUsername |
FTP ユーザー名。 |
||||
|
ftpPassword |
FTP パスワード。 |
||||
|
region |
リージョン情報。 |
||||
|
beianInfo |
ICP 登録アドレス。 |
||||
|
databaseInfo |
データベース情報。 |
||||
|
appInfo |
購入者コンソールの [購入済みサービス] ページに表示されるアプリケーション情報。 |
false |
JSON |
frontEndUrl |
フロントエンド URL。 |
|
adminUrl |
管理 URL。 |
||||
|
username |
管理者ユーザー名。 |
||||
|
password |
管理者パスワード。 |
||||
|
authUrl |
シングルサインオン (SSO) URL。 |
||||
|
licenseId |
ライセンス ID。 |
||||
|
licenseValidPeriod |
ライセンスの有効期間。 |
||||
|
licenseForUserGuide |
ユーザーガイドの URL。 |
||||
|
appKey |
大規模言語モデルサービス用の AppKey。 |
||||
|
info |
購入者コンソールの [購入済みサービス] ページに表示される備考。 |
false |
JSON |
- |
カスタムのキーと値のデータ。 |
リクエスト例
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. インスタンスの作成時に、顧客が購入した製品と仕様を特定するにはどうすればよいですか。
productCode パラメータは、購入した製品のコードです。このコードは、サービスプロバイダーコンソールの製品管理ページの [製品コード] 列で確認できます。
製品に複数の製品仕様がある場合、skuId パラメータは仕様コードに対応します。このコードは、[製品リリース] > [製品販売情報] で確認できます。
たとえば、[製品販売情報] ページで、Enterprise Edition の仕様コードは yuncode4757500001、Flagship Edition のコードは yuncode4757500002 になる場合があります。