Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com 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.
Tópicos
Ações
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-idrp-4987774726example
\ --resource-idvpc-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 no Guia do desenvolvedor do Amazon Route 53.
-
Para ver detalhes da API, consulte AssociateProfile
na Referência de comandos da AWS CLI.
-
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-idrp-4987774726example
\ --resource-arnarn: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 ver detalhes da API, consulte AssociateResourceToProfile
na Referência de comandos da AWS CLI.
-
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 ver detalhes da API, consulte CreateProfile
na Referência de comandos da AWS CLI.
-
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 ver detalhes da API, consulte DeleteProfile
na Referência de comandos da AWS CLI.
-
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-idvpc-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 ver detalhes da API, consulte DisassociateProfile
na Referência de comandos da AWS CLI.
-
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-arnarn: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 ver detalhes da API, consulte DisassociateResourceFromProfile
na Referência de comandos da AWS CLI.
-
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 ver detalhes da API, consulte GetProfileAssociation
na Referência de comandos da AWS CLI.
-
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 ver detalhes da API, consulte GetProfileResourceAssociation
na Referência de comandos da AWS CLI.
-
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 ver detalhes da API, consulte GetProfile
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar list-profile-associations
.
- AWS CLI
-
Para listar associações de perfil
O
list-profile-associations
a seguir lista as associações de perfil em sua conta da AWS.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 ver detalhes da API, consulte ListProfileAssociations
na Referência de comandos da AWS CLI.
-
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 ver detalhes da API, consulte ListProfileResourceAssociations
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar list-profiles
.
- AWS CLI
-
Para listar perfis
O
list-profiles
a seguir lista os perfis em sua conta da AWS 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 ver detalhes da API, consulte ListProfiles
na Referência de comandos da AWS CLI.
-
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 sobre a API, consulte ListTagsForResource
na AWS CLI Command Reference.
-
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 ver detalhes da API, consulte UpdateProfileResourceAssociation
na Referência de comandos da AWS CLI.
-