1. 接口描述
接口请求域名： mqtt.tencentcloudapi.com 。
跨集群灾备场景下查询设备证书同步记录
默认接口请求频率限制：20次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：DescribeDeviceCertificateBackupHistory。 |
| Version | 是 | String | 公共参数，本接口取值：2024-05-16。 |
| Region | 是 | String | 公共参数，详见产品支持的 地域列表。 |
| InstanceId | 是 | String | 腾讯云MQTT实例ID，从 DescribeInstanceList接口或控制台获得。 示例值：mqtt-mzj7aqxk |
| Destination | 是 | String | 目标集群的集群ID 示例值：mqtt-**** |
| CaSn | 否 | String | CA证书的SN 示例值：1b1e3bf***a7e66f05 |
| DeviceCertificateSn | 否 | String | 设备证书的SN 示例值：eef65*f94d707a59913 |
| ModificationTimeStart | 否 | Integer | 同步发生开始时间（毫秒级时间戳） 示例值：1782121790065 |
| ModificationTimeEnd | 否 | Integer | 同步结束时间（毫秒级时间戳） 示例值：1782121790069 |
| Limit | 否 | Integer | 查询条数，默认20，最大1024 示例值：100 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| Data | Array of DeviceCertificateBackupHistoryItem | 设备证书列表 |
| RequestId | String | 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 示例
输入示例
POST / HTTP/1.1
Host: mqtt.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeDeviceCertificateBackupHistory
<公共请求参数>
{
"InstanceId": "mqtt-mzj7aqxk",
"Destination": "mqtt-********",
"DeviceCertificateSn": "eef6**5*******************f94d707a59913",
"CaSn": "1b1e3bf*******************a7e66f05"
}输出示例
{
"Response": {
"Data": [
{
"CaSn": "1b1e3bf3702110125887a3a721a7e66f05522513",
"CertificateSource": "JITP",
"ClientId": "clientsun",
"DeviceCertificate": "-----BEGIN CERTIFICATE-----\n*******************************************************************************************************************************************************************************************************************************************************************************************************************************GMQswCQYD\nVQQGEwJDTjEXMBUGA1UECAwOc3VuLmppYW4ueGlvbmcxDTALBgNVBAcMBHhpYW4x\nEDAOBgNVBAoMB3RlbmNlbnQxCzAJBgNVBAsMAnR4MQswCQYDVQQDDAJ0eDEjMCEG\nCSqGSIb3DQEJARYUamVoYW5zdW5AdGVuY2VudC5jb20wggEiMA0GCSqGSIb3DQEB\nAQUAA4IBDwAwggEKAoIBAQCry5JrV8CoIP6Jt6fw7ZfIVFdVGcUzorrcx7DXgj/F\nR0pWp4UxR00ZNQ4C24jDitEHbiX3ZoULraxKRnrkx1fJIcs+/vyB85gAlfOa9orz\n6rVHVMGz4dc967GT6LhL3yCbE1d8KRmOOrFqC+ZV/hNreotluJ05pWKwL+3ftuzL\nOi6N6UQ4D5TUR8FNeITo/ArrRtZsySV3kDsmCy+FKbe62yuSvO2WIQ4kGAw4MS6D\nmCYQ8RaxEeEu2TtmFWsLuwZy0mtOlLAZ4iuJg6wJHYmvqkIGJeEjP1U4WPWdmVgK\nLhu0V1YRs0k8r1c3j3SZANp40WusWYhr4l9SVw4yfod1AgMBAAGjQjBAMB0GA1Ud\nDgQWBBTXHECdrJBedaw4unI7JWf/KcmUEjAfBgNVHSMEGDAWgBRGllwHWUUctxz7\n41ejQQGGWBoQ3zANBgkqhkiG9w0BAQsFAAOCAQEAxMRW6AXHrVBW9cKbd7XkcIpx\nvfVOrlnYWRN7enz/SHOkO0T+r0JvzQ0IAUHLfcZc99CjM5GY6PyuQtdorINvbSlg\nC7n/ITry1qhAjwgDKQletcyOWCmALwK4YASZ2gDlJ9uUaLaoj9W0amHx8KjaKwu7\nQFMDd1YzUa2SWkrEuaUli2AkhTzeLMVQlSy+n1gQ0B2R4hDhJis/sCRkfKzUEGID\nuuDs7t/KaH7BQqCv0hjdyKJtttPUVw01gGE08tDOHkOLD0BihQUT95o3ush8i2kE\nTCoA+AK4cYilHmP2hpE4s2CZRzaSLebcLziVWvrTyAUGnKHrrFeSYaRzHOmcvQ==\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\nMIIEvDCCA6SgAwIBAgIUGx4783AhEBJYh6OnIafmbwVSJRMwDQYJKoZIhvcNAQEL\nBQAwgZIxCzAJBgNVBAYTAmNuMQ0wCwYDVQQIDAR4aWFuMQ0wCwYDVQQHDARodXlp\nMREwDwYDVQQKDAhqZWhhbnN1bjEWMBQGA1UECwwNdW5pdCBqZWhhbnN1bjEVMBMG\nA1UEAwwMc3Vuamlhbnhpb25nMSMwIQYJKoZIhvcNAQkBFhRqZWhhbnN1bkB0ZW5j\nZW50LmNvbTAeFw0yNDA1MDYwODM2NDFaFw0zNDA1MDQwODM2NDFaMIGSMQswCQYD\nVQQGEwJjbjENMAsGA1UECAwEeGlhbjENMAsGA1UEBwwEaHV5aTERMA8GA1UECgwI\namVoYW5zdW4xFjAUBgNVBAsMDXVuaXQgamVoYW5zdW4xFTATBgNVBAMMDHN1bmpp\nYW54aW9uZzEjMCEGCSqGSIb3DQEJARYUamVoYW5zdW5AdGVuY2VudC5jb20wggEi\nMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDfgKyMAZsTIibnNGG92MUhzM3F\nZPD+be8x4TF+h5EGODWam8+b7z57amNc7gbelNcL1kAa25Xd39E8xZbhHSMP2vby\ndivs/ZGNJYFlOU1g7IGrDEnPaw402g4S0lMHWwvvtwPJxNa5JP6haI+0N3qC0VfX\n900miu1MGvLQ0XGkEVHy37QZ7t2rtbcokwx9oM/Gf2iz+lodV6m9e4wumsAae2kf\nZNeNyDZ7IhRltfIbExoOu7lUT8FN84iYNXRBFtvVlNwrLXjDkN/Jrg3kI8mPo+24\nmcrx6ToGfk2A6YBQLyVVjfGxeERwnWElQiQ+WHJDrIGpTBXbAjn8h/aiIPjlAgMB\nAAGjggEGMIIBAjAdBgNVHQ4EFgQURpZcB1lFHLcc++NXo0EBhlgaEN8wgdIGA1Ud\nIwSByjCBx4AURpZcB1lFHLcc++NXo0EBhlgaEN+hgZikgZUwgZIxCzAJBgNVBAYT\nAmNuMQ0wCwYDVQQIDAR4aWFuMQ0wCwYDVQQHDARodXlpMREwDwYDVQQKDAhqZWhh\nbnN1bjEWMBQGA1UECwwNdW5pdCBqZWhhbnN1bjEVMBMGA1UEAwwMc3Vuamlhbnhp\nb25nMSMwIQYJKoZIhvcNAQkBFhRqZWhhbnN1bkB0ZW5jZW50LmNvbYIUGx4783Ah\nEBJYh6OnIafmbwVSJRMwDAYDVR0TBAUwAwEB/zANBgkqhkiG9w0BAQsFAAOCAQEA\nYOfLKq2uSONvUGmGt/EoppiKQeksu+t5MGhSwgL5/74WoQlCF9wSKbvgyhW55iQK\n58dJdg9E18rv9OBURWY3xIdope0ZizmULSEuah6dFYsrcY95mNBHkZ0yK6HtWgRP\nOb8+l1aKJK6cC8BvlHziblAC6bOK+HdpEI+mfVCpxU5B2rhUQEVFH5ogVtE+E9OP\nqamwZlHGDSZvwukBsPkg5EiqP9Sixx102B7uAwym0gXtvrfSKj+KC/mlBkpuKHg8\nfG2aZinrh8RqbUvzpqkVyFfGH2SaJPUchNNA0hdfNKtGfJ5S/BWsSPky82xn+9kp\nfB9p/BeTDdveeb1ATq5ZWw==\n-----END CERTIFICATE-----\n",
"DeviceCertificateCn": "tx",
"DeviceCertificateSn": "eef68a582b94254296e54ce754f94d707a59913",
"Format": "PEM",
"LastActivationTime": 1765434993699,
"LastInactivationTime": 0,
"ModificationTime": 1765439638543,
"NotAfterTime": 1766155706000,
"NotBeforeTime": 1734619706000,
"OrganizationalUnit": "tx",
"Source": "mqtt-mzj7aqxk",
"Status": "ACTIVE"
}
],
"RequestId": "225d15f3-b60b-4fd7-927a-0c7923eda71f"
}
}5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| FailedOperation.InstanceNotReady | FailedOperation.InstanceNotReady |
