Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/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 perfiles de Route 53 que utilizan AWS CLI
Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso de los perfiles AWS Command Line Interface de 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 distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
**Topics**
+ [Acciones](#actions)
## Acciones
### `associate-profile`
En el siguiente ejemplo de código, se muestra cómo utilizar `associate-profile`.
**AWS CLI**
**Para asociar un perfil**
En el siguiente ejemplo de `associate-profile`, se asocia un perfil a una VPC.
```
aws route53profiles associate-profile \
--name test-association \
--profile-id rp-4987774726example \
--resource-id vpc-0af3b96b3example
```
Salida:
```
{
"ProfileAssociation": {
"CreationTime": 1710851336.527,
"Id": "rpassoc-489ce212fexample",
"ModificationTime": 1710851336.527,
"Name": "test-association",
"OwnerId": "123456789012",
"ProfileId": "rp-4987774726example",
"ResourceId": "vpc-0af3b96b3example",
"Status": "CREATING",
"StatusMessage": "Creating Profile Association"
}
}
```
Para más información, consulte [Using Profiles](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/profile-high-level-steps.html) en la *Guía para desarrolladores de Amazon Route 53*.
+ Para obtener más información sobre la API, consulte [AssociateProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/associate-profile.html)la *Referencia de AWS CLI comandos*.
### `associate-resource-to-profile`
En el siguiente ejemplo de código, se muestra cómo utilizar `associate-resource-to-profile`.
**AWS CLI**
**Para asociar un recurso a un perfil**
En el siguiente ejemplo de `associate-resource-to-profile`, se asocia un grupo de reglas de DNS Firewall con una prioridad de 102 a un perfil.
```
aws route53profiles associate-resource-to-profile \
--name test-resource-association \
--profile-id rp-4987774726example \
--resource-arn arn:aws:route53resolver:us-east-1:123456789012:firewall-rule-group/rslvr-frg-cfe7f72example \
--resource-properties "{\"priority\": 102}"
```
Salida:
```
{
"ProfileResourceAssociation": {
"CreationTime": 1710851216.613,
"Id": "rpr-001913120a7example",
"ModificationTime": 1710851216.613,
"Name": "test-resource-association",
"OwnerId": "123456789012",
"ProfileId": "rp-4987774726example",
"ResourceArn": "arn:aws:route53resolver:us-east-1:123456789012:firewall-rule-group/rslvr-frg-cfe7f72example",
"ResourceProperties": "{\"priority\":102}",
"ResourceType": "FIREWALL_RULE_GROUP",
"Status": "UPDATING",
"StatusMessage": "Updating the Profile to DNS Firewall rule group association"
}
}
```
+ Para obtener más información sobre la API, consulte [AssociateResourceToProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/associate-resource-to-profile.html)la *Referencia de AWS CLI comandos*.
### `create-profile`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-profile`.
**AWS CLI**
**Para crear un perfil**
En el ejemplo siguiente de `create-profile`, se crea un perfil.
```
aws route53profiles create-profile \
--name test
```
Salida:
```
{
"Profile": {
"Arn": "arn:aws:route53profiles:us-east-1:123456789012:profile/rp-6ffe47d5example",
"ClientToken": "2ca1a304-32b3-4f5f-bc4c-EXAMPLE11111",
"CreationTime": 1710850903.578,
"Id": "rp-6ffe47d5example",
"ModificationTime": 1710850903.578,
"Name": "test",
"OwnerId": "123456789012",
"ShareStatus": "NOT_SHARED",
"Status": "COMPLETE",
"StatusMessage": "Created Profile"
}
}
```
+ Para obtener más información sobre la API, consulte [CreateProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/create-profile.html)la *Referencia de AWS CLI comandos*.
### `delete-profile`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-profile`.
**AWS CLI**
**Para eliminar un perfil**
En el siguiente ejemplo de `delete-profile`, se elimina un perfil.
```
aws route53profiles delete-profile \
--profile-id rp-6ffe47d5example
```
Salida:
```
{
"Profile": {
"Arn": "arn:aws:route53profiles:us-east-1:123456789012:profile/rp-6ffe47d5example",
"ClientToken": "0a15fec0-05d9-4f78-bec0-EXAMPLE11111",
"CreationTime": 1710850903.578,
"Id": "rp-6ffe47d5example",
"ModificationTime": 1710850903.578,
"Name": "test",
"OwnerId": "123456789012",
"ShareStatus": "NOT_SHARED",
"Status": "DELETED",
"StatusMessage": "Deleted Profile"
}
}
```
+ Para obtener más información sobre la API, consulte [DeleteProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/delete-profile.html)la *Referencia de AWS CLI comandos*.
### `disassociate-profile`
En el siguiente ejemplo de código, se muestra cómo utilizar `disassociate-profile`.
**AWS CLI**
**Para desasociar un perfil**
En el siguiente ejemplo de `disassociate-profile`, se desvincula un perfil de una VPC.
```
aws route53profiles disassociate-profile \
--profile-id rp-4987774726example \
--resource-id vpc-0af3b96b3example
```
Salida:
```
{
"ProfileAssociation": {
"CreationTime": 1710851336.527,
"Id": "rpassoc-489ce212fexample",
"ModificationTime": 1710851401.362,
"Name": "test-association",
"OwnerId": "123456789012",
"ProfileId": "rp-4987774726example",
"ResourceId": "vpc-0af3b96b3example",
"Status": "DELETING",
"StatusMessage": "Deleting Profile Association"
}
}
```
+ Para obtener más información sobre la API, consulte [DisassociateProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/disassociate-profile.html)la *Referencia de AWS CLI comandos*.
### `disassociate-resource-from-profile`
En el siguiente ejemplo de código, se muestra cómo utilizar `disassociate-resource-from-profile`.
**AWS CLI**
**Para desasociar un recurso de un perfil**
En el siguiente ejemplo de `disassociate-resource-from-profile`, se desvincula un grupo de reglas de DNS Firewall de un perfil.
```
aws route53profiles disassociate-resource-from-profile \
--profile-id rp-4987774726example \
--resource-arn arn:aws:route53resolver:us-east-1:123456789012:firewall-rule-group/rslvr-frg-cfe7f72example
```
Salida:
```
{
"ProfileResourceAssociation": {
"CreationTime": 1710851216.613,
"Id": "rpr-001913120a7example",
"ModificationTime": 1710852624.36,
"Name": "test-resource-association",
"OwnerId": "123456789012",
"ProfileId": "rp-4987774726example",
"ResourceArn": "arn:aws:route53resolver:us-east-1:123456789012:firewall-rule-group/rslvr-frg-cfe7f72example",
"ResourceProperties": "{\"priority\":105}",
"ResourceType": "FIREWALL_RULE_GROUP",
"Status": "DELETING",
"StatusMessage": "Deleting the Profile to DNS Firewall rule group association"
}
}
```
+ Para obtener más información sobre la API, consulte [DisassociateResourceFromProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/disassociate-resource-from-profile.html)la *Referencia de AWS CLI comandos*.
### `get-profile-association`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-profile-association`.
**AWS CLI**
**Para obtener información sobre una asociación de perfiles**
En el siguiente ejemplo de `get-profile-association`, se devuelve información sobre la asociación de perfiles especificada.
```
aws route53profiles get-profile-association \
--profile-association-id rpassoc-489ce212fexample
```
Salida:
```
{
"ProfileAssociation": {
"CreationTime": 1709338817.148,
"Id": "rrpassoc-489ce212fexample",
"ModificationTime": 1709338974.772,
"Name": "test-association",
"OwnerId": "123456789012",
"ProfileId": "rp-4987774726example",
"ResourceId": "vpc-0af3b96b3example",
"Status": "COMPLETE",
"StatusMessage": "Created Profile Association"
}
}
```
+ Para obtener más información sobre la API, consulte [GetProfileAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/get-profile-association.html)la *Referencia de AWS CLI comandos*.
### `get-profile-resource-association`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-profile-resource-association`.
**AWS CLI**
**Para obtener información sobre un recurso asociado a un perfil**
En el siguiente ejemplo de `get-profile-resource-association`, se devuelve información sobre la asociación de recursos especificada a un perfil.
```
aws route53profiles get-profile-resource-association \
--profile-resource-association-id rpr-001913120a7example
```
Salida:
```
{
"ProfileResourceAssociation": {
"CreationTime": 1710851216.613,
"Id": "rpr-001913120a7example",
"ModificationTime": 1710852303.798,
"Name": "test-resource-association",
"OwnerId": "123456789012",
"ProfileId": "rp-4987774726example",
"ResourceArn": "arn:aws:route53resolver:us-east-1:123456789012:firewall-rule-group/rslvr-frg-cfe7f72example",
"ResourceProperties": "{\"priority\":105}",
"ResourceType": "FIREWALL_RULE_GROUP",
"Status": "COMPLETE",
"StatusMessage": "Completed creation of Profile to DNS Firewall rule group association"
}
}
```
+ Para obtener más información sobre la API, consulte [GetProfileResourceAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/get-profile-resource-association.html)la *Referencia de AWS CLI comandos*.
### `get-profile`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-profile`.
**AWS CLI**
**Para obtener información sobre un perfil**
En el siguiente ejemplo de `get-profile`, se devuelve información sobre el perfil especificado.
```
aws route53profiles get-profile \
--profile-id rp-4987774726example
```
Salida:
```
{
"Profile": {
"Arn": "arn:aws:route53profiles:us-east-1:123456789012:profile/rp-4987774726example",
"ClientToken": "0cbc5ae7-4921-4204-bea9-EXAMPLE11111",
"CreationTime": 1710851044.288,
"Id": "rp-4987774726example",
"ModificationTime": 1710851044.288,
"Name": "test",
"OwnerId": "123456789012",
"ShareStatus": "NOT_SHARED",
"Status": "COMPLETE",
"StatusMessage": "Created Profile"
}
}
```
+ Para obtener más información sobre la API, consulte [GetProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/get-profile.html)la *Referencia de AWS CLI comandos*.
### `list-profile-associations`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-profile-associations`.
**AWS CLI**
**Para enumerar las asociaciones de perfiles**
A continuación, se `list-profile-associations` enumeran las asociaciones de perfiles de su AWS cuenta.
```
aws route53profiles list-profile-associations
```
Salida:
```
{
"ProfileAssociations": [
{
"CreationTime": 1709338817.148,
"Id": "rpassoc-489ce212fexample",
"ModificationTime": 1709338974.772,
"Name": "test-association",
"OwnerId": "123456789012",
"ProfileId": "rp-4987774726example",
"ResourceId": "vpc-0af3b96b3example",
"Status": "COMPLETE",
"StatusMessage": "Created Profile Association"
}
]
}
```
+ Para obtener más información sobre la API, consulte [ListProfileAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/list-profile-associations.html)la *Referencia de AWS CLI comandos*.
### `list-profile-resource-associations`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-profile-resource-associations`.
**AWS CLI**
**Para enumerar las asociaciones de recursos de perfiles**
En el siguiente ejemplo de `list-profile-resource-associations`, se enumeran las asociaciones de recursos de perfiles para el perfil especificado.
```
aws route53profiles list-profile-resource-associations \
--profile-id rp-4987774726example
```
Salida:
```
{
"ProfileResourceAssociations": [
{
"CreationTime": 1710851216.613,
"Id": "rpr-001913120a7example",
"ModificationTime": 1710851216.613,
"Name": "test-resource-association",
"OwnerId": "123456789012",
"ProfileId": "rp-4987774726example",
"ResourceArn": "arn:aws:route53resolver:us-east-1:123456789012:firewall-rule-group/rslvr-frg-cfe7f72example",
"ResourceProperties": "{\"priority\":102}",
"ResourceType": "FIREWALL_RULE_GROUP",
"Status": "COMPLETE",
"StatusMessage": "Completed creation of Profile to DNS Firewall rule group association"
}
]
}
```
+ Para obtener más información sobre la API, consulte [ListProfileResourceAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/list-profile-resource-associations.html)la *Referencia de AWS CLI comandos*.
### `list-profiles`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-profiles`.
**AWS CLI**
**Para enumerar los perfiles**
A continuación, se `list-profiles` enumeran los perfiles de su AWS cuenta y se muestra información adicional sobre ellos.
```
aws route53profiles list-profiles
```
Salida:
```
{
"ProfileSummaries": [
{
"Arn": "arn:aws:route53profiles:us-east-1:123456789012:profile/rp-4987774726example",
"Id": "rp-4987774726example",
"Name": "test",
"ShareStatus": "NOT_SHARED"
}
]
}
```
+ Para obtener más información sobre la API, consulte [ListProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/list-profiles.html)la *Referencia de AWS CLI comandos*.
### `list-tags-for-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-tags-for-resource`.
**AWS CLI**
**Para enumerar las etiquetas de un recurso**
En el siguiente ejemplo de `list-tags-for-resource`, se enumeran las etiquetas para el recurso especificado.
```
aws route53profiles list-tags-for-resource \
--resource-arn arn:aws:route53profiles:us-east-1:123456789012:profile/rp-4987774726example
```
Salida:
```
{
"Tags": {
"my-key-2": "my-value-2",
"my-key-1": "my-value-1"
}
}
```
+ Para obtener más información sobre la API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/list-tags-for-resource.html)la *Referencia de AWS CLI comandos*.
### `update-profile-resource-association`
En el siguiente ejemplo de código, se muestra cómo utilizar `update-profile-resource-association`.
**AWS CLI**
**Para actualizar un recurso asociado a un perfil**
En el siguiente ejemplo de `update-profile-resource-association`, se actualiza una prioridad de un grupo de reglas de DNS Firewall asociado a un perfil.
```
aws route53profiles update-profile-resource-association \
--profile-resource-association-id rpr-001913120a7example \
--resource-properties "{\"priority\": 105}"
```
Salida:
```
{
"ProfileResourceAssociation": {
"CreationTime": 1710851216.613,
"Id": "rpr-001913120a7example",
"ModificationTime": 1710852303.798,
"Name": "test-resource-association",
"OwnerId": "123456789012",
"ProfileId": "rp-4987774726example",
"ResourceArn": "arn:aws:route53resolver:us-east-1:123456789012:firewall-rule-group/rslvr-frg-cfe7f72example",
"ResourceProperties": "{\"priority\":105}",
"ResourceType": "FIREWALL_RULE_GROUP",
"Status": "UPDATING",
"StatusMessage": "Updating the Profile to DNS Firewall rule group association"
}
}
```
+ Para obtener más información sobre la API, consulte [UpdateProfileResourceAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/update-profile-resource-association.html)la *Referencia de AWS CLI comandos*.