AWS Cloud Map Ejemplos de que utilizan la AWS CLI

Creación de un espacio de nombres de HTTP

En el siguiente ejemplo de create-http-namespace se crea el espacio de nombres de HTTP example.com.

aws servicediscovery create-http-namespace \
    --name example.com \
    --creator-request-id example-request-id

Salida:

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}

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

Para obtener más información sobre la creación de un espacio de nombres, consulte Creación de un espacio de nombres de AWS Cloud Map para agrupar servicios de aplicación en la Guía para desarrolladores de AWS Cloud Map.

Para crear un espacio de nombres de DNS privado

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

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

Salida:

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}

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

Para obtener más información, consulte Creating namespaces en la Guía para desarrolladores de AWS Cloud Map.

Creación de un espacio de nombres DNS público

En el siguiente ejemplo de create-public-dns-namespace se crea el espacio de nombres de DNS público example.com.

aws servicediscovery create-public-dns-namespace \
    --name example-public-dns.com \
    --creator-request-id example-public-request-id \
    --properties DnsProperties={SOA={TTL=60}}

Salida:

{
    "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
}

Para confirmar que la operación se ha realizado correctamente, puede ejecutar get-operation.

Para obtener más información sobre la creación de un espacio de nombres, consulte Creación de un espacio de nombres de AWS Cloud Map para agrupar servicios de aplicación en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 1: Creación de un servicio con un ID de espacio de nombres

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

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

Salida:

{
    "Service": {
        "Id": "srv-abcd1234xmpl5678",
        "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
        "ResourceOwner": "123456789012",
        "Name": "myservice",
        "NamespaceId": "ns-abcd1234xmpl5678",
        "DnsConfig": {
            "NamespaceId": "ns-abcd1234xmpl5678",
            "RoutingPolicy": "MULTIVALUE",
            "DnsRecords": [
                {
                    "Type": "A",
                    "TTL": 60
                }
            ]
        },
        "Type": "DNS_HTTP",
        "CreateDate": "2025-08-18T13:45:31.023000-05:00",
        "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678",
        "CreatedByAccount": "123456789012"
    }
}

Para obtener más información, consulte Creación de un servicio de AWS Cloud Map para un componente de aplicación en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 2: Creación de un servicio con un ARN de espacio de nombres

En el ejemplo de create-service siguiente, se crea un servicio con un ARN de espacio de nombres en lugar de un ID de espacio de nombres. Es necesario especificar un ARN de espacio de nombres al crear un servicio en un espacio de nombres compartido.

aws servicediscovery create-service \
    --name myservice-arn \
    --namespace-id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678 \
    --dns-config "RoutingPolicy=MULTIVALUE,DnsRecords=[{Type=A,TTL=60}]"

Salida:

{
    "Service": {
        "Id": "srv-abcd1234xmpl5678",
        "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
        "ResourceOwner": "123456789012",
        "Name": "myservice-arn",
        "NamespaceId": "ns-abcd1234xmpl5678",
        "DnsConfig": {
            "NamespaceId": "ns-abcd1234xmpl5678",
            "RoutingPolicy": "MULTIVALUE",
            "DnsRecords": [
                {
                    "Type": "A",
                    "TTL": 60
                }
            ]
        },
        "Type": "DNS_HTTP",
        "CreateDate": "2025-08-18T13:45:31.023000-05:00",
        "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678",
        "CreatedByAccount": "123456789012"
    }
}

Para obtener más información, consulte Espacios de nombres de AWS Cloud Map compartidos en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 1: Eliminación de un espacio de nombres

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

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

Salida:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

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

Para obtener más información, consulte Eliminación de un espacio de nombres de AWS Cloud Map en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 2: Eliminación de un espacio de nombres mediante el ARN del espacio de nombres

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

aws servicediscovery delete-namespace \
    --id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678

Salida:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Para obtener más información, consulte Eliminación de un espacio de nombres de AWS Cloud Map en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 1: Eliminación de un atributo de servicio

En el siguiente ejemplo de delete-service-attributes, se elimina un atributo de servicio con la clave Port asociada al servicio especificado.

