CreateServerCertificateWithCsr - - Centre de documentation Alibaba Cloud

Émet un certificat de serveur unique basé sur une CSR personnalisée.

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

create

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Csr	string	Oui	Le contenu de la CSR. Vous pouvez utiliser OpenSSL ou Keytool pour générer une CSR. Pour plus d'informations, consultez Comment créer un fichier CSR ?.	-----BEGIN CERTIFICATE REQUEST----- ...... -----END CERTIFICATE REQUEST-----
Domain	string	Non	Le nom de domaine étendu ou l'adresse IP étendue du certificat de serveur. Après avoir ajouté des informations étendues au certificat, vous pouvez appliquer le certificat à plusieurs noms de domaine ou adresses IP. Vous pouvez saisir plusieurs noms de domaine et adresses IP en même temps. Séparez les différentes valeurs 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.	CN
CommonName	string	Non	Le nom commun du certificat. Les caractères chinois, les caractères anglais et d'autres caractères sont pris en charge. Remarque Si vous définissez le paramètre Csr, la valeur du paramètre CommonName est déterminée par les informations correspondantes dans le paramètre Csr.	mtcsq.com
State	string	Non	Le nom de la province ou de l'État où se trouve l'organisation du certificat. Les caractères chinois, les caractères anglais et d'autres caractères sont pris en charge. La valeur par défaut est 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, les caractères anglais et d'autres caractères sont pris en charge. La valeur par défaut est 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	Non	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.	270oe6bb538d538c70c01f81hfd3****
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, et les paramètres BeforeTime et AfterTime doivent être tous deux vides ou tous deux définis. Voici comment définir ce paramètre : 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 consulter 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. La valeur par défaut est 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 définis.	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 définis.	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 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.	rg-aek****wia
CustomIdentifier	string	Non	L'identifiant personnalisé, qui est une clé unique.	*e6bb538d538c70c01f81hfd3**
AsynchronousFlag	boolean	Non	L'indicateur de traitement asynchrone. Si la valeur est true, le service principal é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 communs des 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	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.	180ae6bb538d538c70c01f81dcf2****
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.	55C66C7B-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": "180ae6bb538d538c70c01f81dcf2****",
  "SerialNumber": "084bde9cd233f0ddae33adc438cfbbbd****",
  "RequestId": "55C66C7B-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.