RegisterCaCertificate - 注册CA证书
云消息队列 MQTT 版支持X.509证书认证，客户端可通过设备证书完成接入认证。CA证书用于为客户端签发设备证书，并验证设备证书的正确性，您需要先将申请的CA证书注册到云消息队列 MQTT 版的服务端上，才能用于认证设备证书。本接口用于将指定CA证书注册到云消息队列 MQTT 版服务端。
接口说明
仅铂金版和专业版实例支持使用 RegisterCaCertificate 接口。
单用户请求频率限制为 500 次/秒。如有特殊需求，请联系云消息队列 MQTT 版技术支持，钉钉群号：35228338。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
mq:RegisterCa |
create |
*Instance
|
无 |
|
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| MqttInstanceId |
string |
是 |
云消息队列 MQTT 版的实例 ID。注册 CA 证书时，需要指定一个实例进行绑定。 |
post-cn-7mz2d****** |
| CaName |
string |
是 |
待注册 CA 证书的名称。 |
mqtt_ca |
| CaContent |
string |
是 |
待注册 CA 证书的内容。 说明
示例中的\n 表示换行。 |
-----BEGIN CERTIFICATE-----\nMIIDuzCCAqdGVzdC5jbi1xaW5n******\n-----END CERTIFICATE----- |
| VerificationContent |
string |
是 |
待注册 CA 证书的验证证书的内容。和 CA 证书的注册码一起使用，用于验证用户拥有该 CA 证书的私钥。 说明
示例中的\n 表示换行。 |
-----BEGIN CERTIFICATE-----\nMIID/DCCAu+Y5sRMpp9tnd+4s******\n-----END CERTIFICATE----- |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
公共参数，每个请求的 ID 都是唯一的，可用于排查和定位问题。 |
020F6A43-19E6-4B6E-B846-44EB31DF**** |
| Sn |
string |
已注册的 CA 证书的 SN 序列号，用于唯一标识一个 CA 证书。 |
007269004887****** |
示例
正常返回示例
JSON格式
{
"RequestId": "020F6A43-19E6-4B6E-B846-44EB31DF****",
"Sn": "007269004887******"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InstancePermissionCheckFailed | An error occurred while validating the permissions of the instance. Please verify the account that created the instance and its permissions settings. | 实例权限校验失败，请确认MQTT实例的所属关系以及授权策略。 |
| 400 | MqttOwnerCheckError | Failed to validate the instance permission | 实例权限校验失败 |
| 400 | RegisterCodeError | Register code error in verification certificate. | 注册码错误 |
| 400 | ParameterFieldCheckFailed | Failed to validate the parameters. The parameters may be missing or invalid. | 参数校验失败，可能缺失或者传入值非法。 |
| 400 | MqttApplyCluster4InstanceFailed | the instance can not find cluster. | 该实例获取集群信息失败 |
| 400 | SystemError | system error. | 系统错误，请重试 |
| 400 | MqttInstanceNotFound | Specified instance is not found | 实例不存在 |
| 401 | RegisterCodeUsed | Register code has been used. | |
| 401 | GetCaNumError | Failed to get ca num. Try again later. | |
| 401 | CaNumExceed | CA certificate num exceed | |
| 401 | CertificateContentError | Certificate content error, please check ca/verification certificate content. BasicConstraints extension should be set to true in CA certificate | |
| 401 | SnNotUnique | Sn is not unique in gloabal | SN 不是全局唯一的 |
| 403 | PermissionCheckFailed | Failed to verify API permissions. | ram权限检查失败 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。