调用CreateVault创建一个备份仓库。

接口说明

  • 每个阿里云账号最多能创建100个备份仓库。
  • 备份仓库创建后,状态为INITIALIZING,并自动发起初始化任务。任务成功后,备份仓库状态为CREATED。此时仓库才能用于备份任务。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateVault

系统规定参数。取值:CreateVault

VaultName String backupvaultname

备份仓库名称。长度为1~64个字符。

VaultRegionId String cn-shanghai

备份仓库所属的地域ID。

Description String description

备份仓库描述信息。长度为0~255个字符。

VaultType String STANDARD

备份仓库类型。取值仅为STANDARD,表示普通仓库。

VaultStorageClass String STANDARD

备份仓库存储类型。取值仅为STANDARD,表示标准存储。

返回数据

名称 类型 示例值 描述
Code String 200

返回码,200表示成功。

Message String successful

返回信息描述,成功一般返回successful,错误时会返回相应错误信息。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

Success Boolean true

请求是否成功。

  • true表示成功。
  • false表示失败。
TaskId String t-*********************

备份仓库初始化任务ID。可以使用DescribeTask查询任务状态。

VaultId String v-*********************

备份仓库ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateVault
&VaultName=backupvaultname
&VaultRegionId=cn-shanghai
&<公共请求参数>

正常返回示例

XML格式

<CreateVaultResponse>
  <TaskId>t-*********************</TaskId>
  <Message>successful</Message>
  <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
  <VaultId>v-*********************</VaultId>
  <Code>200</Code>
  <Success>true</Success>
</CreateVaultResponse>

JSON格式

{
    "TaskId": "t-*********************",
    "Message": "successful",
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
    "VaultId": "v-*********************",
    "Code": 200,
    "Success": true
}

错误码

访问错误中心查看更多错误码。