aws servicediscovery delete-service-attributes \
    --service-id srv-abcd1234xmpl5678 \
    --attributes Port

Este comando no genera ninguna salida.

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

Ejemplo 2: Eliminación de un atributo de servicio con ARN

En el ejemplo de delete-service-attributes siguiente, se elimina un atributo de servicio mediante el ARN del servicio. Es necesario especificar el ARN para eliminar los atributos asociados a los servicios creados en los espacios de nombres compartidos con la cuenta.

aws servicediscovery delete-service-attributes \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 \
    --attributes Port

Este comando no genera ninguna salida.

Para obtener más información, consulte Servicios de AWS Cloud Map y Espacios de nombres de AWS Cloud Map compartidos en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 1: Eliminación de un servicio

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

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

Este comando no genera ninguna salida.

Para obtener más información, consulte Eliminación de un servicio de AWS Cloud Map en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 2: Eliminación de un servicio con ARN

En el ejemplo de delete-service siguiente, se elimina un servicio con su ARN.

aws servicediscovery delete-service \
    --id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678

Este comando no genera ninguna salida.

Para obtener más información, consulte Eliminación de un servicio de AWS Cloud Map en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 1: Anulación del registro de una instancia de servicio

En el siguiente ejemplo de deregister-instance, 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 ha realizado correctamente, puede ejecutar get-operation. Para obtener más información, consulte get-operation.

Para obtener más información, consulte Deregistering service instances en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 2: Anulación del registro de una instancia de servicio mediante el ARN de servicio para espacios de nombres compartidos

En el ejemplo de deregister-instance siguiente, se anula el registro de una instancia de servicio mediante un ARN de servicio en lugar de un ID de servicio. Es necesario especificar un ARN al anular el registro de instancias de los servicios creados en los espacios de nombres que se comparten con la cuenta.

aws servicediscovery deregister-instance \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \
    --instance-id web-server-01

Salida:

{
    "OperationId": "gv4g5meo7ndmkqjrhpn39wk42xmpl"
}

Para obtener más información, consulte Espacios de nombres de AWS Cloud Map compartidos y Anulación del registro de una instancia de servicio de AWS Cloud Map en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 1: Detección de la revisión de una instancia

En el siguiente ejemplo de discover-instances-revision, se descubre la revisión creciente de una instancia.

aws servicediscovery discover-instances-revision \
    --namespace-name example.com \
    --service-name myservice

Salida:

{
    "InstancesRevision": 123456
}

Para obtener más información, consulte Instancias de servicio de AWS Cloud Map en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 2: Detección de la revisión de instancias de una cuenta de propietario específica

En el ejemplo de discover-instances-revision siguiente, se detecta la revisión de instancias de una cuenta de propietario específica. El parámetro owner-account es necesario para las instancias de los espacios de nombres que se comparten con la cuenta.

aws servicediscovery discover-instances-revision \
    --namespace-name shared-namespace \
    --service-name shared-service \
    --owner-account 123456789111

Salida:

{
    "InstancesRevision": 1234567890
}

Para obtener más información, consulte Espacios de nombre de AWS Cloud Map compartidos e Instancias de servicio de AWS Cloud Map en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 1: Detección de instancias registradas

En el siguiente ejemplo de discover-instances, 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"
            }
        }
    ],
    "InstancesRevision": 85648075627387284
}

Para obtener más información, consulte Instancias de servicio de AWS Cloud Map en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 2: Detección de instancias de una cuenta de propietario específica

En el ejemplo de discover-instances siguiente, se detectan instancias registradas de una cuenta de propietario específica. Este parámetro es necesario para detectar instancias en espacios de nombres que se comparten con la cuenta.

aws servicediscovery discover-instances \
    --namespace-name shared-namespace \
    --service-name shared-service \
    --owner-account 123456789111

Salida:

{
    "Instances": [
        {
            "InstanceId": "shared-instance-1234",
            "NamespaceName": "shared-namespace",
            "ServiceName": "shared-service",
            "HealthStatus": "HEALTHY",
            "Attributes": {
                "AWS_INSTANCE_IPV4": "203.0.113.75",
                "AWS_INSTANCE_PORT": "80"
            }
        }
    ],
    "InstancesRevision": 1234567890
}

