### Aliyun DNS - Custom Read-Only Policy Example

Source: https://help.aliyun.com/zh/dns/fine-grained-resource-control-using-resource-groups-3

Example of a custom RAM policy allowing all read-only operations that do not support resource group authorization.

```APIDOC
## Aliyun DNS - Custom Read-Only Policy Example

### Description
This is an example of a custom RAM policy designed to grant permissions for all Aliyun DNS read-only operations that do not support resource group-level authorization. For such operations, resource scope must be set to 'Account Level'.

### Method
N/A (Policy definition)

### Endpoint
N/A (Policy definition)

### Parameters
N/A

### Request Example
```json
{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "alidns:CheckDomainRecord",
        "alidns:CheckEdgeDnsClusterConnection",
        "alidns:CheckEdgeDnsClusterDeploymentAppVersion",
        "alidns:CheckEdgeDnsDeploymentAppVersion",
        "alidns:CheckFusionClientAvailable",
        "alidns:CheckGtmInstanceExistence",
        "alidns:CheckInstanceAllowSystemAssign",
        "alidns:CheckSubDomainRecord4Add",
        "alidns:DescribeAccount",
        "alidns:DescribeAlidnsGlobalAlert",
        "alidns:DescribeAlidnsInstances",
        "alidns:DescribeAlidnsPostBusinessStatus",
        "alidns:DescribeAlidnsResolveAnalysisConfig",
        "alidns:DescribeBatchLogs",
        "alidns:DescribeBatchResultCount",
        "alidns:DescribeBatchResultDetail",
        "alidns:DescribeBundleRecordTaskResult",
        "alidns:DescribeBundleTempDomains",
        "alidns:DescribeCanAddMonitorDomainRrs",
        "alidns:DescribeCanAddMonitorSubDomainInfo",
        "alidns:DescribeChangeLogs",
        "alidns:DescribeCloudGtmAddress",
        "alidns:DescribeCloudGtmAddressPool",
        "alidns:DescribeCloudGtmAddressPoolReference",
        "alidns:DescribeCloudGtmAddressReference",
        "alidns:DescribeCloudGtmGlobalAlert",
        "alidns:DescribeCloudGtmInstanceConfigAlert",
        "alidns:DescribeCloudGtmInstanceConfigFullInfo",
        "alidns:DescribeCloudGtmMonitorTemplate",
        "alidns:DescribeCloudGtmResolveAnalysisConfig",
        "alidns:DescribeCloudGtmSummary",
        "alidns:DescribeCloudGtmSystemLines",
        "alidns:DescribeCloudMonitorDetectCountOverview",
        "alidns:DescribeCloudMonitorDetectCountSummary",
        "alidns:DescribeCloudMonitorDetectLogs",
        "alidns:DescribeCloudMonitorGlobalAlertConfig",
        "alidns:DescribeCloudMonitorLatestDetectLogOverview",
        "alidns:DescribeCloudMonitorLatestDetectLogs",
        "alidns:DescribeCloudMonitorTask",
        "alidns:DescribeCloudMonitorTaskAlertConfig",
        "alidns:DescribeCloudMonitorTaskDetectSummary",
        "alidns:DescribeCloudMonitorTaskOverview",
        "alidns:DescribeDnsCacheDomains",
        "alidns:DescribeDnsGtmAddrAttributeInfo",
        "alidns:DescribeDnsGtmAvailableAlertGroup",
        "alidns:DescribeDnsGtmMonitorAvailableConfig",
        "alidns:DescribeDnsMonitor",
        "alidns:DescribeDnsMonitorAvailableNodes",
        "alidns:DescribeDnsMonitorTaskConfig",
        "alidns:DescribeDnsMonitors",
        "alidns:DescribeDnsProductInstance",
        "alidns:DescribeDnsProductInstanceSummary",
        "alidns:DescribeDnsProductInstances",
        "alidns:DescribeDnsTemplateInfo",
        "alidns:DescribeDnsTemplates",
        "alidns:DescribeDnsUserInstancesInfo",
        "alidns:DescribeDohAccountStatistics",
        "alidns:DescribeDohDomainStatistics",
        "alidns:DescribeDohDomainStatisticsSummary",
        "alidns:DescribeDohSdkList",
        "alidns:DescribeDohSubDomainStatistics",
        "alidns:DescribeDohSubDomainStatisticsSummary",
        "alidns:DescribeDohUserInfo",
        "alidns:DescribeDomainBackups",
        "alidns:DescribeDomainGroups",
        "alidns:DescribeDomainLogs",
        "alidns:DescribeDomainResolveStatisticsSummary",
        "alidns:DescribeDomainStatisticsSummary",
        "alidns:DescribeEdgeDnsAppAgentInfo",
        "alidns:DescribeEdgeDnsAppLatestVersion",
        "alidns:DescribeEdgeDnsClusterFullInfo",
        "alidns:DescribeEdgeDnsClusterNodeContainers",
        "alidns:DescribeEdgeDnsClusterNodeServiceStatus",
        "alidns:DescribeEdgeDnsClusterResource",
        "alidns:DescribeEdgeDnsClusterResourceOverview",
        "alidns:DescribeEdgeDnsDeployNotFinalStatusTask",
        "alidns:DescribeEdgeDnsDeployOptionalIp",
        "alidns:DescribeEdgeDnsDeployOptionalVersion",
        "alidns:DescribeEdgeDnsDeployTask",
        "alidns:DescribeEdgeDnsDeploymentInfo",
        "alidns:DescribeEdgeDnsDeploymentStatistics",
        "alidns:DescribeEdgeDnsNodeConnectionToken",
        "alidns:DescribeEdgeDnsNodeFullInfo",
        "alidns:DescribeFusionOnPremisesInstances",
        "alidns:DescribeFusionResources",
        "alidns:DescribeGtmAvailableAlertGroup",
        "alidns:DescribeGtmMonitorAvailableConfig",
        "alidns:DescribeGtmRecoveryPlan",
        "alidns:DescribeGtmRecoveryPlanAvailableConfig",
        "alidns:DescribeGtmRecoveryPlans"
      ]
    }
  ]
}
```

### Response
(Policy definition, not a typical API response)
```

