Exemplos de perfis do Route 53 usando AWS CLI - AWS Command Line Interface
Ações

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 funções 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, onde você pode encontrar instruções sobre como configurar e executar o código no contexto.

Tópicos

Ações

O código de exemplo a seguir mostra como usar associate-profile.

AWS CLI

Para associar um perfil

O associate-profile exemplo a seguir associa um Perfil a umVPC.

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 Como usar perfis no Guia do desenvolvedor do Amazon Route 53.

  • Para API obter detalhes, consulte AssociateProfilena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar associate-resource-to-profile.

AWS CLI

Para associar um recurso a um perfil

O associate-resource-to-profile exemplo a seguir associa um grupo de regras de DNS firewall 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"
    }
}

O código de exemplo a seguir mostra como usar create-profile.

AWS CLI

Para criar um perfil

O create-profile exemplo 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 API obter detalhes, consulte CreateProfilena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-profile.

AWS CLI

Para excluir um perfil

O delete-profile exemplo 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 API obter detalhes, consulte DeleteProfilena Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar disassociate-profile.

AWS CLI

Para desassociar um perfil

O disassociate-profile exemplo a seguir desassocia um perfil de um. 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"
    }
}

O código de exemplo a seguir mostra como usar disassociate-resource-from-profile.

AWS CLI

Para desassociar um recurso do Perfil

O disassociate-resource-from-profile exemplo a seguir desassocia um grupo de regras de DNS firewall 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"
    }
}

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 seguinte get-profile-association 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"
    }
}

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 seguinte get-profile-resource-association 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"
    }
}

O código de exemplo a seguir mostra como usar get-profile.

AWS CLI

Para obter informações sobre um perfil

O seguinte get-profile 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 API obter detalhes, consulte GetProfilena Referência de AWS CLI Comandos.

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

O código de exemplo a seguir mostra como usar list-profile-resource-associations.

AWS CLI

Para listar associações de recursos de perfil

A seguir estão list-profile-resource-associations listadas as associações de recursos do 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"
         }
     ]
 }

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 API obter detalhes, consulte ListProfilesna Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-tags-for-resource.

AWS CLI

Para listar tags para um recurso

A seguir, list-tags-for-resource listamos as tags do 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"
    }
}

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 seguinte update-profile-resource-association atualiza a prioridade de um grupo de regras de DNS Firewall 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"
    }
}