Compartir a través de

Creación de conjuntos de registros y zonas DNS con el SDK de .NET

  • Artículo

Puede automatizar las operaciones para crear, eliminar o actualizar zonas, conjuntos de registros y registros de DNS mediante el SDK de DNS con la biblioteca de administración de DNS de .NET. Un proyecto completo de Visual Studio se encuentra disponible aquí.

Creación de una cuenta de entidad de servicio

Normalmente, el acceso a recursos de Azure mediante programación se concede con una cuenta dedicada en lugar de por medio de sus propias credenciales de usuario. Estas cuentas dedicadas se denominan cuentas de 'entidad de servicio'. Para usar el proyecto de ejemplo del SDK de Azure DNS, primero debe crear una cuenta de entidad de servicio y asignarle los permisos correctos.

  1. Cree una cuenta de entidad de servicio. En el proyecto de ejemplo del SDK de Azure DNS se asume la autenticación basada en contraseña.

  2. A continuación, cree un grupo de recursos.

  3. Use RBAC de Azure para conceder a la cuenta de entidad de servicio permisos de "Colaborador de zona DNS" al grupo de recursos.

  4. Si va a usar el proyecto de ejemplo del SDK de Azure DNS, edite el archivo "program.cs" de la manera siguiente:

    • Inserte los valores correctos para tenantId, clientId (también conocido como identificador de cuenta), secret (contraseña de la cuenta de entidad de servicio) y subscriptionId usados en el paso 1.
    • Escriba el nombre del grupo de recursos creado en el paso 2.
    • Escriba un nombre de zona DNS de su elección.

Paquetes NuGet y declaraciones de espacio de nombres

Para usar el SDK de .NET de DNS de Azure, debe instalar el paquete NuGet de la biblioteca de administración de DNS de Azure y otros paquetes de Azure necesarios.

  1. En Visual Studio, abra un proyecto o cree uno nuevo.

  2. Vaya a Herramientas > Administrador de paquetes NuGet > Administrar paquetes NuGet para la solución.

  3. Seleccione Examinar, habilite la casilla Incluir versión preliminar y escriba Microsoft.Azure.Management.Dns en el cuadro de búsqueda.

  4. Seleccione el paquete y, después, Instalar para agregarlo a su proyecto de Visual Studio.

  5. Repita el proceso anterior para instalar también los siguientes paquetes: Microsoft.Rest.ClientRuntime.Azure.Authentication y Microsoft.Azure.Management.ResourceManager.

Incorporación de declaraciones de espacio de nombres

Adición de las siguientes declaraciones de espacio de nombres

using Microsoft.Rest.Azure.Authentication;
using Microsoft.Azure.Management.Dns;
using Microsoft.Azure.Management.Dns.Models;

Inicialización del cliente de administración de DNS

DnsManagementClient contiene los métodos y las propiedades necesarios para administrar los conjuntos de registros y las zonas DNS. El código siguiente inicia una sesión en la cuenta de entidad de servicio y crea un objeto DnsManagementClient.

// Build the service credentials and DNS management client
var serviceCreds = await ApplicationTokenProvider.LoginSilentAsync(tenantId, clientId, secret);
var dnsClient = new DnsManagementClient(serviceCreds);
dnsClient.SubscriptionId = subscriptionId;

Creación o actualización de una zona DNS

Para crear una zona DNS, primero debe crear un objeto "Zone" que contenga los parámetros de la zona DNS. Como las zonas DNS no están vinculadas a una región específica, la ubicación se establece en "global". En este ejemplo, también se agrega una 'etiqueta' de Azure Resource Manager a la zona.

Para crear o actualizar la zona en Azure DNS, el objeto de zona que contiene los parámetros de zona se pasa al método DnsManagementClient.Zones.CreateOrUpdateAsyc.

Nota:

DnsManagementClient admite tres modos de funcionamiento: sincrónico ('CreateOrUpdate'), asincrónico ('CreateOrUpdateAsync') o asincrónico con acceso a la respuesta HTTP ('CreateOrUpdateWithHttpMessagesAsync'). Puede elegir cualquiera de estos modos, dependiendo de sus necesidades de aplicación.

DNS de Azure admite la simultaneidad optimista denominada Etags. En este ejemplo, al especificar "*" para el encabezado "If-None-Match", indica a Azure DNS que cree una zona DNS si no existe ya una. La llamada produce error si una zona con el nombre dado ya existe en el grupo de recursos dado.

// Create zone parameters
var dnsZoneParams = new Zone("global"); // All DNS zones must have location = "global"

// Create an Azure Resource Manager 'tag'.  This is optional.  You can add multiple tags
dnsZoneParams.Tags = new Dictionary<string, string>();
dnsZoneParams.Tags.Add("dept", "finance");

// Create the actual zone.
// Note: Uses 'If-None-Match *' ETAG check, so will fail if the zone exists already.
// Note: For non-async usage, call dnsClient.Zones.CreateOrUpdate(resourceGroupName, zoneName, dnsZoneParams, null, "*")
// Note: For getting the http response, call dnsClient.Zones.CreateOrUpdateWithHttpMessagesAsync(resourceGroupName, zoneName, dnsZoneParams, null, "*")
var dnsZone = await dnsClient.Zones.CreateOrUpdateAsync(resourceGroupName, zoneName, dnsZoneParams, null, "*");

