CreateAutoGroupingRule - Resource Management - Centre de documentation Alibaba Cloud

Crée une règle de transfert automatique de groupe de ressources. Deux types sont pris en charge : les règles de transfert personnalisées et les règles de transfert de ressources attachées.

Description de l'opération

Vous pouvez créer jusqu'à 10 règles de transfert personnalisées, et chaque règle de transfert personnalisée prend en charge jusqu'à 10 entrées de règle.

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.

resourcemanager:CreateAutoGroupingRule

create

*Toutes les ressources.

*

Aucune

Syntaxe de la requête

POST  HTTP/1.1

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RuleName	string	Oui	Le nom de la règle.	Règle de transfert automatique pour les ressources en ligne du projet A
RuleDesc	string	Non	La description de la règle.	Transférer les ressources avec les balises {"env": "online"} et {"project": "A"} vers le groupe de ressources rg-aek2********qcy
RuleType	string	Oui	Le type de règle. Valeurs valides : custom_condition : règle de transfert personnalisée. associated_transfer : règle de transfert de ressources attachées. Valeurs valides : associated_transfer : Règle de transfert de ressources attachées. custom_condition : Règle de transfert personnalisée.	custom_condition
RuleContents	array<object>	Oui	La liste des entrées de règle.
	object	Non	L'entrée de règle.
AutoGroupingScopeCondition	string	Non	La condition de portée pour le transfert automatique de groupe de ressources. Spécifie la portée des ressources à transférer automatiquement.	{"children":[{"desired":"{\"env\":\"online\", \"project\":\"A\"}","featurePath":"$.tags","featureSource":"RESOURCE","operator":"TagMatchAll"}],"operator":"and"}
TargetResourceGroupCondition	string	Oui	La condition de groupe de ressources cible. Spécifie le groupe de ressources de destination pour le regroupement automatique.	{"children":[{"desired":"rg-aek2********qcy","featurePath":"$.resourceGroupId","featureSource":"RESOURCE","operator":"StringEquals"}],"operator":"and"}
ResourceGroupIdsScope	string	Non	La portée des identifiants de groupe de ressources. Séparez plusieurs identifiants de groupe de ressources par des virgules (,).	rg-aekz****4b5ea,rg-aek2****fxykq
ExcludeResourceGroupIdsScope	string	Non	Les identifiants de groupe de ressources à exclure. Séparez plusieurs identifiants de groupe de ressources par des virgules (,).	rg-aekz****zj2oi,rg-aekz****r62ua
RegionIdsScope	string	Non	La portée des identifiants de région. Séparez plusieurs identifiants de région par des virgules (,).	cn-hangzhou,cn-shanghai
ExcludeRegionIdsScope	string	Non	Les identifiants de région à exclure. Séparez plusieurs identifiants de région par des virgules (,).	cn-beijing,cn-guangzhou
ResourceIdsScope	string	Non	La portée des identifiants de ressource. Séparez plusieurs identifiants de ressource par des virgules (,).	i-2zee****ym49kfmwis,vpc-5ts6****fnw493g849a
ExcludeResourceIdsScope	string	Non	Les identifiants de ressource à exclure. Séparez plusieurs identifiants de ressource par des virgules (,).	pc-uf6p****4h784y,rmq-cn-****ny0y
ResourceTypesScope	string	Non	La portée des types de ressources. Séparez plusieurs types de ressources par des virgules (,).	rds.dbinstance,oss.bucket
ExcludeResourceTypesScope	string	Non	Les types de ressources à exclure. Séparez plusieurs types de ressources par des virgules (,).	mse.cluster,slb.loadbalancer

Exemple 1 : Transférer automatiquement des ressources en fonction des balises de ressource

{
  "RuleName": "Transfert automatique pour les ressources en ligne du projet A",
  "RuleDesc": "Transférer les ressources avec les balises {\"env\": \"online\"} et {\"project\": \"A\"} vers le groupe de ressources rg-aek2********qcy",
  "RuleType": "custom_condition",
  "RuleContents": [
    {
      "AutoGroupingScopeCondition": "{\"children\":[{\"desired\":\"{\\\"env\\\":\\\"online\\\", \\\"project\\\":\\\"A\\\"}\",\"featurePath\":\"$.tags\",\"featureSource\":\"RESOURCE\",\"operator\":\"TagMatchAll\"}],\"operator\":\"and\"}",
      "TargetResourceGroupCondition": "{\"children\":[{\"desired\":\"rg-aek2********qcy\",\"featurePath\":\"$.resourceGroupId\",\"featureSource\":\"RESOURCE\",\"operator\":\"StringEquals\"}],\"operator\":\"and\"}"
    }
  ]
}

