SearchResources - - Centre de documentation Alibaba Cloud

Recherche les ressources de votre compte actuel auxquelles vous êtes autorisé à accéder.

Description de l'opération

Vous pouvez uniquement rechercher les ressources de votre compte actuel auxquelles vous êtes autorisé à accéder.
Vous pouvez uniquement rechercher les services Alibaba Cloud et les types de ressources pris en charge par Resource Center.
Par défaut, l'opération SearchResources renvoie un maximum de 20 entrées. Vous pouvez spécifier le paramètre MaxResults pour modifier le nombre maximal d'entrées renvoyées.
Si la réponse n'inclut pas de valeur NextToken, il n'y a plus de résultats disponibles. Pour récupérer la page de résultats suivante, incluez la valeur NextToken de la réponse précédente dans votre requête suivante. Si vous ne spécifiez pas le paramètre NextToken, la première page de résultats est renvoyée.
Vous pouvez définir une ou plusieurs conditions de filtrage pour restreindre la portée de la recherche. Pour plus d'informations sur les paramètres de filtrage et les méthodes de correspondance pris en charge, consultez les sections suivantes. Plusieurs conditions de filtrage sont combinées par un AND logique. Seules les ressources répondant à toutes les conditions de filtrage sont renvoyées. Les valeurs au sein d'une condition de filtrage sont combinées par un OR logique. Les ressources répondant à n'importe quelle valeur de la condition de filtrage sont renvoyées.
Pour plus d'exemples de requêtes, consultez l'API 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:SearchResources

list

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
NextToken	string	Non	Le jeton de pagination utilisé dans la requête suivante pour récupérer une nouvelle page de résultats. Vous n'avez pas besoin de spécifier ce paramètre pour la première requête. Vous devez spécifier le jeton obtenu lors de la requête précédente comme valeur de `NextToken`.	eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd****
MaxResults	integer	Non	Le nombre maximal d'entrées par page. Valeurs valides : 1 à 500. Valeur par défaut : 20.	10
Filter	array<object>	Non	Les conditions de filtrage.
	object	Non	La condition de filtrage.
Key	string	Non	La clé de la condition de filtrage. Pour plus d'informations sur les valeurs valides, consultez la section « Paramètres de filtrage pris en charge » ci-dessous.	RegionId
MatchType	string	Non	La méthode de correspondance. Valeurs valides : Equals : Correspondance exacte. Prefix : Correspondance de préfixe. Contains : Contient une valeur. NotContains : Ne contient pas de valeur. Exists : La clé existe. NotExists : La clé n'existe pas.	Equals
Value	array	Non	La valeur de la condition de filtrage.
	string	Non	La valeur de la condition de filtrage.	Valeur de la condition de filtrage
ResourceGroupId	string	Non	L'identifiant du groupe de ressources.	rg-acfmzawhxxc****
SortCriterion	object	Non	Les paramètres de tri.
Key	string	Non	La clé de tri. Définissez ce paramètre sur `CreateTime`, ce qui signifie que les résultats sont triés par heure de création de la ressource.	CreateTime
Order	string	Non	L'ordre de tri. Valeurs valides : ASC : Ordre croissant. DESC : Ordre décroissant. Valeur par défaut : ASC.	ASC
SearchExpression	string	Non	Le mot-clé de recherche. Resource Center filtre et trie les résultats de recherche en fonction de la pertinence. Si vous ne spécifiez pas de paramètre de tri, les ressources qui correspondent le mieux au mot-clé sont affichées en priorité.	mots-clés
IncludeDeletedResources	boolean	Non	Indique si les ressources supprimées doivent être incluses. Valeurs valides : true false	true

Paramètres de filtre pris en charge

Paramètre	Description	Méthodes de correspondance prises en charge
ResourceType	Le type de ressource.	Égal
RegionId	L'identifiant de la région.	Égal
ResourceId	L'identifiant de la ressource.	Égal, Préfixe
ResourceGroupId	L'identifiant du groupe de ressources.	Égal, Existe, N'existe pas
ResourceName	Le nom de la ressource.	Égal, Contient
Tag	La paire clé-valeur d'une balise. La valeur doit être une chaîne JSON au format `{ "key": $key, "value": $value }`. Vous devez spécifier au moins la clé ou la valeur. Par exemple, si vous souhaitez interroger la clé de balise `foo` et la valeur de balise `bar`, définissez ce paramètre sur `{ "key": "foo", "value": "bar" }`. Si vous souhaitez interroger uniquement la clé de balise `foo`, définissez ce paramètre sur `{ "key": "foo" }`.	Contient, Ne contient pas, N'existe pas
VpcId	L'identifiant du VPC.	Égal
VSwitchId	L'identifiant du vSwitch.	Égal
IpAddress	L'adresse IP.	Égal, Contient

