SearchMultiAccountResources - - Centre de documentation Alibaba Cloud

Recherche des ressources dans le compte de gestion et plusieurs comptes membres d'un répertoire de ressources.

Description de l'opération

Seuls les services cloud et types de ressources pris en charge par Resource Center peuvent être recherchés.
Si vous utilisez un utilisateur ou un rôle Resource Access Management (RAM), vous devez disposer des autorisations sur l'opération SearchMultiAccountResources avant de pouvoir exécuter des recherches de ressources inter-comptes. Pour plus d'informations, consultez Utilisateurs RAM utilisant Resource Center.
L'opération SearchMultiAccountResources renvoie un maximum de 20 entrées par défaut. Vous pouvez ajuster le nombre maximal d'entrées renvoyées en spécifiant le paramètre MaxResults.
Si le paramètre NextToken n'est pas renvoyé dans la réponse, il n'y a plus de données. Sinon, il existe davantage de données. Pour interroger la page suivante, définissez le paramètre NextToken de l'opération SearchMultiAccountResources sur la valeur NextToken renvoyée dans la réponse précédente. Si le paramètre NextToken n'est pas spécifié, la première page de données est renvoyée par défaut.
Vous pouvez restreindre la portée de la recherche en définissant une ou plusieurs conditions de filtrage. Pour les paramètres de filtrage et les types de correspondance pris en charge, consultez la section suivante. Plusieurs conditions de filtrage sont évaluées à l'aide d'un ET logique. Seules les ressources répondant à toutes les conditions de filtrage sont renvoyées. Les valeurs au sein d'une même condition de filtrage sont évaluées à l'aide d'un OU logique. Les ressources répondant à l'une des valeurs de filtrage conditionnel sont renvoyées.
Vous pouvez obtenir d'autres exemples de requêtes à partir de OpenAPI Explorer.

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.

resourcecenter:SearchMultiAccountResources

list

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Scope	string	Oui	La portée des comptes à rechercher. Valeurs valides : Identifiant du répertoire de ressources : recherche des ressources dans le compte de gestion et tous les comptes membres. Pour plus d'informations, consultez GetResourceDirectory. Identifiant du dossier racine : recherche des ressources dans tous les comptes membres du dossier racine et de ses sous-dossiers. Pour plus d'informations, consultez ListFoldersForParent. Identifiant du dossier : recherche des ressources dans tous les comptes membres du dossier spécifié. Pour plus d'informations, consultez ListFoldersForParent. Identifiant du compte membre : recherche des ressources dans le compte membre spécifié. Pour plus d'informations, consultez ListAccounts.	rd-r4****
NextToken	string	Non	Le jeton pour la page de résultats suivante. Si le nombre total de résultats dépasse la limite MaxResults, les données sont tronquées. Vous pouvez utiliser NextToken pour interroger la page de données suivante.	eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd****
MaxResults	integer	Non	Le nombre maximal d'entrées par page. Valeurs valides : 1 à 100. Valeur par défaut : 20.	10
Filter	array<object>	Non	Les conditions de filtrage.
	object	Non	Les conditions de filtrage.
Key	string	Non	La clé de la condition de filtrage. Pour les valeurs valides, consultez Paramètres de filtrage pris en charge ci-dessous.	ResourceGroupId
MatchType	string	Non	Le type de correspondance. Définissez la valeur sur Equals, ce qui indique une correspondance exacte.	Equals
Value	array	Non	Les valeurs de la condition de filtrage.
	string	Non	Les valeurs de la condition de filtrage.	rg-aekzmrjn4ns****
SortCriterion	object	Non	Le paramètre de tri.
Key	string	Non	Le critère de tri. Définissez la valeur sur CreateTime, ce qui indique un tri par heure de création de la ressource.	CreateTime
Order	string	Non	L'ordre de tri. Valeurs valides : ASC (par défaut) : ordre croissant. DESC : ordre décroissant.	ASC

