Exemples de profils Route 53 utilisant AWS CLI - AWS Command Line Interface
Actions

Cette documentation concerne AWS CLI uniquement la version 1. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Exemples de profils Route 53 utilisant AWS CLI

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l' AWS Command Line Interface aide des profils Route 53.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

L'exemple de code suivant montre comment utiliserassociate-profile.

AWS CLI

Pour associer un profil

L’exemple associate-profile suivant associe un profil à un VPC.

aws route53profiles associate-profile \
    --name test-association \
    --profile-id rp-4987774726example \
    --resource-id vpc-0af3b96b3example

Sortie :

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

Pour plus d’informations, consultez Utilisations de profils dans le Manuel du développeur Amazon Route 53.

  • Pour plus de détails sur l'API, reportez-vous AssociateProfileà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserassociate-resource-to-profile.

AWS CLI

Pour associer une ressource à un profil

L’exemple associate-resource-to-profile suivant associe un groupe de règles de pare-feu DNS avec la priorité 102 à un profil.

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

Sortie :

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

L'exemple de code suivant montre comment utilisercreate-profile.

AWS CLI

Pour créer un profil

L’exemple create-profile suivant crée un profil.

aws route53profiles create-profile \
    --name test

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous CreateProfileà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdelete-profile.

AWS CLI

Pour supprimer un profil

L’exemple delete-profile suivant supprime un profil.

aws route53profiles delete-profile \
    --profile-id rp-6ffe47d5example

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous DeleteProfileà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdisassociate-profile.

AWS CLI

Pour dissocier un profil

L’exemple disassociate-profile suivant dissocie un profil d’un VPC.

aws route53profiles disassociate-profile \
    --profile-id rp-4987774726example \
    --resource-id vpc-0af3b96b3example

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous DisassociateProfileà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserdisassociate-resource-from-profile.

AWS CLI

Pour dissocier une ressource d’un profil

L’exemple disassociate-resource-from-profile suivant dissocie un groupe de règles de pare-feu DNS d’un profil.

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

Sortie :

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

L'exemple de code suivant montre comment utiliserget-profile-association.

AWS CLI

Pour obtenir les informations sur une association de profil

L’exemple get-profile-association suivant renvoie les informations sur l’association de profil spécifiée.

aws route53profiles get-profile-association \
    --profile-association-id rpassoc-489ce212fexample

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous GetProfileAssociationà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserget-profile-resource-association.

AWS CLI

Pour obtenir les informations sur une ressource associée à un profil

L’exemple get-profile-resource-association suivant renvoie les informations sur l’association d’une ressource spécifiée à un profil.

aws route53profiles get-profile-resource-association \
    --profile-resource-association-id rpr-001913120a7example

Sortie :

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

L'exemple de code suivant montre comment utiliserget-profile.

AWS CLI

Pour obtenir les informations sur un profil

L’exemple get-profile suivant renvoie les informations sur le profil spécifié.

aws route53profiles get-profile \
    --profile-id rp-4987774726example

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous GetProfileà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-profile-associations.

AWS CLI

Pour créer une liste des associations de profils

Vous trouverez ci-dessous la list-profile-associations liste des associations de profils associées à votre AWS compte.

aws route53profiles list-profile-associations

Sortie :

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

  • Pour plus de détails sur l'API, reportez-vous ListProfileAssociationsà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-profile-resource-associations.

AWS CLI

Pour créer une liste des associations de ressources du profil

list-profile-resource-associations ci-dessous suivant crée une liste des associations de ressources du profil spécifié.

aws route53profiles list-profile-resource-associations \
    --profile-id rp-4987774726example

Sortie :

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

L'exemple de code suivant montre comment utiliserlist-profiles.

AWS CLI

Pour créer une liste des profils

Vous trouverez ci-dessous la list-profiles liste des profils de votre AWS compte et des informations supplémentaires à leur sujet.

aws route53profiles list-profiles

Sortie :

{
     "ProfileSummaries": [
         {
             "Arn": "arn:aws:route53profiles:us-east-1:123456789012:profile/rp-4987774726example",
             "Id": "rp-4987774726example",
             "Name": "test",
             "ShareStatus": "NOT_SHARED"
         }
     ]
 }

  • Pour plus de détails sur l'API, reportez-vous ListProfilesà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserlist-tags-for-resource.

AWS CLI

Pour répertorier les balises d’une ressource

L’exemple list-tags-for-resource suivant crée une liste des balises de la ressource spécifiée.

aws route53profiles list-tags-for-resource \
    --resource-arn arn:aws:route53profiles:us-east-1:123456789012:profile/rp-4987774726example

Sortie :

{
    "Tags": {
        "my-key-2": "my-value-2",
        "my-key-1": "my-value-1"
    }
}

  • Pour plus de détails sur l'API, reportez-vous ListTagsForResourceà la section Référence des AWS CLI commandes.

L'exemple de code suivant montre comment utiliserupdate-profile-resource-association.

AWS CLI

Pour mettre à jour une ressource associée à un profil

update-profile-resource-association ci-dessous met à jour la priorité d’un groupe de règles de pare-feu DNS associé au profil.

aws route53profiles update-profile-resource-association \
    --profile-resource-association-id rpr-001913120a7example \
    --resource-properties "{\"priority\": 105}"

Sortie :

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