Ejemplos de perfiles de Route 53 que utilizan AWS CLI - AWS Command Line Interface
Acciones

Esta documentación es AWS CLI únicamente para la versión 1 de la versión. Para ver la documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.

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 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 usarloassociate-profile.

AWS CLI

Para asociar un perfil

En el siguiente associate-profile ejemplo se asocia un perfil a unVPC.

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 obtener más información, consulte Uso de perfiles en la Guía para desarrolladores de Amazon Route 53.

  • Para API obtener más información, consulte AssociateProfilela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usarloassociate-resource-to-profile.

AWS CLI

Para asociar un recurso a un perfil

El siguiente associate-resource-to-profile ejemplo 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"
    }
}

En el siguiente ejemplo de código se muestra cómo usarlocreate-profile.

AWS CLI

Para crear un perfil

En el siguiente create-profile ejemplo, 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 API obtener más información, consulte CreateProfilela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usarlodelete-profile.

AWS CLI

Para eliminar un perfil

En el siguiente delete-profile ejemplo, 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 API obtener más información, consulte DeleteProfilela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usarlodisassociate-profile.

AWS CLI

Para desasociar un perfil

El siguiente disassociate-profile ejemplo desasocia un perfil de un. 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 API obtener más información, consulte DisassociateProfilela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usarlodisassociate-resource-from-profile.

AWS CLI

Para desasociar un recurso de Profile

El siguiente disassociate-resource-from-profile ejemplo desasocia 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"
    }
}

En el siguiente ejemplo de código se muestra cómo usarloget-profile-association.

AWS CLI

Para obtener información sobre una asociación de perfiles

A continuación, se get-profile-association 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"
    }
}

En el siguiente ejemplo de código se muestra cómo usarloget-profile-resource-association.

AWS CLI

Para obtener información sobre un recurso asociado a un perfil

A continuación, se get-profile-resource-association 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"
    }
}

En el siguiente ejemplo de código se muestra cómo usarloget-profile.

AWS CLI

Para obtener información sobre un perfil

A continuación, se get-profile 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 API obtener más información, consulte GetProfilela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usarlolist-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"
        }
    ]
}

En el siguiente ejemplo de código se muestra cómo usarlolist-profile-resource-associations.

AWS CLI

Para enumerar las asociaciones de recursos de Profile

A continuación, se list-profile-resource-associations enumeran las asociaciones de recursos de perfil 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"
         }
     ]
 }

En el siguiente ejemplo de código se muestra cómo usarlolist-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 API obtener más información, consulte ListProfilesla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usarlolist-tags-for-resource.

AWS CLI

Para enumerar las etiquetas de un recurso

A continuación, se list-tags-for-resource enumeran las etiquetas del 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 API obtener más información, consulte ListTagsForResourcela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usarloupdate-profile-resource-association.

AWS CLI

Para actualizar un recurso asociado a un perfil

A continuación, se update-profile-resource-association actualiza la prioridad de un grupo de reglas de DNS firewall asociado al 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"
    }
}