CreateSubCACertificate

Updated at:

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

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

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 _ format. Valid values:

  • RSA_1024: corresponds to the Sha256WithRSA signature algorithm.

  • RSA_2048: corresponds to the Sha256WithRSA signature algorithm.

  • RSA_4096: corresponds to the Sha256WithRSA signature algorithm.

  • ECC_256: corresponds to the Sha256WithECDSA signature algorithm.

  • SM2_256: corresponds to the SM3WithSM2 signature algorithm.

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:

  • any

  • serverAuth

  • clientAuth

  • codeSigning

  • emailProtection

  • timeStamping

  • OCSPSigning

  • Other extended key usage OIDs

Valid values:

  • codeSigning :

    Code signing.

  • emailProtection :

    Email protection.

  • serverAuth :

    Server authentication.

  • timeStamping :

    Time stamping.

  • any :

    Any.

  • clientAuth :

    Client authentication.

  • OCSPSigning :

    OCSP signing.

serverAuth

EnableCrl

boolean

No

Specifies whether to enable the Certificate Revocation List (CRL) service. Valid values:

  • false: No.

  • true: Yes.

Valid values:

  • true :

    true

  • false :

    false

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.