ListInstances - - Centre de documentation Alibaba Cloud

Obtient la liste des instances.

Description de l'opération

Consulte les informations d'état des instances d'autorité de certification privée (PCA) que vous avez achetées via la console SSL Certificates en spécifiant les identifiants des instances de CA privée. Par exemple, vous pouvez consulter l'état d'une instance de CA, le nombre de certificats numériques inclus et le nombre de certificats numériques émis.

Avant d'appeler cette opération, vous devez avoir acheté une CA privée via la console Certificate Management Service. Pour plus d'informations, consultez Acheter une CA privée.

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 selon vos besoins.

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

list

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Keyword	string	Non	Le mot-clé pour la recherche approximative. Correspond aux noms de domaine, aux noms d'instance ou aux identifiants de ressource correspondants.	test
Status	string	Non	L'état de l'instance. Valeurs valides : inactive : En attente d'utilisation. pending : En cours d'examen. Le dernier certificat est en cours de soumission pour examen. willExpire : L'instance est sur le point d'expirer. expired : L'instance a expiré. refund : Remboursé. normal : Normal. closed : Arrêté et indisponible.	inactive
Brand	string	Non	La marque de la CA. Valeurs valides : WoSign, CFCA, DigiCert, GeoTrust, GlobalSign, vTrus et Alibaba.	Digicert
CertificateType	string	Non	Le type de certificat. Valeurs valides : DV, OV et EV.	DV
CertificateStatus	string	Non	L'état du certificat. Valeurs valides : issued : Émis. revoked : Révoqué. willExpire : Sur le point d'expirer. expired : Expiré. Valeurs valides : expired : expiré. willExpire : sur le point d'expirer. issued : émis. revoked : révoqué.	issued
InstanceType	string	Non	Le type d'instance. Valeurs valides : BUY (certificat officiel) et TEST (certificat de test).	BUY
ResourceGroupId	string	Non	L'identifiant du groupe de ressources.	rg-ae******4wia
ShowSize	integer	Non	Le nombre d'instances à afficher par page dans une requête paginée. Définit le nombre d'instances affichées par page. Valeur par défaut : 10. Valeur maximale : 100.	10
CurrentPage	integer	Non	Le numéro de la page actuelle dans une requête paginée. Définit le numéro de la page actuelle. Valeur par défaut : 1.	1
ServerDeployFlag	integer	Non	Indique si seules les instances répondant aux conditions de déploiement sur serveur doivent être renvoyées. Valeurs valides : 1 : oui. 0 : non.	1
AutoReissueFlag	integer	Non	Indique si l'instance est gérée. Valeurs valides : 1 (gérée) et 0 (non gérée).	1

Éléments de réponse

Élément	Type	Description	Exemple
	object
CurrentPage	integer	Le numéro de la page actuelle dans une requête paginée.	1
DisableReissueCount	integer	Le nombre d'instances pour lesquelles le renouvellement géré n'est pas activé.	80
EnableReissueCount	integer	Le nombre d'instances pour lesquelles le renouvellement géré est activé.	100
InstanceList	array<object>	La liste des instances.
	object	L'instance.
