All Products
Search
Document Center

ENS:CreateSDG

Last Updated:Jun 11, 2024

Creates a shared data group (SDG) by using a specific device.

Operation description

After you create an SDG, you must call the SaveSDG operation to save the SDG. Otherwise, the SDG is unavailable.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
InstanceIdstringYes

The ID of the device.

aic-xxxx
SizestringNo

The maximum capacity of the SDG. Unit: GB.

Note
  • To save costs, we recommend that you specify this parameter based on your business requirements.

  • The first time that you create an SDG, the Size parameter is required.

  • When the amount of data increases, you can pass a new Size parameter for resizing.

    • If the value of the Size parameter is not empty and is greater than the value of the Size parameter of the original SDG, the original disk corresponding to the SDG is scaled out to the size that is specified by the current Size parameter.
    • If the value of the Size parameter is not empty, or the value of the Size parameter is smaller than the value of the Size parameter of the original SDG, no operation is performed.
20
DescriptionstringNo

The description of the SDG.

Note We recommend that you specify this parameter in details for subsequent queries.
FromSDGIdstringNo

The ID of the SDG from which you want to create an SDG.

Note
  • The first time you create an SDG, the FromSDGId parameter is empty.

  • If the value of the FromSDGId parameter is invalid or does not correspond to an original disk, an error is reported.

  • If the value of the FromSDGId parameter is not empty, you have created an SDG, and the operation is performed on the existing SDG.

sdg-xxxxx

Response parameters

ParameterTypeDescriptionExample
object

Schema of Response

RequestIdstring

The request ID.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
SDGIdstring

The ID of the generated SDG.

sdg-xxxx

Examples

Sample success responses

JSONformat

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "SDGId": "sdg-xxxx"
}

Error codes

HTTP status codeError codeError messageDescription
400Interface.Call.ErrorThe interface call error-
400Interface.Call.Failed%s.Request failed
400Parameter.InvalidThe parameter is invalid. Please check your parameters and try it again.The parameter is invalid.
400NoPermissionPermission denied.-
400InvalidParameter.%sThe specified field %s invalid. Please check it again.-

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

Change history

Change timeSummary of changesOperation
2024-03-22The Error code has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    Error Codes 400 change