Ejemplos de Route 53 con herramientas para PowerShell - AWS SDKEjemplos de código

Hay más AWS SDK ejemplos disponibles en el GitHub repositorio de AWS Doc SDK Examples.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Ejemplos de Route 53 con herramientas para PowerShell

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes AWS Tools for PowerShell con Route 53.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.

Cada ejemplo incluye un enlace al código fuente completo, donde puede encontrar instrucciones sobre cómo configurar y ejecutar el código en su contexto.

Acciones

En el siguiente ejemplo de código se muestra cómo usar Edit-R53ResourceRecordSet.

Herramientas para PowerShell

Ejemplo 1: en este ejemplo, se crea un registro A para www.example.com y se cambia el registro A de test.example.com de 192.0.2.3 a 192.0.2.1. Tenga en cuenta que los valores de los registros TXT de tipo cambio deben estar entre comillas dobles. Consulte la documentación de Amazon Route 53 para obtener más información. Puede usar el Get-R53Change cmdlet para sondear y determinar cuándo se han completado los cambios.

$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

Ejemplo 2: en este ejemplo, se muestra cómo crear conjuntos de registros de recursos de alias. “Z222222222” es el ID de la zona alojada de Amazon Route 53 en la que crea el conjunto de registros de recursos de alias. “example.com” es el vértice de zona para el que desea crear un alias y “www.example.com” es un subdominio para el que también debe crear un alias. «Z11111» es un ejemplo de un ID de zona alojada para el balanceador de cargas y «example-load-balancer-11.us-east-1.elb.amazonaws.com» es un ejemplo de un nombre de dominio de balanceador de carga con el que Amazon Route 53 responde a las consultas de example.com y www.example.com. Consulte la documentación de Amazon Route 53 para obtener más información. Puede usar el cmdlet para sondear y determinar cuándo se han completado los cambios. Get-R53Change

$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

Ejemplo 3: en este ejemplo, se crean dos registros A para www.example.com. Una cuarta parte de las veces (1/(1+3)), Amazon Route 53 responde a las consultas de www.example.com con los dos valores del primer conjunto de registros de recursos (192.0.2.9 y 192.0.2.10). Tres cuartas partes de las veces (3/(1+3)), Amazon Route 53 responde a las consultas de www.example.com con los dos valores del segundo conjunto de registros de recursos (192.0.2.11 y 192.0.2.12). Consulte la documentación de Amazon Route 53 para obtener más información. Puede usar el Get-R53Change cmdlet para sondear y determinar cuándo se han completado los cambios.

$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

Ejemplo 4: en este ejemplo se muestra cómo crear conjuntos de registros de recursos de alias ponderados suponiendo que example.com es el dominio para el que desea crear conjuntos de registros de recursos de alias ponderados. SetIdentifier diferencia los dos conjuntos de registros de recursos de alias ponderados entre sí. Este elemento es obligatorio porque los elementos Nombre y Tipo tienen los mismos valores para ambos conjuntos de registros de recursos. Los valores Z333311111 y Z3333333333333 son ejemplos de zona hospedada para el balanceador de ELB cargas IDs especificado por el valor de. DNSName example-load-balancer-2222222222.us-east-1.elb.amazonaws.com y -4444444444.us-east-1.elb.amazonaws.com example-load-balancer son ejemplos de dominios de Elastic Load Balancing desde los que Amazon Route 53 responde a las consultas de example.com. Consulte la documentación de Amazon Route 53 para obtener más información. Puede usar el cmdlet para sondear y determinar cuándo Get-R53Change se han completado los cambios.

$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

Ejemplo 5: en este ejemplo se crean dos conjuntos de registros de recursos de alias de latencia, uno para un balanceador de ELB cargas en la región EE.UU. Oeste (Oregón) (us-west-2) y otro para un balanceador de cargas en la región Asia-Pacífico (Singapur) (ap-southeast-1). Consulte la documentación de Amazon Route 53 para obtener más información. Puede usar el Get-R53Change cmdlet para sondear y determinar cuándo se han completado los cambios.

$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

En el siguiente ejemplo de código se muestra cómo usar Get-R53AccountLimit.

Herramientas para PowerShell

Ejemplo 1: Este ejemplo devuelve el número máximo de zonas alojadas que se pueden crear con la cuenta actual.

Get-R53AccountLimit -Type MAX_HOSTED_ZONES_BY_OWNER

Salida:

15
  • Para API obtener más información, consulte GetAccountLimitla referencia de AWS Tools for PowerShell cmdlets.

En el siguiente ejemplo de código se muestra cómo usar Get-R53CheckerIpRanges.

Herramientas para PowerShell

Ejemplo 1: Este ejemplo devuelve el valor de los CIDRs comprobadores de estado de Route53

Get-R53CheckerIpRanges

Salida:

