华为云用户手册

  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型(格式),下方类型可任选其一使用: application/json;charset=utf-8 application/json 缺省值:application/json X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 [数组元素] 是 Array of UserAuth objects 创建组织权限需要的信息 表4 UserAuth 参数 是否必选 参数类型 描述 user_id 是 String 用户id,需要从IAM服务获取 user_name 是 String 用户名,需要从IAM服务获取 auth 是 Long 用户权限,7表示管理权限,3表示编辑权限,1表示读取权限
  • 响应示例 状态码: 200 查询成功 [ { "algorithm" : "or", "id" : 222, "rules" : [ { "params" : { "days" : "30" }, "tag_selectors" : [ { "kind" : "label", "pattern" : "v5" }, { "kind" : "label", "pattern" : "1.0.1" }, { "kind" : "regexp", "pattern" : "^123$" } ], "template" : "date_rule" } ], "scope" : "" } ]
  • URI GET /v2/manage/namespaces/{namespace}/repos/{repository}/retentions 表1 路径参数 参数 是否必选 参数类型 描述 namespace 是 String 组织名称。小写字母开头,后面跟小写字母、数字、小数点、下划线或中划线(其中下划线最多允许连续两个,小数点、下划线、中划线不能直接相连),小写字母或数字结尾,1-64个字符。 repository 是 String 镜像仓库名称
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型(格式),下方类型可任选其一使用: application/json;charset=utf-8 application/json 缺省值:application/json X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 [数组元素] Array of Retention objects 查询成功 表4 Retention 参数 参数类型 描述 algorithm String 回收规则匹配策略,or id Integer ID rules Array of Rule objects 镜像老化规则 scope String 保留字段 表5 Rule 参数 参数类型 描述 template String 回收类型,date_rule、tag_rule params Object template是date_rule时,设置params为{"days": "xxx"} template是tag_rule时,设置params为{"num": "xxx"} tag_selectors Array of TagSelector objects 例外镜像 表6 TagSelector 参数 参数类型 描述 kind String 匹配规则,label、regexp pattern String kind是label时,设置为镜像版本,kind是regexp时,设置为正则表达式
  • 状态码 正常 返回值 说明 200 OK GET和PUT操作正常返回。 201 Created POST操作正常返回。 202 Accepted 请求已被接受。 204 No Content DELETE操作正常返回。 异常 返回值 说明 400 Bad Request 服务器未能处理请求。 401 Unauthorized 被请求的页面需要用户名和密码。 403 Forbidden 对被请求页面的访问被禁止。 404 Not Found 服务器无法找到被请求的页面。 405 Method Not Allowed 请求中指定的方法不被允许。 406 Not Acceptable 服务器生成的响应无法被客户端所接受。 407 Proxy Authentication Required 用户必须首先使用代理服务器进行验证,这样请求才会被处理。 408 Request Timeout 请求超出了服务器的等待时间。 409 Conflict 由于冲突,请求无法被完成。 500 Internal Server Error 请求未完成。服务异常。 501 Not Implemented 请求未完成。服务器不支持所请求的功能。 502 Bad Gateway 请求未完成。服务器从上游服务器收到一个无效的响应。 503 Service Unavailable 请求未完成。系统暂时异常。 504 Gateway Timeout 网关超时。 父主题: 附录
  • 响应示例 状态码: 200 请求成功 { "id" : 0, "ns_id" : 0, "name" : "busybox", "category" : "other", "description" : "containerops", "creator_id" : "1", "creator_name" : "admin", "size" : 2099575, "is_public" : false, "num_images" : 0, "num_download" : 0, "url" : "", "path" : "swr.cn-north-1.myhuaweicloud.com/namespace/repository", "internal_path" : "10.125.0.198:20202/namespace/repository", "created" : "2017-08-17T12:00:03.915153267Z", "updated" : "2017-08-17T12:00:03.915153267Z", "domain_id" : "da44776c316c4a99b3683bb174f8821b", "priority" : 0 }
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型(格式),下方类型可任选其一使用: application/json;charset=utf-8 application/json 缺省值:application/json X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。
  • URI GET /v2/manage/namespaces/{namespace}/repos/{repository} 表1 路径参数 参数 是否必选 参数类型 描述 namespace 是 String 组织名称。小写字母开头,后面跟小写字母、数字、小数点、下划线或中划线(其中下划线最多允许连续两个,小数点、下划线、中划线不能直接相连),小写字母或数字结尾,1-64个字符。 repository 是 String 镜像仓库名称
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 id Long 仓库编号 ns_id Long 组织编号 name String 仓库名称 category String 仓库类型(计划改造,每个镜像会有多个lable标示) description String 仓库描述信息 creator_id String 仓库创建者id creator_name String 仓库创建者 size Long 仓库大小 is_public Boolean 仓库是否为公共仓库,值为true或false num_images Long 仓库中镜像个数,0 ~ 9223372036854775807 num_download Long 仓库下载次数 url String 仓库logo图片的URL,URL格式。(暂时未用) path String 镜像pull路径,格式为 swr.cn-north-1.myhuaweicloud.com/namespace/repository internal_path String 镜像pull路径,格式为 10.125.0.198:20202/namespace/repository created String 仓库创建时间,UTC日期格式,时间为UTC标准时间,用户需要根据本地时间计算偏移量;如东8区需要+8:00 updated String 仓库更新时间,UTC日期格式,时间为UTC标准时间,用户需要根据本地时间计算偏移量;如东8区需要+8:00 domain_id String 账号ID priority Integer 镜像排序优先级
  • URI DELETE /v2/manage/namespaces/{namespace}/repos/{repository}/access 表1 路径参数 参数 是否必选 参数类型 描述 namespace 是 String 组织名称。小写字母开头,后面跟小写字母、数字、小数点、下划线或中划线(其中下划线最多允许连续两个,小数点、下划线、中划线不能直接相连),小写字母或数字结尾,1-64个字符。 repository 是 String 镜像仓库名称
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型(格式),下方类型可任选其一使用: application/json;charset=utf-8 application/json 缺省值:application/json X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 [数组元素] 是 Array of strings 用户ID,需从华为云IAM服务获取。
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型(格式),下方类型可任选其一使用: application/json;charset=utf-8 application/json 缺省值:application/json X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。
  • URI DELETE /v2/manage/namespaces/{namespace}/repos/{repository} 表1 路径参数 参数 是否必选 参数类型 描述 namespace 是 String 组织名称。小写字母开头,后面跟小写字母、数字、小数点、下划线或中划线(其中下划线最多允许连续两个,小数点、下划线、中划线不能直接相连),小写字母或数字结尾,1-64个字符。 repository 是 String 镜像仓库名称
  • 请求示例 PATCH https://{endpoint}/v2/manage/namespaces/{namespace}/repositories/{repository}/access-domains { "permit" : "read", "deadline" : "2018-10-01T16:00:00.000Z", "description" : "description" }
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型(格式),下方类型可任选其一使用: application/json;charset=utf-8 application/json 缺省值:application/json X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 permit 是 String 当前只支持read权限 deadline 是 String 截止时间,UTC时间格式。永久有效为forever description 否 String 描述。默认值为空字符串
  • URI PATCH /v2/manage/namespaces/{namespace}/repositories/{repository}/access-domains/{access_domain} 表1 路径参数 参数 是否必选 参数类型 描述 namespace 是 String 组织名称。小写字母开头,后面跟小写字母、数字、小数点、下划线或中划线(其中下划线最多允许连续两个,小数点、下划线、中划线不能直接相连),小写字母或数字结尾,1-64个字符。 repository 是 String 镜像仓库名称 access_domain 是 String 共享账号
  • 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型(格式),下方类型可任选其一使用: application/json;charset=utf-8 application/json 缺省值:application/json X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表2 请求Body参数 参数 是否必选 参数类型 描述 namespace 是 String 组织名称。小写字母开头,后面跟小写字母、数字、小数点、下划线或中划线(其中下划线最多允许连续两个,小数点、下划线、中划线不能直接相连),小写字母或数字结尾,1-64个字符。
  • URI PATCH /v2/manage/namespaces/{namespace}/repos/{repository}/access 表1 路径参数 参数 是否必选 参数类型 描述 namespace 是 String 组织名称。小写字母开头,后面跟小写字母、数字、小数点、下划线或中划线(其中下划线最多允许连续两个,小数点、下划线、中划线不能直接相连),小写字母或数字结尾,1-64个字符。 repository 是 String 镜像仓库名称
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型(格式),下方类型可任选其一使用: application/json;charset=utf-8 application/json 缺省值:application/json X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 [数组元素] 是 Array of UserAuth objects 需要创建镜像权限的信息 表4 UserAuth 参数 是否必选 参数类型 描述 user_id 是 String 用户id,需要从IAM服务获取 user_name 是 String 用户名,需要从IAM服务获取 auth 是 Long 用户权限,7表示管理权限,3表示编辑权限,1表示读取权限
  • URI DELETE /v2/manage/namespaces/{namespace}/repositories/{repository}/access-domains/{access_domain} 表1 路径参数 参数 是否必选 参数类型 描述 namespace 是 String 组织名称。小写字母开头,后面跟小写字母、数字、小数点、下划线或中划线(其中下划线最多允许连续两个,小数点、下划线、中划线不能直接相连),小写字母或数字结尾,1-64个字符。 repository 是 String 镜像仓库名称 access_domain 是 String 共享租户名
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型(格式),下方类型可任选其一使用: application/json;charset=utf-8 application/json 缺省值:application/json X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 action String 触发动作,update app_type String 应用类型,deployments、statefulsets application String 应用名 cluster_id String 集群ID(cci时为空) cluster_name String 集群名(cci时为空) cluster_ns String 应用名所在的namespace condition String 触发条件,type为all时为.*,type为tag时为tag名,type为regular时为正则表达式 container String 需更新的container名,默认为所有container created_at String 创建时间 creator_name String 创建人 enable String 是否生效 name String 触发器名 trigger_history Array of TriggerHistories objects 触发器历史 trigger_mode String 触发器类型,cce、cci trigger_type String 触发条件,all、tag、regular 表4 TriggerHistories 参数 参数类型 描述 action String 触发动作,update app_type String 应用类型,deployments、statefulsets application String 应用名 cluster_id String 集群ID(cci时为空) cluster_name String 集群名(cci时为空) cluster_ns String 应用名所在的namespace condition String 触发条件,type为all时为.*,type为tag时为tag名,type为regular时为正则表达式 container String 需更新的container名,默认为所有container created_at String 创建时间 creator_name String 创建人 detail String 详情 result String 更新结果,success、failed tag String 触发的版本号
  • 响应示例 状态码: 200 查询成功 { "action" : "update", "app_type" : "deployments", "application" : "cci-deployment-20204161", "cluster_id" : "", "cluster_name" : "", "cluster_ns" : "cci-namespace-21539491", "condition" : ".*", "container" : "", "created_at" : "2020-04-16T01:35:08.639589Z", "creator_name" : "paas_swr_z00232859", "enable" : "true", "name" : "test", "trigger_history" : [ { "action" : "update", "app_type" : "deployments", "application" : "cci-deployment-20204161", "cluster_id" : "", "cluster_name" : "", "cluster_ns" : "", "condition" : ".*", "container" : "", "created_at" : "2020-04-16T01:36:36.155119Z", "creator_name" : "************", "detail" : "xxxxxxxxxxxxxx", "result" : "failed", "tag" : "test" } ], "trigger_mode" : "cci", "trigger_type" : "all" }
  • URI GET /v2/manage/namespaces/{namespace}/repos/{repository}/triggers/{trigger} 表1 路径参数 参数 是否必选 参数类型 描述 namespace 是 String 组织名称。小写字母开头,后面跟小写字母、数字、小数点、下划线或中划线(其中下划线最多允许连续两个,小数点、下划线、中划线不能直接相连),小写字母或数字结尾,1-64个字符。 repository 是 String 镜像仓库名称 trigger 是 String 触发器名称
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型(格式),下方类型可任选其一使用: application/json;charset=utf-8 application/json 缺省值:application/json X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 [数组元素] Array of ShowRepoDomainsResponse objects 共享租户列表 表4 ShowRepoDomainsResponse 参数 参数类型 描述 namespace String 组织 repository String 镜像仓库 access_domain String 共享租户名 permit String 权限 deadline String 截止时间 description String 描述 creator_id String 创建者ID creator_name String 创建者名称 created String 镜像创建时间,UTC时间格式,时间为UTC标准时间,用户需要根据本地时间计算偏移量;如东8区需要+8:00 updated String 镜像更新时间,UTC时间格式,时间为UTC标准时间,用户需要根据本地时间计算偏移量;如东8区需要+8:00 status Boolean 是否过期:true:有效;false:过期
  • 响应示例 状态码: 200 成功查询共享账号列表 [ { "namespace" : "huawei", "repository" : "paas", "access_domain" : "swr", "permit" : "read", "deadline" : "2018-10-01T16:00:00.000Z", "description" : "description", "creator_id" : "fb3f175c1fd146ab8cdae3272be6107b", "creator_name" : "huawei", "created" : "2017-04-08T14:12:23Z", "updated" : "2017-04-13T21:01:11Z", "status" : false } ]
  • URI GET /v2/manage/namespaces/{namespace}/repositories/{repository}/access-domains 表1 路径参数 参数 是否必选 参数类型 描述 namespace 是 String 组织名称。小写字母开头,后面跟小写字母、数字、小数点、下划线或中划线(其中下划线最多允许连续两个,小数点、下划线、中划线不能直接相连),小写字母或数字结尾,1-64个字符。 repository 是 String 镜像仓库名称
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型(格式),下方类型可任选其一使用: application/json;charset=utf-8 application/json 缺省值:application/json X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。
共100000条