All Products
Search
Document Center

Certificate Management Service:GetCaInstanceCrlAddress

Last Updated:Aug 24, 2026

Retrieves the certificate revocation list (CRL) URL of a certificate authority (CA).

Operation description

Queries the status information of a private CA instance that you purchased through the SSL Certificate Service console by using the ID of the private CA instance. For example, you can query the status of the CA instance, the number of certificates included, and the number of certificates issued.

Before you invoke this operation, you must have purchased a private CA through the Digital Certificate Management Service console. For more information, see Purchase a private CA.

QPS limit

The single-user QPS limit for this operation is 10 calls per second. If the limit is exceeded, the API call is throttled, which may affect your business. Invoke this operation as needed.

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:GetCaInstanceCrlAddress

get

*All Resource

*

None None

Request parameters

Parameter

Type

Required

Description

Example

Uuid

string

No

The zone ID of the China Application Security (CAS) instance.

1f047318-0815-XXX-f7ceb76b5c0a

CaIdentifier

string

No

The CA certificate identifier.

1f0167b4-ee84-XXX-49bc4d39fa68

Response elements

Element

Type

Description

Example

object

Schema of Response

RequestId

string

Id of the request

C53C2341-F321-55A5-895C-D0746E6DA58E

CrlUrl

string

The CRL URL.

https://crl-cn-publish.oss-cn-hangzhou.aliyuncs.com/pca/crl/35118048/1f0be094-14bd-6caa-bd7f-db45730d510a.crl

CaInstanceStatus

string

The status of the CA instance.

normal

HashCode

string

The hash code used to identify whether new revoked certificates exist in the CRL.

5481d1b1228fXXX40ee70dc8cd

NextUpdateTime

string

The next update time of the CRL. The value is a UNIX timestamp in milliseconds.

1778688000000

CaType

string

The CA type.

uploadCA

Examples

Success response

JSON format

{
  "RequestId": "C53C2341-F321-55A5-895C-D0746E6DA58E",
  "CrlUrl": "https://crl-cn-publish.oss-cn-hangzhou.aliyuncs.com/pca/crl/35118048/1f0be094-14bd-6caa-bd7f-db45730d510a.crl",
  "CaInstanceStatus": "normal",
  "HashCode": "5481d1b1228fXXX40ee70dc8cd",
  "NextUpdateTime": "1778688000000",
  "CaType": "uploadCA"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.