# API概览
通过使用容器镜像服务提供的接口，您可以实现对组织、镜像仓库、镜像信息的查询，也可以实现对组织、镜像仓库、镜像的管理操作。
#### 组织管理
| **API**                                                           | **说明**                           |
|:---|:---|
| [创建组织](https://support.huaweicloud.com/api-swr/swr_02_0026.html)   | 创建组织。                             |
| [删除组织](https://support.huaweicloud.com/api-swr/swr_02_0027.html)   | 删除组织。                             |
| [查询组织列表](https://support.huaweicloud.com/api-swr/swr_02_0028.html)  | 查询组织列表。                            |
| [获取组织详情](https://support.huaweicloud.com/api-swr/swr_02_0029.html) | 查询某个组织的详细信息，包括组织ID、组织名称、创建者和用户权限。 |
   
#### 镜像仓库管理
|                                  **API**                                   |                           **说明**                           |
|---|---|
| [在组织下创建镜像仓库](https://support.huaweicloud.com/api-swr/swr_02_0030.html)    | 在组织下创建镜像仓库。                                              |
| [删除组织下的镜像仓库](https://support.huaweicloud.com/api-swr/swr_02_0031.html)     | 删除组织下的镜像仓库。                                                |
| [更新镜像仓库的概要信息](https://support.huaweicloud.com/api-swr/swr_02_0032.html)  | 更新组织下的镜像仓库概要信息，包括镜像类型、是否公有、描述信息。                            |
| [查询镜像仓库概要信息](https://support.huaweicloud.com/api-swr/swr_02_0033.html)     | 查询组织下镜像仓库的概要信息，包括仓库ID、组织ID、仓库名称、仓库描述信息、仓库创建者、仓库大小、镜像pull路径等。 |
| [查询镜像仓库列表](https://support.huaweicloud.com/api-swr/swr_02_0034.html)       | 查询镜像仓库列表。                                                   |
| [查询共享镜像列表](https://support.huaweicloud.com/api-swr/swr_02_0075.html)         | 查看共享镜像列表。                                                 |
| [查询镜像仓库列表详情（v3）](https://support.huaweicloud.com/api-swr/swr_02_0060.html) | 查询镜像仓库列表详情。                                                   |
| [查询共享仓库列表详情（v3）](https://support.huaweicloud.com/api-swr/swr_02_0077.html)  | 查询共享仓库列表详情。                                               |
   
#### 镜像版本管理
|                                    **API**                                     |      **说明**       |
|---|---|
| [查询镜像tag列表](https://support.huaweicloud.com/api-swr/swr_02_0035.html)          | 查询某一个镜像仓库的所有镜像版本。     |
| [删除指定tag的镜像](https://support.huaweicloud.com/api-swr/swr_02_0123.html)         | 删除镜像仓库中指定tag的镜像。    |
| [创建镜像tag](https://support.huaweicloud.com/api-swr/swr_02_0076.html)            | 创建镜像tag。            |
| [查询指定tag的镜像的详情](https://support.huaweicloud.com/api-swr/swr_02_0123.html)     | 查询镜像仓库中指定tag的镜像详情。  |
| [查询镜像tag列表（V3）](https://support.huaweicloud.com/api-swr/swr_02_0125.html)      | 查询镜像tag列表。          |
| [查询镜像的签名附件列表](https://support.huaweicloud.com/api-swr/swr_02_0062.html)         | 查询镜像的签名附件列表。       |
| [查询签名镜像关联的被签名镜像版本列表](https://support.huaweicloud.com/api-swr/swr_02_0063.html) | 查询签名镜像关联的被签名镜像版本列表。 |
| [获取镜像的Config信息](https://support.huaweicloud.com/api-swr/ShowRepoTagConfig.html)   | 获取镜像的Config信息。        |
   
#### 共享账号管理
|                                **API**                                |                 **说明**                  |
|---|---|
| [创建共享账号](https://support.huaweicloud.com/api-swr/swr_02_0070.html)    | 创建共享账号。镜像上传后，您可以共享私有镜像给其他账号，并授予下载该镜像的权限。 |
| [删除共享账号](https://support.huaweicloud.com/api-swr/swr_02_0071.html)     | 删除共享账号。                                    |
| [更新共享账号](https://support.huaweicloud.com/api-swr/swr_02_0072.html)   | 更新共享账号。                                    |
| [判断共享账号是否存在](https://support.huaweicloud.com/api-swr/swr_02_0073.html) | 判断共享账号是否存在。                                 |
| [获取共享账号列表](https://support.huaweicloud.com/api-swr/swr_02_0074.html)     | 获取共享账号列表。                                   |
   
#### API版本信息
|                                **API**                                 |         **说明**          |
|---|---|
| [查询所有API版本信息](https://support.huaweicloud.com/api-swr/swr_02_0080.html) | 查询容器镜像服务所有可用的API版本信息列表。 |
| [查询指定API版本信息](https://support.huaweicloud.com/api-swr/swr_02_0081.html) | 查询容器镜像服务指定API版本信息列表。    |
   
#### 组织权限管理
|                              **API**                              |             **说明**              |
|---|---|
| [创建组织权限](https://support.huaweicloud.com/api-swr/swr_02_0042.html)   | 为组织添加授权，使某些用户可以管理/编辑/读取该组织下的镜像。 |
| [删除组织权限](https://support.huaweicloud.com/api-swr/swr_02_0043.html) | 删除某些用户对组织的操作权限。                |
| [更新组织权限](https://support.huaweicloud.com/api-swr/swr_02_0044.html)  | 更新某些用户对组织的操作权限类型。              |
| [查询组织权限](https://support.huaweicloud.com/api-swr/swr_02_0045.html)  | 查询组织权限。                          |
   
#### 镜像权限管理
|                               **API**                                |                **说明**                 |
|---|---|
| [创建镜像权限](https://support.huaweicloud.com/api-swr/swr_02_0036.html)   | 为镜像授权，使某些用户可以管理/编辑/读取该镜像。             |
| [删除镜像权限](https://support.huaweicloud.com/api-swr/swr_02_0047.html)    | 删除某些用户对镜像的操作权限。                       |
| [更新镜像权限](https://support.huaweicloud.com/api-swr/swr_02_0048.html)    | 更新某些用户对镜像的操作权限类型。 |
| [查询镜像权限](https://support.huaweicloud.com/api-swr/swr_02_0049.html) | 查询镜像的权限。                             |
   
#### 镜像自动同步管理
|                                  **API**                                  |                                                                                                                                                                           **说明**                                                                                                                                                                           |
|---|---|
| [获取镜像自动同步任务信息](https://support.huaweicloud.com/api-swr/swr_02_0006.html) | 创建镜像自动同步任务后，可以通过此接口查询该任务的状态，以判断是否同步成功。                                                                                                                                                                                                                                                                                                                    |
| [获取镜像自动同步任务列表](https://support.huaweicloud.com/api-swr/swr_02_0007.html)   | 获取为当前镜像仓库所创建的所有自动同步任务。                                                                                                                                                                                                                                                                                                                                    |
| [创建镜像自动同步任务](https://support.huaweicloud.com/api-swr/swr_02_0012.html)   | 创建镜像自动同步任务，帮助您把最新推送的镜像自动同步到其他区域镜像仓库内。 镜像自动同步帮助您把最新推送的镜像自动同步到其他区域镜像仓库内，后期镜像有更新时，目标仓库的镜像也会自动更新，但已有的镜像不会自动同步。已有镜像的同步需要手动操作，详情请参见[手动同步镜像](https://support.huaweicloud.com/api-swr/swr_02_0014.html)。                                                                                                                                                         |
| [删除镜像自动同步任务](https://support.huaweicloud.com/api-swr/swr_02_0013.html)   | 根据目标区域、目标组织删除指定的镜像自动同步任务。                                                                                                                                                                                                                                                                                                                                 |
| [手动同步镜像](https://support.huaweicloud.com/api-swr/swr_02_0014.html)       | 对于镜像仓库已有的镜像，如果想在其他区域使用，需要手动触发镜像同步。判断是否同步成功的方法如下： - 响应状态码为200，无报错信息，表示同步成功。  - 通过SWR管理控制台或调用[查询镜像仓库概要信息](https://support.huaweicloud.com/api-swr/swr_02_0033.html)接口，在目标区域的目标组织下，若存在所同步的镜像版本表示同步成功。   |
| [获取可进行镜像同步的区域列表](https://support.huaweicloud.com/api-swr/swr_02_0123.html)  | 获取可进行镜像同步的区域列表。                                                                                                                                                                                                                                                                                                                                           |
   
#### 触发器管理
|                                  **API**                                  |      **说明**      |
|---|---|
| [创建触发器](https://support.huaweicloud.com/api-swr/swr_02_0015.html)         | 创建触发器。            |
| [获取镜像仓库下的触发器列表](https://support.huaweicloud.com/api-swr/swr_02_0016.html) | 获取镜像仓库下的触发器列表。 |
| [删除触发器](https://support.huaweicloud.com/api-swr/swr_02_0017.html)         | 删除触发器。         |
| [获取触发器详情](https://support.huaweicloud.com/api-swr/swr_02_0018.html)       | 获取触发器详情。      |
| [更新触发器配置](https://support.huaweicloud.com/api-swr/swr_02_0019.html)       | 更新触发器的状态。         |
   
#### 镜像老化规则管理
|                                 **API**                                  |   **说明**   |
|---|---|
| [创建镜像老化规则](https://support.huaweicloud.com/api-swr/swr_02_0025.html)    | 创建镜像老化规则。     |
| [获取镜像老化规则列表](https://support.huaweicloud.com/api-swr/swr_02_0053.html) | 获取镜像老化规则列表。 |
| [删除镜像老化规则](https://support.huaweicloud.com/api-swr/swr_02_0076.html)    | 删除镜像老化规则。    |
| [获取镜像老化规则记录](https://support.huaweicloud.com/api-swr/swr_02_0055.html)  | 获取镜像老化规则记录。 |
| [修改镜像老化规则](https://support.huaweicloud.com/api-swr/swr_02_0056.html)    | 修改镜像老化规则。   |
| [获取镜像老化记录](https://support.huaweicloud.com/api-swr/swr_02_0057.html)    | 获取镜像老化记录。   |
   
#### 临时登录指令
|                                  **API**                                   |                        **说明**                        |
|---|---|
| [生成临时登录指令](https://support.huaweicloud.com/api-swr/swr_02_0052.html)     | 通过获取响应消息头的X-Swr-Dockerlogin的值及响应消息体的host值，可生成临时登录指令。 |
| [生成临时登录指令(增强型)](https://support.huaweicloud.com/api-swr/swr_02_0058.html) | 通过获取响应消息头的X-Swr-Dockerlogin的值及响应消息体的host值，可生成临时登录指令。 |
   
#### 配额管理
|                               **API**                               | **说明**  |
|---|---|
| [获取配额信息](https://support.huaweicloud.com/api-swr/swr_02_0037.html) | 获取配额信息。 |
   
#### 其他
|                                **API**                                 |    **说明**    |
|---|---|
| [获取租户总览信息](https://support.huaweicloud.com/api-swr/swr_02_0120.html)   | 获取租户总览信息。    |
| [获取租户资源统计信息](https://support.huaweicloud.com/api-swr/swr_02_0121.html)   | 获取租户资源统计信息。 |
| [查询服务特性开关信息](https://support.huaweicloud.com/api-swr/swr_02_0121.html) | 查询服务特性开关信息。  |
| [创建委托](https://support.huaweicloud.com/api-swr/swr_02_0124.html)         | 创建委托。       |
| [查询委托是否存在](https://support.huaweicloud.com/api-swr/swr_02_0125.html)     | 查询委托是否存在。   |