ListClientCertificate - - Centre de documentation Alibaba Cloud

Répertorie tous les certificats client et serveur émis par une autorité de certification (CA) privée.

Description de l'opération

Cette API effectue une requête paginée pour récupérer les détails de tous les certificats client et serveur que vous avez créés. Ces détails incluent l'identifiant unique, le numéro de série, les informations du sujet, le contenu et l'état de chaque certificat.

Limite de QPS

La limite de QPS pour un utilisateur unique est de 10 appels par seconde. Si vous dépassez cette limite, vos appels d'API sont limités, ce qui peut affecter votre activité. Appelez cette API à un rythme raisonnable.

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

list

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
CurrentPage	integer	Non	Le numéro de page. Valeur par défaut : 1.	1
ShowSize	integer	Non	Le nombre d'entrées à renvoyer sur chaque page. Valeur par défaut : 20.	20
Identifier	string	Non	L'identifiant unique du certificat client ou serveur que vous souhaitez interroger. Remarque Vous pouvez appeler ListClientCertificate pour interroger les identifiants uniques de tous les certificats client et serveur.	160ae6bb538d538c70c01f81dcf2****
ResourceGroupId	string	Non	L'identifiant du groupe de ressources. Appelez l'opération ListResources pour obtenir cet identifiant.	rg-ae******4wia

Lorsque vous appelez cette API, vous devez inclure les paramètres de requête communs aux API Alibaba Cloud en plus des paramètres de requête décrits dans cette rubrique.

Pour le format de la requête, consultez l'exemple de requête dans la section Exemples de cette rubrique.

Éléments de réponse

Élément	Type	Description	Exemple
	object	ListCertificateResponse2
CertificateList	array<object>	Liste des détails des certificats client ou serveur.
	object	Un objet.
X509Certificate	string	Le contenu du certificat.	-----BEGIN CERTIFICATE----- ...... -----END CERTIFICATE-----
Identifier	string	L'identifiant unique du certificat.	d3b95700998e47afc4d95f886579****
SerialNumber	string	Le numéro de série du certificat.	62b2b943a32d96883a6650e672ea0276****
SubjectDN	string	Le nom distinctif (DN) du certificat. Le DN indique l'utilisateur du certificat et contient les informations suivantes : C : Le pays. O : L'organisation. OU : Le département. L : La ville. ST : La province ou l'État. CN : Le nom commun.	C=CN,O=Alibaba Cloud Computing Co., Ltd.,OU=Security,L=Hangzhou,ST=Zhejiang,CN=Aliyun
CommonName	string	Le nom commun du certificat.	aliyundoc.com
OrganizationUnit	string	Le nom du département de l'organisation associé au certificat de l'autorité de certification (CA) subordonnée émettrice.	Security
Organization	string	Le nom de l'organisation associé au certificat de l'autorité de certification subordonnée émettrice.	Alibaba Cloud Computing Co., Ltd
Locality	string	La ville où se trouve l'organisation associée au certificat de l'autorité de certification subordonnée émettrice.	Hangzhou
State	string	Le nom de la province ou de l'État où se trouve l'organisation associée au certificat de l'autorité de certification subordonnée émettrice.	Zhejiang
CountryCode	string	Le code du pays où se trouve l'organisation associée au certificat de l'autorité de certification subordonnée émettrice. Pour plus d'informations sur les codes pays, consultez la section Codes pays de Gérer les informations de l'entreprise.	CN
Sans	string	L'extension Subject Alternative Name (SAN) du certificat. Cette extension indique d'autres noms de domaine, adresses IP, etc., associés au certificat. Ce paramètre est une chaîne convertie à partir d'un tableau JSON. Chaque élément du tableau JSON est une structure correspondant à une extension SAN. Chaque structure d'extension SAN contient les paramètres suivants : Type : Le type de l'extension. Ce paramètre est de type Integer. Valeurs valides : 1 : une adresse e-mail. 2 : un nom de domaine. 6 : un URI (Uniform Resource Identifier). 7 : une adresse IP. Value : Le contenu de l'extension. Ce paramètre est de type String.	[ {"Type": 7, "Value": "192.0.XX.XX"}, {"Type": 2, "Value": "www.aliyundoc.com"}, ]
Status	string	L'état du certificat. Valeurs valides : ISSUE : Le certificat est émis. REVOKE : Le certificat est révoqué.	ISSUE
BeforeDate	integer	La date d'émission du certificat. Cette valeur est un horodatage UNIX. Unité : millisecondes.	1634283958000
AfterDate	integer	La date d'expiration du certificat. Cette valeur est un horodatage UNIX. Unité : millisecondes.	1665819958000
Algorithm	string	Le type d'algorithme de chiffrement du certificat. Valeurs valides : RSA : Algorithme RSA. ECC : Algorithme ECC. SM2 : Algorithme SM2.	RSA
KeySize	integer	La longueur de la clé du certificat.	4096
SignAlgorithm	string	L'algorithme de signature du certificat.	SHA256WITHRSA
CertificateType	string	Le type de certificat. Valeurs valides : CLIENT : un certificat client. SERVER : un certificat serveur.	SERVER
ParentIdentifier	string	L'identifiant unique du certificat de l'autorité de certification subordonnée qui a émis ce certificat.	160ae6bb538d538c70c01f81dcf2****
Sha2	string	L'empreinte SHA-256 du certificat.	14dcc8afc7578e1fcec36d658f7e20de18f6957bbac42b373a66bc9de4e9****
Md5	string	L'empreinte MD5 du certificat.	d3b95700998e47afc4d95f886579****
Days	integer	La période de validité du certificat. Unité : jours.	365
ResourceGroupId	string	L'identifiant du groupe de ressources auquel le certificat appartient.	rg-acfmyxa2uv6cu5a
CustomIdentifier	string	L'identifiant personnalisé, qui est une clé unique.	**48d8d3ecc9976d9ecd2b2f25**
Id	integer	L'identifiant de clé primaire du certificat.	12321
AliasName	string	Le nom du certificat émis.	Production Training 10.153.13.177
CurrentPage	integer	Le numéro de la page renvoyée.	1
PageCount	integer	Le nombre total de pages.	1
ShowSize	integer	Le nombre de certificats renvoyés par page.	20
TotalCount	integer	Le nombre total de certificats client et serveur interrogés.	1
RequestId	string	L'identifiant de la requête.	15C66C7B-671A-4297-9187-2C4477247A74
MaxResults	integer	Paramètre de pagination : le nombre maximum d'entrées dans le jeu de résultats.	20

