ListCertificates - - Centre de documentation Alibaba Cloud

Obtient la liste des certificats.

Description de l'opération

Consulte les journaux d'opérations des certificats d'autorité de certification, y compris les certificats d'autorité de certification racine et subordonnée. Par exemple, vous pouvez consulter les journaux de création et les journaux de changement d'état des certificats d'autorité de certification.

La limite de requêtes par seconde (QPS) par utilisateur pour cette opération est de 10. Si cette limite est dépassée, les appels d'API sont limités, ce qui peut affecter votre activité. Appelez cette opération à une fréquence appropriée.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

yundun-cert:ListCertificates

list

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Keyword	string	Non	Le mot-clé utilisé pour la correspondance approximative. Ce mot-clé est comparé aux noms de domaine, aux noms et aux identifiants des ressources correspondantes.	test
InstanceId	string	Non	L'identifiant de l'instance.	cas-ivauto-hqito6
CertificateStatus	string	Non	L'état du certificat. Valeurs valides : issued : Émis. revoked : Révoqué. willExpire : Sur le point d'expirer. expired : Expiré.	issued
CertificateSource	string	Non	La source du certificat. Valeurs valides : BUY : un certificat payant. TEST : un certificat de test. UPLOAD : un certificat téléversé.	BUY
ResourceGroupId	string	Non	L'identifiant du groupe de ressources.	rg-aek****wia
ShowSize	integer	Non	Le nombre d'entrées par page. Valeur par défaut : 10. Valeur maximale : 100.	10
CurrentPage	integer	Non	Le numéro de la page actuelle.	1

Éléments de réponse

Élément	Type	Description	Exemple
	object
CertificateList	array<object>	La liste des certificats.
	object	Les informations du certificat.
Algorithm	string	Le type d'algorithme de chiffrement du certificat. Valeurs valides : RSA : algorithme RSA. ECC : algorithme ECC. SM2 : algorithme SM2 (cryptographie nationale chinoise).	RSA
CertIdentifier	string	L'identifiant global du certificat, au format identifiant du certificat + "-" + identifiant de la région du site. Cet identifiant est couramment utilisé dans les services Alibaba Cloud. Pour le site chinois, la valeur est l'identifiant du certificat + "-cn-hangzhou". Pour le site international, la valeur est l'identifiant du certificat + "-ap-southeast-1". Par exemple, si l'identifiant du certificat est 123, le CertIdentifier sur le site chinois est "123-cn-hangzhou", et le CertIdentifier sur le site international est "123-ap-southeast-1".	21589515-cn-hangzhou
CertificateId	string	L'identifiant du certificat.	17281539
CertificateName	string	Le nom du certificat.	test
CertificateSource	string	La source du certificat. Valeurs valides : BUY : un certificat payant. TEST : un certificat de test. UPLOAD : un certificat téléversé.	BUY
CertificateStatus	string	L'état du certificat. Valeurs valides : issued : Émis. revoked : Révoqué. willExpire : Sur le point d'expirer. expired : Expiré.	issued
CommonName	string	Le nom commun du certificat.	aliyun.com
DeploymentDesc	string	Les informations de déploiement au format JSON : --Scope : les valeurs valides sont all/server. Si le certificat possède une clé privée, la valeur est all. Si le certificat ne possède pas de clé privée, la valeur est server. --ServerName : le nom du serveur associé à l'instance de certificat. --ResourceInstanceId : l'identifiant de ressource du serveur associé à l'instance de certificat.	{ "Scope": "all", "ServerName": "acmeServerName", "ResourceInstanceId": "cas_dv-cn-XXX" }
Domain	string	Les noms de domaine associés au certificat. Les noms de domaine multiples sont séparés par des virgules (,).	test.com
ExistPrivateKey	boolean	Indique si le certificat possède une clé privée. Valeurs valides : true false	true
FingerPrint	string	L'empreinte de la clé publique.	123
InstanceId	string	L'identifiant de l'instance de certificat.	cas-cn-v***
Issuer	string	L'émetteur du certificat.	DigiCert
KeySize	integer	La longueur de la clé. La longueur de la clé RSA est généralement de 2048, 3072 ou 4096. La longueur de la clé des algorithmes ECC et SM2 est généralement de 256.	2048
NotAfter	integer	L'heure de fin de la période de validité du certificat.	1749580567000
NotBefore	integer	L'heure de début de la période de validité du certificat.	1760745600000
Serial	string	Le numéro de série du certificat.	123
SubjectAlternativeNames	array	La liste des noms alternatifs du sujet (SAN) du certificat, renvoyée sous forme de tableau. Cela correspond au champ Subject Alternative Name du certificat.
	string	Le nom alternatif du sujet du certificat.	test.com
UsingProductList	array	La liste des services Alibaba Cloud sur lesquels le certificat est actuellement déployé.
	string	Le service Alibaba Cloud.	CDN
CurrentPage	integer	Le numéro de page actuel. Valeur par défaut : 1.	1
RequestId	string	L'identifiant de la requête, qui est un identifiant unique généré par Alibaba Cloud pour cette requête. Vous pouvez utiliser cet identifiant pour le dépannage.	CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D
ShowSize	integer	Le nombre d'entrées par page.	10
TotalCount	integer	Le nombre total d'entrées renvoyées.	10

Exemples

JSON format

{
  "CertificateList": [
    {
      "Algorithm": "RSA",
      "CertIdentifier": "21589515-cn-hangzhou",
      "CertificateId": "17281539",
      "CertificateName": "test",
      "CertificateSource": "BUY",
      "CertificateStatus": "issued",
      "CommonName": "aliyun.com",
      "DeploymentDesc": "{\n      \"Scope\": \"all\",\n       \"ServerName\": \"acmeServerName\",\n       \"ResourceInstanceId\": \"cas_dv-cn-XXX\"\n}",
      "Domain": "test.com",
      "ExistPrivateKey": true,
      "FingerPrint": "123",
      "InstanceId": "cas-cn-v***",
      "Issuer": "DigiCert",
      "KeySize": 2048,
      "NotAfter": 1749580567000,
      "NotBefore": 1760745600000,
      "Serial": "123",
      "SubjectAlternativeNames": [
        "test.com"
      ],
      "UsingProductList": [
        "CDN"
      ]
    }
  ],
  "CurrentPage": 1,
  "RequestId": "CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D",
  "ShowSize": 10,
  "TotalCount": 10
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.