すべてのプロダクト
Search

このプロダクト

    :CreateAndroidInstanceGroup

    ドキュメントセンター

    :CreateAndroidInstanceGroup

    最終更新日:Apr 11, 2026

    従量課金またはサブスクリプションのクラウドフォンインスタンスグループを作成します。インスタンスグループは複数のインスタンスを管理できます。同様の機能を持つインスタンスをインスタンスグループにまとめることで、単一のユニットとして管理できます。

    操作説明

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

    • インスタンスグループの課金方法がサブスクリプション (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 を指定します。ID は クラウドフォンコンソール > ネットワーク ページで確認できます。コンソールに利用可能な共有ネットワークがない場合は、このパラメーターを省略できます。インスタンスグループを作成すると、システムが自動的に共有ネットワークを作成します。

    • VPC にインスタンスを作成する場合：このパラメーターは必須です。VPC の ID を指定します。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。デフォルト値： 1。

    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

    任意

    PromotionId

    string

    任意

    PaidCallbackUrl

    string

    任意

    BandwidthPackageType

    string

    任意

    BandwidthPackageId

    string

    任意

    NetworkType

    string

    任意

    PromotionId

    string

    任意

    StreamMode

    integer

    任意

    PaidCallBackUrl

    string

    任意

    wya.wuying.aliyun.com/instanceGroup
    SaleMode

    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": ""
  }
}

    エラーコード

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

    変更履歴

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