-
响应示例 返回状态码为200：查询成功，响应体参考BatchQueryDeviceCertificateResponseDto。 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" : "",
"data" : [
{
"deviceId" : "00000000-0000-0000-0000-000000000000",
"deviceEsn" : "esn",
"certificationStatus" : "0",
"issuer" : "Huawei Equipment CA",
"issuerDatetime" : 1557187200000,
"expirationDatetime" : 1558656000000,
"failureReason" : "在线更新设备证书失败"
}
]
} 返回状态码为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
-
响应参数 返回状态码为200：查询成功，响应体参考BatchQueryDeviceCertificateResponseDto。 表3 BatchQueryDeviceCertificateResponseDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 1~64个字符。 - 错误码。 "0" errmsg string 0~64个字符。 - 错误信息。 "" data ARRAY_REFERENCE 0-100个列表项，详细请参见表3。 结果返回列表 - 返回状态码为400：校验异常，无响应体。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误，无响应体。 详细信息请参见实际响应消息体。
-
请求示例 HTTP的示例 POST /controller/campus/v1/oamservice/certification/device/certificate/batch-query HTTP/1.1
Host: 192.168.1.125:18002
Content-Type: application/json
Accept: application/json
Accept-Language: en-US
X-AC
CES S-TOKEN: x-yyyyyy
{
"deviceIds" : [
"57f879c7-7f6a-4d3a-88af-bf2585cb61e0"
]
}
-
响应示例 返回状态码为200：查询成功，响应体参考QueryDeviceCertificateResponseDto。 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" : "",
"data" : {
"deviceId" : "00000000-0000-0000-0000-000000000000",
"deviceEsn" : "esn",
"certificationStatus" : "0",
"issuer" : "Huawei Equipment CA",
"issuerDatetime" : 1557187200000,
"expirationDatetime" : 1558656000000,
"failureReason" : "在线更新设备证书失败"
}
} 返回状态码为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
-
请求示例 HTTP的示例 GET /controller/campus/v1/oamservice/certification/device/certificate?deviceId=fbb684c8-0d37-496f-bafa-4b06d5151e2e 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
-
响应参数 返回状态码为200：查询成功，响应体参考QueryDeviceCertificateResponseDto。 表2 QueryDeviceCertificateResponseDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 1~64个字符。 - 错误码。 "0" errmsg string 1~64个字符。 - 错误信息。 "" data REFERENCE 详细请参见表3。 - - 表3 DeviceCertificateDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 deviceId string 1~64个字符。 - 设备ID。 "00000000-0000-0000-0000-000000000000" deviceEsn string 1~64个字符。 - 设备ESN。 "esn" certificationStatus string 1~64个字符。 - 证书状态（0：初始化，1：申请中，2：申请成功，3：申请失败，4：等待中）。 "0" issuer string - - 证书授权者（"Huawei Equipment CA"，"Huawei Switch & Enterprise Communications Product Line CA"，"Other 3rd Issuer CA"）。 "Huawei Equipment CA" issuerDatetime int64 - - 发行时间（UTC）。 1557187200000 expirationDatetime int64 - - 到期时间（UTC）。 1558656000000 failureReason string 0~256个字符。 - 失败原因。 "在线更新设备证书失败" 返回状态码为400：校验异常，无响应体。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误，无响应体。 详细信息请参见实际响应消息体。
-
请求示例 HTTP的示例 POST /controller/campus/v1/oamservice/certification/device/certificate/batch-update 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
{
"deviceIds" : [
"57f879c7-7f6a-4d3a-88af-bf2585cb61e0"
],
"caServerId" : "00000000-0000-0000-0000-000000000000",
"algorithm" : "rsa",
"algLength" : "4096",
"entity" : {
"ipAddress" : "10.1.1.1",
"fqdn" : "test.abc.com",
"email" : "user@abc.com",
"country" : "cn",
"state" : "jiangsu",
"organization" : "huawei",
"department" : "huawei"
},
"transportNetworkPortId" : "00000000-0000-0000-0000-000000000000",
"challengePwd" : "password",
"vpnId" : "18bd7aec-f163-4091-bc5e-d6c19725d72c",
"vpnInstanceName" : "vpn1",
"sourceInterface" : "loopback1",
"urlMode" : 1,
"sslClientVersion" : "tls1.2",
"sslClientCipher" : 16,
"pkiDomain" : "default"
}
-
响应示例 返回状态码为200：更新成功，响应体参考BatchReplaceDeviceCertificateResponseDto。 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" : ""
} 返回状态码为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
-
响应参数 返回状态码为200：更新成功，响应体参考BatchReplaceDeviceCertificateResponseDto。 表3 BatchReplaceDeviceCertificateResponseDto对象的参数列表 参数名称 类型 参数值域 默认值 参数说明 参数示例 errcode string 1~64个字符。 - 错误码。 "0" errmsg string 0~64个字符。 - 错误信息。 "" 返回状态码为400：校验异常，无响应体。 详细信息请参见实际响应消息体。 返回状态码为500：内部错误，无响应体。 详细信息请参见实际响应消息体。
