Esempi di Route 53 che utilizzano AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with Route 53.

Le operazioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Mentre le azioni mostrano come richiamare le singole funzioni di servizio, è possibile visualizzare le azioni nel loro contesto negli scenari correlati.

Ogni esempio include un collegamento al codice sorgente completo, in cui è possibile trovare istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

Azioni

Il seguente esempio di codice mostra come utilizzarechange-resource-record-sets.

AWS CLI

Per creare, aggiornare o eliminare un set di record di risorse

Il change-resource-record-sets comando seguente crea un set di record di risorse utilizzando la configurazione in JSON formato hosted-zone-id Z1R8UBAEXAMPLE e nel file: 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

Per ulteriori informazioni, POST ChangeResourceRecordSets consulta Amazon Route 53 API Reference.

La configurazione nel JSON file dipende dal tipo di set di record di risorse che desideri creare:

BasicWeightedAliasWeighted AliasLatencyLatency AliasFailoverFailover Alias

Sintassi di 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"
          },
          {...}
        ]
      }
    },
    {...}
  ]
}

Sintassi ponderata:


{
  "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"
      }
    },
    {...}
  ]
}

Sintassi degli 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"
      }
    },
    {...}
  ]
}

Sintassi degli alias ponderati:


{
  "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"
      }
    },
    {...}
  ]
}

Sintassi della latenza:


{
  "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"
      }
    },
    {...}
  ]
}

Sintassi dell'alias di latenza:


{
  "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"
      }
    },
    {...}
  ]
}

Sintassi di failover:


{
  "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"
      }
    },
    {...}
  ]
}

Sintassi degli alias di failover:


{
  "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"
      }
    },
    {...}
  ]
}

Per API i dettagli, vedere ChangeResourceRecordSetsin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarechange-tags-for-resource.

AWS CLI

Il comando seguente aggiunge un tag denominato owner a una risorsa healthcheck specificata da ID:


aws route53 change-tags-for-resource --resource-type healthcheck --resource-id 6233434j-18c1-34433-ba8e-3443434 --add-tags Key=owner,Value=myboss

Il comando seguente rimuove un tag denominato owner da una risorsa della zona ospitata specificata da ID:


aws route53 change-tags-for-resource --resource-type hostedzone --resource-id Z1523434445 --remove-tag-keys owner

Per API i dettagli, vedere ChangeTagsForResourcein AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarecreate-health-check.

AWS CLI

Per creare un controllo sanitario

Il create-health-check comando seguente crea un controllo dello stato utilizzando il riferimento al chiamante 2014-04-01-18:47 e la configurazione JSON -formatted nel file: C:\awscli\route53\create-health-check.json


aws route53 create-health-check --caller-reference 2014-04-01-18:47 --health-check-config file://C:\awscli\route53\create-health-check.json

JSONsintassi:


{
  "IPAddress": "IP address of the endpoint to check",
  "Port": port on the endpoint to check--required when Type is "TCP",
  "Type": "HTTP"|"HTTPS"|"HTTP_STR_MATCH"|"HTTPS_STR_MATCH"|"TCP",
  "ResourcePath": "path of the file that you want Amazon Route 53 to request--all Types except TCP",
  "FullyQualifiedDomainName": "domain name of the endpoint to check--all Types except TCP",
  "SearchString": "if Type is HTTP_STR_MATCH or HTTPS_STR_MATCH, the string to search for in the response body from the specified resource",
  "RequestInterval": 10 | 30,
  "FailureThreshold": integer between 1 and 10
}

Per aggiungere il controllo dello stato di salute a un set di record di risorse Route 53, utilizzare il change-resource-record-sets comando.

Per ulteriori informazioni, consulta Amazon Route 53 Health Checks and DNS Failover nella Amazon Route 53 Developer Guide.

Per API i dettagli, consulta CreateHealthCheck AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzarecreate-hosted-zone.

AWS CLI

Per creare una zona ospitata

Il create-hosted-zone comando seguente aggiunge una zona ospitata denominata example.com utilizzando il riferimento del chiamante. 2014-04-01-18:47 Il commento opzionale include uno spazio, quindi deve essere racchiuso tra virgolette:


aws route53 create-hosted-zone --name example.com --caller-reference 2014-04-01-18:47 --hosted-zone-config Comment="command-line version"

Per ulteriori informazioni, consulta Working with Hosted Zones nella Amazon Route 53 Developer Guide.

Per API i dettagli, consulta CreateHostedZone AWS CLICommand Reference.

Il seguente esempio di codice mostra come utilizzaredelete-health-check.

AWS CLI

Per eliminare un controllo sanitario

Il delete-health-check comando seguente elimina il controllo dello stato con un health-check-id die75b48d9-547a-4c3d-88a5-ae4002397608:


aws route53 delete-health-check --health-check-id e75b48d9-547a-4c3d-88a5-ae4002397608

Per API i dettagli, vedere DeleteHealthCheckin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzaredelete-hosted-zone.

AWS CLI

Per eliminare una zona ospitata

Il delete-hosted-zone comando seguente elimina la zona ospitata con un id diZ36KTIQEXAMPLE:


aws route53 delete-hosted-zone --id Z36KTIQEXAMPLE

Per API i dettagli, vedere DeleteHostedZonein AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareget-change.

AWS CLI

Per ottenere lo stato di una modifica ai set di record di risorse

Il get-change comando seguente ottiene lo stato e altre informazioni sulla change-resource-record-sets richiesta che presenta un Id di/change/CWPIK4URU2I5S:


aws route53 get-change --id /change/CWPIK4URU2I5S

