# Ejemplos de CloudWatch Observability Access Monitor que utilizan AWS CLI
Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante la 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.
**Topics**
+ [Acciones](#actions)
## Acciones
### `create-link`
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 [Observabilidad entre cuentas de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [CreateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/create-link.html) en la *Referencia de comandos de la AWS CLI*.
### `create-sink`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-sink`.
**AWS CLI**
**Creación de un receptor**
En el siguiente ejemplo de `create-sink`, se crea un receptor en la cuenta actual para que pueda utilizarse como cuenta de supervisión en la observabilidad entre cuentas de CloudWatch.
```
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 [Observabilidad entre cuentas de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [CreateSink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/create-sink.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-link`
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 [Observabilidad entre cuentas de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [DeleteLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/delete-link.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-sink`
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 [Observabilidad entre cuentas de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [DeleteSink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/delete-sink.html) en la *Referencia de comandos de la AWS CLI*.
### `get-link`
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 [Observabilidad entre cuentas de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [GetLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/get-link.html) en la *Referencia de comandos de la AWS CLI*.
### `get-sink-policy`
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 [Observabilidad entre cuentas de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [GetSinkPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/get-sink-policy.html) en la *Referencia de comandos de la AWS CLI*.
### `get-sink`
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 [Observabilidad entre cuentas de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [GetSink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/get-sink.html) en la *Referencia de comandos de la AWS CLI*.
### `list-attached-links`
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 [Observabilidad entre cuentas de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [ListAttachedLinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-attached-links.html) en la *Referencia de comandos de la AWS CLI*.
### `list-links`
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 [Observabilidad entre cuentas de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [ListLinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-links.html) en la *Referencia de comandos de la AWS CLI*.
### `list-sinks`
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 [Observabilidad entre cuentas de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [ListSinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-sinks.html) en la *Referencia de comandos de la AWS CLI*.
### `list-tags-for-resource`
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 [Observabilidad entre cuentas de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para ver los detalles de la API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-tags-for-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `put-sink-policy`
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 [Observabilidad entre cuentas de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [PutSinkPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/put-sink-policy.html) en la *Referencia de comandos de la AWS CLI*.
### `tag-resource`
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 [Observabilidad entre cuentas de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para ver los detalles de la API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/tag-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `untag-resource`
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 [Observabilidad entre cuentas de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para ver los detalles de la API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/untag-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `update-link`
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 [Observabilidad entre cuentas de CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [UpdateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/update-link.html) en la *Referencia de comandos de la AWS CLI*.