Para obtener más información, consulte Espacios de nombre de AWS Cloud Map compartidos e Instancias de servicio de AWS Cloud Map en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 1: Obtención de los detalles de una instancia

En el siguiente ejemplo de get-instance, se obtienen los atributos de un servicio.

aws servicediscovery get-instance \
    --service-id srv-e4anhexample0004
    --instance-id i-abcd1234

Salida:

{
    "ResourceOwner": "123456789012",
    "Instance": {
        "Id": "arn:aws:servicediscovery:us-west-2:111122223333;:service/srv-e4anhexample0004",
        "Attributes": {
            "AWS_INSTANCE_IPV4": "192.0.2.44",
            "AWS_INSTANCE_PORT": "80",
            "color": "green",
            "region": "us-west-2",
            "stage": "beta"
        },
        "CreatedByAccount": "123456789012"
    }
}

Para obtener más información, consulte Instancias de servicio de AWS Cloud Map en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 2: Obtención de los detalles de una instancia mediante el ARN de servicio para espacios de nombres compartidos

En el ejemplo de get-instance siguiente, se obtienen los atributos de una instancia mediante un ARN de servicio en lugar de un ID de servicio. Es necesario especificar un ARN para obtener detalles de las instancias asociadas a los espacios de nombres que se comparten con la cuenta. La instancia devuelta en este ejemplo se registró por cuenta 123456789111 en un espacio de nombres propiedad de la cuenta 123456789012.

aws servicediscovery get-instance \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \
    --instance-id web-server-01

Salida:

{
    "ResourceOwner": "123456789012",
    "Instance": {
        "Id": "web-server-01",
        "Attributes": {
            "AWS_INSTANCE_IPV4": "203.0.113.15",
            "AWS_INSTANCE_PORT": "80"
        },
        "CreatedByAccount": "123456789111"
    }
}

Para obtener más información sobre los espacios de nombres entre cuentas compartidos, consulte Espacios de nombres de AWS Cloud Map compartidos en la Guía para desarrolladores de AWS.

Ejemplo 1: Obtención del estado de las instancias asociadas a un servicio

En el siguiente ejemplo de get-instances-health-status, se obtiene el estado de las instancias asociadas al servicio especificado.

aws servicediscovery get-instances-health-status \
    --service-id srv-e4anhexample0004

Salida:

{
    "Status": {
        "i-abcd1234": "HEALTHY",
        "i-abcd1235": "UNHEALTHY"
    }
}

Para obtener más información, consulte Instancias de servicio de AWS Cloud Map en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 2: Obtención de los detalles de las instancias mediante el ARN de servicio para espacios de nombres compartidos

En el ejemplo de get-instances-health-status siguiente, se obtiene el estado de las instancias mediante un ARN de servicio en lugar de un ID de servicio. Es necesario especificar un ARN para obtener el estado de las instancias asociadas a los espacios de nombres que se comparten con la cuenta del solicitante.

aws servicediscovery get-instances-health-status \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita

Salida:

{
    "Status": {
        "web-server-01": "HEALTHY",
        "web-server-02": "UNHEALTHY"
    }
}

Para obtener más información, consulte Instancias de servicios de AWS Cloud Map y Espacios de nombres de AWS Cloud Map compartidos en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 1: Obtención de los detalles de un espacio de nombres

En el siguiente ejemplo de get-namespace, se recupera información sobre el espacio de nombres especificado.

aws servicediscovery get-namespace \
    --id ns-abcd1234xmpl5678

Salida:

{
    "Namespace": {
        "Id": "ns-abcd1234xmpl5678",
        "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678",
        "ResourceOwner": "123456789012",
        "Name": "example-http.com",
        "Type": "HTTP",
        "Description": "Example.com AWS Cloud Map HTTP Namespace",
        "Properties": {
            "DnsProperties": {},
            "HttpProperties": {
                "HttpName": "example-http.com"
            }
        },
        "CreateDate": "2024-02-23T13:35:21.874000-06:00",
        "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678"
    }
}

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

