All Products
Search
Document Center

Certificate Management Service:ListUserCertificateOrder

Last Updated:Jun 25, 2024

Queries the certificates or certificate orders of users.

Operation description

You can call the ListUserCertificateOrder operation to query the certificates or certificate orders of users. If you set OrderType to CERT or UPLOAD, certificates are returned. If you set OrderType to CPACK or BUY, certificate orders are returned.

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.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

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.
OperationAccess levelResource typeCondition keyAssociated operation
yundun-cert:ListUserCertificateOrderRead
  • All Resources
    *
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
KeywordstringNo

The domain names that are bound or the ID of the order. Fuzzy match is supported.

cert-instanceId
StatusstringNo

The certificate status of the order. Valid values:

  • PAYED: pending application. You can set Status to PAYED only if you set OrderType to CPACK or BUY.
  • CHECKING: reviewing. You can set Status to CHECKING only if you set OrderType to CPACK or BUY.
  • CHECKED_FAIL: review failed. You can set Status to CHECKED_FAIL only if you set OrderType to CPACK or BUY.
  • ISSUED: issued.
  • WILLEXPIRED: about to expire.
  • EXPIRED: expired.
  • NOTACTIVATED: not activated. You can set Status to NOTACTIVATED only if you set OrderType to CPACK or BUY.
  • REVOKED: revoked. You can set Status to REVOKED only if you set OrderType to CPACK or BUY.
ISSUED
OrderTypestringNo

The type of the order. Valid values:

  • CPACK: virtual resource order. If you set OrderType to CPACK, only the information about orders that are generated to consume the certificate quota is returned.
  • BUY: purchase order. If you set OrderType to BUY, only the information about purchase orders is returned. In most cases, this type of order can be ignored.
  • UPLOAD: uploaded certificate. If you set OrderType to UPLOAD, only uploaded certificates are returned.
  • CERT: certificate. If you set OrderType to CERT, both issued certificates and uploaded certificates are returned.
CPACK
CurrentPagelongNo

The number of the page to return.

1
ShowSizelongNo

The number of entries to return on each page. Default value: 50.

10
ResourceGroupIdstringNo

The ID of the resource group.

rg-ae******4wia

Response parameters

ParameterTypeDescriptionExample
object

The data returned.

ShowSizelong

The number of entries returned per page.

10
CurrentPagelong

The page number of the returned page.

1
TotalCountlong

The total number of entries returned.

1
CertificateOrderListobject []

An array that consists of the information about the certificates and orders.

Algorithmstring

The algorithm. This parameter is returned only if OrderType is set to CPACK or BUY.

RSA
AliyunOrderIdlong

The ID of the Alibaba Cloud order. This parameter is returned only if OrderType is set to CPACK or BUY.

234567
BuyDatelong

The time at which the order was placed. Unit: milliseconds. This parameter is returned only if OrderType is set to CPACK or BUY.

1634283958000
CertEndTimelong

The time at which the certificate expires. Unit: milliseconds. This parameter is returned only if OrderType is set to CPACK or BUY.

1665819958000
CertStartTimelong

The time at which the certificate starts to take effect. Unit: milliseconds. This parameter is returned only if OrderType is set to CPACK or BUY.

1665819958000
CertTypestring

The type of the certificate. This parameter is returned only if OrderType is set to CPACK or BUY. Valid values:

  • DV: domain validated (DV) certificate
  • EV: extended validation (EV) certificate
  • OV: organization validated (OV) certificate
  • FREE: free certificate
FREE
Domainstring

The domain name. This parameter is returned only if OrderType is set to CPACK or BUY.

aliyundoc.com
DomainCountlong

The total number of domain names that can be bound to the certificate. This parameter is returned only if OrderType is set to CPACK or BUY.

1
DomainTypestring

The type of the domain name. This parameter is returned only if OrderType is set to CPACK or BUY. Valid values:

  • ONE: single domain name
  • MULTIPLE: multiple domain names
  • WILDCARD: single wildcard domain name
  • M_WILDCARD: multiple wildcard domain names
  • MIX: hybrid domain name
ONE
InstanceIdstring

The ID of the resource.

cas-instanceId
OrderIdlong

The order ID. This parameter is returned only if OrderType is set to CPACK or BUY.

2345687
PartnerOrderIdstring

The ID of the certificate authority (CA) order. This parameter is returned only if OrderType is set to CPACK or BUY.

ca-123456
ProductCodestring

The specification ID of the order. This parameter is returned only if OrderType is set to CPACK or BUY.

bykj123456
ProductNamestring

The specification name of the order. This parameter is returned only if OrderType is set to CPACK or BUY.

CFCA
RootBrandstring

The brand of the certificate. Valid values: WoSign, CFCA, DigiCert, and vTrus. This parameter is returned only if OrderType is set to CPACK or BUY.

CFCA
SourceTypestring

The type of the order. This parameter is returned only if OrderType is set to CPACK or BUY.

  • cpack: virtual resource order
  • buy: purchase order
buy
Statusstring