Paramètres de filtrage pris en charge

Paramètre	Description	Types de correspondance pris en charge
ResourceType	Le type de ressource.	Equals
RegionId	L'identifiant de la région.	Equals
ResourceId	L'identifiant de la ressource.	Equals, Prefix
ResourceGroupId	L'identifiant du groupe de ressources.	Equals, Exists, NotExists
ResourceName	Le nom de la ressource.	Equals, Contains
Tag	La paire clé-valeur de la balise. Le format JSON est `{ "key": $key, "value": $value }`. Au moins une clé ou valeur doit être spécifiée. Par exemple, pour interroger la clé de balise `foo` et la valeur de balise `bar`, transmettez `{ "key": "foo", "value": "bar" }`. Pour interroger uniquement la clé de balise `foo`, transmettez `{ "key": "foo" }`.	Contains, NotContains, NotExists
VpcId	L'identifiant du VPC.	Equals
VSwitchId	L'identifiant du vSwitch.	Equals

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
Filters	array<object>	Les conditions de filtrage.
	object	Les conditions de filtrage.
Key	string	La clé de la condition de filtrage.	RegionId
MatchType	string	Le type de correspondance.	Equals
Values	array	Les valeurs de la condition de filtrage.
	string	Les valeurs de la condition de filtrage.	cn-hangzhou
MaxResults	integer	Le nombre maximal d'entrées par page.	10
NextToken	string	Le jeton pour la page de résultats suivante.	Le jeton pour la page de résultats suivante
RequestId	string	L'identifiant de la requête.	EFA806B9-7F36-55AB-8B7A-D680C2C5EE57
Resources	array<object>	Les informations sur la ressource.
	array<object>	Les informations sur la ressource.
AccountId	string	L'identifiant du compte de gestion du répertoire de ressources ou des comptes membres du répertoire de ressources.	151266687691****
CreateTime	string	L'heure de création de la ressource. L'heure est affichée au format ISO 8601, en temps UTC. Le format est `yyyy-MM-ddTHH:mm:ssZ` ou `yyyy-MM-ddTHH:mm:ss.SSSZ`. Remarque Le renvoi de ce paramètre est déterminé par le service cloud auquel la ressource appartient.	2021-06-30T09:20:08Z
ExpireTime	string	L'heure d'expiration de la ressource. L'heure est affichée au format ISO 8601, en temps UTC. Le format est `yyyy-MM-ddTHH:mm:ssZ` ou `yyyy-MM-ddTHH:mm:ss.SSSZ`.	2023-06-14T14:35:45Z
IpAddressAttributes	array<object>	Les attributs de l'adresse IP.
	object	Les attributs de l'adresse IP.
IpAddress	string	L'adresse IP.	192.168.1.2
NetworkType	string	Le type de réseau. Valeurs valides : Public : Internet. Private : réseau privé.	Public
Version	string	La version de l'adresse IP.	Ipv4
IpAddresses	array	Les adresses IP. Remarque Le renvoi de ce paramètre est déterminé par le service cloud auquel la ressource appartient.
	string	Les adresses IP. Remarque Le renvoi de ce paramètre est déterminé par le service cloud auquel la ressource appartient.	192.168.1.2
RegionId	string	L'identifiant de la région de la ressource.	cn-hangzhou
ResourceGroupId	string	L'identifiant du groupe de ressources.	rg-acfmzawhxxc****
ResourceId	string	L'identifiant de la ressource.	vtb-bp11lbh452fr8940s****
ResourceName	string	Le nom de la ressource.	group1
ResourceType	string	Le type de ressource.	ACS::VPC::RouteTable
Tags	array<object>	Les balises.
	object	Les balises.
