Inbound Endpoints - Create Or Update

Szolgáltatás:: DNS

API-verzió:: 2025-05-01

Létrehoz vagy frissít egy bejövő végpontot egy DNS-feloldó számára.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
dnsResolverName	path	True	string	A DNS-feloldó neve.
inboundEndpointName	path	True	string	A DNS-feloldó bejövő végpontjának neve.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string (uuid)	A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérelem fejléce

Name	Kötelező	Típus	Description
If-Match		string	Az erőforrás ETagje. Hagyja ki ezt az értéket, hogy mindig felülírja az aktuális erőforrást. Adja meg az utolsóként látott ETag értéket, hogy megakadályozza az egyidejű módosítások véletlen felülírását.
If-None-Match		string	Állítsa a "*" értékre egy új erőforrás létrehozásának engedélyezéséhez, de egy meglévő erőforrás frissítésének megakadályozásához. A program figyelmen kívül hagyja az egyéb értékeket.

Kérelem törzse

Name	Kötelező	Típus	Description
location	True	string	Az a földrajzi hely, ahol az erőforrás él
properties.ipConfigurations	True	IpConfiguration[]	A bejövő végpont IP-konfigurációi.
tags		object	Erőforráscímkék.

Válaszok

Name	Típus	Description
200 OK	InboundEndpoint	Frissült a DNS-feloldó bejövő végpontja.
201 Created	InboundEndpoint	Létrejött a DNS-feloldó bejövő végpontja.
202 Accepted		A DNS-feloldó upsert bejövő végpontjának művelete el lett fogadva, és aszinkron módon fejeződik be.
Other Status Codes	CloudError	Alapértelmezett válasz. A hibadefiníciónak megfelelően deszerializálja.

Példák

Upsert inbound endpoint for DNS resolver

Mintakérelem

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


import com.azure.core.management.SubResource;
import com.azure.resourcemanager.dnsresolver.models.IpAllocationMethod;
import com.azure.resourcemanager.dnsresolver.models.IpConfiguration;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for InboundEndpoints CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/dnsresolver/resource-manager/Microsoft.Network/stable/2025-05-01/examples/InboundEndpoint_Put.json
     */
    /**
     * Sample code: Upsert inbound endpoint for DNS resolver.
     * 
     * @param manager Entry point to DnsResolverManager.
     */
    public static void
        upsertInboundEndpointForDNSResolver(com.azure.resourcemanager.dnsresolver.DnsResolverManager manager) {
        manager.inboundEndpoints().define("sampleInboundEndpoint").withRegion("westus2")
            .withExistingDnsResolver("sampleResourceGroup", "sampleDnsResolver")
            .withIpConfigurations(Arrays.asList(new IpConfiguration().withSubnet(new SubResource().withId(
                "/subscriptions/0403cfa9-9659-4f33-9f30-1f191c51d111/resourceGroups/sampleVnetResourceGroupName/providers/Microsoft.Network/virtualNetworks/sampleVirtualNetwork/subnets/sampleSubnet"))
                .withPrivateIpAllocationMethod(IpAllocationMethod.DYNAMIC)))
            .withTags(mapOf("key1", "fakeTokenPlaceholder")).create();
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from azure.identity import DefaultAzureCredential

from azure.mgmt.dnsresolver import DnsResolverManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-dnsresolver
# USAGE
    python inbound_endpoint_put.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = DnsResolverManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="abdd4249-9f34-4cc6-8e42-c2e32110603e",
    )

    response = client.inbound_endpoints.begin_create_or_update(
        resource_group_name="sampleResourceGroup",
        dns_resolver_name="sampleDnsResolver",
        inbound_endpoint_name="sampleInboundEndpoint",
        parameters={
            "location": "westus2",
            "properties": {
                "ipConfigurations": [
                    {
                        "privateIpAllocationMethod": "Dynamic",
                        "subnet": {
                            "id": "/subscriptions/0403cfa9-9659-4f33-9f30-1f191c51d111/resourceGroups/sampleVnetResourceGroupName/providers/Microsoft.Network/virtualNetworks/sampleVirtualNetwork/subnets/sampleSubnet"
                        },
                    }
                ]
            },
            "tags": {"key1": "value1"},
        },
    ).result()
    print(response)


