ListRecursionZones - - Alibaba Cloud Documentation Center

Queries the zones that are used for recursive resolution of built-in authoritative domain names.

Operation description

Specify at least ResourceId.N or Tag.N (Tag.N.Key and Tag.N.Value) in your request to identify the resources to retrieve.
Tag.N is a resource tag that consists of a key-value pair. If you specify only Tag.N.Key, all tag values associated with the tag key are returned. An error is returned if you specify only Tag.N.Value.
If you specify both Tag.N and ResourceId.N to filter resources, only the resources that are specified by ResourceId.N and match all the specified key-value pairs are returned.
If you specify multiple tag key-value pairs, the resources that match all of them are returned.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

pubdns:ListRecursionZones

list

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
ZoneName	string	No	The name of the zone.	lisheng999.com
Remark	string	No	The remarks.	test
PageNumber	integer	Yes	The current page number. The value starts from 1. The default value is 1.	1
PageSize	integer	Yes	The number of entries to return on each page for a paged query. The maximum value is 100. The default value is 20.	10
MaxResults	integer	No	The maximum number of entries to return for this request.	100
NextToken	string	No	The token to start the next query.	4698691

Response elements

Element	Type	Description	Example
	object
RequestId	string	The unique request ID.	536E9CAD-DB30-4647-AC87-AA5CC38C5382
PageNumber	integer	The current page number. The value starts from 1. The default value is 1.	1
PageSize	integer	The number of entries per page.	5
TotalPages	integer	The total number of pages.	1
TotalItems	integer	The total number of addresses in the address list.	1
Zones	object
Zone	array<object>	The list of zones supported in the current region.
	object	The list of zones supported in the current region.
ZoneId	string	The zone ID. This is the unique identifier of the zone.	173671468000011
CreateTime	string	The time when the zone was created.	2021-03-08T05:45Z
CreateTimestamp	integer	The time when the zone was created. This value is a UNIX timestamp.	1729674680000
UpdateTime	string	The time when the zone was last modified.	2024-11-12T04:30Z
UpdateTimestamp	integer	The time when the zone was last modified. This value is a UNIX timestamp.	1707189878000
ZoneName	string	The name of the zone.	dfsdfsd
Remark	string	The remarks.	107
RecordCount	integer	The number of DNS records in the zone.	8
ProxyPattern	string	Indicates whether subdomain recursive proxy is enabled. Valid values: zone: disabled. If a non-existent subdomain of the current domain name is parsed, the system returns an NXDOMAIN error, which indicates that the subdomain does not exist. record: enabled. If a non-existent subdomain of the current domain name is parsed, the system queries the forwarding and recursion modules in sequence and uses the final query result to respond to the request.	record
Creator	string	The creator.	218497924149333932
CreatorType	string	The type of the creator. Valid values: user and system.	USER
CreatorSubType	string	sts: role assumption other: other	SUB
EffectiveScopes	object
EffectiveScope	array<object>	The resolution scope.
	object
EffectiveType	string	The type of the effective scope. Valid value: account.	account
Scopes	object
Scope	array	The list of resolution scope values.
	string	The effective scope. This parameter corresponds to the effective scope type. The account type corresponds to the list of account IDs for recursive resolution.	20003
MaxResults	integer	The maximum number of entries returned for this request.	100
NextToken	string	The token to start the next query.	4698691

Examples

Success response

JSON format

{
  "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
  "PageNumber": 1,
  "PageSize": 5,
  "TotalPages": 1,
  "TotalItems": 1,
  "Zones": {
    "Zone": [
      {
        "ZoneId": "173671468000011",
        "CreateTime": "2021-03-08T05:45Z",
        "CreateTimestamp": 1729674680000,
        "UpdateTime": "2024-11-12T04:30Z",
        "UpdateTimestamp": 1707189878000,
        "ZoneName": "dfsdfsd",
        "Remark": "107",
        "RecordCount": 8,
        "ProxyPattern": "record",
        "Creator": "218497924149333932",
        "CreatorType": "USER",
        "CreatorSubType": "SUB",
        "EffectiveScopes": {
          "EffectiveScope": [
            {
              "EffectiveType": "account",
              "Scopes": {
                "Scope": [
                  "20003"
                ]
              }
            }
          ]
        }
      }
    ]
  },
  "MaxResults": 100,
  "NextToken": "4698691"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.