# 删除聚合仓库至回收站 - DeleteVirtualRepository
#### 功能介绍
根据仓库ID删除指定聚合仓库至回收站，删除后如有需要可以从回收站还原，用户可以在需要时轻松恢复数据，确保业务的灵活性和数据的安全性。（只支持删除聚合仓库）
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-cloudartifact/CloudArtifact_api_0008.html)。
#### 授权信息
当前API调用无需身份策略权限。
#### URI
DELETE /cloudartifact/v5/virtual/repositories
#### 请求参数
表1请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| x-auth-token | 是    | String | **参数解释**: 用户token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值），调用详情请参考章节。 **约束限制**: 不涉及。 **取值范围**: 字符串长度为1-100000。 **默认取值**: 不涉及。 |
   
表2请求Body参数 
| 参数             | 是否必选 | 参数类型             | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| format         | 否    | String           | **参数解释**: 制品类型。 **约束限制**: 不涉及。 **取值范围**: - maven   - maven2   - npm   - go   - pypi   - rpm   - composer   - debian   - conan   - nuget   - docker2   - cocoapods   - ohpm   - generic   - helm   - conda    **默认取值**: 不涉及。 |
| project_id     | 否    | String           | **参数解释**: 项目id，可以从调用API处获取，也可以从控制台获取。获取方式请参考[获取项目id](https://support.huaweicloud.com/api-cloudartifact/CloudArtifact_api_0015.html)。 **约束限制**: 不涉及。 **取值范围**: 只能由英文字母、数字组成，且长度为32个字符。 **默认取值**: 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| repository_ids | 否    | Array of strings | **参数解释**: 仓库id集合，最多支持100个仓库id。仓库id的格式为{region}_{domainId}_{format}_{sequence}。仓库id可以使用[查询仓库详情，不会去统计仓库下的制品数量](https://support.huaweicloud.com/api-cloudartifact/ListAllRepositories.html)接口的响应体中"name"参数的值作为此参数的值。 **约束限制**: 不涉及。 **取值范围**: 不涉及。 **默认取值**: 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数       | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| status   | String | **参数解释**: 请求成功或失败状态。 **取值范围**: - success：请求成功。   - error：请求失败。    |
| trace_id | String | **参数解释**: 请求id，当前请求的唯一标识。 **取值范围**: 数字及中划线(-)组成的字符串。                                                                                                                                                                                                                                                                                                                                                               |
| result   | Object | **参数解释**: 请求返回结果，接口不同，返回不同。 **取值范围**: 不涉及。                                                                                                                                                                                                                                                                                                                                                                         |
   
#### 请求示例
删除仓库
```
https://artifact.example-1.com/cloudartifact/v5/virtual/repositories
{
  "format" : "maven2",
  "repository_ids" : [ "xx-xxxxx-x_5a775fdcb14f4431b6c0015618140bc3_maven_2_201" ]
}
```
#### 响应示例
**状态码：200**
OK
```
{
  "status" : "success",
  "trace_id" : "143002-1701175914578-88",
  "result" : null
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cloudartifact/ErrorCode.html)。