AWS Cloud Map ejemplos que utilizan AWS CLI - AWS Command Line Interface
Acciones

Esta documentación es AWS CLI únicamente para la versión 1 de la versión. Para ver la documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

AWS Cloud Map ejemplos que utilizan AWS CLI

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso del AWS Command Line Interface with AWS Cloud Map.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.

Cada ejemplo incluye un enlace al código fuente completo, donde puede encontrar instrucciones sobre cómo configurar y ejecutar el código en su contexto.

Acciones

En el siguiente ejemplo de código se muestra cómo usarlocreate-private-dns-namespace.

AWS CLI

Para crear un espacio de DNS nombres privado

En el siguiente create-private-dns-namespace ejemplo, se crea un espacio de nombres privadoDNS.

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

Salida:

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}

Para confirmar que la operación se realizó correctamente, puede ejecutar. get-operation Para obtener más información, consulte get-operation.

Para obtener más información, consulta Cómo crear espacios de nombres en la Guía para desarrolladores de AWS Cloud Map.

En el siguiente ejemplo de código se muestra cómo usarlocreate-service.

AWS CLI

Para crear un servicio

En el siguiente create-service ejemplo, se crea un servicio.

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

Salida:

{
        "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 obtener más información, consulte Creación de servicios en la Guía para desarrolladores de AWS Cloud Map.

  • Para API obtener más información, consulte CreateServicela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usarlodelete-namespace.

AWS CLI

Para eliminar un espacio de nombres

En el siguiente delete-namespace ejemplo, se elimina un espacio de nombres.

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

Salida:

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k98y6drk"
}

Para confirmar que la operación se realizó correctamente, puede ejecutar. get-operation Para obtener más información, consulte get-operation.

Para obtener más información, consulta Eliminar espacios de nombres en la Guía para desarrolladores de AWS Cloud Map.

  • Para API obtener más información, consulta la Referencia DeleteNamespacede AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usarlodelete-service.

AWS CLI

Eliminación de un servicio

En el siguiente delete-service ejemplo, se elimina un servicio.

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

Este comando no genera ninguna salida.

Para obtener más información, consulta Eliminar servicios en la Guía para desarrolladores de AWS Cloud Map.

  • Para API obtener más información, consulte DeleteServicela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usarloderegister-instance.

AWS CLI

Para anular el registro de una instancia de servicio

En el siguiente deregister-instance ejemplo se anula el registro de una instancia de servicio.

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

Salida:

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

Para confirmar que la operación se realizó correctamente, puede ejecutar. get-operation Para obtener más información, consulte get-operation.

Para obtener más información, consulta Cómo anular el registro de instancias de servicio en la Guía para desarrolladores de AWS Cloud Map.

  • Para API obtener más información, consulta la Referencia DeregisterInstancede AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usarlodiscover-instances.

AWS CLI

Para descubrir instancias registradas

En el siguiente discover-instances ejemplo, se descubren instancias registradas.

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

Salida:

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

  • Para API obtener más información, consulte DiscoverInstancesla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usarloget-operation.

AWS CLI

Para obtener el resultado de una operación

En el get-operation ejemplo siguiente se obtiene el resultado de una operación.

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

Salida:

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

  • Para API obtener más información, consulte GetOperationla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usarlolist-instances.

AWS CLI

Para enumerar las instancias de servicio

En el siguiente list-instances ejemplo, se enumeran las instancias de servicio.

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

Salida:

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

Para obtener más información, consulta Cómo ver una lista de instancias de servicio en la Guía para desarrolladores de AWS Cloud Map.

  • Para API obtener más información, consulte ListInstancesla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usarlolist-namespaces.

AWS CLI

Para enumerar los espacios de nombres

En el siguiente list-namespaces ejemplo, se enumeran los espacios de nombres.

aws servicediscovery list-namespaces

Salida:

{
    "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 obtener más información, consulta Cómo ver una lista de espacios de nombres en la Guía para desarrolladores de AWS Cloud Map.

  • Para API obtener más información, consulta la Referencia ListNamespacesde AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usarlolist-services.

AWS CLI

Para enumerar los servicios

En el siguiente list-services ejemplo, se enumeran los servicios.

aws servicediscovery list-services

Salida:

{
    "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 obtener más información, consulta Cómo ver una lista de servicios en la Guía para desarrolladores de AWS Cloud Map.

  • Para API obtener más información, consulte ListServicesla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usarloregister-instance.

AWS CLI

Para registrar una instancia de servicio

En el siguiente register-instance ejemplo, se registra una instancia de servicio.

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

Salida:

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

Para confirmar que la operación se realizó correctamente, puede ejecutarget-operation. Para obtener más información, consulte get-operation.

Para obtener más información, consulta Registrar instancias en la Guía para desarrolladores de AWS Cloud Map.

  • Para API obtener más información, consulte RegisterInstancela Referencia de AWS CLI comandos.