View a markdown version of this page

CloudWatch Ejemplos de Observability Access Monitor que utilizan AWS CLI - AWS Ejemplos de código de SDK
Acciones

Hay más ejemplos de AWS SDK disponibles en el repositorio de ejemplos de AWS Doc SDK. GitHub

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.

CloudWatch Ejemplos de Observability Access Monitor que utilizan AWS CLI

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes AWS Command Line Interface con CloudWatch Observability Access Monitor.

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 distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar create-link.

AWS CLI

Para crear un enlace

En el siguiente ejemplo de create-link, se crea un enlace entre una cuenta de origen y un receptor que ha creado en una cuenta de supervisión.

aws oam create-link \
    --label-template sourceAccount \
    --resource-types AWS::CloudWatch::Metric \
    --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Salida:

{
    "Arn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111",
    "Id": "a1b2c3d4-5678-90ab-cdef-example11111",
    "Label": "sourceAccount",
    "LabelTemplate": "sourceAccount",
    "ResourceTypes": [
        "AWS::CloudWatch::Metric"
    ],
    "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "Tags": {}
}

Para obtener más información, consulte la observabilidad CloudWatch entre cuentas en la Guía del usuario de Amazon. CloudWatch

  • Para obtener más información sobre la API, consulte la sección de CreateLink referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar create-sink.

AWS CLI

Creación de un receptor

El siguiente create-sink ejemplo crea un sumidero en la cuenta actual, de modo que pueda usarse como cuenta de monitoreo en la observabilidad CloudWatch entre cuentas.

aws oam create-sink \
    --name DemoSink

Salida:

{
    "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "Id": "a1b2c3d4-5678-90ab-cdef-example12345",
    "Name": "DemoSink",
    "Tags": {}
}

Para obtener más información, consulte la observabilidad CloudWatch entre cuentas en la Guía del usuario de Amazon. CloudWatch

  • Para obtener más información sobre la API, consulte la sección de CreateSink referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-link.

AWS CLI

Para eliminar un enlace

En el siguiente ejemplo de delete-link, se elimina un enlace entre un receptor de cuenta de supervisión y una cuenta de origen.

aws oam delete-link \
    --identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111

Este comando no genera ninguna salida.

Para obtener más información, consulte la observabilidad CloudWatch entre cuentas en la Guía del usuario de Amazon. CloudWatch

  • Para obtener más información sobre la API, consulte la sección de DeleteLink referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-sink.

AWS CLI

Eliminación de un receptor

En el siguiente ejemplo de delete-sink, se elimina un receptor. Debe eliminar todos los enlaces a un receptor para poder eliminar ese receptor.

aws oam delete-sink \
    --identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Este comando no genera ninguna salida.

Para obtener más información, consulte la observabilidad CloudWatch entre cuentas en la Guía del usuario de Amazon. CloudWatch

  • Para obtener más información sobre la API, consulte la sección de DeleteSink referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar get-link.

AWS CLI

Devolución de la información completa sobre un enlace

En el siguiente ejemplo de get-link, se devuelve información completa sobre un enlace.

aws oam get-link \
    --identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111

Salida:

{
    "Arn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111",
    "Id": "a1b2c3d4-5678-90ab-cdef-example11111",
    "Label": "sourceAccount",
    "LabelTemplate": "sourceAccount",
    "ResourceTypes": [
        "AWS::CloudWatch::Metric"
    ],
    "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "Tags": {}
}

Para obtener más información, consulte la observabilidad CloudWatch entre cuentas en la Guía del usuario de Amazon. CloudWatch

  • Para obtener más información sobre la API, consulte la sección de GetLink referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar get-sink-policy.

AWS CLI

Devolución de la política de receptor actual adjunta al receptor

En el siguiente ejemplo de get-sink-policy, se devuelve la política de receptor actual asociada al receptor.

aws oam get-sink-policy \
    --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Salida:

