Private Zones - Get

Serviço:

DNS

Versão da API:

2018-09-01

Obtém uma zona DNS privada. Recupera as propriedades da zona, mas não os links de redes virtuais ou os conjuntos de registros dentro da zona.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
privateZoneName	path	True	string	O nome da zona DNS privada (sem um ponto de encerramento).
resourceGroupName	path	True	string	O nome do grupo de recursos.
subscriptionId	path	True	string	Obtém credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. O ID da assinatura faz parte do URI de cada chamada de serviço.
api-version	query	True	string	Versão da API do cliente.

Respostas

Name	Tipo	Description
200 OK	PrivateZone	Sucesso.
Other Status Codes	CloudError	Resposta padrão. Ele será desserializado de acordo com a definição de erro.

Exemplos

GET Private DNS Zone

Pedido de amostra

HTTP

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

Resposta da amostra

Código de estado:

200

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

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 privada.
ProvisioningState	O estado de provisionamento do recurso. Esta é uma propriedade somente leitura e qualquer tentativa de definir esse valor será ignorada.

CloudError

Object

Uma resposta de erro do serviço.

Name	Tipo	Description
error	CloudErrorBody	Corpo do erro na nuvem.

CloudErrorBody

Object

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 descrevendo o erro, destinada a ser adequada para exibição em uma interface do usuário.
target	string	O alvo do erro específico. Por exemplo, o nome da propriedade em erro.

PrivateZone

Object

Descreve uma zona DNS privada.

Name	Tipo	Description
etag	string	O ETag da zona.
id	string	ID do recurso totalmente 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 (int64)	O número máximo de conjuntos de registos que podem ser criados nesta zona DNS privada. Esta é uma propriedade somente leitura e qualquer tentativa de definir esse valor será ignorada.
properties.maxNumberOfVirtualNetworkLinks	integer (int64)	O número máximo de redes virtuais que podem ser vinculadas a essa zona DNS privada. Esta é uma propriedade somente leitura e qualquer tentativa de definir esse valor será ignorada.
properties.maxNumberOfVirtualNetworkLinksWithRegistration	integer (int64)	O número máximo de redes virtuais que podem ser vinculadas a essa zona DNS privada com o registro habilitado. Esta é uma propriedade somente leitura e qualquer tentativa de definir esse valor será ignorada.
properties.numberOfRecordSets	integer (int64)	O número atual de conjuntos de registros nesta zona DNS privada. Esta é uma propriedade somente leitura e qualquer tentativa de definir esse valor será ignorada.
properties.numberOfVirtualNetworkLinks	integer (int64)	O número atual de redes virtuais vinculadas a essa zona DNS privada. Esta é uma propriedade somente leitura e qualquer tentativa de definir esse valor será ignorada.
properties.numberOfVirtualNetworkLinksWithRegistration	integer (int64)	O número atual de redes virtuais vinculadas a essa zona DNS privada com registro habilitado. Esta é uma propriedade somente leitura e qualquer tentativa de definir esse valor será ignorada.
properties.provisioningState	ProvisioningState	O estado de provisionamento do recurso. Esta é uma propriedade somente leitura e qualquer tentativa de definir esse valor será ignorada.
tags	object	Tags de recursos.
type	string	O tipo do recurso. Exemplo - 'Microsoft.Network/privateDnsZones'.

ProvisioningState

Enumeração

O estado de provisionamento do recurso. Esta é uma propriedade somente leitura e qualquer tentativa de definir esse valor será ignorada.

Valor	Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating