Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Exemples de code pour Route 53 utilisant AWS SDKs
Les exemples de code suivants montrent comment utiliser Route 53 avec un kit de développement AWS logiciel (SDK).
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de Route 53 avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit de développement logiciel (SDK).
**Contents**
+ [Route 53](service_code_examples_route-53.md)
+ [Principes de base](service_code_examples_route-53_basics.md)
+ [Actions](service_code_examples_route-53_actions.md)
+ [`ChangeResourceRecordSets`](route-53_example_route-53_ChangeResourceRecordSets_section.md)
+ [`CreateHostedZone`](route-53_example_route-53_CreateHostedZone_section.md)
+ [`DeleteHostedZone`](route-53_example_route-53_DeleteHostedZone_section.md)
+ [`GetHostedZone`](route-53_example_route-53_GetHostedZone_section.md)
+ [`ListHostedZones`](route-53_example_route-53_ListHostedZones_section.md)
+ [`ListHostedZonesByName`](route-53_example_route-53_ListHostedZonesByName_section.md)
+ [`ListQueryLoggingConfigs`](route-53_example_route-53_ListQueryLoggingConfigs_section.md)
+ [Enregistrement de domaine Route 53](service_code_examples_route-53-domains.md)
+ [Principes de base](service_code_examples_route-53-domains_basics.md)
+ [Bonjour Enregistrement de domaine Route 53](route-53-domains_example_route-53-domains_Hello_section.md)
+ [Principes de base](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
+ [Actions](service_code_examples_route-53-domains_actions.md)
+ [`CheckDomainAvailability`](route-53-domains_example_route-53-domains_CheckDomainAvailability_section.md)
+ [`CheckDomainTransferability`](route-53-domains_example_route-53-domains_CheckDomainTransferability_section.md)
+ [`GetDomainDetail`](route-53-domains_example_route-53-domains_GetDomainDetail_section.md)
+ [`GetDomainSuggestions`](route-53-domains_example_route-53-domains_GetDomainSuggestions_section.md)
+ [`GetOperationDetail`](route-53-domains_example_route-53-domains_GetOperationDetail_section.md)
+ [`ListDomains`](route-53-domains_example_route-53-domains_ListDomains_section.md)
+ [`ListOperations`](route-53-domains_example_route-53-domains_ListOperations_section.md)
+ [`ListPrices`](route-53-domains_example_route-53-domains_ListPrices_section.md)
+ [`RegisterDomain`](route-53-domains_example_route-53-domains_RegisterDomain_section.md)
+ [`ViewBilling`](route-53-domains_example_route-53-domains_ViewBilling_section.md)
# Exemples de code pour Route 53 utilisant AWS SDKs
Les exemples de code suivants montrent comment utiliser Route 53 avec un kit de développement AWS logiciel (SDK).
Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de Route 53 avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.
**Contents**
+ [Principes de base](service_code_examples_route-53_basics.md)
+ [Actions](service_code_examples_route-53_actions.md)
+ [`ChangeResourceRecordSets`](route-53_example_route-53_ChangeResourceRecordSets_section.md)
+ [`CreateHostedZone`](route-53_example_route-53_CreateHostedZone_section.md)
+ [`DeleteHostedZone`](route-53_example_route-53_DeleteHostedZone_section.md)
+ [`GetHostedZone`](route-53_example_route-53_GetHostedZone_section.md)
+ [`ListHostedZones`](route-53_example_route-53_ListHostedZones_section.md)
+ [`ListHostedZonesByName`](route-53_example_route-53_ListHostedZonesByName_section.md)
+ [`ListQueryLoggingConfigs`](route-53_example_route-53_ListQueryLoggingConfigs_section.md)
# Exemples de base pour l'utilisation de Route 53 AWS SDKs
Les exemples de code suivants montrent comment utiliser les bases d'Amazon Route 53 avec AWS SDKs.
**Contents**
+ [Actions](service_code_examples_route-53_actions.md)
+ [`ChangeResourceRecordSets`](route-53_example_route-53_ChangeResourceRecordSets_section.md)
+ [`CreateHostedZone`](route-53_example_route-53_CreateHostedZone_section.md)
+ [`DeleteHostedZone`](route-53_example_route-53_DeleteHostedZone_section.md)
+ [`GetHostedZone`](route-53_example_route-53_GetHostedZone_section.md)
+ [`ListHostedZones`](route-53_example_route-53_ListHostedZones_section.md)
+ [`ListHostedZonesByName`](route-53_example_route-53_ListHostedZonesByName_section.md)
+ [`ListQueryLoggingConfigs`](route-53_example_route-53_ListQueryLoggingConfigs_section.md)
# Actions pour utiliser Route 53 AWS SDKs
Les exemples de code suivants montrent comment effectuer des actions Route 53 individuelles avec AWS SDKs. Chaque exemple inclut un lien vers GitHub, où vous pouvez trouver des instructions pour configurer et exécuter le code.
Les exemples suivants incluent uniquement les actions les plus couramment utilisées. Pour obtenir la liste complète, consultez la [référence de l’API Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/APIReference/Welcome.html).
**Topics**
+ [`ChangeResourceRecordSets`](route-53_example_route-53_ChangeResourceRecordSets_section.md)
+ [`CreateHostedZone`](route-53_example_route-53_CreateHostedZone_section.md)
+ [`DeleteHostedZone`](route-53_example_route-53_DeleteHostedZone_section.md)
+ [`GetHostedZone`](route-53_example_route-53_GetHostedZone_section.md)
+ [`ListHostedZones`](route-53_example_route-53_ListHostedZones_section.md)
+ [`ListHostedZonesByName`](route-53_example_route-53_ListHostedZonesByName_section.md)
+ [`ListQueryLoggingConfigs`](route-53_example_route-53_ListQueryLoggingConfigs_section.md)
# Utilisation de `ChangeResourceRecordSets` avec une CLI
Les exemples de code suivants illustrent comment utiliser `ChangeResourceRecordSets`.
------
#### [ CLI ]
**AWS CLI**
**Pour créer, mettre à jour ou supprimer un jeu d’enregistrements de ressources**
La commande `change-resource-record-sets` suivante crée un jeu d’enregistrements de ressources à l’aide de l’`hosted-zone-id` `Z1R8UBAEXAMPLE` et de la configuration au format JSON du fichier `C:\awscli\route53\change-resource-record-sets.json` :
```
aws route53 change-resource-record-sets --hosted-zone-id Z1R8UBAEXAMPLE --change-batch file://C:\awscli\route53\change-resource-record-sets.json
```
Pour plus d'informations, consultez POST ChangeResourceRecordSets dans le manuel *Amazon Route 53 API Reference*.
La configuration du fichier JSON dépend du type de jeu d’enregistrements de ressources que vous souhaitez créer :
BasicWeightedAliasWeighted AliasLatencyLatency AliasFailoverFailover Alias
**Syntaxe de base** :
```
{
"Comment": "optional comment about the changes in this change batch request",
"Changes": [
{
"Action": "CREATE"|"DELETE"|"UPSERT",
"ResourceRecordSet": {
"Name": "DNS domain name",
"Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA",
"TTL": time to live in seconds,
"ResourceRecords": [
{
"Value": "applicable value for the record type"
},
{...}
]
}
},
{...}
]
}
```
**Syntaxe pondérée** :
```
{
"Comment": "optional comment about the changes in this change batch request",
"Changes": [
{
"Action": "CREATE"|"DELETE"|"UPSERT",
"ResourceRecordSet": {
"Name": "DNS domain name",
"Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA",
"SetIdentifier": "unique description for this resource record set",
"Weight": value between 0 and 255,
"TTL": time to live in seconds,
"ResourceRecords": [
{
"Value": "applicable value for the record type"
},
{...}
],
"HealthCheckId": "optional ID of an Amazon Route 53 health check"
}
},
{...}
]
}
```
**Syntaxe d’alias** :
```
{
"Comment": "optional comment about the changes in this change batch request",
"Changes": [
{
"Action": "CREATE"|"DELETE"|"UPSERT",
"ResourceRecordSet": {
"Name": "DNS domain name",
"Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA",
"AliasTarget": {
"HostedZoneId": "hosted zone ID for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or Amazon Route 53 hosted zone",
"DNSName": "DNS domain name for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or another resource record set in this hosted zone",
"EvaluateTargetHealth": true|false
},
"HealthCheckId": "optional ID of an Amazon Route 53 health check"
}
},
{...}
]
}
```
**Syntaxe d’alias pondérée** :
```
{
"Comment": "optional comment about the changes in this change batch request",
"Changes": [
{
"Action": "CREATE"|"DELETE"|"UPSERT",
"ResourceRecordSet": {
"Name": "DNS domain name",
"Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA",
"SetIdentifier": "unique description for this resource record set",
"Weight": value between 0 and 255,
"AliasTarget": {
"HostedZoneId": "hosted zone ID for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or Amazon Route 53 hosted zone",
"DNSName": "DNS domain name for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or another resource record set in this hosted zone",
"EvaluateTargetHealth": true|false
},
"HealthCheckId": "optional ID of an Amazon Route 53 health check"
}
},
{...}
]
}
```
**Syntaxe de latence** :
```
{
"Comment": "optional comment about the changes in this change batch request",
"Changes": [
{
"Action": "CREATE"|"DELETE"|"UPSERT",
"ResourceRecordSet": {
"Name": "DNS domain name",
"Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA",
"SetIdentifier": "unique description for this resource record set",
"Region": "Amazon EC2 region name",
"TTL": time to live in seconds,
"ResourceRecords": [
{
"Value": "applicable value for the record type"
},
{...}
],
"HealthCheckId": "optional ID of an Amazon Route 53 health check"
}
},
{...}
]
}
```
**Syntaxe d’alias de latence** :
```
{
"Comment": "optional comment about the changes in this change batch request",
"Changes": [
{
"Action": "CREATE"|"DELETE"|"UPSERT",
"ResourceRecordSet": {
"Name": "DNS domain name",
"Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA",
"SetIdentifier": "unique description for this resource record set",
"Region": "Amazon EC2 region name",
"AliasTarget": {
"HostedZoneId": "hosted zone ID for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or Amazon Route 53 hosted zone",
"DNSName": "DNS domain name for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or another resource record set in this hosted zone",
"EvaluateTargetHealth": true|false
},
"HealthCheckId": "optional ID of an Amazon Route 53 health check"
}
},
{...}
]
}
```
**Syntaxe de basculement** :
```
{
"Comment": "optional comment about the changes in this change batch request",
"Changes": [
{
"Action": "CREATE"|"DELETE"|"UPSERT",
"ResourceRecordSet": {
"Name": "DNS domain name",
"Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA",
"SetIdentifier": "unique description for this resource record set",
"Failover": "PRIMARY" | "SECONDARY",
"TTL": time to live in seconds,
"ResourceRecords": [
{
"Value": "applicable value for the record type"
},
{...}
],
"HealthCheckId": "ID of an Amazon Route 53 health check"
}
},
{...}
]
}
```
**Syntaxe d’alias de basculement** :
```
{
"Comment": "optional comment about the changes in this change batch request",
"Changes": [
{
"Action": "CREATE"|"DELETE"|"UPSERT",
"ResourceRecordSet": {
"Name": "DNS domain name",
"Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA",
"SetIdentifier": "unique description for this resource record set",
"Failover": "PRIMARY" | "SECONDARY",
"AliasTarget": {
"HostedZoneId": "hosted zone ID for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or Amazon Route 53 hosted zone",
"DNSName": "DNS domain name for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or another resource record set in this hosted zone",
"EvaluateTargetHealth": true|false
},
"HealthCheckId": "optional ID of an Amazon Route 53 health check"
}
},
{...}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [ChangeResourceRecordSets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53/change-resource-record-sets.html)à la section *Référence des AWS CLI commandes*.
------
#### [ PowerShell ]
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple crée un enregistrement A pour www.exemple.com et modifie l’enregistrement A pour test.example.com de 192.0.2.3 à 192.0.2.1. Notez que les valeurs des modifications des enregistrements de type TXT doivent être entre guillemets doubles. Consultez la documentation Amazon Route 53 pour plus de détails. Vous pouvez utiliser l'Get-R53Changeapplet de commande pour effectuer un sondage afin de déterminer quand les modifications sont terminées.**
```
$change1 = New-Object Amazon.Route53.Model.Change
$change1.Action = "CREATE"
$change1.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change1.ResourceRecordSet.Name = "www.example.com"
$change1.ResourceRecordSet.Type = "TXT"
$change1.ResourceRecordSet.TTL = 600
$change1.ResourceRecordSet.ResourceRecords.Add(@{Value="item 1 item 2 item 3"})
$change2 = New-Object Amazon.Route53.Model.Change
$change2.Action = "DELETE"
$change2.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change2.ResourceRecordSet.Name = "test.example.com"
$change2.ResourceRecordSet.Type = "A"
$change2.ResourceRecordSet.TTL = 600
$change2.ResourceRecordSet.ResourceRecords.Add(@{Value="192.0.2.3"})
$change3 = New-Object Amazon.Route53.Model.Change
$change3.Action = "CREATE"
$change3.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change3.ResourceRecordSet.Name = "test.example.com"
$change3.ResourceRecordSet.Type = "A"
$change3.ResourceRecordSet.TTL = 600
$change3.ResourceRecordSet.ResourceRecords.Add(@{Value="192.0.2.1"})
$params = @{
HostedZoneId="Z1PA6795UKMFR9"
ChangeBatch_Comment="This change batch creates a TXT record for www.example.com. and changes the A record for test.example.com. from 192.0.2.3 to 192.0.2.1."
ChangeBatch_Change=$change1,$change2,$change3
}
Edit-R53ResourceRecordSet @params
```
**Exemple 2 : cet exemple montre comment créer des ensembles d’enregistrements de ressources d’alias. « Z222222222 » est l’ID de la zone hébergée Amazon Route 53 dans laquelle vous créez le jeu d’enregistrements de ressources d’alias. « exemple.com » est la zone apex pour laquelle vous souhaitez créer un alias et « www.exemple.com » est un sous-domaine pour lequel vous souhaitez également créer un alias. « Z1111111111111 » est un exemple d'ID de zone hébergée pour l'équilibreur de charge et « example-load-balancer -1111111111.us-east-1.elb.amazonaws.com » est un exemple de nom de domaine d'équilibreur de charge avec lequel Amazon Route 53 répond aux requêtes pour exemple.com et www.example.com. Consultez la documentation Amazon Route 53 pour plus de détails. Vous pouvez utiliser l'Get-R53Changeapplet de commande pour effectuer un sondage afin de déterminer quand les modifications sont terminées.**
```
$change1 = New-Object Amazon.Route53.Model.Change
$change1.Action = "CREATE"
$change1.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change1.ResourceRecordSet.Name = "example.com"
$change1.ResourceRecordSet.Type = "A"
$change1.ResourceRecordSet.AliasTarget = New-Object Amazon.Route53.Model.AliasTarget
$change1.ResourceRecordSet.AliasTarget.HostedZoneId = "Z1111111111111"
$change1.ResourceRecordSet.AliasTarget.DNSName = "example-load-balancer-1111111111.us-east-1.elb.amazonaws.com."
$change1.ResourceRecordSet.AliasTarget.EvaluateTargetHealth = $true
$change2 = New-Object Amazon.Route53.Model.Change
$change2.Action = "CREATE"
$change2.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change1.ResourceRecordSet.Name = "www.example.com"
$change1.ResourceRecordSet.Type = "A"
$change1.ResourceRecordSet.AliasTarget = New-Object Amazon.Route53.Model.AliasTarget
$change1.ResourceRecordSet.AliasTarget.HostedZoneId = "Z1111111111111"
$change1.ResourceRecordSet.AliasTarget.DNSName = "example-load-balancer-1111111111.us-east-1.elb.amazonaws.com."
$change1.ResourceRecordSet.AliasTarget.EvaluateTargetHealth = $false
$params = @{
HostedZoneId="Z222222222"
ChangeBatch_Comment="This change batch creates two alias resource record sets, one for the zone apex, example.com, and one for www.example.com, that both point to example-load-balancer-1111111111.us-east-1.elb.amazonaws.com."
ChangeBatch_Change=$change1,$change2
}
Edit-R53ResourceRecordSet @params
```
**Exemple 3 : cet exemple crée deux enregistrements A pour www.example.com. Dans un quart des cas (1/(1\$13)), Amazon Route 53 répond aux requêtes relatives à www.example.com avec les deux valeurs du premier ensemble d’enregistrements de ressources (192.0.2.9 et 192.0.2.10). Dans trois quarts des cas (3/(1\$13)), Amazon Route 53 répond aux requêtes relatives à www.example.com avec les deux valeurs du second ensemble d’enregistrements de ressources (192.0.2.11 et 192.0.2.12). Consultez la documentation Amazon Route 53 pour plus de détails. Vous pouvez utiliser l'Get-R53Changeapplet de commande pour effectuer un sondage afin de déterminer quand les modifications sont terminées.**
```
$change1 = New-Object Amazon.Route53.Model.Change
$change1.Action = "CREATE"
$change1.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change1.ResourceRecordSet.Name = "www.example.com"
$change1.ResourceRecordSet.Type = "A"
$change1.ResourceRecordSet.SetIdentifier = "Rack 2, Positions 4 and 5"
$change1.ResourceRecordSet.Weight = 1
$change1.ResourceRecordSet.TTL = 600
$change1.ResourceRecordSet.ResourceRecords.Add(@{Value="192.0.2.9"})
$change1.ResourceRecordSet.ResourceRecords.Add(@{Value="192.0.2.10"})
$change2 = New-Object Amazon.Route53.Model.Change
$change2.Action = "CREATE"
$change2.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change2.ResourceRecordSet.Name = "www.example.com"
$change2.ResourceRecordSet.Type = "A"
$change2.ResourceRecordSet.SetIdentifier = "Rack 5, Positions 1 and 2"
$change2.ResourceRecordSet.Weight = 3
$change2.ResourceRecordSet.TTL = 600
$change2.ResourceRecordSet.ResourceRecords.Add(@{Value="192.0.2.11"})
$change2.ResourceRecordSet.ResourceRecords.Add(@{Value="192.0.2.12"})
$params = @{
HostedZoneId="Z1PA6795UKMFR9"
ChangeBatch_Comment="This change creates two weighted resource record sets, each of which has two values."
ChangeBatch_Change=$change1,$change2
}
Edit-R53ResourceRecordSet @params
```
**Exemple 4 : Cet exemple montre comment créer des ensembles d'enregistrements de ressources d'alias pondérés en supposant que exemple.com est le domaine pour lequel vous souhaitez créer des ensembles d'enregistrements de ressources d'alias pondérés. SetIdentifier différencie les deux ensembles d'enregistrements de ressources alias pondérés l'un de l'autre. Cet élément est obligatoire, car les éléments Name et Type ont les mêmes valeurs pour les deux jeux d’enregistrements de ressources. Z1111111111111 et Z3333333333333 sont des exemples de zone hébergée pour l'équilibreur de charge ELB spécifié par la valeur de. IDs DNSName example-load-balancer-2222222222.us-east-1.elb.amazonaws.com et example-load-balancer -4444444444.us-east-1.elb.amazonaws.com sont des exemples de domaines Elastic Load Balancing à partir desquels Amazon Route 53 répond aux requêtes pour exemple.com. Consultez la documentation Amazon Route 53 pour plus de détails. Vous pouvez utiliser l'Get-R53Changeapplet de commande pour effectuer un sondage afin de déterminer quand les modifications sont terminées.**
```
$change1 = New-Object Amazon.Route53.Model.Change
$change1.Action = "CREATE"
$change1.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change1.ResourceRecordSet.Name = "example.com"
$change1.ResourceRecordSet.Type = "A"
$change1.ResourceRecordSet.SetIdentifier = "1"
$change1.ResourceRecordSet.Weight = 3
$change1.ResourceRecordSet.AliasTarget = New-Object Amazon.Route53.Model.AliasTarget
$change1.ResourceRecordSet.AliasTarget.HostedZoneId = "Z1111111111111"
$change1.ResourceRecordSet.AliasTarget.DNSName = "example-load-balancer-2222222222.us-east-1.elb.amazonaws.com."
$change1.ResourceRecordSet.AliasTarget.EvaluateTargetHealth = $true
$change2 = New-Object Amazon.Route53.Model.Change
$change2.Action = "CREATE"
$change2.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change2.ResourceRecordSet.Name = "example.com"
$change2.ResourceRecordSet.Type = "A"
$change2.ResourceRecordSet.SetIdentifier = "2"
$change2.ResourceRecordSet.Weight = 1
$change2.ResourceRecordSet.AliasTarget = New-Object Amazon.Route53.Model.AliasTarget
$change2.ResourceRecordSet.AliasTarget.HostedZoneId = "Z3333333333333"
$change2.ResourceRecordSet.AliasTarget.DNSName = "example-load-balancer-4444444444.us-east-1.elb.amazonaws.com."
$change2.ResourceRecordSet.AliasTarget.EvaluateTargetHealth = $false
$params = @{
HostedZoneId="Z5555555555"
ChangeBatch_Comment="This change batch creates two weighted alias resource record sets. Amazon Route 53 responds to queries for example.com with the first ELB domain 3/4ths of the times and the second one 1/4th of the time."
ChangeBatch_Change=$change1,$change2
}
Edit-R53ResourceRecordSet @params
```
**Exemple 5 : cet exemple crée deux jeux d’enregistrements de ressources d’alias de latence, l’un pour un équilibreur de charge ELB dans la région USA Ouest (Oregon) (us-west-2) et l’autre pour un équilibreur de charge dans la région Asie-Pacifique (Singapour) (ap-southeast-1). Consultez la documentation Amazon Route 53 pour plus de détails. Vous pouvez utiliser l'Get-R53Changeapplet de commande pour effectuer un sondage afin de déterminer quand les modifications sont terminées.**
```
$change1 = New-Object Amazon.Route53.Model.Change
$change1.Action = "CREATE"
$change1.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change1.ResourceRecordSet.Name = "example.com"
$change1.ResourceRecordSet.Type = "A"
$change1.ResourceRecordSet.SetIdentifier = "Oregon load balancer 1"
$change1.ResourceRecordSet.Region = us-west-2
$change1.ResourceRecordSet.AliasTarget = New-Object Amazon.Route53.Model.AliasTarget
$change1.ResourceRecordSet.AliasTarget.HostedZoneId = "Z1111111111111"
$change1.ResourceRecordSet.AliasTarget.DNSName = "example-load-balancer-2222222222.us-west-2.elb.amazonaws.com"
$change1.ResourceRecordSet.AliasTarget.EvaluateTargetHealth = $true
$change2 = New-Object Amazon.Route53.Model.Change
$change2.Action = "CREATE"
$change2.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change2.ResourceRecordSet.Name = "example.com"
$change2.ResourceRecordSet.Type = "A"
$change2.ResourceRecordSet.SetIdentifier = "Singapore load balancer 1"
$change2.ResourceRecordSet.Region = ap-southeast-1
$change2.ResourceRecordSet.AliasTarget = New-Object Amazon.Route53.Model.AliasTarget
$change2.ResourceRecordSet.AliasTarget.HostedZoneId = "Z2222222222222"
$change2.ResourceRecordSet.AliasTarget.DNSName = "example-load-balancer-1111111111.ap-southeast-1.elb.amazonaws.com"
$change2.ResourceRecordSet.AliasTarget.EvaluateTargetHealth = $true
$params = @{
HostedZoneId="Z5555555555"
ChangeBatch_Comment="This change batch creates two latency resource record sets, one for the US West (Oregon) region and one for the Asia Pacific (Singapore) region."
ChangeBatch_Change=$change1,$change2
}
Edit-R53ResourceRecordSet @params
```
+ Pour plus de détails sur l'API, reportez-vous [ChangeResourceRecordSets](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple crée un enregistrement A pour www.exemple.com et modifie l’enregistrement A pour test.example.com de 192.0.2.3 à 192.0.2.1. Notez que les valeurs des modifications des enregistrements de type TXT doivent être entre guillemets doubles. Consultez la documentation Amazon Route 53 pour plus de détails. Vous pouvez utiliser l'Get-R53Changeapplet de commande pour effectuer un sondage afin de déterminer quand les modifications sont terminées.**
```
$change1 = New-Object Amazon.Route53.Model.Change
$change1.Action = "CREATE"
$change1.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change1.ResourceRecordSet.Name = "www.example.com"
$change1.ResourceRecordSet.Type = "TXT"
$change1.ResourceRecordSet.TTL = 600
$change1.ResourceRecordSet.ResourceRecords = @()
$change1.ResourceRecordSet.ResourceRecords.Add(@{Value="item 1 item 2 item 3"})
$change2 = New-Object Amazon.Route53.Model.Change
$change2.Action = "DELETE"
$change2.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change2.ResourceRecordSet.Name = "test.example.com"
$change2.ResourceRecordSet.Type = "A"
$change2.ResourceRecordSet.TTL = 600
$change2.ResourceRecordSet.ResourceRecords = @()
$change2.ResourceRecordSet.ResourceRecords.Add(@{Value="192.0.2.3"})
$change3 = New-Object Amazon.Route53.Model.Change
$change3.Action = "CREATE"
$change3.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change3.ResourceRecordSet.Name = "test.example.com"
$change3.ResourceRecordSet.Type = "A"
$change3.ResourceRecordSet.TTL = 600
$change3.ResourceRecordSet.ResourceRecords = @()
$change3.ResourceRecordSet.ResourceRecords.Add(@{Value="192.0.2.1"})
$params = @{
HostedZoneId="Z1PA6795UKMFR9"
ChangeBatch_Comment="This change batch creates a TXT record for www.example.com. and changes the A record for test.example.com. from 192.0.2.3 to 192.0.2.1."
ChangeBatch_Change=$change1,$change2,$change3
}
Edit-R53ResourceRecordSet @params
```
**Exemple 2 : cet exemple montre comment créer des ensembles d’enregistrements de ressources d’alias. « Z222222222 » est l’ID de la zone hébergée Amazon Route 53 dans laquelle vous créez le jeu d’enregistrements de ressources d’alias. « exemple.com » est la zone apex pour laquelle vous souhaitez créer un alias et « www.exemple.com » est un sous-domaine pour lequel vous souhaitez également créer un alias. « Z1111111111111 » est un exemple d'ID de zone hébergée pour l'équilibreur de charge et « example-load-balancer -1111111111.us-east-1.elb.amazonaws.com » est un exemple de nom de domaine d'équilibreur de charge avec lequel Amazon Route 53 répond aux requêtes pour exemple.com et www.example.com. Consultez la documentation Amazon Route 53 pour plus de détails. Vous pouvez utiliser l'Get-R53Changeapplet de commande pour effectuer un sondage afin de déterminer quand les modifications sont terminées.**
```
$change1 = New-Object Amazon.Route53.Model.Change
$change1.Action = "CREATE"
$change1.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change1.ResourceRecordSet.Name = "example.com"
$change1.ResourceRecordSet.Type = "A"
$change1.ResourceRecordSet.AliasTarget = New-Object Amazon.Route53.Model.AliasTarget
$change1.ResourceRecordSet.AliasTarget.HostedZoneId = "Z1111111111111"
$change1.ResourceRecordSet.AliasTarget.DNSName = "example-load-balancer-1111111111.us-east-1.elb.amazonaws.com."
$change1.ResourceRecordSet.AliasTarget.EvaluateTargetHealth = $true
$change2 = New-Object Amazon.Route53.Model.Change
$change2.Action = "CREATE"
$change2.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change1.ResourceRecordSet.Name = "www.example.com"
$change1.ResourceRecordSet.Type = "A"
$change1.ResourceRecordSet.AliasTarget = New-Object Amazon.Route53.Model.AliasTarget
$change1.ResourceRecordSet.AliasTarget.HostedZoneId = "Z1111111111111"
$change1.ResourceRecordSet.AliasTarget.DNSName = "example-load-balancer-1111111111.us-east-1.elb.amazonaws.com."
$change1.ResourceRecordSet.AliasTarget.EvaluateTargetHealth = $false
$params = @{
HostedZoneId="Z222222222"
ChangeBatch_Comment="This change batch creates two alias resource record sets, one for the zone apex, example.com, and one for www.example.com, that both point to example-load-balancer-1111111111.us-east-1.elb.amazonaws.com."
ChangeBatch_Change=$change1,$change2
}
Edit-R53ResourceRecordSet @params
```
**Exemple 3 : cet exemple crée deux enregistrements A pour www.example.com. Dans un quart des cas (1/(1\$13)), Amazon Route 53 répond aux requêtes relatives à www.example.com avec les deux valeurs du premier ensemble d’enregistrements de ressources (192.0.2.9 et 192.0.2.10). Dans trois quarts des cas (3/(1\$13)), Amazon Route 53 répond aux requêtes relatives à www.example.com avec les deux valeurs du second ensemble d’enregistrements de ressources (192.0.2.11 et 192.0.2.12). Consultez la documentation Amazon Route 53 pour plus de détails. Vous pouvez utiliser l'Get-R53Changeapplet de commande pour effectuer un sondage afin de déterminer quand les modifications sont terminées.**
```
$change1 = New-Object Amazon.Route53.Model.Change
$change1.Action = "CREATE"
$change1.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change1.ResourceRecordSet.Name = "www.example.com"
$change1.ResourceRecordSet.Type = "A"
$change1.ResourceRecordSet.SetIdentifier = "Rack 2, Positions 4 and 5"
$change1.ResourceRecordSet.Weight = 1
$change1.ResourceRecordSet.TTL = 600
$change1.ResourceRecordSet.ResourceRecords = @()
$change1.ResourceRecordSet.ResourceRecords.Add(@{Value="192.0.2.9"})
$change1.ResourceRecordSet.ResourceRecords.Add(@{Value="192.0.2.10"})
$change2 = New-Object Amazon.Route53.Model.Change
$change2.Action = "CREATE"
$change2.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change2.ResourceRecordSet.Name = "www.example.com"
$change2.ResourceRecordSet.Type = "A"
$change2.ResourceRecordSet.SetIdentifier = "Rack 5, Positions 1 and 2"
$change2.ResourceRecordSet.Weight = 3
$change2.ResourceRecordSet.TTL = 600
$change2.ResourceRecordSet.ResourceRecords = @()
$change2.ResourceRecordSet.ResourceRecords.Add(@{Value="192.0.2.11"})
$change2.ResourceRecordSet.ResourceRecords.Add(@{Value="192.0.2.12"})
$params = @{
HostedZoneId="Z1PA6795UKMFR9"
ChangeBatch_Comment="This change creates two weighted resource record sets, each of which has two values."
ChangeBatch_Change=$change1,$change2
}
Edit-R53ResourceRecordSet @params
```
**Exemple 4 : Cet exemple montre comment créer des ensembles d'enregistrements de ressources d'alias pondérés en supposant que exemple.com est le domaine pour lequel vous souhaitez créer des ensembles d'enregistrements de ressources d'alias pondérés. SetIdentifier différencie les deux ensembles d'enregistrements de ressources alias pondérés l'un de l'autre. Cet élément est obligatoire, car les éléments Name et Type ont les mêmes valeurs pour les deux jeux d’enregistrements de ressources. Z1111111111111 et Z3333333333333 sont des exemples de zone hébergée pour l'équilibreur de charge ELB spécifié par la valeur de. IDs DNSName example-load-balancer-2222222222.us-east-1.elb.amazonaws.com et example-load-balancer -4444444444.us-east-1.elb.amazonaws.com sont des exemples de domaines Elastic Load Balancing à partir desquels Amazon Route 53 répond aux requêtes pour exemple.com. Consultez la documentation Amazon Route 53 pour plus de détails. Vous pouvez utiliser l'Get-R53Changeapplet de commande pour effectuer un sondage afin de déterminer quand les modifications sont terminées.**
```
$change1 = New-Object Amazon.Route53.Model.Change
$change1.Action = "CREATE"
$change1.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change1.ResourceRecordSet.Name = "example.com"
$change1.ResourceRecordSet.Type = "A"
$change1.ResourceRecordSet.SetIdentifier = "1"
$change1.ResourceRecordSet.Weight = 3
$change1.ResourceRecordSet.AliasTarget = New-Object Amazon.Route53.Model.AliasTarget
$change1.ResourceRecordSet.AliasTarget.HostedZoneId = "Z1111111111111"
$change1.ResourceRecordSet.AliasTarget.DNSName = "example-load-balancer-2222222222.us-east-1.elb.amazonaws.com."
$change1.ResourceRecordSet.AliasTarget.EvaluateTargetHealth = $true
$change2 = New-Object Amazon.Route53.Model.Change
$change2.Action = "CREATE"
$change2.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change2.ResourceRecordSet.Name = "example.com"
$change2.ResourceRecordSet.Type = "A"
$change2.ResourceRecordSet.SetIdentifier = "2"
$change2.ResourceRecordSet.Weight = 1
$change2.ResourceRecordSet.AliasTarget = New-Object Amazon.Route53.Model.AliasTarget
$change2.ResourceRecordSet.AliasTarget.HostedZoneId = "Z3333333333333"
$change2.ResourceRecordSet.AliasTarget.DNSName = "example-load-balancer-4444444444.us-east-1.elb.amazonaws.com."
$change2.ResourceRecordSet.AliasTarget.EvaluateTargetHealth = $false
$params = @{
HostedZoneId="Z5555555555"
ChangeBatch_Comment="This change batch creates two weighted alias resource record sets. Amazon Route 53 responds to queries for example.com with the first ELB domain 3/4ths of the times and the second one 1/4th of the time."
ChangeBatch_Change=$change1,$change2
}
Edit-R53ResourceRecordSet @params
```
**Exemple 5 : cet exemple crée deux jeux d’enregistrements de ressources d’alias de latence, l’un pour un équilibreur de charge ELB dans la région USA Ouest (Oregon) (us-west-2) et l’autre pour un équilibreur de charge dans la région Asie-Pacifique (Singapour) (ap-southeast-1). Consultez la documentation Amazon Route 53 pour plus de détails. Vous pouvez utiliser l'Get-R53Changeapplet de commande pour effectuer un sondage afin de déterminer quand les modifications sont terminées.**
```
$change1 = New-Object Amazon.Route53.Model.Change
$change1.Action = "CREATE"
$change1.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change1.ResourceRecordSet.Name = "example.com"
$change1.ResourceRecordSet.Type = "A"
$change1.ResourceRecordSet.SetIdentifier = "Oregon load balancer 1"
$change1.ResourceRecordSet.Region = us-west-2
$change1.ResourceRecordSet.AliasTarget = New-Object Amazon.Route53.Model.AliasTarget
$change1.ResourceRecordSet.AliasTarget.HostedZoneId = "Z1111111111111"
$change1.ResourceRecordSet.AliasTarget.DNSName = "example-load-balancer-2222222222.us-west-2.elb.amazonaws.com"
$change1.ResourceRecordSet.AliasTarget.EvaluateTargetHealth = $true
$change2 = New-Object Amazon.Route53.Model.Change
$change2.Action = "CREATE"
$change2.ResourceRecordSet = New-Object Amazon.Route53.Model.ResourceRecordSet
$change2.ResourceRecordSet.Name = "example.com"
$change2.ResourceRecordSet.Type = "A"
$change2.ResourceRecordSet.SetIdentifier = "Singapore load balancer 1"
$change2.ResourceRecordSet.Region = ap-southeast-1
$change2.ResourceRecordSet.AliasTarget = New-Object Amazon.Route53.Model.AliasTarget
$change2.ResourceRecordSet.AliasTarget.HostedZoneId = "Z2222222222222"
$change2.ResourceRecordSet.AliasTarget.DNSName = "example-load-balancer-1111111111.ap-southeast-1.elb.amazonaws.com"
$change2.ResourceRecordSet.AliasTarget.EvaluateTargetHealth = $true
$params = @{
HostedZoneId="Z5555555555"
ChangeBatch_Comment="This change batch creates two latency resource record sets, one for the US West (Oregon) region and one for the Asia Pacific (Singapore) region."
ChangeBatch_Change=$change1,$change2
}
Edit-R53ResourceRecordSet @params
```
+ Pour plus de détails sur l'API, reportez-vous [ChangeResourceRecordSets](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
------
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de Route 53 avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.
# Utilisation de `CreateHostedZone` avec une CLI
Les exemples de code suivants illustrent comment utiliser `CreateHostedZone`.
------
#### [ CLI ]
**AWS CLI**
**Pour créer une zone hébergée**
La commande `create-hosted-zone` suivante ajoute une zone hébergée nommée `example.com` à l’aide de la référence appelant `2014-04-01-18:47`. Le commentaire facultatif inclut un espace, il doit donc être placé entre guillemets :
```
aws route53 create-hosted-zone --name example.com --caller-reference 2014-04-01-18:47 --hosted-zone-config Comment="command-line version"
```
Pour plus d’informations, consultez Utilisation de zones hébergées dans le *Manuel du développeur Amazon Route 53*.
+ Pour plus de détails sur l'API, reportez-vous [CreateHostedZone](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53/create-hosted-zone.html)à la section *Référence des AWS CLI commandes*.
------
#### [ PowerShell ]
**Outils pour PowerShell V4**
**Exemple 1 : crée une nouvelle zone hébergée nommée « exemple.com », associée à un ensemble de délégations réutilisable Notez que vous devez fournir une valeur pour le CallerReference paramètre afin que les demandes puissent être réessayées si nécessaire sans risquer d'exécuter l'opération deux fois. Comme la zone hébergée est créée dans un VPC, elle est automatiquement privée et vous ne devez pas définir le paramètre - HostedZoneConfig \$1PrivateZone .**
```
$params = @{
Name="example.com"
CallerReference="myUniqueIdentifier"
HostedZoneConfig_Comment="This is my first hosted zone"
DelegationSetId="NZ8X2CISAMPLE"
VPC_VPCId="vpc-1a2b3c4d"
VPC_VPCRegion="us-east-1"
}
New-R53HostedZone @params
```
+ Pour plus de détails sur l'API, reportez-vous [CreateHostedZone](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
**Outils pour PowerShell V5**
**Exemple 1 : crée une nouvelle zone hébergée nommée « exemple.com », associée à un ensemble de délégations réutilisable Notez que vous devez fournir une valeur pour le CallerReference paramètre afin que les demandes puissent être réessayées si nécessaire sans risquer d'exécuter l'opération deux fois. Comme la zone hébergée est créée dans un VPC, elle est automatiquement privée et vous ne devez pas définir le paramètre - HostedZoneConfig \$1PrivateZone .**
```
$params = @{
Name="example.com"
CallerReference="myUniqueIdentifier"
HostedZoneConfig_Comment="This is my first hosted zone"
DelegationSetId="NZ8X2CISAMPLE"
VPC_VPCId="vpc-1a2b3c4d"
VPC_VPCRegion="us-east-1"
}
New-R53HostedZone @params
```
+ Pour plus de détails sur l'API, reportez-vous [CreateHostedZone](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
------
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de Route 53 avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.
# Utilisation de `DeleteHostedZone` avec une CLI
Les exemples de code suivants illustrent comment utiliser `DeleteHostedZone`.
------
#### [ CLI ]
**AWS CLI**
**Pour supprimer une zone hébergée**
La commande `delete-hosted-zone` suivante supprime la zone hébergée avec l’`id` `Z36KTIQEXAMPLE` :
```
aws route53 delete-hosted-zone --id Z36KTIQEXAMPLE
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteHostedZone](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53/delete-hosted-zone.html)à la section *Référence des AWS CLI commandes*.
------
#### [ PowerShell ]
**Outils pour PowerShell V4**
**Exemple 1 : supprime la zone hébergée avec l’ID spécifié. Vous devrez confirmer avant que la commande ne soit exécutée, sauf si vous ajoutez le paramètre de commutation -Force.**
```
Remove-R53HostedZone -Id Z1PA6795UKMFR9
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteHostedZone](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
**Outils pour PowerShell V5**
**Exemple 1 : supprime la zone hébergée avec l’ID spécifié. Vous devrez confirmer avant que la commande ne soit exécutée, sauf si vous ajoutez le paramètre de commutation -Force.**
```
Remove-R53HostedZone -Id Z1PA6795UKMFR9
```
+ Pour plus de détails sur l'API, reportez-vous [DeleteHostedZone](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
------
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de Route 53 avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.
# Utilisation de `GetHostedZone` avec une CLI
Les exemples de code suivants illustrent comment utiliser `GetHostedZone`.
------
#### [ CLI ]
**AWS CLI**
**Pour obtenir les informations sur une zone hébergée**
La commande `get-hosted-zone` suivante obtient des informations sur la zone hébergée qui a l’`id` `Z1R8UBAEXAMPLE` :
```
aws route53 get-hosted-zone --id Z1R8UBAEXAMPLE
```
+ Pour plus de détails sur l'API, reportez-vous [GetHostedZone](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53/get-hosted-zone.html)à la section *Référence des AWS CLI commandes*.
------
#### [ PowerShell ]
**Outils pour PowerShell V4**
**Exemple 1 : Renvoie les détails de la zone hébergée avec l'ID PJN98 FT9 Z1D633.**
```
Get-R53HostedZone -Id Z1D633PJN98FT9
```
+ Pour plus de détails sur l'API, reportez-vous [GetHostedZone](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
**Outils pour PowerShell V5**
**Exemple 1 : Renvoie les détails de la zone hébergée avec l'ID PJN98 FT9 Z1D633.**
```
Get-R53HostedZone -Id Z1D633PJN98FT9
```
+ Pour plus de détails sur l'API, reportez-vous [GetHostedZone](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
------
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de Route 53 avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.
# Utilisation `ListHostedZones` avec un AWS SDK ou une CLI
Les exemples de code suivants illustrent comment utiliser `ListHostedZones`.
------
#### [ CLI ]
**AWS CLI**
**Pour répertorier les zones hébergées associées au AWS compte actuel**
La `list-hosted-zones` commande suivante répertorie les informations récapitulatives sur les 100 premières zones hébergées associées au AWS compte actuel. :
```
aws route53 list-hosted-zones
```
Si vous avez plus de 100 zones hébergées ou si vous souhaitez les répertorier dans des groupes inférieurs à 100, incluez le paramètre `--max-items`. Par exemple, pour répertorier les zones hébergées une par une, utilisez la commande suivante :
```
aws route53 list-hosted-zones --max-items 1
```
Pour afficher les informations relatives à la zone hébergée suivante, prenez la valeur `NextToken` de la réponse à la commande précédente et incluez-la dans le paramètre `--starting-token`, par exemple :
```
aws route53 list-hosted-zones --max-items 1 --starting-token Z3M3LMPEXAMPLE
```
+ Pour plus de détails sur l'API, reportez-vous [ListHostedZones](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53/list-hosted-zones.html)à la section *Référence des AWS CLI commandes*.
------
#### [ PowerShell ]
**Outils pour PowerShell V4**
**Exemple 1 : affiche toutes vos zones hébergées publiques et privées.**
```
Get-R53HostedZoneList
```
**Exemple 2 : affiche toutes les zones hébergées associées à l'ensemble de délégations réutilisable portant l'ID NZ8 X2CISAMPLE**
```
Get-R53HostedZoneList -DelegationSetId NZ8X2CISAMPLE
```
+ Pour plus de détails sur l'API, reportez-vous [ListHostedZones](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
**Outils pour PowerShell V5**
**Exemple 1 : affiche toutes vos zones hébergées publiques et privées.**
```
Get-R53HostedZoneList
```
**Exemple 2 : affiche toutes les zones hébergées associées à l'ensemble de délégations réutilisable portant l'ID NZ8 X2CISAMPLE**
```
Get-R53HostedZoneList -DelegationSetId NZ8X2CISAMPLE
```
+ Pour plus de détails sur l'API, reportez-vous [ListHostedZones](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
------
#### [ Rust ]
**SDK pour Rust**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/route53#code-examples).
```
async fn show_host_info(client: &aws_sdk_route53::Client) -> Result<(), aws_sdk_route53::Error> {
let hosted_zone_count = client.get_hosted_zone_count().send().await?;
println!(
"Number of hosted zones in region : {}",
hosted_zone_count.hosted_zone_count(),
);
let hosted_zones = client.list_hosted_zones().send().await?;
println!("Zones:");
for hz in hosted_zones.hosted_zones() {
let zone_name = hz.name();
let zone_id = hz.id();
println!(" ID : {}", zone_id);
println!(" Name : {}", zone_name);
println!();
}
Ok(())
}
```
+ Pour plus de détails sur l'API, voir [ListHostedZones](https://docs.rs/aws-sdk-route53/latest/aws_sdk_route53/client/struct.Client.html#method.list_hosted_zones)la section de *référence de l'API AWS SDK for Rust*.
------
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de Route 53 avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.
# Utilisation de `ListHostedZonesByName` avec une CLI
Les exemples de code suivants illustrent comment utiliser `ListHostedZonesByName`.
------
#### [ CLI ]
**AWS CLI**
La commande suivante crée une liste de 100 zones hébergées maximum, classées par nom de domaine :
```
aws route53 list-hosted-zones-by-name
```
Sortie :
```
{
"HostedZones": [
{
"ResourceRecordSetCount": 2,
"CallerReference": "test20150527-2",
"Config": {
"Comment": "test2",
"PrivateZone": false
},
"Id": "/hostedzone/Z119WBBTVP5WFX",
"Name": "2.example.com."
},
{
"ResourceRecordSetCount": 2,
"CallerReference": "test20150527-1",
"Config": {
"Comment": "test",
"PrivateZone": false
},
"Id": "/hostedzone/Z3P5QSUBK4POTI",
"Name": "www.example.com."
}
],
"IsTruncated": false,
"MaxItems": "100"
}
```
La commande suivante crée une liste des zones hébergées classées par nom, commençant par `www.example.com` :
```
aws route53 list-hosted-zones-by-name --dns-name www.example.com
```
Sortie :
```
{
"HostedZones": [
{
"ResourceRecordSetCount": 2,
"CallerReference": "mwunderl20150527-1",
"Config": {
"Comment": "test",
"PrivateZone": false
},
"Id": "/hostedzone/Z3P5QSUBK4POTI",
"Name": "www.example.com."
}
],
"DNSName": "www.example.com",
"IsTruncated": false,
"MaxItems": "100"
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListHostedZonesByName](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53/list-hosted-zones-by-name.html)à la section *Référence des AWS CLI commandes*.
------
#### [ PowerShell ]
**Outils pour PowerShell V4**
**Exemple 1 : renvoie toutes vos zones hébergées publiques et privées dans l’ordre ASCII par nom de domaine.**
```
Get-R53HostedZonesByName
```
**Exemple 2 : renvoie vos zones hébergées publiques et privées, dans l’ordre ASCII par nom de domaine, en commençant par le nom DNS spécifié.**
```
Get-R53HostedZonesByName -DnsName example2.com
```
+ Pour plus de détails sur l'API, reportez-vous [ListHostedZonesByName](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
**Outils pour PowerShell V5**
**Exemple 1 : renvoie toutes vos zones hébergées publiques et privées dans l’ordre ASCII par nom de domaine.**
```
Get-R53HostedZonesByName
```
**Exemple 2 : renvoie vos zones hébergées publiques et privées, dans l’ordre ASCII par nom de domaine, en commençant par le nom DNS spécifié.**
```
Get-R53HostedZonesByName -DnsName example2.com
```
+ Pour plus de détails sur l'API, reportez-vous [ListHostedZonesByName](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
------
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de Route 53 avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.
# Utilisation de `ListQueryLoggingConfigs` avec une CLI
Les exemples de code suivants illustrent comment utiliser `ListQueryLoggingConfigs`.
------
#### [ CLI ]
**AWS CLI**
**Pour créer une liste des configurations de journalisation de requêtes**
L'`list-query-logging-configs`exemple suivant répertorie les informations relatives aux 100 premières configurations de journalisation des requêtes de votre AWS compte, pour la zone hébergée`Z1OX3WQEXAMPLE`.
```
aws route53 list-query-logging-configs \
--hosted-zone-id Z1OX3WQEXAMPLE
```
Sortie :
```
{
"QueryLoggingConfigs": [
{
"Id": "964ff34e-ae03-4f06-80a2-9683cexample",
"HostedZoneId": "Z1OX3WQEXAMPLE",
"CloudWatchLogsLogGroupArn": "arn:aws:logs:us-east-1:111122223333:log-group:/aws/route53/example.com:*"
}
]
}
```
Pour plus d’informations, consultez [Journalisation des requêtes DNS](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/query-logs.html) dans le *Manuel du développeur Amazon Route 53*.
+ Pour plus de détails sur l'API, reportez-vous [ListQueryLoggingConfigs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53/list-query-logging-configs.html)à la section *Référence des AWS CLI commandes*.
------
#### [ PowerShell ]
**Outils pour PowerShell V4**
**Exemple 1 : cet exemple renvoie toutes les configurations de journalisation de requêtes DNS qui sont associées au Compte AWS actuel.**
```
Get-R53QueryLoggingConfigList
```
**Sortie** :
```
Id HostedZoneId CloudWatchLogsLogGroupArn
-- ------------ -------------------------
59b0fa33-4fea-4471-a88c-926476aaa40d Z385PDS6EAAAZR arn:aws:logs:us-east-1:111111111112:log-group:/aws/route53/example1.com:*
ee528e95-4e03-4fdc-9d28-9e24ddaaa063 Z94SJHBV1AAAAZ arn:aws:logs:us-east-1:111111111112:log-group:/aws/route53/example2.com:*
e38dddda-ceb6-45c1-8cb7-f0ae56aaaa2b Z3MEQ8T7AAA1BF arn:aws:logs:us-east-1:111111111112:log-group:/aws/route53/example3.com:*
```
+ Pour plus de détails sur l'API, reportez-vous [ListQueryLoggingConfigs](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*.
**Outils pour PowerShell V5**
**Exemple 1 : cet exemple renvoie toutes les configurations de journalisation de requêtes DNS qui sont associées au Compte AWS actuel.**
```
Get-R53QueryLoggingConfigList
```
**Sortie** :
```
Id HostedZoneId CloudWatchLogsLogGroupArn
-- ------------ -------------------------
59b0fa33-4fea-4471-a88c-926476aaa40d Z385PDS6EAAAZR arn:aws:logs:us-east-1:111111111112:log-group:/aws/route53/example1.com:*
ee528e95-4e03-4fdc-9d28-9e24ddaaa063 Z94SJHBV1AAAAZ arn:aws:logs:us-east-1:111111111112:log-group:/aws/route53/example2.com:*
e38dddda-ceb6-45c1-8cb7-f0ae56aaaa2b Z3MEQ8T7AAA1BF arn:aws:logs:us-east-1:111111111112:log-group:/aws/route53/example3.com:*
```
+ Pour plus de détails sur l'API, reportez-vous [ListQueryLoggingConfigs](https://docs.aws.amazon.com/powershell/v5/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V5)*.
------
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de Route 53 avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.
# Exemples de code pour l'enregistrement de domaines Route 53 à l'aide de AWS SDKs
Les exemples de code suivants montrent comment utiliser l'enregistrement de domaine Route 53 avec un kit de développement AWS logiciel (SDK).
Les *principes de base* sont des exemples de code qui vous montrent comment effectuer les opérations essentielles au sein d’un service.
Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de Route 53 avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.
**Contents**
+ [Principes de base](service_code_examples_route-53-domains_basics.md)
+ [Bonjour Enregistrement de domaine Route 53](route-53-domains_example_route-53-domains_Hello_section.md)
+ [Principes de base](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
+ [Actions](service_code_examples_route-53-domains_actions.md)
+ [`CheckDomainAvailability`](route-53-domains_example_route-53-domains_CheckDomainAvailability_section.md)
+ [`CheckDomainTransferability`](route-53-domains_example_route-53-domains_CheckDomainTransferability_section.md)
+ [`GetDomainDetail`](route-53-domains_example_route-53-domains_GetDomainDetail_section.md)
+ [`GetDomainSuggestions`](route-53-domains_example_route-53-domains_GetDomainSuggestions_section.md)
+ [`GetOperationDetail`](route-53-domains_example_route-53-domains_GetOperationDetail_section.md)
+ [`ListDomains`](route-53-domains_example_route-53-domains_ListDomains_section.md)
+ [`ListOperations`](route-53-domains_example_route-53-domains_ListOperations_section.md)
+ [`ListPrices`](route-53-domains_example_route-53-domains_ListPrices_section.md)
+ [`RegisterDomain`](route-53-domains_example_route-53-domains_RegisterDomain_section.md)
+ [`ViewBilling`](route-53-domains_example_route-53-domains_ViewBilling_section.md)
# Exemples de base pour l'enregistrement de domaines Route 53 à l'aide de AWS SDKs
Les exemples de code suivants montrent comment utiliser les principes de base de Amazon Route 53 domain registration with AWS SDKs.
**Contents**
+ [Bonjour Enregistrement de domaine Route 53](route-53-domains_example_route-53-domains_Hello_section.md)
+ [Principes de base](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
+ [Actions](service_code_examples_route-53-domains_actions.md)
+ [`CheckDomainAvailability`](route-53-domains_example_route-53-domains_CheckDomainAvailability_section.md)
+ [`CheckDomainTransferability`](route-53-domains_example_route-53-domains_CheckDomainTransferability_section.md)
+ [`GetDomainDetail`](route-53-domains_example_route-53-domains_GetDomainDetail_section.md)
+ [`GetDomainSuggestions`](route-53-domains_example_route-53-domains_GetDomainSuggestions_section.md)
+ [`GetOperationDetail`](route-53-domains_example_route-53-domains_GetOperationDetail_section.md)
+ [`ListDomains`](route-53-domains_example_route-53-domains_ListDomains_section.md)
+ [`ListOperations`](route-53-domains_example_route-53-domains_ListOperations_section.md)
+ [`ListPrices`](route-53-domains_example_route-53-domains_ListPrices_section.md)
+ [`RegisterDomain`](route-53-domains_example_route-53-domains_RegisterDomain_section.md)
+ [`ViewBilling`](route-53-domains_example_route-53-domains_ViewBilling_section.md)
# Bonjour Enregistrement de domaine Route 53
Les exemples de code suivants montrent comment démarrer avec l’enregistrement de domaine Route 53.
------
#### [ .NET ]
**SDK pour .NET**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples).
```
public static class HelloRoute53Domains
{
static async Task Main(string[] args)
{
// Use the AWS .NET Core Setup package to set up dependency injection for the Amazon Route 53 domain registration service.
// Use your AWS profile name, or leave it blank to use the default profile.
using var host = Host.CreateDefaultBuilder(args)
.ConfigureServices((_, services) =>
services.AddAWSService()
).Build();
// Now the client is available for injection.
var route53Client = host.Services.GetRequiredService();
// You can use await and any of the async methods to get a response.
var response = await route53Client.ListPricesAsync(new ListPricesRequest { Tld = "com" });
Console.WriteLine($"Hello Amazon Route 53 Domains! Following are prices for .com domain operations:");
var comPrices = response.Prices.FirstOrDefault();
if (comPrices != null)
{
Console.WriteLine($"\tRegistration: {comPrices.RegistrationPrice?.Price} {comPrices.RegistrationPrice?.Currency}");
Console.WriteLine($"\tRenewal: {comPrices.RenewalPrice?.Price} {comPrices.RenewalPrice?.Currency}");
}
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListPrices](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/ListPrices)à la section *Référence des AWS SDK pour .NET API*.
------
#### [ Java ]
**SDK pour Java 2.x**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples).
```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.route53domains.Route53DomainsClient;
import software.amazon.awssdk.services.route53.model.Route53Exception;
import software.amazon.awssdk.services.route53domains.model.DomainPrice;
import software.amazon.awssdk.services.route53domains.model.ListPricesRequest;
import software.amazon.awssdk.services.route53domains.model.ListPricesResponse;
import java.util.List;
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*
* This Java code examples performs the following operation:
*
* 1. Invokes ListPrices for at least one domain type, such as the “com” type
* and displays the prices for Registration and Renewal.
*
*/
public class HelloRoute53 {
public static final String DASHES = new String(new char[80]).replace("\0", "-");
public static void main(String[] args) {
final String usage = "\n" +
"Usage:\n" +
" \n\n" +
"Where:\n" +
" hostedZoneId - The id value of an existing hosted zone. \n";
if (args.length != 1) {
System.out.println(usage);
System.exit(1);
}
String domainType = args[0];
Region region = Region.US_EAST_1;
Route53DomainsClient route53DomainsClient = Route53DomainsClient.builder()
.region(region)
.build();
System.out.println(DASHES);
System.out.println("Invokes ListPrices for at least one domain type.");
listPrices(route53DomainsClient, domainType);
System.out.println(DASHES);
}
public static void listPrices(Route53DomainsClient route53DomainsClient, String domainType) {
try {
ListPricesRequest pricesRequest = ListPricesRequest.builder()
.maxItems(10)
.tld(domainType)
.build();
ListPricesResponse response = route53DomainsClient.listPrices(pricesRequest);
List prices = response.prices();
for (DomainPrice pr : prices) {
System.out.println("Name: " + pr.name());
System.out.println(
"Registration: " + pr.registrationPrice().price() + " " + pr.registrationPrice().currency());
System.out.println("Renewal: " + pr.renewalPrice().price() + " " + pr.renewalPrice().currency());
System.out.println("Transfer: " + pr.transferPrice().price() + " " + pr.transferPrice().currency());
System.out.println("Transfer: " + pr.transferPrice().price() + " " + pr.transferPrice().currency());
System.out.println("Change Ownership: " + pr.changeOwnershipPrice().price() + " "
+ pr.changeOwnershipPrice().currency());
System.out.println(
"Restoration: " + pr.restorationPrice().price() + " " + pr.restorationPrice().currency());
System.out.println(" ");
}
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListPrices](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ListPrices)à la section *Référence des AWS SDK for Java 2.x API*.
------
#### [ Kotlin ]
**SDK pour Kotlin**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples).
```
/**
Before running this Kotlin code example, set up your development environment,
including your credentials.
For more information, see the following documentation topic:
https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/setup.html
*/
suspend fun main(args: Array) {
val usage = """
Usage:
Where:
domainType - The domain type (for example, com).
"""
if (args.size != 1) {
println(usage)
exitProcess(0)
}
val domainType = args[0]
println("Invokes ListPrices using a Paginated method.")
listPricesPaginated(domainType)
}
suspend fun listPricesPaginated(domainType: String) {
val pricesRequest =
ListPricesRequest {
maxItems = 10
tld = domainType
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
route53DomainsClient
.listPricesPaginated(pricesRequest)
.transform { it.prices?.forEach { obj -> emit(obj) } }
.collect { pr ->
println("Registration: ${pr.registrationPrice} ${pr.registrationPrice?.currency}")
println("Renewal: ${pr.renewalPrice?.price} ${pr.renewalPrice?.currency}")
println("Transfer: ${pr.transferPrice?.price} ${pr.transferPrice?.currency}")
println("Restoration: ${pr.restorationPrice?.price} ${pr.restorationPrice?.currency}")
}
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListPrices](https://sdk.amazonaws.com/kotlin/api/latest/index.html)à la section *AWS SDK pour la référence de l'API Kotlin*.
------
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de Route 53 avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.
# Découvrez les bases de l'enregistrement de domaines Route 53 à l'aide d'un AWS SDK
Les exemples de code suivants montrent comment :
+ Répertorier les domaines actuels et les opérations effectuées au cours de l’année écoulée.
+ Afficher la facturation de l’année écoulée et les prix des types de domaines.
+ Obtenir des suggestions de domaines.
+ Vérifier la disponibilité et la transférabilité du domaine.
+ Éventuellement, demander l’enregistrement d’un domaine.
+ Obtenir des informations sur une opération.
+ Éventuellement, obtenir des informations sur un domaine.
------
#### [ .NET ]
**SDK pour .NET**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples).
Exécutez un scénario interactif à une invite de commande.
```
public static class Route53DomainScenario
{
/*
Before running this .NET code example, set up your development environment, including your credentials.
This .NET example performs the following tasks:
1. List current domains.
2. List operations in the past year.
3. View billing for the account in the past year.
4. View prices for domain types.
5. Get domain suggestions.
6. Check domain availability.
7. Check domain transferability.
8. Optionally, request a domain registration.
9. Get an operation detail.
10. Optionally, get a domain detail.
*/
private static Route53Wrapper _route53Wrapper = null!;
private static IConfiguration _configuration = null!;
static async Task Main(string[] args)
{
// Set up dependency injection for the Amazon service.
using var host = Host.CreateDefaultBuilder(args)
.ConfigureLogging(logging =>
logging.AddFilter("System", LogLevel.Debug)
.AddFilter("Microsoft", LogLevel.Information)
.AddFilter("Microsoft", LogLevel.Trace))
.ConfigureServices((_, services) =>
services.AddAWSService()
.AddTransient()
)
.Build();
_configuration = new ConfigurationBuilder()
.SetBasePath(Directory.GetCurrentDirectory())
.AddJsonFile("settings.json") // Load settings from .json file.
.AddJsonFile("settings.local.json",
true) // Optionally, load local settings.
.Build();
var logger = LoggerFactory.Create(builder =>
{
builder.AddConsole();
}).CreateLogger(typeof(Route53DomainScenario));
_route53Wrapper = host.Services.GetRequiredService();
Console.WriteLine(new string('-', 80));
Console.WriteLine("Welcome to the Amazon Route 53 domains example scenario.");
Console.WriteLine(new string('-', 80));
try
{
await ListDomains();
await ListOperations();
await ListBillingRecords();
await ListPrices();
await ListDomainSuggestions();
await CheckDomainAvailability();
await CheckDomainTransferability();
var operationId = await RequestDomainRegistration();
await GetOperationalDetail(operationId);
await GetDomainDetails();
}
catch (Exception ex)
{
logger.LogError(ex, "There was a problem executing the scenario.");
}
Console.WriteLine(new string('-', 80));
Console.WriteLine("The Amazon Route 53 domains example scenario is complete.");
Console.WriteLine(new string('-', 80));
}
///
/// List account registered domains.
///
/// Async task.
private static async Task ListDomains()
{
Console.WriteLine(new string('-', 80));
Console.WriteLine($"1. List account domains.");
var domains = await _route53Wrapper.ListDomains();
for (int i = 0; i < domains.Count; i++)
{
Console.WriteLine($"\t{i + 1}. {domains[i].DomainName}");
}
if (!domains.Any())
{
Console.WriteLine("\tNo domains found in this account.");
}
Console.WriteLine(new string('-', 80));
}
///
/// List domain operations in the past year.
///
/// Async task.
private static async Task ListOperations()
{
Console.WriteLine(new string('-', 80));
Console.WriteLine($"2. List account domain operations in the past year.");
var operations = await _route53Wrapper.ListOperations(
DateTime.Today.AddYears(-1));
for (int i = 0; i < operations.Count; i++)
{
Console.WriteLine($"\tOperation Id: {operations[i].OperationId}");
Console.WriteLine($"\tStatus: {operations[i].Status}");
Console.WriteLine($"\tDate: {operations[i].SubmittedDate}");
}
Console.WriteLine(new string('-', 80));
}
///
/// List billing in the past year.
///
/// Async task.
private static async Task ListBillingRecords()
{
Console.WriteLine(new string('-', 80));
Console.WriteLine($"3. View billing for the account in the past year.");
var billingRecords = await _route53Wrapper.ViewBilling(
DateTime.Today.AddYears(-1),
DateTime.Today);
for (int i = 0; i < billingRecords.Count; i++)
{
Console.WriteLine($"\tBill Date: {billingRecords[i].BillDate.ToShortDateString()}");
Console.WriteLine($"\tOperation: {billingRecords[i].Operation}");
Console.WriteLine($"\tPrice: {billingRecords[i].Price}");
}
if (!billingRecords.Any())
{
Console.WriteLine("\tNo billing records found in this account for the past year.");
}
Console.WriteLine(new string('-', 80));
}
///
/// List prices for a few domain types.
///
/// Async task.
private static async Task ListPrices()
{
Console.WriteLine(new string('-', 80));
Console.WriteLine($"4. View prices for domain types.");
var domainTypes = new List { "net", "com", "org", "co" };
var prices = await _route53Wrapper.ListPrices(domainTypes);
foreach (var pr in prices)
{
Console.WriteLine($"\tName: {pr.Name}");
Console.WriteLine($"\tRegistration: {pr.RegistrationPrice?.Price} {pr.RegistrationPrice?.Currency}");
Console.WriteLine($"\tRenewal: {pr.RenewalPrice?.Price} {pr.RenewalPrice?.Currency}");
Console.WriteLine($"\tTransfer: {pr.TransferPrice?.Price} {pr.TransferPrice?.Currency}");
Console.WriteLine($"\tChange Ownership: {pr.ChangeOwnershipPrice?.Price} {pr.ChangeOwnershipPrice?.Currency}");
Console.WriteLine($"\tRestoration: {pr.RestorationPrice?.Price} {pr.RestorationPrice?.Currency}");
Console.WriteLine();
}
Console.WriteLine(new string('-', 80));
}
///
/// List domain suggestions for a domain name.
///
/// Async task.
private static async Task ListDomainSuggestions()
{
Console.WriteLine(new string('-', 80));
Console.WriteLine($"5. Get domain suggestions.");
string? domainName = null;
while (domainName == null || string.IsNullOrWhiteSpace(domainName))
{
Console.WriteLine($"Enter a domain name to get available domain suggestions.");
domainName = Console.ReadLine();
}
var suggestions = await _route53Wrapper.GetDomainSuggestions(domainName, true, 5);
foreach (var suggestion in suggestions)
{
Console.WriteLine($"\tSuggestion Name: {suggestion.DomainName}");
Console.WriteLine($"\tAvailability: {suggestion.Availability}");
}
Console.WriteLine(new string('-', 80));
}
///
/// Check availability for a domain name.
///
/// Async task.
private static async Task CheckDomainAvailability()
{
Console.WriteLine(new string('-', 80));
Console.WriteLine($"6. Check domain availability.");
string? domainName = null;
while (domainName == null || string.IsNullOrWhiteSpace(domainName))
{
Console.WriteLine($"Enter a domain name to check domain availability.");
domainName = Console.ReadLine();
}
var availability = await _route53Wrapper.CheckDomainAvailability(domainName);
Console.WriteLine($"\tAvailability: {availability}");
Console.WriteLine(new string('-', 80));
}
///
/// Check transferability for a domain name.
///
/// Async task.
private static async Task CheckDomainTransferability()
{
Console.WriteLine(new string('-', 80));
Console.WriteLine($"7. Check domain transferability.");
string? domainName = null;
while (domainName == null || string.IsNullOrWhiteSpace(domainName))
{
Console.WriteLine($"Enter a domain name to check domain transferability.");
domainName = Console.ReadLine();
}
var transferability = await _route53Wrapper.CheckDomainTransferability(domainName);
Console.WriteLine($"\tTransferability: {transferability}");
Console.WriteLine(new string('-', 80));
}
///
/// Check transferability for a domain name.
///
/// Async task.
private static async Task RequestDomainRegistration()
{
Console.WriteLine(new string('-', 80));
Console.WriteLine($"8. Optionally, request a domain registration.");
Console.WriteLine($"\tNote: This example uses domain request settings in settings.json.");
Console.WriteLine($"\tTo change the domain registration settings, set the values in that file.");
Console.WriteLine($"\tRemember, registering an actual domain will incur an account billing cost.");
Console.WriteLine($"\tWould you like to begin a domain registration? (y/n)");
var ynResponse = Console.ReadLine();
if (ynResponse != null && ynResponse.Equals("y", StringComparison.InvariantCultureIgnoreCase))
{
string domainName = _configuration["DomainName"];
ContactDetail contact = new ContactDetail();
contact.CountryCode = CountryCode.FindValue(_configuration["Contact:CountryCode"]);
contact.ContactType = ContactType.FindValue(_configuration["Contact:ContactType"]);
_configuration.GetSection("Contact").Bind(contact);
var operationId = await _route53Wrapper.RegisterDomain(
domainName,
Convert.ToBoolean(_configuration["AutoRenew"]),
Convert.ToInt32(_configuration["DurationInYears"]),
contact);
if (operationId != null)
{
Console.WriteLine(
$"\tRegistration requested. Operation Id: {operationId}");
}
return operationId;
}
Console.WriteLine(new string('-', 80));
return null;
}
///
/// Get details for an operation.
///
/// Async task.
private static async Task GetOperationalDetail(string? operationId)
{
Console.WriteLine(new string('-', 80));
Console.WriteLine($"9. Get an operation detail.");
var operationDetails =
await _route53Wrapper.GetOperationDetail(operationId);
Console.WriteLine(operationDetails);
Console.WriteLine(new string('-', 80));
}
///
/// Optionally, get details for a registered domain.
///
/// Async task.
private static async Task GetDomainDetails()
{
Console.WriteLine(new string('-', 80));
Console.WriteLine($"10. Get details on a domain.");
Console.WriteLine($"\tNote: you must have a registered domain to get details.");
Console.WriteLine($"\tWould you like to get domain details? (y/n)");
var ynResponse = Console.ReadLine();
if (ynResponse != null && ynResponse.Equals("y", StringComparison.InvariantCultureIgnoreCase))
{
string? domainName = null;
while (domainName == null)
{
Console.WriteLine($"\tEnter a domain name to get details.");
domainName = Console.ReadLine();
}
var domainDetails = await _route53Wrapper.GetDomainDetail(domainName);
Console.WriteLine(domainDetails);
}
Console.WriteLine(new string('-', 80));
return null;
}
}
```
Méthodes d’encapsulation utilisées par le scénario pour les actions d’enregistrement de domaine Route 53.
```
public class Route53Wrapper
{
private readonly IAmazonRoute53Domains _amazonRoute53Domains;
private readonly ILogger _logger;
public Route53Wrapper(IAmazonRoute53Domains amazonRoute53Domains, ILogger logger)
{
_amazonRoute53Domains = amazonRoute53Domains;
_logger = logger;
}
///
/// List prices for domain type operations.
///
/// Domain types to include in the results.
/// The list of domain prices.
public async Task> ListPrices(List domainTypes)
{
var results = new List();
var paginatePrices = _amazonRoute53Domains.Paginators.ListPrices(new ListPricesRequest());
// Get the entire list using the paginator.
await foreach (var prices in paginatePrices.Prices)
{
results.Add(prices);
}
return results.Where(p => domainTypes.Contains(p.Name)).ToList();
}
///
/// Check the availability of a domain name.
///
/// The domain to check for availability.
/// An availability result string.
public async Task CheckDomainAvailability(string domain)
{
var result = await _amazonRoute53Domains.CheckDomainAvailabilityAsync(
new CheckDomainAvailabilityRequest
{
DomainName = domain
}
);
return result.Availability.Value;
}
///
/// Check the transferability of a domain name.
///
/// The domain to check for transferability.
/// A transferability result string.
public async Task CheckDomainTransferability(string domain)
{
var result = await _amazonRoute53Domains.CheckDomainTransferabilityAsync(
new CheckDomainTransferabilityRequest
{
DomainName = domain
}
);
return result.Transferability.Transferable.Value;
}
///
/// Get a list of suggestions for a given domain.
///
/// The domain to check for suggestions.
/// If true, only returns available domains.
/// The number of suggestions to return. Defaults to the max of 50.
/// A collection of domain suggestions.
public async Task> GetDomainSuggestions(string domain, bool onlyAvailable, int suggestionCount = 50)
{
var result = await _amazonRoute53Domains.GetDomainSuggestionsAsync(
new GetDomainSuggestionsRequest
{
DomainName = domain,
OnlyAvailable = onlyAvailable,
SuggestionCount = suggestionCount
}
);
return result.SuggestionsList;
}
///
/// Get details for a domain action operation.
///
/// The operational Id.
/// A string describing the operational details.
public async Task GetOperationDetail(string? operationId)
{
if (operationId == null)
return "Unable to get operational details because ID is null.";
try
{
var operationDetails =
await _amazonRoute53Domains.GetOperationDetailAsync(
new GetOperationDetailRequest
{
OperationId = operationId
}
);
var details = $"\tOperation {operationId}:\n" +
$"\tFor domain {operationDetails.DomainName} on {operationDetails.SubmittedDate.ToShortDateString()}.\n" +
$"\tMessage is {operationDetails.Message}.\n" +
$"\tStatus is {operationDetails.Status}.\n";
return details;
}
catch (AmazonRoute53DomainsException ex)
{
return $"Unable to get operation details. Here's why: {ex.Message}.";
}
}
///
/// Initiate a domain registration request.
///
/// Contact details.
/// The domain name to register.
/// True if the domain should automatically renew.
/// The duration in years for the domain registration.
/// The operation Id.
public async Task RegisterDomain(string domainName, bool autoRenew, int duration, ContactDetail contact)
{
// This example uses the same contact information for admin, registrant, and tech contacts.
try
{
var result = await _amazonRoute53Domains.RegisterDomainAsync(
new RegisterDomainRequest()
{
AdminContact = contact,
RegistrantContact = contact,
TechContact = contact,
DomainName = domainName,
AutoRenew = autoRenew,
DurationInYears = duration,
PrivacyProtectAdminContact = false,
PrivacyProtectRegistrantContact = false,
PrivacyProtectTechContact = false
}
);
return result.OperationId;
}
catch (InvalidInputException)
{
_logger.LogInformation($"Unable to request registration for domain {domainName}");
return null;
}
}
///
/// View billing records for the account between a start and end date.
///
/// The start date for billing results.
/// The end date for billing results.
/// A collection of billing records.
public async Task> ViewBilling(DateTime startDate, DateTime endDate)
{
var results = new List();
var paginateBilling = _amazonRoute53Domains.Paginators.ViewBilling(
new ViewBillingRequest()
{
Start = startDate,
End = endDate
});
// Get the entire list using the paginator.
await foreach (var billingRecords in paginateBilling.BillingRecords)
{
results.Add(billingRecords);
}
return results;
}
///
/// List the domains for the account.
///
/// A collection of domain summary records.
public async Task> ListDomains()
{
var results = new List();
var paginateDomains = _amazonRoute53Domains.Paginators.ListDomains(
new ListDomainsRequest());
// Get the entire list using the paginator.
await foreach (var domain in paginateDomains.Domains)
{
results.Add(domain);
}
return results;
}
///
/// List operations for the account that are submitted after a specified date.
///
/// A collection of operation summary records.
public async Task> ListOperations(DateTime submittedSince)
{
var results = new List();
var paginateOperations = _amazonRoute53Domains.Paginators.ListOperations(
new ListOperationsRequest()
{
SubmittedSince = submittedSince
});
// Get the entire list using the paginator.
await foreach (var operations in paginateOperations.Operations)
{
results.Add(operations);
}
return results;
}
///
/// Get details for a domain.
///
/// A string with detail information about the domain.
public async Task GetDomainDetail(string domainName)
{
try
{
var result = await _amazonRoute53Domains.GetDomainDetailAsync(
new GetDomainDetailRequest()
{
DomainName = domainName
});
var details = $"\tDomain {domainName}:\n" +
$"\tCreated on {result.CreationDate.ToShortDateString()}.\n" +
$"\tAdmin contact is {result.AdminContact.Email}.\n" +
$"\tAuto-renew is {result.AutoRenew}.\n";
return details;
}
catch (InvalidInputException)
{
return $"Domain {domainName} was not found in your account.";
}
}
}
```
+ Pour plus de détails sur l’API, consultez les rubriques suivantes dans la *Référence des API du kit AWS SDK pour .NET *.
+ [CheckDomainAvailability](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/CheckDomainAvailability)
+ [CheckDomainTransferability](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/CheckDomainTransferability)
+ [GetDomainDetail](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/GetDomainDetail)
+ [GetDomainSuggestions](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/GetDomainSuggestions)
+ [GetOperationDetail](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/GetOperationDetail)
+ [ListDomains](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/ListDomains)
+ [ListOperations](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/ListOperations)
+ [ListPrices](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/ListPrices)
+ [RegisterDomain](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/RegisterDomain)
+ [ViewBilling](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/ViewBilling)
------
#### [ Java ]
**SDK pour Java 2.x**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples).
```
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*
* This example uses pagination methods where applicable. For example, to list
* domains, the
* listDomainsPaginator method is used. For more information about pagination,
* see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/pagination.html
*
* This Java code example performs the following operations:
*
* 1. List current domains.
* 2. List operations in the past year.
* 3. View billing for the account in the past year.
* 4. View prices for domain types.
* 5. Get domain suggestions.
* 6. Check domain availability.
* 7. Check domain transferability.
* 8. Request a domain registration.
* 9. Get operation details.
* 10. Optionally, get domain details.
*/
public class Route53Scenario {
public static final String DASHES = new String(new char[80]).replace("\0", "-");
public static void main(String[] args) {
final String usage = """
Usage:
Where:
domainType - The domain type (for example, com).\s
phoneNumber - The phone number to use (for example, +91.9966564xxx) email - The email address to use. domainSuggestion - The domain suggestion (for example, findmy.accountants).\s
firstName - The first name to use to register a domain.\s
lastName - The last name to use to register a domain.\s
city - the city to use to register a domain.\s
""";
if (args.length != 7) {
System.out.println(usage);
System.exit(1);
}
String domainType = args[0];
String phoneNumber = args[1];
String email = args[2];
String domainSuggestion = args[3];
String firstName = args[4];
String lastName = args[5];
String city = args[6];
Region region = Region.US_EAST_1;
Route53DomainsClient route53DomainsClient = Route53DomainsClient.builder()
.region(region)
.build();
System.out.println(DASHES);
System.out.println("Welcome to the Amazon Route 53 domains example scenario.");
System.out.println(DASHES);
System.out.println(DASHES);
System.out.println("1. List current domains.");
listDomains(route53DomainsClient);
System.out.println(DASHES);
System.out.println(DASHES);
System.out.println("2. List operations in the past year.");
listOperations(route53DomainsClient);
System.out.println(DASHES);
System.out.println(DASHES);
System.out.println("3. View billing for the account in the past year.");
listBillingRecords(route53DomainsClient);
System.out.println(DASHES);
System.out.println(DASHES);
System.out.println("4. View prices for domain types.");
listPrices(route53DomainsClient, domainType);
System.out.println(DASHES);
System.out.println(DASHES);
System.out.println("5. Get domain suggestions.");
listDomainSuggestions(route53DomainsClient, domainSuggestion);
System.out.println(DASHES);
System.out.println(DASHES);
System.out.println("6. Check domain availability.");
checkDomainAvailability(route53DomainsClient, domainSuggestion);
System.out.println(DASHES);
System.out.println(DASHES);
System.out.println("7. Check domain transferability.");
checkDomainTransferability(route53DomainsClient, domainSuggestion);
System.out.println(DASHES);
System.out.println(DASHES);
System.out.println("8. Request a domain registration.");
String opId = requestDomainRegistration(route53DomainsClient, domainSuggestion, phoneNumber, email, firstName,
lastName, city);
System.out.println(DASHES);
System.out.println(DASHES);
System.out.println("9. Get operation details.");
getOperationalDetail(route53DomainsClient, opId);
System.out.println(DASHES);
System.out.println(DASHES);
System.out.println("10. Get domain details.");
System.out.println("Note: You must have a registered domain to get details.");
System.out.println("Otherwise, an exception is thrown that states ");
System.out.println("Domain xxxxxxx not found in xxxxxxx account.");
getDomainDetails(route53DomainsClient, domainSuggestion);
System.out.println(DASHES);
}
public static void getDomainDetails(Route53DomainsClient route53DomainsClient, String domainSuggestion) {
try {
GetDomainDetailRequest detailRequest = GetDomainDetailRequest.builder()
.domainName(domainSuggestion)
.build();
GetDomainDetailResponse response = route53DomainsClient.getDomainDetail(detailRequest);
System.out.println("The contact first name is " + response.registrantContact().firstName());
System.out.println("The contact last name is " + response.registrantContact().lastName());
System.out.println("The contact org name is " + response.registrantContact().organizationName());
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
public static void getOperationalDetail(Route53DomainsClient route53DomainsClient, String operationId) {
try {
GetOperationDetailRequest detailRequest = GetOperationDetailRequest.builder()
.operationId(operationId)
.build();
GetOperationDetailResponse response = route53DomainsClient.getOperationDetail(detailRequest);
System.out.println("Operation detail message is " + response.message());
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
public static String requestDomainRegistration(Route53DomainsClient route53DomainsClient,
String domainSuggestion,
String phoneNumber,
String email,
String firstName,
String lastName,
String city) {
try {
ContactDetail contactDetail = ContactDetail.builder()
.contactType(ContactType.COMPANY)
.state("LA")
.countryCode(CountryCode.IN)
.email(email)
.firstName(firstName)
.lastName(lastName)
.city(city)
.phoneNumber(phoneNumber)
.organizationName("My Org")
.addressLine1("My Address")
.zipCode("123 123")
.build();
RegisterDomainRequest domainRequest = RegisterDomainRequest.builder()
.adminContact(contactDetail)
.registrantContact(contactDetail)
.techContact(contactDetail)
.domainName(domainSuggestion)
.autoRenew(true)
.durationInYears(1)
.build();
RegisterDomainResponse response = route53DomainsClient.registerDomain(domainRequest);
System.out.println("Registration requested. Operation Id: " + response.operationId());
return response.operationId();
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
return "";
}
public static void checkDomainTransferability(Route53DomainsClient route53DomainsClient, String domainSuggestion) {
try {
CheckDomainTransferabilityRequest transferabilityRequest = CheckDomainTransferabilityRequest.builder()
.domainName(domainSuggestion)
.build();
CheckDomainTransferabilityResponse response = route53DomainsClient
.checkDomainTransferability(transferabilityRequest);
System.out.println("Transferability: " + response.transferability().transferable().toString());
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
public static void checkDomainAvailability(Route53DomainsClient route53DomainsClient, String domainSuggestion) {
try {
CheckDomainAvailabilityRequest availabilityRequest = CheckDomainAvailabilityRequest.builder()
.domainName(domainSuggestion)
.build();
CheckDomainAvailabilityResponse response = route53DomainsClient
.checkDomainAvailability(availabilityRequest);
System.out.println(domainSuggestion + " is " + response.availability().toString());
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
public static void listDomainSuggestions(Route53DomainsClient route53DomainsClient, String domainSuggestion) {
try {
GetDomainSuggestionsRequest suggestionsRequest = GetDomainSuggestionsRequest.builder()
.domainName(domainSuggestion)
.suggestionCount(5)
.onlyAvailable(true)
.build();
GetDomainSuggestionsResponse response = route53DomainsClient.getDomainSuggestions(suggestionsRequest);
List suggestions = response.suggestionsList();
for (DomainSuggestion suggestion : suggestions) {
System.out.println("Suggestion Name: " + suggestion.domainName());
System.out.println("Availability: " + suggestion.availability());
System.out.println(" ");
}
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
public static void listPrices(Route53DomainsClient route53DomainsClient, String domainType) {
try {
ListPricesRequest pricesRequest = ListPricesRequest.builder()
.tld(domainType)
.build();
ListPricesIterable listRes = route53DomainsClient.listPricesPaginator(pricesRequest);
listRes.stream()
.flatMap(r -> r.prices().stream())
.forEach(content -> System.out.println(" Name: " + content.name() +
" Registration: " + content.registrationPrice().price() + " "
+ content.registrationPrice().currency() +
" Renewal: " + content.renewalPrice().price() + " " + content.renewalPrice().currency()));
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
public static void listBillingRecords(Route53DomainsClient route53DomainsClient) {
try {
Date currentDate = new Date();
LocalDateTime localDateTime = currentDate.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime();
ZoneOffset zoneOffset = ZoneOffset.of("+01:00");
LocalDateTime localDateTime2 = localDateTime.minusYears(1);
Instant myStartTime = localDateTime2.toInstant(zoneOffset);
Instant myEndTime = localDateTime.toInstant(zoneOffset);
ViewBillingRequest viewBillingRequest = ViewBillingRequest.builder()
.start(myStartTime)
.end(myEndTime)
.build();
ViewBillingIterable listRes = route53DomainsClient.viewBillingPaginator(viewBillingRequest);
listRes.stream()
.flatMap(r -> r.billingRecords().stream())
.forEach(content -> System.out.println(" Bill Date:: " + content.billDate() +
" Operation: " + content.operationAsString() +
" Price: " + content.price()));
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
public static void listOperations(Route53DomainsClient route53DomainsClient) {
try {
Date currentDate = new Date();
LocalDateTime localDateTime = currentDate.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime();
ZoneOffset zoneOffset = ZoneOffset.of("+01:00");
localDateTime = localDateTime.minusYears(1);
Instant myTime = localDateTime.toInstant(zoneOffset);
ListOperationsRequest operationsRequest = ListOperationsRequest.builder()
.submittedSince(myTime)
.build();
ListOperationsIterable listRes = route53DomainsClient.listOperationsPaginator(operationsRequest);
listRes.stream()
.flatMap(r -> r.operations().stream())
.forEach(content -> System.out.println(" Operation Id: " + content.operationId() +
" Status: " + content.statusAsString() +
" Date: " + content.submittedDate()));
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
public static void listDomains(Route53DomainsClient route53DomainsClient) {
try {
ListDomainsIterable listRes = route53DomainsClient.listDomainsPaginator();
listRes.stream()
.flatMap(r -> r.domains().stream())
.forEach(content -> System.out.println("The domain name is " + content.domainName()));
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
}
```
+ Pour plus de détails sur l’API, consultez les rubriques suivantes dans la *Référence des API du kit AWS SDK for Java 2.x *.
+ [CheckDomainAvailability](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/CheckDomainAvailability)
+ [CheckDomainTransferability](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/CheckDomainTransferability)
+ [GetDomainDetail](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/GetDomainDetail)
+ [GetDomainSuggestions](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/GetDomainSuggestions)
+ [GetOperationDetail](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/GetOperationDetail)
+ [ListDomains](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ListDomains)
+ [ListOperations](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ListOperations)
+ [ListPrices](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ListPrices)
+ [RegisterDomain](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/RegisterDomain)
+ [ViewBilling](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ViewBilling)
------
#### [ Kotlin ]
**SDK pour Kotlin**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples).
```
/**
Before running this Kotlin code example, set up your development environment,
including your credentials.
For more information, see the following documentation topic:
https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/setup.html
This Kotlin code example performs the following operations:
1. List current domains.
2. List operations in the past year.
3. View billing for the account in the past year.
4. View prices for domain types.
5. Get domain suggestions.
6. Check domain availability.
7. Check domain transferability.
8. Request a domain registration.
9. Get operation details.
10. Optionally, get domain details.
*/
val DASHES: String = String(CharArray(80)).replace("\u0000", "-")
suspend fun main(args: Array) {
val usage = """
Usage:
Where:
domainType - The domain type (for example, com).
phoneNumber - The phone number to use (for example, +1.2065550100)
email - The email address to use.
domainSuggestion - The domain suggestion (for example, findmy.example).
firstName - The first name to use to register a domain.
lastName - The last name to use to register a domain.
city - The city to use to register a domain.
"""
if (args.size != 7) {
println(usage)
exitProcess(1)
}
val domainType = args[0]
val phoneNumber = args[1]
val email = args[2]
val domainSuggestion = args[3]
val firstName = args[4]
val lastName = args[5]
val city = args[6]
println(DASHES)
println("Welcome to the Amazon Route 53 domains example scenario.")
println(DASHES)
println(DASHES)
println("1. List current domains.")
listDomains()
println(DASHES)
println(DASHES)
println("2. List operations in the past year.")
listOperations()
println(DASHES)
println(DASHES)
println("3. View billing for the account in the past year.")
listBillingRecords()
println(DASHES)
println(DASHES)
println("4. View prices for domain types.")
listAllPrices(domainType)
println(DASHES)
println(DASHES)
println("5. Get domain suggestions.")
listDomainSuggestions(domainSuggestion)
println(DASHES)
println(DASHES)
println("6. Check domain availability.")
checkDomainAvailability(domainSuggestion)
println(DASHES)
println(DASHES)
println("7. Check domain transferability.")
checkDomainTransferability(domainSuggestion)
println(DASHES)
println(DASHES)
println("8. Request a domain registration.")
val opId = requestDomainRegistration(domainSuggestion, phoneNumber, email, firstName, lastName, city)
println(DASHES)
println(DASHES)
println("9. Get operation details.")
getOperationalDetail(opId)
println(DASHES)
println(DASHES)
println("10. Get domain details.")
println("Note: You must have a registered domain to get details.")
println("Otherwise an exception is thrown that states ")
println("Domain xxxxxxx not found in xxxxxxx account.")
getDomainDetails(domainSuggestion)
println(DASHES)
}
suspend fun getDomainDetails(domainSuggestion: String?) {
val detailRequest =
GetDomainDetailRequest {
domainName = domainSuggestion
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.getDomainDetail(detailRequest)
println("The contact first name is ${response.registrantContact?.firstName}")
println("The contact last name is ${response.registrantContact?.lastName}")
println("The contact org name is ${response.registrantContact?.organizationName}")
}
}
suspend fun getOperationalDetail(opId: String?) {
val detailRequest =
GetOperationDetailRequest {
operationId = opId
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.getOperationDetail(detailRequest)
println("Operation detail message is ${response.message}")
}
}
suspend fun requestDomainRegistration(
domainSuggestion: String?,
phoneNumberVal: String?,
emailVal: String?,
firstNameVal: String?,
lastNameVal: String?,
cityVal: String?,
): String? {
val contactDetail =
ContactDetail {
contactType = ContactType.Company
state = "LA"
countryCode = CountryCode.In
email = emailVal
firstName = firstNameVal
lastName = lastNameVal
city = cityVal
phoneNumber = phoneNumberVal
organizationName = "My Org"
addressLine1 = "My Address"
zipCode = "123 123"
}
val domainRequest =
RegisterDomainRequest {
adminContact = contactDetail
registrantContact = contactDetail
techContact = contactDetail
domainName = domainSuggestion
autoRenew = true
durationInYears = 1
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.registerDomain(domainRequest)
println("Registration requested. Operation Id: ${response.operationId}")
return response.operationId
}
}
suspend fun checkDomainTransferability(domainSuggestion: String?) {
val transferabilityRequest =
CheckDomainTransferabilityRequest {
domainName = domainSuggestion
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.checkDomainTransferability(transferabilityRequest)
println("Transferability: ${response.transferability?.transferable}")
}
}
suspend fun checkDomainAvailability(domainSuggestion: String) {
val availabilityRequest =
CheckDomainAvailabilityRequest {
domainName = domainSuggestion
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.checkDomainAvailability(availabilityRequest)
println("$domainSuggestion is ${response.availability}")
}
}
suspend fun listDomainSuggestions(domainSuggestion: String?) {
val suggestionsRequest =
GetDomainSuggestionsRequest {
domainName = domainSuggestion
suggestionCount = 5
onlyAvailable = true
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.getDomainSuggestions(suggestionsRequest)
response.suggestionsList?.forEach { suggestion ->
println("Suggestion Name: ${suggestion.domainName}")
println("Availability: ${suggestion.availability}")
println(" ")
}
}
}
suspend fun listAllPrices(domainType: String?) {
val pricesRequest =
ListPricesRequest {
tld = domainType
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
route53DomainsClient
.listPricesPaginated(pricesRequest)
.transform { it.prices?.forEach { obj -> emit(obj) } }
.collect { pr ->
println("Registration: ${pr.registrationPrice} ${pr.registrationPrice?.currency}")
println("Renewal: ${pr.renewalPrice?.price} ${pr.renewalPrice?.currency}")
println("Transfer: ${pr.transferPrice?.price} ${pr.transferPrice?.currency}")
println("Restoration: ${pr.restorationPrice?.price} ${pr.restorationPrice?.currency}")
}
}
}
suspend fun listBillingRecords() {
val currentDate = Date()
val localDateTime = currentDate.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime()
val zoneOffset = ZoneOffset.of("+01:00")
val localDateTime2 = localDateTime.minusYears(1)
val myStartTime = localDateTime2.toInstant(zoneOffset)
val myEndTime = localDateTime.toInstant(zoneOffset)
val timeStart: Instant? = myStartTime?.let { Instant(it) }
val timeEnd: Instant? = myEndTime?.let { Instant(it) }
val viewBillingRequest =
ViewBillingRequest {
start = timeStart
end = timeEnd
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
route53DomainsClient
.viewBillingPaginated(viewBillingRequest)
.transform { it.billingRecords?.forEach { obj -> emit(obj) } }
.collect { billing ->
println("Bill Date: ${billing.billDate}")
println("Operation: ${billing.operation}")
println("Price: ${billing.price}")
}
}
}
suspend fun listOperations() {
val currentDate = Date()
var localDateTime = currentDate.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime()
val zoneOffset = ZoneOffset.of("+01:00")
localDateTime = localDateTime.minusYears(1)
val myTime: java.time.Instant? = localDateTime.toInstant(zoneOffset)
val time2: Instant? = myTime?.let { Instant(it) }
val operationsRequest =
ListOperationsRequest {
submittedSince = time2
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
route53DomainsClient
.listOperationsPaginated(operationsRequest)
.transform { it.operations?.forEach { obj -> emit(obj) } }
.collect { content ->
println("Operation Id: ${content.operationId}")
println("Status: ${content.status}")
println("Date: ${content.submittedDate}")
}
}
}
suspend fun listDomains() {
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
route53DomainsClient
.listDomainsPaginated(ListDomainsRequest {})
.transform { it.domains?.forEach { obj -> emit(obj) } }
.collect { content ->
println("The domain name is ${content.domainName}")
}
}
}
```
+ Pour plus de détails sur l’API, consultez les rubriques suivantes dans la *Référence des API du kit AWS SDK pour Kotlin*.
+ [CheckDomainAvailability](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [CheckDomainTransferability](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [GetDomainDetail](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [GetDomainSuggestions](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [GetOperationDetail](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [ListDomains](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [ListOperations](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [ListPrices](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [RegisterDomain](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
+ [ViewBilling](https://sdk.amazonaws.com/kotlin/api/latest/index.html)
------
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de Route 53 avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.
# Actions pour l'enregistrement de domaines Route 53 à l'aide de AWS SDKs
Les exemples de code suivants montrent comment effectuer des actions d'enregistrement de domaine Route 53 individuelles avec AWS SDKs. Chaque exemple inclut un lien vers GitHub, où vous pouvez trouver des instructions pour configurer et exécuter le code.
Les exemples suivants incluent uniquement les actions les plus couramment utilisées. Pour obtenir la liste complète, consultez la [Référence des API Amazon Route 53 domain registration](https://docs.aws.amazon.com/Route53/latest/APIReference/API_Operations_Amazon_Route_53_Domains.html).
**Topics**
+ [`CheckDomainAvailability`](route-53-domains_example_route-53-domains_CheckDomainAvailability_section.md)
+ [`CheckDomainTransferability`](route-53-domains_example_route-53-domains_CheckDomainTransferability_section.md)
+ [`GetDomainDetail`](route-53-domains_example_route-53-domains_GetDomainDetail_section.md)
+ [`GetDomainSuggestions`](route-53-domains_example_route-53-domains_GetDomainSuggestions_section.md)
+ [`GetOperationDetail`](route-53-domains_example_route-53-domains_GetOperationDetail_section.md)
+ [`ListDomains`](route-53-domains_example_route-53-domains_ListDomains_section.md)
+ [`ListOperations`](route-53-domains_example_route-53-domains_ListOperations_section.md)
+ [`ListPrices`](route-53-domains_example_route-53-domains_ListPrices_section.md)
+ [`RegisterDomain`](route-53-domains_example_route-53-domains_RegisterDomain_section.md)
+ [`ViewBilling`](route-53-domains_example_route-53-domains_ViewBilling_section.md)
# Utilisation `CheckDomainAvailability` avec un AWS SDK ou une CLI
Les exemples de code suivants illustrent comment utiliser `CheckDomainAvailability`.
Les exemples d’actions sont des extraits de code de programmes de plus grande envergure et doivent être exécutés en contexte. Vous pouvez voir cette action en contexte dans l’exemple de code suivant :
+ [Principes de base](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
------
#### [ .NET ]
**SDK pour .NET**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples).
```
///
/// Check the availability of a domain name.
///
/// The domain to check for availability.
/// An availability result string.
public async Task CheckDomainAvailability(string domain)
{
var result = await _amazonRoute53Domains.CheckDomainAvailabilityAsync(
new CheckDomainAvailabilityRequest
{
DomainName = domain
}
);
return result.Availability.Value;
}
```
+ Pour plus de détails sur l'API, reportez-vous [CheckDomainAvailability](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/CheckDomainAvailability)à la section *Référence des AWS SDK pour .NET API*.
------
#### [ CLI ]
**AWS CLI**
**Pour déterminer si vous pouvez enregistrer un nom de domaine avec Route 53**
La commande `check-domain-availability` suivante renvoie des informations indiquant si le nom de domaine `example.com` est disponible pour être enregistré à l’aide de Route 53.
Cette commande s’exécute uniquement dans la région `us-east-1`. Si la région par défaut est définie sur `us-east-1`, vous pouvez omettre le paramètre `region`.
```
aws route53domains check-domain-availability \
--region us-east-1 \
--domain-name example.com
```
Sortie :
```
{
"Availability": "UNAVAILABLE"
}
```
Route 53 prend en charge un grand nombre de domaines de premier niveau (TLDs), tels que `.com` et`.jp`, mais nous ne prenons pas en charge tous les domaines disponibles TLDs. Si vous vérifiez la disponibilité d’un domaine et que Route 53 ne prend pas en charge le TLD, `check-domain-availability` renvoie le message suivant.
```
An error occurred (UnsupportedTLD) when calling the CheckDomainAvailability operation: tld is not supported.
```
Pour obtenir la liste des domaines TLDs que vous pouvez utiliser lors de l'enregistrement d'un domaine auprès de Route 53, consultez la section [Domaines que vous pouvez enregistrer auprès d'Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/registrar-tld-list.html) dans le *guide du développeur Amazon Route 53*. Pour plus d’informations sur l’enregistrement de domaines avec Amazon Route 53, consultez [Enregistrement d’un nouveau domaine](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-register.html) dans le *Manuel du développeur Amazon Route 53*.
+ Pour plus de détails sur l'API, reportez-vous [CheckDomainAvailability](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/check-domain-availability.html)à la section *Référence des AWS CLI commandes*.
------
#### [ Java ]
**SDK pour Java 2.x**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples).
```
public static void checkDomainAvailability(Route53DomainsClient route53DomainsClient, String domainSuggestion) {
try {
CheckDomainAvailabilityRequest availabilityRequest = CheckDomainAvailabilityRequest.builder()
.domainName(domainSuggestion)
.build();
CheckDomainAvailabilityResponse response = route53DomainsClient
.checkDomainAvailability(availabilityRequest);
System.out.println(domainSuggestion + " is " + response.availability().toString());
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [CheckDomainAvailability](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/CheckDomainAvailability)à la section *Référence des AWS SDK for Java 2.x API*.
------
#### [ Kotlin ]
**SDK pour Kotlin**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples).
```
suspend fun checkDomainAvailability(domainSuggestion: String) {
val availabilityRequest =
CheckDomainAvailabilityRequest {
domainName = domainSuggestion
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.checkDomainAvailability(availabilityRequest)
println("$domainSuggestion is ${response.availability}")
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [CheckDomainAvailability](https://sdk.amazonaws.com/kotlin/api/latest/index.html)à la section *AWS SDK pour la référence de l'API Kotlin*.
------
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de Route 53 avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.
# Utilisation `CheckDomainTransferability` avec un AWS SDK ou une CLI
Les exemples de code suivants illustrent comment utiliser `CheckDomainTransferability`.
Les exemples d’actions sont des extraits de code de programmes de plus grande envergure et doivent être exécutés en contexte. Vous pouvez voir cette action en contexte dans l’exemple de code suivant :
+ [Principes de base](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
------
#### [ .NET ]
**SDK pour .NET**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples).
```
///
/// Check the transferability of a domain name.
///
/// The domain to check for transferability.
/// A transferability result string.
public async Task CheckDomainTransferability(string domain)
{
var result = await _amazonRoute53Domains.CheckDomainTransferabilityAsync(
new CheckDomainTransferabilityRequest
{
DomainName = domain
}
);
return result.Transferability.Transferable.Value;
}
```
+ Pour plus de détails sur l'API, reportez-vous [CheckDomainTransferability](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/CheckDomainTransferability)à la section *Référence des AWS SDK pour .NET API*.
------
#### [ CLI ]
**AWS CLI**
**Pour déterminer si un domaine peut être transféré vers Route 53**
La commande `check-domain-transferability` suivante renvoie des informations indiquant si vous pouvez transférer le nom de domaine `example.com` vers Route 53.
Cette commande s’exécute uniquement dans la région `us-east-1`. Si la région par défaut est définie sur `us-east-1`, vous pouvez omettre le paramètre `region`.
```
aws route53domains check-domain-transferability \
--region us-east-1 \
--domain-name example.com
```
Sortie :
```
{
"Transferability": {
"Transferable": "UNTRANSFERABLE"
}
}
```
Pour plus d’informations, consultez [Transferring Registration for a Domain to Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-transfer-to-route-53.html) dans le *Manuel du développeur Amazon Route 53*.
+ Pour plus de détails sur l'API, reportez-vous [CheckDomainTransferability](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/check-domain-transferability.html)à la section *Référence des AWS CLI commandes*.
------
#### [ Java ]
**SDK pour Java 2.x**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples).
```
public static void checkDomainTransferability(Route53DomainsClient route53DomainsClient, String domainSuggestion) {
try {
CheckDomainTransferabilityRequest transferabilityRequest = CheckDomainTransferabilityRequest.builder()
.domainName(domainSuggestion)
.build();
CheckDomainTransferabilityResponse response = route53DomainsClient
.checkDomainTransferability(transferabilityRequest);
System.out.println("Transferability: " + response.transferability().transferable().toString());
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [CheckDomainTransferability](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/CheckDomainTransferability)à la section *Référence des AWS SDK for Java 2.x API*.
------
#### [ Kotlin ]
**SDK pour Kotlin**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples).
```
suspend fun checkDomainTransferability(domainSuggestion: String?) {
val transferabilityRequest =
CheckDomainTransferabilityRequest {
domainName = domainSuggestion
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.checkDomainTransferability(transferabilityRequest)
println("Transferability: ${response.transferability?.transferable}")
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [CheckDomainTransferability](https://sdk.amazonaws.com/kotlin/api/latest/index.html)à la section *AWS SDK pour la référence de l'API Kotlin*.
------
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de Route 53 avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.
# Utilisation `GetDomainDetail` avec un AWS SDK ou une CLI
Les exemples de code suivants illustrent comment utiliser `GetDomainDetail`.
Les exemples d’actions sont des extraits de code de programmes de plus grande envergure et doivent être exécutés en contexte. Vous pouvez voir cette action en contexte dans l’exemple de code suivant :
+ [Principes de base](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
------
#### [ .NET ]
**SDK pour .NET**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples).
```
///
/// Get details for a domain.
///
/// A string with detail information about the domain.
public async Task GetDomainDetail(string domainName)
{
try
{
var result = await _amazonRoute53Domains.GetDomainDetailAsync(
new GetDomainDetailRequest()
{
DomainName = domainName
});
var details = $"\tDomain {domainName}:\n" +
$"\tCreated on {result.CreationDate.ToShortDateString()}.\n" +
$"\tAdmin contact is {result.AdminContact.Email}.\n" +
$"\tAuto-renew is {result.AutoRenew}.\n";
return details;
}
catch (InvalidInputException)
{
return $"Domain {domainName} was not found in your account.";
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetDomainDetail](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/GetDomainDetail)à la section *Référence des AWS SDK pour .NET API*.
------
#### [ CLI ]
**AWS CLI**
**Pour obtenir les informations détaillées sur un domaine spécifié**
La commande `get-domain-detail` suivante affiche des informations détaillées sur le domaine spécifié.
Cette commande s’exécute uniquement dans la région `us-east-1`. Si la région par défaut est définie sur `us-east-1`, vous pouvez omettre le paramètre `region`.
```
aws route53domains get-domain-detail \
--region us-east-1 \
--domain-name example.com
```
Sortie :
```
{
"DomainName": "example.com",
"Nameservers": [
{
"Name": "ns-2048.awsdns-64.com",
"GlueIps": []
},
{
"Name": "ns-2049.awsdns-65.net",
"GlueIps": []
},
{
"Name": "ns-2050.awsdns-66.org",
"GlueIps": []
},
{
"Name": "ns-2051.awsdns-67.co.uk",
"GlueIps": []
}
],
"AutoRenew": true,
"AdminContact": {
"FirstName": "Saanvi",
"LastName": "Sarkar",
"ContactType": "COMPANY",
"OrganizationName": "Example",
"AddressLine1": "123 Main Street",
"City": "Anytown",
"State": "WA",
"CountryCode": "US",
"ZipCode": "98101",
"PhoneNumber": "+1.8005551212",
"Email": "ssarkar@example.com",
"ExtraParams": []
},
"RegistrantContact": {
"FirstName": "Alejandro",
"LastName": "Rosalez",
"ContactType": "COMPANY",
"OrganizationName": "Example",
"AddressLine1": "123 Main Street",
"City": "Anytown",
"State": "WA",
"CountryCode": "US",
"ZipCode": "98101",
"PhoneNumber": "+1.8005551212",
"Email": "arosalez@example.com",
"ExtraParams": []
},
"TechContact": {
"FirstName": "Wang",
"LastName": "Xiulan",
"ContactType": "COMPANY",
"OrganizationName": "Example",
"AddressLine1": "123 Main Street",
"City": "Anytown",
"State": "WA",
"CountryCode": "US",
"ZipCode": "98101",
"PhoneNumber": "+1.8005551212",
"Email": "wxiulan@example.com",
"ExtraParams": []
},
"AdminPrivacy": true,
"RegistrantPrivacy": true,
"TechPrivacy": true,
"RegistrarName": "Amazon Registrar, Inc.",
"WhoIsServer": "whois.registrar.amazon",
"RegistrarUrl": "http://registrar.amazon.com",
"AbuseContactEmail": "abuse@registrar.amazon.com",
"AbuseContactPhone": "+1.2062661000",
"CreationDate": 1444934889.601,
"ExpirationDate": 1602787689.0,
"StatusList": [
"clientTransferProhibited"
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetDomainDetail](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/get-domain-detail.html)à la section *Référence des AWS CLI commandes*.
------
#### [ Java ]
**SDK pour Java 2.x**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples).
```
public static void getDomainDetails(Route53DomainsClient route53DomainsClient, String domainSuggestion) {
try {
GetDomainDetailRequest detailRequest = GetDomainDetailRequest.builder()
.domainName(domainSuggestion)
.build();
GetDomainDetailResponse response = route53DomainsClient.getDomainDetail(detailRequest);
System.out.println("The contact first name is " + response.registrantContact().firstName());
System.out.println("The contact last name is " + response.registrantContact().lastName());
System.out.println("The contact org name is " + response.registrantContact().organizationName());
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetDomainDetail](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/GetDomainDetail)à la section *Référence des AWS SDK for Java 2.x API*.
------
#### [ Kotlin ]
**SDK pour Kotlin**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples).
```
suspend fun getDomainDetails(domainSuggestion: String?) {
val detailRequest =
GetDomainDetailRequest {
domainName = domainSuggestion
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.getDomainDetail(detailRequest)
println("The contact first name is ${response.registrantContact?.firstName}")
println("The contact last name is ${response.registrantContact?.lastName}")
println("The contact org name is ${response.registrantContact?.organizationName}")
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetDomainDetail](https://sdk.amazonaws.com/kotlin/api/latest/index.html)à la section *AWS SDK pour la référence de l'API Kotlin*.
------
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de Route 53 avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.
# Utilisation `GetDomainSuggestions` avec un AWS SDK ou une CLI
Les exemples de code suivants illustrent comment utiliser `GetDomainSuggestions`.
Les exemples d’actions sont des extraits de code de programmes de plus grande envergure et doivent être exécutés en contexte. Vous pouvez voir cette action en contexte dans l’exemple de code suivant :
+ [Principes de base](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
------
#### [ .NET ]
**SDK pour .NET**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples).
```
///
/// Get a list of suggestions for a given domain.
///
/// The domain to check for suggestions.
/// If true, only returns available domains.
/// The number of suggestions to return. Defaults to the max of 50.
/// A collection of domain suggestions.
public async Task> GetDomainSuggestions(string domain, bool onlyAvailable, int suggestionCount = 50)
{
var result = await _amazonRoute53Domains.GetDomainSuggestionsAsync(
new GetDomainSuggestionsRequest
{
DomainName = domain,
OnlyAvailable = onlyAvailable,
SuggestionCount = suggestionCount
}
);
return result.SuggestionsList;
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetDomainSuggestions](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/GetDomainSuggestions)à la section *Référence des AWS SDK pour .NET API*.
------
#### [ CLI ]
**AWS CLI**
**Pour obtenir une liste de noms de domaine suggérés**
La commande `get-domain-suggestions` suivante affiche une liste de noms de domaine suggérés en fonction du nom de domaine `example.com`. La réponse inclut uniquement les noms de domaine disponibles. Cette commande s’exécute uniquement dans la région `us-east-1`. Si la région par défaut est définie sur `us-east-1`, vous pouvez omettre le paramètre `region`.
```
aws route53domains get-domain-suggestions \
--region us-east-1 \
--domain-name example.com \
--suggestion-count 10 \
--only-available
```
Sortie :
```
{
"SuggestionsList": [
{
"DomainName": "egzaampal.com",
"Availability": "AVAILABLE"
},
{
"DomainName": "examplelaw.com",
"Availability": "AVAILABLE"
},
{
"DomainName": "examplehouse.net",
"Availability": "AVAILABLE"
},
{
"DomainName": "homeexample.net",
"Availability": "AVAILABLE"
},
{
"DomainName": "examplelist.com",
"Availability": "AVAILABLE"
},
{
"DomainName": "examplenews.net",
"Availability": "AVAILABLE"
},
{
"DomainName": "officeexample.com",
"Availability": "AVAILABLE"
},
{
"DomainName": "exampleworld.com",
"Availability": "AVAILABLE"
},
{
"DomainName": "exampleart.com",
"Availability": "AVAILABLE"
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetDomainSuggestions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/get-domain-suggestions.html)à la section *Référence des AWS CLI commandes*.
------
#### [ Java ]
**SDK pour Java 2.x**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples).
```
public static void listDomainSuggestions(Route53DomainsClient route53DomainsClient, String domainSuggestion) {
try {
GetDomainSuggestionsRequest suggestionsRequest = GetDomainSuggestionsRequest.builder()
.domainName(domainSuggestion)
.suggestionCount(5)
.onlyAvailable(true)
.build();
GetDomainSuggestionsResponse response = route53DomainsClient.getDomainSuggestions(suggestionsRequest);
List suggestions = response.suggestionsList();
for (DomainSuggestion suggestion : suggestions) {
System.out.println("Suggestion Name: " + suggestion.domainName());
System.out.println("Availability: " + suggestion.availability());
System.out.println(" ");
}
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetDomainSuggestions](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/GetDomainSuggestions)à la section *Référence des AWS SDK for Java 2.x API*.
------
#### [ Kotlin ]
**SDK pour Kotlin**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples).
```
suspend fun listDomainSuggestions(domainSuggestion: String?) {
val suggestionsRequest =
GetDomainSuggestionsRequest {
domainName = domainSuggestion
suggestionCount = 5
onlyAvailable = true
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.getDomainSuggestions(suggestionsRequest)
response.suggestionsList?.forEach { suggestion ->
println("Suggestion Name: ${suggestion.domainName}")
println("Availability: ${suggestion.availability}")
println(" ")
}
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetDomainSuggestions](https://sdk.amazonaws.com/kotlin/api/latest/index.html)à la section *AWS SDK pour la référence de l'API Kotlin*.
------
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de Route 53 avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.
# Utilisation `GetOperationDetail` avec un AWS SDK ou une CLI
Les exemples de code suivants illustrent comment utiliser `GetOperationDetail`.
Les exemples d’actions sont des extraits de code de programmes de plus grande envergure et doivent être exécutés en contexte. Vous pouvez voir cette action en contexte dans l’exemple de code suivant :
+ [Principes de base](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
------
#### [ .NET ]
**SDK pour .NET**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples).
```
///
/// Get details for a domain action operation.
///
/// The operational Id.
/// A string describing the operational details.
public async Task GetOperationDetail(string? operationId)
{
if (operationId == null)
return "Unable to get operational details because ID is null.";
try
{
var operationDetails =
await _amazonRoute53Domains.GetOperationDetailAsync(
new GetOperationDetailRequest
{
OperationId = operationId
}
);
var details = $"\tOperation {operationId}:\n" +
$"\tFor domain {operationDetails.DomainName} on {operationDetails.SubmittedDate.ToShortDateString()}.\n" +
$"\tMessage is {operationDetails.Message}.\n" +
$"\tStatus is {operationDetails.Status}.\n";
return details;
}
catch (AmazonRoute53DomainsException ex)
{
return $"Unable to get operation details. Here's why: {ex.Message}.";
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetOperationDetail](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/GetOperationDetail)à la section *Référence des AWS SDK pour .NET API*.
------
#### [ CLI ]
**AWS CLI**
**Pour obtenir le statut actuel d’une opération**
Certaines opérations d’enregistrement de domaine fonctionnent de manière asynchrone et renvoient une réponse avant leur fin. Ces opérations renvoient un ID d’opération que vous pouvez utiliser pour obtenir le statut actuel. La commande `get-operation-detail` suivante renvoie le statut de l’opération spécifiée.
Cette commande s’exécute uniquement dans la région `us-east-1`. Si la région par défaut est définie sur `us-east-1`, vous pouvez omettre le paramètre `region`.
```
aws route53domains get-operation-detail \
--region us-east-1 \
--operation-id edbd8d63-7fe7-4343-9bc5-54033example
```
Sortie :
```
{
"OperationId": "edbd8d63-7fe7-4343-9bc5-54033example",
"Status": "SUCCESSFUL",
"DomainName": "example.com",
"Type": "DOMAIN_LOCK",
"SubmittedDate": 1573749367.864
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetOperationDetail](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/get-operation-detail.html)à la section *Référence des AWS CLI commandes*.
------
#### [ Java ]
**SDK pour Java 2.x**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples).
```
public static void getOperationalDetail(Route53DomainsClient route53DomainsClient, String operationId) {
try {
GetOperationDetailRequest detailRequest = GetOperationDetailRequest.builder()
.operationId(operationId)
.build();
GetOperationDetailResponse response = route53DomainsClient.getOperationDetail(detailRequest);
System.out.println("Operation detail message is " + response.message());
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetOperationDetail](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/GetOperationDetail)à la section *Référence des AWS SDK for Java 2.x API*.
------
#### [ Kotlin ]
**SDK pour Kotlin**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples).
```
suspend fun getOperationalDetail(opId: String?) {
val detailRequest =
GetOperationDetailRequest {
operationId = opId
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.getOperationDetail(detailRequest)
println("Operation detail message is ${response.message}")
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetOperationDetail](https://sdk.amazonaws.com/kotlin/api/latest/index.html)à la section *AWS SDK pour la référence de l'API Kotlin*.
------
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de Route 53 avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.
# Utilisation `ListDomains` avec un AWS SDK ou une CLI
Les exemples de code suivants illustrent comment utiliser `ListDomains`.
Les exemples d’actions sont des extraits de code de programmes de plus grande envergure et doivent être exécutés en contexte. Vous pouvez voir cette action en contexte dans l’exemple de code suivant :
+ [Principes de base](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
------
#### [ .NET ]
**SDK pour .NET**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples).
```
///
/// List the domains for the account.
///
/// A collection of domain summary records.
public async Task> ListDomains()
{
var results = new List();
var paginateDomains = _amazonRoute53Domains.Paginators.ListDomains(
new ListDomainsRequest());
// Get the entire list using the paginator.
await foreach (var domain in paginateDomains.Domains)
{
results.Add(domain);
}
return results;
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListDomains](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/ListDomains)à la section *Référence des AWS SDK pour .NET API*.
------
#### [ CLI ]
**AWS CLI**
**Pour répertorier les domaines enregistrés avec le AWS compte actuel**
La `list-domains` commande suivante répertorie les informations récapitulatives sur les domaines enregistrés avec le AWS compte actuel.
Cette commande s’exécute uniquement dans la région `us-east-1`. Si la région par défaut est définie sur `us-east-1`, vous pouvez omettre le paramètre `region`.
```
aws route53domains list-domains
--region us-east-1
```
Sortie :
```
{
"Domains": [
{
"DomainName": "example.com",
"AutoRenew": true,
"TransferLock": true,
"Expiry": 1602712345.0
},
{
"DomainName": "example.net",
"AutoRenew": true,
"TransferLock": true,
"Expiry": 1602723456.0
},
{
"DomainName": "example.org",
"AutoRenew": true,
"TransferLock": true,
"Expiry": 1602734567.0
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListDomains](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/list-domains.html)à la section *Référence des AWS CLI commandes*.
------
#### [ Java ]
**SDK pour Java 2.x**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples).
```
public static void listDomains(Route53DomainsClient route53DomainsClient) {
try {
ListDomainsIterable listRes = route53DomainsClient.listDomainsPaginator();
listRes.stream()
.flatMap(r -> r.domains().stream())
.forEach(content -> System.out.println("The domain name is " + content.domainName()));
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListDomains](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ListDomains)à la section *Référence des AWS SDK for Java 2.x API*.
------
#### [ Kotlin ]
**SDK pour Kotlin**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples).
```
suspend fun listDomains() {
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
route53DomainsClient
.listDomainsPaginated(ListDomainsRequest {})
.transform { it.domains?.forEach { obj -> emit(obj) } }
.collect { content ->
println("The domain name is ${content.domainName}")
}
}
}
```
+ Pour plus de détails sur l'API, consultez [ListDomains](https://sdk.amazonaws.com/kotlin/api/latest/index.html)la section *AWS SDK pour la référence de l'API Kotlin*.
------
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de Route 53 avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.
# Utilisation `ListOperations` avec un AWS SDK ou une CLI
Les exemples de code suivants illustrent comment utiliser `ListOperations`.
Les exemples d’actions sont des extraits de code de programmes de plus grande envergure et doivent être exécutés en contexte. Vous pouvez voir cette action en contexte dans l’exemple de code suivant :
+ [Principes de base](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
------
#### [ .NET ]
**SDK pour .NET**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples).
```
///
/// List operations for the account that are submitted after a specified date.
///
/// A collection of operation summary records.
public async Task> ListOperations(DateTime submittedSince)
{
var results = new List();
var paginateOperations = _amazonRoute53Domains.Paginators.ListOperations(
new ListOperationsRequest()
{
SubmittedSince = submittedSince
});
// Get the entire list using the paginator.
await foreach (var operations in paginateOperations.Operations)
{
results.Add(operations);
}
return results;
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListOperations](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/ListOperations)à la section *Référence des AWS SDK pour .NET API*.
------
#### [ CLI ]
**AWS CLI**
**Pour répertorier le statut des opérations qui renvoient un ID d’opération**
Certaines opérations d’enregistrement de domaine sont exécutées de manière asynchrone et renvoient une réponse avant leur fin. Ces opérations renvoient un ID d’opération que vous pouvez utiliser pour obtenir le statut actuel. La commande `list-operations` suivante crée une liste des informations récapitulatives, y compris le statut, concernant les opérations d’enregistrement de domaine en cours.
Cette commande s’exécute uniquement dans la région `us-east-1`. Si la région par défaut est définie sur `us-east-1`, vous pouvez omettre le paramètre `region`.
```
aws route53domains list-operations
--region us-east-1
```
Sortie :
```
{
"Operations": [
{
"OperationId": "aab9822f-1da0-4bf3-8a15-fd4e0example",
"Status": "SUCCESSFUL",
"Type": "DOMAIN_LOCK",
"SubmittedDate": 1455321739.986
},
{
"OperationId": "c24379ed-76be-42f8-bdad-9379bexample",
"Status": "SUCCESSFUL",
"Type": "UPDATE_NAMESERVER",
"SubmittedDate": 1468960475.109
},
{
"OperationId": "f47e1297-ef9e-4c2b-ae1e-a5fcbexample",
"Status": "SUCCESSFUL",
"Type": "RENEW_DOMAIN",
"SubmittedDate": 1473561835.943
},
{
"OperationId": "75584f23-b15f-459e-aed7-dc6f5example",
"Status": "SUCCESSFUL",
"Type": "UPDATE_DOMAIN_CONTACT",
"SubmittedDate": 1547501003.41
}
]
}
```
La sortie inclut toutes les opérations qui renvoient un ID d'opération et que vous avez effectuées sur tous les domaines que vous avez enregistrés à l'aide du AWS compte courant. Si vous souhaitez obtenir uniquement les opérations que vous avez soumises après une date spécifiée, vous pouvez inclure le paramètre `submitted-since` et spécifier une date au format Unix et en temps universel coordonné (UTC). La commande suivante permet d’obtenir le statut de toutes les opérations soumises après 00 h 00 UTC le 1er janvier 2020.
```
aws route53domains list-operations \
--submitted-since 1577836800
```
+ Pour plus de détails sur l'API, reportez-vous [ListOperations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/list-operations.html)à la section *Référence des AWS CLI commandes*.
------
#### [ Java ]
**SDK pour Java 2.x**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples).
```
public static void listOperations(Route53DomainsClient route53DomainsClient) {
try {
Date currentDate = new Date();
LocalDateTime localDateTime = currentDate.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime();
ZoneOffset zoneOffset = ZoneOffset.of("+01:00");
localDateTime = localDateTime.minusYears(1);
Instant myTime = localDateTime.toInstant(zoneOffset);
ListOperationsRequest operationsRequest = ListOperationsRequest.builder()
.submittedSince(myTime)
.build();
ListOperationsIterable listRes = route53DomainsClient.listOperationsPaginator(operationsRequest);
listRes.stream()
.flatMap(r -> r.operations().stream())
.forEach(content -> System.out.println(" Operation Id: " + content.operationId() +
" Status: " + content.statusAsString() +
" Date: " + content.submittedDate()));
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListOperations](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ListOperations)à la section *Référence des AWS SDK for Java 2.x API*.
------
#### [ Kotlin ]
**SDK pour Kotlin**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples).
```
suspend fun listOperations() {
val currentDate = Date()
var localDateTime = currentDate.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime()
val zoneOffset = ZoneOffset.of("+01:00")
localDateTime = localDateTime.minusYears(1)
val myTime: java.time.Instant? = localDateTime.toInstant(zoneOffset)
val time2: Instant? = myTime?.let { Instant(it) }
val operationsRequest =
ListOperationsRequest {
submittedSince = time2
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
route53DomainsClient
.listOperationsPaginated(operationsRequest)
.transform { it.operations?.forEach { obj -> emit(obj) } }
.collect { content ->
println("Operation Id: ${content.operationId}")
println("Status: ${content.status}")
println("Date: ${content.submittedDate}")
}
}
}
```
+ Pour plus de détails sur l'API, consultez [ListOperations](https://sdk.amazonaws.com/kotlin/api/latest/index.html)la section *AWS SDK pour la référence de l'API Kotlin*.
------
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de Route 53 avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.
# Utilisation `ListPrices` avec un AWS SDK
Les exemples de code suivants illustrent comment utiliser `ListPrices`.
Les exemples d’actions sont des extraits de code de programmes de plus grande envergure et doivent être exécutés en contexte. Vous pouvez voir cette action en contexte dans l’exemple de code suivant :
+ [Principes de base](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
------
#### [ .NET ]
**SDK pour .NET**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples).
```
///
/// List prices for domain type operations.
///
/// Domain types to include in the results.
/// The list of domain prices.
public async Task> ListPrices(List domainTypes)
{
var results = new List();
var paginatePrices = _amazonRoute53Domains.Paginators.ListPrices(new ListPricesRequest());
// Get the entire list using the paginator.
await foreach (var prices in paginatePrices.Prices)
{
results.Add(prices);
}
return results.Where(p => domainTypes.Contains(p.Name)).ToList();
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListPrices](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/ListPrices)à la section *Référence des AWS SDK pour .NET API*.
------
#### [ Java ]
**SDK pour Java 2.x**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples).
```
public static void listPrices(Route53DomainsClient route53DomainsClient, String domainType) {
try {
ListPricesRequest pricesRequest = ListPricesRequest.builder()
.tld(domainType)
.build();
ListPricesIterable listRes = route53DomainsClient.listPricesPaginator(pricesRequest);
listRes.stream()
.flatMap(r -> r.prices().stream())
.forEach(content -> System.out.println(" Name: " + content.name() +
" Registration: " + content.registrationPrice().price() + " "
+ content.registrationPrice().currency() +
" Renewal: " + content.renewalPrice().price() + " " + content.renewalPrice().currency()));
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListPrices](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ListPrices)à la section *Référence des AWS SDK for Java 2.x API*.
------
#### [ Kotlin ]
**SDK pour Kotlin**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples).
```
suspend fun listAllPrices(domainType: String?) {
val pricesRequest =
ListPricesRequest {
tld = domainType
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
route53DomainsClient
.listPricesPaginated(pricesRequest)
.transform { it.prices?.forEach { obj -> emit(obj) } }
.collect { pr ->
println("Registration: ${pr.registrationPrice} ${pr.registrationPrice?.currency}")
println("Renewal: ${pr.renewalPrice?.price} ${pr.renewalPrice?.currency}")
println("Transfer: ${pr.transferPrice?.price} ${pr.transferPrice?.currency}")
println("Restoration: ${pr.restorationPrice?.price} ${pr.restorationPrice?.currency}")
}
}
}
```
+ Pour plus de détails sur l'API, consultez [ListPrices](https://sdk.amazonaws.com/kotlin/api/latest/index.html)la section *AWS SDK pour la référence de l'API Kotlin*.
------
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de Route 53 avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.
# Utilisation `RegisterDomain` avec un AWS SDK ou une CLI
Les exemples de code suivants illustrent comment utiliser `RegisterDomain`.
Les exemples d’actions sont des extraits de code de programmes de plus grande envergure et doivent être exécutés en contexte. Vous pouvez voir cette action en contexte dans l’exemple de code suivant :
+ [Principes de base](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
------
#### [ .NET ]
**SDK pour .NET**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples).
```
///
/// Initiate a domain registration request.
///
/// Contact details.
/// The domain name to register.
/// True if the domain should automatically renew.
/// The duration in years for the domain registration.
/// The operation Id.
public async Task RegisterDomain(string domainName, bool autoRenew, int duration, ContactDetail contact)
{
// This example uses the same contact information for admin, registrant, and tech contacts.
try
{
var result = await _amazonRoute53Domains.RegisterDomainAsync(
new RegisterDomainRequest()
{
AdminContact = contact,
RegistrantContact = contact,
TechContact = contact,
DomainName = domainName,
AutoRenew = autoRenew,
DurationInYears = duration,
PrivacyProtectAdminContact = false,
PrivacyProtectRegistrantContact = false,
PrivacyProtectTechContact = false
}
);
return result.OperationId;
}
catch (InvalidInputException)
{
_logger.LogInformation($"Unable to request registration for domain {domainName}");
return null;
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [RegisterDomain](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/RegisterDomain)à la section *Référence des AWS SDK pour .NET API*.
------
#### [ CLI ]
**AWS CLI**
**Pour enregistrer un domaine**
La commande `register-domain` suivante enregistre un domaine et extrait toutes les valeurs de paramètres d’un fichier au format JSON.
Cette commande s’exécute uniquement dans la région `us-east-1`. Si la région par défaut est définie sur `us-east-1`, vous pouvez omettre le paramètre `region`.
```
aws route53domains register-domain \
--region us-east-1 \
--cli-input-json file://register-domain.json
```
Contenu de `register-domain.json` :
```
{
"DomainName": "example.com",
"DurationInYears": 1,
"AutoRenew": true,
"AdminContact": {
"FirstName": "Martha",
"LastName": "Rivera",
"ContactType": "PERSON",
"OrganizationName": "Example",
"AddressLine1": "1 Main Street",
"City": "Anytown",
"State": "WA",
"CountryCode": "US",
"ZipCode": "98101",
"PhoneNumber": "+1.8005551212",
"Email": "mrivera@example.com"
},
"RegistrantContact": {
"FirstName": "Li",
"LastName": "Juan",
"ContactType": "PERSON",
"OrganizationName": "Example",
"AddressLine1": "1 Main Street",
"City": "Anytown",
"State": "WA",
"CountryCode": "US",
"ZipCode": "98101",
"PhoneNumber": "+1.8005551212",
"Email": "ljuan@example.com"
},
"TechContact": {
"FirstName": "Mateo",
"LastName": "Jackson",
"ContactType": "PERSON",
"OrganizationName": "Example",
"AddressLine1": "1 Main Street",
"City": "Anytown",
"State": "WA",
"CountryCode": "US",
"ZipCode": "98101",
"PhoneNumber": "+1.8005551212",
"Email": "mjackson@example.com"
},
"PrivacyProtectAdminContact": true,
"PrivacyProtectRegistrantContact": true,
"PrivacyProtectTechContact": true
}
```
Sortie :
```
{
"OperationId": "b114c44a-9330-47d1-a6e8-a0b11example"
}
```
Pour confirmer que l’opération a réussi, vous pouvez exécuter `get-operation-detail`. Pour plus d’informations, consultez [get-operation-detail](https://docs.aws.amazon.com/cli/latest/reference/route53domains/get-operation-detail.html).
Pour de plus amples informations, veuillez consulter [Enregistrement d’un nouveau domaine](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-register.html) dans le *Manuel du développeur Amazon Route 53*.
Pour plus d'informations sur les domaines de premier niveau (TLDs) nécessitant des valeurs `ExtraParams` et sur les valeurs valides, consultez le manuel [ExtraParam](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ExtraParam.html)de *référence des API Amazon Route 53*.
+ Pour plus de détails sur l'API, reportez-vous [RegisterDomain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/register-domain.html)à la section *Référence des AWS CLI commandes*.
------
#### [ Java ]
**SDK pour Java 2.x**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples).
```
public static String requestDomainRegistration(Route53DomainsClient route53DomainsClient,
String domainSuggestion,
String phoneNumber,
String email,
String firstName,
String lastName,
String city) {
try {
ContactDetail contactDetail = ContactDetail.builder()
.contactType(ContactType.COMPANY)
.state("LA")
.countryCode(CountryCode.IN)
.email(email)
.firstName(firstName)
.lastName(lastName)
.city(city)
.phoneNumber(phoneNumber)
.organizationName("My Org")
.addressLine1("My Address")
.zipCode("123 123")
.build();
RegisterDomainRequest domainRequest = RegisterDomainRequest.builder()
.adminContact(contactDetail)
.registrantContact(contactDetail)
.techContact(contactDetail)
.domainName(domainSuggestion)
.autoRenew(true)
.durationInYears(1)
.build();
RegisterDomainResponse response = route53DomainsClient.registerDomain(domainRequest);
System.out.println("Registration requested. Operation Id: " + response.operationId());
return response.operationId();
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
return "";
}
```
+ Pour plus de détails sur l'API, reportez-vous [RegisterDomain](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/RegisterDomain)à la section *Référence des AWS SDK for Java 2.x API*.
------
#### [ Kotlin ]
**SDK pour Kotlin**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples).
```
suspend fun requestDomainRegistration(
domainSuggestion: String?,
phoneNumberVal: String?,
emailVal: String?,
firstNameVal: String?,
lastNameVal: String?,
cityVal: String?,
): String? {
val contactDetail =
ContactDetail {
contactType = ContactType.Company
state = "LA"
countryCode = CountryCode.In
email = emailVal
firstName = firstNameVal
lastName = lastNameVal
city = cityVal
phoneNumber = phoneNumberVal
organizationName = "My Org"
addressLine1 = "My Address"
zipCode = "123 123"
}
val domainRequest =
RegisterDomainRequest {
adminContact = contactDetail
registrantContact = contactDetail
techContact = contactDetail
domainName = domainSuggestion
autoRenew = true
durationInYears = 1
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
val response = route53DomainsClient.registerDomain(domainRequest)
println("Registration requested. Operation Id: ${response.operationId}")
return response.operationId
}
}
```
+ Pour plus de détails sur l'API, consultez [RegisterDomain](https://sdk.amazonaws.com/kotlin/api/latest/index.html)la section *AWS SDK pour la référence de l'API Kotlin*.
------
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de Route 53 avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.
# Utilisation `ViewBilling` avec un AWS SDK ou une CLI
Les exemples de code suivants illustrent comment utiliser `ViewBilling`.
Les exemples d’actions sont des extraits de code de programmes de plus grande envergure et doivent être exécutés en contexte. Vous pouvez voir cette action en contexte dans l’exemple de code suivant :
+ [Principes de base](route-53-domains_example_route-53-domains_Scenario_GetStartedRoute53Domains_section.md)
------
#### [ .NET ]
**SDK pour .NET**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Route53#code-examples).
```
///
/// View billing records for the account between a start and end date.
///
/// The start date for billing results.
/// The end date for billing results.
/// A collection of billing records.
public async Task> ViewBilling(DateTime startDate, DateTime endDate)
{
var results = new List();
var paginateBilling = _amazonRoute53Domains.Paginators.ViewBilling(
new ViewBillingRequest()
{
Start = startDate,
End = endDate
});
// Get the entire list using the paginator.
await foreach (var billingRecords in paginateBilling.BillingRecords)
{
results.Add(billingRecords);
}
return results;
}
```
+ Pour plus de détails sur l'API, reportez-vous [ViewBilling](https://docs.aws.amazon.com/goto/DotNetSDKV3/route53domains-2014-05-15/ViewBilling)à la section *Référence des AWS SDK pour .NET API*.
------
#### [ CLI ]
**AWS CLI**
**Pour obtenir les informations de facturation relatives aux frais d'enregistrement de domaine pour le AWS compte courant**
La commande `view-billing` suivante renvoie tous les enregistrements de facturation relatifs au domaine pour le compte actuel pour la période comprise entre le 1er janvier 2018 (1514764800 en heure Unix) et minuit le 31 décembre 2019 (1577836800 en heure Unix).
Cette commande s’exécute uniquement dans la région `us-east-1`. Si la région par défaut est définie sur `us-east-1`, vous pouvez omettre le paramètre `region`.
```
aws route53domains view-billing \
--region us-east-1 \
--start-time 1514764800 \
--end-time 1577836800
```
Sortie :
```
{
"BillingRecords": [
{
"DomainName": "example.com",
"Operation": "RENEW_DOMAIN",
"InvoiceId": "149962827",
"BillDate": 1536618063.181,
"Price": 12.0
},
{
"DomainName": "example.com",
"Operation": "RENEW_DOMAIN",
"InvoiceId": "290913289",
"BillDate": 1568162630.884,
"Price": 12.0
}
]
}
```
Pour plus d'informations, consultez [ViewBilling](https://docs.aws.amazon.com/Route53/latest/APIReference/API_domains_ViewBilling.html)le manuel de *référence des API Amazon Route 53*.
+ Pour plus de détails sur l'API, reportez-vous [ViewBilling](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53domains/view-billing.html)à la section *Référence des AWS CLI commandes*.
------
#### [ Java ]
**SDK pour Java 2.x**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/route53#code-examples).
```
public static void listBillingRecords(Route53DomainsClient route53DomainsClient) {
try {
Date currentDate = new Date();
LocalDateTime localDateTime = currentDate.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime();
ZoneOffset zoneOffset = ZoneOffset.of("+01:00");
LocalDateTime localDateTime2 = localDateTime.minusYears(1);
Instant myStartTime = localDateTime2.toInstant(zoneOffset);
Instant myEndTime = localDateTime.toInstant(zoneOffset);
ViewBillingRequest viewBillingRequest = ViewBillingRequest.builder()
.start(myStartTime)
.end(myEndTime)
.build();
ViewBillingIterable listRes = route53DomainsClient.viewBillingPaginator(viewBillingRequest);
listRes.stream()
.flatMap(r -> r.billingRecords().stream())
.forEach(content -> System.out.println(" Bill Date:: " + content.billDate() +
" Operation: " + content.operationAsString() +
" Price: " + content.price()));
} catch (Route53Exception e) {
System.err.println(e.getMessage());
System.exit(1);
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [ViewBilling](https://docs.aws.amazon.com/goto/SdkForJavaV2/route53domains-2014-05-15/ViewBilling)à la section *Référence des AWS SDK for Java 2.x API*.
------
#### [ Kotlin ]
**SDK pour Kotlin**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin/services/route53#code-examples).
```
suspend fun listBillingRecords() {
val currentDate = Date()
val localDateTime = currentDate.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime()
val zoneOffset = ZoneOffset.of("+01:00")
val localDateTime2 = localDateTime.minusYears(1)
val myStartTime = localDateTime2.toInstant(zoneOffset)
val myEndTime = localDateTime.toInstant(zoneOffset)
val timeStart: Instant? = myStartTime?.let { Instant(it) }
val timeEnd: Instant? = myEndTime?.let { Instant(it) }
val viewBillingRequest =
ViewBillingRequest {
start = timeStart
end = timeEnd
}
Route53DomainsClient.fromEnvironment { region = "us-east-1" }.use { route53DomainsClient ->
route53DomainsClient
.viewBillingPaginated(viewBillingRequest)
.transform { it.billingRecords?.forEach { obj -> emit(obj) } }
.collect { billing ->
println("Bill Date: ${billing.billDate}")
println("Operation: ${billing.operation}")
println("Price: ${billing.price}")
}
}
}
```
+ Pour plus de détails sur l'API, consultez [ViewBilling](https://sdk.amazonaws.com/kotlin/api/latest/index.html)la section *AWS SDK pour la référence de l'API Kotlin*.
------
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de Route 53 avec un AWS SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.