获取所有组件
功能介绍
此API用于获取所有应用组件。
调试
您可以在API Explorer中调试该接口。
URI
GET /v3/{project_id}/cas/components
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
租户项目ID。获取方法,请参考获取项目ID。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
limit |
否 |
integer |
查询个数,取值[0, 100]。 |
offset |
否 |
integer |
查询偏移量,表示查询第n条数据后的结果。 |
order_by |
否 |
String |
排序字段。 排序字段支持以下枚举值:
传值不在支持的枚举值范围内的话按默认排序字段排序。 |
order |
否 |
String |
排序方式。
|
application_name |
否 |
String |
应用名称。 |
component_name |
否 |
String |
组件名称。 |
请求消息
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
Content-Type |
是 |
String |
消息体的类型(格式),默认取值为“application/json;charset=utf8”。 |
X-Auth-Token |
是 |
String |
调用接口的认证方式分为Token和AK/SK两种,如果您使用的Token方式,此参数为必填,请填写Token的值。Token获取方式,请参考认证鉴权。 |
响应消息
参数 |
参数类型 |
描述 |
---|---|---|
count |
Integer |
组件总数。 |
components |
Array of objects |
组件参数,请参考表5。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
组件ID。 |
name |
String |
组件名称。 |
labels |
Array of objects |
标签。容器部署可通过标签查询对应工作负载,虚机部署可配置对应的微服务名称的标签来使用优雅上下线功能,请参考表10。 |
status |
Object |
组件状态,请参考表8。 |
runtime_stack |
Object |
技术栈,请参考表7。 |
application_name |
String |
应用名称。 |
application_id |
String |
应用ID。 |
environment_name |
String |
环境名称。 |
environment_id |
String |
环境ID。 |
version |
String |
版本号。 |
source |
Object |
代码/软件包来源,请参考表6。 |
creator |
String |
创建人。 |
platform_type |
String |
运行平台类型,应用可以在不同的平台上运行,可选用的平台的类型有以下几种:
|
external_accesses |
Array of Objects |
外部访问,请参考表11。 |
workload_kind |
String |
工作负载类型。
|
is_multi_containers |
Boolean |
是否是多容器。 |
enterprise_project_id |
String |
企业项目ID。 |
engine_id |
String |
引擎ID。 |
swimlane_tag |
String |
泳道标签。 |
swimlane |
Object |
所属泳道,请参考表12。 |
refer_resources |
Array of Objects |
关联资源,请参考表14。 |
config_mode |
String |
组件创建方式。
|
template_source |
Object |
组件模板包来源,请参考表20。 |
参数 |
参数类型 |
描述 |
---|---|---|
kind |
String |
组件来源类型。
|
version |
String |
版本号。 |
url |
String |
包地址,类型为package和image时需要添加。 |
storage |
String |
存储方式,例如:obs。 |
auth |
String |
认证方式,例如:iam。 |
repo_auth |
String |
授权名称。 |
repo_namespace |
String |
代码仓库命名空间。 |
repo_ref |
String |
代码分支或者Tag,例如:master。 |
repo_type |
String |
代码仓类型,例如:CodeArts、Gitee、GitHub、BitBucket、GitLab。 |
web_url |
String |
代码跳转链接,例如:https://github.com/example/demo.git。 |
repo_url |
String |
代码仓url,例如:https://github.com/example/demo.git。 |
http_username |
String |
在“storage”为“http”时需要填写,支持用户名、密码认证,这里填写用户名。 |
http_password |
String |
在“storage”为“http”时需要填写,支持用户名、密码认证,这里填写密码。 |
http_command |
String |
在“storage”为“http”时需要填写,这里是用户定义软件包的地址。 |
http_headers |
Map<String, String> |
在“storage”为“http”时需要填写,支持用户自定义请求头,支持填写一个key,value,例如{"key":"xx","value":"xx""},其中的key和value关键字固定。 |
参数 |
参数类型 |
描述 |
---|---|---|
name |
String |
技术栈名称。 |
type |
String |
技术栈类型,支持Java、Tomcat、Nodejs、Php、Docker、Python。 当部署模式为虚机部署时,仅支持Java、Tomcat、Nodejs;容器部署上述类型都支持。 |
version |
String |
技术栈版本,例如:1.1.4。 |
deploy_mode |
String |
部署模式。
|
参数 |
参数类型 |
描述 |
---|---|---|
component_status |
String |
组件状态。
|
available_replica |
Integer |
可用实例。 |
replica |
Integer |
总实例。 |
succeeded_replica |
Integer |
普通任务工作负载执行成功的实例数。 |
fail_detail |
String |
失败原因。
|
last_job_id |
String |
最后执行任务ID。 |
create_time |
Integer |
创建时间。 |
update_time |
Integer |
更新时间。 |
creator |
String |
创建人。 |
artifact |
Object |
组件构建信息,请参考表9。 |
参数 |
参数类型 |
描述 |
---|---|---|
protocol |
String |
外部访问类型,取值范围为:http、https。 |
address |
String |
外部访问地址。 |
forward_port |
Integer |
外部访问端口。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
泳道ID。 |
name |
String |
泳道名称 |
swimlane_group_id |
String |
所属泳道组ID。 |
type |
String |
泳道类型。
|
tag |
String |
泳道标签,根据标签来控制流量的走向。 |
route_status |
String |
泳道路由状态。
|
rule_match_mode |
String |
路由规则匹配模式。当泳道组灰度类型为基于内容,即gray_release_type为CONTENT时生效。
|
rules |
Array of objects |
路由规则。当泳道组灰度类型为基于内容,即gray_release_type为CONTENT时生效。请参考表13。 |
weight |
Integer |
泳道流量权重,范围在0-100之间。当泳道组灰度类型为基于流量,即gray_release_type为WEIGHT时生效。 |
project_id |
String |
项目ID。 |
create_time |
Integer |
创建时间。 |
update_time |
Integer |
更新时间。 |
creator |
String |
创建人。 |
swimlane_group |
Object |
所属泳道组,请参考表17。 |
engine_ids |
Array of String |
引擎ID列表。 |
参数 |
参数类型 |
描述 |
---|---|---|
type |
String |
灰度匹配规则类型。当前只支持HEADER,即基于Header头进行匹配。 |
key |
String |
键。 |
value |
String |
值。 |
condition |
String |
匹配条件。
|
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
资源ID。 |
instance_id |
String |
组件实例ID。 |
type |
String |
资源类型:
|
refer_type |
String |
资源类别。
|
refer_alias |
String |
资源别名。 |
parameters |
Object |
资源参数,请参考表15。 |
selectors |
Objects |
资源选择器,请参考表16。 |
参数 |
参数类型 |
描述 |
---|---|---|
namespace |
String |
命名空间。 |
name |
String |
资源名称。 |
capacity |
Integer |
存储容量,单位GiB。 |
type |
String |
存储卷声明类型,当表14中的type为pvc时指定。
|
class |
String |
存储卷声明子类型。
|
pv_name |
String |
存储卷名称。type为efs时展示。 |
share_id |
String |
存储卷句柄。type为efs时展示。 |
share_export_location |
String |
存储卷共享路径。type为efs时展示。 |
share_proto |
String |
存储卷文件系统类型。type为efs时展示。默认为NFS。 |
obs_volume_type |
String |
OBS存储卷类型,默认为STANDARD标准存储类型。 |
access_mode |
String |
存储卷访问模式。
|
availableZone |
String |
可用区。 |
volume_type |
String |
存储卷类型。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
泳道组ID。 |
name |
String |
泳道组名称。 |
description |
String |
泳道组描述。 |
creator |
String |
创建人。 |
project_id |
String |
项目ID。 |
gray_release_type |
String |
泳道组灰度类型。
|
engine_ids |
Array of string |
网关目标服务引擎ID。 |
gateways |
Array of objects |
目标服务列表,请参考表18。 |
create_time |
Integer |
创建时间。 |
update_time |
Integer |
更新时间。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
网关ID。 |
name |
String |
网关名称。 |
engine_id |
String |
目标服务引擎ID,对应于目标服务对应的服务来源所用的引擎ID。 |
target_services |
Array of objects |
目标服务列表,对应于网关服务管理中的服务。请参考表19。 |
参数 |
参数类型 |
描述 |
---|---|---|
storage |
String |
组件模板包存储方式。
|
url |
String |
组件模板包地址。 组件模板包存储方式为自定义文件地址时有效。 |
http_username |
String |
用户名。 组件模板包存储方式为自定义文件地址且安全认证方式为用户名密码认证时有效。 |
http_password |
String |
密码。 组件模板包存储方式为自定义文件地址且安全认证方式为用户名密码认证时有效。 |
http_headers |
Array of objects |
请求头,请参考表21。 组件模板包存储方式为自定义文件地址且安全认证方式为自定义Header认证时有效。 |
请求示例
无
响应示例
{ "components": [ { "source": { "kind": "package", "url": "obs://bucket0001/weather-1.0.0.jar", "storage": "obs" }, "name": "mycomponent", "id": "b8702b0f-94d3-4822-98a1-56815632a0a0", "labels": null, "runtime_stack": { "name": "OpenJDK8", "deploy_mode": "virtualmachine", "version": "1.1.1" }, "external_accesses": null, "status": { "component_status": "RUNNING", "available_replica": 1, "replica": 1, "fail_detail": null, "last_job_id": "JOB8be53b2a-af9a-4e2b-8505-096688a52237", "creator": "ss-test", "create_time": 1679556221028, "update_time": 1679556318779 }, "environment_name": "sudo", "environment_id": "4d084044-0b80-4641-963c-b9c9f4092a4f", "application_name": "app-39mbbn", "application_id": "fc092465-a5fb-4a52-bc65-b735f18366d8", "creator": "ss-test", "platform_type": "cce", "version": "2023.0323.15181" } ], "count": 1 }
状态码
状态码 |
描述 |
---|---|
200 |
操作成功 |
400 |
错误的请求 |
404 |
请求对象不存在 |
500 |
内部错误 |
错误码
请参考ServiceStage错误码。