DescribeClientCertificate - - Centre de documentation Alibaba Cloud

Obtient un certificat client ou un certificat de serveur par son identifiant unique.

Description de l'opération

Vous pouvez appeler cette opération pour interroger les détails d'un certificat client ou d'un certificat de serveur par son identifiant unique. Les détails incluent le numéro de série, le sujet, le contenu et l'état du certificat.

Avant d'appeler cette opération, vous devez créer un certificat client ou un certificat de serveur.

Pour créer un certificat client en appelant une API, consultez les rubriques suivantes :

Pour créer un certificat de serveur en appelant une API, consultez les rubriques suivantes :

Limites

La limite de requêtes par seconde (QPS) pour cet appel d'API est de 10 par utilisateur. Si vous dépassez cette limite, une limitation de débit est déclenchée, ce qui peut affecter votre activité. Planifiez vos appels en conséquence.

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

get

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Identifier	string	Oui	L'identifiant unique du certificat client ou du certificat de serveur à interroger. Remarque Appelez ListClientCertificate pour interroger les identifiants uniques de tous les certificats clients et certificats de serveur.	d3b95700998e47afc4d95f886579****

En plus des paramètres de requête précédents, vous devez spécifier les paramètres de requête communs lors de l'appel de cette API. Pour plus d'informations sur les paramètres de requête communs, consultez Paramètres communs.

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	DescribeCertificateResponse<CertificateWithContentDTO>
Certificate	object	Les détails du certificat client ou du certificat de serveur.
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 sujet du certificat. Cette valeur est composée des champs suivants : C : Pays. O : Organisation. OU : Unité organisationnelle. CN : Nom commun. ST : Province ou État. CN : Nom commun.	C=CN,O=Aliyun,OU=Security,L=Hangzhou,ST=Zhejiang,CN=Aliyun
CommonName	string	Le nom commun du certificat.	aliyun.com
OrganizationUnit	string	L'unité organisationnelle du sujet du certificat.	Security
Organization	string	L'organisation associée au certificat de l'autorité de certification subordonnée émettrice.	Aliyun
Locality	string	La ville où se trouve l'organisation du sujet.	Hangzhou
State	string	L'État ou la province où se trouve l'organisation du sujet.	Zhejiang
CountryCode	string	Le code pays de l'organisation du sujet. Pour plus d'informations sur les codes pays, consultez la section Codes internationaux dans Gérer les profils d'entreprise.	CN
Sans	string	L'extension Subject Alternative Name (SAN) du certificat. L'extension SAN indique d'autres noms de domaine ou adresses IP 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 qui correspond à 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 identificateur de ressource uniforme (URI). 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. Valeurs valides : RSA : l'algorithme RSA. ECC : l'algorithme ECC. SM2 : l'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 de serveur.	SERVER
ParentIdentifier	string	L'identifiant unique du certificat de l'autorité de certification subordonnée qui a émis le 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-acfmxllajdpw3fi
CertChain	string	La chaîne de certificats complète.	-----BEGIN CERTIFICATE----- cert -----END CERTIFICATE----- -----BEGIN CERTIFICATE----- subCA -----END CERTIFICATE----- -----BEGIN CERTIFICATE----- rootCA -----END CERTIFICATE-----
CustomIdentifier	string	L'identifiant personnalisé, qui est une clé unique.	*3a32d96883a6650e672ea0276**
UploadFlag	integer	Indique si le certificat est synchronisé avec Digital Certificate Management Service.	1
FullAlgorithm	string	L'algorithme et sa longueur.	RSA_2048
AliasName	string	L'alias du certificat émis.	rsa_root_2048
Id	integer	L'identifiant de la source de données à laquelle la commande de certificat appartient.	1137354
Tags	array<object>	La liste des balises.	mtls
	object	La valeur de la balise.
TagKey	string	The tag key.	testKey
TagValue	string	The tag value.	[{\"tag\":\"PROPERTY_TYPE\",\"values\":[]}]
RequestId	string	L'identifiant de la requête.	15C66C7B-671A-4297-9187-2C4477247A74

Exemples

JSON format

{
  "Certificate": {
    "X509Certificate": "-----BEGIN CERTIFICATE-----  ...... -----END CERTIFICATE-----",
    "Identifier": "d3b95700998e47afc4d95f886579****",
    "SerialNumber": "62b2b943a32d96883a6650e672ea0276****",
    "SubjectDN": "C=CN,O=Aliyun,OU=Security,L=Hangzhou,ST=Zhejiang,CN=Aliyun",
    "CommonName": "aliyun.com",
    "OrganizationUnit": "Security",
    "Organization": "Aliyun",
    "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-acfmxllajdpw3fi",
    "CertChain": "-----BEGIN CERTIFICATE-----\ncert\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\nsubCA\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\nrootCA\n-----END CERTIFICATE-----",
    "CustomIdentifier": "***3a32d96883a6650e672ea0276****",
    "UploadFlag": 1,
    "FullAlgorithm": "RSA_2048",
    "AliasName": "rsa_root_2048",
    "Id": 1137354,
    "Tags": [
      {
        "TagKey": "testKey",
        "TagValue": "[{\\\"tag\\\":\\\"PROPERTY_TYPE\\\",\\\"values\\\":[]}]"
      }
    ]
  },
  "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74"
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.