Exemple 2 : Transférer des disques cloud avec des instances ECS

{
  "RuleName": "Transférer des disques cloud avec des instances ECS",
  "RuleDesc": "Lorsqu'un disque cloud est attaché à une instance ECS ou qu'une instance ECS est transférée vers un autre groupe de ressources, les disques cloud associés sont automatiquement transférés vers le groupe de ressources de l'instance ECS associée",
  "RuleType": "associated_transfer",
  "ResourceTypesScope": "ecs.disk",
  "RuleContents": [
    {
      "TargetResourceGroupCondition": "{\"desired\":\"$.ResourceGroupId\",\"desiredSource\":\"RESOURCE_RELATIONSHIP_ACS::ECS::Instance\",\"featurePath\":\"$.ResourceGroupId\",\"featureSource\":\"CONFIGURATION\",\"operator\":\"StringEquals\"}"
    }
  ]
}

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
RequestId	string	L'identifiant de la requête.	F7701451-340B-5CB3-AEA7-7D831F7F38C0
RuleId	string	L'identifiant de la règle.	gr-acfo******hy6a

Exemples

JSON format

{
  "RequestId": "F7701451-340B-5CB3-AEA7-7D831F7F38C0",
  "RuleId": "gr-acfo******hy6a"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	Invalid.AssociatedTransferRule.AlreadyExisted	The associated transfer rule already exists.	La règle de transfert d'association existe déjà.
400	InvalidParameter.ResourceTypesScope	The parameter ResourceTypesScope is invalid.	Le paramètre ResourceTypesScope n'est pas valide.
400	InvalidParameter.ExcludeResourceTypesScope	The parameter ExcludeResourceTypesScope is invalid.	Le paramètre ExcludeResourceTypesScope n'est pas valide.
400	InvalidParameter.ResourceGroupIdsScope	The parameter ResourceGroupIdsScope is invalid.	Le paramètre ResourceGroupIdsScope n'est pas valide.
400	InvalidParameter.ExcludeResourceGroupIdsScope	The parameter ExcludeResourceGroupIdsScope is invalid.	Le paramètre ExcludeResourceGroupIdsScope n'est pas valide.
400	InvalidParameterCombination.BothRegionIdScopes	The combination of parameters RegionIdsScope and ExcludeRegionIdsScope is not allowed. Please select only one of these parameters.	RegionIdsScope et ExcludeRegionIdsScope sont mutuellement exclusifs. Vous ne pouvez en spécifier qu'un seul dans une même requête.
400	InvalidParameterCombination.BothResourceGroupIdScopes	The combination of parameters ResourceGroupIdsScope and ExcludeResourceGroupIdsScope is not allowed. Please select only one of these parameters.	ResourceGroupIdsScope et ExcludeResourceGroupIdsScope sont mutuellement exclusifs. Vous ne pouvez en spécifier qu'un seul dans une même requête.
400	InvalidParameterCombination.BothResourceIdScopes	The combination of parameters ResourceIdsScope and ExcludeResourceIdsScope is not allowed. Please select only one of these parameters.	ResourceIdsScope et ExcludeResourceIdsScope sont mutuellement exclusifs. Vous ne pouvez en spécifier qu'un seul dans une même requête.
400	InvalidParameterCombination.BothResourceTypeScopes	The combination of parameters ResourceTypesScope and ExcludeResourceTypesScope is not allowed. Please select only one of these parameters.	ResourceTypesScope et ExcludeResourceTypesScope sont mutuellement exclusifs. Vous ne pouvez en spécifier qu'un seul dans une même requête.
400	InvalidParameter.RuleContents	The parameter RuleContents is invalid.	Le paramètre RuleContents n'est pas valide.
400	MissingParameter.RuleContents	The parameter RuleContents is required.	Le paramètre RuleContents est requis.
409	AutoGroupingNotEnabled	The auto grouping is disabled.	Le transfert automatique de groupe est désactivé.
409	QuotaExceeded.RuleContent	The number of rule contents exceeds the quota.	Le nombre d'éléments dans la condition de groupe créée dépasse la limite.
409	QuotaExceeded.GroupingRule	The number of grouping rules exceeds the quota.	Le nombre de conditions de groupe dépasse la limite.

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

Notes de version

Consultez Notes de version pour la liste complète.