Ejemplo 2: Obtención de los detalles de un espacio de nombres mediante el ARN

En el siguiente ejemplo de get-namespace, se recupera información sobre el espacio de nombres especificado mediante su ARN. Es necesario especificar el ARN para recuperar los detalles de un espacio de nombres compartido con la cuenta.

aws servicediscovery get-namespace \
    --id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678

Salida:

{
    "Namespace": {
        "Id": "ns-abcd1234xmpl5678",
        "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678",
        "ResourceOwner": "123456789012",
        "Name": "example-http.com",
        "Type": "HTTP",
        "Description": "Example.com AWS Cloud Map HTTP Namespace",
        "Properties": {
            "DnsProperties": {},
            "HttpProperties": {
                "HttpName": "example-http.com"
            }
        },
        "CreateDate": "2024-02-23T13:35:21.874000-06:00",
        "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678"
    }
}

Para obtener más información, consulte Espacios de nombres de AWS Cloud Map compartidos en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 1: Obtención del resultado de una operación

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

aws servicediscovery get-operation \
    --operation-id abcd1234xmpl5678abcd1234xmpl5678-abcd1234

Salida:

{
    "Operation": {
        "Id": "abcd1234xmpl5678abcd1234xmpl5678-abcd1234",
        "Type": "CREATE_NAMESPACE",
        "Status": "SUCCESS",
        "CreateDate": "2025-01-13T13:35:21.874000-06:00",
        "UpdateDate": "2025-01-13T13:36:02.469000-06:00",
        "Targets": {
            "NAMESPACE": "ns-abcd1234xmpl5678"
        }
    }
}

Para obtener más información, consulte Creación de un espacio de nombres de AWS Cloud Map para agrupar servicios de aplicación en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 2: Obtención de una operación de una cuenta de propietario específica

En el ejemplo de get-operation siguiente, se obtiene el resultado de una operación asociada a una cuenta de propietario de espacio de nombres específica. Este parámetro es necesario para obtener el resultado de las operaciones asociadas a los espacios de nombres compartidos con la cuenta.

aws servicediscovery get-operation \
    --operation-id abcd1234xmpl5678abcd1234xmpl5678-abcd1234 \
    --owner-account 123456789111

Salida:

{
    "Operation": {
        "Id": "abcd1234xmpl5678abcd1234xmpl5678-abcd1234",
        "OwnerAccount": "123456789111",
        "Type": "CREATE_NAMESPACE",
        "Status": "SUCCESS",
        "CreateDate": "2025-01-13T13:35:21.874000-06:00",
        "UpdateDate": "2025-01-13T13:36:02.469000-06:00",
        "Targets": {
            "NAMESPACE": "ns-abcd1234xmpl5678"
        }
    }
}

Para obtener más información, consulte Espacios de nombres de AWS Cloud Map compartidos en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 1: Obtención de los atributos de un servicio

En el siguiente ejemplo de get-service-attributes, se obtienen los atributos de un servicio.

aws servicediscovery get-service-attributes \
    --service-id srv-abcd1234xmpl5678

Salida:

{
    "ServiceAttributes": {
        "ServiceArn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
        "ResourceOwner": "123456789012",
        "Attributes": {
            "Port": "80"
        }
    }
}

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

Ejemplo 2: Obtención de los atributos de un servicio mediante el ARN

En el ejemplo de get-service-attributes siguiente, se obtienen los atributos de un servicio mediante su ARN. Es necesario especificar un ARN para obtener los atributos de un servicio creado en un espacio de nombres compartido con la cuenta.

aws servicediscovery get-service-attributes \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678

Salida:

{
    "ServiceAttributes": {
        "ServiceArn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
        "ResourceOwner": "123456789012",
        "Attributes": {
            "Port": "80"
        }
    }
}

Para obtener más información, consulte Servicios de AWS Cloud Map y Espacios de nombres de AWS Cloud Map compartidos en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 1: Obtención de la configuración de un servicio

En el siguiente ejemplo de get-service, se obtiene la configuración de un servicio especificado.

