Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).
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 IoT Greengrass V2 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 IoT Greengrass V2.
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
### `associate-service-role-to-account`
En el siguiente ejemplo de código, se muestra cómo utilizar `associate-service-role-to-account`.
**AWS CLI**
**Para asociar el rol de servicio de Greengrass a su cuenta AWS **
El siguiente `associate-service-role-to-account` ejemplo asocia un rol de servicio a AWS IoT Greengrass para su AWS cuenta.
```
aws greengrassv2 associate-service-role-to-account \
--role-arn arn:aws:iam::123456789012:role/service-role/Greengrass_ServiceRole
```
Salida:
```
{
"associatedAt": "2022-01-19T19:21:53Z"
}
```
Para obtener más información, consulte [Greengrass service role](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-service-role.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [AssociateServiceRoleToAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/associate-service-role-to-account.html)la *Referencia de AWS CLI comandos*.
### `batch-associate-client-device-with-core-device`
En el siguiente ejemplo de código, se muestra cómo utilizar `batch-associate-client-device-with-core-device`.
**AWS CLI**
**Para asociar los dispositivos de cliente a un dispositivo de núcleo**
En el siguiente ejemplo de `batch-associate-client-device-with-core-device`, se asocian dos dispositivos de cliente a un dispositivo de núcleo.
```
aws greengrassv2 batch-associate-client-device-with-core-device \
--core-device-thing-name MyGreengrassCore \
--entries thingName=MyClientDevice1 thingName=MyClientDevice2
```
Salida:
```
{
"errorEntries": []
}
```
Para obtener más información, consulte [Interact with local IoT devices](https://docs.aws.amazon.com/greengrass/v2/developerguide/interact-with-local-iot-devices.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [BatchAssociateClientDeviceWithCoreDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/batch-associate-client-device-with-core-device.html)la *Referencia de AWS CLI comandos*.
### `batch-disassociate-client-device-from-core-device`
En el siguiente ejemplo de código, se muestra cómo utilizar `batch-disassociate-client-device-from-core-device`.
**AWS CLI**
**Para desasociar los dispositivos de cliente de un dispositivo de núcleo**
En el siguiente ejemplo de `batch-disassociate-client-device-from-core-device`, se desasocian dos dispositivos de cliente de un dispositivo de núcleo.
```
aws greengrassv2 batch-disassociate-client-device-from-core-device \
--core-device-thing-name MyGreengrassCore \
--entries thingName=MyClientDevice1 thingName=MyClientDevice2
```
Salida:
```
{
"errorEntries": []
}
```
Para obtener más información, consulte [Interact with local IoT devices](https://docs.aws.amazon.com/greengrass/v2/developerguide/interact-with-local-iot-devices.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [BatchDisassociateClientDeviceFromCoreDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/batch-disassociate-client-device-from-core-device.html)la *Referencia de AWS CLI comandos*.
### `cancel-deployment`
En el siguiente ejemplo de código, se muestra cómo utilizar `cancel-deployment`.
**AWS CLI**
**Para cancelar una implementación**
En el siguiente ejemplo de `cancel-deployment`, se detiene una implementación continua en un grupo de objetos.
```
aws greengrassv2 cancel-deployment \
--deployment-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Salida:
```
{
"message": "SUCCESS"
}
```
Para obtener más información, consulte [Cancel deployments](https://docs.aws.amazon.com/greengrass/v2/developerguide/cancel-deployments.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [CancelDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/cancel-deployment.html)la *Referencia de AWS CLI comandos*.
### `create-component-version`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-component-version`.
**AWS CLI**
**Ejemplo 1: creación de una versión de componente a partir de una receta**
En el siguiente ejemplo de `create-component-version`, se crea una versión de un componente de Hola, mundo a partir de un archivo de recetas.
```
aws greengrassv2 create-component-version \
--inline-recipe fileb://com.example.HelloWorld-1.0.0.json
```
Contenido de `com.example.HelloWorld-1.0.0.json`:
```
{
"RecipeFormatVersion": "2020-01-25",
"ComponentName": "com.example.HelloWorld",
"ComponentVersion": "1.0.0",
"ComponentDescription": "My first AWS IoT Greengrass component.",
"ComponentPublisher": "Amazon",
"ComponentConfiguration": {
"DefaultConfiguration": {
"Message": "world"
}
},
"Manifests": [
{
"Platform": {
"os": "linux"
},
"Lifecycle": {
"Run": "echo 'Hello {configuration:/Message}'"
}
}
]
}
```
Salida:
```
{
"arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0",
"componentName": "com.example.HelloWorld",
"componentVersion": "1.0.0",
"creationTimestamp": "2021-01-07T16:24:33.650000-08:00",
"status": {
"componentState": "REQUESTED",
"message": "NONE",
"errors": {}
}
}
```
Para obtener más información, consulte [Create custom components](https://docs.aws.amazon.com/greengrass/v2/developerguide/create-components.html) y [Upload components to deploy](https://docs.aws.amazon.com/greengrass/v2/developerguide/upload-components.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
**Ejemplo 2: Para crear una versión de un componente a partir de una AWS función Lambda**
En el siguiente `create-component-version` ejemplo, se crea una versión de un componente de Hello World a partir de una AWS función Lambda.
```
aws greengrassv2 create-component-version \
--cli-input-json file://lambda-function-component.json
```
Contenido de `lambda-function-component.json`:
```
{
"lambdaFunction": {
"lambdaArn": "arn:aws:lambda:us-west-2:123456789012:function:HelloWorldPythonLambda:1",
"componentName": "com.example.HelloWorld",
"componentVersion": "1.0.0",
"componentLambdaParameters": {
"eventSources": [
{
"topic": "hello/world/+",
"type": "IOT_CORE"
}
]
}
}
}
```
Salida:
```
{
"arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0",
"componentName": "com.example.HelloWorld",
"componentVersion": "1.0.0",
"creationTimestamp": "2021-01-07T17:05:27.347000-08:00",
"status": {
"componentState": "REQUESTED",
"message": "NONE",
"errors": {}
}
}
```
Para obtener más información, consulte [Ejecutar funciones AWS Lambda](https://docs.aws.amazon.com/greengrass/v2/developerguide/run-lambda-functions.html) en la Guía para desarrolladores de IoT *AWS Greengrass* V2.
+ Para obtener más información sobre la API, consulte la Referencia [CreateComponentVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/create-component-version.html)de *AWS CLI comandos*.
### `create-deployment`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-deployment`.
**AWS CLI**
**Ejemplo 1: creación de una implementación**
En el siguiente `create-deployment` ejemplo, se implementa la interfaz de línea de comandos de AWS IoT Greengrass en un dispositivo central.
```
aws greengrassv2 create-deployment \
--cli-input-json file://cli-deployment.json
```
Contenido de `cli-deployment.json`:
```
{
"targetArn": "arn:aws:iot:us-west-2:123456789012:thing/MyGreengrassCore",
"deploymentName": "Deployment for MyGreengrassCore",
"components": {
"aws.greengrass.Cli": {
"componentVersion": "2.0.3"
}
},
"deploymentPolicies": {
"failureHandlingPolicy": "DO_NOTHING",
"componentUpdatePolicy": {
"timeoutInSeconds": 60,
"action": "NOTIFY_COMPONENTS"
},
"configurationValidationPolicy": {
"timeoutInSeconds": 60
}
},
"iotJobConfiguration": {}
}
```
Salida:
```
{
"deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
Para obtener más información, consulte [Create deployments](https://docs.aws.amazon.com/greengrass/v2/developerguide/create-deployments.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
**Ejemplo 2: creación de una implementación que actualice las configuraciones de los componentes**
En el siguiente `create-deployment` ejemplo, se implementa el componente núcleo de AWS IoT Greengrass en un grupo de dispositivos principales. Esta implementación aplica las siguientes actualizaciones de configuración para el componente del núcleo:
Restablezca la configuración de proxy de los dispositivos de destino en su configuración predeterminada sin proxy. Restablezca la configuración de MQTT de los dispositivos de destino a sus valores predeterminados. Establece las opciones de JVM para la JVM del núcleo. Establece el nivel de registro del núcleo.
```
aws greengrassv2 create-deployment \
--cli-input-json file://nucleus-deployment.json
```
Contenido de `nucleus-deployment.json`:
```
{
"targetArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/MyGreengrassCoreGroup",
"deploymentName": "Deployment for MyGreengrassCoreGroup",
"components": {
"aws.greengrass.Nucleus": {
"componentVersion": "2.0.3",
"configurationUpdate": {
"reset": [
"/networkProxy",
"/mqtt"
],
"merge": "{\"jvmOptions\":\"-Xmx64m\",\"logging\":{\"level\":\"WARN\"}}"
}
}
},
"deploymentPolicies": {
"failureHandlingPolicy": "ROLLBACK",
"componentUpdatePolicy": {
"timeoutInSeconds": 60,
"action": "NOTIFY_COMPONENTS"
},
"configurationValidationPolicy": {
"timeoutInSeconds": 60
}
},
"iotJobConfiguration": {}
}
```
Salida:
```
{
"deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"iotJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"iotJobArn": "arn:aws:iot:us-west-2:123456789012:job/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}
```
Para obtener más información, consulte [Create deployments](https://docs.aws.amazon.com/greengrass/v2/developerguide/create-deployments.html) y [Update component configurations](https://docs.aws.amazon.com/greengrass/v2/developerguide/update-component-configurations.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte la Referencia [CreateDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/create-deployment.html)de *AWS CLI comandos*.
### `delete-component`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-component`.
**AWS CLI**
**Para eliminar la versión de un componente**
En el siguiente ejemplo de `delete-component`, se elimina un componente de Hola, mundo.
```
aws greengrassv2 delete-component \
--arn arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Manage components](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [DeleteComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/delete-component.html)la *Referencia de AWS CLI comandos*.
### `delete-core-device`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-core-device`.
**AWS CLI**
**Para eliminar un dispositivo de núcleo**
En el siguiente `delete-core-device` ejemplo, se elimina un dispositivo AWS principal de IoT Greengrass.
```
aws greengrassv2 delete-core-device \
--core-device-thing-name MyGreengrassCore
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Desinstalar el software AWS IoT Greengrass Core](https://docs.aws.amazon.com/greengrass/v2/developerguide/configure-greengrass-core-v2.html#uninstall-greengrass-core-v2) en la Guía para desarrolladores de IoT *AWS Greengrass* V2.
+ Para obtener más información sobre la API, consulte la Referencia [DeleteCoreDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/delete-core-device.html)de *AWS CLI comandos*.
### `describe-component`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-component`.
**AWS CLI**
**Para describir la versión de un componente**
En el siguiente ejemplo de `describe-component`, se describe un componente de Hola, mundo.
```
aws greengrassv2 describe-component \
--arn arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0
```
Salida:
```
{
"arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0",
"componentName": "com.example.HelloWorld",
"componentVersion": "1.0.0",
"creationTimestamp": "2021-01-07T17:12:11.133000-08:00",
"publisher": "Amazon",
"description": "My first AWS IoT Greengrass component.",
"status": {
"componentState": "DEPLOYABLE",
"message": "NONE",
"errors": {}
},
"platforms": [
{
"attributes": {
"os": "linux"
}
}
]
}
```
Para obtener más información, consulte [Manage components](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [DescribeComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/describe-component.html)la *Referencia de AWS CLI comandos*.
### `disassociate-service-role-from-account`
En el siguiente ejemplo de código, se muestra cómo utilizar `disassociate-service-role-from-account`.
**AWS CLI**
**Para desasociar el rol de servicio de Greengrass de su cuenta AWS **
El siguiente `disassociate-service-role-from-account` ejemplo desvincula la función de servicio Greengrass de AWS IoT Greengrass para su cuenta. AWS
```
aws greengrassv2 disassociate-service-role-from-account
```
Salida:
```
{
"disassociatedAt": "2022-01-19T19:26:09Z"
}
```
Para obtener más información, consulte [Greengrass service role](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-service-role.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ *Para obtener más información sobre la API, consulte la Referencia de [DisassociateServiceRoleFromAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/disassociate-service-role-from-account.html)comandos AWS CLI .*
### `get-component-version-artifact`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-component-version-artifact`.
**AWS CLI**
**Para obtener una URL con el fin de descargar un artefacto de componente**
En el siguiente ejemplo de `get-component-version-artifact`, se obtiene una URL para descargar el archivo JAR del componente de la consola de depuración local.
```
aws greengrassv2 get-component-version-artifact \
--arn arn:aws:greengrass:us-west-2:aws:components:aws.greengrass.LocalDebugConsole:versions:2.0.3 \
--artifact-name "Uvt6ZEzQ9TKiAuLbfXBX_APdY0TWks3uc46tHFHTzBM=/aws.greengrass.LocalDebugConsole.jar"
```
Salida:
```
{
"preSignedUrl": "https://evergreencomponentmanageme-artifactbucket7410c9ef-g18n1iya8kwr.s3.us-west-2.amazonaws.com/public/aws.greengrass.LocalDebugConsole/2.0.3/s3/ggv2-component-releases-prod-pdx/EvergreenHttpDebugView/2ffc496ba41b39568968b22c582b4714a937193ee7687a45527238e696672521/aws.greengrass.LocalDebugConsole/aws.greengrass.LocalDebugConsole.jar?X-Amz-Security-Token=KwfLKSdEXAMPLE..."
}
```
Para obtener más información, consulte [Manage components](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [GetComponentVersionArtifact](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-component-version-artifact.html)la *Referencia de AWS CLI comandos*.
### `get-component`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-component`.
**AWS CLI**
**Ejemplo 1: descarga de la receta de un componente en formato YAML (Linux, macOS o Unix)**
En el siguiente ejemplo de `get-component`, se descarga la receta de un componente de Hola, mundo a un archivo en formato YAML. Este comando hace lo siguiente:
Utiliza los parámetros`--output` y `--query` para controlar la salida del comando. Estos parámetros extraen el blob de recetas de la salida del comando. Para obtener más información sobre la salida del comando, consulte [Controlling Command Output](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html) en la *Guía del usuario de la interfaz de línea de comandos de AWS *. Utiliza la utilidad de `base64`. Esta utilidad descodifica el blob extraído en el texto original. El blob que devuelve un comando `get-component` correcto es texto codificado en base64. Debe descodificar este blob para obtener el texto original. Guarda el texto decodificado en un archivo. La sección final del comando (`> com.example.HelloWorld-1.0.0.json`) guarda el texto decodificado en un archivo.
```
aws greengrassv2 get-component \
--arn arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0 \
--recipe-output-format YAML \
--query recipe \
--output text | base64 --decode > com.example.HelloWorld-1.0.0.json
```
Para obtener más información, consulte [Manage components](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
**Ejemplo 2: descarga de la receta de un componente en formato YAML (CMD de Windows)**
En el siguiente ejemplo de `get-component`, se descarga la receta de un componente de Hola, mundo a un archivo en formato YAML. Este comando usa la utilidad `certutil`.
```
aws greengrassv2 get-component ^
--arn arn:aws:greengrass:us-west-2:675946970638:components:com.example.HelloWorld:versions:1.0.0 ^
--recipe-output-format YAML ^
--query recipe ^
--output text > com.example.HelloWorld-1.0.0.yaml.b64
certutil -decode com.example.HelloWorld-1.0.0.yaml.b64 com.example.HelloWorld-1.0.0.yaml
```
Para obtener más información, consulte [Manage components](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
**Ejemplo 3: Para descargar la receta de un componente en formato YAML (Windows PowerShell)**
En el siguiente ejemplo de `get-component`, se descarga la receta de un componente de Hola, mundo a un archivo en formato YAML. Este comando usa la utilidad `certutil`.
```
aws greengrassv2 get-component `
--arn arn:aws:greengrass:us-west-2:675946970638:components:com.example.HelloWorld:versions:1.0.0 `
--recipe-output-format YAML `
--query recipe `
--output text > com.example.HelloWorld-1.0.0.yaml.b64
certutil -decode com.example.HelloWorld-1.0.0.yaml.b64 com.example.HelloWorld-1.0.0.yaml
```
Para obtener más información, consulte [Manage components](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [GetComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-component.html)la *Referencia de AWS CLI comandos*.
### `get-connectivity-info`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-connectivity-info`.
**AWS CLI**
**Para obtener información de conectividad para un dispositivo de núcleo de Greengrass**
En el siguiente ejemplo de `get-connectivity-info`, se obtiene información de conectividad para un dispositivo de núcleo de Greengrass. Los dispositivos de cliente utilizan esta información para conectarse al intermediario MQTT que se ejecuta en este dispositivo de núcleo.
```
aws greengrassv2 get-connectivity-info \
--thing-name MyGreengrassCore
```
Salida:
```
{
"connectivityInfo": [
{
"id": "localIP_192.0.2.0",
"hostAddress": "192.0.2.0",
"portNumber": 8883
}
]
}
```
Para obtener más información, consulte [Manage core device endpoints](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-core-device-endpoints.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [GetConnectivityInfo](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-connectivity-info.html)la *Referencia de AWS CLI comandos*.
### `get-core-device`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-core-device`.
**AWS CLI**
**Para obtener un dispositivo de núcleo**
En el siguiente `get-core-device` ejemplo, se obtiene información sobre un AWS dispositivo principal de IoT Greengrass.
```
aws greengrassv2 get-core-device \
--core-device-thing-name MyGreengrassCore
```
Salida:
```
{
"coreDeviceThingName": "MyGreengrassCore",
"coreVersion": "2.0.3",
"platform": "linux",
"architecture": "amd64",
"status": "HEALTHY",
"lastStatusUpdateTimestamp": "2021-01-08T04:57:58.838000-08:00",
"tags": {}
}
```
Para obtener más información, consulte [Check core device status](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-status.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [GetCoreDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-core-device.html)la *Referencia de AWS CLI comandos*.
### `get-deployment`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-deployment`.
**AWS CLI**
**Para obtener una implementación**
En el siguiente `get-deployment` ejemplo, se obtiene información sobre la implementación del componente núcleo de AWS IoT Greengrass en un grupo de dispositivos principales.
```
aws greengrassv2 get-deployment \
--deployment-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
```
Salida:
```
{
"targetArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/MyGreengrassCoreGroup",
"revisionId": "14",
"deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"deploymentName": "Deployment for MyGreengrassCoreGroup",
"deploymentStatus": "ACTIVE",
"iotJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"iotJobArn": "arn:aws:iot:us-west-2:123456789012:job/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"components": {
"aws.greengrass.Nucleus": {
"componentVersion": "2.0.3",
"configurationUpdate": {
"merge": "{\"jvmOptions\":\"-Xmx64m\",\"logging\":{\"level\":\"WARN\"}}",
"reset": [
"/networkProxy",
"/mqtt"
]
}
}
},
"deploymentPolicies": {
"failureHandlingPolicy": "ROLLBACK",
"componentUpdatePolicy": {
"timeoutInSeconds": 60,
"action": "NOTIFY_COMPONENTS"
},
"configurationValidationPolicy": {
"timeoutInSeconds": 60
}
},
"iotJobConfiguration": {},
"creationTimestamp": "2021-01-07T17:21:20.691000-08:00",
"isLatestForTarget": false,
"tags": {}
}
```
Para obtener más información, consulte [Deploy components to devices](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-deployments.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [GetDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-deployment.html)la *Referencia de AWS CLI comandos*.
### `get-service-role-for-account`
En el siguiente ejemplo de código, se muestra cómo utilizar `get-service-role-for-account`.
**AWS CLI**
**Para obtener el rol de servicio de Greengrass para su cuenta AWS **
En el siguiente `get-service-role-for-account` ejemplo, se obtiene el rol de servicio asociado a AWS IoT Greengrass para su AWS cuenta.
```
aws greengrassv2 get-service-role-for-account
```
Salida:
```
{
"associatedAt": "2022-01-19T19:21:53Z",
"roleArn": "arn:aws:iam::123456789012:role/service-role/Greengrass_ServiceRole"
}
```
Para obtener más información, consulte [Greengrass service role](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-service-role.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [GetServiceRoleForAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-service-role-for-account.html)la *Referencia de AWS CLI comandos*.
### `list-client-devices-associated-with-core-device`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-client-devices-associated-with-core-device`.
**AWS CLI**
**Para enumerar los dispositivos cliente asociados a un dispositivo de núcleo**
En el siguiente ejemplo de `list-client-devices-associated-with-core-device`, se enumeran todos los dispositivos de cliente asociados a un dispositivo de núcleo.
```
aws greengrassv2 list-client-devices-associated-with-core-device \
--core-device-thing-name MyTestGreengrassCore
```
Salida:
```
{
"associatedClientDevices": [
{
"thingName": "MyClientDevice2",
"associationTimestamp": "2021-07-12T16:33:55.843000-07:00"
},
{
"thingName": "MyClientDevice1",
"associationTimestamp": "2021-07-12T16:33:55.843000-07:00"
}
]
}
```
Para obtener más información, consulte [Interact with local IoT devices](https://docs.aws.amazon.com/greengrass/v2/developerguide/interact-with-local-iot-devices.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [ListClientDevicesAssociatedWithCoreDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-client-devices-associated-with-core-device.html)la *Referencia de AWS CLI comandos*.
### `list-component-versions`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-component-versions`.
**AWS CLI**
**Para enumerar las versiones disponibles del componente**
En el siguiente ejemplo de `list-component-versions`, se enumeran todas las versiones de un componente de Hola, mundo.
```
aws greengrassv2 list-component-versions \
--arn arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld
```
Salida:
```
{
"componentVersions": [
{
"componentName": "com.example.HelloWorld",
"componentVersion": "1.0.1",
"arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.1"
},
{
"componentName": "com.example.HelloWorld",
"componentVersion": "1.0.0",
"arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0"
}
]
}
```
Para obtener más información, consulte [Manage components](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [ListComponentVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-component-versions.html)la *Referencia de AWS CLI comandos*.
### `list-components`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-components`.
**AWS CLI**
**Para enumerar componentes**
El siguiente `list-components` ejemplo muestra cada componente y su última versión definida en su AWS cuenta en la región actual.
```
aws greengrassv2 list-components
```
Salida:
```
{
"components": [
{
"arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld",
"componentName": "com.example.HelloWorld",
"latestVersion": {
"arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.1",
"componentVersion": "1.0.1",
"creationTimestamp": "2021-01-08T16:51:07.352000-08:00",
"description": "My first AWS IoT Greengrass component.",
"publisher": "Amazon",
"platforms": [
{
"attributes": {
"os": "linux"
}
}
]
}
}
]
}
```
Para obtener más información, consulte [Manage components](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [ListComponents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-components.html)la *Referencia de AWS CLI comandos*.
### `list-core-devices`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-core-devices`.
**AWS CLI**
**Para enumerar los dispositivos de núcleo**
En el siguiente `list-core-devices` ejemplo, se enumeran los dispositivos principales de AWS IoT Greengrass de tu AWS cuenta en la región actual.
```
aws greengrassv2 list-core-devices
```
Salida:
```
{
"coreDevices": [
{
"coreDeviceThingName": "MyGreengrassCore",
"status": "HEALTHY",
"lastStatusUpdateTimestamp": "2021-01-08T04:57:58.838000-08:00"
}
]
}
```
Para obtener más información, consulte [Check core device status](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-status.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [ListCoreDevices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-core-devices.html)la *Referencia de AWS CLI comandos*.
### `list-deployments`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-deployments`.
**AWS CLI**
**Para enumerar implementaciones**
En el siguiente `list-deployments` ejemplo, se muestra la última revisión de cada despliegue definido en tu AWS cuenta en la región actual.
```
aws greengrassv2 list-deployments
```
Salida:
```
{
"deployments": [
{
"targetArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/MyGreengrassCoreGroup",
"revisionId": "14",
"deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"deploymentName": "Deployment for MyGreengrassCoreGroup",
"creationTimestamp": "2021-01-07T17:21:20.691000-08:00",
"deploymentStatus": "ACTIVE",
"isLatestForTarget": false
},
{
"targetArn": "arn:aws:iot:us-west-2:123456789012:thing/MyGreengrassCore",
"revisionId": "1",
"deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"deploymentName": "Deployment for MyGreengrassCore",
"creationTimestamp": "2021-01-06T16:10:42.407000-08:00",
"deploymentStatus": "COMPLETED",
"isLatestForTarget": false
}
]
}
```
Para obtener más información, consulte [Deploy components to devices](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-deployments.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [ListDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-deployments.html)la *Referencia de AWS CLI comandos*.
### `list-effective-deployments`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-effective-deployments`.
**AWS CLI**
**Para enumerar los trabajos de implementación**
En el siguiente `list-effective-deployments` ejemplo, se enumeran las implementaciones que se aplican a un dispositivo principal de AWS IoT Greengrass.
```
aws greengrassv2 list-effective-deployments \
--core-device-thing-name MyGreengrassCore
```
Salida:
```
{
"effectiveDeployments": [
{
"deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"deploymentName": "Deployment for MyGreengrassCore",
"iotJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
"targetArn": "arn:aws:iot:us-west-2:123456789012:thing/MyGreengrassCore",
"coreDeviceExecutionStatus": "COMPLETED",
"reason": "SUCCESSFUL",
"creationTimestamp": "2021-01-06T16:10:42.442000-08:00",
"modifiedTimestamp": "2021-01-08T17:21:27.830000-08:00"
},
{
"deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"deploymentName": "Deployment for MyGreengrassCoreGroup",
"iotJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE44444",
"iotJobArn": "arn:aws:iot:us-west-2:123456789012:job/a1b2c3d4-5678-90ab-cdef-EXAMPLE44444",
"targetArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/MyGreengrassCoreGroup",
"coreDeviceExecutionStatus": "SUCCEEDED",
"reason": "SUCCESSFUL",
"creationTimestamp": "2021-01-07T17:19:20.394000-08:00",
"modifiedTimestamp": "2021-01-07T17:21:20.721000-08:00"
}
]
}
```
Para obtener más información, consulte [Check core device status](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-status.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [ListEffectiveDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-effective-deployments.html)la *Referencia de AWS CLI comandos*.
### `list-installed-components`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-installed-components`.
**AWS CLI**
**Para enumerar los componentes instalados en un dispositivo de núcleo**
En el siguiente `list-installed-components` ejemplo, se enumeran los componentes que están instalados en un dispositivo principal de AWS IoT Greengrass.
```
aws greengrassv2 list-installed-components \
--core-device-thing-name MyGreengrassCore
```
Salida:
```
{
"installedComponents": [
{
"componentName": "aws.greengrass.Cli",
"componentVersion": "2.0.3",
"lifecycleState": "RUNNING",
"isRoot": true
},
{
"componentName": "aws.greengrass.Nucleus",
"componentVersion": "2.0.3",
"lifecycleState": "FINISHED",
"isRoot": true
}
]
}
```
Para obtener más información, consulte [Check core device status](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-status.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [ListInstalledComponents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-installed-components.html)la *Referencia de AWS CLI comandos*.
### `list-tags-for-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-tags-for-resource`.
**AWS CLI**
**Para enumerar las etiquetas de un recurso**
En el siguiente `list-tags-for-resource` ejemplo, se enumeran todas las etiquetas de un AWS dispositivo principal de IoT Greengrass.
```
aws greengrassv2 list-tags-for-resource \
--resource-arn arn:aws:greengrass:us-west-2:123456789012:coreDevices:MyGreengrassCore
```
Salida:
```
{
"tags": {
"Owner": "richard-roe"
}
}
```
Para obtener más información, consulte [Tag your resources](https://docs.aws.amazon.com/greengrass/v2/developerguide/tag-resources.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-tags-for-resource.html)la *Referencia de AWS CLI comandos*.
### `tag-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `tag-resource`.
**AWS CLI**
**Cómo añadir una etiqueta a un recurso**
El siguiente `tag-resource` ejemplo agrega una etiqueta de propietario a un dispositivo principal de AWS IoT Greengrass. Puede usar esta etiqueta para controlar el acceso al dispositivo de núcleo en función de quién sea su propietario.
```
aws greengrassv2 tag-resource \
--resource-arn arn:aws:greengrass:us-west-2:123456789012:coreDevices:MyGreengrassCore \
--tags Owner=richard-roe
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Tag your resources](https://docs.aws.amazon.com/greengrass/v2/developerguide/tag-resources.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/tag-resource.html)la *Referencia de AWS CLI comandos*.
### `untag-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `untag-resource`.
**AWS CLI**
**Para eliminar una etiqueta de un recurso**
El siguiente `untag-resource` ejemplo elimina una etiqueta de propietario de un dispositivo principal de AWS IoT Greengrass.
```
aws iotsitewise untag-resource \
--resource-arn arn:aws:greengrass:us-west-2:123456789012:coreDevices:MyGreengrassCore \
--tag-keys Owner
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Tag your resources](https://docs.aws.amazon.com/greengrass/v2/developerguide/tag-resources.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/untag-resource.html)la *Referencia de AWS CLI comandos*.
### `update-connectivity-info`
En el siguiente ejemplo de código, se muestra cómo utilizar `update-connectivity-info`.
**AWS CLI**
**Para actualizar la información de conectividad para un dispositivo de núcleo de Greengrass**
En el siguiente ejemplo de `update-connectivity-info`, se obtiene información de conectividad para un dispositivo de núcleo de Greengrass. Los dispositivos de cliente utilizan esta información para conectarse al intermediario MQTT que se ejecuta en este dispositivo de núcleo.
```
aws greengrassv2 update-connectivity-info \
--thing-name MyGreengrassCore \
--cli-input-json file://core-device-connectivity-info.json
```
Contenido de `core-device-connectivity-info.json`:
```
{
"connectivityInfo": [
{
"hostAddress": "192.0.2.0",
"portNumber": 8883,
"id": "localIP_192.0.2.0"
}
]
}
```
Salida:
```
{
"version": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
Para obtener más información, consulte [Manage core device endpoints](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-core-device-endpoints.html) en la *Guía para desarrolladores de AWS IoT Greengrass, versión 2*.
+ Para obtener más información sobre la API, consulte [UpdateConnectivityInfo](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/update-connectivity-info.html)la *Referencia de AWS CLI comandos*.