Route 53-Beispiele mit AWS CLI - AWS SDK-Codebeispiele
Aktionen

Weitere AWS SDK-Beispiele sind im Repo AWS Doc SDK Examples GitHub verfügbar.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Route 53-Beispiele mit AWS CLI

Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von Route 53 Aktionen ausführen und allgemeine Szenarien implementieren. AWS Command Line Interface

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarios anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, in dem Sie Anweisungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt die Verwendungchange-resource-record-sets.

AWS CLI

Um einen Ressourcendatensatz zu erstellen, zu aktualisieren oder zu löschen

Der folgende change-resource-record-sets Befehl erstellt einen Ressourcendatensatz unter Verwendung der hosted-zone-id Z1R8UBAEXAMPLE und der JSON-formatierten Konfiguration in der Datei: 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

Weitere Informationen finden Sie unter POST ChangeResourceRecordSets in der Amazon Route 53 API-Referenz.

Die Konfiguration in der JSON-Datei hängt von der Art des Ressourceneintrags ab, den Sie erstellen möchten:

BasicWeightedAliasWeighted AliasLatencyLatency AliasFailoverFailover Alias

Grundlegende Syntax:

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

Gewichtete Syntax:

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

Alias-Syntax:

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

Gewichtete Alias-Syntax:

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

Latenz-Syntax:

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

Latenz-Alias-Syntax:

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

Failover-Syntax:

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

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

Das folgende Codebeispiel zeigt die Verwendungchange-tags-for-resource.

AWS CLI

Mit dem folgenden Befehl wird einer durch die ID angegebenen Healthcheck-Ressource ein Tag mit dem Namen owner hinzugefügt:

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

Mit dem folgenden Befehl wird ein Tag mit dem Namen owner aus einer Ressource in der gehosteten Zone entfernt, die mit der ID angegeben ist:

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

Das folgende Codebeispiel zeigt die Verwendungcreate-health-check.

AWS CLI

Um einen Gesundheitscheck zu erstellen

Mit dem folgenden create-health-check Befehl wird mithilfe der Anruferreferenz 2014-04-01-18:47 und der Konfiguration im JSON-Format in der Datei eine Integritätsprüfung erstellt: 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

JSON-Syntax:

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

Verwenden Sie den change-resource-record-sets Befehl, um die Integritätsprüfung zu einem Route 53 53-Ressourcendatensatz hinzuzufügen.

Weitere Informationen finden Sie unter Amazon Route 53 Health Checks and DNS Failover im Amazon Route 53 Developer Guide.

Das folgende Codebeispiel zeigt die Verwendungcreate-hosted-zone.

AWS CLI

So erstellen Sie eine gehostete Zone

Der folgende create-hosted-zone Befehl fügt eine gehostete Zone hinzu, die example.com mithilfe der Anruferreferenz 2014-04-01-18:47 benannt wird. Der optionale Kommentar enthält ein Leerzeichen und muss daher in Anführungszeichen gesetzt werden:

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

Weitere Informationen finden Sie unter Working with Hosted Zones im Amazon Route 53 53-Entwicklerhandbuch.

  • Einzelheiten zur API finden Sie CreateHostedZoneunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-health-check.

AWS CLI

Um einen Gesundheitscheck zu löschen

Der folgende delete-health-check Befehl löscht die Integritätsprüfung mit einem health-check-id vone75b48d9-547a-4c3d-88a5-ae4002397608:

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

Das folgende Codebeispiel zeigt die Verwendungdelete-hosted-zone.

AWS CLI

Um eine gehostete Zone zu löschen

Der folgende delete-hosted-zone Befehl löscht die Hosting-Zone mit dem Wert id vonZ36KTIQEXAMPLE:

aws route53 delete-hosted-zone --id Z36KTIQEXAMPLE

  • Einzelheiten zur API finden Sie DeleteHostedZonein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-change.

AWS CLI

Um den Status einer Änderung an Ressourcendatensätzen abzurufen

Mit dem folgenden get-change Befehl werden der Status und weitere Informationen zu der change-resource-record-sets Anfrage abgerufen, die den Wert Id von hat/change/CWPIK4URU2I5S:

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

  • Einzelheiten zur API finden Sie GetChangeunter AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-health-check.

AWS CLI

Um Informationen über einen Gesundheitscheck zu erhalten

Mit dem folgenden get-health-check Befehl werden Informationen zur Integritätsprüfung abgerufen, die einen Wert health-check-id von hat02ec8401-9879-4259-91fa-04e66d094674:

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

  • Einzelheiten zur API finden Sie GetHealthCheckin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-hosted-zone.

