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.
**Topics**
+ [Actions](#actions)
## Actions
### `associate-profile`
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 [Utilisations de profils](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/profile-high-level-steps.html) dans le *Manuel du développeur Amazon Route 53*.
+ Pour plus de détails sur l'API, reportez-vous [AssociateProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/associate-profile.html)à la section *Référence des AWS CLI commandes*.
### `associate-resource-to-profile`
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"
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [AssociateResourceToProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/associate-resource-to-profile.html)à la section *Référence des AWS CLI commandes*.
### `create-profile`
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, reportez-vous [CreateProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/create-profile.html)à la section *Référence des AWS CLI commandes*.
### `delete-profile`
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, reportez-vous [DeleteProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/delete-profile.html)à la section *Référence des AWS CLI commandes*.
### `disassociate-profile`
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, reportez-vous [DisassociateProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/disassociate-profile.html)à la section *Référence des AWS CLI commandes*.
### `disassociate-resource-from-profile`
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"
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [DisassociateResourceFromProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/disassociate-resource-from-profile.html)à la section *Référence des AWS CLI commandes*.
### `get-profile-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, reportez-vous [GetProfileAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/get-profile-association.html)à la section *Référence des AWS CLI commandes*.
### `get-profile-resource-association`
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"
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [GetProfileResourceAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/get-profile-resource-association.html)à la section *Référence des AWS CLI commandes*.
### `get-profile`
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, reportez-vous [GetProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/get-profile.html)à la section *Référence des AWS CLI commandes*.
### `list-profile-associations`
L'exemple de code suivant montre comment utiliser`list-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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/list-profile-associations.html)à la section *Référence des AWS CLI commandes*.
### `list-profile-resource-associations`
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**
`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"
}
]
}
```
+ Pour plus de détails sur l'API, reportez-vous [ListProfileResourceAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/list-profile-resource-associations.html)à la section *Référence des AWS CLI commandes*.
### `list-profiles`
L'exemple de code suivant montre comment utiliser`list-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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/list-profiles.html)à la section *Référence des AWS CLI commandes*.
### `list-tags-for-resource`
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, reportez-vous [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/list-tags-for-resource.html)à la section *Référence des AWS CLI commandes*.
### `update-profile-resource-association`
L'exemple de code suivant montre comment utiliser`update-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"
}
}
```
+ Pour plus de détails sur l'API, reportez-vous [UpdateProfileResourceAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/update-profile-resource-association.html)à la section *Référence des AWS CLI commandes*.