{
    "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "SinkId": "a1b2c3d4-5678-90ab-cdef-example12345",
    "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789111:root\"},\"Action\":[\"oam:CreateLink\",\"oam:UpdateLink\"],\"Resource\":\"*\",\"Condition\":{\"ForAllValues:StringEquals\":{\"oam:ResourceTypes\":[\"AWS::Logs::LogGroup\",\"AWS::CloudWatch::Metric\",\"AWS::XRay::Trace\",\"AWS::ApplicationInsights::Application\"]}}}]}"
}

Para obtener más información, consulte la observabilidad CloudWatch entre cuentas en la Guía del usuario de Amazon. CloudWatch

  • Para obtener más información sobre la API, consulte la sección de GetSinkPolicy referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar get-sink.

AWS CLI

Devolución de la información completa sobre un receptor de cuenta de supervisión

En el siguiente ejemplo de get-sink, se devuelve información completa sobre un receptor de cuenta de supervisión.

aws oam get-sink \
    --identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Salida:

{
    "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "Id": "a1b2c3d4-5678-90ab-cdef-example12345",
    "Name": "DemoSink",
    "Tags": {}
}

Para obtener más información, consulte la observabilidad CloudWatch entre cuentas en la Guía del usuario de Amazon. CloudWatch

  • Para obtener más información sobre la API, consulte la sección de GetSink referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar list-attached-links.

AWS CLI

Devolución de una lista de los enlaces de cuentas de origen que están vinculados a este receptor de cuentas de supervisión

En el siguiente ejemplo de list-attached-links, se devuelve una lista de los enlaces de cuentas de origen que están enlazados a este receptor de cuentas de supervisión.

aws oam list-attached-links \
    --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Salida:

{
    "Items": [{
        "Label": "Monitoring account",
        "LinkArn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111",
        "ResourceTypes": [
            "AWS::ApplicationInsights::Application",
            "AWS::Logs::LogGroup",
            "AWS::CloudWatch::Metric",
            "AWS::XRay::Trace"
        ]
    }]
}

Para obtener más información, consulte la observabilidad CloudWatch entre cuentas en la Guía del usuario de Amazon. CloudWatch

  • Para obtener más información sobre la API, consulte la sección de ListAttachedLinks referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar list-links.

AWS CLI

Devolución de una lista de enlaces para un receptor de cuentas de supervisión

En el siguiente ejemplo de list-links, se devuelve una lista de enlaces para un receptor de cuentas de supervisión. Ejecute esta operación en una cuenta de origen para devolver una lista de enlaces a los receptores de las cuentas de supervisión que tiene esta cuenta de origen.

aws oam list-links

Salida:

{
    "Items": [{
        "Arn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111",
        "Id": "a1b2c3d4-5678-90ab-cdef-example11111",
        "Label": "sourceAccount",
        "ResourceTypes": [
            "AWS::CloudWatch::Metric"
        ],
        "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345"
    }]
}

Para obtener más información, consulte la observabilidad CloudWatch entre cuentas en la Guía del usuario de Amazon. CloudWatch

  • Para obtener más información sobre la API, consulte la sección de ListLinks referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar list-sinks.

AWS CLI

Para devolver la lista de receptores creada en la cuenta de supervisión

En el siguiente ejemplo de list-sinks, se devuelve una lista de receptores creada en la cuenta de supervisión. Ejecute esta operación en una cuenta de supervisión.

aws oam list-sinks

Salida:

{
    "Items": [
        {
            "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
            "Id": "a1b2c3d4-5678-90ab-cdef-example12345",
            "Name": "DemoSink"
        }
    ]
}

Para obtener más información, consulte la observabilidad CloudWatch entre cuentas en la Guía del usuario de Amazon. CloudWatch

  • Para obtener más información sobre la API, consulte la sección de ListSinks referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar list-tags-for-resource.

AWS CLI

Muestra de las etiquetas asociadas a un recurso

En el siguiente ejemplo de list-tags-for-resource, se muestran las etiquetas asociadas con un receptor.

aws oam list-tags-for-resource \
    --resource-arn arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Salida:

{
    "Tags": {
        "Team": "Devops"
    }
}

