CreateSubCACertificate
Creates a subordinate CA certificate.
Operation description
This operation issues a subordinate CA certificate by using an existing root CA certificate. Subordinate CA certificates can be used to issue client and server certificates.
Before calling this operation, you must call CreateRootCACertificate to create a root CA certificate.
QPS limits
The rate limit for a single user is 10 queries per second (QPS). If the limit is exceeded, API calls are throttled, which may affect your services. Make API calls at a reasonable frequency.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
yundun-cert:CreateSubCACertificate |
create |
*All Resource
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| ParentIdentifier |
string |
No |
The unique identifier of the root CA certificate. Note
You can call DescribeCACertificateList to query the unique identifiers of all CA certificates. |
1a83bcbb89e562885e40aa0108f5**** |
| CommonName |
string |
Yes |
The common name or abbreviation of the organization. Chinese and English characters are supported. |
Aliyun |
| OrganizationUnit |
string |
Yes |
The name of the department or branch under the organization. Chinese and English characters are supported. |
Security |
| Organization |
string |
Yes |
The name of the organization (corresponding to your enterprise or institution) associated with the subordinate CA certificate. Chinese and English characters are supported. |
Alibaba |
| Locality |
string |
Yes |
The name of the city where the organization is located. Chinese and English characters are supported. |
Hangzhou |
| State |
string |
Yes |
The name of the province, municipality, or autonomous region where the organization is located. Chinese and English characters are supported. |
Zhejiang |
| CountryCode |
string |
No |
The code of the country or region where the organization is located, represented by a two-letter or three-letter uppercase English abbreviation. For example, CN indicates China, and US indicates the United States. For more information about country codes, see the International codes section in Manage company information. |
CN |
| Algorithm |
string |
Yes |
The key algorithm type of the subordinate CA certificate. The key algorithm is represented in the
The encryption algorithm of the subordinate CA certificate must be the same as that of the root CA certificate, but the key length can be different. For example, if the key algorithm of the root CA certificate is RSA_2048, the key algorithm of the subordinate CA certificate must be RSA_1024, RSA_2048, or RSA_4096. Note
You can call DescribeCACertificate to query the key algorithm of the root CA certificate. |
RSA_2048 |
| Years |
integer |
Yes |
The validity period of the subordinate CA certificate. Unit: years. Set this parameter to a value from 5 to 10. Note
The validity period of the subordinate CA certificate cannot exceed the validity period of the root CA certificate. You can call DescribeCACertificate to query the validity period of the root CA certificate. |
5 |
| PathLenConstraint |
integer |
No |
The path length constraint of the certificate. Default value: 0. |
0 |
| ExtendedKeyUsages |
array |
No |
The extended key usages. |
|
|
string |
No |
The extended key usage. Valid values:
Valid values:
|
serverAuth |
|
| EnableCrl |
boolean |
No |
Specifies whether to enable the Certificate Revocation List (CRL) service. Valid values:
Valid values:
|
true |
| CrlDay |
integer |
No |
The validity period of the CRL. Valid values: 1 to 365. Unit: days. |
30 |
| Tags |
array<object> |
No |
The list of tags. |
|
|
object |
No |
The list of tags. |
||
| Key |
string |
No |
The tag key. |
testKey |
| Value |
string |
No |
The tag value. |
test |
| ResourceGroupId |
string |
No |
The ID of the resource group. |
rg-ae****vty |
| ClientToken |
string |
No |
The client token that is used to ensure the idempotence of the request. You can use the client to generate the value, but you must ensure that it is unique among different requests. The token can contain a maximum of 64 ASCII characters and cannot contain non-ASCII characters. |
create-sub-ca-20261110-6e2b9f4a |
| CertMaxTime |
integer |
No |
The maximum validity period of the issued certificate, which is specified by the certMaxTime parameter of the CA. Unit: days. |
30 |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The object. |
||
| RequestId |
string |
The ID of the request, which is a unique identifier generated by Alibaba Cloud for the request. You can use the ID to troubleshoot and locate issues. |
15C66C7B-671A-4297-9187-2C4477247A74 |
| Identifier |
string |
The unique identifier of the subordinate CA certificate created by the request. |
160ae6bb538d538c70c01f81dcf2**** |
| Certificate |
string |
The PEM-formatted certificate created by the call. |
-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE----- |
| CertificateChain |
string |
The CA certificate chain of the certificate created by the call. |
-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----\n |
serverAuth: Server authentication.
clientAuth: Client authentication.
codeSigning: Code signing.
emailProtection: Email protection.
timeStamping: Time stamping.
OCSPSigning: OCSP signing.
Other extended key usage OIDs.
Examples
Success response
JSON format
{
"RequestId": "15C66C7B-671A-4297-9187-2C4477247A74",
"Identifier": "160ae6bb538d538c70c01f81dcf2****",
"Certificate": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----",
"CertificateChain": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----\\n-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----\\n"
}
Error codes
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.