Key	string	La clé de la balise.	test_key
Value	string	La valeur de la balise.	test_value
ZoneId	string	L'identifiant de la zone. Remarque Le renvoi de ce paramètre est déterminé par le service cloud auquel la ressource appartient.	cn-hangzhou-k
Scope	string	La portée des comptes à rechercher. Valeurs valides : Identifiant du répertoire de ressources : recherche des ressources dans le compte de gestion et tous les comptes membres. Identifiant du dossier racine : recherche des ressources dans tous les comptes membres du dossier racine et de ses sous-dossiers. Identifiant du dossier : recherche des ressources dans tous les comptes membres du dossier spécifié. Identifiant du compte membre : recherche des ressources dans le compte membre spécifié.	rd-r4****

Exemples

JSON format

{
  "Filters": [
    {
      "Key": "RegionId",
      "MatchType": "Equals",
      "Values": [
        "cn-hangzhou"
      ]
    }
  ],
  "MaxResults": 10,
  "NextToken": "Jeton pour récupérer la page de résultats suivante",
  "RequestId": "EFA806B9-7F36-55AB-8B7A-D680C2C5EE57",
  "Resources": [
    {
      "AccountId": "151266687691****",
      "CreateTime": "2021-06-30T09:20:08Z",
      "ExpireTime": "2023-06-14T14:35:45Z",
      "IpAddressAttributes": [
        {
          "IpAddress": "192.168.1.2",
          "NetworkType": "Public",
          "Version": "Ipv4"
        }
      ],
      "IpAddresses": [
        "192.168.1.2"
      ],
      "RegionId": "cn-hangzhou",
      "ResourceGroupId": "rg-acfmzawhxxc****",
      "ResourceId": "vtb-bp11lbh452fr8940s****",
      "ResourceName": "group1",
      "ResourceType": "ACS::VPC::RouteTable",
      "Tags": [
        {
          "Key": "test_key",
          "Value": "test_value"
        }
      ],
      "ZoneId": "cn-hangzhou-k"
    }
  ],
  "Scope": "rd-r4****\n"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	NoPermission	You are not authorized to perform this operation.
400	InvalidParameter.MaxResults	The specified parameter MaxResults is not valid.	Le paramètre MaxResults n'est pas valide.
400	MultiAccountServiceNotEnabled	Multi account ResourceCenter service is not enabled.
400	InvalidParameter.Filter.ResourceType	The specified parameter value of Filter.ResourceType is not valid.
400	InvalidParameter.Filter.CreateTime	The specified parameter Filter.n.CreateTime is not valid.	Le paramètre Filter.n.CreateTime n'est pas valide.
400	InvalidParameter.Filter.IpAddress	The specified parameter Filter.n.IpAddress is not valid.	Le paramètre Filter.n.IpAddress n'est pas valide.
400	InvalidParameter.Filter.Tag	The specified parameter Filter.n.Tag is not valid.	Le paramètre Filter.n.Tag n'est pas valide.
403	NoPermission.AccountScope	The operator is not permitted for this account scope.	L'utilisateur actuel n'est pas autorisé à effectuer des opérations sur ce périmètre de compte de répertoire de ressources.
404	NotExists.Resource	The specified resource does not exist.	La ressource spécifiée n'existe pas.
404	NotExists.ResourceDirectory	The resource directory for the account is not enabled.	Le répertoire de ressources n'est pas activé pour le compte actuel.
404	NotExists.ResourceDirectory.FolderId	The specified folder does not exist.	Le dossier spécifié n'existe pas.
409	InvalidParameter.Scope	The Scope is invalid.
409	NoPermission.ResourceDirectory.MemberAccount	ResourceDirectory Member Account is not authorized to perform this operation.
409	InvalidParameter.SortCriterion.Key	The specified parameter SortCriterion.Key is not valid.
409	ExceedLimit.Filter	The maximum length of Filters is exceeded.	Le nombre de paramètres Filter dépasse la limite supérieure.
409	ServiceNotEnabled.SpecifiedAccount	ResourceCenter service of the specified account is not enabled.

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

Notes de version

Consultez Notes de version pour la liste complète.