Поделиться через


Dns Forwarding Rulesets - List

Списки наборы правил перенаправления DNS во всех группах ресурсов подписки.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/dnsForwardingRulesets?api-version=2020-04-01-preview
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/dnsForwardingRulesets?api-version=2020-04-01-preview&$top={$top}

Параметры URI

Имя В Обязательно Тип Описание
subscriptionId
path True

string

Идентификатор целевой подписки.

api-version
query True

string

Версия API, используемая для данной операции.

$top
query

integer

int32

Максимальное количество отображаемых результатов. Если значение не указано, возвращает до 100 результатов.

Ответы

Имя Тип Описание
200 OK

DnsForwardingRulesetListResult

Список наборов правил перенаправления DNS в подписке.

Other Status Codes

CloudError

Ответ по умолчанию. Он будет десериализован в определении Ошибки.

Примеры

List DNS forwarding rulesets by subscription

Образец запроса

GET https://management.azure.com/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/providers/Microsoft.Network/dnsForwardingRulesets?api-version=2020-04-01-preview

Пример ответа

{
  "value": [
    {
      "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsForwardingRulesets/sampleDnsForwardingRuleset",
      "name": "sampleDnsForwardingRuleset",
      "type": "Microsoft.Network/dnsForwardingRulesets",
      "tags": {
        "key1": "value1"
      },
      "systemData": {
        "createdByType": "Application",
        "createdAt": "2021-04-03T01:01:01.1075056Z",
        "lastModifiedByType": "Application",
        "lastModifiedAt": "2021-04-04T02:03:01.1974346Z"
      },
      "location": "westus2",
      "etag": "00000000-0000-0000-0000-000000000000",
      "properties": {
        "dnsResolverOutboundEndpoints": [
          {
            "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver/outboundEndpoints/sampleOutboundEndpoint0"
          },
          {
            "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver/outboundEndpoints/sampleOutboundEndpoint1"
          }
        ],
        "provisioningState": "Succeeded",
        "resourceGuid": "a7e1a32c-498c-401c-a805-5bc3518257b8"
      }
    },
    {
      "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsForwardingRulesets/sampleDnsForwardingRuleset1",
      "name": "sampleDnsForwardingRuleset",
      "type": "Microsoft.Network/dnsForwardingRulesets",
      "tags": {
        "key1": "value1"
      },
      "systemData": {
        "createdByType": "Application",
        "createdAt": "2021-04-04T01:01:01.1075056Z",
        "lastModifiedByType": "Application",
        "lastModifiedAt": "2021-04-05T02:03:01.1974346Z"
      },
      "location": "westus2",
      "etag": "00000000-0000-0000-0000-000000000000",
      "properties": {
        "dnsResolverOutboundEndpoints": [
          {
            "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver/outboundEndpoints/sampleOutboundEndpoint2"
          },
          {
            "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver/outboundEndpoints/sampleOutboundEndpoint3"
          }
        ],
        "provisioningState": "Succeeded",
        "resourceGuid": "a7e1a32c-498c-401c-a805-5bc3518257b8"
      }
    }
  ],
  "nextLink": "https://management.azure.com/api/mresolver/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/providers/Microsoft.Network/dnsForwardingRulesets?$skipToken=skipToken&api-version=2020-04-01-preview"
}

Определения

Имя Описание
CloudError

Сообщение об ошибке

CloudErrorBody

Текст сообщения об ошибке

createdByType

Тип удостоверения, создавшего ресурс.

DnsForwardingRuleset

Описывает набор правил перенаправления DNS.

DnsForwardingRulesetListResult

Ответ на операцию перечисления для наборов правил перенаправления DNS.

ProvisioningState

Текущее состояние подготовки ресурса.

SubResource

Ссылка на другой ресурс ARM.

systemData

Метаданные, относящиеся к созданию и последнему изменению ресурса.

CloudError

Сообщение об ошибке

Имя Тип Описание
error

CloudErrorBody

Текст сообщения об ошибке

CloudErrorBody

Текст сообщения об ошибке

Имя Тип Описание
code

string

Код ошибки

details

CloudErrorBody[]

Дополнительные сведения об ошибке

message

string

Описание причины ошибки

target

string

Целевой ресурс сообщения об ошибке

createdByType

Тип удостоверения, создавшего ресурс.

Имя Тип Описание
Application

string

Key

string

ManagedIdentity

string

User

string

DnsForwardingRuleset

Описывает набор правил перенаправления DNS.

Имя Тип Описание
etag

string

ETag набора правил перенаправления DNS.

id

string

Полный идентификатор ресурса. Например: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Географическое расположение, в котором находится ресурс

name

string

Имя ресурса.

properties.dnsResolverOutboundEndpoints

SubResource[]

Ссылка на исходящие конечные точки сопоставителя DNS, которые используются для маршрутизации ЗАПРОСОВ DNS, соответствующих правилам пересылки в наборе правил, на целевые DNS-серверы.

properties.provisioningState

ProvisioningState

Текущее состояние подготовки набора правил перенаправления DNS. Это свойство доступно только для чтения, и любая попытка задать это значение будет игнорироваться.

properties.resourceGuid

string

ResourceGuid для набора правил переадресации DNS.

systemData

systemData

Метаданные, относящиеся к созданию и последнему изменению ресурса.

tags

object

Теги ресурсов.

type

string

Тип ресурса. Например, Microsoft.Compute/virtualMachines или Microsoft.Storage/storageAccounts.

DnsForwardingRulesetListResult

Ответ на операцию перечисления для наборов правил перенаправления DNS.

Имя Тип Описание
nextLink

string

Маркер продолжения для следующей страницы результатов.

value

DnsForwardingRuleset[]

Перечисление наборов правил перенаправления DNS.

ProvisioningState

Текущее состояние подготовки ресурса.

Имя Тип Описание
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

SubResource

Ссылка на другой ресурс ARM.

Имя Тип Описание
id

string

Идентификатор ресурса.

systemData

Метаданные, относящиеся к созданию и последнему изменению ресурса.

Имя Тип Описание
createdAt

string

Метка времени создания ресурса (UTC).

createdBy

string

Удостоверение, создающее ресурс.

createdByType

createdByType

Тип удостоверения, создавшего ресурс.

lastModifiedAt

string

Метка времени последнего изменения ресурса (UTC)

lastModifiedBy

string

Удостоверение, которое последним изменял ресурс.

lastModifiedByType

createdByType

Тип удостоверения, которое последним изменял ресурс.