Normes API et SDK multilingues prédéfinis
L'OpenAPI de ce produit (cas/2020-04-07) utilise le style de signature RPC. Des SDK sont disponibles pour les langages de programmation courants. Les développeurs peuvent télécharger le SDK pour appeler directement l'OpenAPI de ce produit, sans se soucier des détails techniques. Si le SDK existant ne répond pas à vos besoins, utilisez le mécanisme de signature pour une intégration par auto-signature. L'auto-signature étant particulièrement complexe, comptez environ 5 jours ouvrables. Nous vous recommandons donc de rejoindre notre groupe d'assistance DingTalk (147535001692) pour bénéficier d'un accompagnement expert lors de l'intégration.
Avant d'utiliser l'API, préparez votre compte d'identité et votre clé d'accès (AccessKey) afin d'accéder efficacement à l'API via des outils clients (tels que SDK et CLI). Pour plus d'informations, consultez Obtenir un AccessKey.
Scénarios de signature personnalisée
Si votre scénario métier présente des exigences particulières et nécessite une intégration par auto-signature, consultez d'abord notre équipe de support technique (groupe d'assistance DingTalk : 147535001692) pour obtenir un accompagnement professionnel et garantir une intégration efficace.
Préparation du compte et de la sécurité
Les comptes Alibaba Cloud disposent de permissions administratives complètes sur l'ensemble des ressources. En cas de compromission d'un AccessKey, toutes les ressources associées sont exposées à un risque d'accès non autorisé. Pour garantir la sécurité, créez un utilisateur RAM disposant uniquement de permissions d'accès API et configurez son AccessKey. Appliquez ensuite des politiques RAM selon le principe du moindre privilège (PoLP). N'utilisez le compte Alibaba Cloud que dans les scénarios spécifiques où ses permissions sont explicitement requises.
Instances d'abonnement (V2.0)
|
API |
Titre |
Description |
| ListInstances | Liste des instances. | Obtient la liste des instances. |
| UpdateInstance | Mise à jour d'une instance. | Met à jour une instance. |
| GetInstanceDetail | Consultation des détails de l'instance | Consulte les détails d'une instance. |
| DeleteInstance | Supprimer une instance. | Supprime une instance. |
| RefundInstance | Remboursement d'une instance. | Rembourse une instance dans un délai de 7 jours. |
| GetInstanceSummary | GetInstanceSummary. | Consulte les statistiques récapitulatives des instances de Certificate Management Service, telles que le nombre de certificats par état. |
| ApplyCertificate | Demande de certificat. | Demande un certificat. |
| GetTaskAttribute | GetTaskAttribute. | Consulte le résultat du traitement et l'état d'une demande de certificat soumise. |
| CancelPendingCertificate | Révocation d'une demande de certificat. | Révoque une demande de certificat. |
| ListCertificates | Liste des certificats. | Obtient la liste des certificats. |
| RevokeCertificate | Révoquer un certificat. | Révoque un certificat. |
| GetCertificateDetail | Consultation des détails du certificat à l'exclusion de la clé privée. | Consulte les détails d'un certificat. Le contenu du certificat et le contenu de la clé privée ne sont pas renvoyés. |
| GetUserCertificateDetail | Détails du certificat. | Obtient les détails d'un certificat, y compris les informations de base et le contenu des clés publique et privée. Vous pouvez utiliser cette opération pour télécharger le contenu du certificat et la clé privée. |
| DeleteUserCertificate | Supprimer un certificat. | Supprime un certificat expiré, révoqué ou importé. |
| UploadUserCertificate | Importation d'un certificat. | Importe un certificat, y compris un certificat SM standard ou un certificat non-SM. |
Contacts des certificats
|
API |
Titre |
Description |
| CreateContact | Créer un contact de demande de certificat. | Crée un contact de demande de certificat. |
| GetContact | Obtenir les informations de contact. | Obtient un contact. |
| ListContact | Récupération de la liste des contacts. | Obtient la liste des contacts. |
| UpdateContact | Modifier un contact de demande de certificat. | Met à jour un contact. |
| DeleteContact | Supprimer un contact de demande de certificat. | Supprime un contact. |
Organisation de l'entreprise
|
API |
Titre |
Description |
| CreateCompany | Création d'une organisation d'entreprise de certificat. | Crée une entreprise. |
| UpdateCompany | Modification de l'organisation de l'entreprise du certificat. | Met à jour les informations de l'entreprise. |
| ListCompanies | Récupérer les organisations des entreprises de certificats. | Obtient une liste d'entreprises. |
| GetCompany | Détails de l'entreprise ou de l'organisation du certificat. | Obtient les détails d'une entreprise. |
| DeleteCompany | Suppression d'une organisation d'entreprise de certificat. | Supprime une entreprise. |
Groupes de ressources
|
API |
Titre |
Description |
| MoveResourceGroup | MoveResourceGroup. | Modifie le groupe de ressources auquel appartient un certificat ou une commande de certificat. |
Tâches de déploiement
|
API |
Titre |
Description |
| CreateDeploymentJob | CreateDeploymentJob | Crée une tâche de déploiement de certificat pour déployer un certificat SSL sur un ou plusieurs services Alibaba Cloud immédiatement ou à une heure planifiée. |
| UpdateDeploymentJobStatus | UpdateDeploymentJobStatus | Met à jour l'état d'une tâche de déploiement de certificat, par exemple en passant de l'édition à l'attente d'exécution. |
| ListDeploymentJob | Consultation de la liste des tâches de déploiement. | Obtient la liste des tâches de déploiement après la création d'une tâche de déploiement. |
| UpdateDeploymentJob | UpdateDeploymentJob. | Met à jour la configuration d'une tâche de déploiement de certificats, telle que les certificats ou les ressources cibles. |
| DescribeDeploymentJob | DescribeDeploymentJob. | Obtient les informations relatives à une tâche de déploiement de certificat, y compris l'état de la tâche, les ressources cibles et les certificats. |
| ListWorkerResource | ListWorkerResource. | Consulte les tâches de travail d'une tâche de déploiement. Chaque tâche de travail déploie un certificat sur une ressource cloud spécifique d'un service cloud. |
| DescribeDeploymentJobStatus | DescribeDeploymentJobStatus. | Consulte le résumé de l'état d'exécution d'une tâche de déploiement de certificat, incluant le nombre de tâches ayant réussi et échoué. |
| ListDeploymentJobResource | ListDeploymentJobResource. | Consulte les ressources cloud associées à une tâche de déploiement. Une liste vide indique que les ressources ne sont pas valides et doivent être réassociées. |
| ListDeploymentJobCert | ListDeploymentJobCert. | Consulte les certificats associés à une tâche de déploiement, tels que l'identifiant de l'instance du certificat, le type et le nom. |
| UpdateWorkerResourceStatus | Mise à jour du statut d'une tâche de worker dans une tâche de déploiement. | Met à jour le statut d'une tâche de worker dans une tâche de déploiement. |
| DeleteWorkerResource | DeleteWorkerResource. | Supprime une tâche de worker d'une tâche de déploiement de certificat. |
| DeleteDeploymentJob | DeleteDeploymentJob. | Supprime une tâche de déploiement de certificat. |
| DescribeCloudResourceStatus | DescribeCloudResourceStatus. | Consulte le nombre de ressources cloud sur lesquelles des certificats ont été déployés à l'aide d'une tâche de déploiement multi-cloud. |
| ListCloudResources | ListCloudResources. | Consulte les ressources cloud sur lesquelles des certificats sont déployés, telles que les instances Server Load Balancer (SLB) et les domaines CDN. |
| ListCloudAccess | ListCloudAccess. | Consulte les paires de clés d'accès configurées pour le déploiement de certificats multi-cloud. |
Référentiel de certificats
|
API |
Titre |
Description |
| GetCertWarehouseQuota | GetCertWarehouseQuota. | Consulte le quota restant pour les opérations du référentiel de demandes de certificats. |
| ListCertWarehouse | Consultation de la liste des référentiels de certificats. | Consulte la liste des référentiels de certificats. |
| ListCert | ListCert. | Consulte les certificats dans le magasin de certificats. |
| Sign | Sign. | Crée une signature numérique à l'aide d'un certificat PCA issu d'un référentiel de certificats. |
| Verify | Verify. | Vérifie une signature de données à l'aide d'un certificat privé dans un référentiel de demandes de certificats. |
| Encrypt | Encrypt. | Chiffre des données à l'aide d'un certificat dans un référentiel de demandes de certificat. |
| Decrypt | Decrypt. | Déchiffre les données qui ont été chiffrées à l'aide d'un certificat dans un référentiel d'applications de certificats. |
| UploadPCACert | Importer un certificat PCA dans un référentiel de certificats. | Importe un certificat PCA dans un référentiel de certificats. |
| DeletePCACert | DeletePCACert. | Supprime un certificat privé d'un référentiel de demandes de certificats. |
| CreateWHClientCertificate | CreateWHClientCertificate. | Émet un certificat client unique à partir du référentiel général de certificats utilisateur. |
| RevokeWHClientCertificate | RevokeWHClientCertificate. | Révoque un certificat client du référentiel de certificats. |
Gestion des CSR
|
API |
Titre |
Description |
| ListCsr | ListCsr. | Consulte les demandes de signature de certificat (CSR) de votre compte. |
| CreateCsr | CreateCsr. | Crée une demande de signature de certificat (CSR) contenant des informations sur un certificat SSL à demander, telles que les noms de domaine et le titulaire du certificat. Vous devez fournir un CSR lorsque vous soumettez une demande de certificat à une autorité de certification (CA). |
| UploadCsr | UploadCsr. | Importe une demande de signature de certificat (CSR) existante vers Certificate Management Service. Après l'importation, vous pouvez utiliser la CSR pour demander des certificats. |
| GetCsrDetail | GetCsrDetail. | Consulte le contenu d'une demande de signature de certificat (CSR). |
| UpdateCsr | Importation ou mise à jour d'une clé privée de CSR. | Importe la clé privée correspondant à une CSR si vous n'avez pas fourni la clé privée de la CSR lors de l'importation de la CSR locale. |
| DeleteCsr | DeleteCsr. | Supprime une demande de signature de certificat (CSR). |
Commandes (V1.0)
|
API |
Titre |
Description |
| DescribePackageState | DescribePackageState | Consulte le quota et l'utilisation des packages de certificats validés au niveau du domaine (DV). |
| ListUserCertificateOrder | Consultation des certificats ou des commandes utilisateur. | Consulte la liste des certificats ou des commandes de l'utilisateur. |
| CreateCertificateForPackageRequest | CreateCertificateForPackageRequest. | Soumet une demande de certificat en utilisant le quota d'un forfait de certificats acheté. |
| CancelCertificateForPackageRequest | CancelCertificateForPackageRequest. | Révoque un certificat émis ou annule une commande de certificat en attente et restaure le quota. |
| CancelOrderRequest | CancelOrderRequest. | Annule une commande de demande de certificat en attente de vérification du domaine ou en cours d'examen. |
| RenewCertificateOrderForPackageRequest | RenewCertificateOrderForPackageRequest. | Soumet une demande de renouvellement pour un certificat SSL émis. |
Demandes de certificat (V1.0)
|
API |
Titre |
Description |
| DescribeCertificateState | DescribeCertificateState. | Consulte l'état d'une commande de demande de certificat, telle que la progression de la validation du domaine. |
| CreateCertificateWithCsrRequest | CreateCertificateWithCsrRequest. | Achète, demande et émet un certificat à validation de domaine (DV) à l'aide d'un fichier de demande de signature de certificat (CSR) personnalisé. |
| CreateCertificateRequest | Créer une demande de certificat. | Achète, demande et délivre un certificat à validation de domaine (DV) via les services de certificats étendus. |
| DeleteCertificateRequest | Supprimer une demande de certificat DV en échec. | Supprime une commande de demande de certificat à validation de domaine (DV) en échec. |
Autres
|
API |
Titre |
Description |
| AddCloudAccess | AddCloudAccess. | Ajoute une AccessKey pour l'autorisation. |
| CreateWarehouse | Créer un référentiel de demandes de certificat. | Crée un référentiel de certificats. |
| DeleteCloudAccess | DeleteCloudAccess. | Supprime une clé d'accès. |
| DeleteWarehouse | DeleteWarehouse. | Supprime un entrepôt de certificats. |
| DescribeWarehouseCert | DescribeWarehouseCert. | Obtient les détails d'un certificat stocké dans un entrepôt de certificats. |
| GetAssetCount | Consultation du nombre d'actifs. | Consulte le nombre d'actifs. |
| GetRiskCount | GetRiskCount. | Consulte le nombre d'actifs présentant des risques liés aux certificats, tels que des certificats expirés ou sur le point d'expirer. |
| ListAssetCount | Consultation des statistiques de ressources des services cloud. | Consulte la liste des statistiques de ressources des services cloud. |
| ListWarehouse | ListWarehouse. | Répertorie les entrepôts. |
| BatchUpdateNoticeStatus | Mise à jour de l'état de notification des messages. | Met à jour l'état des notifications par lots. |
| GetMatchedResources | Récupération des ressources correspondant à un certificat. | Obtient les ressources correspondant à un certificat. |
| CreateRollbackTask | Retour en arrière d'un déploiement. | Effectue un retour en arrière d'un déploiement. |
| GetCertificatePackageCount | Obtenir le nombre de plans de ressources de certificats | Obtient le nombre de plans de ressources de certificats. |
| ListTagKeys | Interrogation des clés de balises. | Obtient une liste de clés et de valeurs de balises. |
| ListTagResources | Liste des balises de ressource. | Obtient les balises associées à une ressource. |
| ListTrusteeOrder | Liste des commandes gérées. | Obtient la liste des commandes gérées. |
| ShareCertificate | Partage d'un certificat. | Partage un certificat. |
| TagResources | Attacher des balises à une ressource spécifiée (instance de certificat SSL) | Ajoute des balises de ressource. |
| UntagResources | Suppression des balises d'une ressource spécifiée (instance de certificat SSL) | Supprime des balises. |