aws servicediscovery get-service \
    --id srv-abcd1234xmpl5678

Salida:

{
    "Service": {
        "Id": "srv-abcd1234xmpl5678",
        "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
        "ResourceOwner": "123456789012",
        "Name": "test-service",
        "NamespaceId": "ns-abcd1234xmpl5678",
        "DnsConfig": {},
        "Type": "HTTP",
        "CreateDate": "2025-08-18T13:53:02.775000-05:00",
        "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678",
        "CreatedByAccount": "123456789012"
    }
}

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

Ejemplo 2: Obtención de la configuración de un servicio mediante el ARN

En el ejemplo de get-service siguiente, se obtiene la configuración de un servicio especificado mediante su ARN. Es necesario especificar el ARN para recuperar información sobre un servicio creado en un espacio de nombres que se comparte con la cuenta. La cuenta 123456789111 de la persona que llama creó el servicio en un espacio de nombres compartido por la cuenta 123456789012.

aws servicediscovery get-service \
    --id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678

Salida:

{
    "Service": {
        "Id": "srv-abcd1234xmpl5678",
        "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678",
        "ResourceOwner": "123456789012",
        "Name": "test-service",
        "NamespaceId": "ns-abcd1234xmpl5678",
        "DnsConfig": {},
        "Type": "HTTP",
        "CreateDate": "2025-08-18T13:53:02.775000-05:00",
        "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678",
        "CreatedByAccount": "123456789111"
    }
}

Para obtener más información, consulte Creación de un servicio de AWS Cloud Map para un componente de aplicación en los Espacios de nombres de AWS Cloud Map compartidos en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 1: Muestra de las instancias de servicio

En el siguiente ejemplo de list-instances, se enumeran las instancias del 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"
            },
            "CreatedByAccount": "123456789012"
        }
    ],
    "ResourceOwner": "123456789012"
}

Para obtener más información, consulte Muestra de las instancias de servicio de AWS Cloud Map en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 2: Muestra de las instancias de servicio mediante el ARN del servicio

En el ejemplo de list-instances siguiente, se muestran las instancias de servicio mediante un ARN de servicio en lugar de un ID de servicio. Es necesario especificar un ARN al mostrar las instancias asociadas a los espacios de nombres que se comparten con la cuenta.

aws servicediscovery list-instances \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita

Salida:

{
    "ResourceOwner": "123456789012",
    "Instances": [
        {
            "Id": "web-server-01",
            "Attributes": {
                "AWS_INSTANCE_IPV4": "203.0.113.15",
                "AWS_INSTANCE_PORT": "80"
            },
            "CreatedByAccount": "123456789012"
        },
        {
            "Id": "web-server-02",
            "Attributes": {
                "AWS_INSTANCE_IPV4": "203.0.113.16",
                "AWS_INSTANCE_PORT": "80"
            },
            "CreatedByAccount": "123456789012"
        }
    ]
}

Para obtener más información sobre los espacios de nombres entre cuentas compartidos, consulte Espacios de nombres de AWS Cloud Map compartidos y Muestra de instancias de servicios de AWS Cloud Map en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 1: Muestra de los espacios de nombres

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

aws servicediscovery list-namespaces

Salida:

{
    "Namespaces": [
        {
            "Id": "ns-abcd1234xmpl5678",
            "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678",
            "ResourceOwner": "123456789012",
            "Name": "local",
            "Type": "DNS_PRIVATE",
            "Properties": {
                "DnsProperties": {
                    "HostedZoneId": "Z06752353VBUDTC32S84S",
                    "SOA": {}
                },
                "HttpProperties": {
                    "HttpName": "local"
                 }
            },
            "CreateDate": "2023-07-17T13:37:27.872000-05:00"
        },
        {
            "Id": "ns-abcd1234xmpl9012",
            "Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl9012",
            "ResourceOwner": "123456789012",
            "Name": "My-second-namespace",
            "Type": "HTTP",
            "Description": "My second namespace",
            "Properties": {
                "DnsProperties": {
                    "SOA": {}
                },
                "HttpProperties": {
                    "HttpName": "My-second-namespace"
                }
            },
            "CreateDate": "2023-11-14T10:35:47.840000-06:00"
        }
    ]
}

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