AWS CLI

Um Informationen über eine gehostete Zone abzurufen

Mit dem folgenden get-hosted-zone Befehl werden Informationen über die Hosting-Zone mit dem Wert id von abgerufenZ1R8UBAEXAMPLE:

aws route53 get-hosted-zone --id Z1R8UBAEXAMPLE

  • Einzelheiten zur API finden Sie GetHostedZonein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-health-checks.

AWS CLI

Um die mit dem AWS Girokonto verknüpften Gesundheitschecks aufzulisten

Der folgende list-health-checks Befehl listet detaillierte Informationen zu den ersten 100 Zustandsprüfungen auf, die mit dem aktuellen AWS Konto verknüpft sind. :

aws route53 list-health-checks

Wenn Sie mehr als 100 Zustandsprüfungen haben oder wenn Sie diese in Gruppen mit weniger als 100 auflisten möchten, geben Sie den --maxitems Parameter an. Um beispielsweise die Zustandsprüfungen einzeln aufzulisten, verwenden Sie den folgenden Befehl:

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

Um die nächste Integritätsprüfung anzuzeigen, nehmen Sie den Wert von NextToken aus der Antwort auf den vorherigen Befehl und fügen ihn in den --starting-token Parameter ein, zum Beispiel:

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

  • Einzelheiten zur API finden Sie ListHealthChecksin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-hosted-zones-by-name.

AWS CLI

Der folgende Befehl listet bis zu 100 gehostete Zonen auf, sortiert nach Domainnamen:

aws route53 list-hosted-zones-by-name

Ausgabe:

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

Der folgende Befehl listet die Hosting-Zonen nach Namen geordnet auf, beginnend mitwww.example.com:

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

Ausgabe:

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

Das folgende Codebeispiel zeigt die Verwendunglist-hosted-zones.

AWS CLI

Um die Hosting-Zonen aufzulisten, die dem aktuellen AWS Konto zugeordnet sind

Der folgende list-hosted-zones Befehl listet zusammenfassende Informationen zu den ersten 100 Hostzonen auf, die dem aktuellen AWS Konto zugeordnet sind. :

aws route53 list-hosted-zones

Wenn Sie mehr als 100 gehostete Zonen haben oder wenn Sie sie in Gruppen von weniger als 100 auflisten möchten, fügen Sie den Parameter --max-items ein. Um zum Beispiel eine gehostete Zone nach der anderen aufzulisten, verwenden Sie den folgenden Befehl:

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

Um Informationen über die nächste gehostete Zone anzuzeigen, übernehmen Sie den Wert von NextToken aus der Antwort auf den vorherigen Befehl und fügen ihn in den Parameter --starting-token ein, zum Beispiel:

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

  • Einzelheiten zur API finden Sie ListHostedZonesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-query-logging-configs.

AWS CLI

Um Konfigurationen für die Abfrageprotokollierung aufzulisten

Im folgenden list-query-logging-configs Beispiel werden Informationen zu den ersten 100 Konfigurationen für die Abfrageprotokollierung in Ihrem AWS Konto für die gehostete Zone aufgeführtZ1OX3WQEXAMPLE.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Protokollierung von DNS-Abfragen im Amazon Route 53 53-Entwicklerhandbuch.

Das folgende Codebeispiel zeigt die Verwendunglist-resource-record-sets.

AWS CLI

Um die Ressourcendatensätze in einer gehosteten Zone aufzulisten

Der folgende list-resource-record-sets Befehl listet zusammenfassende Informationen zu den ersten 100 Ressourcendatensätzen in einer angegebenen Hostzone auf. :

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

Wenn die gehostete Zone mehr als 100 Ressourcendatensätze enthält oder wenn Sie sie in Gruppen mit weniger als 100 auflisten möchten, geben Sie den --maxitems Parameter an. Verwenden Sie beispielsweise den folgenden Befehl, um Ressourcendatensätze einzeln aufzulisten:

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

Um Informationen über den nächsten Ressourceneintrag in der Hosting-Zone anzuzeigen, nehmen Sie den Wert von NextToken aus der Antwort auf den vorherigen Befehl und fügen ihn in den --starting-token Parameter ein, zum Beispiel:

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

Um alle Ressourcendatensätze mit einem bestimmten Namen anzuzeigen, verwenden Sie den --query Parameter, um sie herauszufiltern. Zum Beispiel:

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