Bibliothèque de client de gestion Dns Microsoft Azure pour .NET

Article
04/18/2023

Microsoft Azure Dns est un service d’hébergement pour les domaines Dns qui fournit la résolution de noms à l’aide de l’infrastructure Microsoft Azure. En hébergeant vos domaines dans Microsoft Azure, vous pouvez gérer vos enregistrements Dns en utilisant les mêmes informations d’identification, API, outils et facturation que vos autres services Azure.

Cette bibliothèque prend en charge la gestion des ressources Microsoft Azure Dns.

Cette bibliothèque suit les nouvelles recommandations du Kit de développement logiciel (SDK) Azure et fournit de nombreuses fonctionnalités de base :

- Support MSAL.NET, Azure.Identity is out of box for supporting MSAL.NET.
- Support [OpenTelemetry](https://opentelemetry.io/) for distributed tracing.
- HTTP pipeline with custom policies.
- Better error-handling.
- Support uniform telemetry across all languages.

Prise en main

Installer le package

Installez la bibliothèque de gestion Azure DNS pour .NET avec NuGet :

dotnet add package Azure.ResourceManager.Dns

Prérequis

Vous devez disposer d’un abonnement Microsoft Azure.

Authentifier le client

Pour créer un client authentifié et commencer à interagir avec les ressources Microsoft Azure, consultez le guide de démarrage rapide ici.

Concepts clés

Les concepts clés du kit de développement logiciel Microsoft Azure SDK pour .NET sont disponibles ici.

Documentation

La documentation est disponible pour vous aider à apprendre à utiliser ce package :

Exemples

Créer une zone DNS

ArmClient armClient = new ArmClient(new DefaultAzureCredential());
SubscriptionResource subscription = await armClient.GetDefaultSubscriptionAsync();
// first we need to get the resource group
string rgName = "myRgName";
ResourceGroupResource resourceGroup = await subscription.GetResourceGroups().GetAsync(rgName);
// Now we get the DnsZone collection from the resource group
DnsZoneCollection dnsZoneCollection = resourceGroup.GetDnsZones();
// Use the same location as the resource group
string dnsZoneName = "sample.com";
DnsZoneData data = new DnsZoneData("Global")
{
};
ArmOperation<DnsZoneResource> lro = await dnsZoneCollection.CreateOrUpdateAsync(WaitUntil.Completed, dnsZoneName, data);
DnsZoneResource dnsZone = lro.Value;

Obtenir toutes les zones Dns d’un groupe de ressources

ArmClient armClient = new ArmClient(new DefaultAzureCredential());
SubscriptionResource subscription = await armClient.GetDefaultSubscriptionAsync();
// first we need to get the resource group
string rgName = "myRgName";
ResourceGroupResource resourceGroup = await subscription.GetResourceGroups().GetAsync(rgName);
// Now we get the DnsZone collection from the resource group
DnsZoneCollection dnsZoneCollection = resourceGroup.GetDnsZones();
// With ListAsync(), we can get a list of the DnsZones
AsyncPageable<DnsZoneResource>  response = dnsZoneCollection.GetAllAsync();
await foreach (DnsZoneResource dnsZone in response)
{
    Console.WriteLine(dnsZone.Data.Name);
}

Supprimer une zone DNS

ArmClient armClient = new ArmClient(new DefaultAzureCredential());
SubscriptionResource subscription = await armClient.GetDefaultSubscriptionAsync();
// first we need to get the resource group
string rgName = "myRgName";
ResourceGroupResource resourceGroup = await subscription.GetResourceGroups().GetAsync(rgName);
// Now we get the DnsZone collection from the resource group
DnsZoneCollection dnsZoneCollection = resourceGroup.GetDnsZones();
string dnsZoneName = "sample.com";
DnsZoneResource dnsZone =await dnsZoneCollection.GetAsync(dnsZoneName);
await dnsZone.DeleteAsync(WaitUntil.Completed);

Dépannage

Effectuez un problème via GitHub Issues.
Consultez les questions précédentes ou posez-en de nouvelles sur Stack Overflow à l’aide de balises Azure et .NET.
Si vous rencontrez des problèmes avec l’authentification, accédez à DefaultAzureCredential documentation.

Étapes suivantes

Autres exemples de code

Autre documentation

Pour plus d’informations sur le Kit de développement logiciel (SDK) Microsoft Azure, consultez ce site web.

Contribution

Pour plus d’informations sur la contribution à ce dépôt, consultez le guide de contribution.

Ce projet accepte les contributions et les suggestions. La plupart des contributions vous demandent d’accepter un contrat de licence de contribution (CLA) déclarant que vous avez le droit de nous accorder, et que vous nous accordez réellement, les droits d’utilisation de votre contribution. Pour plus d’informations, visitez https://cla.microsoft.com.

Lorsque vous envoyez une demande de tirage, un cla-bot détermine automatiquement si vous devez fournir un cla cla et décorer la demande de tirage de manière appropriée (par exemple, étiquette, commentaire). Suivez les instructions fournies par le bot. Vous n’aurez besoin d’effectuer cette action qu’une seule fois sur tous les dépôts à l’aide de notre cla cla.

Ce projet a adopté le Code de conduite Open Source de Microsoft. Pour plus d’informations, consultez les Questions fréquentes (FAQ) sur le code de conduite ou envoyez vos questions ou vos commentaires à opencode@microsoft.com.

Partager via