Inbound Endpoints - Create Or Update

Referencia

Servicio:: DNS

Versión de la API:: 2025-05-01

Crea o actualiza un punto de conexión de entrada para una resolución DNS.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsResolvers/{dnsResolverName}/inboundEndpoints/{inboundEndpointName}?api-version=2025-05-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
dnsResolverName	path	True	string	Nombre del solucionador DNS.
inboundEndpointName	path	True	string	Nombre del punto de conexión de entrada para la resolución DNS.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
If-Match		string	ETag del recurso. Omita este valor para sobrescribir siempre el recurso actual. Especifique el valor de ETag visto por última vez para evitar que se sobrescriba accidentalmente cualquier cambio simultáneo.
If-None-Match		string	Establézcalo en "*" para permitir la creación de un nuevo recurso, pero evitar la actualización de un recurso existente. Se omitirán otros valores.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
location	True	string	Ubicación geográfica donde reside el recurso
properties.ipConfigurations	True	IpConfiguration[]	Configuraciones de IP para el punto de conexión de entrada.
tags		object	Etiquetas de recursos.

Respuestas

Nombre	Tipo	Description
200 OK	InboundEndpoint	Se ha actualizado el punto de conexión de entrada para la resolución de DNS.
201 Created	InboundEndpoint	Se ha creado el punto de conexión de entrada para el solucionador de DNS.
202 Accepted		La operación para upsert el punto de conexión de entrada para el solucionador de DNS se ha aceptado y se completará de forma asincrónica.
Other Status Codes	CloudError	Respuesta predeterminada. Se deserializará según la definición de error.

Ejemplos

Upsert inbound endpoint for DNS resolver

Solicitud de ejemplo

HTTP

PUT https://management.azure.com/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/dnsResolvers/sampleDnsResolver/inboundEndpoints/sampleInboundEndpoint?api-version=2025-05-01

{
  "tags": {
    "key1": "value1"
  },
  "location": "westus2",
  "properties": {
    "ipConfigurations": [
      {
        "subnet": {
          "id": "/subscriptions/0403cfa9-9659-4f33-9f30-1f191c51d111/resourceGroups/sampleVnetResourceGroupName/providers/Microsoft.Network/virtualNetworks/sampleVirtualNetwork/subnets/sampleSubnet"
        },
        "privateIpAllocationMethod": "Dynamic"
      }
    ]
  }
}

Respuesta de muestra

status code:: 201

{
  "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/inboundEndpoints/sampleInboundEndpoint",
  "name": "sampleInboundEndpoint",
  "type": "Microsoft.Network/dnsResolvers/inboundEndpoints",
  "tags": {
    "key1": "value1"
  },
  "location": "westus2",
  "etag": "00000000-0000-0000-0000-000000000000",
  "systemData": {
    "createdByType": "Application",
    "createdAt": "2021-04-01T01:01:01.1075056Z",
    "lastModifiedByType": "Application",
    "lastModifiedAt": "2021-04-02T02:03:01.1974346Z"
  },
  "properties": {
    "ipConfigurations": [
      {
        "subnet": {
          "id": "/subscriptions/0403cfa9-9659-4f33-9f30-1f191c51d111/resourceGroups/sampleVnetResourceGroupName/providers/Microsoft.Network/virtualNetworks/sampleVirtualNetwork/subnets/sampleSubnet"
        },
        "privateIpAddress": "255.255.255.255",
        "privateIpAllocationMethod": "Dynamic"
      }
    ],
    "provisioningState": "Succeeded",
    "resourceGuid": "b6b2d964-8588-4e3a-a7fe-8a5b7fe8eca5"
  }
}

status code:: 200

