DescribeCACertificate - Certificate Management Service - Alibaba Cloud Documentation Center

Queries the details about a root certificate authority (CA) certificate or an intermediate CA certificate.

Operation Description

You can call the DescribeCACertificate operation to query the details about a root CA certificate or an intermediate CA certificate by using the unique identifier of the root CA certificate or intermediate CA certificate. The details include the serial number, user information, and content of a CA certificate.

Before you call this operation, make sure that you have created a root CA by calling the CreateRootCACertificate operation or an intermediate CA certificate by calling the CreateSubCACertificate operation.

Limits

You can call this operation up to 10 times per second per account. If the number of the calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

Operation: the value that you can use in the Action element to specify the operation on a resource.
Access level: the access level of each operation. The levels are read, write, and list.
Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- The required resource types are displayed in bold characters.
- If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
Condition Key: the condition key that is defined by the cloud service.
Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.

Operation	Access level	Resource type	Condition key	Association operation
yundun-cert:DescribeCACertificate	Read	SSLCertificatesService acs:yundun-cert::{#accountId}:	none	none

Request parameters

Parameter	Type	Required	Description	Example
Identifier	string	No	The unique identifier of the CA certificate that you want to query. NoteYou can call the DescribeCACertificateList operation to query the unique identifiers of all CA certificates.	160ae6bb538d538c70c01f81dcf2****

All Alibaba Cloud API operations must include common request parameters.

For more information about sample requests, see the "Examples" section of this topic.

Response parameters

Parameter	Type	Description	Example
	object	DescribeCACertificateResponse.
Certificate	object	The details about the CA certificate.
CertificateType	string	The type of the CA certificate. Valid values: ROOT: root CA certificate SUB_ROOT: intermediate CA certificate	SUB_ROOT
X509Certificate	string	The content of the CA certificate.	-----BEGIN CERTIFICATE----- …… -----END CERTIFICATE-----
Identifier	string	The unique identifier of the CA certificate.	160ae6bb538d538c70c01f81dcf2****
SerialNumber	string	The serial number of the CA certificate.	70e3b2566d92805173767869727fb92e****
SubjectDN	string	The user attribute of the CA certificate, which contains the following information: C: the country code in which the organization is located O: the name of the organization OU: the name of the department or branch in the organization L: the name of the city in which the organization is located ST: the name of the province, municipality, or autonomous region in which the organization is located CN: the common name or abbreviation of the organization	C=CN,O=Alibaba Cloud Computing Co., Ltd.,OU=Security,L=Hangzhou,ST=Zhejiang,CN=Aliyun
CommonName	string	The common name or abbreviation of the organization that is associated with the CA certificate.	Aliyun
OrganizationUnit	string	The name of the department or branch in the organization that is associated with the CA certificate.	Security
Organization	string	The name of the organization that is associated with the CA certificate.	Alibaba Cloud Computing Co., Ltd.
Locality	string	The name of the city in which the organization is located.	Hangzhou
State	string	The name of the province, municipality, or autonomous region in which the organization is located.	Zhejiang
CountryCode	string	The code of the country in which the organization is located. For more information about country codes, see the "Country codes" section of the Manage company profiles topic.	CN
Sans	string	This parameter is deprecated.	1
Status	string	The status of the CA certificate. Valid values: ISSUE: The CA certificate is issued. REVOKE: The CA certificate is revoked.	ISSUE
Algorithm	string	The encryption algorithm of the CA certificate. Valid values: RSA: the Rivest-Shamir-Adleman (RSA) algorithm. ECC: the elliptic curve cryptography (ECC) algorithm. SM2: the SM2 algorithm, which is developed and approved by the State Cryptography Administration of China.	RSA
KeySize	integer	The key length of the CA certificate.	2048
SignAlgorithm	string	The signature algorithm of the CA certificate.	SHA256WITHRSA
BeforeDate	long	The issuance date of the CA certificate. This value is a UNIX timestamp. Unit: milliseconds.	1634283958000
AfterDate	long	The expiration date of the CA certificate. This value is a UNIX timestamp. Unit: milliseconds.	1665819958000
ParentIdentifier	string	The unique identifier of the root CA certificate from which the CA certificate is issued. NoteThis parameter is returned only if the value of the CertificateType parameter is SUB_ROOT. The value SUB_ROOT indicates an intermediate CA certificate.	1a83bcbb89e562885e40aa0108f5****
Sha2	string	The SHA-256 fingerprint of the CA certificate.	14dcc8afc7578e1fcec36d658f7e20de18f6957bbac42b373a66bc9de4e9****
Md5	string	The MD5 fingerprint of the CA certificate.	160ae6bb538d538c70c01f81dcf2****
CrlStatus	string	The status of the certificate revocation list (CRL) feature.	ACTIVE
CrlUrl	string	The address of the CRL.	https://crl-cn-publish.oss-cn-hangzhou.aliyuncs.com/pca/crl/1925647866611395/1ed40789-483f-6023-b6b8-29ddd3bb0a9a.crl
RequestId	string	The ID of the request.	15C66C7B-671A-4297-9187-2C4477247A74
Years	integer	The validity period of the CA certificate. Unit: years.	10

Examples

Sample success responses

JSONformat

{
  "Certificate": {
    "CertificateType": "SUB_ROOT",
    "X509Certificate": "-----BEGIN CERTIFICATE----- …… -----END CERTIFICATE-----",
    "Identifier": "160ae6bb538d538c70c01f81dcf2****",
    "SerialNumber": "70e3b2566d92805173767869727fb92e****",
    "SubjectDN": "C=CN,O=Alibaba Cloud Computing Co., Ltd.,OU=Security,L=Hangzhou,ST=Zhejiang,CN=Aliyun\n",
    "CommonName": "Aliyun",
    "OrganizationUnit": "Security",
    "Organization": "Alibaba Cloud Computing Co., Ltd.\n",
    "Locality": "Hangzhou",
    "State": "Zhejiang",
    "CountryCode": "CN",
    "Sans": "1",
    "Status": "ISSUE",
    "Algorithm": "RSA",
    "KeySize": 2048,
    "SignAlgorithm": "SHA256WITHRSA",
    "BeforeDate": 1634283958000,
    "AfterDate": 1665819958000,
    "ParentIdentifier": "1a83bcbb89e562885e40aa0108f5****",
    "Sha2": "14dcc8afc7578e1fcec36d658f7e20de18f6957bbac42b373a66bc9de4e9****",
    "Md5": "160ae6bb538d538c70c01f81dcf2****",
    "CrlStatus": "ACTIVE",
    "CrlUrl": "https://crl-cn-publish.oss-cn-hangzhou.aliyuncs.com/pca/crl/1925647866611395/1ed40789-483f-6023-b6b8-29ddd3bb0a9a.crl"
  },
  "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74",
  "Years": 10
}

Error codes

For a list of error codes, visit the Service error codes.