Ejemplo 2: Muestra de los espacios de nombres compartidos por otras cuentas

En el ejemplo de list-namespaces siguiente, se muestran los espacios de nombres que otras cuentas de AWS que utilizan el filtro RESOURCE_OWNER comparten con la cuenta de la persona que llama.

aws servicediscovery list-namespaces \
    --filters Name=RESOURCE_OWNER,Values=OTHER_ACCOUNTS,Condition=EQ

Salida:

{
    "Namespaces": [
        {
            "Id": "ns-abcd1234xmpl5678",
            "Arn": "arn:aws:servicediscovery:us-west-2:123456789111:namespace/ns-abcd1234xmpl5678",
            "ResourceOwner": "123456789111",
            "Name": "shared-namespace",
            "Type": "HTTP",
            "Description": "Namespace shared from another account",
            "Properties": {
                "DnsProperties": {
                    "SOA": {}
                },
                "HttpProperties": {
                    "HttpName": "shared-namespace"
                }
            },
            "CreateDate": "2025-01-13T13:35:21.874000-06:00"
        }
    ]
}

Para obtener más información, consulte Espacios de nombres de AWS Cloud Map compartidos en la Guía para desarrolladores de AWS Cloud Map.

Enumeración de las operaciones que cumplen los criterios especificados

En el siguiente ejemplo de list-operations, se enumeran las operaciones que tienen un estado de PENDING o SUCCESS.

aws servicediscovery list-operations \
    --service-id srv-e4anhexample0004 \
    --filters Name=STATUS,Condition=IN,Values=PENDING,SUCCESS

Salida:

{
    "Operations": [
        {
            "Id": "76yy8ovhpdz0plmjzbsnqgnrqvpv2qdt-kexample",
            "Status": "SUCCESS"
        },
        {
            "Id": "prysnyzpji3u2ciy45nke83x2zanl7yk-dexample",
            "Status": "SUCCESS"
        },
        {
            "Id": "ko4ekftir7kzlbechsh7xvcdgcpk66gh-7example",
            "Status": "PENDING"
        }
    ]
}

Para obtener más información, consulte ¿Qué es AWS Cloud Map? en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 1: Muestra de los servicios

En el siguiente ejemplo de list-services, 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, consulte Muestra de los servicios de AWS Cloud Map en un espacio de nombres en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 2: Muestra de los servicios creados en espacios de nombres compartidos

En el ejemplo de list-services siguiente, se muestran los servicios que se crean en espacios de nombres compartidos con la cuenta de la persona que llama 123456789012 de otras cuentas de AWS que utilizan el filtro RESOURCE_OWNER.

aws servicediscovery list-services \
    --filters Name=RESOURCE_OWNER,Values=OTHER_ACCOUNTS,Condition=EQ

Salida:

{
    "Services": [
        {
            "Id": "srv-abcd1234xmpl5678",
            "Arn": "arn:aws:servicediscovery:us-west-2:123456789111:service/srv-abcd1234xmpl5678",
            "ResourceOwner": "123456789111",
            "Name": "shared-service",
            "NamespaceId": "ns-abcd1234xmpl5678",
            "Type": "HTTP",
            "Description": "Service in shared namespace",
            "DnsConfig": {},
            "CreateDate": "2025-01-13T13:35:21.874000-06:00",
            "CreatorRequestId": "abcd1234-5678-90ab-cdef-xmpl12345678",
            "CreatedByAccount": "123456789012"
        }
    ]
}

Para obtener más información, consulte Espacios de nombres de AWS Cloud Map compartidos y Muestra de servicios de AWS Cloud Map en la Guía para desarrolladores de AWS Cloud Map.

Enumeración de las etiquetas asociadas al recurso especificado

En el siguiente ejemplo de list-tags-for-resource, se enumeran las etiquetas para el recurso especificado.

aws servicediscovery list-tags-for-resource \
    --resource-arn arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004

Salida:

{
    "Tags": [
        {
            "Key": "Project",
            "Value": "Zeta"
        },
        {
            "Key": "Department",
            "Value": "Engineering"
        }
    ]
}

Para obtener más información, consulte Etiquetado de los recursos de AWS Cloud Map en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 1: Registro de una instancia de servicio mediante el ID de servicio

En el siguiente ejemplo de register-instance, 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 ha realizado correctamente, puede ejecutar get-operation. Para obtener más información, consulte get-operation.

Para obtener más información sobre cómo registrar una instancia, consulte Registro de un recurso como una instancia del servicio de AWS Cloud Map en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 2: Registro de una instancia de servicio mediante el ARN de servicio

En el ejemplo de register-instance siguiente, se registra una instancia de servicio mediante un ARN de servicio. Es necesario especificar el ARN al registrar instancias de los servicios que se comparten con la cuenta.

aws servicediscovery register-instance \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \
    --instance-id web-server-01 \
    --attributes=AWS_INSTANCE_IPV4=203.0.113.15,AWS_INSTANCE_PORT=80

Salida:

{
    "OperationId": "gv4g5meo7ndmkqjrhpn39wk42xmpl"
}

Para obtener más información sobre los espacios de nombres entre cuentas compartidos, consulte Espacios de nombres de AWS Cloud Map compartidos en la Guía para desarrolladores de AWS.

Asociación de las etiquetas al recurso especificado

En el siguiente ejemplo de tag-resource se asocia una etiqueta Department al valor Engineering con el espacio de nombres especificado.

aws servicediscovery tag-resource \
    --resource-arn arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004 \
    --tags Key=Department, Value=Engineering

Este comando no genera ninguna salida.

Para obtener más información, consulte Etiquetado de los recursos de AWS Cloud Map en la Guía para desarrolladores de AWS Cloud Map.

Eliminación de etiquetas del recurso especificado

En el siguiente ejemplo de untag-resource, se elimina una etiqueta Department de un espacio de nombres especificado.

aws servicediscovery untag-resource \
    --resource-arn arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-e4anhexample0004 \
    --tags Key=Department, Value=Engineering

Este comando no genera ninguna salida.

Para obtener más información, consulte Etiquetado de los recursos de AWS Cloud Map en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 1: Actualización de un espacio de nombres de HTTP

En el siguiente ejemplo de update-http-namespace, se actualiza la descripción del espacio de nombres de HTTP especificado.

aws servicediscovery update-http-namespace \
    --id ns-abcd1234xmpl5678 \
    --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
    --namespace Description="The updated namespace description."

Salida:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

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

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

Ejemplo 2: Actualización de un espacio de nombres de HTTP mediante el ARN

En el ejemplo de update-http-namespace siguiente, se actualiza el espacio de nombres de HTTP especificado mediante su ARN.

aws servicediscovery update-http-namespace \
    --id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678 \
    --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
    --namespace Description="The updated namespace description."

Salida:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

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

Ejemplo 1: Actualización de una comprobación de estado personalizada

En el siguiente ejemplo de update-instance-custom-health-status se actualiza el estado de la comprobación de estado personalizada para el servicio especificado y la instancia de servicio de ejemplo a HEALTHY.

aws servicediscovery update-instance-custom-health-status \
    --service-id srv-e4anhexample0004 \
    --instance-id example \
    --status HEALTHY

Este comando no genera ninguna salida.

Para obtener más información, consulte Configuración de la comprobación de estado de los servicios de AWS Cloud Map en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 2: Actualización de una comprobación de estado personalizada mediante el ARN de servicio

En el ejemplo de update-instance-custom-health-status siguiente, se actualiza el estado de la comprobación de estado personalizada mediante un ARN de servicio. Es necesario el ARN al actualizar el estado para instancias asociadas a los espacios de nombres que se comparten con la cuenta.

aws servicediscovery update-instance-custom-health-status \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-p5zdwlg5uvvzjita \
    --instance-id web-server-01 \
    --status HEALTHY

Este comando no genera ninguna salida.

Para obtener más información, consulte Configuración de comprobación de estado de servicio de AWS Cloud Map y Uso compartido del espacio de nombres de AWS Cloud Map entre cuentas en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 1: Actualización de un espacio de nombres de DNS privado mediante un ID

