ModifyInstance API を呼び出して仕様を変更 - Bastionhost

Bastionhost には、インスタンスの構成を変更するための専用 API オペレーションはありません。Bastionhost インスタンスの構成を変更するには、Alibaba Cloud Billing Management API が提供する ModifyInstance オペレーションを呼び出します。

背景情報

Alibaba Cloud Billing Management API は、Alibaba Cloud のリソースを管理するために使用できる一連の共通 API オペレーションです。これらのオペレーションを使用して、サービスの価格のクエリ、インスタンスの管理、請求情報の取得ができます。サポートされているすべての API オペレーションの詳細については、「API の概要」をご参照ください。

Alibaba Cloud Billing Management API の ModifyInstance オペレーションを呼び出して、Bastionhost インスタンスの構成を変更できます。このオペレーションの呼び出し方法の詳細については、「リクエストの構造」をご参照ください。

このトピックでは、リクエストパラメーターについて説明し、ModifyInstance オペレーションを呼び出して Bastionhost インスタンスの構成を変更する方法の例を示します。

デバッグ

この操作を OpenAPI Explorer で実行すると、API 呼び出しが簡単になります。OpenAPI Explorer は、呼び出しが成功すると、自動的に署名を計算し、SDK のサンプルコードを生成します。

リクエストパラメーター

名前	タイプ	必須	説明	例
ProductCode	string	はい	プロダクトコードです。	bastionhost
ProductType	string	いいえ	プロダクトタイプです。	bastionhost
SubscriptionType	string	はい	課金方法です。Bastionhost はサブスクリプションの課金方法を使用します。このパラメーターを Subscription に設定します。	Subscription
ModifyType	string	はい	構成変更のタイプです。有効値： Upgrade：Bastionhost インスタンスの構成をアップグレードします。 Downgrade：Bastionhost インスタンスの構成をダウングレードします。説明この機能はグレースケールリリースです。この機能を使用するには、DingTalk グループ (ID: 33797269) に参加し、プロダクトおよび技術スタッフに連絡してご相談ください。	Upgrade
InstanceId	String	はい	bastionhost-cn-****	構成を変更するインスタンスの ID です。
ClientToken	string	いいえ	リクエストのべき等性を保証するために使用されるクライアントトークンです。サーバーは、同じクライアントトークンを持つ以前のリクエストをチェックします。以前のリクエストが見つかった場合、サーバーは同じ結果を返します。	JASIOFKVNVIXXXXXX
Parameter	object []	いいえ	モジュールのリストです。
└Value	string	はい	n 番目のモジュールプロパティの値です。n の有効値：1～100。	disk
└Code	string	はい	n 番目のモジュールプロパティのコードです。n の有効値：1～100。複数のモジュールプロパティがある場合は、`n=1,2,3...n` の形式で連結します。	InstanceType

パラメーター設定