AutoReissue	string	Indique si le renouvellement géré automatique est activé. Valeurs valides : enable : Activé. disable : Non activé.	enable
Brand	string	La marque de la CA. Valeurs valides : WoSign, CFCA, DigiCert, GeoTrust, GlobalSign, vTrus et Alibaba.	DigiCert
CertIdentifier	string	L'identifiant global du certificat, au format identifiant de certificat + "-" + identifiant de région du site. Cet identifiant est couramment utilisé dans les services Alibaba Cloud. Valeurs valides : Pour le site Chine : identifiant de certificat + "-cn-hangzhou". Pour le site Chine (chinois) : identifiant de certificat + "-ap-southeast-1". Par exemple, si l'identifiant du certificat est 123, le CertIdentifier sur le site Chine est "123-cn-hangzhou", et le CertIdentifier sur le site Chine (chinois) est "123-ap-southeast-1".	21795675-cn-hangzhou
CertificateDomain	string	Le nom de domaine du dernier certificat émis.	abc.com,www.abc.com
CertificateId	integer	L'identifiant du certificat.	18541349
CertificateName	string	Le nom du certificat.	cert-13216408
CertificateNotAfter	integer	L'heure de fin du dernier certificat. La valeur est un horodatage UNIX en secondes. Cette valeur est vide si aucun certificat n'a été émis.	1801324800000
CertificateNotBefore	integer	L'heure de début du dernier certificat. La valeur est un horodatage UNIX en secondes. Cette valeur est vide si aucun certificat n'a été émis.	1776988800000
CertificateRevokeTime	integer	L'heure de révocation du dernier certificat. La valeur est un horodatage UNIX en secondes.	1801324800000
CertificateStatus	string	L'état du certificat. Valeurs valides : issued : Émis. revoked : Révoqué. willExpire : Sur le point d'expirer. expired : Expiré.	issued
CertificateType	string	Le type de certificat. Valeurs valides : DV, OV et EV.	DV
Domain	string	Le nom de domaine associé au certificat.	test.com
FullDomainCount	integer	Le nombre de noms de domaine avec correspondance exacte.	1
InstanceEndTime	integer	L'heure d'expiration de l'instance. La valeur est un horodatage UNIX en secondes. Cette valeur est vide si aucun certificat n'a été émis.	1801324800000
InstanceId	string	L'identifiant de l'instance.	cas_dv-cn-123
InstanceStartTime	integer	L'heure de début de l'instance. La valeur est un horodatage UNIX en secondes. Cette valeur est vide si aucun certificat n'a été émis.	1801324800000
InstanceType	string	Le type d'instance. Valeurs valides : BUY (certificat officiel) et TEST (certificat de test).	BUY
KeyAlgorithm	string	L'algorithme du certificat. Valeur par défaut : RSA_2048. Valeurs valides : RSA_2048 RSA_3072 RSA_4096 ECC_256 SM2	RSA_2048
OrderEndTime	integer	L'heure de fin de l'achat de l'instance. La valeur est un horodatage UNIX en secondes. Cette valeur est utilisée pour déterminer la durée d'achat de l'instance.	1801324800000
OrderStartTime	integer	L'heure de début de l'achat de l'instance. La valeur est un horodatage UNIX en secondes. Cette valeur est utilisée pour déterminer le délai limite de remboursement.	1801324800000
PendingResult	string	Le résultat renvoyé par la CA lors de la dernière opération de certificat.	pending
ResourceGroupId	string	L'identifiant du groupe de ressources.	123
Spec	string	La spécification de l'instance achetée.	ss.dv.t
Status	string	L'état de l'instance. Valeurs valides : inactive : En attente d'utilisation. pending : En cours d'examen. La dernière soumission de certificat est en cours d'examen. willExpire : L'instance est sur le point d'expirer. expired : L'instance a expiré. refund : Remboursé. normal : Normal. closed : Arrêté et indisponible.	inactive
UsingProductList	array	La liste de déploiement des services cloud pour le dernier certificat.
	string	Le service cloud de déploiement.	['DCDN', 'VOD', 'CDN', 'OSS']
VersionType	string	Le type de version. Valeurs valides : basic (Édition de base), standard (Édition standard), professional (Édition professionnelle) et ultimate (Édition ultime). Valeurs valides : standard : Édition standard. ultimate : Édition ultime. basic : Édition de base. professional : Édition professionnelle.	professional
WildcardDomainCount	integer	Le nombre de noms de domaine génériques.	0
RequestId	string	L'identifiant de la requête.	12345678-1234-1234-1234-123456789ABC
ShowSize	integer	Le nombre d'enregistrements affichés par page.	20
TotalCount	integer	Le nombre total d'instances.	12

Exemples

JSON format

{
  "CurrentPage": 1,
  "DisableReissueCount": 80,
  "EnableReissueCount": 100,
  "InstanceList": [
    {
      "AutoReissue": "enable",
      "Brand": "DigiCert",
      "CertIdentifier": "21795675-cn-hangzhou",
      "CertificateDomain": "abc.com,www.abc.com",
      "CertificateId": 18541349,
      "CertificateName": "cert-13216408",
      "CertificateNotAfter": 1801324800000,
      "CertificateNotBefore": 1776988800000,
      "CertificateRevokeTime": 1801324800000,
      "CertificateStatus": "issued",
      "CertificateType": "DV",
      "Domain": "test.com",
      "FullDomainCount": 1,
      "InstanceEndTime": 1801324800000,
      "InstanceId": "cas_dv-cn-123",
      "InstanceStartTime": 1801324800000,
      "InstanceType": "BUY",
      "KeyAlgorithm": "RSA_2048",
      "OrderEndTime": 1801324800000,
      "OrderStartTime": 1801324800000,
      "PendingResult": "pending",
      "ResourceGroupId": "123",
      "Spec": "ss.dv.t",
      "Status": "inactive",
      "UsingProductList": [
        "['DCDN', 'VOD', 'CDN', 'OSS']"
      ],
      "VersionType": "professional",
      "WildcardDomainCount": 0
    }
  ],
  "RequestId": "12345678-1234-1234-1234-123456789ABC",
  "ShowSize": 20,
  "TotalCount": 12
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.