CreateServerCertificate - - Centre de documentation Alibaba Cloud

Émet un certificat de serveur unique basé sur une demande de signature de certificat (CSR) générée par le système.

Description de l'opération

Avant d'appeler cette opération, vous devez avoir appelé CreateRootCACertificate pour créer un certificat d'autorité de certification racine et appelé CreateSubCACertificate pour créer un certificat d'autorité de certification subordonnée. Seuls les certificats d'autorité de certification subordonnée peuvent émettre des certificats de serveur.

Limite de QPS

La limite de QPS par utilisateur pour cette opération est de 10 appels par seconde. Si cette limite est dépassée, l'appel d'API est limité, ce qui peut affecter votre activité. Appelez cette opération de manière 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:CreateServerCertificate

create

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Domain	string	Non	Les noms de domaine et les adresses IP supplémentaires du certificat de serveur. Après avoir ajouté des informations supplémentaires au certificat, vous pouvez l'appliquer à plusieurs noms de domaine et adresses IP. Séparez les différents noms de domaine et adresses IP par des virgules (,).	example.com
Organization	string	Non	Le nom de l'organisation. Valeur par défaut : Alibaba Inc.	Alibaba Cloud
OrganizationUnit	string	Non	Le nom du département. Valeur par défaut : Aliyun CDN.	IT
Country	string	Non	Le code du pays, tel que CN ou US.	CN
CommonName	string	Oui	Le nom de l'utilisateur du certificat. Pour un certificat d'authentification de serveur (ServerAuth), l'utilisateur est un serveur. Saisissez le nom de domaine ou l'adresse IP associé au serveur.	www.example.com
State	string	Non	Le nom de la province ou de l'État où se trouve l'organisation du certificat. Les caractères chinois et anglais sont pris en charge. Valeur par défaut : le nom de la province ou de l'État où se trouve l'organisation du certificat d'autorité de certification subordonnée qui émet ce certificat.	Zhejiang
Locality	string	Non	Le nom de la ville où se trouve l'organisation du certificat. Les caractères chinois et anglais sont pris en charge. Valeur par défaut : le nom de la ville où se trouve l'organisation du certificat d'autorité de certification subordonnée qui émet ce certificat.	Hangzhou
Algorithm	string	Oui	L'algorithme de clé du certificat de serveur. L'algorithme de clé est au format `<algorithme de chiffrement>_<longueur de clé>`. Valeurs valides : RSA_1024 : l'algorithme de signature est Sha256WithRSA. RSA_2048 : l'algorithme de signature est Sha256WithRSA. RSA_4096 : l'algorithme de signature est Sha256WithRSA. ECC_256 : l'algorithme de signature est Sha256WithECDSA. ECC_384 : l'algorithme de signature est Sha256WithECDSA. ECC_512 : l'algorithme de signature est Sha256WithECDSA. SM2_256 : l'algorithme de signature est SM3WithSM2. L'algorithme de chiffrement du certificat de serveur doit être identique à celui du certificat d'autorité de certification subordonnée, mais la longueur de clé peut être différente. Par exemple, si l'algorithme de clé du certificat d'autorité de certification subordonnée est RSA_2048, l'algorithme de clé du certificat de serveur doit être RSA_1024, RSA_2048 ou RSA_4096. Remarque Vous pouvez appeler DescribeCACertificate pour interroger l'algorithme de clé du certificat d'autorité de certification subordonnée.	RSA_2048
ParentIdentifier	string	Oui	L'identifiant unique du certificat d'autorité de certification subordonnée qui émet ce certificat. Remarque Vous pouvez appeler DescribeCACertificateList pour interroger l'identifiant unique du certificat d'autorité de certification subordonnée.	271ae6bb538d538c70c01f81dg3****
Years	integer	Non	La période de validité du certificat. Unité : années.	1
Months	integer	Non	La période de validité du certificat. Unité : mois.	12
Days	integer	Non	La période de validité du certificat de serveur. Unité : jours. Les paramètres Days, BeforeTime et AfterTime ne peuvent pas être tous vides. Les paramètres BeforeTime et AfterTime doivent être tous deux vides ou tous deux spécifiés. Les règles suivantes s'appliquent : Si vous définissez le paramètre Days, vous pouvez choisir de définir ou non les paramètres BeforeTime et AfterTime. Si vous ne définissez pas le paramètre Days, vous devez définir les paramètres BeforeTime et AfterTime. Remarque Si vous définissez les paramètres Days, BeforeTime et AfterTime en même temps, la période de validité du certificat de serveur est déterminée par la valeur du paramètre Days. La période de validité du certificat de serveur ne peut pas dépasser la période de validité du certificat d'autorité de certification subordonnée. Vous pouvez appeler DescribeCACertificate pour interroger la période de validité du certificat d'autorité de certification subordonnée.	365
BeforeTime	integer	Non	L'heure d'émission du certificat de serveur au format d'horodatage. Valeur par défaut : l'heure à laquelle vous appelez cette opération. Unité : secondes. Remarque Les paramètres BeforeTime et AfterTime doivent être tous deux vides ou tous deux spécifiés.	1634283958
AfterTime	integer	Non	L'heure d'expiration du certificat de serveur au format d'horodatage. Unité : secondes. Remarque Les paramètres BeforeTime et AfterTime doivent être tous deux vides ou tous deux spécifiés.	1665819958
Immediately	integer	Non	Indique si le certificat numérique doit être renvoyé immédiatement. Valeurs valides : 0 : ne renvoie pas le certificat. Il s'agit de la valeur par défaut. 1 : renvoie le certificat. 2 : renvoie le certificat et sa chaîne de certificats.	1
EnableCrl	integer	Non	Indique si l'adresse de la liste de révocation de certificats (CRL) doit être incluse. Valeurs valides : 0 : non. 1 : oui.	1
Tags	array<object>	Non	La liste des balises.
	object	Non	La liste des balises.
