检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
Key)加密调用请求。 Token认证 Token的有效期为24小时,需要使用一个Token鉴权时,可以先缓存起来,避免频繁调用。 Token在计算机系统中代表令牌(临时)的意思,拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头,从而通过身份认证,获得操作API的权限。
用户通过控制台访问DevStar,可以浏览和使用模板,以及对模板及应用的全生命周期管理。 API方式 如果用户需要将公有云平台上的DevStar集成到第三方系统,用于二次开发,请使用API方式访问。 CLI方式 支持用户通过CLI方式访问DevStar,提供模板浏览和按模板生成框架代码的能力。
查询模板 功能 查看系统当前可使用的模板列表。 语法 hcloud DevStar ListTemplates --cli-region="cn-north-1" [--keyword=template_name] 参数说明 表1 请求参数说明 参数名称 是否必选 参数描述 template_name
与其它云服务的关系 DevStar与周边服务的依赖关系 服务名称 DevStar服务与其他服务的关系 主要交互功能 CodeArts Req 新建代码仓、流水线所依赖的CodeArts项目 查询当前用户名下的项目 新建一个项目 CodeArts Repo 按模板生成的代码可以在CodeArts
状态码 状态码如表1所示 表1 状态码 状态码 编码 错误码说明 100 Continue 继续请求。 这个临时响应用来通知客户端,它的部分请求已经被服务器接收,且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如,切换到HTTP的新版本协议。
安装命令行工具 前提条件 操作系统为 Linux、Windows或Mac OS。 安装 node.js 10以上版本。 操作步骤 下载命令行工具。 npm install -g @huaweicloud/hcloud 验证命令行工具安装结果。 执行如下命令,显示版本号则安装成功。
失败原因 表5 PipelineBasic 参数 参数类型 描述 uuid String DevStar系统生成的流水线UUID id String CloudPipeline系统对应流水线ID name String 流水线名称 url String 流水线地址 last_running_status
读取模板文件 功能介绍 该接口可以用于模板作者或模板维护人读取模板文件内容。 调试 您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。 URI GET /v1/templates/{template_id}/files
构造请求 本节介绍REST API请求的组成,并以调用IAM服务的获取用户Token接口说明如何调用API,该API获取用户的Token,Token可以用于调用其他API时鉴权。 请求URI 请求URI由如下部分组成。 {URI-scheme} :// {Endpoint} / {resource-path}
返回结果 状态码 请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。 对于获取用户Token接口,如果调用后返回状态码为“201”,则表示请求成功。 响应消息头 对应请求
代码生成 功能 通过 DevStar 模板生成代码。 语法 hcloud DevStar <operation> --cli-region="cn-north-1" --param1=value1 --param2=value2 ... 其中 “operation”可选内容如下:
更多服务错误码请参见API错误中心。 状态码 错误码 错误信息 描述 处理措施 400 DEVSTAR.1000 System busy. Try again later. 系统繁忙,请稍后再试 请稍后再试 400 DEVSTAR.1001 Invalid parameter. 非法参数 请联系技术支持 400 DEVSTAR
失败原因 表6 PipelineBasic 参数 参数类型 描述 uuid String DevStar系统生成的流水线UUID id String CloudPipeline系统对应流水线ID name String 流水线名称 url String 流水线地址 last_running_status