Modifying a Dedicated Group

You can modify the name of a dedicated group.

If you want to modify the Subregion or the CPU generation of a dedicated group, you have to create a new one.

Modifying a Dedicated Group Using OSC CLI

The UpdateDedicatedGroup command modifies the name of a specified dedicated group.

Request sample
$ osc-cli api UpdateDedicatedGroup --profile "default" \
    --DedicatedGroupId "ded-12345678" \
    --Name "New-dedicated-group-name"

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

  • DedicatedGroupId: The ID of the dedicated group you want to update.

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

  • Name: The new name of the dedicated group.

The UpdateDedicatedGroup 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": [
      "i-12345678"
    ],
    "NetIds": [
      "vpc-12345678"
    ],
    "AccountId": "123456789012",
    "CpuGeneration": 4,
    "Name": "New-dedicated-group-name",
    "SubregionName": "eu-west-2a",
    "DedicatedGroupId": "ded-12345678"
  }
}

Modifying a Dedicated Group Using oapi-cli

The UpdateDedicatedGroup command modifies the name of a specified dedicated group.

Request sample
$ oapi-cli --profile "default" UpdateDedicatedGroup \
    --DedicatedGroupId "ded-12345678" \
    --Name "New-dedicated-group-name"

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

  • DedicatedGroupId: The ID of the dedicated group you want to update.

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

  • Name: The new name of the dedicated group.

The UpdateDedicatedGroup 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": [
      "i-12345678"
    ],
    "NetIds": [
      "vpc-12345678"
    ],
    "AccountId": "123456789012",
    "CpuGeneration": 4,
    "Name": "New-dedicated-group-name",
    "SubregionName": "eu-west-2a",
    "DedicatedGroupId": "ded-12345678"
  }
}

Related Pages

Corresponding API Method

Export to PDF