ListProductQuotas - - Centre de documentation Alibaba Cloud

Consulte la liste des quotas d'un produit cloud spécifié.

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.

quotas:ListProductQuotas

list

*Quota

acs:quotas:{#regionId}:{#accountId}:quota/{#ProductCode}/*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
NextToken	string	Non	Le jeton utilisé pour initier la requête suivante. Laissez ce paramètre vide pour la première requête ou si aucune requête ultérieure n'est nécessaire. Si une requête ultérieure est nécessaire, définissez la valeur sur la valeur NextToken renvoyée par le dernier appel d'API.	AAAAAd****
MaxResults	integer	Non	Le nombre maximal d'enregistrements à renvoyer pour la requête. Valeurs valides : 1 à 100. Valeur par défaut : 30.	30
ProductCode	string	Oui	L'abréviation du produit cloud. Remarque Pour plus d'informations sur la façon d'obtenir l'abréviation d'un produit cloud, consultez le paramètre `ProductCode` dans ListProducts.	ecs
QuotaActionCode	string	Non	L'identifiant du quota.	q_security-groups
KeyWord	string	Non	Le mot-clé à utiliser pour rechercher des quotas. Remarque Ce paramètre s'applique uniquement aux quotas de type d'instance d'Elastic Compute Service (ECS). La recherche est effectuée sur QuotaName et QuotaActionCode.	security
SortField	string	Non	Le champ à utiliser pour trier les quotas. Remarque Ce paramètre s'applique uniquement aux quotas de types d'instances ECS. Si vous ne définissez pas ce paramètre, les résultats de la requête ne sont pas triés. Valeurs valides : TOTAL : Trie par utilisation totale du quota. TIME : Trie par heure de la dernière mise à jour. RESERVED : Trie par utilisation du quota réservé.	TIME
SortOrder	string	Non	L'ordre de tri des résultats. Remarque Ce paramètre s'applique uniquement aux quotas de types d'instances ECS. Si vous ne définissez pas ce paramètre, les résultats de la requête ne sont pas triés. Valeurs valides : Descending : Trie par ordre décroissant. Ascending : Trie par ordre croissant.	Ascending
Dimensions	array<object>	Non	Les dimensions du quota.
	object	Non	Les dimensions du quota.
Key	string	Non	La clé de la dimension de quota. Remarque La valeur de N dépend du nombre de dimensions prises en charge par le produit cloud.	regionId
Value	string	Non	La valeur de la dimension de quota. Remarque La valeur de N dépend du nombre de dimensions prises en charge par le produit cloud.	cn-hangzhou
QuotaCategory	string	Non	La catégorie de quota. Valeurs valides : FlowControl : Quotas de limitation de débit d'API. WhiteListLabel : Quotas de privilège. CommonQuota : Quotas généraux.	FlowControl
GroupCode	string	Non	Le code du groupe de dimensions.	entconsole_w1j3ms****

Éléments de réponse

Élément	Type	Description	Exemple
	object	Le résultat retourné.
MaxResults	integer	Le nombre maximal d'enregistrements retournés pour la requête.	1
NextToken	string	Le jeton utilisé pour initier la requête suivante. Si ce paramètre est vide, aucune requête ultérieure n'est initiée. Si une valeur est renvoyée, cette valeur est le jeton utilisé pour la requête suivante.	AAAAAd****
Quotas	array<object>	Les détails des quotas.
	array<object>	Les détails du quota.
Adjustable	boolean	Indique si le quota est ajustable. Valeurs valides : true : Le quota est ajustable. false : Le quota n'est pas ajustable.	true
ApplicableRange	array	La plage de valeurs de quota que vous pouvez demander pour le quota. Cela peut servir de référence pour les demandes d'augmentation de quota.
	number	La plage de valeurs de quota que vous pouvez demander. Cette plage n'inclut pas le quota existant de l'utilisateur. Vous pouvez l'utiliser comme référence lorsque vous demandez une augmentation de quota. Par exemple, `[1010,10000]`.	[1010,10000]
ApplicableType	string	Le type d'ajustement du quota. Valeurs valides : continuous : La valeur du quota est continue. discontinuous : La valeur du quota est discontinue.	discontinuous
ApplyReasonTips	string	Un exemple de motif pour une demande d'augmentation de quota.	L'activité xxx devrait augmenter de 50 %
Consumable	boolean	Indique si le quota utilisé est affiché. Valeurs valides : true : Le quota utilisé est affiché. false : Le quota utilisé n'est pas affiché.	true
Dimensions	object	Les dimensions du quota. Format : {"regionId":"Region"}.	{"regionId":"cn-hangzhou"}
EffectiveTime	string	L'heure UTC à laquelle le quota prend effet.	2022-09-28T06:07:00Z
ExpireTime	string	L'heure UTC à laquelle le quota expire.	2022-09-29T06:07:00Z
GlobalQuota	boolean	Indique si le quota est un quota global. Valeurs valides : true : Le quota est partagé par toutes les régions. false : Le quota est indépendant pour chaque région.	true
Period	object	Le cycle de calcul du quota.
PeriodUnit	string	The unit of the calculation cycle. Valeurs valides : week : Week hour : Hour day : Day second : Seconds minute : minutes	day
PeriodValue	integer	The value of the calculation cycle.	{}
ProductCode	string	L'abréviation du produit cloud.	ecs
QuotaActionCode	string	L'identifiant du quota.	q_security-groups
QuotaArn	string	L'Alibaba Cloud Resource Name (ARN) du quota.	acs:quotas:cn-hangzhou:120886317861****:quota/ecs/q_security-groups
QuotaCategory	string	La catégorie de quota. Valeurs valides : FlowControl : Quotas de limitation de débit d'API. WhiteListLabel : Quotas de privilège. CommonQuota : Quotas généraux.	CommonQuota
QuotaDescription	string	La description du quota.	Le nombre maximal de groupes de sécurité pouvant être détenus par le compte actuel
QuotaItems	array<object>	Les détails du quota.
	object	Les détails du quota.
Quota	string	The quota value.	1009
QuotaUnit	string	The unit of the quota.	Count
Type	string	The quota type. Valeurs valides : BaseQuota : Guaranteed quota ReservedQuota : Reserved quota	BaseQuota
Usage	string	The quota usage.	1009
QuotaName	string	Le nom du quota.	ecs.g5.2xlarge
QuotaType	string	Le type de quota. Valeurs valides : normal : Standard. privilege : Privilège.	privilege
QuotaUnit	string	L'unité du quota.	AMOUNT
SupportedRange	array	La plage de valeurs de quota prise en charge par le quota. Cela peut servir de référence lors de la configuration d'un modèle de quota.
	number	La plage de valeurs de quota prise en charge par le quota. Cela peut servir de référence lors de la configuration d'un modèle de quota. Si ApplicableType est continuous et que la valeur est [1009,10000], cela indique que toutes les valeurs de 1009 à 10000 sont prises en charge. Si ApplicableType est discontinuous et que la valeur est [10,20,50,100], cela indique que seules les valeurs 10, 20, 50 et 100 sont prises en charge.	[1009,10000]
TotalQuota	number	La valeur du quota.	200
TotalUsage	number	L'utilisation du quota.	1009
UnadjustableDetail	string	La raison pour laquelle le quota n'est pas ajustable. Valeurs valides : limitReached : La limite du quota est atteinte. nonactivated : Le service n'est pas activé. applicationProcess : Une demande d'augmentation de quota est en cours de traitement.	applicationProcess
UsageMetric	object	Les informations de surveillance de l'utilisation du quota dans CloudMonitor. Remarque Une valeur vide indique qu'aucune donnée de surveillance n'est disponible pour le quota dans CloudMonitor.
MetricDimensions	object	The dimensions for CloudMonitor. Format: a collection of key-value pairs. For example: `{"productCode":"*","metricKey":"","regionId":"","label":"*"}`.
	string	The value of the dimension for CloudMonitor.	ecs
MetricName	string	The name of the CloudMonitor metric.	Usage
MetricNamespace	string	The namespace of the metric for CloudMonitor.	acs_quotas_flowcontrol
RequestId	string	L'identifiant de la requête.	D0131FD5-5397-44FE-BF5A-4B7165B813CC
TotalCount	integer	Le nombre total d'entrées retournées pour la requête.	1

Exemples

JSON format

{
  "MaxResults": 1,
  "NextToken": "AAAAAd****",
  "Quotas": [
    {
      "Adjustable": true,
      "ApplicableRange": [
        0
      ],
      "ApplicableType": "discontinuous",
      "ApplyReasonTips": "The business xxx is expected to grow by 50%.",
      "Consumable": true,
      "Dimensions": {
        "regionId": "cn-hangzhou"
      },
      "EffectiveTime": "2022-09-28T06:07:00Z",
      "ExpireTime": "2022-09-29T06:07:00Z",
      "GlobalQuota": true,
      "Period": {
        "PeriodUnit": "day",
        "PeriodValue": 0
      },
      "ProductCode": "ecs",
      "QuotaActionCode": "q_security-groups",
      "QuotaArn": "acs:quotas:cn-hangzhou:120886317861****:quota/ecs/q_security-groups",
      "QuotaCategory": "CommonQuota",
      "QuotaDescription": "The maximum number of security groups that can be owned by the current account.",
      "QuotaItems": [
        {
          "Quota": "1009",
          "QuotaUnit": "Count",
          "Type": "BaseQuota",
          "Usage": "1009"
        }
      ],
      "QuotaName": "ecs.g5.2xlarge",
      "QuotaType": "privilege",
      "QuotaUnit": "AMOUNT",
      "SupportedRange": [
        0
      ],
      "TotalQuota": 200,
      "TotalUsage": 1009,
      "UnadjustableDetail": "applicationProcess",
      "UsageMetric": {
        "MetricDimensions": {
          "key": "ecs"
        },
        "MetricName": "Usage",
        "MetricNamespace": "acs_quotas_flowcontrol"
      }
    }
  ],
  "RequestId": "D0131FD5-5397-44FE-BF5A-4B7165B813CC",
  "TotalCount": 1
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidSortOrder	Invalid SortOrder	The specified SortOrder parameter is invalid.
400	INVALID.MAX.RESULTS	The maxResults parameter is invalid. Use an integer ranging from 1 to 100.	The maxResults value is invalid. It must be an integer within the range of 1 to 100.
400	DIMENSIONGROUP.NOT.FOUND	Dimension group does not exist.	Dimension group parameter is incorrect

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

Notes de version

Consultez Notes de version pour la liste complète.