Exemplos do AWS Cloud Map usando oAWS CLI - AWS Command Line Interface
Ações

Esta documentação é somente para a versão 1 da AWS CLI. Para obter a documentação relacionada à AWS CLI versão 2, consulte o Guia do usuário da versão 2.

Exemplos do AWS Cloud Map usando oAWS CLI

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o AWS Cloud Map.

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 create-private-dns-namespace.

AWS CLI

Para criar um namespace de DNS privado

O exemplo create-private-dns-namespace a seguir cria um namespace DNS privado.

aws servicediscovery create-private-dns-namespace \
    --name example.com \
    --vpc vpc-1c56417b

Saída:

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}

Para confirmar que a operação foi bem-sucedida, você pode executarget-operation. Para obter mais informações, consulte get-operation.

Para obter mais informações, consulte Criar namespaces no Guia do desenvolvedor do AWS Cloud Map.

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

AWS CLI

Para criar um serviço

O exemplo create-service a seguir cria um serviço.

aws servicediscovery create-service \
    --name myservice \
    --namespace-id  ns-ylexjili4cdxy3xm \
    --dns-config "NamespaceId=ns-ylexjili4cdxy3xm,RoutingPolicy=MULTIVALUE,DnsRecords=[{Type=A,TTL=60}]"

Saída:

{
        "Service": {
        "Id": "srv-p5zdwlg5uvvzjita",
        "Arn": "arn:aws:servicediscovery:us-west-2:803642222207:service/srv-p5zdwlg5uvvzjita",
        "Name": "myservice",
        "NamespaceId": "ns-ylexjili4cdxy3xm",
        "DnsConfig": {
            "NamespaceId": "ns-ylexjili4cdxy3xm",
            "RoutingPolicy": "MULTIVALUE",
            "DnsRecords": [
                {
                    "Type": "A",
                    "TTL": 60
                }
            ]
        },
        "CreateDate": 1587081768.334,
        "CreatorRequestId": "567c1193-6b00-4308-bd57-ad38a8822d25"
    }
}

Para obter mais informações, consulte Criar serviços no Guia do desenvolvedor do AWS Cloud Map.

  • Para obter detalhes da API, consulte CreateService na Referência de comandos da AWS CLI.

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

AWS CLI

Para excluir um namespace

O exemplo delete-namespace a seguir exclui um namespace.

aws servicediscovery delete-namespace \
    --id ns-ylexjili4cdxy3xm

Saída:

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k98y6drk"
}

Para confirmar que a operação foi bem-sucedida, você pode executarget-operation. Para obter mais informações, consulte get-operation.

Para obter mais informações, consulte Excluir namespaces no Guia do desenvolvedor do AWS Cloud Map.

  • Para ver detalhes da API, consulte DeleteNamespace na Referência de comandos da AWS CLI.

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

AWS CLI

Como excluir um serviço

O exemplo delete-service a seguir exclui um serviço.

aws servicediscovery delete-service \
    --id srv-p5zdwlg5uvvzjita

Este comando não produz saída.

Para obter mais informações, consulte Excluir serviços no Guia do desenvolvedor do AWS Cloud Map.

  • Para obter detalhes da API, consulte DeleteService na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar deregister-instance.

AWS CLI

Como cancelar o registro de uma instância de serviço

O exemplo deregister-instance a seguir cancela o registro de uma instância de serviço.

aws servicediscovery deregister-instance \
    --service-id srv-p5zdwlg5uvvzjita \
    --instance-id myservice-53

Saída:

{
    "OperationId": "4yejorelbukcjzpnr6tlmrghsjwpngf4-k98rnaiq"
}

Para confirmar que a operação foi bem-sucedida, você pode executarget-operation. Para obter mais informações, consulte get-operation.

Para obter mais informações, consulte Cancelar o registro de instâncias de serviço no Guia do desenvolvedor do AWS Cloud Map.

  • Para ver detalhes da API, consulte DeregisterInstance na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar discover-instances.

AWS CLI

Como descobrir instâncias registradas

O exemplo discover-instances a seguir descobre instâncias registradas.

aws servicediscovery discover-instances \
    --namespace-name example.com \
    --service-name myservice \
    --max-results 10 \
    --health-status ALL

Saída:

{
    "Instances": [
        {
            "InstanceId": "myservice-53",
            "NamespaceName": "example.com",
            "ServiceName": "myservice",
            "HealthStatus": "UNKNOWN",
            "Attributes": {
                "AWS_INSTANCE_IPV4": "172.2.1.3",
                "AWS_INSTANCE_PORT": "808"
            }
        }
    ]
}

  • Para ver detalhes da API, consulte DiscoverInstances na Referência de comandos da AWS CLI.

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

