AWS Cloud Map exemplos usando AWS CLI - AWS Exemplos de código do SDK
Ações

Há mais exemplos de AWS SDK disponíveis no repositório 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á.

AWS Cloud Map exemplos usando AWS CLI

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface with 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 CreateServiceem Referência de AWS CLI Comandos.

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

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 DeleteServiceem Referência de AWS CLI Comandos.

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

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

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

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

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

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 ListServicesem Referência de AWS CLI Comandos.

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