The certificate status of the order. This parameter is returned only if OrderType is set to CPACK or BUY.

  • PAYED: pending application
  • CHECKING: reviewing
  • CHECKED_FAIL: review failed
  • ISSUED: issued
  • WILLEXPIRED: about to expire
  • EXPIRED: expired
  • NOTACTIVATED: not activated
  • REVOKED: revoked
PAYED
TrusteeStatusstring

The hosting status of the certificate. This parameter is returned only if OrderType is set to CPACK or BUY.

  • unTrustee: not hosted
  • trustee: hosted
unTrustee
WildDomainCountlong

The number of wildcard domain names that can be bound to the certificate. This parameter is returned only if OrderType is set to CPACK or BUY.

0
CertificateIdlong

The ID of the certificate. This parameter is returned only if OrderType is set to CERT or UPLOAD.

896521
Namestring

The name of the certificate. This parameter is returned only if OrderType is set to CERT or UPLOAD.

cert-name
CommonNamestring

The parent domain name of the certificate. This parameter is returned only if OrderType is set to CERT or UPLOAD.

aliyun.com
Fingerprintstring

The fingerprint of the certificate. This parameter is returned only if OrderType is set to CERT or UPLOAD.

CC6B3696E7C7CA715BD26E28E45FF3E3DF435C03
Sha2string

The SHA-2 value of the certificate. This parameter is returned only if OrderType is set to CERT or UPLOAD.

56B4DED2243A81DD909D7C39824FFE4DDBD87F91BFA46CD333FF212FE0E7CB11
SerialNostring

The serial number of the certificate. This parameter is returned only if OrderType is set to CERT or UPLOAD.

040a6e493cffdda6d744acf99b6576cf
Issuerstring

The issuer of the certificate. This parameter is returned only if OrderType is set to CERT or UPLOAD.

MyIssuer
OrgNamestring

The name of the organization that is associated with the certificate. This parameter is returned only if OrderType is set to CERT or UPLOAD.

Alibaba Cloud
Provincestring

The name of the province or autonomous region in which the organization is located. This parameter is returned only if OrderType is set to CERT or UPLOAD.

Zhejiang
Citystring

The city in which the organization is located. This parameter is returned only if OrderType is set to CERT or UPLOAD.

Hangzhou
Countrystring

The code of the country in which the organization is located. This parameter is returned only if OrderType is set to CERT or UPLOAD.

CN
Sansstring

All domain names that are bound to the certificate. Multiple domain names are separated by commas (,). This parameter is returned only if OrderType is set to CERT or UPLOAD.

aliyun.com
Expiredboolean

Indicates whether the certificate expires. This parameter is returned only if OrderType is set to CERT or UPLOAD.

true
Uploadboolean

Indicates whether the certificate is an uploaded certificate. This parameter is returned only if OrderType is set to CERT or UPLOAD.

false
StartDatestring

The time at which the certificate starts to take effect. This parameter is returned only if OrderType is set to CERT or UPLOAD.

2021-11-16
EndDatestring

The time at which the certificate expires. This parameter is returned only if OrderType is set to CERT or UPLOAD.

2022-11-17
ResourceGroupIdstring

The ID of the resource group. This parameter is returned only if OrderType is set to CERT or UPLOAD.

rg-ae******4wia
RequestIdstring

The ID of the request, which is used to locate and troubleshoot issues.

15C66C7B-671A-4297-9187-2C4477247A74

Examples

Sample success responses

JSONformat

{
  "ShowSize": 10,
  "CurrentPage": 1,
  "TotalCount": 1,
  "CertificateOrderList": [
    {
      "Algorithm": "RSA",
      "AliyunOrderId": 234567,
      "BuyDate": 1634283958000,
      "CertEndTime": 1665819958000,
      "CertStartTime": 1665819958000,
      "CertType": "FREE",
      "Domain": "aliyundoc.com",
      "DomainCount": 1,
      "DomainType": "ONE",
      "InstanceId": "cas-instanceId",
      "OrderId": 2345687,
      "PartnerOrderId": "ca-123456",
      "ProductCode": "bykj123456",
      "ProductName": "CFCA",
      "RootBrand": "CFCA",
      "SourceType": "buy",
      "Status": "PAYED",
      "TrusteeStatus": "unTrustee",
      "WildDomainCount": 0,
      "CertificateId": 896521,
      "Name": "cert-name",
      "CommonName": "aliyun.com",
      "Fingerprint": "CC6B3696E7C7CA715BD26E28E45FF3E3DF435C03",
      "Sha2": "56B4DED2243A81DD909D7C39824FFE4DDBD87F91BFA46CD333FF212FE0E7CB11",
      "SerialNo": "040a6e493cffdda6d744acf99b6576cf",
      "Issuer": "MyIssuer",
      "OrgName": "Alibaba Cloud\n",
      "Province": "Zhejiang\n",
      "City": "Hangzhou\n",
      "Country": "CN",
      "Sans": "aliyun.com",
      "Expired": true,
      "Upload": false,
      "StartDate": "2021-11-16",
      "EndDate": "2022-11-17",
      "ResourceGroupId": "rg-ae******4wia"
    }
  ],
  "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74"
}

Error codes

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

Change history

Change timeSummary of changesOperation
No change history