--------------------------------

### GET alidns:DescribeTags

Source: https://help.aliyun.com/zh/dns/fine-grained-resource-control-using-resource-groups-3

This API retrieves a list of existing tags. It helps users manage and categorize their resources.

```APIDOC
## GET alidns:DescribeTags

### Description
This API retrieves a list of existing tags.

### Method
GET

### Endpoint
alidns:DescribeTags

### Parameters
No parameters are required for this endpoint.

### Request Example
No request body is required for this endpoint.

### Response
#### Success Response (200)
- **tags** (array) - A list of existing tags.

#### Response Example
{
  "tags": [
    "tag1",
    "tag2"
  ]
}
```

--------------------------------

### GET alidns:DescribeSupportLines

Source: https://help.aliyun.com/zh/dns/fine-grained-resource-control-using-resource-groups-3

This API retrieves a list of all supported DNS lines. It allows users to understand the available options for DNS resolution.

```APIDOC
## GET alidns:DescribeSupportLines

### Description
This API retrieves a list of all supported DNS lines.

### Method
GET

### Endpoint
alidns:DescribeSupportLines

### Parameters
No parameters are required for this endpoint.

### Request Example
No request body is required for this endpoint.

### Response
#### Success Response (200)
- **lines** (array) - A list of supported DNS lines.

#### Response Example
{
  "lines": [
    "line1",
    "line2"
  ]
}
```

--------------------------------

### GET alidns:GetTxtRecordForVerify

Source: https://help.aliyun.com/zh/dns/fine-grained-resource-control-using-resource-groups-3

This API generates a TXT record. It is used for domain and subdomain retrieval, subdomain verification, and batch retrieval.

```APIDOC
## GET alidns:GetTxtRecordForVerify

### Description
This API generates a TXT record.

### Method
GET

### Endpoint
alidns:GetTxtRecordForVerify

### Parameters
No parameters are required for this endpoint.

### Request Example
No request body is required for this endpoint.

### Response
#### Success Response (200)
- **txtRecord** (string) - The generated TXT record.

#### Response Example
{
  "txtRecord": "some_txt_record_value"
}
```

--------------------------------

### DNS Product Instance Information

Source: https://help.aliyun.com/zh/dns/fine-grained-resource-control-using-resource-groups-3

Retrieve details about Aliyun DNS product instances, including paid versions and their summaries.

```APIDOC
## GET alidns:DescribeDnsProductInstance

### Description
Retrieves the detailed information of a cloud resolution paid version product instance based on the instance ID.

### Method
GET

### Endpoint
/alidns/DescribeDnsProductInstance

### Parameters
#### Query Parameters
- **InstanceId** (string) - Required - The ID of the DNS product instance.
- **Lang** (string) - Optional - The language for the response. Default is 'en'.

### Request Example
```json
{
  "InstanceId": "dns-instance-123"
}
```

### Response
#### Success Response (200)
- **Instance** (object) - The details of the DNS product instance.
  - **InstanceId** (string) - The ID of the instance.
  - **DomainNameCount** (integer) - The number of domains associated with the instance.
  - **VersionName** (string) - The version name of the product.

#### Response Example
```json
{
  "Instance": {
    "InstanceId": "dns-instance-123",
    "DomainNameCount": 100,
    "VersionName": "Professional"
  }
}
```
```

