Private Zones - List

Referência

Service:: DNS

API Version:: 2018-09-01

Listas as zonas de DNS Privado em todos os grupos de recursos numa subscrição.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/privateDnsZones?api-version=2018-09-01

With optional parameters:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/privateDnsZones?$top={$top}&api-version=2018-09-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
subscriptionId	path	True	string	Obtém credenciais de subscrição que identificam exclusivamente a subscrição do Microsoft Azure. O ID da subscrição faz parte do URI para cada chamada de serviço.
api-version	query	True	string	Versão da API de Cliente.
$top	query		integer int32	O número máximo de zonas de DNS Privado a devolver. Se não for especificado, devolve até 100 zonas.

Respostas

Name	Tipo	Description
200 OK	PrivateZoneListResult	Com êxito.
Other Status Codes	CloudError	Resposta predefinida. Será desserializado de acordo com a Definição de erro.

Exemplos

GET Private DNS Zone by Subscription

Sample Request

HTTP

GET https://management.azure.com/subscriptions/subscriptionId/providers/Microsoft.Network/privateDnsZones?api-version=2018-09-01

Sample Response

Status code:: 200

{
  "nextLink": "https://management.azure.com/subscriptions/subscriptionId/providers/Microsoft.Network/privateDnsZones?api-version=2018-09-01&$skipToken=skipToken",
  "value": [
    {
      "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com",
      "name": "privatezone1.com",
      "type": "Microsoft.Network/privateDnsZones",
      "location": "global",
      "etag": "00000000-0000-0000-0000-000000000000",
      "properties": {
        "maxNumberOfRecordSets": 5000,
        "numberOfRecordSets": 1,
        "maxNumberOfVirtualNetworkLinks": 100,
        "numberOfVirtualNetworkLinks": 0,
        "maxNumberOfVirtualNetworkLinksWithRegistration": 50,
        "numberOfVirtualNetworkLinksWithRegistration": 0,
        "provisioningState": "Succeeded"
      },
      "tags": {
        "key1": "value1"
      }
    },
    {
      "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup2/providers/Microsoft.Network/privateDnsZones/privatezone2.com",
      "name": "privatezone2.com",
      "type": "Microsoft.Network/privateDnsZones",
      "location": "global",
      "etag": "00000000-0000-0000-0000-000000000000",
      "properties": {
        "maxNumberOfRecordSets": 5000,
        "numberOfRecordSets": 1,
        "maxNumberOfVirtualNetworkLinks": 100,
        "numberOfVirtualNetworkLinks": 0,
        "maxNumberOfVirtualNetworkLinksWithRegistration": 50,
        "numberOfVirtualNetworkLinksWithRegistration": 0,
        "provisioningState": "Succeeded"
      }
    }
  ]
}

Definições

Name	Description
CloudError	Uma resposta de erro do serviço.
CloudErrorBody	Uma resposta de erro do serviço.
PrivateZone	Descreve uma zona DNS Privado.
PrivateZoneListResult	A resposta a uma operação de lista de zonas DNS Privado.
ProvisioningState	O estado de aprovisionamento do recurso. Esta é uma propriedade só de leitura e qualquer tentativa de definir este valor será ignorada.

CloudError

Uma resposta de erro do serviço.

Name	Tipo	Description
error	CloudErrorBody	Corpo do erro da cloud.

CloudErrorBody

Uma resposta de erro do serviço.

Name	Tipo	Description
code	string	Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente.
details	CloudErrorBody[]	Uma lista de detalhes adicionais sobre o erro.
message	string	Uma mensagem que descreve o erro, destinada a ser adequada para ser apresentada numa interface de utilizador.
target	string	O destino do erro específico. Por exemplo, o nome da propriedade em erro.

PrivateZone

Descreve uma zona DNS Privado.

Name	Tipo	Description
etag	string	O ETag da zona.
id	string	ID de recurso completamente qualificado para o recurso. Exemplo – "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateDnsZoneName}".
location	string	A Região do Azure onde o recurso reside
name	string	O nome do recurso
properties.maxNumberOfRecordSets	integer	O número máximo de conjuntos de registos que podem ser criados nesta zona de DNS Privado. Esta é uma propriedade só de leitura e qualquer tentativa de definir este valor será ignorada.
properties.maxNumberOfVirtualNetworkLinks	integer	O número máximo de redes virtuais que podem ser ligadas a esta zona de DNS Privado. Esta é uma propriedade só de leitura e qualquer tentativa de definir este valor será ignorada.
properties.maxNumberOfVirtualNetworkLinksWithRegistration	integer	O número máximo de redes virtuais que podem ser ligadas a esta zona de DNS Privado com o registo ativado. Esta é uma propriedade só de leitura e qualquer tentativa de definir este valor será ignorada.
properties.numberOfRecordSets	integer	O número atual de conjuntos de registos nesta zona de DNS Privado. Esta é uma propriedade só de leitura e qualquer tentativa de definir este valor será ignorada.
properties.numberOfVirtualNetworkLinks	integer	O número atual de redes virtuais que estão ligadas a esta zona de DNS Privado. Esta é uma propriedade só de leitura e qualquer tentativa de definir este valor será ignorada.
properties.numberOfVirtualNetworkLinksWithRegistration	integer	O número atual de redes virtuais que estão ligadas a esta zona de DNS Privado com o registo ativado. Esta é uma propriedade só de leitura e qualquer tentativa de definir este valor será ignorada.
properties.provisioningState	ProvisioningState	O estado de aprovisionamento do recurso. Esta é uma propriedade só de leitura e qualquer tentativa de definir este valor será ignorada.
tags	object	Etiquetas de recursos.
type	string	O tipo de recurso. Exemplo – "Microsoft.Network/privateDnsZones".

PrivateZoneListResult

A resposta a uma operação de lista de zonas DNS Privado.

Name	Tipo	Description
nextLink	string	O token de continuação para a próxima página de resultados.
value	PrivateZone[]	Informações sobre as zonas de DNS Privado.

ProvisioningState

O estado de aprovisionamento do recurso. Esta é uma propriedade só de leitura e qualquer tentativa de definir este valor será ignorada.

Name	Tipo	Description
Canceled	string
Creating	string
Deleting	string
Failed	string
Succeeded	string
Updating	string