É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	La condition de filtrage.
Key	string	La clé de la condition de filtrage.	RegionId
MatchType	string	La méthode de correspondance.	Equals
Values	array	Les valeurs de la condition de filtrage.
	string	La valeur de la condition de filtrage.	cn-hangzhou
MaxResults	integer	Le nombre maximal d'entrées renvoyées par page.	10
NextToken	string	Le jeton de pagination utilisé dans la requête suivante pour récupérer une nouvelle page de résultats.	eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd****
RequestId	string	L'identifiant de la requête.	D696E6EF-3A6D-5770-801E-4982081FE4D0
Resources	array<object>	Les informations sur les ressources.
	array<object>	Les informations sur la ressource.
AccountId	string	L'identifiant du compte Alibaba Cloud.	151266687691****
CreateTime	string	L'heure de création de la ressource. Remarque Le renvoi de ce paramètre dépend du service Alibaba Cloud auquel la ressource appartient.	2021-06-30T09:20:08Z
ExpireTime	string	L'heure d'expiration de la ressource.	2021-07-30T09:20:08Z
IpAddressAttributes	array<object>	Les attributs des adresses IP.
	object	Les attributs de l'adresse IP.
IpAddress	string	The IP address.	192.168.1.2
NetworkType	string	The network type. Valid values: Public: Internet Private: Private network	Public
Version	string	The IP address version.	Ipv4
IpAddresses	array	Les adresses IP. Remarque Le renvoi de ce paramètre dépend du service Alibaba Cloud auquel la ressource appartient.
	string	L'adresse IP. Remarque Le renvoi de ce paramètre dépend du service Alibaba Cloud auquel la ressource appartient.	192.168.1.2
RegionId	string	L'identifiant de la région.	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	La balise.
Key	string	The tag key.	test_key
Value	string	The tag value.	test_value
ZoneId	string	L'identifiant de la zone. Remarque Le renvoi de ce paramètre dépend du service Alibaba Cloud auquel la ressource appartient.	cn-hangzhou-k
Deleted	boolean	Indique si la ressource est supprimée. Valeurs valides : true false	true

Exemples

JSON format

{
  "Filters": [
    {
      "Key": "RegionId",
      "MatchType": "Equals",
      "Values": [
        "cn-hangzhou"
      ]
    }
  ],
  "MaxResults": 10,
  "NextToken": "eyJzZWFyY2hBZnRlcnMiOlsiMTAwMTU2Nzk4MTU1OSJd****\t\n",
  "RequestId": "D696E6EF-3A6D-5770-801E-4982081FE4D0",
  "Resources": [
    {
      "AccountId": "151266687691****",
      "CreateTime": "2021-06-30T09:20:08Z",
      "ExpireTime": "2021-07-30T09:20:08Z",
      "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",
      "Deleted": true
    }
  ]
}

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.	The MaxResults parameter is invalid.
400	InvalidParameter.Filter.ResourceType	The specified parameter value of Filter.ResourceType is not valid.
400	InvalidParameter.Filter.IpAddress	The specified parameter Filter.n.IpAddress is not valid.	The specified parameter Filter.n.IpAddress is not valid.
400	InvalidParameter.Filter.Tag	The specified parameter Filter.n.Tag is not valid.	The specified parameter Filter.n.Tag is not valid.
400	InvalidParameter.Filter.CreateTime	The specified parameter Filter.n.CreateTime is not valid.	The specified parameter Filter.n.CreateTime is not valid.
409	InvalidParameter.SortCriterion.Key	The specified parameter SortCriterion.Key is not valid.
409	ExceedLimit.Filter	The maximum length of Filters is exceeded.	The number of objects specified in the Filter parameter exceeds the upper limit.

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

Notes de version

Consultez Notes de version pour la liste complète.