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
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
subscription
|
path | True |
string |
Идентификатор целевой подписки. |
api-version
|
query | True |
string |
Версия API, используемая для данной операции. |
$top
|
query |
integer int32 |
Максимальное количество отображаемых результатов. Если значение не указано, возвращает до 100 результатов. |
Ответы
Имя | Тип | Описание |
---|---|---|
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"
}
Определения
Имя | Описание |
---|---|
Cloud |
Сообщение об ошибке |
Cloud |
Текст сообщения об ошибке |
created |
Тип удостоверения, создавшего ресурс. |
Dns |
Описывает набор правил перенаправления DNS. |
Dns |
Ответ на операцию перечисления для наборов правил перенаправления DNS. |
Provisioning |
Текущее состояние подготовки ресурса. |
Sub |
Ссылка на другой ресурс ARM. |
system |
Метаданные, относящиеся к созданию и последнему изменению ресурса. |
CloudError
Сообщение об ошибке
Имя | Тип | Описание |
---|---|---|
error |
Текст сообщения об ошибке |
CloudErrorBody
Текст сообщения об ошибке
Имя | Тип | Описание |
---|---|---|
code |
string |
Код ошибки |
details |
Дополнительные сведения об ошибке |
|
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 |
Ссылка на исходящие конечные точки сопоставителя DNS, которые используются для маршрутизации ЗАПРОСОВ DNS, соответствующих правилам пересылки в наборе правил, на целевые DNS-серверы. |
|
properties.provisioningState |
Текущее состояние подготовки набора правил перенаправления DNS. Это свойство доступно только для чтения, и любая попытка задать это значение будет игнорироваться. |
|
properties.resourceGuid |
string |
ResourceGuid для набора правил переадресации DNS. |
systemData |
Метаданные, относящиеся к созданию и последнему изменению ресурса. |
|
tags |
object |
Теги ресурсов. |
type |
string |
Тип ресурса. Например, Microsoft.Compute/virtualMachines или Microsoft.Storage/storageAccounts. |
DnsForwardingRulesetListResult
Ответ на операцию перечисления для наборов правил перенаправления DNS.
Имя | Тип | Описание |
---|---|---|
nextLink |
string |
Маркер продолжения для следующей страницы результатов. |
value |
Перечисление наборов правил перенаправления 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 |
Тип удостоверения, создавшего ресурс. |
|
lastModifiedAt |
string |
Метка времени последнего изменения ресурса (UTC) |
lastModifiedBy |
string |
Удостоверение, которое последним изменял ресурс. |
lastModifiedByType |
Тип удостоверения, которое последним изменял ресурс. |