# x-ms-original-file: specification/dnsresolver/resource-manager/Microsoft.Network/stable/2025-05-01/examples/InboundEndpoint_Put.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Mintaválasz

Állapotkód:: 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"
  }
}

Állapotkód:: 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"
  }
}

Állapotkód:: 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

Definíciók

Name	Description
CloudError	Hibaüzenet
CloudErrorBody	Egy hibaüzenet törzse
createdByType	Az erőforrást létrehozó identitás típusa.
InboundEndpoint	Egy DNS-feloldó bejövő végpontjának leírása.
IpAllocationMethod	Privát IP-címfoglalási módszer.
IpConfiguration	IP-konfiguráció.
ProvisioningState	Az erőforrás aktuális kiépítési állapota.
SubResource	Hivatkozás egy másik ARM-erőforrásra.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

CloudError

Objektum

Hibaüzenet

Name	Típus	Description
error	CloudErrorBody	A hibaüzenet törzse

CloudErrorBody

Objektum

Egy hibaüzenet törzse

Name	Típus	Description
code	string	A hibakód
details	CloudErrorBody[]	További hibainformációk
message	string	A hiba okainak leírása
target	string	A hibaüzenet célerőforrása

createdByType

Enumerálás

Az erőforrást létrehozó identitás típusa.

Érték	Description
Application
Key
ManagedIdentity
User

InboundEndpoint

Objektum

Egy DNS-feloldó bejövő végpontjának leírása.

Name	Típus	Description
etag	string	A bejövő végpont ETagje.
id	string (arm-id)	Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Az a földrajzi hely, ahol az erőforrás él
name	string	Az erőforrás neve
properties.ipConfigurations	IpConfiguration[]	A bejövő végpont IP-konfigurációi.
properties.provisioningState	ProvisioningState	A bejövő végpont aktuális kiépítési állapota. Ez egy írásvédett tulajdonság, és az érték beállítására tett kísérletek figyelmen kívül lesznek hagyva.
properties.resourceGuid	string	A bejövő végponterőforrás resourceGuid tulajdonsága.
systemData	systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
tags	object	Erőforráscímkék.
type	string	Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

IpAllocationMethod

Enumerálás

Privát IP-címfoglalási módszer.

Érték	Description
Dynamic
Static

IpConfiguration

Objektum

IP-konfiguráció.

Name	Típus	Alapértelmezett érték	Description
privateIpAddress	string		Az IP-konfiguráció privát IP-címe.
privateIpAllocationMethod	IpAllocationMethod	Dynamic	Privát IP-címfoglalási módszer.
subnet	SubResource		Az IP-konfigurációhoz kötött alhálózatra mutató hivatkozás.

ProvisioningState

Enumerálás

Az erőforrás aktuális kiépítési állapota.

Érték	Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating

SubResource

Objektum

Hivatkozás egy másik ARM-erőforrásra.

Name	Típus	Description
id	string	Erőforrás-azonosító.

systemData

Objektum

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name	Típus	Description
createdAt	string (date-time)	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string (date-time)	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást legutóbb módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.

Megosztás a következőn keresztül:

Inbound Endpoints - Create Or Update

URI-paraméterek

Kérelem fejléce

Kérelem törzse

Válaszok

Példák

Upsert inbound endpoint for DNS resolver

Mintakérelem

Mintaválasz

Definíciók

CloudError

CloudErrorBody

createdByType

InboundEndpoint

IpAllocationMethod

IpConfiguration

ProvisioningState

SubResource

systemData