SearchRecursionZones - - Centre de documentation Alibaba Cloud

Recherche les zones de noms de domaine faisant autorité intégrées utilisées pour la résolution récursive.

Description de l'opération

Pour récupérer des ressources, vous devez spécifier au moins ResourceId.N ou Tag.N (Tag.N.Key et Tag.N.Value) dans la requête.
Tag.N est une balise de ressource qui se compose d'une paire clé-valeur. Si vous spécifiez uniquement Tag.N.Key, toutes les valeurs de balise associées à cette clé sont renvoyées. Si vous spécifiez uniquement Tag.N.Value, une erreur est renvoyée.
Si vous spécifiez à la fois Tag.N et ResourceId.N, l'opération renvoie uniquement les ressources identifiées par ResourceId.N et qui correspondent à toutes les paires clé-valeur de balise spécifiées.
Si vous spécifiez plusieurs paires clé-valeur de balise, seules les ressources qui correspondent à toutes ces paires sont renvoyées.

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.

pubdns:SearchRecursionZones

list

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
ZoneName	string	Non	Le nom de la zone.	cheng.suow.cc
Remark	string	Non	La remarque pour la zone. La recherche approximative est prise en charge.	test
PageNumber	integer	Oui	Le numéro de page. Les pages commencent à 1. Valeur par défaut : 1.	1
PageSize	integer	Oui	Le nombre d'entrées à renvoyer par page. Valeurs valides : 1 à 100. Valeur par défaut : 20.	5
EffectiveScopes	array<object>	Non	La liste des étendues effectives.
	object	Non	L'étendue effective pour une zone faisant autorité intégrée.
EffectiveType	string	Non	Le type de l'étendue effective. Valeur valide : `account`.	account
Scope	array	Non	Une liste de valeurs d'étendue qui correspondent à l'`EffectiveType` spécifié. Par exemple, si l'`EffectiveType` est défini sur `account`, ce paramètre contient une liste d'identifiants de compte pour les utilisateurs qui utilisent la résolution récursive.	[20003]
	string	Non	Un identifiant de compte.	20003
OrderBy	string	Non	Le champ de tri. Valeurs valides : `UpdateTime` : l'heure de mise à jour de la zone. `RecordCount` : le nombre d'enregistrements DNS.	default
Direction	string	Non	L'ordre de tri. Valeurs valides : `asc` : croissant. `desc` : décroissant.	asc
MaxResults	integer	Non	Le nombre maximal d'entrées à renvoyer. Valeurs valides : 1 à 100. Valeur par défaut : 20.	50
NextToken	string	Non	Le jeton pour récupérer la page de résultats suivante.	4698691

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	536E9CAD-DB30-4647-AC87-AA5CC38C5382
PageNumber	integer	Le numéro de page. Les pages commencent à 1. La valeur par défaut est 1.	1
PageSize	integer	Le nombre d'éléments renvoyés sur chaque page.	20
TotalPages	integer	Le nombre total de pages.	123
TotalItems	integer	Le nombre total d'éléments.	11
Zones	object
Zone	array<object>	La liste des zones.
	array<object>	Les détails d'une zone dans la liste.
ZoneId	string	The unique ID of the zone.	169439170000011
CreateTime	string	The time the zone was created.	2022-10-17T06:13Z
CreateTimestamp	integer	The creation timestamp.	1749694625000
UpdateTime	string	The time the zone was last modified.	2024-08-13T01:44Z
UpdateTimestamp	integer	The last modification timestamp.	1639621006000
ZoneName	string	The name of the zone.	ixiqiu.cn
Remark	string	The remark for the zone.	107
RecordCount	integer	The number of DNS records in the zone.	20
ProxyPattern	string	Indicates whether the recursive proxy for subdomains is enabled. Valid values: `zone`: Disabled. For queries to non-existent subdomains, the system returns an NXDOMAIN response. `record`: Enabled. For queries to non-existent subdomains, the system sequentially queries the forwarding and recursion modules and returns the final result.	record
Creator	string	The ID of the creator.	***
CreatorType	string	The type of the creator. Valid values are `USER` (a user) and `SYSTEM` (the system).	USER
CreatorSubType	string	The creator's account type. `CUSTOMER`: Alibaba Cloud account, `SUB`: RAM user, `STS`: assumed role, `OTHER`: other.	SUB
EffectiveScopes	object
EffectiveScope	array<object>	The resolution scope.
	array<object>
EffectiveType	string	The type of the effective scope. Valid value: `account`.	account
Scopes	object
Scope	array	The scope values. The meaning of these values depends on the `EffectiveType`. If `EffectiveType` is `account`, this parameter lists the account IDs of users who use recursive resolution.	[20003]
	string	An account ID.	20003
MaxResults	integer	Le nombre maximal d'éléments à renvoyer pour cette requête.	20
NextToken	string	Un jeton de pagination utilisé pour récupérer la page de résultats suivante.	4698691

Exemples

JSON format

{
  "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
  "PageNumber": 1,
  "PageSize": 20,
  "TotalPages": 123,
  "TotalItems": 11,
  "Zones": {
    "Zone": [
      {
        "ZoneId": "169439170000011",
        "CreateTime": "2022-10-17T06:13Z",
        "CreateTimestamp": 1749694625000,
        "UpdateTime": "2024-08-13T01:44Z",
        "UpdateTimestamp": 1639621006000,
        "ZoneName": "ixiqiu.cn",
        "Remark": "107",
        "RecordCount": 20,
        "ProxyPattern": "record",
        "Creator": "***",
        "CreatorType": "USER",
        "CreatorSubType": "SUB",
        "EffectiveScopes": {
          "EffectiveScope": [
            {
              "EffectiveType": "account",
              "Scopes": {
                "Scope": [
                  "20003"
                ]
              }
            }
          ]
        }
      }
    ]
  },
  "MaxResults": 20,
  "NextToken": "4698691"
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.