Private Zones - Create Or Update

Referência

Service:: DNS

API Version:: 2018-09-01

Cria ou atualiza uma zona de DNS Privado. Não modifica ligações para redes virtuais ou registos DNS dentro da zona.

PUT 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 de DNS Privado (sem um ponto de terminação).
resourceGroupName	path	True	string	O nome do grupo de recursos.
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 do Cliente.

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
If-Match		string	A ETag da zona de DNS Privado. Omita este valor para substituir sempre a zona atual. Especifique o valor de ETag visto pela última vez para evitar substituir acidentalmente quaisquer alterações simultâneas.
If-None-Match		string	Defina como '*' para permitir a criação de uma nova zona de DNS Privado, mas para impedir a atualização de uma zona existente. Outros valores serão ignorados.

Corpo do Pedido

Name	Tipo	Description
etag	string	A ETag da zona.
location	string	A Região do Azure onde reside o recurso
tags	object	Etiquetas de recursos.

Respostas

Name	Tipo	Description
200 OK	PrivateZone	A zona de DNS Privado foi atualizada.
201 Created	PrivateZone	A zona de DNS Privado foi criada.
202 Accepted		A operação DNS Privado upsert de zona foi aceite e será concluída de forma assíncrona.
Other Status Codes	CloudError	Resposta predefinida. Será desserializada de acordo com a Definição de erro.

Exemplos

PUT Private DNS Zone

Sample Request

HTTP

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

{
  "location": "Global",
  "tags": {
    "key1": "value1"
  }
}

Sample Response

Status code:: 201

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

Status code:: 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"
  }
}

Status code:: 202

Location: https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsOperationResults/asyncOperationId?api-version=2018-09-01
Azure-AsyncOperation: https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsOperationStatuses/asyncOperationId?api-version=2018-09-01
Retry-After: 60

Definições

Name	Description
CloudError	Uma resposta de erro do serviço.
CloudErrorBody	Uma resposta de erro do serviço.
PrivateZone	Descreve uma zona 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.

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, que se destina 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 de DNS Privado.

Name	Tipo	Description
etag	string	A 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 reside o recurso
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 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 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 do recurso. Exemplo : "Microsoft.Network/privateDnsZones".

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

Private Zones - Create Or Update

Parâmetros do URI

Cabeçalho do Pedido

Corpo do Pedido

Respostas

Exemplos

PUT Private DNS Zone

Sample Request

Sample Response

Definições

CloudError

CloudErrorBody

PrivateZone

ProvisioningState

Recursos adicionais