更新时间:2025-05-12 GMT+08:00
分享

批量修改域名组

典型场景

批量修改域名组。

接口功能

批量修改域名组。

接口约束

该接口仅支持租户视图或msp代维视图下,角色为“Open Api Operator”的用户访问,必须在用户会话建立后使用。

调用方法

PUT

URI

/controller/campus/v1/sdwan/policy/security/domain-set

请求参数

表1 body参数列表

参数名称

必选

类型

参数值域

默认值

参数说明

参数示例

DomainSetInfos

REFERENCE

详细请参见表2

修改域名组请求数据。

-

请求示例

HTTP的示例
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

相关文档

    OSZAR »