AWS CLI

Para obter o resultado de uma operação

O exemplo get-operation a seguir obtém o resultado de uma operação.

aws servicediscovery get-operation \
    --operation-id gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd

Saída:

{
    "Operation": {
        "Id": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd",
        "Type": "CREATE_NAMESPACE",
        "Status": "SUCCESS",
        "CreateDate": 1587055860.121,
        "UpdateDate": 1587055900.469,
        "Targets": {
            "NAMESPACE": "ns-ylexjili4cdxy3xm"
        }
    }
}

  • Para ver detalhes da API, consulte GetOperation na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar list-instances.

AWS CLI

Para listar instâncias de serviço

O exemplo list-instances a seguir lista as instâncias do serviço.

aws servicediscovery list-instances \
    --service-id srv-qzpwvt2tfqcegapy

Saída:

{
    "Instances": [
        {
            "Id": "i-06bdabbae60f65a4e",
            "Attributes": {
                "AWS_INSTANCE_IPV4": "172.2.1.3",
                "AWS_INSTANCE_PORT": "808"
            }
        }
    ]
}

Para obter mais informações, consulte Visualizar uma lista de instâncias de serviço no Guia do desenvolvedor do AWS Cloud Map.

  • Para ver detalhes da API, consulte ListInstances na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar list-namespaces.

AWS CLI

Para listar namespaces

O exemplo list-namespaces a seguir lista os namespaces.

aws servicediscovery list-namespaces

Saída:

{
    "Namespaces": [
        {
            "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-a3ccy2e7e3a7rile",
            "CreateDate": 1585354387.357,
            "Id": "ns-a3ccy2e7e3a7rile",
            "Name": "local",
            "Properties": {
                "DnsProperties": {
                    "HostedZoneId": "Z06752353VBUDTC32S84S"
                },
                "HttpProperties": {
                    "HttpName": "local"
                 }
            },
            "Type": "DNS_PRIVATE"
        },
        {
            "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-pocfyjtrsmwtvcxx",
            "CreateDate": 1586468974.698,
            "Description": "My second namespace",
            "Id": "ns-pocfyjtrsmwtvcxx",
            "Name": "My-second-namespace",
            "Properties": {
                "DnsProperties": {},
                "HttpProperties": {
                    "HttpName": "My-second-namespace"
                }
            },
            "Type": "HTTP"
        },
        {
            "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-ylexjili4cdxy3xm",
            "CreateDate": 1587055896.798,
            "Id": "ns-ylexjili4cdxy3xm",
            "Name": "example.com",
            "Properties": {
                "DnsProperties": {
                    "HostedZoneId": "Z09983722P0QME1B3KC8I"
                },
                 "HttpProperties": {
                     "HttpName": "example.com"
                }
            },
            "Type": "DNS_PRIVATE"
        }
    ]
}

Para obter mais informações, consulte Visualizar uma lista de namespaces no Guia do desenvolvedor do AWS Cloud Map.

  • Para ver detalhes da API, consulte ListNamespaces na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar list-services.

AWS CLI

Para listar serviços

O exemplo list-services a seguir lista os serviços.

aws servicediscovery list-services

Saída:

{
    "Services": [
        {
            "Id": "srv-p5zdwlg5uvvzjita",
            "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita",
            "Name": "myservice",
            "DnsConfig": {
                "RoutingPolicy": "MULTIVALUE",
                "DnsRecords": [
                    {
                        "Type": "A",
                        "TTL": 60
                    }
                ]
            },
            "CreateDate": 1587081768.334
        }
    ]
}

Para obter mais informações, consulte Visualizar uma lista de serviços no Guia do desenvolvedor do AWS Cloud Map.

  • Para obter detalhes da API, consulte ListServices na Referência de comandos da AWS CLI.

O código de exemplo a seguir mostra como usar register-instance.

AWS CLI

Para registrar uma instância de serviço

O exemplo register-instance a seguir registra uma instância de serviço.

aws servicediscovery register-instance \
    --service-id srv-p5zdwlg5uvvzjita \
    --instance-id myservice-53 \
    --attributes=AWS_INSTANCE_IPV4=172.2.1.3,AWS_INSTANCE_PORT=808

Saída:

{
    "OperationId": "4yejorelbukcjzpnr6tlmrghsjwpngf4-k95yg2u7"
}

Para confirmar que a operação foi bem-sucedida, você pode executarget-operation. Para obter mais informações, consulte get-operation.

Para obter mais informações, consulte Registrar instâncias no Guia do desenvolvedor do AWS Cloud Map.

  • Para ver detalhes da API, consulte RegisterInstance na Referência de comandos da AWS CLI.