Call the CreateAgentGroup API to create an agent group. ## Debug [去调试](https://api.volcengine.com/api-explorer/?action=CreateAgentGroup&groupName=openapi&serviceCode=dms&version=2025-01-01) ## Request parameters The following only lists parameters that are specific to this API and some common parameters. For more information, see [Common parameters](https://www.volcengine.com/docs/6369/67268). **Action ** string 必选 `Example: CreateAgentGroup` Operation to perform. Value: CreateAgentGroup. **Version ** string 必选 `Example: 2025-01-01` API version. Value: 2025\-01\-01. **AgentGroupName ** string 必选 `Example: aaa` Name of the agent group. **NetworkType ** string 必选`Example value: Public` Network type. The fields are described as follows: * Public: Public network * Vpc: Virtual private cloud (VPC) **DeployType ** string 必选 `Example: HalfManaged` Deployment type. Value: HalfManaged (semi\-managed). **DeployArea ** string 必选 `Example: CloudOverlay` Deployment area, value type instructions: * CloudOverlay: VPC network in the cloud * Premises: Offline IDC environment ## Response parameters The following only lists parameters that are specific to this API. For more information, see [Response structure](https://www.volcengine.com/docs/6369/80336). **Id ** string `Example value: 1*` Agent group ID. **AccountId ** string `Example value: 210000****` Account ID. ## Sample request ```text POST /?Action=CreateAgentGroup&Version=2025-01-01 HTTP/1.1 Host: dms.cn-beijing.volcengineapi.com Content-Type: application/json; charset=UTF-8 X-Date: 20251203T094311Z X-Content-Sha256: 287e874e******d653b44d21e Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251203/cn-beijing/dms/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f { "AgentGroupName": "aaa", "NetworkType": "Public", "DeployType": "HalfManaged", "DeployArea": "CloudOverlay" } ``` ## Sample response ```json { "ResponseMetadata": { "RequestId": "2025120317431425413616703217****", "Action": "CreateAgentGroup", "Version": "2025-01-01", "Service": "dms", "Region": "cn-beijing" }, "Result": { "Id": "1*", "AccountId": "210000****" } } ``` ## Error codes The table below lists error codes relevant to this API and business logic. For public error codes, refer to the [Public Error Codes](https://www.volcengine.com/docs/6369/68677) documentation. |Status code |Error code |Error message |Description | |---|---|---|---| |400 |2002\-00000012 |InvalidRequestBody |Parameter error. | |404 |2002\-00000014 |EntityNotFoundErr |The corresponding entity does not exist. | |500 |2001\-00000001 |ServiceInternalErr |Server error. Please try again later. |

Data Migration Service