15.177.2.0/23 15.177.6.0/23 15.177.10.0/23 15.177.14.0/23 15.177.18.0/23 15.177.22.0/23 15.177.26.0/23 15.177.30.0/23 15.177.34.0/23 15.177.38.0/23 15.177.42.0/23 15.177.46.0/23 15.177.50.0/23 15.177.54.0/23 15.177.58.0/23 15.177.62.0/23 54.183.255.128/26 54.228.16.0/26 54.232.40.64/26 54.241.32.64/26 54.243.31.192/26 54.244.52.192/26 54.245.168.0/26 54.248.220.0/26 54.250.253.192/26 54.251.31.128/26 54.252.79.128/26 54.252.254.192/26 54.255.254.192/26 107.23.255.0/26 176.34.159.192/26 177.71.207.128/26
  • Para API obtener más información, consulte Cmdlet GetCheckerIpRangesReference AWS Tools for PowerShell .

En el siguiente ejemplo de código se muestra cómo usar Get-R53HostedZone.

Herramientas para PowerShell

Ejemplo 1: Devuelve los detalles de la zona alojada con el ID PJN98FT9 Z1D633.

Get-R53HostedZone -Id Z1D633PJN98FT9
  • Para obtener API más información, consulte GetHostedZonela referencia de cmdlets.AWS Tools for PowerShell

En el siguiente ejemplo de código se muestra cómo usar Get-R53HostedZoneCount.

Herramientas para PowerShell

Ejemplo 1: devuelve el número total de zonas alojadas públicas y privadas de la actual Cuenta de AWS.

Get-R53HostedZoneCount
  • Para API obtener más información, consulte GetHostedZoneCountla referencia de AWS Tools for PowerShell cmdlets.

En el siguiente ejemplo de código se muestra cómo usar Get-R53HostedZoneLimit.

Herramientas para PowerShell

Ejemplo 1: en este ejemplo se devuelve el límite del número máximo de registros que se pueden crear en la zona alojada especificada.

Get-R53HostedZoneLimit -HostedZoneId Z3MEQ8T7HAAAAF -Type MAX_RRSETS_BY_ZONE

Salida:

5

En el siguiente ejemplo de código se muestra cómo usar Get-R53HostedZoneList.

Herramientas para PowerShell

Ejemplo 1: se muestra todas las zonas alojadas públicas y privadas.

Get-R53HostedZoneList

Ejemplo 2: Muestra todas las zonas alojadas que están asociadas al conjunto de delegación reutilizable que tiene el ID NZ8X2CISAMPLE

Get-R53HostedZoneList -DelegationSetId NZ8X2CISAMPLE
  • Para API obtener más información, consulte ListHostedZonesla referencia del AWS Tools for PowerShell cmdlet.

En el siguiente ejemplo de código se muestra cómo usar Get-R53HostedZonesByName.

Herramientas para PowerShell

Ejemplo 1: Devuelve todas las zonas alojadas públicas y privadas ASCII ordenadas por nombre de dominio.

Get-R53HostedZonesByName

Ejemplo 2: Devuelve las zonas alojadas públicas y privadas, ASCII ordenadas por nombre de dominio, empezando por el DNS nombre especificado.

Get-R53HostedZonesByName -DnsName example2.com
  • Para API obtener más información, consulte ListHostedZonesByNamela referencia de AWS Tools for PowerShell cmdlets.

En el siguiente ejemplo de código se muestra cómo usar Get-R53QueryLoggingConfigList.

Herramientas para PowerShell

Ejemplo 1: Este ejemplo devuelve todas las configuraciones del registro de DNS consultas asociadas a la actual Cuenta de AWS.

Get-R53QueryLoggingConfigList

Salida:

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:*
  • Para API obtener más información, consulte ListQueryLoggingConfigsla referencia del AWS Tools for PowerShell cmdlet.

En el siguiente ejemplo de código se muestra cómo usar Get-R53ReusableDelegationSet.

Herramientas para PowerShell

Ejemplo 1: Este ejemplo recupera información sobre el conjunto de delegación especificado, incluidos los cuatro servidores de nombres que están asignados al conjunto de delegación.

Get-R53ReusableDelegationSet -Id N23DS9X4AYEAAA

Salida:

Id CallerReference NameServers -- --------------- ----------- /delegationset/N23DS9X4AYEAAA testcaller {ns-545.awsdns-04.net, ns-1264.awsdns-30.org, ns-2004.awsdns-58.co.uk, ns-240.awsdns-30.com}

En el siguiente ejemplo de código se muestra cómo usar New-R53HostedZone.

Herramientas para PowerShell

Ejemplo 1: crea una nueva zona alojada llamada “example.com”, asociada a un conjunto de delegación reutilizable. Tenga en cuenta que debe proporcionar un valor para el CallerReference parámetro de modo que las solicitudes se tengan que volver a intentar si es necesario sin correr el riesgo de ejecutar la operación dos veces. Como la zona alojada se crea en unVPC, es automáticamente privada y no debe establecer el PrivateZone parámetro - HostedZoneConfig _.