En el ejemplo de update-private-dns-namespace siguiente, se actualiza la descripción de un espacio de nombres de DNS privado mediante el ID de un espacio de nombres.

aws servicediscovery update-private-dns-namespace \
    --id ns-abcd1234xmpl5678 \
    --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
    --namespace Description="The updated namespace description."

Salida:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Para confirmar que la operación se ha realizado correctamente, puede ejecutar get-operation.

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

Ejemplo 2: Actualización de un espacio de nombres de DNS privado mediante un ARN

En el ejemplo de update-private-dns-namespace siguiente, se actualiza un espacio de nombres de DNS privado mediante su ARN.

aws servicediscovery update-private-dns-namespace \
    --id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678 \
    --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
    --namespace Description="The updated namespace description."

Salida:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

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

Ejemplo 1: Actualización de un espacio de nombres de DNS público mediante un ID

En el ejemplo de update-public-dns-namespace siguiente, se actualiza la descripción de un espacio de nombres de DNS público mediante su ID.

aws servicediscovery update-public-dns-namespace \
    --id ns-abcd1234xmpl5678 \
    --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
    --namespace Description="The updated namespace description."

Salida:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Para confirmar que la operación se ha realizado correctamente, puede ejecutar get-operation.

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

Ejemplo 2: Actualización de un espacio de nombres de DNS público mediante el ARN

En el ejemplo de update-public-dns-namespace siguiente, se actualiza un espacio de nombres de DNS público mediante su ARN.

aws servicediscovery update-public-dns-namespace \
    --id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678 \
    --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
    --namespace Description="The updated namespace description."

Salida:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

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

Ejemplo 1: Actualización de un servicio para agregar un atributo

En el siguiente ejemplo de update-service-attributes, se actualiza el servicio especificado para agregar un atributo de servicio con una clave Port y un valor 80.

aws servicediscovery update-service-attributes \
    --service-id srv-abcd1234xmpl5678 \
    --attributes Port=80

Este comando no genera ninguna salida.

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

Ejemplo 2: Actualización de atributos de servicio con ARN

En el ejemplo de update-service-attributes siguiente, se actualiza un servicio mediante su ARN para agregar un atributo de servicio. Es necesario especificar el ARN para agregar atributos a servicios creados en los espacios de nombres compartidos con la cuenta.

aws servicediscovery update-service-attributes \
    --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 \
    --attributes Port=80

Este comando no genera ninguna salida.

Para obtener más información, consulte Servicios de AWS Cloud Map y Espacios de nombres de AWS Cloud Map compartidos en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 1: Actualización de un servicio

En el siguiente ejemplo de update-service, se actualiza un servicio para actualizar las opciones de configuración DnsConfig y HealthCheckConfig.

aws servicediscovery update-service \
    --id srv-abcd1234xmpl5678 \
    --service "DnsConfig={DnsRecords=[{Type=A,TTL=60}]},HealthCheckConfig={Type=HTTP,ResourcePath=/,FailureThreshold=2}"

Salida:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Para confirmar que la operación se ha realizado correctamente, puede ejecutar get-operation.

Para obtener más información sobre la actualización de un servicio, consulte Actualización de un servicio de AWS Cloud Map en la Guía para desarrolladores de AWS Cloud Map.

Ejemplo 2: Actualización de un servicio mediante el ARN

En el ejemplo de update-service siguiente, se actualiza un servicio mediante su ARN. Es necesario especificar el ARN para servicios creados en los espacios de nombres compartidos con la cuenta.

aws servicediscovery update-service \
    --id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 \
    --service "DnsConfig={DnsRecords=[{Type=A,TTL=60}]},HealthCheckConfig={Type=HTTP,ResourcePath=/,FailureThreshold=2}"

Salida:

{
    "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
}

Para obtener más información sobre la actualización de un servicio, consulte Actualización de un servicio de AWS Cloud Map y Espacios de nombres de AWS Cloud Map compartidos en la Guía para desarrolladores de AWS Cloud Map.