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á. # Registrando um recurso como instância de AWS Cloud Map serviço Você pode registrar os recursos do seu aplicativo como instâncias em um AWS Cloud Map serviço. Por exemplo, suponha que você tenha criado um serviço chamado `users` para todos os recursos do aplicativo que gerenciam dados do usuário. Em seguida, você pode registrar uma tabela do DynamoDB usada para armazenar dados do usuário como uma instância nesse serviço. **nota** Os seguintes recursos não estão disponíveis no AWS Cloud Map console: Ao registrar uma instância de serviço usando o console, você não pode criar um registro de alias que roteia o tráfego para um balanceador de carga Elastic Load Balancing (ELB). Ao registrar uma instância, você deve incluir o atributo `AWS_ALIAS_DNS_NAME`. Para obter mais informações, consulte [RegisterInstance](https://docs.aws.amazon.com/cloud-map/latest/api/API_RegisterInstance.html) na *Referência de APIs do AWS Cloud Map *. Se você registrar uma instância usando um serviço que inclua uma verificação de integridade personalizada, não será possível especificar o status inicial da verificação de integridade personalizada. Por padrão, o status inicial de verificações de integridade personalizadas é **Healthy (Íntegra)**. Para que o status de integridade inicial seja **Unhealthy (Não íntegra)**, registre a instância de forma programática e inclua o atributo `AWS_INIT_HEALTH_STATUS`. Para obter mais informações, consulte [RegisterInstance](https://docs.aws.amazon.com/cloud-map/latest/api/API_RegisterInstance.html) na *Referência de APIs do AWS Cloud Map *. Para registrar uma instância em um serviço, siga estas etapas. ------ #### [ Console de gerenciamento da AWS ] 1. Faça login no Console de gerenciamento da AWS e abra o AWS Cloud Map console em [https://console.aws.amazon.com/cloudmap/](https://console.aws.amazon.com/cloudmap/). 1. No painel de navegação, escolha **Namespaces**. 1. Na página **Namespaces**, escolha o namespace que contém o serviço que você deseja usar como modelo para registrar uma instância do serviço. 1. Na {{namespace-name}} página **Namespace:**, escolha o serviço que você deseja usar. 1. Na {{service-name}} página **Serviço:**, escolha **Registrar instância do serviço**. 1. Na página **Registrar instância do serviço**, escolha um **tipo de instância**. Dependendo da configuração de descoberta da instância de namespace, você pode optar por especificar um endereço IP, um ID de instância do Amazon EC2 ou outras informações de identificação para um recurso que não tem um endereço IP. **nota** Você pode escolher a **instância EC2** somente em namespaces HTTP. 1. Para **ID da instância de serviço**, forneça um identificador associado à instância de serviço. **nota** Se você quiser atualizar uma instância existente, forneça o identificador associado à instância que você deseja atualizar. Em seguida, use as próximas etapas para atualizar os valores e registrar novamente a instância. 1. Com base no **tipo de instância** de sua escolha, execute as etapas a seguir. **Importante** Você não pode usar o `AWS_` prefixo (sem distinção entre maiúsculas e minúsculas) em uma chave ao especificar um atributo personalizado. [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/cloud-map/latest/dg/registering-instances.html) 1. Escolha **Registrar instância de serviço**. ------ #### [ AWS CLI ] + Quando você envia uma solicitação de `RegisterInstance`: + Para cada registro de DNS definido no serviço especificado por `ServiceId`, um registro é criado ou atualizado na zona hospedada associada ao namespace correspondente. + Caso o serviço inclua `HealthCheckConfig`, uma verificação de integridade será criada com base nas configurações da verificação de integridade. + Todas as verificações de integridade estão associadas a um dos registros novos ou atualizados. Registre uma instância de serviço com o `[register-instance](https://docs.aws.amazon.com/cli/latest/reference/servicediscovery/register-instance.html)` comando (substitua {{red}} os valores pelos seus). ``` aws servicediscovery register-instance \ --service-id {{srv-xxxxxxxxx}} \ --instance-id {{myservice-xx}} \ --attributes={{AWS_INSTANCE_IPV4=172.2.1.3,AWS_INSTANCE_PORT=808}} ``` ------ #### [ AWS SDK for Python (Boto3) ] 1. Caso ainda não tenha instalado `Boto3`, é possível encontrar instruções para instalação, configuração e uso do `Boto3` [aqui](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation). 1. Importe `Boto3` e use `servicediscovery` como seu serviço. ``` import boto3 client = boto3.client('servicediscovery') ``` 1. Quando você envia uma solicitação de `RegisterInstance`: + Para cada registro de DNS definido no serviço especificado por `ServiceId`, um registro é criado ou atualizado na zona hospedada associada ao namespace correspondente. + Caso o serviço inclua `HealthCheckConfig`, uma verificação de integridade será criada com base nas configurações da verificação de integridade. + Todas as verificações de integridade estão associadas a um dos registros novos ou atualizados. Registre uma instância de serviço com `register_instance()` (substitua {{red}} os valores pelos seus). ``` response = client.register_instance( Attributes={ 'AWS_INSTANCE_IPV4': '172.2.1.3', 'AWS_INSTANCE_PORT': '808', }, InstanceId='{{myservice-xx}}', ServiceId='{{srv-xxxxxxxxx}}', ) # If you want to see the response print(response) ``` Exemplo de objeto de resposta ``` { 'OperationId': '4yejorelbukcjzpnr6tlmrghsjwpngf4-k95yg2u7', 'ResponseMetadata': { '...': '...', }, } ``` ------