Docs

Elastic Compute Service

Storage placement group

ModifyPlacementGroup - Modify placement group

Use ModifyPlacementGroup to change the name and description of a storage placement group.

Debugging

API Explorer

You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.

Go to debug

request parameters

Only specific request parameters for this API and some common parameters are listed below. For more information, see Common Parameters.

Action string required Example value: ModifyPlacementGroup

Operation to perform: ModifyPlacementGroup.

Version string required Example: 2020-04-01

The version of the API is: 2020-04-01.

Id string required Example: pg-bp67acfmxazb4ph****

Storage placement group ID.

Name string Optional Example: test-pg

Storage placement group name; see details below:

The first character can only be a Chinese character, letter, or underscore (_).

It can contain Chinese characters, letters, numbers, underscores (_), hyphens (-), or periods (.).

Length must be between 1 and 128 characters.

Description string Optional Example value: testDescription

The description for the storage placement group; defaults to empty. Description as follows:

The first character can only be a Chinese character, letter, or underscore (_).

Can contain Chinese characters, letters, numbers, underscores (_), hyphens (-), or periods (.).

Length limit is 1 to 128 characters.

Response Parameters

This API does not have specific response parameters. For more information, see Response Structure.

Request example

POST /?Action=ModifyPlacementGroup&Version=2020-04-01 HTTP/1.1​
Host: open.volcengineapi.com​
Content-Type: application/json; charset=UTF-8​
X-Date: 20250730T085716Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250730/cn-beijing/storage_ebs/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
  "Id": "pg-bp67acfmxazb4ph****",​
  "Name": "test-pg"​
}​

Back to example

{​
  "ResponseMetadata": {​
    "RequestId": "20240829152008176165188230AC****",​
    "Action": "ModifyPlacementGroup",​
    "Version": "2020-04-01",​
    "Service": "storage_ebs",​
    "Region": "cn-beijing"​
  },​
  "Result": {}​
}​

error code

The table below lists error codes related to this interface and business logic. For public error codes, see the Public Error Code documentation.

Status Code	error code	error message	Create Volume
404	InvalidPlacementGroup.NotFound	placement group not found	Anti-affinity group does not exist.

Last updated: 2026.01.09 18:19:56