Per API i dettagli, vedere GetChangein AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareget-health-check.

AWS CLI

Per ottenere informazioni su un controllo sanitario

Il get-health-check comando seguente consente di ottenere informazioni sul controllo dello stato health-check-id di salute che include02ec8401-9879-4259-91fa-04e66d094674:


aws route53 get-health-check --health-check-id 02ec8401-9879-4259-91fa-04e66d094674

Per API i dettagli, vedere GetHealthCheckin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzareget-hosted-zone.

AWS CLI

Per ottenere informazioni su una zona ospitata

Il get-hosted-zone comando seguente ottiene informazioni sulla zona ospitata con un id diZ1R8UBAEXAMPLE:


aws route53 get-hosted-zone --id Z1R8UBAEXAMPLE

Per API i dettagli, vedere GetHostedZonein AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarelist-health-checks.

AWS CLI

Per elencare i controlli sanitari associati all' AWS account corrente

Il list-health-checks comando seguente elenca informazioni dettagliate sui primi 100 controlli sanitari associati all' AWS account corrente. :


aws route53 list-health-checks

Se hai più di 100 controlli sanitari o se desideri elencarli in gruppi più piccoli di 100, includi il --maxitems parametro. Ad esempio, per elencare i controlli sanitari uno alla volta, utilizzate il comando seguente:


aws route53 list-health-checks --max-items 1

Per visualizzare il prossimo controllo di integrità, prendi il valore di NextToken dalla risposta al comando precedente e includilo nel --starting-token parametro, ad esempio:


aws route53 list-health-checks --max-items 1 --starting-token Z3M3LMPEXAMPLE

Per API i dettagli, vedere ListHealthChecksin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarelist-hosted-zones-by-name.

AWS CLI

Il comando seguente elenca fino a 100 zone ospitate ordinate per nome di dominio:


aws route53 list-hosted-zones-by-name

Output:


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

Il comando seguente elenca le zone ospitate ordinate per nome, a partire dawww.example.com:


aws route53 list-hosted-zones-by-name --dns-name www.example.com

Output:


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

Per API i dettagli, vedere ListHostedZonesByNamein AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarelist-hosted-zones.

AWS CLI

Per elencare le zone ospitate associate all' AWS account corrente

Il list-hosted-zones comando seguente elenca le informazioni di riepilogo sulle prime 100 zone ospitate associate all' AWS account corrente. :


aws route53 list-hosted-zones

Se disponi di oltre 100 zone ospitate o se desideri elencarle in gruppi più piccoli di 100, includi il parametro --max-items. Ad esempio, per elencare le zone ospitate una alla volta, utilizza il comando seguente:


aws route53 list-hosted-zones --max-items 1

Per visualizzare le informazioni sulla zona ospitata successiva, prendi il valore di NextToken dalla risposta al comando precedente e includilo nel parametro --starting-token, ad esempio:


aws route53 list-hosted-zones --max-items 1 --starting-token Z3M3LMPEXAMPLE

Per API i dettagli, vedere ListHostedZonesin AWS CLI Command Reference.

Il seguente esempio di codice mostra come utilizzarelist-query-logging-configs.

AWS CLI

Per elencare le configurazioni di registrazione delle query

L'list-query-logging-configsesempio seguente elenca le informazioni sulle prime 100 configurazioni di registrazione delle query nell' AWS account, per la zona ospitata. Z1OX3WQEXAMPLE


aws route53 list-query-logging-configs \
    --hosted-zone-id Z1OX3WQEXAMPLE

Output:


{
    "QueryLoggingConfigs": [
        {
            "Id": "964ff34e-ae03-4f06-80a2-9683cexample",
            "HostedZoneId": "Z1OX3WQEXAMPLE",
            "CloudWatchLogsLogGroupArn": "arn:aws:logs:us-east-1:111122223333:log-group:/aws/route53/example.com:*"
        }
    ]
}

Per ulteriori informazioni, consulta la sezione Logging DNS delle query nella Amazon Route 53 Developer Guide.

Per API i dettagli, consulta AWS CLI Command ListQueryLoggingConfigsReference.

Il seguente esempio di codice mostra come utilizzarelist-resource-record-sets.

AWS CLI

Per elencare i set di record di risorse in una zona ospitata

Il list-resource-record-sets comando seguente elenca informazioni di riepilogo sui primi 100 set di record di risorse in una zona ospitata specificata. :


aws route53 list-resource-record-sets --hosted-zone-id Z2LD58HEXAMPLE

Se la zona ospitata contiene più di 100 set di record di risorse o se desideri elencarli in gruppi più piccoli di 100, includi il --maxitems parametro. Ad esempio, per elencare i set di record di risorse uno alla volta, utilizzate il comando seguente:


aws route53 list-resource-record-sets --hosted-zone-id Z2LD58HEXAMPLE --max-items 1

Per visualizzare le informazioni sul prossimo record di risorse impostato nella zona ospitata, prendete il valore di NextToken dalla risposta al comando precedente e includetelo nel --starting-token parametro, ad esempio:


aws route53 list-resource-record-sets --hosted-zone-id Z2LD58HEXAMPLE --max-items 1 --starting-token Z3M3LMPEXAMPLE

Per visualizzare tutti i set di record di risorse con un nome particolare, utilizzate il --query parametro per filtrarli. Per esempio:


aws route53 list-resource-record-sets --hosted-zone-id Z2LD58HEXAMPLE --query "ResourceRecordSets[?Name == 'example.domain.']"

Per API i dettagli, vedere ListResourceRecordSetsin AWS CLI Command Reference.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

AWS RoboMaker

Registrazione del dominio Route 53