批量修改域名组
典型场景
批量修改域名组。
接口功能
批量修改域名组。
接口约束
该接口仅支持租户视图或msp代维视图下,角色为“Open Api Operator”的用户访问,必须在用户会话建立后使用。
调用方法
PUT
URI
/controller/campus/v1/sdwan/policy/security/domain-set
请求参数
参数名称 |
必选 |
类型 |
参数值域 |
默认值 |
参数说明 |
参数示例 |
---|---|---|---|---|---|---|
DomainSetInfos |
是 |
REFERENCE |
详细请参见表2。 |
修改域名组请求数据。 |
- |
请求示例
PUT /controller/campus/v1/sdwan/policy/security/domain-set HTTP/1.1 Host: 192.168.1.125:18002 Content-Type: application/json Accept: application/json Accept-Language: en-US X-ACCESS-TOKEN: x-yyyyyy { "domainSetInfo" : [ { "id" : "000000-0000-0000-0000-000000000000", "name" : "test_1", "description" : "XXX", "domainNames" : [ "www.test.com" ] } ] }
响应参数
返回状态码为200:修改成功,响应体参考DomainSetResponse。
DomainSetResponse对象的参数列表,详细请参见表4。
返回状态码为202:请求正在处理中,请求处理详情请通过“查询业务编排结果”接口,确认是否处理成功。响应体参考DomainSetResponse。
返回状态码为400:请求参数错误,无响应体。
详细信息请参见实际响应消息体。
返回状态码为500:内部错误,无响应体。
详细信息请参见实际响应消息体。
响应示例
返回状态码为200:修改成功,响应体参考DomainSetResponse。
HTTP/1.1 200 OK Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive { "errcode" : "0", "errmsg" : "", "processInstanceId" : "", "success" : [ { "id" : "000000-0000-0000-0000-000000000000", "name" : "test_1", "description" : "XXX", "domainNames" : [ "www.test.com" ] } ], "fail" : [ { "errcode" : "0x00c8000c", "errmsg" : "The parameter is invalid.", "data" : { "id" : "000000-0000-0000-0000-000000000000", "name" : "test_1", "description" : "XXX", "domainNames" : [ "www.test.com" ] } } ] }
返回状态码为202:请求正在处理中,请求处理详情请通过“查询业务编排结果”接口,确认是否处理成功。响应体参考DomainSetResponse。
HTTP/1.1 202 Accepted Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive
返回状态码为400:请求参数错误,无响应体。
HTTP/1.1 400 Bad Request Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive
返回状态码为500:内部错误,无响应体。
HTTP/1.1 500 Internal Server Error Date: Sun,11 May 2025 10:00:00 GMT Server: example-server Content-Type: application/json;charset=UTF-8 Content-Length: 250 Connection: keep-alive