Creating a Dedicated Group

You can create a dedicated group to isolate your VMs at creation on a server allocated to the dedicated group. For more information, see About Dedicated Groups.

Creating a Dedicated Group Using OSC CLI

This feature is currently in beta.

The CreateDedicatedGroup command creates a dedicated group for virtual machines (VMs).

For more information, see About Dedicated Groups.

Request sample
$ osc-cli api CreateDedicatedGroup --profile "default" \
    --CpuGeneration 4 \
    --Name "dedicated-group-example" \
    --SubregionName "eu-west-2a"

This command contains the following attributes that you need to specify:

  • CpuGeneration: The processor generation for the VMs in the dedicated group (for example, 4).

  • DryRun: (optional) If true, checks whether you have the required permissions to perform the action.

  • Name: A name for the dedicated group.

  • SubregionName: The Subregion in which you want to create the dedicated group.

The CreateDedicatedGroup command returns the following elements:

  • DedicatedGroup: Information about the dedicated group.

    • AccountId: The account ID of the owners of the dedicated group.

    • CpuGeneration: The processor generation.

    • DedicatedGroupId: The ID of the dedicated group.

    • Name: The name of the dedicated group.

    • NetIds: The IDs of the Nets in the dedicated group.

    • SubregionName: The name of the Subregion in which the dedicated group is located.

    • VmIds: The IDs of the VMs in the dedicated group.

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the request.

Result sample
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "DedicatedGroup": {
    "VmIds": [],
    "NetIds": [],
    "AccountId": "123456789012",
    "CpuGeneration": 4,
    "Name": "dedicated-group-example",
    "SubregionName": "eu-west-2a",
    "DedicatedGroupId": "ded-12345678"
  }
}

Creating a Dedicated Group Using oapi-cli

This feature is currently in beta.

The CreateDedicatedGroup command creates a dedicated group for virtual machines (VMs).

For more information, see About Dedicated Groups.

Request sample
$ oapi-cli --profile "default" CreateDedicatedGroup \
    --CpuGeneration 4 \
    --Name "dedicated-group-example" \
    --SubregionName "eu-west-2a"

This command contains the following attributes that you need to specify:

  • CpuGeneration: The processor generation for the VMs in the dedicated group (for example, 4).

  • DryRun: (optional) If true, checks whether you have the required permissions to perform the action.

  • Name: A name for the dedicated group.

  • SubregionName: The Subregion in which you want to create the dedicated group.

The CreateDedicatedGroup command returns the following elements:

  • DedicatedGroup: Information about the dedicated group.

    • AccountId: The account ID of the owners of the dedicated group.

    • CpuGeneration: The processor generation.

    • DedicatedGroupId: The ID of the dedicated group.

    • Name: The name of the dedicated group.

    • NetIds: The IDs of the Nets in the dedicated group.

    • SubregionName: The name of the Subregion in which the dedicated group is located.

    • VmIds: The IDs of the VMs in the dedicated group.

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the request.

Result sample
{
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  },
  "DedicatedGroup": {
    "VmIds": [],
    "NetIds": [],
    "AccountId": "123456789012",
    "CpuGeneration": 4,
    "Name": "dedicated-group-example",
    "SubregionName": "eu-west-2a",
    "DedicatedGroupId": "ded-12345678"
  }
}

Related Pages

Corresponding API Method