API Introduction

Create a VBS repository. This API may involve billing items.

API Restrictions

None

<span lang="EN-US">POST /v4/ebs-backup/repo/create</span>

Path Parameter

None

Query Parameter

None

Request Header Parameter

None

Request Body Parameter

Parameter	Required or Not	Parameter Type	Description	Example
clientToken	Yes	String	Ensure order idempotence. This value must be unique within the whole cloud account. Requests with the same ClientToken value and having the same other parameters are considered as the same request.	4cf2962d-e92c-4c00-9181-cfbb2218636c
regionID	Yes	String	Resource Pool ID	81f7728662dd11ec810800155d307d5b
repositoryName	Yes	String	Repository name. Only digits, letters, and hyphen (-) are allowed. The name cannot start with a digit or a hyphen (-) or end with a hyphen (-). It must be within 2 to 32 characters in length.	test-repo1
size	No	Integer	Repository capacity (GB). Value range: [100-1024000]. Default value: 100.	100
cycleType	Yes	String	Subscription type. Value range: MONTH and YEAR. The maximum subscription duration is three years.	MONTH
cycleCount	Yes	Integer	Subscription duration. This parameter is used with the cycleType parameter. When cycleType is set to MONTH, the parameter unit is in month. When cycleType is set to YEAR, the parameter unit is in year.	1
autoRenewStatus	No	Integer	Specify whether to enable auto-renewal. Value range: 0: do not enable. 1: enable. Default value: 0. If this value is set to 1, the auto-renewal duration is three months or one year depending on the subscription cycle.	1
projectID	No	String	Enterprise project ID. Default value: 0.	0

Parameter	Required or Not	Type	Description	Example	Lower-level Object
statusCode	Yes	Integer	Return status code (800 indicates success, 900 indicates failure).	800
message	Yes	String	Error descripting in English.	SUCCESS
description	Yes	String	Error description in Chinese.	Successful
errorCode	No	String	Business code, returned upon failures.	Refer to error codes
returnObj	No	Object	Data returned upon success. Refer to returnObj object structures.		returnObj

Table returnObj

Parameter	Required or Not	Parameter Type	Description	Example
masterOrderID	Yes	String	Order ID. The caller can check status of the order and resources among multiple errors based on the masterOrderID parameter.	235145e4489811eda8330242ac110002
masterOrderNO	Yes	String	Order number. You can check the ID of a specific resource based on this parameter.	20221010142913884246
regionID	Yes	String	Resource pool ID.	81f7728662dd11ec810800155d307d5b

Request Header

None

Request Body

    "clientToken": "4cf2962d-e92c-4c00-9181-cfbb2218636c",

    "regionID": "81f7728662dd11ec810800155d307d5b",

    "repositoryName": "test-repo",

    "size": 100,

    "cycleType": "MONTH",

    "cycleCount": 6,

    "autoRenewStatus": 1

    "returnObj": {

        "masterOrderNO": "20230116170722621567",

        "regionID": "81f7728662dd11ec810800155d307d5b",

        "masterOrderID": "2f7c845a957d11edbaba0242ac110010"

},

    "message": "SUCCESS",

    "description": "Successful",

    "statusCode": 800

errorCode	Description
EbsBackup.RegionInfo.Empty	The resource pool information is empty or does not exist. Check whether the resource pool ID is valid.
EbsBackup.RegionInfo.AccessFailed	Failed to query the resource pool. Please try again. If the failure keeps happening, please submit a ticket.
EbsBackup.RegionInfo.DataDamaged	The resource pool information is incorrect. Please try again. If the failure keeps happening, please submit a ticket.
EbsBackup.Parameter.InvalidRepositoryName	Invalid request parameter: {Reason}.
EbsBackup.Parameter.InvalidSize	Invalid request parameter: {Reason}.
EbsBackup.Parameter.InvalidCycle	Invalid request parameter: {Reason}.
EbsBackup.Parameter.InvalidCycleCount	Invalid request parameter: {Reason}.
EbsBackup.Parameter.InvalidCycleType	Invalid request parameter: {Reason}.
EbsBackup.Parameter.InvalidAutoRenewStatus	Invalid request parameter: {Reason}.
EbsBackup.Parameter.InvalidRegionID	Invalid request parameter: {Reason}.
EbsBackup.Parameter.InvalidClientToken	Invalid request parameter: {Reason}.
EbsBackup.OrderCheck.InvalidProjectID	The enterprise project does not exist. Please check whether the project ID is valid.
EbsBackup.OrderCheck.ProcFailed	Order processing failed: {Reason}.