Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Exemplos de perfis do Route 53 usando AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando os AWS Command Line Interface perfis do Route 53.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `associate-profile`
O código de exemplo a seguir mostra como usar `associate-profile`.
**AWS CLI**
**Para associar um perfil**
O exemplo `associate-profile` a seguir associa um perfil a uma VPC.
```
aws route53profiles associate-profile \
--name test-association \
--profile-id rp-4987774726example \
--resource-id vpc-0af3b96b3example
```
Saída:
```
{
"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 obter mais informações, consulte [Usar perfis](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/profile-high-level-steps.html) no *Guia do desenvolvedor do Amazon Route 53*.
+ Para obter detalhes da API, consulte [AssociateProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/associate-profile.html)em *Referência de AWS CLI Comandos*.
### `associate-resource-to-profile`
O código de exemplo a seguir mostra como usar `associate-resource-to-profile`.
**AWS CLI**
**Para associar um recurso a um perfil**
O exemplo `associate-resource-to-profile` a seguir associa um grupo de regras de firewall DNS com a prioridade de 102 a um 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}"
```
Saída:
```
{
"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 obter detalhes da API, consulte [AssociateResourceToProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/associate-resource-to-profile.html)em *Referência de AWS CLI Comandos*.
### `create-profile`
O código de exemplo a seguir mostra como usar `create-profile`.
**AWS CLI**
**Para criar um perfil**
O exemplo `create-profile` a seguir cria um perfil.
```
aws route53profiles create-profile \
--name test
```
Saída:
```
{
"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 obter detalhes da API, consulte [CreateProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/create-profile.html)em *Referência de AWS CLI Comandos*.
### `delete-profile`
O código de exemplo a seguir mostra como usar `delete-profile`.
**AWS CLI**
**Para excluir um perfil**
O exemplo `delete-profile` a seguir exclui um perfil.
```
aws route53profiles delete-profile \
--profile-id rp-6ffe47d5example
```
Saída:
```
{
"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 obter detalhes da API, consulte [DeleteProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/delete-profile.html)em *Referência de AWS CLI Comandos*.
### `disassociate-profile`
O código de exemplo a seguir mostra como usar `disassociate-profile`.
**AWS CLI**
**Para desassociar um perfil**
O exemplo `disassociate-profile` a seguir desassocia um perfil de uma VPC.
```
aws route53profiles disassociate-profile \
--profile-id rp-4987774726example \
--resource-id vpc-0af3b96b3example
```
Saída:
```
{
"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 obter detalhes da API, consulte [DisassociateProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/disassociate-profile.html)em *Referência de AWS CLI Comandos*.
### `disassociate-resource-from-profile`
O código de exemplo a seguir mostra como usar `disassociate-resource-from-profile`.
**AWS CLI**
**Para desassociar um recurso do perfil**
O exemplo `disassociate-resource-from-profile` a seguir desassocia um grupo de regras do Firewall DNS de um 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
```
Saída:
```
{
"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 obter detalhes da API, consulte [DisassociateResourceFromProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/disassociate-resource-from-profile.html)em *Referência de AWS CLI Comandos*.
### `get-profile-association`
O código de exemplo a seguir mostra como usar `get-profile-association`.
**AWS CLI**
**Para obter informações sobre uma associação de perfil**
O `get-profile-association` a seguir retorna informações sobre a associação de perfil especificada.
```
aws route53profiles get-profile-association \
--profile-association-id rpassoc-489ce212fexample
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetProfileAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/get-profile-association.html)em *Referência de AWS CLI Comandos*.
### `get-profile-resource-association`
O código de exemplo a seguir mostra como usar `get-profile-resource-association`.
**AWS CLI**
**Para obter informações sobre um recurso associado a um perfil**
O `get-profile-resource-association` a seguir retorna informações sobre a associação de recursos especificada a um perfil.
```
aws route53profiles get-profile-resource-association \
--profile-resource-association-id rpr-001913120a7example
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetProfileResourceAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/get-profile-resource-association.html)em *Referência de AWS CLI Comandos*.
### `get-profile`
O código de exemplo a seguir mostra como usar `get-profile`.
**AWS CLI**
**Para obter informações sobre um perfil**
O `get-profile` a seguir retorna informações sobre o perfil especificado.
```
aws route53profiles get-profile \
--profile-id rp-4987774726example
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetProfile](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/get-profile.html)em *Referência de AWS CLI Comandos*.
### `list-profile-associations`
O código de exemplo a seguir mostra como usar `list-profile-associations`.
**AWS CLI**
**Para listar associações de perfil**
A seguir estão `list-profile-associations` listadas as associações de perfil em sua AWS conta.
```
aws route53profiles list-profile-associations
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListProfileAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/list-profile-associations.html)em *Referência de AWS CLI Comandos*.
### `list-profile-resource-associations`
O código de exemplo a seguir mostra como usar `list-profile-resource-associations`.
**AWS CLI**
**Para listar associações de recursos de perfil**
O `list-profile-resource-associations` a seguir lista as associações de recursos de perfil para o perfil especificado.
```
aws route53profiles list-profile-resource-associations \
--profile-id rp-4987774726example
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListProfileResourceAssociations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/list-profile-resource-associations.html)em *Referência de AWS CLI Comandos*.
### `list-profiles`
O código de exemplo a seguir mostra como usar `list-profiles`.
**AWS CLI**
**Para listar perfis**
O seguinte `list-profiles` lista os Perfis em sua AWS conta e exibe informações adicionais sobre eles.
```
aws route53profiles list-profiles
```
Saída:
```
{
"ProfileSummaries": [
{
"Arn": "arn:aws:route53profiles:us-east-1:123456789012:profile/rp-4987774726example",
"Id": "rp-4987774726example",
"Name": "test",
"ShareStatus": "NOT_SHARED"
}
]
}
```
+ Para obter detalhes da API, consulte [ListProfiles](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/list-profiles.html)em *Referência de AWS CLI Comandos*.
### `list-tags-for-resource`
O código de exemplo a seguir mostra como usar `list-tags-for-resource`.
**AWS CLI**
**Para listar as tags para um recurso**
O `list-tags-for-resource` a seguir lista tags para o recurso especificado.
```
aws route53profiles list-tags-for-resource \
--resource-arn arn:aws:route53profiles:us-east-1:123456789012:profile/rp-4987774726example
```
Saída:
```
{
"Tags": {
"my-key-2": "my-value-2",
"my-key-1": "my-value-1"
}
}
```
+ Para obter detalhes da API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/list-tags-for-resource.html)em *Referência de AWS CLI Comandos*.
### `update-profile-resource-association`
O código de exemplo a seguir mostra como usar `update-profile-resource-association`.
**AWS CLI**
**Para atualizar um recurso associado a um perfil**
O `update-profile-resource-association` a seguir atualiza a prioridade de um grupo de regras do Firewall DNS associado ao perfil.
```
aws route53profiles update-profile-resource-association \
--profile-resource-association-id rpr-001913120a7example \
--resource-properties "{\"priority\": 105}"
```
Saída:
```
{
"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 obter detalhes da API, consulte [UpdateProfileResourceAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/route53profiles/update-profile-resource-association.html)em *Referência de AWS CLI Comandos*.