Exemples d’utilisation de l’AWS CLI avec les profils Route 53 - AWS Command Line Interface
Actions

Exemples d’utilisation de l’AWS CLI avec les profils Route 53

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec les 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 utiliser associate-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 Utilisation de profils dans le Manuel du développeur Amazon Route 53.

  • Pour plus de détails sur l’API, consultez AssociateProfile dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser associate-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 utiliser create-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, consultez CreateProfile dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-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, consultez DeleteProfile dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser disassociate-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, consultez DisassociateProfile dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser disassociate-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 utiliser get-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, consultez GetProfileAssociation dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-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 utiliser get-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, consultez GetProfile dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-profile-associations.

AWS CLI

Pour créer une liste des associations de profils

L’exemple list-profile-associations suivant crée une liste des associations de profils de votre compte AWS.

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, consultez ListProfileAssociations dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-profile-resource-associations.

AWS CLI

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

L’exemple list-profile-resource-associations 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 utiliser list-profiles.

AWS CLI

Pour créer une liste des profils

L’exemple list-profiles suivant crée une liste des profils de votre compte AWS et affiche les 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, consultez ListProfiles dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-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, consultez ListTagsForResource dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-profile-resource-association.

AWS CLI

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

L’exemple update-profile-resource-association suivant 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"
    }
}