Key	string	Non	La clé de la balise.	account
Value	string	Non	La valeur de la balise.	test
ResourceGroupId	string	Non	L'identifiant du groupe de ressources. Vous pouvez obtenir cet identifiant en appelant l'opération ListResources.	test
CustomIdentifier	string	Non	L'identifiant personnalisé, qui est une clé unique.	**6bb538d538c70c01f81dg3**
AsynchronousFlag	boolean	Non	L'indicateur de traitement asynchrone. Si la valeur est "true", le service backend émet le certificat de manière asynchrone. Une fois la requête soumise, vous pouvez appeler l'opération ListClientCertificate pour obtenir le certificat le plus récent.	false

Lorsque vous appelez cette opération, vous devez inclure les paramètres de requête d'API Alibaba Cloud courants en plus des paramètres de requête spécifiques à l'opération décrits dans cette rubrique.

Pour le format de la requête, consultez les exemples de requêtes dans la section Exemples de cette rubrique.

Éléments de réponse

Élément	Type	Description	Exemple
	object	CreateCertificateResponse
X509Certificate	string	Le contenu du certificat de serveur.	-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----
CertificateChain	string	La chaîne de certificats de l'autorité de certification.	-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\n......\n-----END CERTIFICATE-----\n
Identifier	string	L'identifiant unique du certificat de serveur.	160ae6bb538d538c70c01f81dcf2****
SerialNumber	string	Le numéro de série du certificat.	084bde9cd233f0ddae33adc438cfbbbd****
RequestId	string	L'identifiant de la requête. Alibaba Cloud génère un identifiant unique pour chaque requête. Vous pouvez utiliser l'identifiant de la requête pour résoudre les problèmes.	15C66C7B-671A-4297-9187-2C4477247A74

Exemples

JSON format

{
  "X509Certificate": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----",
  "CertificateChain": "-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----\\n-----BEGIN CERTIFICATE-----\\n......\\n-----END CERTIFICATE-----\\n",
  "Identifier": "160ae6bb538d538c70c01f81dcf2****",
  "SerialNumber": "084bde9cd233f0ddae33adc438cfbbbd****",
  "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.