All Products
Search

This Product

    Server Migration Center:CreateWorkgroup

    Document Center

    Server Migration Center:CreateWorkgroup

    Last Updated:Oct 29, 2024

    Creates a workgroup. You can create a workgroup to manage the lifecycles of multiple migration tasks at a time. This is suitable for scenarios in which multiple servers are migrated.

    Operation description

    • You can create up to 50 workgroups within an Alibaba Cloud account.
    • A workgroup can be associated with a maximum of 50 migration sources.
    • A migration source can be associated with only one workgroup.

    Debugging

    You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

    Authorization information

    There is currently no authorization information disclosed in the API.

    Request parameters

    ParameterTypeRequiredDescriptionExample
    ClientTokenstringNo

    The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length. For more information, see How to ensure idempotence.

    		123e4567-e89b-12d3-a456-426655440000
    NamestringNo

    The name of the workgroup. The name must meet the following requirements:

    • The name must be unique.
    • The name must be 2 to 128 characters in length. It must start with a letter and cannot start with http:// or https://. It can contain letters, digits, colons (:), underscores (_), and hyphens (-).
    		testWorkgroupName
    DescriptionstringNo

    The description of the workgroup.

    The description must be 2 to 128 characters in length. It must start with a letter and cannot start with http:// or https://. It can contain letters, digits, colons (:), underscores (_), and hyphens (-).

    		test

    Response parameters

    ParameterTypeDescriptionExample
    object

    The response parameters.

    RequestIdstring

    The request ID.

    		C8B26B44-0189-443E-9816-D951F59623A9
    WorkgroupIdstring

    The workgroup ID.

    		w-***

    Examples

    Sample success responses

    JSONformat

    {
  "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
  "WorkgroupId": "w-***"
}

    Error codes

    HTTP status codeError codeError messageDescription
    403Forbidden.UnauthorizedA required authorization for the specified action is not supplied.-
    500InternalErrorAn error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket.An error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket.

    For a list of error codes, visit the Service error codes.