{
  "id": "/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/inboundEndpoints/sampleInboundEndpoint",
  "name": "sampleInboundEndpoint",
  "type": "Microsoft.Network/dnsResolvers/inboundEndpoints",
  "tags": {
    "key1": "value1"
  },
  "location": "westus2",
  "etag": "00000000-0000-0000-0000-000000000000",
  "systemData": {
    "createdByType": "Application",
    "createdAt": "2021-04-01T01:01:01.1075056Z",
    "lastModifiedByType": "Application",
    "lastModifiedAt": "2021-04-02T02:03:01.1974346Z"
  },
  "properties": {
    "ipConfigurations": [
      {
        "subnet": {
          "id": "/subscriptions/0403cfa9-9659-4f33-9f30-1f191c51d111/resourceGroups/sampleVnetResourceGroupName/providers/Microsoft.Network/virtualNetworks/sampleVirtualNetwork/subnets/sampleSubnet"
        },
        "privateIpAddress": "255.255.255.255",
        "privateIpAllocationMethod": "Dynamic"
      }
    ],
    "provisioningState": "Succeeded",
    "resourceGuid": "87b3e20a-5833-4c40-8ad7-c5160bb1c5bd"
  }
}

status code:: 202

Location: https://management.azure.com/api/mresolver/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/locations/westus2/dnsResolverOperationResults/asyncOperationId?api-version=2025-05-01
Azure-AsyncOperation: https://management.azure.com/api/mresolver/subscriptions/abdd4249-9f34-4cc6-8e42-c2e32110603e/resourceGroups/sampleResourceGroup/providers/Microsoft.Network/locations/westus2/dnsResolverOperationStatuses/asyncOperationId?api-version=2025-05-01

Definiciones

Nombre	Description
CloudError	Mensaje de error
CloudErrorBody	Cuerpo de un mensaje de error
createdByType	Tipo de identidad que creó el recurso.
InboundEndpoint	Describe un punto de conexión de entrada para una resolución DNS.
IpAllocationMethod	Método de asignación de direcciones IP privadas.
IpConfiguration	Configuración de IP.
ProvisioningState	El estado de aprovisionamiento actual del recurso.
SubResource	Referencia a otro recurso de ARM.
systemData	Metadatos relativos a la creación y última modificación del recurso.

CloudError

Object

Mensaje de error

Nombre	Tipo	Description
error	CloudErrorBody	Cuerpo del mensaje de error

CloudErrorBody

Object

Cuerpo de un mensaje de error

Nombre	Tipo	Description
code	string	El código de error
details	CloudErrorBody[]	Información adicional de error
message	string	Descripción de lo que provocó el error
target	string	Recurso de destino del mensaje de error

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
Application
Key
ManagedIdentity
User

InboundEndpoint

Object

Describe un punto de conexión de entrada para una resolución DNS.

Nombre	Tipo	Description
etag	string	ETag del punto de conexión de entrada.
id	string (arm-id)	Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Ubicación geográfica donde reside el recurso
name	string	Nombre del recurso
properties.ipConfigurations	IpConfiguration[]	Configuraciones de IP para el punto de conexión de entrada.
properties.provisioningState	ProvisioningState	Estado de aprovisionamiento actual del punto de conexión de entrada. Se trata de una propiedad de solo lectura y se omitirá cualquier intento de establecer este valor.
properties.resourceGuid	string	La propiedad resourceGuid del recurso de punto de conexión de entrada.
systemData	systemData	Metadatos relativos a la creación y última modificación del recurso.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

IpAllocationMethod

Enumeración

Método de asignación de direcciones IP privadas.

Valor	Description
Dynamic
Static

IpConfiguration

Object

Configuración de IP.

Nombre	Tipo	Valor predeterminado	Description
privateIpAddress	string		Dirección IP privada de la configuración de IP.
privateIpAllocationMethod	IpAllocationMethod	Dynamic	Método de asignación de direcciones IP privadas.
subnet	SubResource		Referencia a la subred enlazada a la configuración de IP.

ProvisioningState

Enumeración

El estado de aprovisionamiento actual del recurso.

Valor	Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating

SubResource

Object

Referencia a otro recurso de ARM.

Nombre	Tipo	Description
id	string	Identificador de recurso.

systemData

Object

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

Compartir a través de

Inbound Endpoints - Create Or Update

Parámetros de identificador URI

Encabezado de la solicitud

Cuerpo de la solicitud

Respuestas

Ejemplos

Upsert inbound endpoint for DNS resolver

Solicitud de ejemplo

Respuesta de muestra

Definiciones

CloudError

CloudErrorBody

createdByType

InboundEndpoint

IpAllocationMethod

IpConfiguration

ProvisioningState

SubResource

systemData