ModifyCenServiceRouteEntryAttributes--云企业网-火山引擎

文档中心

立即注册

导航

ModifyCenServiceRouteEntryAttributes

最近更新时间：2024.10.18 15:45:55首次发布时间：2023.05.09 08:46:44

调用 ModifyCenServiceRouteEntryAttributes 接口，修改指定的云服务访问路由的描述或发布范围。

说明

自定义云服务访问路由发布范围的功能正在邀测中，暂仅支持完成企业认证的账号申请试用，如需试用，请联系客户经理。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表中，PublishToInstances.N.a类型参数中的“N”表示云服务访问路由发布信息的序号，需按照数字顺序从1开始填写，单次调用数量上限100个。多个云服务访问路由的发布信息之间使用&分隔。

参数名称	类型	是否必选	示例值	描述
Action	String	是	ModifyCenServiceRouteEntryAttributes	要执行的操作，取值为ModifyCenServiceRouteEntryAttributes。
Version	String	是	2020-04-01	API版本信息，当前版本为2020-04-01。
CenId	String	是	cen-2nim00ybaylts7trquyzt****	云企业网实例的ID。您可以调用DescribeCens接口获取云企业网实例ID。
DestinationCidrBlock	String	是	100.XX.XX.0/24	云服务部署的地址，必须属于`100.64.0.0/10`或`fd00:64::/32`网段。
ServiceRegionId	String	是	cn-beijing	云服务所属的地域。
Description	String	否	test-service-route	云服务访问的描述信息。必须以字母、数字或中文开头，可包含字母、数字、中文和以下特殊字符：英文逗号（,）、点号（.）、下划线（_）、空格（）、等号（=）、中划线（-）、中文逗号（，）、中文句号（。）。长度限制为0 ~ 255个字符。不传入该参数或该参数不传入数值时，默认为空字符串。
PublishMode	String	否	LocalDCGW	云服务路由的发布范围。 LocalDCGW：表示自动将该云服务访问路由发布到云服务所在地域中所有已加载至CEN实例的专线网关。 Custom：表示手动指定该云服务访问路由需要发布到的网络实例。
PublishToInstances.N.InstanceRegionId	String	否	PublishToInstances.1.InstanceRegionId=cn-guangzhou&PublishToInstances.2.InstanceRegionId=cn-beijing	云服务路由需要发布的地域。云企业网服务支持的地域可参见区域与地域。
PublishToInstances.N.InstanceType	String	否	PublishToInstances.1.InstanceType=VPC&PublishToInstances.2.InstanceType=VPC	云服务访问路由需要发布的网络实例类型。取值如下： VPC：私有网络。 DCGW：专线网关。
PublishToInstances.N.InstanceId	String	否	PublishToInstances.1.InstanceId=vpc-7qthudw0ll6jmc**&PublishToInstances.2.InstanceId=vpc-uf6o8d1dj8sjwxi6o**	云服务访问路由需要发布的网络实例ID。您可以调用DescribeVpcs接口获取“VPC”类型网络实例的ID。您可以调用DescribeDirectConnectGateways接口获取“DCGW”类型网络实例的ID。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

GET /?Action=ModifyCenServiceRouteEntryAttributes&Version=2020-04-01&CenId=cen-2nim00ybaylts7trquyzt****&DestinationCidrBlock=100.XX.XX.0/24&ServiceRegionId=cn-beijing HTTP/1.1
Host: open.volcengineapi.com
Service: cen
Region: cn-beijing

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20211222122528010225****",
        "Action": "ModifyCenServiceRouteEntryAttributes",
        "Version": "2020-04-01",
        "Service": "cen",
        "Region": "cn-beijing"
    },
    "Result": {}
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

HttpCode	错误码	错误信息	描述
400	InvalidCidr.Malformed	The specified cidr block is malformed.	指定的网段格式不合法。
400	InvalidDescription.Malformed	The specified description is malformed. Ensure the maximum length of description is 255.	指定的描述格式不合法，描述长度不能超过255个字符。
400	InvalidDescription.Malformed	The specified description is malformed.	指定的描述格式不合法，请修复描述格式后重试。
400	InvalidServiceRoute.Existed	The specified service route already exists.	指定的云服务访问路由已经存在。
400	InvalidServiceRoute.PublishInstanceDuplicated	The specified publish instance is specified more than once in the request.	指定的发布实例存在重复。
400	InvalidServiceRouteEntry.NotFound	The specified service route entry does not exist.	指定的云服务访问路由不存在。
404	InvalidServiceRoute.PublishInstanceNotFound	The specified publish instance does not exist.	指定的发布实例不存在。
409	InvalidCen.InvalidStatus	The specified CEN instance is not in the correct status for the request.	指定的云企业网实例所处的状态无法响应该请求，请稍后再试。
409	InvalidServiceRoute.Conflict	There is conflict between the specified service route and existed routes.	指定的云服务路由和云企业网路由表中已存在的路由存在冲突。
409	InvalidServiceRouteEntry.InvalidStatus	The specified CEN service route is not in the correct status for the request.	指定的云服务路由所处的状态无法响应该请求，请稍后再试。