$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
  • Para API obtener más información, consulte CreateHostedZonela referencia de AWS Tools for PowerShell cmdlets.

En el siguiente ejemplo de código se muestra cómo usar New-R53QueryLoggingConfig.

Herramientas para PowerShell

Ejemplo 1: Este ejemplo crea una nueva configuración de registro de DNS consultas de Route53 para la zona alojada especificada. Amazon Route53 publicará los registros de DNS consultas en el grupo de registros de Cloudwatch especificado.

New-R53QueryLoggingConfig -HostedZoneId Z3MEQ8T7HAAAAF -CloudWatchLogsLogGroupArn arn:aws:logs:us-east-1:111111111111:log-group:/aws/route53/example.com:*

Salida:

QueryLoggingConfig Location ------------------ -------- Amazon.Route53.Model.QueryLoggingConfig https://route53.amazonaws.com/2013-04-01/queryloggingconfig/ee5aaa95-4e03-4fdc-9d28-9e24ddaaaaa3
  • Para API obtener más información, consulte la referencia de CreateQueryLoggingConfigcmdlets AWS Tools for PowerShell .

En el siguiente ejemplo de código se muestra cómo usar New-R53ReusableDelegationSet.

Herramientas para PowerShell

Ejemplo 1: Este ejemplo crea un conjunto de delegación reutilizable de 4 servidores de nombres que pueden reutilizarse en varias zonas alojadas.

New-R53ReusableDelegationSet -CallerReference testcallerreference

Salida:

DelegationSet Location ------------- -------- Amazon.Route53.Model.DelegationSet https://route53.amazonaws.com/2013-04-01/delegationset/N23DS9XAAAAAXM

En el siguiente ejemplo de código se muestra cómo usar Register-R53VPCWithHostedZone.

Herramientas para PowerShell

Ejemplo 1: Este ejemplo asocia lo especificado VPC a la zona alojada privada.

Register-R53VPCWithHostedZone -HostedZoneId Z3MEQ8T7HAAAAF -VPC_VPCId vpc-f1b9aaaa -VPC_VPCRegion us-east-1

Salida:

Id Status SubmittedAt Comment -- ------ ----------- ------- /change/C3SCAAA633Z6DX PENDING 01/28/2020 19:32:02

En el siguiente ejemplo de código se muestra cómo usar Remove-R53HostedZone.

Herramientas para PowerShell

Ejemplo 1: se elimina la zona alojada con el ID especificado. Antes de continuar con el comando, se le solicitará que lo confirme, a menos que añada el parámetro -Force switch.

Remove-R53HostedZone -Id Z1PA6795UKMFR9
  • Para API obtener más información, consulte DeleteHostedZonela referencia de AWS Tools for PowerShell cmdlets.

En el siguiente ejemplo de código se muestra cómo usar Remove-R53QueryLoggingConfig.

Herramientas para PowerShell

Ejemplo 1: en este ejemplo se elimina la configuración especificada para el registro de DNS consultas.

Remove-R53QueryLoggingConfig -Id ee528e95-4e03-4fdc-9d28-9e24daaa20063

En el siguiente ejemplo de código se muestra cómo usar Remove-R53ReusableDelegationSet.

Herramientas para PowerShell

Ejemplo 1: en este ejemplo se elimina el conjunto de delegación reutilizable especificado.

Remove-R53ReusableDelegationSet -Id N23DS9X4AYAAAM

En el siguiente ejemplo de código se muestra cómo usar Unregister-R53VPCFromHostedZone.

Herramientas para PowerShell

Ejemplo 1: en este ejemplo se desvincula lo especificado VPC de la zona alojada privada.

Unregister-R53VPCFromHostedZone -HostedZoneId Z3MEQ8T7HAAAAF -VPC_VPCId vpc-f1b9aaaa -VPC_VPCRegion us-east-1

Salida:

Id Status SubmittedAt Comment -- ------ ----------- ------- /change/C2XFCAAAA9HKZG PENDING 01/28/2020 10:35:55

En el siguiente ejemplo de código se muestra cómo usar Update-R53HostedZoneComment.

Herramientas para PowerShell

Ejemplo 1: Este comando actualiza el comentario de la zona alojada especificada.

Update-R53HostedZoneComment -Id Z385PDS6AAAAAR -Comment "This is my first hosted zone"

Salida:

Id : /hostedzone/Z385PDS6AAAAAR Name : example.com. CallerReference : C5B55555-7147-EF04-8341-69131E805C89 Config : Amazon.Route53.Model.HostedZoneConfig ResourceRecordSetCount : 9 LinkedService :
  • Para API obtener más información, consulte UpdateHostedZoneCommentla referencia de AWS Tools for PowerShell cmdlets.