Exemples

JSON format

{
  "CertificateList": [
    {
      "X509Certificate": "-----BEGIN CERTIFICATE-----  ...... -----END CERTIFICATE-----",
      "Identifier": "d3b95700998e47afc4d95f886579****",
      "SerialNumber": "62b2b943a32d96883a6650e672ea0276****",
      "SubjectDN": "C=CN,O=阿里云计算有限公司,OU=Security,L=Hangzhou,ST=Zhejiang,CN=Aliyun",
      "CommonName": "aliyundoc.com",
      "OrganizationUnit": "Security",
      "Organization": "阿里云计算有限公司",
      "Locality": "Hangzhou",
      "State": "Zhejiang",
      "CountryCode": "CN",
      "Sans": "[ {\"Type\": 7, \"Value\": \"192.0.XX.XX\"}, {\"Type\": 2, \"Value\": \"www.aliyundoc.com\"}, ]",
      "Status": "ISSUE",
      "BeforeDate": 1634283958000,
      "AfterDate": 1665819958000,
      "Algorithm": "RSA",
      "KeySize": 4096,
      "SignAlgorithm": "SHA256WITHRSA",
      "CertificateType": "SERVER",
      "ParentIdentifier": "160ae6bb538d538c70c01f81dcf2****",
      "Sha2": "14dcc8afc7578e1fcec36d658f7e20de18f6957bbac42b373a66bc9de4e9****",
      "Md5": "d3b95700998e47afc4d95f886579****",
      "Days": 365,
      "ResourceGroupId": "rg-acfmyxa2uv6cu5a",
      "CustomIdentifier": "****48d8d3ecc9976d9ecd2b2f25****",
      "Id": 12321,
      "AliasName": "生产培训10.153.13.177"
    }
  ],
  "CurrentPage": 1,
  "PageCount": 1,
  "ShowSize": 20,
  "TotalCount": 1,
  "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74",
  "MaxResults": 20
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.