查询证书详情 - ShowCertificate
功能介绍
查询证书详情。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
pca:cert:get
Read
-
g:EnterpriseProjectId
-
-
URI
GET /v1/private-certificates/{certificate_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
certificate_id |
是 |
String |
需要查询的私有证书ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户token，参见:IAM token获取方法。 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
certificate_id |
String |
私有证书ID。 |
|
status |
String |
证书状态： |
|
issuer_id |
String |
父CA证书ID。 |
|
issuer_name |
String |
父CA证书名称。 |
|
key_algorithm |
String |
密钥算法。 |
|
signature_algorithm |
String |
签名算法。 |
|
freeze_flag |
Integer |
冻结标识: |
|
gen_mode |
String |
证书生成方式： |
|
serial_number |
String |
序列号。 |
|
create_time |
Long |
证书创建时间，格式为时间戳（毫秒级）。 |
|
delete_time |
Long |
证书删除时间，格式为时间戳（毫秒级）。 |
|
not_before |
Long |
证书创建时间，格式为时间戳（毫秒级）。 |
|
not_after |
Long |
证书到期时间，格式为时间戳（毫秒级）。 |
|
distinguished_name |
DistinguishedName object |
证书名称配置，详情请参见DistinguishedName字段数据结构说明。 |
|
enc_cert_info |
EncCertInfo object |
加密证书信息，详情请参见EncCertInfo字段数据结构说明。 |
|
enterprise_project_id |
String |
企业项目ID，默认为“0”。 对于开通企业项目的用户，表示资源处于默认企业项目下。 对于未开通企业项目的用户，表示资源未处于企业项目下。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
common_name |
String |
证书通用名称（CN），名称只能由"-"、"_"、" "、"."、","、"*"、字母、数字、汉字组成，长度不能超过64位字符。 |
|
country |
String |
国家编码，只能由英文组成，长度为2位字符。 |
|
state |
String |
省市名称，名称只能由"-"、"_"、" "、"."、","、字母、数字、汉字组成，长度不能超过128位字符。 |
|
locality |
String |
地区名称，名称只能由"-"、"_"、" "、"."、","、字母、数字、汉字组成，长度不能超过128位字符。 |
|
organization |
String |
组织名称，名称只能由"-"、"_"、" "、"."、","、字母、数字、汉字组成，长度不能超过64位字符。 |
|
organizational_unit |
String |
组织单元名称，名称只能由"-"、"_"、" "、"."、","、字母、数字、汉字组成，长度不能超过64位字符。 |
状态码：400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误请求返回的错误码。 |
|
error_msg |
String |
错误请求返回的错误信息。 |
状态码：401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误请求返回的错误码。 |
|
error_msg |
String |
错误请求返回的错误信息。 |
状态码：403
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误请求返回的错误码。 |
|
error_msg |
String |
错误请求返回的错误信息。 |
状态码：404
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误请求返回的错误码。 |
|
error_msg |
String |
错误请求返回的错误信息。 |
状态码：500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误请求返回的错误码。 |
|
error_msg |
String |
错误请求返回的错误信息。 |
请求示例
查询证书详情，请求头中的X-Auth-Token字段需要填写token，且该token需要具有本API的访问权限。
GET https://ccm.cn-north-4.myhuaweicloud.com/v1/private-certificates/6434f74f-2d13-4e6a-89eb-93ee313f1a43
响应示例
状态码：200
请求已成功
{
"signature_algorithm" : "SHA256",
"issuer_id" : "ef5d84d1-4f52-47d2-b1c8-a91a672487a0",
"issuer_name" : "HW CA",
"not_after" : 1665539214000,
"not_before" : 1634295475000,
"status" : "ISSUED",
"freeze_flag" : 0,
"gen_mode" : "GENERATE",
"serial_number" : "202110151057541266081861",
"distinguished_name" : {
"country" : "cn",
"state" : "guizhou",
"locality" : "guiyang",
"organization" : "hw",
"organizational_unit" : "IT",
"common_name" : "test.huawei.com"
},
"key_algorithm" : "RSA4096",
"create_time" : 1634295475000,
"delete_time" : null,
"certificate_id" : "6434f74f-2d13-4e6a-89eb-93ee313f1a43",
"enc_cert_info" : {
"enc_serial_number" : "2ad6c3e393a95bf13f95"
}
}
状态码：400
请求参数有误。
{
"error_code" : "PCA.XXX",
"error_msg" : "XXX"
}
状态码：401
被请求的页面需要鉴权。
{
"error_code" : "PCA.XXX",
"error_msg" : "XXX"
}
状态码：403
认证失败。
{
"error_code" : "PCA.XXX",
"error_msg" : "XXX"
}
状态码：404
资源不存在或资源未找到。
{
"error_code" : "PCA.XXX",
"error_msg" : "XXX"
}
状态码：500
服务内部错误。
{
"error_code" : "PCA.XXX",
"error_msg" : "XXX"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
请求已成功 |
|
400 |
请求参数有误。 |
|
401 |
被请求的页面需要鉴权。 |
|
403 |
认证失败。 |
|
404 |
资源不存在或资源未找到。 |
|
500 |
服务内部错误。 |
错误码
请参见错误码。