Creación de registros y conjuntos de registros de DNS

Los registros DNS se administran como un conjunto de registros. Un conjunto de registros es un conjunto de registros con el mismo nombre y tipo de registro dentro de una zona. El nombre del conjunto de registros es relativo al nombre de zona, no al nombre DNS completo.

Para crear o actualizar un conjunto de registros, se crea un objeto de parámetros "RecordSet" y se pasa a DnsManagementClient.RecordSets.CreateOrUpdateAsync. Al igual que con las zonas DNS, existen tres modos de funcionamiento: sincrónico ('CreateOrUpdate'), asincrónico ('CreateOrUpdateAsync') o asincrónico con acceso a la respuesta HTTP ('CreateOrUpdateWithHttpMessagesAsync').

Al igual que con las zonas DNS, las operaciones en los conjuntos de registros incluyen compatibilidad con la simultaneidad optimista. En este ejemplo, como no se especifican "If-Match" ni "If-None-Match", siempre se crea el conjunto de registros. Esta llamada sobrescribe cualquier conjunto de registros existente con el mismo nombre y tipo de registro de esta zona DNS.

// Create record set parameters
var recordSetParams = new RecordSet();
recordSetParams.TTL = 3600;

// Add records to the record set parameter object.  In this case, we'll add a record of type 'A'
recordSetParams.ARecords = new List<ARecord>();
recordSetParams.ARecords.Add(new ARecord("1.2.3.4"));

// Add metadata to the record set.  Similar to Azure Resource Manager tags, this is optional and you can add multiple metadata name/value pairs
recordSetParams.Metadata = new Dictionary<string, string>();
recordSetParams.Metadata.Add("user", "Mary");

// Create the actual record set in Azure DNS
// Note: no ETAG checks specified, will overwrite existing record set if one exists
var recordSet = await dnsClient.RecordSets.CreateOrUpdateAsync(resourceGroupName, zoneName, recordSetName, RecordType.A, recordSetParams);

Obtención de zonas y conjuntos de registros

Los métodos DnsManagementClient.Zones.Get y DnsManagementClient.RecordSets.Get recuperan zonas individuales y conjuntos de registros respectivamente. Los conjuntos de registros se identifican por su tipo y su nombre y por la zona y el grupo de recursos en que se encuentran. Las zonas se identifican por su nombre y el grupo de recursos en que se encuentran.

var recordSet = dnsClient.RecordSets.Get(resourceGroupName, zoneName, recordSetName, RecordType.A);

Actualización de un conjunto de registros existente

Para actualizar un conjunto de registros de DNS existente, primero recupere el conjunto de registros. A continuación, actualice el contenido del conjunto de registros y envíe los cambios. En este ejemplo, especificamos "Etag" del conjunto de registros recuperados en el parámetro 'If-Match'. La llamada produce error si una operación simultánea ha modificado mientras tanto el conjunto de registros.

var recordSet = dnsClient.RecordSets.Get(resourceGroupName, zoneName, recordSetName, RecordType.A);

// Add a new record to the local object.  Note that records in a record set must be unique/distinct
recordSet.ARecords.Add(new ARecord("5.6.7.8"));

// Update the record set in Azure DNS
// Note: ETAG check specified, update will be rejected if the record set has changed in the meantime
recordSet = await dnsClient.RecordSets.CreateOrUpdateAsync(resourceGroupName, zoneName, recordSetName, RecordType.A, recordSet, recordSet.Etag);

Enumeración de zonas y conjuntos de registros

  • Para mostrar las zonas, use los métodos DnsManagementClient.Zones.List..., que admiten el listado de todas las zonas de un grupo de recursos dado o todas las zonas de una suscripción de Azure concreta (entre grupos de recursos).

  • Para mostrar conjuntos de registros, use los métodos DnsManagementClient.RecordSets.List..., que admiten el listado de todos los conjuntos de registros de una zona dada y solo los de un tipo específico.

Al mostrar zonas y conjuntos de registros, tenga en cuenta que los resultados pueden estar paginados. En el ejemplo siguiente se muestra cómo iterar a través d las páginas de resultados. (Un tamaño de página artificialmente pequeño de '2' se usa para forzar la paginación; en la práctica, este parámetro debe omitirse y usarse el tamaño de página predeterminado).

// Note: in this demo, we'll use a very small page size (2 record sets) to demonstrate paging
// In practice, to improve performance you would use a large page size or just use the system default
int recordSets = 0;
var page = await dnsClient.RecordSets.ListAllInResourceGroupAsync(resourceGroupName, zoneName, "2");
recordSets += page.Count();

while (page.NextPageLink != null)
{
    page = await dnsClient.RecordSets.ListAllInResourceGroupNextAsync(page.NextPageLink);
    recordSets += page.Count();
}

Pasos siguientes

Descargue el proyecto de ejemplo del SDK de .NET de Azure DNS, que incluye más ejemplos de cómo usar el SDK de .NET de Azure DNS, además de ejemplos de otros tipos de registros de DNS.