文档首页/ 应用服务网格 ASM/ API参考/ API/ 网格接口/ 更新网格配置 - UpdateMeshConfig
更新时间：2026-06-24 GMT+08:00
在线调试
CLI示例
查看PDF
分享

更新网格配置 - UpdateMeshConfig

功能介绍

该接口用于更新网格配置。

调用方法

请参见如何调用API。

授权信息

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

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    asm:mesh:update

    Write

    mesh *

    • g:EnterpriseProjectId

    • g:ResourceTag/<tag-key>

    -

    -

URI

PUT /v1/{project_id}/meshes/{mesh_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。

mesh_id

是

String

网格ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

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

Content-Type

是

String

消息体的类型（格式）。

取值范围：

  • application/json;charset=utf-8：指定内容为JSON格式，并以UTF8字符编码进行编码

  • application/json：指定内容为JSON格式
表3 请求Body参数

参数

是否必选

参数类型

描述

config

是

UpdateMeshConfig object

网格更新配置
表4 UpdateMeshConfig

参数

是否必选

参数类型

描述

telemetryConfig

否

TelemetryConfig object
表5 TelemetryConfig

参数

是否必选

参数类型

描述

metrics

否

Metric object

应用指标配置，用于上报ASM网格指标数据。如果要启用该配置，集群需安装云原生监控插件。

accessLogging

否

AccessLogging object

AccessLog配置，用于上报ASM网格内Istio代理的访问日志。如果要启用该配置，集群需安装云原生日志采集插件。

tracing

否

Tracing object

Tracing配置，用于上报ASM网格内的调用链数据。
表6 Metric

参数

是否必选

参数类型

描述

aom

否

Array of Aom objects

AOM实例配置。
表7 Aom

参数

是否必选

参数类型

描述

instanceID

是

String

AOM实例ID。
表8 AccessLogging

参数

是否必选

参数类型

描述

lts

否

Array of LtsConfig objects

LTS配置
表9 LtsConfig

参数

是否必选

参数类型

描述

logGroupID

否

String

AccessLog日志组ID

logStreamID

否

String

AccessLog输出日志流ID
表10 Tracing

参数

是否必选

参数类型

描述

randomSamplingPercentage

否

Float

tracing采样率

defaultProviders

否

Array of strings

tracing默认上报的provider名称，必须与extensionProviders中的name字段匹配，或使用ASM预设的provider "apm-otel"。

如果使用"apm-otel"，需确认当前region已支持APM2.0且网格版本大于1.18。

extensionProviders

否

Array of TracingExtensionProvider objects

用户自配置provider，目前支持zipkin协议。

如果用户配置zipkin协议的provider，请保证网格版本大于等于1.15。
表11 TracingExtensionProvider

参数

是否必选

参数类型

描述

name

否

String

provider实例name

zipkin

否

ZipkinTracingProvider object

zipkin协议provider自有配置
表12 ZipkinTracingProvider

参数

是否必选

参数类型

描述

service

否

String

zipkin服务地址

port

否

Integer

zipkin服务端口

响应参数

状态码：200

表13 响应Body参数

参数

参数类型

描述

-

String

表示网格更新成功

状态码：400

表14 响应Body参数

参数

参数类型

描述

errorCode

String

错误码

errorMsg

String

错误描述

状态码：404

表15 响应Body参数

参数

参数类型

描述

errorCode

String

错误码

errorMsg

String

错误描述

状态码：500

表16 响应Body参数

参数

参数类型

描述

errorCode

String

错误码

errorMsg

String

错误描述

请求示例

关闭网格的tracing能力

PUT /v1/719217bc273743xxxxxxxxae8bc34480/meshes/217719bc273743xxxxxxxxae4808bc34

{
  "config" : {
    "telemetryConfig" : {
      "tracing" : {
        "defaultProviders" : [ ]
      }
    }
  }
}

响应示例

无

状态码

状态码

描述

200

表示网格配置更新成功

400

用户提供的参数有问题，未通过校验

404

未找到指定的网格

500

内部错误

错误码

请参见错误码。

父主题： 网格接口

相关文档