すべてのプロダクト
Search
ドキュメントセンター

:CreateAndroidInstanceGroup

最終更新日:Nov 28, 2025

従量課金またはサブスクリプションのクラウドフォンインスタンスグループを作成します。インスタンスグループは複数のインスタンスを管理できます。類似機能を持つインスタンスを同じグループに追加することで、管理を簡素化できます。

操作説明

インスタンスグループの作成には料金が発生することにご注意ください。続行する前に、クラウドフォンインスタンスグループの課金方法を必ずご確認ください。

  • インスタンスグループの課金方法がサブスクリプション (PrePaid) の場合、AutoPay パラメーターはデフォルトで false に設定されます。API を呼び出した後、Alibaba Cloud 費用とコストに移動して、手動で注文の支払いを行ってください。

  • 自動支払いを有効にするには、AutoPay を true に設定します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

必須 / 任意

説明

BizRegionId

string

必須

リージョン ID。 DescribeRegions を呼び出して、クラウドフォンを購入できるリージョンのリストをクエリします。

列挙値:

  • cn-shenzhen :

    深セン

  • cn-beijing :

    北京

  • cn-shanghai :

    上海

  • cn-hongkong :

    中国 (香港)

  • ap-southeast-1 :

    シンガポール

  • cn-hangzhou :

    杭州

cn-hangzhou

InstanceGroupName

string

任意

インスタンスグループの名前。

説明

名前は 30 文字以内にする必要があります。先頭は英字または漢字である必要があります。`http://` または `https://` で始めることはできません。漢字、英字、数字、コロン (:)、アンダースコア (_)、ピリオド (.)、ハイフン (-) のみ使用できます。

云手机A

NumberOfInstances

integer

任意

インスタンスグループ内のインスタンス数。最大値は 100 です。

1

ChargeType

string

任意

課金方法。

列挙値:

  • PostPaid :

    従量課金

  • PrePaid :

    サブスクリプション

PostPaid

Period

integer

任意

リソースのサブスクリプション期間。単位は `PeriodUnit` パラメーターで指定します。

1

PeriodUnit

string

任意

サブスクリプション期間の単位。

列挙値:

  • Month :

  • Year :

  • Hour :

    時間。この単位は従量課金方法でのみ使用できます。

Month

InstanceGroupSpec

string

必須

インスタンスグループの仕様。 DescribeSpec を呼び出して、購入可能な仕様をクエリします。

列挙値:

  • acp.perf.large :

    計算最適化 (8 vCPU、16 GiB メモリ、32 GiB ストレージ)

  • acp.basic.small :

    軽量 (2 vCPU、4 GiB メモリ、32 GiB ストレージ)

  • acp.std.large :

    標準 (4 vCPU、8 GiB メモリ、32 GiB ストレージ)

acp.basic.small

AutoPay

boolean

任意

自動支払いを有効にするかどうかを指定します。デフォルト値は false です。

列挙値:

  • true :

    自動支払いを有効にします。アカウントに十分な残高があることを確認してください。

  • false :

    手動支払いを有効にします。

false

AutoRenew

boolean

任意

自動更新を有効にするかどうかを指定します。デフォルト値は false です。

列挙値:

  • true :

    サブスクリプションリソースは有効期限が切れた後、自動的に更新されます。

  • false :

    サブスクリプションリソースは有効期限が切れた後、手動で更新する必要があります。

false

OfficeSiteId

string

任意

ネットワーク ID。

  • 共有ネットワークにインスタンスを作成する場合:このパラメーターはオプションです。クラウドフォンコンソール > ネットワーク ページの共有ネットワークタイプのネットワーク ID を入力します。コンソールに共有ネットワークが存在しない場合は、このパラメーターを空のままにすることができます。インスタンスグループの作成時に共有ネットワークが自動的に作成されます。

  • VPC にインスタンスを作成する場合:このパラメーターは必須です。クラウドフォンコンソール > ネットワーク ページの VPC タイプのネットワーク ID を入力します。コンソールに VPC が存在しない場合は、まず VPC を作成してください。

