查询私有证书详情--证书中心-火山引擎

文档中心

立即注册

导航

查询私有证书详情

最近更新时间：2024.06.24 20:30:02首次发布时间：2023.08.11 19:16:08

调用本接口查询指定私有证书的详情。

请求说明

接口名称：GetLeafInstance
请求方式：GET
请求地址：open.volcengineapi.com

调试

暂不支持。

请求参数

下方表格中的参数包含在请求头（header）中。

参数	类型	是否必选	描述	示例值
Region	string	是	服务地区。该参数的取值是`cn-north-1`。	`cn-north-1`
ServiceName	string	是	服务名称。该参数的取值是`pca`。	`pca`

Query

下方表格中的参数包含在查询字符串（query string）中。

参数	类型	是否必选	描述	示例值
Action	String	是	API的名称。该参数的取值是 `GetLeafInstance`。	`GetLeafInstance`
Version	String	是	API的版本。该参数的取值是 `2023-05-01`。	`2023-05-01`
instance_id	String	是	要查询的私有证书实例的ID。您可以调用 ListLeafInstances 接口获取所有私有证书实例的ID。	`pca_leaf_M6gaihuZRcO****`

返回参数

参数	类型	描述	示例值
Result	Object	私有证书的详情。

请求示例

GET https://open.volcengineapi.com/?Action=GetLeafInstance&Version=2023-05-01&instance_id=pca_leaf_M6gaihuZRcO****&<其他公共请求参数>

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230314200921F7BEBB2D6FFCA5123A1C",
        "Action": "GetLeafInstance",
        "Version": "2023-05-01",
        "Service": "pca",
        "Region": "cn-north-1"
    },
    "Result": {
        "instance_id": "pca_leaf_M6gaihuZRcO****",
        "sub_ca_id": "pca_sub_MlRaK****",
        "root_ca_id": "pca_root_aXPEF****",
        "encryption_algorithm": "RSA 2048",
        "signature_algorithm": "SHA256-RSA",
        "serial_number": "39E8CBC731E467DBA6DA3B3F36D51FF3A2D34FB",
        "tag": "doc-test-PrivateCert",
        "subject": {
            "country": [
                "CN"
            ],
            "organization": [
                "研发部"
            ],
            "organizational_unit": [
                "测试组"
            ],
            "locality": [
                "海淀"
            ],
            "province": [
                "北京"
            ],
            "common_name": "www.example.com"
        },
        "contact": {
            "name": "",
            "email": "",
            "phone_number": ""
        },
        "common_name": "www.example.com",
        "certificate": {
            "csr": "",
            "encrypt_key": "",
            "encrypt_chain": null,
            "key": "",
            "chain": [
                "-----BEGIN CERTIFICATE-----\nMIIDmjCCAoKgAwIBAgIUA56MvHMeRn26baOz821R/zotNPswDQYJKoZIhvcNAQEL\nBQAwejELMAkGA1UEBhMCQ04xDzANBgNVBAgMBuWMl+S6rDEPMA0GA1UEBwwG5rW3\n5reAMRUwEwYDVQQKDAzor4HkuabkuK3lv4MxEjAQBgNVBAsMCeeglOWPkemDqDEe\nMBwGA1UEAwwVQ2VydGlmaWNhdGUgQ2VudGVyIENBMB4XDTIzMDMxNDExNTEyNFoX\nDTIzMDMyNDE1NTk1OVowcTELMAkGA1UEBhMCQ04xDzANBgNVBAgMBuWMl+S6rDEP\nMA0GA1UEBwwG5rW35reAMRIwEAYDVQQKDAnnoJTlj5Hpg6gxEjAQBgNVBAsMCea1\ni+ivlee7hDEYMBYGA1UEAwwPd3d3LmV4YW1wbGUuY29tMIIBIjANBgkqhkiG9w0B\nAQEFAAOCAQ8AMIIBCgKCAQEA2zHctzXcS8fWW+5Qs2kejlCMKVVxtuXPmZ4JrJt2\nWk7R5Q8sfemM9/Hlc7zPYxos28CAROBWB36/dA4UuCTc/EyTqM/xRzue8No1/sPj\nmdzMbSTk6Vf/ocvgiZiaP/lza7yvHf4BrZsSW/hFIM0xnLGibXwDHaNghZYbviqD\n/UH9wkUad0jGQxrKoA5AcslOFzIOHgvAwI5P/v3mupCwqlpCNLuPIKaAZkAuDViw\nHCq0Fj8ZeweBKjtaOyIZZRd2giEGuxHRkxKADqQ9hVMdAj/paMD3QYR45JjJFiZc\nHMqMEjVgLX41dGJvkXVCR0JNhFMfvtEZlYrPtNrw3baCXQIDAQABoyEwHzAMBgNV\nHQ8EBQMDB/+AMA8GA1UdJQQIMAYGBFUdJQAwDQYJKoZIhvcNAQELBQADggEBAG+b\nO6/sy8sc4IjIF0j3ee8MxXt+Oxdu0U7mSjechvpHJ9S/hOJFG7Rjj5doSFVnkhby\n48sucJofrZICezmno2I3vnDFlcg6LN5nfjcUW7MUxxk90UlovnYTHIvrCiQi1i+3\nzuu1IRzdYO9ntPjIxdMHJBtV7T8Hi7aDfzBEv91+s1MoyJ+znbS820I7qDdJ99j1\nffFzccLKUW1Ht287QVvkapdTumRnmVveVIAhZX51gqdjeb0U/G04PbtWRKgbg7u9\nuJGSDxTKoIl5hRTP33MlC/G3b7v6nPJZ4Eix0wP1GeyFtWxskxiTWpFAvkO4rgO7\ngGLgTBGNo80kfosRSI4=\n-----END CERTIFICATE-----\n",
                "-----BEGIN CERTIFICATE-----\nMIIDszCCApugAwIBAgIUVOJ82RHcResPAmsbmlq+D54LdHQwDQYJKoZIhvcNAQEN\nBQAweTELMAkGA1UEBhMCQ04xDzANBgNVBAgMBuWMl+S6rDEPMA0GA1UEBwwG5rW3\n5reAMRMwEQYDVQQKDApWb2xjZW5naW5lMRswGQYDVQQLDBJDZXJ0aWZpY2F0ZSBD\nZW50ZXIxFjAUBgNVBAMMDVZvbGNlbmdpbmUgQ0EwHhcNMjMwMzE0MTA1MTI0WhcN\nMjMwNDAzMTU1OTU5WjB6MQswCQYDVQQGEwJDTjEPMA0GA1UECAwG5YyX5LqsMQ8w\nDQYDVQQHDAbmtbfmt4AxFTATBgNVBAoMDOivgeS5puS4reW/gzESMBAGA1UECwwJ\n56CU5Y+R6YOoMR4wHAYDVQQDDBVDZXJ0aWZpY2F0ZSBDZW50ZXIgQ0EwggEiMA0G\nCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC3r7v2Itw0miqsRM5aImNNsMzUu9g5\nQ4UcBkUnL3ADhGyjJX8m/lJNoJiCtZ7mHubzQgtJ1P/7RrmAbhaU+7jK+3GDdGYa\nWTvTw87H0d6/Epl9SoZ45xq+xs8riBn5HESJmt//lBZ/O9EPUW/+jX9RxuMcDG6x\nfbRqebDMXl/6ulCQVGHHk9HZQ1YgrWTQ3jeEPSkGf/ztNjT1fuXciRbvSZC0LFwc\nvg8Bqf6osWyZ0jvhTUg5qPpmz8aIQbhwwRyyUZd2Tz6ApiBID5Qo5o0lGIyirqW3\nuDKalOi5pMw/YVAXje4qlHsBHDAw0guybzNzMA1YHasDaPmTP2NWdqCFAgMBAAGj\nMjAwMA8GA1UdEwQIMAYBAf8CAf8wDAYDVR0PBAUDAwf/gDAPBgNVHSUECDAGBgRV\nHSUAMA0GCSqGSIb3DQEBDQUAA4IBAQAJbFNSIjGhXxpibk1/kI4RmSfOCwBjoxjL\n3vKyWsCE63XgKXiyfZ5lPxI2+NgZ7EA/hRwF6JHOWfoW3nCeN/PjsF5yOhVmMYRo\ncSq6eMoJgh/vn6HYOIpeVC4ibUxU9tvpTiwQZdcJtn2NCKGSbMBj+p8tAt8vA8N5\n1jNkRbJQRUPrfaH8BtCz+wmC92JhVSoIzDIDfx5H3FIjbV8u0kNpsrIBQ1bM1oy/\nj2AXT2IvalPZ1LMh9LKsLNI9M1f7RfOahdq7/LfJ4J9qkg/VvIGAmaBUPfEIO+OR\nsTIg5k0iNM3+v4lvq29EBgGOQ/DlmWGn+irCHotvIZjH2o8cXWlZ\n-----END CERTIFICATE-----\n",
                "-----BEGIN CERTIFICATE-----\nMIIDrzCCApegAwIBAgIUMx1M0BTkgTq4MC5H3Z60Nt4ue94wDQYJKoZIhvcNAQEN\nBQAweTELMAkGA1UEBhMCQ04xDzANBgNVBAgMBuWMl+S6rDEPMA0GA1UEBwwG5rW3\n5reAMRMwEQYDVQQKDApWb2xjZW5naW5lMRswGQYDVQQLDBJDZXJ0aWZpY2F0ZSBD\nZW50ZXIxFjAUBgNVBAMMDVZvbGNlbmdpbmUgQ0EwHhcNMjMwMzE0MDcxNjQ2WhcN\nMjMwNDEzMTU1OTU5WjB5MQswCQYDVQQGEwJDTjEPMA0GA1UECAwG5YyX5LqsMQ8w\nDQYDVQQHDAbmtbfmt4AxEzARBgNVBAoMClZvbGNlbmdpbmUxGzAZBgNVBAsMEkNl\ncnRpZmljYXRlIENlbnRlcjEWMBQGA1UEAwwNVm9sY2VuZ2luZSBDQTCCASIwDQYJ\nKoZIhvcNAQEBBQADggEPADCCAQoCggEBANSStoBdQ/YwsLoPJntT2xvVna8QVSlP\nUpaz7YPP2mZw2U32eTAdk3CDXXn5wnLNj0Hw+8i8CgiTyBg7WpzMHf4rruYgSvZ6\nsFa8JXyOuJC/11x7uWqEICUwBQIs2SMpSgfN7n4T2Za5U6FWA5OE0+7zfaEK0h5A\nELHUIUWXffgaY1VhTO/973IdXekpMYPyHhhgQBnenrSvL+Ek2SDi5vufkeKZRis+\nlC4jcKArVoVnBKCvmUNR/I4xRnY8KbY3jz1topuLw5feCfYkXh+dJilrH6vG1FJL\nBbATN9E8KtuxGI8e5nX8kVHS5toptVbgajpLg+sBKb2vygx4CphzJdECAwEAAaMv\nMC0wDAYDVR0TBAUwAwEB/zAMBgNVHQ8EBQMDB/+AMA8GA1UdJQQIMAYGBFUdJQAw\nDQYJKoZIhvcNAQENBQADggEBABcddS1v0PpRcW0vSKuEiomOrdz54VxmsgXIXweE\nhHLh0scTGtqIhA3Z3fVJujE/GwWIANl6VErHE1W0TmycM19UQ766ErIz2f8RCKMh\nvSsjXjoKkujk1xoR+N5w3gxFB+Epa38vGRXU2aTBDFql0yHdCzccKRME9n36x5hV\nUONnsMFIlguQDyyn+pVg8dmEIDIrNRACKZtlsVEMZ6Xeg0Yj1sHvMZM2b0jO1m35\netpnoDIuzDWriI+ZEA4aoL73FVukoZrOfc7XucJRGkv3zKu4aERAKdkwvPKZlKw2\nc+QpjLJ6r5xjeMDPlTAKWvmxn19hmX0MMsKlWgDkKdlYl+o=\n-----END CERTIFICATE-----\n"
            ]
        },
        "create_at": 1678794684,
        "not_after": 1679673599,
        "not_before": 1678794684,
        "instance_status": 1,
        "duration": "10天"
    }
}

错误码

如果响应正文的ResponseMetadata字段中包含Error字段，则表示API请求失败。您可访问公共错误码，获取更多错误码信息。

证书中心