名前	タイプ	必須	値の例	説明
Parameter.1.Code	String	はい	RegionId	Bastionhost インスタンスの最初のプロパティグループのコードです。値を RegionId に設定して、Bastionhost インスタンスのリージョンを指定します。
Parameter.1.Value	String	はい	cn-shanghai	Bastionhost インスタンスの最初のプロパティグループの値です。このパラメーターは、Bastionhost インスタンスが存在するリージョンの ID を指定します。DescribeRegions オペレーションを呼び出してリージョン ID を取得できます。
Parameter.2.Code	String	はい	NetworkType	Bastionhost インスタンスの 2 番目のプロパティグループのコードです。値を NetworkType に設定して、Bastionhost インスタンスのネットワークを指定します。
Parameter.2.Value	String	はい	vpc	Bastionhost インスタンスの 2 番目のプロパティグループの値です。値を vpc に設定して、Bastionhost インスタンスが VPC ネットワークタイプを使用することを指定します。
Parameter.3.Code	String	はい	PlanCode	Bastionhost インスタンスの 3 番目のプロパティグループのコードです。値を PlanCode に設定して、Bastionhost インスタンスのエディションを指定します。
Parameter.3.Value	String	はい	cloudbastion	Bastionhost インスタンスの 3 番目のプロパティグループの値です。このパラメーターは、Bastionhost インスタンスのエディションを指定します。有効値： cloudbastion：Basic Edition。 cloudbastion_ha：Enterprise Edition。
Parameter.4.Code	String	はい	LicenseCode	Bastionhost インスタンスの 4 番目のプロパティグループのコードです。値を LicenseCode に設定して、サポートされる資産数を示す Bastionhost インスタンスのプランタイプを指定します。
Parameter.4.Value	String	はい	bhah_ult_5000_asset	Bastionhost インスタンスの 4 番目のプロパティグループの値です。このパラメーターは、Bastionhost エディションでサポートされる資産数を指定します。有効値： bhah_ent_50_asset：50 資産。この値は Basic Edition と Enterprise Edition に適用されます。 bhah_ent_100_asset：100 資産。この値は Basic Edition と Enterprise Edition に適用されます。 bhah_ent_200_asset：200 資産。この値は Basic Edition と Enterprise Edition に適用されます。 bhah_ult_500_asset：500 資産。この値は Basic Edition と Enterprise Edition に適用されます。 bhah_ult_1000_asset：1,000 資産。この値は Enterprise Edition にのみ適用されます。 bhah_ult_2000_asset：2,000 資産。この値は Enterprise Edition にのみ適用されます。 bhah_ult_5000_asset：5,000 資産。この値は Enterprise Edition にのみ適用されます。 bhah_ult_10000_asset：10,000 資産。この値は Enterprise Edition にのみ適用されます。
Parameter.5.Code	String	はい	Storage	Bastionhost インスタンスの 5 番目のプロパティグループのコードです。値を Storage に設定して、Bastionhost インスタンスのストレージ容量を指定します。
Parameter.5.Value	String	はい	5	Bastionhost インスタンスの 5 番目のプロパティグループの値です。このパラメーターは、Bastionhost インスタンスのストレージ容量を指定します。値の範囲：0 TB～500 TB。
Parameter.6.Code	String	はい	Bandwidth	Bastionhost の 6 番目のプロパティグループの `Code` 設定で、その帯域幅を指定します。有効値：0～200。単位：Mbit/s。値は 10 の倍数である必要があります。
Parameter.6.Value	String	はい	5	Bastionhost インスタンスの 6 番目のプロパティグループの値です。このパラメーターは、Bastionhost インスタンスの帯域幅を指定します。値の範囲は 0 Mbps～200 Mbps で、10 Mbps 刻みです。

レスポンスパラメーター

名前	タイプ	例	説明
Code	String	Success	リクエストのステータスコードです。
Data	Struct		リクエストに対して返される情報です。
└InstanceId	String	bastionhost-cn-****	構成が変更されたインスタンスの ID です。
└OrderId	String	2026532523****	正常に作成された注文の ID です。
Message	String	Successful!	リクエストに対して返されるエラーメッセージです。
RequestId	String	6000EE23-274B-4E07-A697-FF2E999520A4	リクエストの ID です。
Success	Boolean	true	リクエストが成功したかどうかを示します。

例

成功レスポンスの例

XML フォーマット

<ModifyInstanceResponse>
      <Message>Successful!</Message>
      <RequestId>6000EE23-274B-4E07-A697-FF2E999520A4</RequestId>
      <Success>true</Success>
      <Code>Success</Code>
      <Data>
            <OrderId>2026532523****</OrderId>
      </Data>
</ModifyInstanceResponse>

JSON フォーマット

{
    "Message": "Successful!",
    "RequestId": "6000EE23-274B-4E07-A697-FF2E999520A4",
    "Success": true,
    "Code": "Success",
    "Data": {
        "OrderId": "2026532523****"
    }
}