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

Name In Required Type Description
subscriptionId
path True
  • string

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

api-version
query True
  • string

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

$top
query
  • integer
int32

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

Ответы

Name Type Description
200 OK

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

Other Status Codes

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

Примеры

List DNS forwarding rulesets by subscription

Sample Request

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

Sample Response

{
  "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

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

Name Type Description
error

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

CloudErrorBody

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

Name Type Description
code
  • string

Код ошибки

details

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

message
  • string

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

target
  • string

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

createdByType

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

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

DnsForwardingRuleset

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

Name Type Description
etag
  • string

ETag набора правил пересылки DNS.

id
  • string

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

location
  • string

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

name
  • string

Имя ресурса.

properties.dnsResolverOutboundEndpoints

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

properties.provisioningState

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

properties.resourceGuid
  • string

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

systemData

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

tags
  • object

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

type
  • string

Тип ресурса. Например, Microsoft.Compute/virtualMachines или Microsoft. служба хранилища/storageAccounts"

DnsForwardingRulesetListResult

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

Name Type Description
nextLink
  • string

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

value

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

ProvisioningState

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

Name Type Description
Canceled
  • string
Creating
  • string
Deleting
  • string
Failed
  • string
Succeeded
  • string
Updating
  • string

SubResource

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

Name Type Description
id
  • string

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

systemData

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

Name Type Description
createdAt
  • string

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

createdBy
  • string

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

createdByType

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

lastModifiedAt
  • string

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

lastModifiedBy
  • string

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

lastModifiedByType

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