cn-hangzhou+dir-745976****

VSwitchId

string

任意

vSwitch ID。 DescribeVSwitches を呼び出して、vSwitch のリストをクエリします。

  • 共有ネットワーク内のインスタンスの場合:このパラメーターは空のままにします。

  • VPC 内のインスタンスの場合:このパラメーターは必須です。インスタンスは指定された vSwitch に作成されます。

vsw-uf61uvzhz8ejaw776****

PolicyGroupId

string

任意

ポリシー ID。 ListPolicyGroups を呼び出して、ポリシーのリストをクエリします。

pg-b7bxrrwxkijjh****

ImageId

string

必須

イメージ ID。 DescribeImageList を呼び出して、クラウドフォンのイメージリストをクエリします。

imgc-06zyt9m93zwax****

Amount

integer

任意

インスタンスグループの数。デフォルト値は 1、最大値は 100 です。

8

GpuAcceleration

boolean

任意

GPU アクセラレーションを有効にするかどうかを指定します。

列挙値:

  • true :

    有効

  • false :

    無効 [デフォルト]

false

KeyPairId

string

任意

キーペア ID。インスタンスグループの作成時に有効なキーペア ID を指定すると、キーペアは正常に作成されたすべてのインスタンスにアタッチされます。キーペアをアタッチするために別の API 操作を呼び出す必要はありません。

説明

スケールアウト操作中にキーペアをアタッチすることはサポートされていません。

kp-7o9xywwfutc1l****

ClientToken

string

任意

リクエストのべき等性を保証するためのクライアントトークン。これにより、重複したリクエストの送信を防ぐことができます。トークンは最大 100 文字です。

asadbuvwiabdbvchj****

EnableIpv6

boolean

任意

説明

このパラメーターはまだ公開されていません。

null

Ipv6Bandwidth

integer

任意

説明

このパラメーターはまだ公開されていません。

null

Tag

array<object>

任意

リソースのタグ。

object

任意

リソースのタグ。

Value

string

任意

タグ値。

value

Key

string

任意

タグキー。

key

NetworkInfo

object

任意

BandwidthPackageName

string

任意

CidrBlock

string

任意

LimitedBandwidth

integer

任意

InternetChargeType

string

任意

IpRatio

integer

任意

Isp

string

任意

PayType

string

任意

Period

integer

任意

PeriodUnit

string

任意

AutoPay

boolean

任意

AutoRenew

boolean

任意

VisibleType

string

任意

BandwidthPackageType

string

任意

BandwidthPackageId

string

任意

NetworkType

string

任意

PromotionId

string

任意

レスポンスフィールド

フィールド

説明

object

レスポンスパラメーター。

RequestId

string

リクエスト ID。

1A923337-44D9-5CAD-9A53-95084BD4****

InstanceGroupInfos

array<object>

インスタンスグループに関する情報。

object

InstanceGroupId

string

インスタンスグループ ID。

ag-cuv4scs4obxch****

InstanceIds

array

インスタンス ID のリスト。

string

インスタンス ID。

acp-g40b9at5nhjo9****

OrderId

string

注文 ID。

22365781890****

InstanceGroupIds

array

インスタンスグループ ID のリスト。

string

インスタンスグループ ID。

ag-cuv4scs4obxch****

NetworkPackageOrderModel

object

BandwidthPackageOrderId

string

BandwidthPackageId

string

成功レスポンス

JSONJSON

{
  "RequestId": "1A923337-44D9-5CAD-9A53-95084BD4****",
  "InstanceGroupInfos": [
    {
      "InstanceGroupId": "ag-cuv4scs4obxch****",
      "InstanceIds": [
        "acp-g40b9at5nhjo9****"
      ]
    }
  ],
  "OrderId": "22365781890****",
  "InstanceGroupIds": [
    "ag-cuv4scs4obxch****"
  ],
  "NetworkPackageOrderModel": {
    "BandwidthPackageOrderId": "",
    "BandwidthPackageId": ""
  }
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。