Para obtener más información, consulte la observabilidad CloudWatch entre cuentas en la Guía del CloudWatch usuario de Amazon.

  • Para obtener más información sobre la API, consulte la sección de ListTagsForResource referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar put-sink-policy.

AWS CLI

Creación o actualización de la política de recursos

En el siguiente ejemplo de put-sink-policy, se crea la política de recursos que concede permisos a las cuentas de origen para que se vinculen al receptor de cuentas de supervisión.

aws oam put-sink-policy \
    --policy '{"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":{"AWS":"arn:aws:iam::123456789111:root"},"Action":["oam:CreateLink","oam:UpdateLink"],"Resource":"*","Condition":{"ForAllValues:StringEquals":{"oam:ResourceTypes":["AWS::Logs::LogGroup","AWS::CloudWatch::Metric","AWS::XRay::Trace","AWS::ApplicationInsights::Application"]}}}]}' \
    --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Salida:

{
    "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "SinkId": "a1b2c3d4-5678-90ab-cdef-example12345",
    "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789111:root\"},\"Action\":[\"oam:CreateLink\",\"oam:UpdateLink\"],\"Resource\":\"*\",\"Condition\":{\"ForAllValues:StringEquals\":{\"oam:ResourceTypes\":[\"AWS::Logs::LogGroup\",\"AWS::CloudWatch::Metric\",\"AWS::XRay::Trace\",\"AWS::ApplicationInsights::Application\"]}}}]}"
}

Para obtener más información, consulte la observabilidad CloudWatch entre cuentas en la Guía del usuario de Amazon. CloudWatch

  • Para obtener más información sobre la API, consulte la sección de PutSinkPolicy referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar tag-resource.

AWS CLI

Agregación de una o varias etiquetas al recurso especificado

En el siguiente ejemplo de tag-resource, se etiqueta un receptor arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345.

aws oam tag-resource \
    --resource-arn arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 \
    --tags team=Devops

Este comando no genera ninguna salida.

Para obtener más información, consulte la observabilidad CloudWatch entre cuentas en la Guía del CloudWatch usuario de Amazon.

  • Para obtener más información sobre la API, consulte la sección de TagResource referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar untag-resource.

AWS CLI

Eliminación de una o varias etiquetas del recurso especificado.

En el siguiente ejemplo de untag-resource, se elimina una etiqueta con la clave team del receptor arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345.

aws oam untag-resource \
    --resource-arn arn:aws:oam:us-east-2:123456789012:sink/f3f42f60-f0f2-425c-1234-12347bdd821f \
    --tag-keys team

Este comando no genera ninguna salida.

Para obtener más información, consulte la observabilidad CloudWatch entre cuentas en la Guía del CloudWatch usuario de Amazon.

  • Para obtener más información sobre la API, consulte la sección de UntagResource referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo utilizar update-link.

AWS CLI

Cambio de los tipos de datos que se comparten desde una cuenta de origen a su receptor de cuentas de supervisión vinculado

En el siguiente ejemplo de update-link, se actualiza el enlace arn:aws:oam:us-east-2:123456789111:link/0123e691-e7ef-43fa-1234-c57c837fced0 con los tipos de recursos AWS::CloudWatch::Metric y AWS::Logs::LogGroup.

aws oam update-link \
    --identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111 \
    --resource-types "AWS::CloudWatch::Metric" "AWS::Logs::LogGroup"

Salida:

{
    "Arn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111",
    "Id": "a1b2c3d4-5678-90ab-cdef-example11111",
    "Label": "sourceAccount",
    "LabelTemplate": "sourceAccount",
    "ResourceTypes": [
        "AWS::CloudWatch::Metric",
        "AWS::Logs::LogGroup"
    ],
    "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "Tags": {}
}

Para obtener más información, consulte la observabilidad CloudWatch entre cuentas en la Guía del usuario de Amazon. CloudWatch

  • Para obtener más información sobre la API, consulte la sección de UpdateLink referencia de AWS CLI comandos.