文档首页/ 应用管理与运维平台 ServiceStage/ API参考/ 应用管理API(v3版本)/ 环境/ 根据环境ID修改环境资源 - ModifyEnvironmentResourceBasedOnTheEnvironmentID
更新时间:2026-02-28 GMT+08:00
分享

根据环境ID修改环境资源 - ModifyEnvironmentResourceBasedOnTheEnvironmentID

功能介绍

此API用于通过环境ID修改环境资源。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

URI

PUT /v3/{project_id}/cas/environments/{environment_id}/resources

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

租户项目ID。获取方法,请参考获取项目ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

environment_id

String

参数解释:

环境ID。获取方法,请参考获取所有环境 - ObtainAllEnvironments

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求消息

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

参数解释:

消息体的类型(格式)。

约束限制:

不涉及

取值范围:

application/json;charset=utf8

默认取值:

不涉及

X-Auth-Token

String

参数解释:

调用接口的认证方式分为Token和AK/SK两种,如果您使用的Token方式,此参数为必填,请填写Token的值。Token获取方式,请参考认证鉴权

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

resources

Array of objects

参数解释:

资源对象,请参考表4

表4 resources

参数

是否必选

参数类型

描述

id

String

参数解释:

资源ID(为了保证接口调用正常,请您确保调用前输入正确的资源ID)。

取值范围:

不涉及

默认取值:

不涉及

name

String

参数解释:

资源名称。

取值范围:

不涉及

默认取值:

不涉及

type

String

参数解释:

资源类型。

取值范围:

  • vpc:虚拟私有云。
  • eip:弹性IP。
  • elb:弹性负载均衡。
  • cce:云容器引擎。
  • ecs:弹性云服务器。
  • as:弹性伸缩组。
  • cse:ServiceComb引擎。
  • nacos:注册配置中心。
  • ms_gateway:应用网关。

    “华东-上海一”“亚太-新加坡”区域支持纳管应用网关,用于使用全链路流量控制功能。

  • dcs:分布式缓存服务。
  • rds:云数据库RDS。
  • subnet:子网。
  • acl:网络ACL。
  • customServer:自定义服务器。
  • gaussdb:云数据库GaussDB。
  • dms_rocketmq:分布式消息服务RocketMQ。
  • css_es:云搜索服务Elasticsearch。
  • custom_k8s:自定义kubernetes集群。

默认取值:

不涉及

parameters

Map<String, String>

参数解释:

资源参数,请参考表5

alias

String

参数解释:

资源别名。

取值范围:

不涉及

默认取值:

不涉及

表5 parameters

参数

是否必选

参数类型

描述

kube_config

String

参数解释:

Kubernetes连接配置文件。

资源类型为custom_k8s时需要设置此参数。

取值范围:

不涉及

默认取值:

不涉及

响应消息

表6 响应参数

参数

参数类型

描述

resources

Array of objects

参数解释:

资源对象,请参考表7

表7 schemas

参数

参数类型

描述

id

String

参数解释:

资源ID。

取值范围:

不涉及

name

String

参数解释:

资源名称。

取值范围:

不涉及

type

String

参数解释:

资源类型。

取值范围:

  • eip:弹性IP。
  • elb:弹性负载均衡。
  • cce:云容器引擎。
  • ecs:弹性云服务器。
  • as:弹性伸缩组。
  • cse:微服务引擎。
  • dcs:分布式缓存服务。
  • rds:云数据库RDS。
  • gaussdb:云数据库GaussDB。
  • dms_rocketmq:分布式消息服务RocketMQ。
  • css_es:云搜索服务Elasticsearch。
  • custom_k8s:自定义kubernetes集群。

parameters

Map<String, String>

参数解释:

资源参数,请参考表8

表8 parameters

参数

参数类型

描述

kube_config

String

参数解释:

Kubernetes连接配置文件。

资源类型为custom_k8s时返回此参数。

取值范围:

不涉及

请求示例

修改环境ECS资源为id为67835bb3-1235-4cc9-be71-becbb2b4ca0d、名称为ecs-a5a9的弹性云服务器。

{
    "resources": [
        {
            "id": "67835bb3-1235-4cc9-be71-becbb2b4ca0d",
            "name": "ecs-a5a9",
            "type": "ecs"
        }
    ]
}

响应示例

{
    "resources": [
        {
            "id": "67835bb3-1235-4cc9-be71-becbb2b4ca0d",
            "type": "ecs",
            "name": "ecs-a5a9"
        }
    ]
}

状态码

状态码

描述

200

操作成功。

400

错误的请求。

404

请求对象不存在。

500

内部错误。

错误码

请参考ServiceStage错误码

相关文档