```APIDOC
## GET alidns:DescribeDnsProductInstances

### Description
Retrieves a list of paid version DNS product instances based on the provided parameters.

### Method
GET

### Endpoint
/alidns/DescribeDnsProductInstances

### Parameters
#### Query Parameters
- **PageNumber** (integer) - Optional - The page number of the query results.
- **PageSize** (integer) - Optional - The number of results per page.
- **Lang** (string) - Optional - The language for the response. Default is 'en'.

### Request Example
```json
{
  "PageNumber": 1,
  "PageSize": 10
}
```

### Response
#### Success Response (200)
- **Instances** (array) - A list of DNS product instances.
  - **InstanceId** (string) - The ID of the instance.
  - **VersionName** (string) - The version name of the product.

#### Response Example
```json
{
  "Instances": [
    {
      "InstanceId": "dns-instance-456",
      "VersionName": "Basic"
    }
  ]
}
```
```

--------------------------------

### 方式二：JSON API 接入

Source: https://help.aliyun.com/zh/dns/httpdns-access-configuration

适用于无法使用SDK，需要用原生API方式发起解析请求接入场景。提供了DoH JSON API的URL接口，支持TLS和非TLS。

```APIDOC
## 方式二：JSON API 接入

### Description
适用于无法使用SDK，需要用原生API方式发起解析请求接入场景。DoH JSON API的URL 接口 （提供TLS和非TLS API）。

### Method
GET

### Endpoint
- `https://223.5.5.5/resolve?name=域名&type=记录类型&uid=AccountID&ak=AccessKey ID&key=****&ts=时间戳`
- `http://223.5.5.5/resolve?name=域名&type=记录类型&uid=AccountID&ak=AccessKey ID&key=****&ts=时间戳`
- `https://223.6.6.6/resolve?name=域名&type=记录类型&uid=AccountID&ak=AccessKey ID&key=****&ts=时间戳`
- `http://223.6.6.6/resolve?name=域名&type=记录类型&uid=AccountID&ak=AccessKey ID&key=****&ts=时间戳`

### Parameters
#### Query Parameters
- **name** (string) - Required - 要解析的域名。
- **type** (string) - Required - 要解析的记录类型（如 A, AAAA, CNAME, MX, TXT, NS, PTR, SOA, SRV, SPF）。
- **uid** (string) - Required - 账号ID。
- **ak** (string) - Required - AccessKey ID。
- **key** (string) - Required - AccessKey Secret。
- **ts** (string) - Required - 时间戳。

### Request Example
```json
{
  "example": "https://223.5.5.5/resolve?name=example.com&type=A&uid=12345&ak=AKIDEXAMPLE&key=SECRETKEYEXAMPLE&ts=1678886400"
}
```

### Response
#### Success Response (200)
- **status** (object) - 状态信息。
  - **code** (integer) - 状态码。
  - **message** (string) - 状态消息。
- **data** (object) - 解析结果。
  - **id** (string) - 请求ID。
  - **question** (array) - 查询问题列表。
    - **name** (string) - 域名。
    - **type** (integer) - 记录类型。
  - **answer** (array) - 解析答案列表。
    - **name** (string) - 域名。
    - **type** (integer) - 记录类型。
    - **ttl** (integer) - TTL值。
    - **data** (string) - 记录值。

#### Response Example
```json
{
  "example": {
    "status": {
      "code": 200,
      "message": "Success"
    },
    "data": {
      "id": "1234567890",
      "question": [
        {
          "name": "example.com",
          "type": 1
        }
      ],
      "answer": [
        {
          "name": "example.com",
          "type": 1,
          "ttl": 600,
          "data": "1.2.3.4"
        }
      ]
    }
  }
}
```
```

--------------------------------

### GET alidns:ListCloudGtmAddressPools

Source: https://help.aliyun.com/zh/dns/fine-grained-resource-control-using-resource-groups-3

This API retrieves a list of address pools. It allows users to manage and monitor address pool configurations.

```APIDOC
## GET alidns:ListCloudGtmAddressPools

### Description
This API retrieves a list of address pools.

### Method
GET

### Endpoint
alidns:ListCloudGtmAddressPools

### Parameters
No parameters are required for this endpoint.

### Request Example
No request body is required for this endpoint.

### Response
#### Success Response (200)
- **addressPools** (array) - A list of address pools.

#### Response Example
{
  "addressPools": [
    {
      "poolName": "pool1",
      "poolId": "12345"
    }
  ]
}
```

--------------------------------

### Aliyun DNS - Domain and Meta Management

Source: https://help.aliyun.com/zh/dns/fine-grained-resource-control-using-resource-groups-3

API operations for managing domain-level configurations and metadata.

```APIDOC
## Aliyun DNS - Domain and Meta Management

### Description
API endpoints for creating Top-Level Domain (TLD) metadata and reading domain information.

### Method
POST (for `createTldMeta`), GET (for `read` - assumed)

### Endpoint
- `alidns:createTldMeta`
- `alidns:read`

### Parameters
(Specific parameters for these endpoints are not detailed in the provided text.)

### Request Example
(No request examples provided)

### Response
(No response details provided)
```