# AWS IoT Greengrass Exemplos do usando a AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o AWS IoT Greengrass.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `associate-role-to-group`
O código de exemplo a seguir mostra como usar `associate-role-to-group`.
**AWS CLI**
**Associar um perfil a um grupo Greengrass**
O exemplo `associate-role-to-group` a seguir associa o perfil do IAM específico a um grupo do Greengrass. O perfil de grupo é usado por funções e conectores locais do Lambda para acessar serviços da AWS. Por exemplo, seu perfil de grupo pode conceder as permissões necessárias para integrar com o CloudWatch Logs.
```
aws greengrass associate-role-to-group \
--group-id 2494ee3f-7f8a-4e92-a78b-d205f808b84b \
--role-arn arn:aws:iam::123456789012:role/GG-Group-Role
```
Resultado:
```
{
"AssociatedAt": "2019-09-10T20:03:30Z"
}
```
Para obter mais informações sobre grupos, consulte [Configurar Perfil de Grupo](https://docs.aws.amazon.com/greengrass/latest/developerguide/config-iam-roles.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [AssociateRoleToGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/associate-role-to-group.html) na *Referência de comandos da AWS CLI*.
### `associate-service-role-to-account`
O código de exemplo a seguir mostra como usar `associate-service-role-to-account`.
**AWS CLI**
**Associar um perfil de serviço à sua conta AWS**
O exemplo `associate-service-role-to-account` a seguir associa perfil de serviço do IAM, especificado por seu ARN, ao AWS IoT Greengrass em sua conta da AWS. É preciso ter criado, anteriormente, o perfil de serviço no IAM e associar a ele um documento de política que permita que o AWS IoT Greengrass assuma esse perfil.
```
aws greengrass associate-service-role-to-account \
--role-arn "arn:aws:iam::123456789012:role/service-role/Greengrass_ServiceRole"
```
Resultado:
```
{
"AssociatedAt": "2019-06-25T18:12:45Z"
}
```
Para obter mais informações sobre grupos, consulte [Perfil de Serviço do Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/service-role.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [AssociateServiceRoleToAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/associate-service-role-to-account.html) na * Referência do comando da AWS CLI*.
### `create-connector-definition-version`
O código de exemplo a seguir mostra como usar `create-connector-definition-version`.
**AWS CLI**
**Criar uma versão de definição de conector**
O exemplo `create-connector-definition-version` a seguir cria uma versão de definição de conector e a associa à definição de conector específica. Todos os conectores em uma versão definem valores para seus parâmetros.
```
aws greengrass create-connector-definition-version \
--connector-definition-id "55d0052b-0d7d-44d6-b56f-21867215e118" \
--connectors "[{\"Id\": \"MyTwilioNotificationsConnector\", \"ConnectorArn\": \"arn:aws:greengrass:us-west-2::/connectors/TwilioNotifications/versions/2\", \"Parameters\": {\"TWILIO_ACCOUNT_SID\": \"AC1a8d4204890840d7fc482aab38090d57\", \"TwilioAuthTokenSecretArn\": \"arn:aws:secretsmanager:us-west-2:123456789012:secret:greengrass-TwilioAuthToken-ntSlp6\", \"TwilioAuthTokenSecretArn-ResourceId\": \"TwilioAuthToken\", \"DefaultFromPhoneNumber\": \"4254492999\"}}]"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/55d0052b-0d7d-44d6-b56f-21867215e118/versions/33f709a0-c825-49cb-9eea-dc8964fbd635",
"CreationTimestamp": "2019-06-24T20:46:30.134Z",
"Id": "55d0052b-0d7d-44d6-b56f-21867215e118",
"Version": "33f709a0-c825-49cb-9eea-dc8964fbd635"
}
```
+ Para ver detalhes da API, consulte [CreateConnectorDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-connector-definition-version.html) na *Referência de comandos da AWS CLI*.
### `create-connector-definition`
O código de exemplo a seguir mostra como usar `create-connector-definition`.
**AWS CLI**
**Criar uma definição de conector**
O exemplo `create-connector-definition` a seguir cria uma definição de conector e uma versão inicial de definição de conector. A versão inicial contém um conector. Todos os conectores em uma versão definem valores para seus parâmetros.
```
aws greengrass create-connector-definition \
--name MySNSConnector \
--initial-version "{\"Connectors\": [{\"Id\":\"MySNSConnector\",\"ConnectorArn\":\"arn:aws:greengrass:us-west-2::/connectors/SNS/versions/1\",\"Parameters\": {\"DefaultSNSArn\":\"arn:aws:sns:us-west-2:123456789012:GGConnectorTopic\"}}]}"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8",
"CreationTimestamp": "2019-06-19T19:30:01.300Z",
"Id": "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8",
"LastUpdatedTimestamp": "2019-06-19T19:30:01.300Z",
"LatestVersion": "63c57963-c7c2-4a26-a7e2-7bf478ea2623",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8/versions/63c57963-c7c2-4a26-a7e2-7bf478ea2623",
"Name": "MySNSConnector"
}
```
Para obter mais informações, consulte [Introdução aos Conectores Greengrass (CLI)](https://docs.aws.amazon.com/greengrass/latest/developerguide/connectors-cli.html) no **Guia do Desenvolvedor do AWS IoT Greengrass**.
+ Para ver detalhes da API, consulte [CreateConnectorDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-connector-definition.html) na *Referência de comandos da AWS CLI*.
### `create-core-definition-version`
O código de exemplo a seguir mostra como usar `create-core-definition-version`.
**AWS CLI**
**Criar uma versão de definição de núcleo**
O exemplo `create-core-definition-version` a seguir cria uma versão de definição de núcleo e a associa à definição de núcleo específica. A versão pode conter apenas um núcleo. Antes de criar um núcleo, é preciso antes criar e fornecer o item do AWS IoT correspondente. Esse processo inclui os seguintes `iot` comandos, que retornam `ThingArn` e `CertificateArn` necessários para o comando `create-core-definition-version`.
Criar o item do AWS IoT que corresponde ao dispositivo principal:
```
aws iot create-thing \
--thing-name "MyCoreDevice"
```
Resultado:
```
{
"thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyCoreDevice",
"thingName": "MyCoreDevice",
"thingId": "cb419a19-9099-4515-9cec-e9b0e760608a"
}
```
Criar chaves públicas e privadas, além do certificado do dispositivo principal para o item. Este exemplo usa o comando `create-keys-and-certificate` e exige permissões de gravação no diretório atual. Como alternativa, você pode usar o comando `create-certificate-from-csr`.
```
aws iot create-keys-and-certificate \
--set-as-active \
--certificate-pem-outfile "myCore.cert.pem" \
--public-key-outfile "myCore.public.key" \
--private-key-outfile "myCore.private.key"
```
Resultado:
```
{
"certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz",
"certificatePem": "-----BEGIN CERTIFICATE-----\nMIIDWTCAkGgAwIBATgIUCgq6EGqou6zFqWgIZRndgQEFW+gwDQYJKoZIhvc...KdGewQS\n-----END CERTIFICATE-----\n",
"keyPair": {
"PublicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBzrqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqKpRgnn6yq26U3y...wIDAQAB\n-----END PUBLIC KEY-----\n",
"PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIABAKCAQEAqKpRgnn6yq26U3yt5YFZquyukfRjbMXDcNOK4rMCxDR...fvY4+te\n-----END RSA PRIVATE KEY-----\n"
},
"certificateId": "123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz"
}
```
Criar uma política do AWS IoT que permita ações `iot` e `greengrass`. Simplificando, a política a seguir permite ações em todos os recursos, mas sua política deve ser mais restritiva.
```
aws iot create-policy \
--policy-name "Core_Devices" \
--policy-document "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}"
```
Resultado:
```
{
"policyName": "Core_Devices",
"policyArn": "arn:aws:iot:us-west-2:123456789012:policy/Core_Devices",
"policyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}",
"policyVersionId": "1"
}
```
Anexar a política ao certificado:
```
aws iot attach-policy \
--policy-name "Core_Devices" \
--target "arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz"
```
Este comando não produz saída.
Anexar o item ao certificado:
```
aws iot attach-thing-principal \
--thing-name "MyCoreDevice" \
--principal "arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz"
```
Este comando não produz saída.
Criar uma versão de definição de núcleo:
```
aws greengrass create-core-definition-version \
--core-definition-id "582efe12-b05a-409e-9a24-a2ba1bcc4a12" \
--cores "[{\"Id\":\"MyCoreDevice\",\"ThingArn\":\"arn:aws:iot:us-west-2:123456789012:thing/MyCoreDevice\",\"CertificateArn\":\"arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz\",\"SyncShadow\":true}]"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/582efe12-b05a-409e-9a24-a2ba1bcc4a12/versions/3fdc1190-2ce5-44de-b98b-eec8f9571014",
"Version": "3fdc1190-2ce5-44de-b98b-eec8f9571014",
"CreationTimestamp": "2019-09-18T00:15:09.838Z",
"Id": "582efe12-b05a-409e-9a24-a2ba1bcc4a12"
}
```
Para obter mais informações, consulte [Configurar AWS IoT Greengrass Core](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-core.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [CreateCoreDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-core-definition-version.html) na *Referência de comandos da AWS CLI*.
### `create-core-definition`
O código de exemplo a seguir mostra como usar `create-core-definition`.
**AWS CLI**
**Exemplo 1: criar uma definição de núcleo vazia**
O exemplo `create-core-definition` a seguir cria uma definição de núcleo Greengrass vazia (sem versão inicial). Antes que o núcleo possa ser usado, é necessário usar o comando `create-core-definition-version` para fornecer os outros parâmetros do núcleo.
```
aws greengrass create-core-definition \
--name cliGroup_Core
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/b5c08008-54cb-44bd-9eec-c121b04283b5",
"CreationTimestamp": "2019-06-25T18:23:22.106Z",
"Id": "b5c08008-54cb-44bd-9eec-c121b04283b5",
"LastUpdatedTimestamp": "2019-06-25T18:23:22.106Z",
"Name": "cliGroup_Core"
}
```
**Exemplo 2: criar uma definição de núcleo com uma versão inicial**
O exemplo `create-core-definition` a seguir cria uma definição de núcleo que contém uma versão inicial da definição de núcleo. A versão pode conter apenas um núcleo. Antes de criar um núcleo, é preciso antes criar e fornecer o item do AWS IoT correspondente. Esse processo inclui os seguintes `iot` comandos, que retornam `ThingArn` e `CertificateArn` necessários para o comando `create-core-definition`.
Criar o item do AWS IoT que corresponde ao dispositivo principal:
```
aws iot create-thing \
--thing-name "MyCoreDevice"
```
Resultado:
```
{
"thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyCoreDevice",
"thingName": "MyCoreDevice",
"thingId": "cb419a19-9099-4515-9cec-e9b0e760608a"
}
```
Criar chaves públicas e privadas, além do certificado do dispositivo principal para o item. Este exemplo usa o comando `create-keys-and-certificate` e exige permissões de gravação no diretório atual. Como alternativa, você pode usar o comando `create-certificate-from-csr`.
```
aws iot create-keys-and-certificate \
--set-as-active \
--certificate-pem-outfile "myCore.cert.pem" \
--public-key-outfile "myCore.public.key" \
--private-key-outfile "myCore.private.key"
```
Resultado:
```
{
"certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz",
"certificatePem": "-----BEGIN CERTIFICATE-----\nMIIDWTCAkGgAwIBATgIUCgq6EGqou6zFqWgIZRndgQEFW+gwDQYJKoZIhvc...KdGewQS\n-----END CERTIFICATE-----\n",
"keyPair": {
"PublicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBzrqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqKpRgnn6yq26U3y...wIDAQAB\n-----END PUBLIC KEY-----\n",
"PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIABAKCAQEAqKpRgnn6yq26U3yt5YFZquyukfRjbMXDcNOK4rMCxDR...fvY4+te\n-----END RSA PRIVATE KEY-----\n"
},
"certificateId": "123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz"
}
```
Criar uma política do AWS IoT que permita ações `iot` e `greengrass`. Simplificando, a política a seguir permite ações em todos os recursos, mas sua política deve ser mais restritiva.
```
aws iot create-policy \
--policy-name "Core_Devices" \
--policy-document "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}"
```
Resultado:
```
{
"policyName": "Core_Devices",
"policyArn": "arn:aws:iot:us-west-2:123456789012:policy/Core_Devices",
"policyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}",
"policyVersionId": "1"
}
```
Anexar a política ao certificado:
```
aws iot attach-policy \
--policy-name "Core_Devices" \
--target "arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz"
```
Este comando não produz saída.
Anexar o item ao certificado:
```
aws iot attach-thing-principal \
--thing-name "MyCoreDevice" \
--principal "arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz"
```
Este comando não produz saída.
Criar uma definição de núcleo:
```
aws greengrass create-core-definition \
--name "MyCores" \
--initial-version "{\"Cores\":[{\"Id\":\"MyCoreDevice\",\"ThingArn\":\"arn:aws:iot:us-west-2:123456789012:thing/MyCoreDevice\",\"CertificateArn\":\"arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz\",\"SyncShadow\":true}]}"
```
Resultado:
```
{
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/582efe12-b05a-409e-9a24-a2ba1bcc4a12/versions/cc87b5b3-8f4b-465d-944c-1d6de5dbfcdb",
"Name": "MyCores",
"LastUpdatedTimestamp": "2019-09-18T00:11:06.197Z",
"LatestVersion": "cc87b5b3-8f4b-465d-944c-1d6de5dbfcdb",
"CreationTimestamp": "2019-09-18T00:11:06.197Z",
"Id": "582efe12-b05a-409e-9a24-a2ba1bcc4a12",
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/582efe12-b05a-409e-9a24-a2ba1bcc4a12"
}
```
Para obter mais informações, consulte [Configurar AWS IoT Greengrass Core](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-core.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [CreateCoreDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-core-definition.html) na *Referência de comandos da AWS CLI*.
### `create-deployment`
O código de exemplo a seguir mostra como usar `create-deployment`.
**AWS CLI**
**Criar uma implantação para uma versão de um grupo do Greengrass**
O exemplo `create-deployment` a seguir implanta a versão específica de um grupo do Greengrass.
```
aws greengrass create-deployment \
--deployment-type NewDeployment \
--group-id "ce2e7d01-3240-4c24-b8e6-f6f6e7a9eeca" \
--group-version-id "dc40c1e9-e8c8-4d28-a84d-a9cad5f599c9"
```
Resultado:
```
{
"DeploymentArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/ce2e7d01-3240-4c24-b8e6-f6f6e7a9eeca/deployments/bfceb608-4e97-45bc-af5c-460144270308",
"DeploymentId": "bfceb608-4e97-45bc-af5c-460144270308"
}
```
Para obter mais informações, consulte [Introdução a Conectores (CLI)](https://docs.aws.amazon.com/greengrass/latest/developerguide/connectors-cli.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Consulte detalhes da API em [CreateDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-deployment.html) na *Referência de comandos da AWS CLI*.
### `create-device-definition-version`
O código de exemplo a seguir mostra como usar `create-device-definition-version`.
**AWS CLI**
**Criar uma versão de definição de dispositivo**
O exemplo `create-device-definition-version` a seguir cria uma versão de definição de dispositivo e a associa à definição de dispositivo específica. A versão define dois dispositivos. Antes de criar um dispositivo Greengrass, é necessário primeiro criar e provisionar o item do AWS IoT correspondente. Esse processo inclui os seguintes comandos `iot` que devem ser executados para obter informações necessárias para o comando Greengrass:
Criar o item do AWS IoT correspondente ao dispositivo:
```
aws iot create-thing \
--thing-name "InteriorTherm"
```
Resultado:
```
{
"thingArn": "arn:aws:iot:us-west-2:123456789012:thing/InteriorTherm",
"thingName": "InteriorTherm",
"thingId": "01d4763c-78a6-46c6-92be-7add080394bf"
}
```
Crie chaves públicas e privadas, além do certificado do dispositivo para o item. Este exemplo usa o comando `create-keys-and-certificate` e exige permissões de gravação no diretório atual. Como alternativa, você pode usar o comando `create-certificate-from-csr`:
```
aws iot create-keys-and-certificate \
--set-as-active \
--certificate-pem-outfile "myDevice.cert.pem" \
--public-key-outfile "myDevice.public.key" \
--private-key-outfile "myDevice.private.key"
```
Resultado:
```
{
"certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92",
"certificatePem": "-----BEGIN CERTIFICATE-----\nMIIDWTCAkGgAwIBATgIUCgq6EGqou6zFqWgIZRndgQEFW+gwDQYJKoZIhvc...KdGewQS\n-----END CERTIFICATE-----\n",
"keyPair": {
"PublicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBzrqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqKpRgnn6yq26U3y...wIDAQAB\n-----END PUBLIC KEY-----\n",
"PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIABAKCAQEAqKpRgnn6yq26U3yt5YFZquyukfRjbMXDcNOK4rMCxDR...fvY4+te\n-----END RSA PRIVATE KEY-----\n"
},
"certificateId": "66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92"
}
```
Criar uma política do AWS IoT que permita ações `iot` e `greengrass`. Para simplificar, a política a seguir permite ações em todos os recursos, mas sua política pode ficar mais rigorosa:
```
aws iot create-policy \
--policy-name "GG_Devices" \
--policy-document "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}"
```
Resultado:
```
{
"policyName": "GG_Devices",
"policyArn": "arn:aws:iot:us-west-2:123456789012:policy/GG_Devices",
"policyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}",
"policyVersionId": "1"
}
```
Anexar a política ao certificado:
```
aws iot attach-policy \
--policy-name "GG_Devices" \
--target "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92"
```
Anexar o item ao certificado
```
aws iot attach-thing-principal \
--thing-name "InteriorTherm" \
--principal "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92"
```
Depois de criar e configurar o item IoT conforme demonstrado anteriormente, use `ThingArn` e `CertificateArn` dos dois primeiros comandos no exemplo a seguir.
```
aws greengrass create-device-definition-version \
--device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd" \
--devices "[{\"Id\":\"InteriorTherm\",\"ThingArn\":\"arn:aws:iot:us-west-2:123456789012:thing/InteriorTherm\",\"CertificateArn\":\"arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92\",\"SyncShadow\":true},{\"Id\":\"ExteriorTherm\",\"ThingArn\":\"arn:aws:iot:us-west-2:123456789012:thing/ExteriorTherm\",\"CertificateArn\":\"arn:aws:iot:us-west-2:123456789012:cert/6c52ce1b47bde88a637e9ccdd45fe4e4c2c0a75a6866f8f63d980ee22fa51e02\",\"SyncShadow\":true}]"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd/versions/83c13984-6fed-447e-84d5-5b8aa45d5f71",
"Version": "83c13984-6fed-447e-84d5-5b8aa45d5f71",
"CreationTimestamp": "2019-09-11T00:15:09.838Z",
"Id": "f9ba083d-5ad4-4534-9f86-026a45df1ccd"
}
```
+ Para ver detalhes da API, consulte [CreateDeviceDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-device-definition-version.html) na *Referência de comandos da AWS CLI*.
### `create-device-definition`
O código de exemplo a seguir mostra como usar `create-device-definition`.
**AWS CLI**
**Criar uma definição de dispositivo**
O exemplo `create-device-definition` a seguir cria uma definição de dispositivo que contém uma versão inicial da definição de dispositivo. A versão inicial define dois dispositivos. Antes de criar um dispositivo Greengrass, é necessário primeiro criar e provisionar o item do AWS IoT correspondente. Esse processo inclui os seguintes comandos `iot` que devem ser executados para obter informações necessárias para o comando Greengrass:
Criar o item do AWS IoT correspondente ao dispositivo:
```
aws iot create-thing \
--thing-name "InteriorTherm"
```
Resultado:
```
{
"thingArn": "arn:aws:iot:us-west-2:123456789012:thing/InteriorTherm",
"thingName": "InteriorTherm",
"thingId": "01d4763c-78a6-46c6-92be-7add080394bf"
}
```
Crie chaves públicas e privadas, além do certificado do dispositivo para o item. Este exemplo usa o comando `create-keys-and-certificate` e exige permissões de gravação no diretório atual. Como alternativa, você pode usar o comando `create-certificate-from-csr`:
```
aws iot create-keys-and-certificate \
--set-as-active \
--certificate-pem-outfile "myDevice.cert.pem" \
--public-key-outfile "myDevice.public.key" \
--private-key-outfile "myDevice.private.key"
```
Resultado:
```
{
"certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92",
"certificatePem": "-----BEGIN CERTIFICATE-----\nMIIDWTCAkGgAwIBATgIUCgq6EGqou6zFqWgIZRndgQEFW+gwDQYJKoZIhvc...KdGewQS\n-----END CERTIFICATE-----\n",
"keyPair": {
"PublicKey": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBzrqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqKpRgnn6yq26U3y...wIDAQAB\n-----END PUBLIC KEY-----\n",
"PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIABAKCAQEAqKpRgnn6yq26U3yt5YFZquyukfRjbMXDcNOK4rMCxDR...fvY4+te\n-----END RSA PRIVATE KEY-----\n"
},
"certificateId": "66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92"
}
```
Criar uma política do AWS IoT que permita ações `iot` e `greengrass`. Para simplificar, a política a seguir permite ações em todos os recursos, mas sua política pode ficar mais rigorosa:
```
aws iot create-policy \
--policy-name "GG_Devices" \
--policy-document "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}"
```
Resultado:
```
{
"policyName": "GG_Devices",
"policyArn": "arn:aws:iot:us-west-2:123456789012:policy/GG_Devices",
"policyDocument": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Action\":[\"iot:Publish\",\"iot:Subscribe\",\"iot:Connect\",\"iot:Receive\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"iot:GetThingShadow\",\"iot:UpdateThingShadow\",\"iot:DeleteThingShadow\"],\"Resource\":[\"*\"]},{\"Effect\":\"Allow\",\"Action\":[\"greengrass:*\"],\"Resource\":[\"*\"]}]}",
"policyVersionId": "1"
}
```
Anexar a política ao certificado:
```
aws iot attach-policy \
--policy-name "GG_Devices" \
--target "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92"
```
Anexar o item ao certificado
```
aws iot attach-thing-principal \
--thing-name "InteriorTherm" \
--principal "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92"
```
Depois de criar e configurar o item IoT conforme demonstrado anteriormente, use `ThingArn` e `CertificateArn` dos dois primeiros comandos no exemplo a seguir.
```
aws greengrass create-device-definition \
--name "Sensors" \
--initial-version "{\"Devices\":[{\"Id\":\"InteriorTherm\",\"ThingArn\":\"arn:aws:iot:us-west-2:123456789012:thing/InteriorTherm\",\"CertificateArn\":\"arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92\",\"SyncShadow\":true},{\"Id\":\"ExteriorTherm\",\"ThingArn\":\"arn:aws:iot:us-west-2:123456789012:thing/ExteriorTherm\",\"CertificateArn\":\"arn:aws:iot:us-west-2:123456789012:cert/6c52ce1b47bde88a637e9ccdd45fe4e4c2c0a75a6866f8f63d980ee22fa51e02\",\"SyncShadow\":true}]}"
```
Resultado:
```
{
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd/versions/3b5cc510-58c1-44b5-9d98-4ad858ffa795",
"Name": "Sensors",
"LastUpdatedTimestamp": "2019-09-11T00:11:06.197Z",
"LatestVersion": "3b5cc510-58c1-44b5-9d98-4ad858ffa795",
"CreationTimestamp": "2019-09-11T00:11:06.197Z",
"Id": "f9ba083d-5ad4-4534-9f86-026a45df1ccd",
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd"
}
```
+ Para ver detalhes da API, consulte [CreateDeviceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-device-definition.html) na *Referência de comandos da AWS CLI*.
### `create-function-definition-version`
O código de exemplo a seguir mostra como usar `create-function-definition-version`.
**AWS CLI**
**Criar uma versão da definição da função**
O exemplo `create-function-definition-version` a seguir cria uma nova versão da definição de função específica. Essa versão especifica uma única função cujo ID é `Hello-World-function`, permite acesso ao sistema de arquivos e determina um tamanho máximo de memória e um período de tempo limite.
```
aws greengrass create-function-definition-version \
--cli-input-json "{\"FunctionDefinitionId\": \"e626e8c9-3b8f-4bf3-9cdc-d26ecdeb9fa3\",\"Functions\": [{\"Id\": \"Hello-World-function\", \"FunctionArn\": \""arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld_Counter:gghw-alias"\",\"FunctionConfiguration\": {\"Environment\": {\"AccessSysfs\": true},\"Executable\": \"greengrassHelloWorldCounter.function_handler\",\"MemorySize\": 16000,\"Pinned\": false,\"Timeout\": 25}}]}"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/e626e8c9-3b8f-4bf3-9cdc-d26ecdeb9fa3/versions/74abd1cc-637e-4abe-8684-9a67890f4043",
"CreationTimestamp": "2019-06-25T22:03:43.376Z",
"Id": "e626e8c9-3b8f-4bf3-9cdc-d26ecdeb9fa3",
"Version": "74abd1cc-637e-4abe-8684-9a67890f4043"
}
```
+ Para ver detalhes da API, consulte [CreateFunctionDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-function-definition-version.html) na *Referência de comandos da AWS CLI*.
### `create-function-definition`
O código de exemplo a seguir mostra como usar `create-function-definition`.
**AWS CLI**
**Criar uma definição da função do Lambda**
O exemplo `create-function-definition` a seguir cria uma definição de função do Lambda e uma versão inicial, fornecendo uma lista de funções do Lambda (neste caso, uma lista de apenas uma função chamada `TempMonitorFunction`) e suas configurações. Antes de criar a definição da função, é necessária a função do Lambda ARN. Para criar a função e seu respectivo alias, use comandos `create-function` e `publish-version` do Lambda. O comando `create-function` do Lambda exige o ARN do perfil de execução, embora o AWS IoT Greengrass não use esse perfil porque as permissões são especificadas no perfil de grupo do Greengrass. Você pode usar o comando `create-role` IAM para criar um perfil vazio e obter um ARN para usar com o `create-function` do Lambda ou usar um perfil de execução existente.
```
aws greengrass create-function-definition \
--name MyGreengrassFunctions \
--initial-version "{\"Functions\": [{\"Id\": \"TempMonitorFunction\", \"FunctionArn\": \"arn:aws:lambda:us-west-2:123456789012:function:TempMonitor:GG_TempMonitor\", \"FunctionConfiguration\": {\"Executable\": \"temp_monitor.function_handler\", \"MemorySize\": 16000,\"Timeout\": 5}}]}"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/3b0d0080-87e7-48c6-b182-503ec743a08b",
"CreationTimestamp": "2019-06-19T22:24:44.585Z",
"Id": "3b0d0080-87e7-48c6-b182-503ec743a08b",
"LastUpdatedTimestamp": "2019-06-19T22:24:44.585Z",
"LatestVersion": "67f918b9-efb4-40b0-b87c-de8c9faf085b",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/3b0d0080-87e7-48c6-b182-503ec743a08b/versions/67f918b9-efb4-40b0-b87c-de8c9faf085b",
"Name": "MyGreengrassFunctions"
}
```
Para obter mais informações, consulte [How to Configure Local Resource Access Using the AWS Command Line Interface](https://docs.aws.amazon.com/greengrass/latest/developerguide/lra-cli.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [CreateFunctionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-function-definition.html) na *Referência de comandos da AWS CLI*.
### `create-group-certificate-authority`
O código de exemplo a seguir mostra como usar `create-group-certificate-authority`.
**AWS CLI**
**Criar uma autoridade de certificação (CA) para um grupo**
O exemplo `create-group-certificate-authority` a seguir cria ou alterna uma CA para o grupo específico.
```
aws greengrass create-group-certificate-authority \
--group-id "8eaadd72-ce4b-4f15-892a-0cc4f3a343f1"
```
Resultado:
```
{
"GroupCertificateAuthorityArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/8eaadd72-ce4b-4f15-892a-0cc4f3a343f1/certificateauthorities/d31630d674c4437f6c5dbc0dca56312a902171ce2d086c38e509c8EXAMPLEcc5"
}
```
Para obter mais informações sobre grupos, consulte [Segurança do AWS IoT Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-sec.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [CreateGroupCertificateAuthority](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-group-certificate-authority.html) na *Referência de comandos da AWS CLI*.
### `create-group-version`
O código de exemplo a seguir mostra como usar `create-group-version`.
**AWS CLI**
**Criar uma versão de um grupo do Greengrass**
O exemplo `create-group-version` a seguir cria uma versão de grupo e a associa ao grupo específico. A versão faz referência às versões de núcleo, recurso, conector, função e assinatura que contêm as entidades a serem incluídas nessa versão de grupo. É necessário criar essas entidades antes da versão de grupo.
Para criar uma definição de recurso com uma versão inicial, use o comando `create-resource-definition`.Para criar uma definição de conector com uma versão inicial, use o comando `create-connector-definition`.Para criar uma definição de função com uma versão inicial, use o comando `create-function-definition`.Para criar uma definição de assinatura com uma versão inicial, use o comando `create-subscription-definition`.Para recuperar o ARN da última versão da definição de núcleo, use o comando `get-group-version` e especifique a ID da última versão do grupo.
```
aws greengrass create-group-version \
--group-id "ce2e7d01-3240-4c24-b8e6-f6f6e7a9eeca" \
--core-definition-version-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/6a630442-8708-4838-ad36-eb98849d975e/versions/6c87151b-1fb4-4cb2-8b31-6ee715d8f8ba" \
--resource-definition-version-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/c8bb9ebc-c3fd-40a4-9c6a-568d75569d38/versions/a5f94d0b-f6bc-40f4-bb78-7a1c5fe13ba1" \
--connector-definition-version-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/55d0052b-0d7d-44d6-b56f-21867215e118/versions/78a3331b-895d-489b-8823-17b4f9f418a0" \
--function-definition-version-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/3b0d0080-87e7-48c6-b182-503ec743a08b/versions/67f918b9-efb4-40b0-b87c-de8c9faf085b" \
--subscription-definition-version-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/9d611d57-5d5d-44bd-a3b4-feccbdd69112/versions/aa645c47-ac90-420d-9091-8c7ffa4f103f"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/ce2e7d01-3240-4c24-b8e6-f6f6e7a9eeca/versions/e10b0459-4345-4a09-88a4-1af1f5d34638",
"CreationTimestamp": "2019-06-20T18:42:47.020Z",
"Id": "ce2e7d01-3240-4c24-b8e6-f6f6e7a9eeca",
"Version": "e10b0459-4345-4a09-88a4-1af1f5d34638"
}
```
*Para obter mais informações, consulte [Overview of the AWS IoT Greengrass Group Object Model](https://docs.aws.amazon.com/greengrass/latest/developerguide/deployments.html#api-overview) no Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [CreateGroupVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-group-version.html) na *Referência de comandos da AWS CLI*.
### `create-group`
O código de exemplo a seguir mostra como usar `create-group`.
**AWS CLI**
**Criar um grupo Greengrass**
O exemplo `create-group` a seguir cria um grupo chamado `cli-created-group`.
```
aws greengrass create-group \
--name cli-created-group
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/4e22bd92-898c-436b-ade5-434d883ff749",
"CreationTimestamp": "2019-06-25T18:07:17.688Z",
"Id": "4e22bd92-898c-436b-ade5-434d883ff749",
"LastUpdatedTimestamp": "2019-06-25T18:07:17.688Z",
"Name": "cli-created-group"
}
```
*Para obter mais informações, consulte [Overview of the AWS IoT Greengrass Group Object Model](https://docs.aws.amazon.com/greengrass/latest/developerguide/deployments.html#api-overview) no Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Consulte detalhes da API em [CreateGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-group.html) na *Referência de comandos da AWS CLI*.
### `create-logger-definition-version`
O código de exemplo a seguir mostra como usar `create-logger-definition-version`.
**AWS CLI**
**Criar uma versão de definição de logger**
O exemplo `create-logger-definition-version` a seguir cria uma versão de definição de logger e a associa a uma definição de logger. A versão define quatro configurações de log: 1) logs de componentes do sistema no sistema de arquivos do dispositivo principal, 2) logs de funções do Lambda definidas pelo usuário no sistema de arquivos do dispositivo principal, 3) logs de componentes do sistema no Amazon CloudWatch Logs e 4) logs de funções do Lambda definidas pelo usuário no Amazon CloudWatch Logs. Observação: para integrar os logs do CloudWatch, sua função de grupo deve conceder as permissões apropriadas.
```
aws greengrass create-logger-definition-version \
--logger-definition-id "a454b62a-5d56-4ca9-bdc4-8254e1662cb0" \
--loggers "[{\"Id\":\"1\",\"Component\":\"GreengrassSystem\",\"Level\":\"ERROR\",\"Space\":10240,\"Type\":\"FileSystem\"},{\"Id\":\"2\",\"Component\":\"Lambda\",\"Level\":\"INFO\",\"Space\":10240,\"Type\":\"FileSystem\"},{\"Id\":\"3\",\"Component\":\"GreengrassSystem\",\"Level\":\"WARN\",\"Type\":\"AWSCloudWatch\"},{\"Id\":\"4\",\"Component\":\"Lambda\",\"Level\":\"INFO\",\"Type\":\"AWSCloudWatch\"}]"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/a454b62a-5d56-4ca9-bdc4-8254e1662cb0/versions/49aedb1e-01a3-4d39-9871-3a052573f1ea",
"Version": "49aedb1e-01a3-4d39-9871-3a052573f1ea",
"CreationTimestamp": "2019-07-24T00:04:48.523Z",
"Id": "a454b62a-5d56-4ca9-bdc4-8254e1662cb0"
}
```
Para obter mais informações, consulte [Monitoring with AWS IoT Greengrass Logs](https://docs.aws.amazon.com/greengrass/latest/developerguide/greengrass-logs-overview.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [CreateLoggerDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-logger-definition-version.html) na *Referência de comandos da AWS CLI*.
### `create-logger-definition`
O código de exemplo a seguir mostra como usar `create-logger-definition`.
**AWS CLI**
**Criar uma definição de logger**
O exemplo `create-logger-definition` a seguir cria uma definição de logger que contém uma versão inicial de definição de logger. A versão inicial define três configurações de log: 1) logs de componentes do sistema no sistema de arquivos do dispositivo principal, 2) logs de funções do Lambda definidas pelo usuário no sistema de arquivos do dispositivo principal e 3) logs de funções do Lambda definidas pelo usuário no Amazon CloudWatch Logs. Observação: para integrar os logs do CloudWatch, sua função de grupo deve conceder as permissões apropriadas.
```
aws greengrass create-logger-definition \
--name "LoggingConfigs" \
--initial-version "{\"Loggers\":[{\"Id\":\"1\",\"Component\":\"GreengrassSystem\",\"Level\":\"ERROR\",\"Space\":10240,\"Type\":\"FileSystem\"},{\"Id\":\"2\",\"Component\":\"Lambda\",\"Level\":\"INFO\",\"Space\":10240,\"Type\":\"FileSystem\"},{\"Id\":\"3\",\"Component\":\"Lambda\",\"Level\":\"INFO\",\"Type\":\"AWSCloudWatch\"}]}"
```
Resultado:
```
{
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/a454b62a-5d56-4ca9-bdc4-8254e1662cb0/versions/de1d9854-1588-4525-b25e-b378f60f2322",
"Name": "LoggingConfigs",
"LastUpdatedTimestamp": "2019-07-23T23:52:17.165Z",
"LatestVersion": "de1d9854-1588-4525-b25e-b378f60f2322",
"CreationTimestamp": "2019-07-23T23:52:17.165Z",
"Id": "a454b62a-5d56-4ca9-bdc4-8254e1662cb0",
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/a454b62a-5d56-4ca9-bdc4-8254e1662cb0"
}
```
Para obter mais informações, consulte [Monitoring with AWS IoT Greengrass Logs](https://docs.aws.amazon.com/greengrass/latest/developerguide/greengrass-logs-overview.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [CreateLoggerDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-logger-definition.html) na *Referência de comandos da AWS CLI*.
### `create-resource-definition-version`
O código de exemplo a seguir mostra como usar `create-resource-definition-version`.
**AWS CLI**
**Criar uma versão de uma definição de recurso**
O exemplo `create-resource-definition-version` a seguir cria uma nova versão de um TwilioAuthToken.
```
aws greengrass create-resource-definition-version \
--resource-definition-id "c8bb9ebc-c3fd-40a4-9c6a-568d75569d38" \
--resources "[{\"Id\": \"TwilioAuthToken\",\"Name\": \"MyTwilioAuthToken\",\"ResourceDataContainer\": {\"SecretsManagerSecretResourceData\": {\"ARN\": \"arn:aws:secretsmanager:us-west-2:123456789012:secret:greengrass-TwilioAuthToken-ntSlp6\"}}}]"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/c8bb9ebc-c3fd-40a4-9c6a-568d75569d38/versions/b3bcada0-5fb6-42df-bf0b-1ee4f15e769e",
"CreationTimestamp": "2019-06-24T21:17:25.623Z",
"Id": "c8bb9ebc-c3fd-40a4-9c6a-568d75569d38",
"Version": "b3bcada0-5fb6-42df-bf0b-1ee4f15e769e"
}
```
+ Para ver detalhes da API, consulte [CreateResourceDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-resource-definition-version.html) na *Referência de comandos da AWS CLI*.
### `create-resource-definition`
O código de exemplo a seguir mostra como usar `create-resource-definition`.
**AWS CLI**
**Criar uma definição de recurso**
O exemplo `create-resource-definition` a seguir cria uma definição de recurso que contém uma lista de recursos a serem usados em um grupo do Greengrass. Neste exemplo, inclui-se uma versão inicial da definição de recursos por meio do fornecimento de uma lista de recursos. A lista inclui um recurso para um token de autorização do Twilio e o ARN para um segredo armazenado no AWS Secrets Manager. É necessário criar o segredo antes de definir o recurso.
```
aws greengrass create-resource-definition \
--name MyGreengrassResources \
--initial-version "{\"Resources\": [{\"Id\": \"TwilioAuthToken\",\"Name\": \"MyTwilioAuthToken\",\"ResourceDataContainer\": {\"SecretsManagerSecretResourceData\": {\"ARN\": \"arn:aws:secretsmanager:us-west-2:123456789012:secret:greengrass-TwilioAuthToken-ntSlp6\"}}}]}"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/c8bb9ebc-c3fd-40a4-9c6a-568d75569d38",
"CreationTimestamp": "2019-06-19T21:51:28.212Z",
"Id": "c8bb9ebc-c3fd-40a4-9c6a-568d75569d38",
"LastUpdatedTimestamp": "2019-06-19T21:51:28.212Z",
"LatestVersion": "a5f94d0b-f6bc-40f4-bb78-7a1c5fe13ba1",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/c8bb9ebc-c3fd-40a4-9c6a-568d75569d38/versions/a5f94d0b-f6bc-40f4-bb78-7a1c5fe13ba1",
"Name": "MyGreengrassResources"
}
```
Para obter mais informações, consulte [How to Configure Local Resource Access Using the AWS Command Line Interface](https://docs.aws.amazon.com/greengrass/latest/developerguide/lra-cli.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [CreateResourceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-resource-definition.html) na *Referência de comandos da AWS CLI*.
### `create-software-update-job`
O código de exemplo a seguir mostra como usar `create-software-update-job`.
**AWS CLI**
**Criar um serviço de atualização de software para um núcleo**
O exemplo `create-software-update-job` a seguir cria um serviço de atualização via ondas de rádio (OTA) para atualizar o software AWS IoT Greengrass Core no núcleo denominado `MyFirstGroup_Core`. Esse comando requer um perfil do IAM que permita o acesso a pacotes de atualização de software no Amazon S3 e inclua `iot.amazonaws.com` como uma entidade confiável.
```
aws greengrass create-software-update-job \
--update-targets-architecture armv7l \
--update-targets [\"arn:aws:iot:us-west-2:123456789012:thing/MyFirstGroup_Core\"] \
--update-targets-operating-system raspbian \
--software-to-update core \
--s3-url-signer-role arn:aws:iam::123456789012:role/OTA_signer_role \
--update-agent-log-level WARN
```
Resultado:
```
{
"IotJobId": "GreengrassUpdateJob_30b353e3-3af7-4786-be25-4c446663c09e",
"IotJobArn": "arn:aws:iot:us-west-2:123456789012:job/GreengrassUpdateJob_30b353e3-3af7-4786-be25-4c446663c09e",
"PlatformSoftwareVersion": "1.9.3"
}
```
*Para obter mais informações, consulte [OTA Updates of AWS IoT Greengrass Core Software](https://docs.aws.amazon.com/greengrass/latest/developerguide/core-ota-update.html) no Guia do desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [CreateSoftwareUpdateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-software-update-job.html) na *Referência de comandos da AWS CLI*.
### `create-subscription-definition-version`
O código de exemplo a seguir mostra como usar `create-subscription-definition-version`.
**AWS CLI**
**Criar uma nova versão de uma definição de assinatura**
O exemplo `create-subscription-definition-version` a seguir cria uma nova versão de uma definição de assinatura que contém três assinaturas: uma notificação de acionamento, uma entrada de temperatura e um status de saída.
```
aws greengrass create-subscription-definition-version \
--subscription-definition-id "9d611d57-5d5d-44bd-a3b4-feccbdd69112" \
--subscriptions "[{\"Id\": \"TriggerNotification\", \"Source\": \"arn:aws:lambda:us-west-2:123456789012:function:TempMonitor:GG_TempMonitor\", \"Subject\": \"twilio/txt\", \"Target\": \"arn:aws:greengrass:us-west-2::/connectors/TwilioNotifications/versions/1\"},{\"Id\": \"TemperatureInput\", \"Source\": \"cloud\", \"Subject\": \"temperature/input\", \"Target\": \"arn:aws:lambda:us-west-2:123456789012:function:TempMonitor:GG_TempMonitor\"},{\"Id\": \"OutputStatus\", \"Source\": \"arn:aws:greengrass:us-west-2::/connectors/TwilioNotifications/versions/1\", \"Subject\": \"twilio/message/status\", \"Target\": \"cloud\"}]"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/9d611d57-5d5d-44bd-a3b4-feccbdd69112/versions/7b65dfae-50b6-4d0f-b3e0-27728bfb0620",
"CreationTimestamp": "2019-06-24T21:21:33.837Z",
"Id": "9d611d57-5d5d-44bd-a3b4-feccbdd69112",
"Version": "7b65dfae-50b6-4d0f-b3e0-27728bfb0620"
}
```
+ Para ver detalhes da API, consulte [CreateSubscriptionDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-subscription-definition-version.html) na *Referência de comandos da AWS CLI*.
### `create-subscription-definition`
O código de exemplo a seguir mostra como usar `create-subscription-definition`.
**AWS CLI**
**Criar uma definição de assinatura**
O exemplo `create-subscription-definition` a seguir cria uma definição de assinatura e especifica sua versão inicial. A versão inicial contém três assinaturas: uma para o tópico MQTT ao qual o conector se inscreve, uma para permitir que uma função receba leituras de temperatura da IoT AWS e uma para permitir que a IoT AWS receba informações de status do conector. O exemplo fornece o ARN para o alias da função do Lambda que foi criado anteriormente usando o comando `create-alias` do Lambda.
```
aws greengrass create-subscription-definition \
--initial-version "{\"Subscriptions\": [{\"Id\": \"TriggerNotification\", \"Source\": \"arn:aws:lambda:us-west-2:123456789012:function:TempMonitor:GG_TempMonitor\", \"Subject\": \"twilio/txt\", \"Target\": \"arn:aws:greengrass:us-west-2::/connectors/TwilioNotifications/versions/1\"},{\"Id\": \"TemperatureInput\", \"Source\": \"cloud\", \"Subject\": \"temperature/input\", \"Target\": \"arn:aws:lambda:us-west-2:123456789012:function:TempMonitor:GG_TempMonitor\"},{\"Id\": \"OutputStatus\", \"Source\": \"arn:aws:greengrass:us-west-2::/connectors/TwilioNotifications/versions/1\", \"Subject\": \"twilio/message/status\", \"Target\": \"cloud\"}]}"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/9d611d57-5d5d-44bd-a3b4-feccbdd69112",
"CreationTimestamp": "2019-06-19T22:34:26.677Z",
"Id": "9d611d57-5d5d-44bd-a3b4-feccbdd69112",
"LastUpdatedTimestamp": "2019-06-19T22:34:26.677Z",
"LatestVersion": "aa645c47-ac90-420d-9091-8c7ffa4f103f",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/9d611d57-5d5d-44bd-a3b4-feccbdd69112/versions/aa645c47-ac90-420d-9091-8c7ffa4f103f"
}
```
Para obter mais informações, consulte [Introdução a Conectores (CLI)](https://docs.aws.amazon.com/greengrass/latest/developerguide/connectors-cli.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [CreateSubscriptionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-subscription-definition.html) na *Referência de comandos da AWS CLI*.
### `delete-connector-definition`
O código de exemplo a seguir mostra como usar `delete-connector-definition`.
**AWS CLI**
**Excluir uma definição de conector**
O exemplo `delete-connector-definition` a seguir exclui a definição específica do conector Greengrass. Caso exclua uma definição de conector que seja usada por um grupo, esse grupo não poderá ser implantado com êxito.
```
aws greengrass delete-connector-definition \
--connector-definition-id "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8"
```
Este comando não produz saída.
+ Para ver detalhes da API, consulte [DeleteConnectorDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-connector-definition.html) na *Referência de comandos da AWS CLI*.
### `delete-core-definition`
O código de exemplo a seguir mostra como usar `delete-core-definition`.
**AWS CLI**
**Excluir uma definição de núcleo**
O exemplo `delete-core-definition` a seguir exclui a definição básica específica do Greengrass, incluindo todas as versões. Caso exclua um núcleo associado a um grupo Greengrass, esse grupo não poderá ser implantado com êxito.
```
aws greengrass delete-core-definition \
--core-definition-id "ff36cc5f-9f98-4994-b468-9d9b6dc52abd"
```
Este comando não produz saída.
+ Para ver detalhes da API, consulte [DeleteCoreDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-core-definition.html) na *Referência de comandos da AWS CLI*.
### `delete-device-definition`
O código de exemplo a seguir mostra como usar `delete-device-definition`.
**AWS CLI**
**Excluir uma definição de dispositivo**
O exemplo `delete-device-definition` a seguir exclui a definição de dispositivo específica, incluindo todas as versões. Caso exclua uma versão de definição de dispositivo usada por uma versão de grupo, esta não poderá ser implantada com êxito.
```
aws greengrass delete-device-definition \
--device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd"
```
Este comando não produz saída.
+ Para ver detalhes da API, consulte [DeleteDeviceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-device-definition.html) na *Referência de comandos da AWS CLI*.
### `delete-function-definition`
O código de exemplo a seguir mostra como usar `delete-function-definition`.
**AWS CLI**
**Excluir uma definição de função**
O exemplo `delete-function-definition` a seguir exclui a definição da função Greengrass específica. Caso exclua uma definição de função usada por um grupo, esse grupo não poderá ser implantado com êxito.
```
aws greengrass delete-function-definition \
--function-definition-id "fd4b906a-dff3-4c1b-96eb-52ebfcfac06a"
```
Este comando não produz saída.
+ Para ver detalhes da API, consulte [DeleteFunctionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-function-definition.html) na *Referência de comandos da AWS CLI*.
### `delete-group`
O código de exemplo a seguir mostra como usar `delete-group`.
**AWS CLI**
**Para excluir um grupo**
O exemplo `delete-group` a seguir exclui o grupo Greengrass específico.
```
aws greengrass delete-group \
--group-id "4e22bd92-898c-436b-ade5-434d883ff749"
```
Este comando não produz saída.
+ Consulte detalhes da API em [DeleteGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-group.html) na *Referência de comandos da AWS CLI*.
### `delete-logger-definition`
O código de exemplo a seguir mostra como usar `delete-logger-definition`.
**AWS CLI**
**Excluir uma definição de logger**
O exemplo `delete-logger-definition` a seguir exclui a definição do logger específico, incluindo todas as versões da definição do logger. Caso exclua uma versão de definição de logger usada por uma versão de grupo, esta não poderá ser implantada com êxito.
```
aws greengrass delete-logger-definition \
--logger-definition-id "a454b62a-5d56-4ca9-bdc4-8254e1662cb0"
```
Este comando não produz saída.
Para obter mais informações, consulte [Monitoring with AWS IoT Greengrass Logs](https://docs.aws.amazon.com/greengrass/latest/developerguide/greengrass-logs-overview.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [DeleteLoggerDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-logger-definition.html) na *Referência de comandos da AWS CLI*.
### `delete-resource-definition`
O código de exemplo a seguir mostra como usar `delete-resource-definition`.
**AWS CLI**
**Excluir uma definição de recurso**
O exemplo `delete-resource-definition` a seguir exclui a definição de recurso específica, incluindo todas as versões do recurso. Caso exclua uma definição de recurso usada por um grupo, este não poderá ser implantado com êxito.
```
aws greengrass delete-resource-definition \
--resource-definition-id "ad8c101d-8109-4b0e-b97d-9cc5802ab658"
```
Este comando não produz saída.
+ Para ver detalhes da API, consulte [DeleteResourceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-resource-definition.html) na *Referência de comandos da AWS CLI*.
### `delete-subscription-definition`
O código de exemplo a seguir mostra como usar `delete-subscription-definition`.
**AWS CLI**
**Excluir uma definição de assinatura**
O exemplo `delete-subscription-definition` a seguir exclui a definição de assinatura Greengrass específica. Caso exclua uma assinatura que esteja sendo usada por um grupo, este não poderá ser implantado com êxito.
```
aws greengrass delete-subscription-definition \
--subscription-definition-id "cd6f1c37-d9a4-4e90-be94-01a7404f5967"
```
Este comando não produz saída.
+ Para ver detalhes da API, consulte [DeleteSubscriptionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-subscription-definition.html) na * Referência de comandos da AWS CLI*.
### `disassociate-role-from-group`
O código de exemplo a seguir mostra como usar `disassociate-role-from-group`.
**AWS CLI**
**Desassociar um perfil de um grupo do Greengrass**
O exemplo `disassociate-role-from-group` a seguir dissocia o perfil do IAM do grupo Greengrass específico.
```
aws greengrass disassociate-role-from-group \
--group-id 2494ee3f-7f8a-4e92-a78b-d205f808b84b
```
Resultado:
```
{
"DisassociatedAt": "2019-09-10T20:05:49Z"
}
```
Para obter mais informações sobre grupos, consulte [Configurar Perfil de Grupo](https://docs.aws.amazon.com/greengrass/latest/developerguide/config-iam-roles.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [DisassociateRoleFromGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/disassociate-role-from-group.html) na *Referência de comandos da AWS CLI*.
### `disassociate-service-role-from-account`
O código de exemplo a seguir mostra como usar `disassociate-service-role-from-account`.
**AWS CLI**
**Desassociar um perfil de serviço de sua conta AWS**
O exemplo `disassociate-service-role-from-account` a seguir remove o perfil de serviço associado à sua conta da AWS. Se não estiver usando o perfil de serviço em nenhuma região da AWS, use o comando `delete-role-policy` para desvincular a política gerenciada `AWSGreengrassResourceAccessRolePolicy` do perfil e, em seguida, use o comando `delete-role` para excluí-lo.
```
aws greengrass disassociate-service-role-from-account
```
Resultado:
```
{
"DisassociatedAt": "2019-06-25T22:12:55Z"
}
```
Para obter mais informações sobre grupos, consulte [Perfil de Serviço do Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/service-role.html) no **Guia do Desenvolvedor do AWS IoT Greengrass**.
+ Para ver detalhes da API, consulte [DisassociateServiceRoleFromAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/disassociate-service-role-from-account.html) na *Referência de comandos da AWS CLI*.
### `get-associated-role`
O código de exemplo a seguir mostra como usar `get-associated-role`.
**AWS CLI**
**Obter o perfil associado a um grupo Greengrass**
O exemplo `get-associated-role` a seguir obtém o perfil do IAM associado ao grupo Greengrass específico. O perfil de grupo é usado por funções e conectores locais do Lambda para acessar serviços da AWS.
```
aws greengrass get-associated-role \
--group-id 2494ee3f-7f8a-4e92-a78b-d205f808b84b
```
Resultado:
```
{
"RoleArn": "arn:aws:iam::123456789012:role/GG-Group-Role",
"AssociatedAt": "2019-09-10T20:03:30Z"
}
```
Para obter mais informações sobre grupos, consulte [Configurar Perfil de Grupo](https://docs.aws.amazon.com/greengrass/latest/developerguide/config-iam-roles.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [GetAssociatedRole](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-associated-role.html) na *Referência de comandos da AWS CLI*.
### `get-bulk-deployment-status`
O código de exemplo a seguir mostra como usar `get-bulk-deployment-status`.
**AWS CLI**
**Verificar o status de sua implantação em massa**
O exemplo `get-bulk-deployment-status` a seguir recupera as informações de status da operação de implantação em massa específica. Neste exemplo, o arquivo que especificou os grupos a serem implantados tem um registro de entrada inválido.
```
aws greengrass get-bulk-deployment-status \
--bulk-deployment-id "870fb41b-6288-4e0c-bc76-a7ba4b4d3267"
```
Resultado:
```
{
"BulkDeploymentMetrics": {
"InvalidInputRecords": 1,
"RecordsProcessed": 1,
"RetryAttempts": 0
},
"BulkDeploymentStatus": "Completed",
"CreatedAt": "2019-06-25T16:11:33.265Z",
"tags": {}
}
```
Para obter mais informações, consulte [Criar Implantações em Massa para Grupos](https://docs.aws.amazon.com/greengrass/latest/developerguide/bulk-deploy-cli.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [GetBulkDeploymentStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-bulk-deployment-status.html) na *Referência de comandos da AWS CLI*.
### `get-connectivity-info`
O código de exemplo a seguir mostra como usar `get-connectivity-info`.
**AWS CLI**
**Obter as informações de conectividade de um núcleo Greengrass**
O exemplo `get-connectivity-info` a seguir mostra os endpoints que os dispositivos podem usar para se conectar ao núcleo específico do Greengrass. As informações de conectividade são uma lista de endereços IP ou nomes de domínio, com números de porta correspondentes e metadados opcionais definidos pelo cliente.
```
aws greengrass get-connectivity-info \
--thing-name "MyGroup_Core"
```
Resultado:
```
{
"ConnectivityInfo": [
{
"Metadata": "",
"PortNumber": 8883,
"HostAddress": "127.0.0.1",
"Id": "AUTOIP_127.0.0.1_0"
},
{
"Metadata": "",
"PortNumber": 8883,
"HostAddress": "192.168.1.3",
"Id": "AUTOIP_192.168.1.3_1"
},
{
"Metadata": "",
"PortNumber": 8883,
"HostAddress": "::1",
"Id": "AUTOIP_::1_2"
},
{
"Metadata": "",
"PortNumber": 8883,
"HostAddress": "fe80::1e69:ed93:f5b:f6d",
"Id": "AUTOIP_fe80::1e69:ed93:f5b:f6d_3"
}
]
}
```
+ Para receber detalhes da API, consulte [GetConnectivityInfo](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-connectivity-info.html) na * Referência de comandos da AWS CLI*.
### `get-connector-definition-version`
O código de exemplo a seguir mostra como usar `get-connector-definition-version`.
**AWS CLI**
**Como recuperar informações sobre uma versão específica de uma definição de conector**
O exemplo `get-connector-definition-version` a seguir recupera informações sobre a versão específica de uma dada definição de conector. Para recuperar as IDs de todas as versões da definição do conector, use o `list-connector-definition-versions` comando. Para recuperar a ID da última versão adicionada à definição do conector, use o `get-connector-definition` comando e verifique a `LatestVersion` propriedade.
```
aws greengrass get-connector-definition-version \
--connector-definition-id "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8" \
--connector-definition-version-id "63c57963-c7c2-4a26-a7e2-7bf478ea2623"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8/versions/63c57963-c7c2-4a26-a7e2-7bf478ea2623",
"CreationTimestamp": "2019-06-19T19:30:01.300Z",
"Definition": {
"Connectors": [
{
"ConnectorArn": "arn:aws:greengrass:us-west-2::/connectors/SNS/versions/1",
"Id": "MySNSConnector",
"Parameters": {
"DefaultSNSArn": "arn:aws:sns:us-west-2:123456789012:GGConnectorTopic"
}
}
]
},
"Id": "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8",
"Version": "63c57963-c7c2-4a26-a7e2-7bf478ea2623"
}
```
Para obter mais informações, consulte [Integração com Serviços e Protocolos usando Conectores Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/connectors.html) no **Guia do Desenvolvedor do AWS IoT Greengrass**.
+ Para ver detalhes da API, consulte [GetConnectorDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-connector-definition-version.html) na *Referência de comandos da AWS CLI*.
### `get-connector-definition`
O código de exemplo a seguir mostra como usar `get-connector-definition`.
**AWS CLI**
**Recuperar informações sobre uma definição de conector**
O exemplo `get-connector-definition` a seguir recupera informações sobre a definição do conector específico. Para recuperar as IDs das definições do conector, use o `list-connector-definitions` comando.
```
aws greengrass get-connector-definition \
--connector-definition-id "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8",
"CreationTimestamp": "2019-06-19T19:30:01.300Z",
"Id": "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8",
"LastUpdatedTimestamp": "2019-06-19T19:30:01.300Z",
"LatestVersion": "63c57963-c7c2-4a26-a7e2-7bf478ea2623",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8/versions/63c57963-c7c2-4a26-a7e2-7bf478ea2623",
"Name": "MySNSConnector",
"tags": {}
}
```
Para obter mais informações, consulte [Integração com Serviços e Protocolos usando Conectores Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/connectors.html) no **Guia do Desenvolvedor do AWS IoT Greengrass**.
+ Para ver detalhes da API, consulte [GetConnectorDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-connector-definition.html) na *Referência de comandos da AWS CLI*.
### `get-core-definition-version`
O código de exemplo a seguir mostra como usar `get-core-definition-version`.
**AWS CLI**
**Obter detalhes sobre uma versão específica da definição de núcleo do Greengrass**
O exemplo `get-core-definition-version` a seguir recupera informações sobre a versão específica de uma dada definição de núcleo. Para recuperar os IDs de todas as versões da definição de núcleo, use o `list-core-definition-versions` comando. Para recuperar o ID da última versão adicionada à definição de núcleo, use o `get-core-definition` comando e verifique a `LatestVersion` propriedade.
```
aws greengrass get-core-definition-version \
--core-definition-id "c906ed39-a1e3-4822-a981-7b9bd57b4b46" \
--core-definition-version-id "42aeeac3-fd9d-4312-a8fd-ffa9404a20e0"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/c906ed39-a1e3-4822-a981-7b9bd57b4b46/versions/42aeeac3-fd9d-4312-a8fd-ffa9404a20e0",
"CreationTimestamp": "2019-06-18T16:21:21.351Z",
"Definition": {
"Cores": [
{
"CertificateArn": "arn:aws:iot:us-west-2:123456789012:cert/928dea7b82331b47c3ff77b0e763fc5e64e2f7c884e6ef391baed9b6b8e21b45",
"Id": "1a39aac7-0885-4417-91f6-23e4cea6c511",
"SyncShadow": false,
"ThingArn": "arn:aws:iot:us-west-2:123456789012:thing/GGGroup4Pi3_Core"
}
]
},
"Id": "c906ed39-a1e3-4822-a981-7b9bd57b4b46",
"Version": "42aeeac3-fd9d-4312-a8fd-ffa9404a20e0"
}
```
+ Para ver detalhes da API, consulte [GetCoreDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-core-definition-version.html) na *Referência de comandos da AWS CLI*.
### `get-core-definition`
O código de exemplo a seguir mostra como usar `get-core-definition`.
**AWS CLI**
**Recuperar detalhes de uma definição básica do Greengrass**
O exemplo `get-core-definition` a seguir recupera informações sobre a definição de núcleo específica. Para recuperar as IDs de suas definições de núcleo, use o `list-core-definitions` comando.
```
aws greengrass get-core-definition \
--core-definition-id "c906ed39-a1e3-4822-a981-7b9bd57b4b46"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/237d6916-27cf-457f-ba0c-e86cfb5d25cd",
"CreationTimestamp": "2018-10-18T04:47:06.721Z",
"Id": "237d6916-27cf-457f-ba0c-e86cfb5d25cd",
"LastUpdatedTimestamp": "2018-10-18T04:47:06.721Z",
"LatestVersion": "bd2cd6d4-2bc5-468a-8962-39e071e34b68",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/237d6916-27cf-457f-ba0c-e86cfb5d25cd/versions/bd2cd6d4-2bc5-468a-8962-39e071e34b68",
"tags": {}
}
```
+ Para ver detalhes da API, consulte [GetCoreDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-core-definition.html) na *Referência de comandos da AWS CLI*.
### `get-deployment-status`
O código de exemplo a seguir mostra como usar `get-deployment-status`.
**AWS CLI**
**Recuperar o status de uma implantação**
O exemplo `get-deployment-status` a seguir recupera o status de uma dada implantação do grupo Greengrass específico. Para obter a ID de implantação, use o `list-deployments` comando e especifique o ID do grupo.
```
aws greengrass get-deployment-status \
--group-id "1013db12-8b58-45ff-acc7-704248f66731" \
--deployment-id "1065b8a0-812b-4f21-9d5d-e89b232a530f"
```
Resultado:
```
{
"DeploymentStatus": "Success",
"DeploymentType": "NewDeployment",
"UpdatedAt": "2019-06-18T17:04:44.761Z"
}
```
+ Para receber detalhes da API, consulte [GetDeploymentStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-deployment-status.html) na *AWS CLI Referência de comando*.
### `get-device-definition-version`
O código de exemplo a seguir mostra como usar `get-device-definition-version`.
**AWS CLI**
**Obter uma versão de definição de dispositivo**
O exemplo `get-device-definition-version` a seguir recupera informações sobre a versão específica de uma dada definição de dispositivo. Para recuperar as IDs de todas as versões da definição do dispositivo, use o `list-device-definition-versions` comando. Para recuperar o ID da última versão adicionada à definição do dispositivo, use o `get-device-definition` comando e verifique a `LatestVersion` propriedade.
```
aws greengrass get-device-definition-version \
--device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd" \
--device-definition-version-id "83c13984-6fed-447e-84d5-5b8aa45d5f71"
```
Resultado:
```
{
"Definition": {
"Devices": [
{
"CertificateArn": "arn:aws:iot:us-west-2:123456789012:cert/6c52ce1b47bde88a637e9ccdd45fe4e4c2c0a75a6866f8f63d980ee22fa51e02",
"ThingArn": "arn:aws:iot:us-west-2:123456789012:thing/ExteriorTherm",
"SyncShadow": true,
"Id": "ExteriorTherm"
},
{
"CertificateArn": "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92",
"ThingArn": "arn:aws:iot:us-west-2:123456789012:thing/InteriorTherm",
"SyncShadow": true,
"Id": "InteriorTherm"
}
]
},
"Version": "83c13984-6fed-447e-84d5-5b8aa45d5f71",
"CreationTimestamp": "2019-09-11T00:15:09.838Z",
"Id": "f9ba083d-5ad4-4534-9f86-026a45df1ccd",
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd/versions/83c13984-6fed-447e-84d5-5b8aa45d5f71"
}
```
+ Consulte detalhes da API em [GetDeviceDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-device-definition-version.html) na *AWS CLI Referência de comando*.
### `get-device-definition`
O código de exemplo a seguir mostra como usar `get-device-definition`.
**AWS CLI**
**Obter uma definição de dispositivo**
O exemplo `get-device-definition` a seguir recupera informações sobre a definição do dispositivo específico. Para recuperar os IDs das definições do seu dispositivo, use o `list-device-definitions` comando.
```
aws greengrass get-device-definition \
--device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd"
```
Resultado:
```
{
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd/versions/83c13984-6fed-447e-84d5-5b8aa45d5f71",
"Name": "TemperatureSensors",
"tags": {},
"LastUpdatedTimestamp": "2019-09-11T00:19:03.698Z",
"LatestVersion": "83c13984-6fed-447e-84d5-5b8aa45d5f71",
"CreationTimestamp": "2019-09-11T00:11:06.197Z",
"Id": "f9ba083d-5ad4-4534-9f86-026a45df1ccd",
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd"
}
```
+ Para mais detalhes da API, consulte [GetDeviceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-device-definition.html) na *AWS CLI Referência de comando*.
### `get-function-definition-version`
O código de exemplo a seguir mostra como usar `get-function-definition-version`.
**AWS CLI**
**Recuperar detalhes sobre uma versão específica de uma função do Lambda**
O exemplo `get-function-definition-version` a seguir recupera informações sobre a versão específica de uma dada definição da função. Para recuperar as IDs de todas as versões da definição da função, use o `list-function-definition-versions` comando. Para recuperar a ID da última versão adicionada à definição da função, use o `get-function-definition` comando e verifique a `LatestVersion` propriedade.
```
aws greengrass get-function-definition-version \
--function-definition-id "063f5d1a-1dd1-40b4-9b51-56f8993d0f85" \
--function-definition-version-id "9748fda7-1589-4fcc-ac94-f5559e88678b"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/9748fda7-1589-4fcc-ac94-f5559e88678b",
"CreationTimestamp": "2019-06-18T17:04:30.776Z",
"Definition": {
"Functions": [
{
"FunctionArn": "arn:aws:lambda:::function:GGIPDetector:1",
"FunctionConfiguration": {
"Environment": {},
"MemorySize": 32768,
"Pinned": true,
"Timeout": 3
},
"Id": "26b69bdb-e547-46bc-9812-84ec04b6cc8c"
},
{
"FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld:GG_HelloWorld",
"FunctionConfiguration": {
"EncodingType": "json",
"Environment": {
"Variables": {}
},
"MemorySize": 16384,
"Pinned": true,
"Timeout": 25
},
"Id": "384465a8-eedf-48c6-b793-4c35f7bfae9b"
}
]
},
"Id": "063f5d1a-1dd1-40b4-9b51-56f8993d0f85",
"Version": "9748fda7-1589-4fcc-ac94-f5559e88678b"
}
```
+ Para ver detalhes da API, consulte [GetFunctionDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-function-definition-version.html) na *Referência de comandos da AWS CLI*.
### `get-function-definition`
O código de exemplo a seguir mostra como usar `get-function-definition`.
**AWS CLI**
**Recuperar uma definição de função**
O exemplo `get-function-definition` a seguir exibe os detalhes de uma definição de função específica. Para recuperar as IDs de suas definições de função, use o `list-function-definitions` comando.
```
aws greengrass get-function-definition \
--function-definition-id "063f5d1a-1dd1-40b4-9b51-56f8993d0f85"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85",
"CreationTimestamp": "2019-06-18T16:21:21.431Z",
"Id": "063f5d1a-1dd1-40b4-9b51-56f8993d0f85",
"LastUpdatedTimestamp": "2019-06-18T16:21:21.431Z",
"LatestVersion": "9748fda7-1589-4fcc-ac94-f5559e88678b",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/9748fda7-1589-4fcc-ac94-f5559e88678b",
"tags": {}
}
```
+ Para ver detalhes da API, consulte [GetFunctionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-function-definition.html) na *Referência de comandos da AWS CLI*.
### `get-group-certificate-authority`
O código de exemplo a seguir mostra como usar `get-group-certificate-authority`.
**AWS CLI**
**Recuperar a CA associada a um grupo do Greengrass**
O exemplo `get-group-certificate-authority` a seguir recupera a autoridade de certificação (CA) associada ao grupo Greengrass específico. Para obter a ID da autoridade de certificação, use o `list-group-certificate-authorities` comando e especifique a ID do grupo.
```
aws greengrass get-group-certificate-authority \
--group-id "1013db12-8b58-45ff-acc7-704248f66731" \
--certificate-authority-id "f0430e1736ea8ed30cc5d5de9af67a7e3586bad9ae4d89c2a44163f65fdd8cf6"
```
Resultado:
```
{
"GroupCertificateAuthorityArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/certificateauthorities/f0430e1736ea8ed30cc5d5de9af67a7e3586bad9ae4d89c2a44163f65fdd8cf6",
"GroupCertificateAuthorityId": "f0430e1736ea8ed30cc5d5de9af67a7e3586bad9ae4d89c2a44163f65fdd8cf6",
"PemEncodedCertificate": "-----BEGIN CERTIFICATE-----
MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBWEXAMPLEGA1UEBhMC
VVMxCzAJBgNVBAgTAldBMRAwDEXAMPLEEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6
b24xFDASBgNVBAEXAMPLESBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd
BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jEXAMPLENMTEwNDI1MjA0NTIxWhcN
MTIwNDI0MjA0EXAMPLEBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD
VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWEXAMPLEDASBgNVBAsTC0lBTSBDb25z
b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWEXAMPLEgkqhkiG9w0BCQEWEG5vb25lQGFt
YXpvbi5EXAMPLE8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ
21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CEXAMPLE93vUEIO3IyNoH/f0wYK8m9T
rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswYEXAMPLEgpE
Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKEXAMPLEAQEFBQADgYEAtCu4
nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb
FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb
NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=
-----END CERTIFICATE-----\n"
}
```
+ Para ver detalhes da API, consulte [GetGroupCertificateAuthority](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-group-certificate-authority.html) na *Referência de comandos da AWS CLI*.
### `get-group-certificate-configuration`
O código de exemplo a seguir mostra como usar `get-group-certificate-configuration`.
**AWS CLI**
**Recuperar a configuração da autoridade de certificação usada pelo grupo Greengrass**
O exemplo `get-group-certificate-configuration` a seguir recupera a configuração da autoridade de certificação (CA) usada pelo grupo Greengrass específico.
```
aws greengrass get-group-certificate-configuration \
--group-id "1013db12-8b58-45ff-acc7-704248f66731"
```
Resultado:
```
{
"CertificateAuthorityExpiryInMilliseconds": 2524607999000,
"CertificateExpiryInMilliseconds": 604800000,
"GroupId": "1013db12-8b58-45ff-acc7-704248f66731"
}
```
+ Para ver detalhes da API, consulte [GetGroupCertificateConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-group-certificate-configuration.html) na *Referência de comandos da AWS CLI*.
### `get-group-version`
O código de exemplo a seguir mostra como usar `get-group-version`.
**AWS CLI**
**Recuperar informações sobre uma versão de um grupo do Greengrass**
O exemplo `get-group-version` a seguir recupera informações sobre a versão específica do grupo específico. Para recuperar as IDs de todas as versões do grupo, use o `list-group-versions` comando. Para recuperar a ID da última versão adicionada ao grupo, use o `get-group` comando e verifique a `LatestVersion` propriedade.
```
aws greengrass get-group-version \
--group-id "1013db12-8b58-45ff-acc7-704248f66731" \
--group-version-id "115136b3-cfd7-4462-b77f-8741a4b00e5e"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/115136b3-cfd7-4462-b77f-8741a4b00e5e",
"CreationTimestamp": "2019-06-18T17:04:30.915Z",
"Definition": {
"CoreDefinitionVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/c906ed39-a1e3-4822-a981-7b9bd57b4b46/versions/42aeeac3-fd9d-4312-a8fd-ffa9404a20e0",
"FunctionDefinitionVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/9748fda7-1589-4fcc-ac94-f5559e88678b",
"SubscriptionDefinitionVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152/versions/88ae8699-12ac-4663-ba3f-4d7f0519140b"
},
"Id": "1013db12-8b58-45ff-acc7-704248f66731",
"Version": "115136b3-cfd7-4462-b77f-8741a4b00e5e"
}
```
+ Para ver detalhes da API, consulte [GetGroupVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-group-version.html) na *Referência de comandos da AWS CLI*.
### `get-group`
O código de exemplo a seguir mostra como usar `get-group`.
**AWS CLI**
**Recuperar informações sobre um grupo do Greengrass**
O exemplo `get-group` a seguir recupera informações sobre o grupo Greengrass específico. Para recuperar as IDs dos seus grupos, use o `list-groups` comando.
```
aws greengrass get-group \
--group-id "1013db12-8b58-45ff-acc7-704248f66731"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731",
"CreationTimestamp": "2019-06-18T16:21:21.457Z",
"Id": "1013db12-8b58-45ff-acc7-704248f66731",
"LastUpdatedTimestamp": "2019-06-18T16:21:21.457Z",
"LatestVersion": "115136b3-cfd7-4462-b77f-8741a4b00e5e",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/115136b3-cfd7-4462-b77f-8741a4b00e5e",
"Name": "GGGroup4Pi3",
"tags": {}
}
```
+ Consulte detalhes da API em [GetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-group.html) na *Referência de comandos da AWS CLI*.
### `get-logger-definition-version`
O código de exemplo a seguir mostra como usar `get-logger-definition-version`.
**AWS CLI**
**Recuperar informações sobre uma versão de uma definição de logger**
O exemplo `get-logger-definition-version` a seguir recupera informações sobre a versão específica da definição específica do logger. Para recuperar as IDs de todas as versões da definição do logger, use o `list-logger-definition-versions` comando. Para recuperar a ID da última versão adicionada à definição do logger, use o `get-logger-definition` comando e verifique a `LatestVersion` propriedade.
```
aws greengrass get-logger-definition-version \
--logger-definition-id "49eeeb66-f1d3-4e34-86e3-3617262abf23" \
--logger-definition-version-id "5e3f6f64-a565-491e-8de0-3c0d8e0f2073"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/49eeeb66-f1d3-4e34-86e3-3617262abf23/versions/5e3f6f64-a565-491e-8de0-3c0d8e0f2073",
"CreationTimestamp": "2019-05-08T16:10:13.866Z",
"Definition": {
"Loggers": []
},
"Id": "49eeeb66-f1d3-4e34-86e3-3617262abf23",
"Version": "5e3f6f64-a565-491e-8de0-3c0d8e0f2073"
}
```
+ Consulte detalhes da API em [GetLoggerDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-logger-definition-version.html) na *AWS CLI Referência de comando*.
### `get-logger-definition`
O código de exemplo a seguir mostra como usar `get-logger-definition`.
**AWS CLI**
**Recuperar informações sobre uma definição de logger**
O exemplo `get-logger-definition` a seguir recupera informações sobre a definição de logger específica. Para recuperar as IDs das definições do seu logger, use o `list-logger-definitions` comando.
```
aws greengrass get-logger-definition \
--logger-definition-id "49eeeb66-f1d3-4e34-86e3-3617262abf23"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/49eeeb66-f1d3-4e34-86e3-3617262abf23",
"CreationTimestamp": "2019-05-08T16:10:13.809Z",
"Id": "49eeeb66-f1d3-4e34-86e3-3617262abf23",
"LastUpdatedTimestamp": "2019-05-08T16:10:13.809Z",
"LatestVersion": "5e3f6f64-a565-491e-8de0-3c0d8e0f2073",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/49eeeb66-f1d3-4e34-86e3-3617262abf23/versions/5e3f6f64-a565-491e-8de0-3c0d8e0f2073",
"tags": {}
}
```
+ Para mais detalhes da API, consulte [GetLoggerDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-logger-definition.html) na *AWS CLI Referência de comando*.
### `get-resource-definition-version`
O código de exemplo a seguir mostra como usar `get-resource-definition-version`.
**AWS CLI**
**Recuperar informações sobre uma versão específica de uma definição de recurso**
O exemplo `get-resource-definition-version` a seguir recupera informações sobre a versão específica da definição de recurso específica. Para recuperar as IDs de todas as versões da definição do recurso, use o `list-resource-definition-versions` comando. Para recuperar a ID da última versão adicionada à definição do recurso, use o `get-resource-definition` comando e verifique a `LatestVersion` propriedade.
```
aws greengrass get-resource-definition-version \
--resource-definition-id "ad8c101d-8109-4b0e-b97d-9cc5802ab658" \
--resource-definition-version-id "26e8829a-491a-464d-9c87-664bf6f6f2be"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658/versions/26e8829a-491a-464d-9c87-664bf6f6f2be",
"CreationTimestamp": "2019-06-19T16:40:59.392Z",
"Definition": {
"Resources": [
{
"Id": "26ff3f7b-839a-4217-9fdc-a218308b3963",
"Name": "usb-port",
"ResourceDataContainer": {
"LocalDeviceResourceData": {
"GroupOwnerSetting": {
"AutoAddGroupOwner": false
},
"SourcePath": "/dev/bus/usb"
}
}
}
]
},
"Id": "ad8c101d-8109-4b0e-b97d-9cc5802ab658",
"Version": "26e8829a-491a-464d-9c87-664bf6f6f2be"
}
```
+ Para ver detalhes da API, consulte [GetResourceDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-resource-definition-version.html) na *Referência de comandos da AWS CLI*.
### `get-resource-definition`
O código de exemplo a seguir mostra como usar `get-resource-definition`.
**AWS CLI**
**Recuperar informações sobre uma definição de recurso**
O exemplo `get-resource-definition` a seguir recupera informações sobre a definição do recurso específico. Para recuperar as IDs das suas definições de recursos, use o `list-resource-definitions` comando.
```
aws greengrass get-resource-definition \
--resource-definition-id "ad8c101d-8109-4b0e-b97d-9cc5802ab658"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658",
"CreationTimestamp": "2019-06-19T16:40:59.261Z",
"Id": "ad8c101d-8109-4b0e-b97d-9cc5802ab658",
"LastUpdatedTimestamp": "2019-06-19T16:40:59.261Z",
"LatestVersion": "26e8829a-491a-464d-9c87-664bf6f6f2be",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658/versions/26e8829a-491a-464d-9c87-664bf6f6f2be",
"tags": {}
}
```
+ Para ver detalhes da API, consulte [GetResourceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-resource-definition.html) na *Referência de comandos da AWS CLI*.
### `get-service-role-for-account`
O código de exemplo a seguir mostra como usar `get-service-role-for-account`.
**AWS CLI**
**Recuperar os detalhes do perfil de serviço que está anexado à sua conta**
O exemplo `get-service-role-for-account` a seguir recupera informações sobre o perfil de serviço vinculado à sua conta da AWS.
```
aws greengrass get-service-role-for-account
```
Resultado:
```
{
"AssociatedAt": "2018-10-18T15:59:20Z",
"RoleArn": "arn:aws:iam::123456789012:role/service-role/Greengrass_ServiceRole"
}
```
Para obter mais informações sobre grupos, consulte [Perfil de Serviço do Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/service-role.html) no **Guia do Desenvolvedor do AWS IoT Greengrass**.
+ Para ver detalhes da API, consulte [GetServiceRoleForAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-service-role-for-account.html) na * Referência de comandos da AWS CLI*.
### `get-subscription-definition-version`
O código de exemplo a seguir mostra como usar `get-subscription-definition-version`.
**AWS CLI**
**Recuperar informações sobre uma versão específica de uma definição de assinatura**
O exemplo `get-subscription-definition-version` a seguir recupera informações sobre a versão específica de uma dada definição de assinatura. Para recuperar as IDs de todas as versões da definição de assinatura, use o `list-subscription-definition-versions` comando. Para recuperar a ID da última versão adicionada à definição de assinatura, use o `get-subscription-definition` comando e verifique a `LatestVersion` propriedade.
```
aws greengrass get-subscription-definition-version \
--subscription-definition-id "70e49321-83d5-45d2-bc09-81f4917ae152" \
--subscription-definition-version-id "88ae8699-12ac-4663-ba3f-4d7f0519140b"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152/versions/88ae8699-12ac-4663-ba3f-4d7f0519140b",
"CreationTimestamp": "2019-06-18T17:03:52.499Z",
"Definition": {
"Subscriptions": [
{
"Id": "692c4484-d89f-4f64-8edd-1a041a65e5b6",
"Source": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld:GG_HelloWorld",
"Subject": "hello/world",
"Target": "cloud"
}
]
},
"Id": "70e49321-83d5-45d2-bc09-81f4917ae152",
"Version": "88ae8699-12ac-4663-ba3f-4d7f0519140b"
}
```
+ Para ver detalhes da API, consulte [GetSubscriptionDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-subscription-definition-version.html) na *Referência de comandos da AWS CLI*.
### `get-subscription-definition`
O código de exemplo a seguir mostra como usar `get-subscription-definition`.
**AWS CLI**
**Recuperar informações sobre uma definição de assinatura**
O exemplo `get-subscription-definition` a seguir recupera informações sobre a definição de assinatura específica. Para recuperar as IDs das suas definições de assinatura, use o `list-subscription-definitions` comando.
```
aws greengrass get-subscription-definition \
--subscription-definition-id "70e49321-83d5-45d2-bc09-81f4917ae152"
```
Resultado:
```
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152",
"CreationTimestamp": "2019-06-18T17:03:52.392Z",
"Id": "70e49321-83d5-45d2-bc09-81f4917ae152",
"LastUpdatedTimestamp": "2019-06-18T17:03:52.392Z",
"LatestVersion": "88ae8699-12ac-4663-ba3f-4d7f0519140b",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152/versions/88ae8699-12ac-4663-ba3f-4d7f0519140b",
"tags": {}
}
```
+ Para ver detalhes da API, consulte [GetSubscriptionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-subscription-definition.html) na *Referência de comandos da AWS CLI*.
### `get-thing-runtime-configuration`
O código de exemplo a seguir mostra como usar `get-thing-runtime-configuration`.
**AWS CLI**
**Recuperar a configuração de runtime de um núcleo do Greengrass**
O exemplo `get-thing-runtime-configuration` a seguir recupera a configuração de runtime de um núcleo do Greengrass. Antes de recuperar a configuração de runtime, é preciso usar o `update-thing-runtime-configuration` comando para criar uma configuração de runtime para o núcleo.
```
aws greengrass get-thing-runtime-configuration \
--thing-name SampleGreengrassCore
```
Resultado:
```
{
"RuntimeConfiguration": {
"TelemetryConfiguration": {
"ConfigurationSyncStatus": "OutOfSync",
"Telemetry": "On"
}
}
}
```
Para obter mais informações, consulte [Configuring telemetry settings](https://docs.aws.amazon.com/greengrass/latest/developerguide/telemetry.html#configure-telemetry-settings) no *AWS Guia do Desenvolvedor do IoT Greengrass*.
+ Para ver detalhes da API, consulte [GetThingRuntimeConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-thing-runtime-configuration.html) na *Referência de comandos da AWS CLI*.
### `list-bulk-deployment-detailed-reports`
O código de exemplo a seguir mostra como usar `list-bulk-deployment-detailed-reports`.
**AWS CLI**
**Listar informações sobre implantações individuais em uma implantação em massa**
O exemplo `list-bulk-deployment-detailed-reports` a seguir exibe informações sobre as implantações individuais em uma operação de implantação em massa, incluindo o status.
```
aws greengrass list-bulk-deployment-detailed-reports \
--bulk-deployment-id 42ce9c42-489b-4ed4-b905-8996aa50ef9d
```
Resultado:
```
{
"Deployments": [
{
"DeploymentType": "NewDeployment",
"DeploymentStatus": "Success",
"DeploymentId": "123456789012:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"DeploymentArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/a1b2c3d4-5678-90ab-cdef-EXAMPLE33333/deployments/123456789012:123456789012:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"GroupArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/a1b2c3d4-5678-90ab-cdef-EXAMPLE33333/versions/123456789012:a1b2c3d4-5678-90ab-cdef-EXAMPLE44444",
"CreatedAt": "2020-01-21T21:34:16.501Z"
},
{
"DeploymentType": "NewDeployment",
"DeploymentStatus": "InProgress",
"DeploymentId": "123456789012:a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"DeploymentArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/a1b2c3d4-5678-90ab-cdef-EXAMPLE55555/deployments/123456789012:123456789012:a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"GroupArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/a1b2c3d4-5678-90ab-cdef-EXAMPLE55555/versions/a1b2c3d4-5678-90ab-cdef-EXAMPLE66666",
"CreatedAt": "2020-01-21T21:34:16.486Z"
},
...
]
}
```
Para obter mais informações, consulte [Criar Implantações em Massa para Grupos](https://docs.aws.amazon.com/greengrass/latest/developerguide/bulk-deploy-cli.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [ListBulkDeploymentDetailedReports](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-bulk-deployment-detailed-reports.html) na *Referência de comandos da AWS CLI*.
### `list-bulk-deployments`
O código de exemplo a seguir mostra como usar `list-bulk-deployments`.
**AWS CLI**
**Listar implantações em massa**
O exemplo `list-bulk-deployments` a seguir lista todas as implantações em massa.
```
aws greengrass list-bulk-deployments
```
Resultado:
```
{
"BulkDeployments": [
{
"BulkDeploymentArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/bulk/deployments/870fb41b-6288-4e0c-bc76-a7ba4b4d3267",
"BulkDeploymentId": "870fb41b-6288-4e0c-bc76-a7ba4b4d3267",
"CreatedAt": "2019-06-25T16:11:33.265Z"
}
]
}
```
Para obter mais informações, consulte [Criar Implantações em Massa para Grupos](https://docs.aws.amazon.com/greengrass/latest/developerguide/bulk-deploy-cli.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [ListBulkDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-bulk-deployments.html) na *Referência de comandos da AWS CLI*.
### `list-connector-definition-versions`
O código de exemplo a seguir mostra como usar `list-connector-definition-versions`.
**AWS CLI**
**Listar as versões disponíveis para uma definição de conector**
O exemplo `list-connector-definition-versions` a seguir lista as versões disponíveis para a definição de conector específico. Use o `list-connector-definitions` comando para obter a ID de definição do conector.
```
aws greengrass list-connector-definition-versions \
--connector-definition-id "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8"
```
Resultado:
```
{
"Versions": [
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8/versions/63c57963-c7c2-4a26-a7e2-7bf478ea2623",
"CreationTimestamp": "2019-06-19T19:30:01.300Z",
"Id": "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8",
"Version": "63c57963-c7c2-4a26-a7e2-7bf478ea2623"
}
]
}
```
Para obter mais informações, consulte [Integração com Serviços e Protocolos usando Conectores Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/connectors.html) no **Guia do Desenvolvedor do AWS IoT Greengrass**.
+ Para ver detalhes da API, consulte [ListConnectorDefinitionVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-connector-definition-versions.html) na *Referência de comandos da AWS CLI*.
### `list-connector-definitions`
O código de exemplo a seguir mostra como usar `list-connector-definitions`.
**AWS CLI**
**Listar os conectores do Greengrass que estão definidos**
O exemplo `list-connector-definitions` a seguir lista todos os conectores do Greengrass definidos para sua conta da AWS.
```
aws greengrass list-connector-definitions
```
Resultado:
```
{
"Definitions": [
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8",
"CreationTimestamp": "2019-06-19T19:30:01.300Z",
"Id": "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8",
"LastUpdatedTimestamp": "2019-06-19T19:30:01.300Z",
"LatestVersion": "63c57963-c7c2-4a26-a7e2-7bf478ea2623",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/connectors/b5c4ebfd-f672-49a3-83cd-31c7216a7bb8/versions/63c57963-c7c2-4a26-a7e2-7bf478ea2623",
"Name": "MySNSConnector"
}
]
}
```
Para obter mais informações, consulte [Integração com Serviços e Protocolos usando Conectores Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/connectors.html) no **Guia do Desenvolvedor do AWS IoT Greengrass**.
+ Para ver detalhes da API, consulte [ListConnectorDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-connector-definitions.html) na *Referência de comandos da AWS CLI*.
### `list-core-definition-versions`
O código de exemplo a seguir mostra como usar `list-core-definition-versions`.
**AWS CLI**
**Listar as versões da definição de núcleo do Greengrass**
O exemplo `list-core-definitions` a seguir lista todas as versões da definição do núcleo Greengrass especificado. É possível usar o `list-core-definitions` comando para obter a ID da versão.
```
aws greengrass list-core-definition-versions \
--core-definition-id "eaf280cb-138c-4d15-af36-6f681a1348f7"
```
Resultado:
```
{
"Versions": [
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/eaf280cb-138c-4d15-af36-6f681a1348f7/versions/467c36e4-c5da-440c-a97b-084e62593b4c",
"CreationTimestamp": "2019-06-18T16:14:17.709Z",
"Id": "eaf280cb-138c-4d15-af36-6f681a1348f7",
"Version": "467c36e4-c5da-440c-a97b-084e62593b4c"
}
]
}
```
+ Para ver detalhes da API, consulte [ListCoreDefinitionVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-core-definition-versions.html) na *Referência de comandos da AWS CLI*.
### `list-core-definitions`
O código de exemplo a seguir mostra como usar `list-core-definitions`.
**AWS CLI**
**Listar as definições de núcleo do Greengrass**
O exemplo `list-core-definitions` a seguir lista todas as definições de núcleo do Greengrass para sua conta da AWS.
```
aws greengrass list-core-definitions
```
Resultado:
```
{
"Definitions": [
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/0507843c-c1ef-4f06-b051-817030df7e7d",
"CreationTimestamp": "2018-10-17T04:30:32.786Z",
"Id": "0507843c-c1ef-4f06-b051-817030df7e7d",
"LastUpdatedTimestamp": "2018-10-17T04:30:32.786Z",
"LatestVersion": "bcdf9e86-3793-491e-93af-3cdfbf4e22b7",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/0507843c-c1ef-4f06-b051-817030df7e7d/versions/bcdf9e86-3793-491e-93af-3cdfbf4e22b7"
},
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/31c22500-3509-4271-bafd-cf0655cda438",
"CreationTimestamp": "2019-06-18T16:24:16.064Z",
"Id": "31c22500-3509-4271-bafd-cf0655cda438",
"LastUpdatedTimestamp": "2019-06-18T16:24:16.064Z",
"LatestVersion": "2f350395-6d09-4c8a-8336-9ae5b57ace84",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/31c22500-3509-4271-bafd-cf0655cda438/versions/2f350395-6d09-4c8a-8336-9ae5b57ace84"
},
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/c906ed39-a1e3-4822-a981-7b9bd57b4b46",
"CreationTimestamp": "2019-06-18T16:21:21.351Z",
"Id": "c906ed39-a1e3-4822-a981-7b9bd57b4b46",
"LastUpdatedTimestamp": "2019-06-18T16:21:21.351Z",
"LatestVersion": "42aeeac3-fd9d-4312-a8fd-ffa9404a20e0",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/c906ed39-a1e3-4822-a981-7b9bd57b4b46/versions/42aeeac3-fd9d-4312-a8fd-ffa9404a20e0"
},
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/eaf280cb-138c-4d15-af36-6f681a1348f7",
"CreationTimestamp": "2019-06-18T16:14:17.709Z",
"Id": "eaf280cb-138c-4d15-af36-6f681a1348f7",
"LastUpdatedTimestamp": "2019-06-18T16:14:17.709Z",
"LatestVersion": "467c36e4-c5da-440c-a97b-084e62593b4c",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/cores/eaf280cb-138c-4d15-af36-6f681a1348f7/versions/467c36e4-c5da-440c-a97b-084e62593b4c"
}
]
}
```
+ Para ver detalhes da API, consulte [ListCoreDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-core-definitions.html) na *Referência de comandos da AWS CLI*.
### `list-deployments`
O código de exemplo a seguir mostra como usar `list-deployments`.
**AWS CLI**
**Listar as implantações de um grupo do Greengrass**
O exemplo `list-deployments` a seguir lista as implantações do grupo Greengrass específico. É possível usar o comando `list-groups` para procurar sua ID de grupo.
```
aws greengrass list-deployments \
--group-id "1013db12-8b58-45ff-acc7-704248f66731"
```
Resultado:
```
{
"Deployments": [
{
"CreatedAt": "2019-06-18T17:04:32.702Z",
"DeploymentId": "1065b8a0-812b-4f21-9d5d-e89b232a530f",
"DeploymentType": "NewDeployment",
"GroupArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/115136b3-cfd7-4462-b77f-8741a4b00e5e"
}
]
}
```
+ Para ver detalhes da API, consulte [ListDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-deployments.html) na *Referência de comandos da AWS CLI*.
### `list-device-definition-versions`
O código de exemplo a seguir mostra como usar `list-device-definition-versions`.
**AWS CLI**
**Listar as versões de uma definição de dispositivo**
O exemplo `list-device-definition-versions` a seguir exibe as versões da definição de dispositivo associadas à definição de dispositivo específica.
```
aws greengrass list-device-definition-versions \
--device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd"
```
Resultado:
```
{
"Versions": [
{
"Version": "83c13984-6fed-447e-84d5-5b8aa45d5f71",
"CreationTimestamp": "2019-09-11T00:15:09.838Z",
"Id": "f9ba083d-5ad4-4534-9f86-026a45df1ccd",
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd/versions/83c13984-6fed-447e-84d5-5b8aa45d5f71"
},
{
"Version": "3b5cc510-58c1-44b5-9d98-4ad858ffa795",
"CreationTimestamp": "2019-09-11T00:11:06.197Z",
"Id": "f9ba083d-5ad4-4534-9f86-026a45df1ccd",
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd/versions/3b5cc510-58c1-44b5-9d98-4ad858ffa795"
}
]
}
```
+ Para ver detalhes da API, consulte [ListDeviceDefinitionVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-device-definition-versions.html) na *Referência de comandos da AWS CLI*.
### `list-device-definitions`
O código de exemplo a seguir mostra como usar `list-device-definitions`.
**AWS CLI**
**Listar as definições do seu dispositivo**
O exemplo `list-device-definitions` a seguir exibe detalhes sobre as definições do dispositivo em sua conta AWS na região da AWS especificada.
```
aws greengrass list-device-definitions \
--region us-west-2
```
Resultado:
```
{
"Definitions": [
{
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/50f3274c-3f0a-4f57-b114-6f46085281ab/versions/c777b0f5-1059-449b-beaa-f003ebc56c34",
"LastUpdatedTimestamp": "2019-06-14T15:42:09.059Z",
"LatestVersion": "c777b0f5-1059-449b-beaa-f003ebc56c34",
"CreationTimestamp": "2019-06-14T15:42:09.059Z",
"Id": "50f3274c-3f0a-4f57-b114-6f46085281ab",
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/50f3274c-3f0a-4f57-b114-6f46085281ab"
},
{
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/e01951c9-6134-479a-969a-1a15cac11c40/versions/514d57aa-4ee6-401c-9fac-938a9f7a51e5",
"Name": "TestDeviceDefinition",
"LastUpdatedTimestamp": "2019-04-16T23:17:43.245Z",
"LatestVersion": "514d57aa-4ee6-401c-9fac-938a9f7a51e5",
"CreationTimestamp": "2019-04-16T23:17:43.245Z",
"Id": "e01951c9-6134-479a-969a-1a15cac11c40",
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/e01951c9-6134-479a-969a-1a15cac11c40"
},
{
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd/versions/83c13984-6fed-447e-84d5-5b8aa45d5f71",
"Name": "TemperatureSensors",
"LastUpdatedTimestamp": "2019-09-10T00:19:03.698Z",
"LatestVersion": "83c13984-6fed-447e-84d5-5b8aa45d5f71",
"CreationTimestamp": "2019-09-11T00:11:06.197Z",
"Id": "f9ba083d-5ad4-4534-9f86-026a45df1ccd",
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/devices/f9ba083d-5ad4-4534-9f86-026a45df1ccd"
}
]
}
```
+ Para ver detalhes da API, consulte [ListDeviceDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-device-definitions.html) na *Referência de comandos da AWS CLI*.
### `list-function-definition-versions`
O código de exemplo a seguir mostra como usar `list-function-definition-versions`.
**AWS CLI**
**Listar as versões de uma função do Lambda**
O exemplo `list-function-definition-versions` a seguir lista todas as versões da função do Lambda específica. É possível usar o comando `list-function-definitions` para obter a ID.
```
aws greengrass list-function-definition-versions \
--function-definition-id "063f5d1a-1dd1-40b4-9b51-56f8993d0f85"
```
Resultado:
```
{
"Versions": [
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/9748fda7-1589-4fcc-ac94-f5559e88678b",
"CreationTimestamp": "2019-06-18T17:04:30.776Z",
"Id": "063f5d1a-1dd1-40b4-9b51-56f8993d0f85",
"Version": "9748fda7-1589-4fcc-ac94-f5559e88678b"
},
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/9b08df77-26f2-4c29-93d2-769715edcfec",
"CreationTimestamp": "2019-06-18T17:02:44.087Z",
"Id": "063f5d1a-1dd1-40b4-9b51-56f8993d0f85",
"Version": "9b08df77-26f2-4c29-93d2-769715edcfec"
},
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/4236239f-94f7-4b90-a2f8-2a24c829d21e",
"CreationTimestamp": "2019-06-18T17:01:42.284Z",
"Id": "063f5d1a-1dd1-40b4-9b51-56f8993d0f85",
"Version": "4236239f-94f7-4b90-a2f8-2a24c829d21e"
},
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/343408bb-549a-4fbe-b043-853643179a39",
"CreationTimestamp": "2019-06-18T16:21:21.431Z",
"Id": "063f5d1a-1dd1-40b4-9b51-56f8993d0f85",
"Version": "343408bb-549a-4fbe-b043-853643179a39"
}
]
}
```
+ Para ver detalhes da API, consulte [ListFunctionDefinitionVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-function-definition-versions.html) na *Referência de comandos da AWS CLI*.
### `list-function-definitions`
O código de exemplo a seguir mostra como usar `list-function-definitions`.
**AWS CLI**
**Listar funções do Lambda**
O exemplo `list-function-definitions` a seguir lista todas as funções do Lambda definidas para sua conta da AWS.
```
aws greengrass list-function-definitions
```
Resultado:
```
{
"Definitions": [
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/017970a5-8952-46dd-b1c1-020b3ae8e960",
"CreationTimestamp": "2018-10-17T04:30:32.884Z",
"Id": "017970a5-8952-46dd-b1c1-020b3ae8e960",
"LastUpdatedTimestamp": "2018-10-17T04:30:32.884Z",
"LatestVersion": "4380b302-790d-4ed8-92bf-02e88afecb15",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/017970a5-8952-46dd-b1c1-020b3ae8e960/versions/4380b302-790d-4ed8-92bf-02e88afecb15"
},
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85",
"CreationTimestamp": "2019-06-18T16:21:21.431Z",
"Id": "063f5d1a-1dd1-40b4-9b51-56f8993d0f85",
"LastUpdatedTimestamp": "2019-06-18T16:21:21.431Z",
"LatestVersion": "9748fda7-1589-4fcc-ac94-f5559e88678b",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/063f5d1a-1dd1-40b4-9b51-56f8993d0f85/versions/9748fda7-1589-4fcc-ac94-f5559e88678b"
},
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/6598e653-a262-440c-9967-e2697f64da7b",
"CreationTimestamp": "2019-06-18T16:24:16.123Z",
"Id": "6598e653-a262-440c-9967-e2697f64da7b",
"LastUpdatedTimestamp": "2019-06-18T16:24:16.123Z",
"LatestVersion": "38bc6ccd-98a2-4ce7-997e-16c84748fae4",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/6598e653-a262-440c-9967-e2697f64da7b/versions/38bc6ccd-98a2-4ce7-997e-16c84748fae4"
},
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/c668df84-fad2-491b-95f4-655d2cad7885",
"CreationTimestamp": "2019-06-18T16:14:17.784Z",
"Id": "c668df84-fad2-491b-95f4-655d2cad7885",
"LastUpdatedTimestamp": "2019-06-18T16:14:17.784Z",
"LatestVersion": "37dd68c4-a64f-40ba-aa13-71fecc3ebded",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/c668df84-fad2-491b-95f4-655d2cad7885/versions/37dd68c4-a64f-40ba-aa13-71fecc3ebded"
}
]
}
```
+ Para ver detalhes da API, consulte [ListFunctionDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-function-definitions.html) na *Referência de comandos da AWS CLI*.
### `list-group-certificate-authorities`
O código de exemplo a seguir mostra como usar `list-group-certificate-authorities`.
**AWS CLI**
**Listar as CAs atuais de grupo**
O exemplo `list-group-certificate-authorities` a seguir lista as autoridades de certificação (CAs) atuais do grupo Greengrass especificado.
```
aws greengrass list-group-certificate-authorities \
--group-id "1013db12-8b58-45ff-acc7-704248f66731"
```
Resultado:
```
{
"GroupCertificateAuthorities": [
{
"GroupCertificateAuthorityArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/certificateauthorities/f0430e1736ea8ed30cc5d5de9af67a7e3586bad9ae4d89c2a44163f65fdd8cf6",
"GroupCertificateAuthorityId": "f0430e1736ea8ed30cc5d5de9af67a7e3586bad9ae4d89c2a44163f65fdd8cf6"
}
]
}
```
+ Para ver detalhes da API, consulte [ListGroupCertificateAuthorities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-group-certificate-authorities.html) na *Referência de comandos da AWS CLI*.
### `list-group-versions`
O código de exemplo a seguir mostra como usar `list-group-versions`.
**AWS CLI**
**Listar as versões de um grupo do Greengrass**
O exemplo `list-group-versions` a seguir lista as versões do grupo Greengrass especificado.
```
aws greengrass list-group-versions \
--group-id "1013db12-8b58-45ff-acc7-704248f66731"
```
Resultado:
```
{
"Versions": [
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/115136b3-cfd7-4462-b77f-8741a4b00e5e",
"CreationTimestamp": "2019-06-18T17:04:30.915Z",
"Id": "1013db12-8b58-45ff-acc7-704248f66731",
"Version": "115136b3-cfd7-4462-b77f-8741a4b00e5e"
},
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/4340669d-d14d-44e3-920c-46c928750750",
"CreationTimestamp": "2019-06-18T17:03:52.663Z",
"Id": "1013db12-8b58-45ff-acc7-704248f66731",
"Version": "4340669d-d14d-44e3-920c-46c928750750"
},
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/1b06e099-2d5b-4f10-91b9-78c4e060f5da",
"CreationTimestamp": "2019-06-18T17:02:44.189Z",
"Id": "1013db12-8b58-45ff-acc7-704248f66731",
"Version": "1b06e099-2d5b-4f10-91b9-78c4e060f5da"
},
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/2d3f27f1-3b43-4554-ab7a-73ec30477efe",
"CreationTimestamp": "2019-06-18T17:01:42.401Z",
"Id": "1013db12-8b58-45ff-acc7-704248f66731",
"Version": "2d3f27f1-3b43-4554-ab7a-73ec30477efe"
},
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/d20f7ae9-3444-4c1c-b025-e2ede23cdd31",
"CreationTimestamp": "2019-06-18T16:21:21.457Z",
"Id": "1013db12-8b58-45ff-acc7-704248f66731",
"Version": "d20f7ae9-3444-4c1c-b025-e2ede23cdd31"
}
]
}
```
+ Para ver detalhes da API, consulte [ListGroupVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-group-versions.html) na *Referência de comandos da AWS CLI*.
### `list-groups`
O código de exemplo a seguir mostra como usar `list-groups`.
**AWS CLI**
**Listar os grupos do Greengrass**
O exemplo `list-groups` a seguir lista todos os grupos do Greengrass definidos em sua conta da AWS.
```
aws greengrass list-groups
```
Resultado:
```
{
"Groups": [
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731",
"CreationTimestamp": "2019-06-18T16:21:21.457Z",
"Id": "1013db12-8b58-45ff-acc7-704248f66731",
"LastUpdatedTimestamp": "2019-06-18T16:21:21.457Z",
"LatestVersion": "115136b3-cfd7-4462-b77f-8741a4b00e5e",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/versions/115136b3-cfd7-4462-b77f-8741a4b00e5e",
"Name": "GGGroup4Pi3"
},
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1402daf9-71cf-4cfe-8be0-d5e80526d0d8",
"CreationTimestamp": "2018-10-31T21:52:46.603Z",
"Id": "1402daf9-71cf-4cfe-8be0-d5e80526d0d8",
"LastUpdatedTimestamp": "2018-10-31T21:52:46.603Z",
"LatestVersion": "749af901-60ab-456f-a096-91b12d983c29",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1402daf9-71cf-4cfe-8be0-d5e80526d0d8/versions/749af901-60ab-456f-a096-91b12d983c29",
"Name": "MyTestGroup"
},
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/504b5c8d-bbed-4635-aff1-48ec5b586db5",
"CreationTimestamp": "2018-12-31T21:39:36.771Z",
"Id": "504b5c8d-bbed-4635-aff1-48ec5b586db5",
"LastUpdatedTimestamp": "2018-12-31T21:39:36.771Z",
"LatestVersion": "46911e8e-f9bc-4898-8b63-59c7653636ec",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/504b5c8d-bbed-4635-aff1-48ec5b586db5/versions/46911e8e-f9bc-4898-8b63-59c7653636ec",
"Name": "smp-ggrass-group"
}
]
}
```
+ Consulte detalhes da API em [ListGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-groups.html) na *Referência de comandos da AWS CLI*.
### `list-logger-definition-versions`
O código de exemplo a seguir mostra como usar `list-logger-definition-versions`.
**AWS CLI**
**Obter uma lista de versões da definição de um logger**
O exemplo `list-logger-definition-versions` a seguir obtém uma lista de todas as versões da definição de logger específico.
```
aws greengrass list-logger-definition-versions \
--logger-definition-id "49eeeb66-f1d3-4e34-86e3-3617262abf23"
```
Resultado:
```
{
"Versions": [
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/49eeeb66-f1d3-4e34-86e3-3617262abf23/versions/5e3f6f64-a565-491e-8de0-3c0d8e0f2073",
"CreationTimestamp": "2019-05-08T16:10:13.866Z",
"Id": "49eeeb66-f1d3-4e34-86e3-3617262abf23",
"Version": "5e3f6f64-a565-491e-8de0-3c0d8e0f2073"
},
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/49eeeb66-f1d3-4e34-86e3-3617262abf23/versions/3ec6d3af-eb85-48f9-a16d-1c795fe696d7",
"CreationTimestamp": "2019-05-08T16:10:13.809Z",
"Id": "49eeeb66-f1d3-4e34-86e3-3617262abf23",
"Version": "3ec6d3af-eb85-48f9-a16d-1c795fe696d7"
}
]
}
```
+ Para ver detalhes da API, consulte [ListLoggerDefinitionVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-logger-definition-versions.html) na *Referência de comandos da AWS CLI*.
### `list-logger-definitions`
O código de exemplo a seguir mostra como usar `list-logger-definitions`.
**AWS CLI**
**Obter uma lista de definições de logger**
O exemplo `list-logger-definitions` a seguir lista todas as definições de logger da sua conta da AWS.
```
aws greengrass list-logger-definitions
```
Resultado:
```
{
"Definitions": [
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/49eeeb66-f1d3-4e34-86e3-3617262abf23",
"CreationTimestamp": "2019-05-08T16:10:13.809Z",
"Id": "49eeeb66-f1d3-4e34-86e3-3617262abf23",
"LastUpdatedTimestamp": "2019-05-08T16:10:13.809Z",
"LatestVersion": "5e3f6f64-a565-491e-8de0-3c0d8e0f2073",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/loggers/49eeeb66-f1d3-4e34-86e3-3617262abf23/versions/5e3f6f64-a565-491e-8de0-3c0d8e0f2073"
}
]
}
```
+ Para ver detalhes da API, consulte [ListLoggerDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-logger-definitions.html) na *Referência de comandos da AWS CLI*.
### `list-resource-definition-versions`
O código de exemplo a seguir mostra como usar `list-resource-definition-versions`.
**AWS CLI**
**Listar as versões de uma definição de recurso**
O exemplo `list-resource-definition-versions` a seguir lista as versões do recurso Greengrass específico.
```
aws greengrass list-resource-definition-versions \
--resource-definition-id "ad8c101d-8109-4b0e-b97d-9cc5802ab658"
```
Resultado:
```
{
"Versions": [
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658/versions/26e8829a-491a-464d-9c87-664bf6f6f2be",
"CreationTimestamp": "2019-06-19T16:40:59.392Z",
"Id": "ad8c101d-8109-4b0e-b97d-9cc5802ab658",
"Version": "26e8829a-491a-464d-9c87-664bf6f6f2be"
},
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658/versions/432d92f6-12de-4ec9-a704-619a942a62aa",
"CreationTimestamp": "2019-06-19T16:40:59.261Z",
"Id": "ad8c101d-8109-4b0e-b97d-9cc5802ab658",
"Version": "432d92f6-12de-4ec9-a704-619a942a62aa"
}
]
}
```
+ Para ver detalhes da API, consulte [ListResourceDefinitionVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-resource-definition-versions.html) na *Referência de comandos da AWS CLI*.
### `list-resource-definitions`
O código de exemplo a seguir mostra como usar `list-resource-definitions`.
**AWS CLI**
**Listar os recursos que estão definidos**
O exemplo `list-resource-definitions` a seguir lista os recursos definidos para serem usados pelo AWS IoT Greengrass.
```
aws greengrass list-resource-definitions
```
Resultado:
```
{
"Definitions": [
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658",
"CreationTimestamp": "2019-06-19T16:40:59.261Z",
"Id": "ad8c101d-8109-4b0e-b97d-9cc5802ab658",
"LastUpdatedTimestamp": "2019-06-19T16:40:59.261Z",
"LatestVersion": "26e8829a-491a-464d-9c87-664bf6f6f2be",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658/versions/26e8829a-491a-464d-9c87-664bf6f6f2be"
},
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/c8bb9ebc-c3fd-40a4-9c6a-568d75569d38",
"CreationTimestamp": "2019-06-19T21:51:28.212Z",
"Id": "c8bb9ebc-c3fd-40a4-9c6a-568d75569d38",
"LastUpdatedTimestamp": "2019-06-19T21:51:28.212Z",
"LatestVersion": "a5f94d0b-f6bc-40f4-bb78-7a1c5fe13ba1",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/c8bb9ebc-c3fd-40a4-9c6a-568d75569d38/versions/a5f94d0b-f6bc-40f4-bb78-7a1c5fe13ba1",
"Name": "MyGreengrassResources"
}
]
}
```
+ Para ver detalhes da API, consulte [ListResourceDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-resource-definitions.html) na *Referência de comandos da AWS CLI*.
### `list-subscription-definition-versions`
O código de exemplo a seguir mostra como usar `list-subscription-definition-versions`.
**AWS CLI**
**Listar as versões de uma definição de assinatura**
O exemplo `list-subscription-definition-versions` a seguir lista todas as versões das assinaturas específicas. Você pode usar o `list-subscription-definitions` comando para pesquisar a ID da assinatura.
```
aws greengrass list-subscription-definition-versions \
--subscription-definition-id "70e49321-83d5-45d2-bc09-81f4917ae152"
```
Resultado:
```
{
"Versions": [
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152/versions/88ae8699-12ac-4663-ba3f-4d7f0519140b",
"CreationTimestamp": "2019-06-18T17:03:52.499Z",
"Id": "70e49321-83d5-45d2-bc09-81f4917ae152",
"Version": "88ae8699-12ac-4663-ba3f-4d7f0519140b"
},
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152/versions/7e320ba3-c369-4069-a2f0-90acb7f219d6",
"CreationTimestamp": "2019-06-18T17:03:52.392Z",
"Id": "70e49321-83d5-45d2-bc09-81f4917ae152",
"Version": "7e320ba3-c369-4069-a2f0-90acb7f219d6"
}
]
}
```
+ Para ver detalhes da API, consulte [ListSubscriptionDefinitionVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-subscription-definition-versions.html) na *Referência de comandos da AWS CLI*.
### `list-subscription-definitions`
O código de exemplo a seguir mostra como usar `list-subscription-definitions`.
**AWS CLI**
**Obter uma lista de definições de assinatura**
O exemplo `list-subscription-definitions` a seguir lista todas as assinaturas do AWS IoT Greengrass definidas em sua conta da AWS.
```
aws greengrass list-subscription-definitions
```
Resultado:
```
{
"Definitions": [
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152",
"CreationTimestamp": "2019-06-18T17:03:52.392Z",
"Id": "70e49321-83d5-45d2-bc09-81f4917ae152",
"LastUpdatedTimestamp": "2019-06-18T17:03:52.392Z",
"LatestVersion": "88ae8699-12ac-4663-ba3f-4d7f0519140b",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/70e49321-83d5-45d2-bc09-81f4917ae152/versions/88ae8699-12ac-4663-ba3f-4d7f0519140b"
},
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/cd6f1c37-d9a4-4e90-be94-01a7404f5967",
"CreationTimestamp": "2018-10-18T15:45:34.024Z",
"Id": "cd6f1c37-d9a4-4e90-be94-01a7404f5967",
"LastUpdatedTimestamp": "2018-10-18T15:45:34.024Z",
"LatestVersion": "d1cf8fac-284f-4f6a-98fe-a2d36d089373",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/cd6f1c37-d9a4-4e90-be94-01a7404f5967/versions/d1cf8fac-284f-4f6a-98fe-a2d36d089373"
},
{
"Arn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/fa81bc84-3f59-4377-a84b-5d0134da359b",
"CreationTimestamp": "2018-10-22T17:09:31.429Z",
"Id": "fa81bc84-3f59-4377-a84b-5d0134da359b",
"LastUpdatedTimestamp": "2018-10-22T17:09:31.429Z",
"LatestVersion": "086d1b08-b25a-477c-a16f-6f9b3a9c295a",
"LatestVersionArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/subscriptions/fa81bc84-3f59-4377-a84b-5d0134da359b/versions/086d1b08-b25a-477c-a16f-6f9b3a9c295a"
}
]
}
```
+ Para ver detalhes da API, consulte [ListSubscriptionDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-subscription-definitions.html) na *Referência de comandos da AWS CLI*.
### `list-tags-for-resource`
O código de exemplo a seguir mostra como usar `list-tags-for-resource`.
**AWS CLI**
**Listar as marcas anexadas a um recurso**
O exemplo `list-tags-for-resource` a seguir lista as marcas e seus valores anexados ao recurso específico.
```
aws greengrass list-tags-for-resource \
--resource-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658"
```
Resultado:
```
{
"tags": {
"ResourceSubType": "USB",
"ResourceType": "Device"
}
}
```
Para obter mais informações, consulte [Como Marcar seus Recursos Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/tagging.html) no **Guia do Desenvolvedor do AWS IoT Greengrass**.
+ Para obter detalhes sobre a API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-tags-for-resource.html) na *AWS CLI Command Reference*.
### `reset-deployments`
O código de exemplo a seguir mostra como usar `reset-deployments`.
**AWS CLI**
**Limpar as informações de implantação de um grupo do Greengrass**
O exemplo `reset-deployments` a seguir limpa as informações de implantação do grupo Greengrass específico. Quando se adiciona o `--force option`, as informações de implantação são redefinidas sem esperar que o dispositivo principal responda.
```
aws greengrass reset-deployments \
--group-id "1402daf9-71cf-4cfe-8be0-d5e80526d0d8" \
--force
```
Resultado:
```
{
"DeploymentArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1402daf9-71cf-4cfe-8be0-d5e80526d0d8/deployments/7dd4e356-9882-46a3-9e28-6d21900c011a",
"DeploymentId": "7dd4e356-9882-46a3-9e28-6d21900c011a"
}
```
Para obter mais informações, consulte [Resetar Implantações](https://docs.aws.amazon.com/greengrass/latest/developerguide/reset-deployments-scenario.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [ResetDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/reset-deployments.html) na *Referência de comandos da AWS CLI*.
### `start-bulk-deployment`
O código de exemplo a seguir mostra como usar `start-bulk-deployment`.
**AWS CLI**
**Iniciar uma operação de implantação em massa**
O exemplo `start-bulk-deployment` a seguir inicia uma operação de implantação em massa, usando um arquivo armazenado em um bucket S3 para especificar os grupos a serem implantados.
```
aws greengrass start-bulk-deployment \
--cli-input-json "{\"InputFileUri\":\"https://gg-group-deployment1.s3-us-west-2.amazonaws.com/MyBulkDeploymentInputFile.txt\", \"ExecutionRoleArn\":\"arn:aws:iam::123456789012:role/ggCreateDeploymentRole\",\"AmznClientToken\":\"yourAmazonClientToken\"}"
```
Resultado:
```
{
"BulkDeploymentArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/bulk/deployments/870fb41b-6288-4e0c-bc76-a7ba4b4d3267",
"BulkDeploymentId": "870fb41b-6288-4e0c-bc76-a7ba4b4d3267"
}
```
Para obter mais informações, consulte [Criar Implantações em Massa para Grupos](https://docs.aws.amazon.com/greengrass/latest/developerguide/bulk-deploy-cli.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para obter detalhes sobre a API, consulte [StartBulkDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/start-bulk-deployment.html) na *AWS CLI Referência de comando*.
### `stop-bulk-deployment`
O código de exemplo a seguir mostra como usar `stop-bulk-deployment`.
**AWS CLI**
**Interromper uma implantação em massa**
O exemplo `stop-bulk-deployment` a seguir interrompe a implantação em massa específica. Ao tentar interromper uma implantação em massa que foi concluída, ocorrerá um erro: `InvalidInputException: Cannot change state of finished execution.`
```
aws greengrass stop-bulk-deployment \
--bulk-deployment-id "870fb41b-6288-4e0c-bc76-a7ba4b4d3267"
```
Este comando não produz saída.
Para obter mais informações, consulte [Criar Implantações em Massa para Grupos](https://docs.aws.amazon.com/greengrass/latest/developerguide/bulk-deploy-cli.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [StopBulkDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/stop-bulk-deployment.html) na *Referência de comandos da AWS CLI*.
### `tag-resource`
O código de exemplo a seguir mostra como usar `tag-resource`.
**AWS CLI**
**Aplicar marcas a um recurso**
O exemplo `tag-resource` a seguir aplica duas marcas, `ResourceType` e `ResourceSubType`, ao recurso Greengrass específico. Essa operação pode adicionar novas marcas e valores ou atualizar o valor das marcas existentes. Para remover uma marca, use o comando `untag-resource`.
```
aws greengrass tag-resource \
--resource-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658" \
--tags "ResourceType=Device,ResourceSubType=USB"
```
Este comando não produz saída.
Para obter mais informações, consulte [Como Marcar seus Recursos Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/tagging.html) no **Guia do Desenvolvedor do AWS IoT Greengrass**.
+ Consulte detalhes da API em [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/tag-resource.html) na *Referência de comandos da AWS CLI*.
### `untag-resource`
O código de exemplo a seguir mostra como usar `untag-resource`.
**AWS CLI**
**Remover uma marca e seu valor de um recurso**
O exemplo `untag-resource` a seguir remove a marca, cuja chave é `Category`, do grupo Greengrass específico. Se a chave `Category` não existir para o recurso especificado, não haverá mensagem de erro.
```
aws greengrass untag-resource \
--resource-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731" \
--tag-keys "Category"
```
Este comando não produz saída.
Para obter mais informações, consulte [Como Marcar seus Recursos Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/tagging.html) no **Guia do Desenvolvedor do AWS IoT Greengrass**.
+ Para obter detalhes sobre a API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/untag-resource.html) na *Referência de comandos da AWS CLI*.
### `update-connectivity-info`
O código de exemplo a seguir mostra como usar `update-connectivity-info`.
**AWS CLI**
**Atualizar as informações de conectividade para um núcleo do Greengrass **
O exemplo `update-connectivity-info` a seguir altera os endpoints que os dispositivos podem usar para se conectar ao núcleo específico do Greengrass. As informações de conectividade são uma lista de endereços IP ou nomes de domínio, com números de porta correspondentes e metadados opcionais definidos pelo cliente. Talvez seja necessário atualizar as informações de conectividade quando a rede local mudar.
```
aws greengrass update-connectivity-info \
--thing-name "MyGroup_Core" \
--connectivity-info "[{\"Metadata\":\"\",\"PortNumber\":8883,\"HostAddress\":\"127.0.0.1\",\"Id\":\"localhost_127.0.0.1_0\"},{\"Metadata\":\"\",\"PortNumber\":8883,\"HostAddress\":\"192.168.1.3\",\"Id\":\"localIP_192.168.1.3\"}]"
```
Resultado:
```
{
"Version": "312de337-59af-4cf9-a278-2a23bd39c300"
}
```
+ Para ver detalhes da API, consulte [UpdateConnectivityInfo](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-connectivity-info.html) na * Referência de comandos da AWS CLI*.
### `update-connector-definition`
O código de exemplo a seguir mostra como usar `update-connector-definition`.
**AWS CLI**
**Atualizar o nome de uma definição de conector**
O exemplo `update-connector-definition` a seguir atualiza o nome da definição do conector específico. Se desejar atualizar os detalhes do conector, use o `create-connector-definition-version` comando para criar uma nova versão.
```
aws greengrass update-connector-definition \
--connector-definition-id "55d0052b-0d7d-44d6-b56f-21867215e118" \
--name "GreengrassConnectors2019"
```
Para obter mais informações, consulte [Integração com Serviços e Protocolos usando Conectores](https://docs.aws.amazon.com/greengrass/latest/developerguide/connectors.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [UpdateConnectorDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-connector-definition.html) na *Referência de comandos da AWS CLI*.
### `update-core-definition`
O código de exemplo a seguir mostra como usar `update-core-definition`.
**AWS CLI**
**Atualizar uma definição de núcleo**
O exemplo `update-core-definition` a seguir altera o nome da definição do núcleo específico. Só é possível atualizar a propriedade `name` de uma definição de núcleo.
```
aws greengrass update-core-definition \
--core-definition-id "582efe12-b05a-409e-9a24-a2ba1bcc4a12" \
--name "MyCoreDevices"
```
Este comando não produz saída.
Para obter mais informações, consulte [Configurar AWS IoT Greengrass Core](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-core.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [UpdateCoreDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-core-definition.html) na *Referência de comandos da AWS CLI*.
### `update-device-definition`
O código de exemplo a seguir mostra como usar `update-device-definition`.
**AWS CLI**
**Atualizar uma definição de dispositivo**
O exemplo `update-device-definition` a seguir altera o nome da definição do dispositivo específico. Só é possível atualizar a propriedade `name` de uma definição de dispositivo.
```
aws greengrass update-device-definition \
--device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd" \
--name "TemperatureSensors"
```
Este comando não produz saída.
+ Para ver detalhes da API, consulte [UpdateDeviceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-device-definition.html) na *Referência de comandos da AWS CLI*.
### `update-function-definition`
O código de exemplo a seguir mostra como usar `update-function-definition`.
**AWS CLI**
**Atualizar o nome de uma definição de função**
O exemplo `update-function-definition` a seguir atualiza o nome da definição da função específica. Se desejar atualizar os detalhes da função, use o comando `create-function-definition-version` para criar uma nova versão.
```
aws greengrass update-function-definition \
--function-definition-id "e47952bd-dea9-4e2c-a7e1-37bbe8807f46" \
--name ObsoleteFunction
```
Este comando não produz saída.
Para obter mais informações, consulte [Executar funções do Lambda locais](https://docs.aws.amazon.com/greengrass/latest/developerguide/lambda-functions.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [UpdateFunctionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-function-definition.html) na *Referência de comandos da AWS CLI*.
### `update-group-certificate-configuration`
O código de exemplo a seguir mostra como usar `update-group-certificate-configuration`.
**AWS CLI**
**Atualizar a expiração dos certificados de um grupo**
O exemplo `update-group-certificate-configuration` a seguir define uma expiração de 10 dias para os certificados gerados para o grupo especificado.
```
aws greengrass update-group-certificate-configuration \
--group-id "8eaadd72-ce4b-4f15-892a-0cc4f3a343f1" \
--certificate-expiry-in-milliseconds 864000000
```
Resultado:
```
{
"CertificateExpiryInMilliseconds": 864000000,
"CertificateAuthorityExpiryInMilliseconds": 2524607999000,
"GroupId": "8eaadd72-ce4b-4f15-892a-0cc4f3a343f1"
}
```
Para obter mais informações sobre grupos, consulte [Segurança do AWS IoT Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-sec.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [UpdateGroupCertificateConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-group-certificate-configuration.html) na *Referência de comandos da AWS CLI*.
### `update-group`
O código de exemplo a seguir mostra como usar `update-group`.
**AWS CLI**
**Atualizar o nome do grupo**
O exemplo `update-group` a seguir atualiza o nome do grupo Greengrass específico. Se desejar atualizar os detalhes do grupo, use o comando `create-group-version` para criar uma nova versão.
```
aws greengrass update-group \
--group-id "1402daf9-71cf-4cfe-8be0-d5e80526d0d8" \
--name TestGroup4of6
```
Para obter mais informações, consulte [Configurar o AWS IoT Greengrass na AWS IoT](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-config.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Consulte detalhes da API em [UpdateGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-group.html) na *Referência de comandos da AWS CLI*.
### `update-logger-definition`
O código de exemplo a seguir mostra como usar `update-logger-definition`.
**AWS CLI**
**Atualizar uma definição de logger**
O exemplo `update-logger-definition` a seguir altera o nome da definição do logger específico. Só é possível atualizar a propriedade `name` de uma definição de logger.
```
aws greengrass update-logger-definition \
--logger-definition-id "a454b62a-5d56-4ca9-bdc4-8254e1662cb0" \
--name "LoggingConfigsForSensors"
```
Este comando não produz saída.
Para obter mais informações, consulte [Monitoring with AWS IoT Greengrass Logs](https://docs.aws.amazon.com/greengrass/latest/developerguide/greengrass-logs-overview.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [UpdateLoggerDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-logger-definition.html) na *Referência de comandos da AWS CLI*.
### `update-resource-definition`
O código de exemplo a seguir mostra como usar `update-resource-definition`.
**AWS CLI**
**Atualizar o nome de uma definição de recurso**
O exemplo `update-resource-definition` a seguir atualiza o nome da definição do recurso específico. Se desejar alterar os detalhes do recurso, use o comando `create-resource-definition-version` para criar uma nova versão.
```
aws greengrass update-resource-definition \
--resource-definition-id "c8bb9ebc-c3fd-40a4-9c6a-568d75569d38" \
--name GreengrassConnectorResources
```
Este comando não produz saída.
Para obter mais informações, consulte [Acessar Recursos Locais com Funções do Lambda e Conectores](https://docs.aws.amazon.com/greengrass/latest/developerguide/access-local-resources.html) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [UpdateResourceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-resource-definition.html) na *Referência de comandos da AWS CLI*.
### `update-subscription-definition`
O código de exemplo a seguir mostra como usar `update-subscription-definition`.
**AWS CLI**
**Atualizar o nome de uma definição de assinatura**
O exemplo `update-subscription-definition` a seguir atualiza o nome da definição de assinatura específica. Se desejar alterar os detalhes da assinatura, use o comando `create-subscription-definition-version` para criar uma nova versão.
```
aws greengrass update-subscription-definition \
--subscription-definition-id "fa81bc84-3f59-4377-a84b-5d0134da359b" \
--name "ObsoleteSubscription"
```
Este comando não produz saída.
Para obter mais informações, consulte *guia*.
+ Para ver detalhes da API, consulte [UpdateSubscriptionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-subscription-definition.html) na *Referência de comandos da AWS CLI*.
### `update-thing-runtime-configuration`
O código de exemplo a seguir mostra como usar `update-thing-runtime-configuration`.
**AWS CLI**
**Para ativar a telemetria na configuração de runtime de um núcleo Greengrass**
O exemplo `update-thing-runtime-configuration` a seguir atualiza a configuração de runtime de um núcleo do Greengrass para ativar a telemetria.
```
aws greengrass update-thing-runtime-configuration \
--thing-name SampleGreengrassCore \
--telemetry-configuration {\"Telemetry\":\"On\"}
```
Este comando não produz saída.
Para obter mais informações, consulte [Configuring telemetry settings](https://docs.aws.amazon.com/greengrass/latest/developerguide/telemetry.html#configure-telemetry-settings) no *Guia do Desenvolvedor do AWS IoT Greengrass*.
+ Para ver detalhes da API, consulte [UpdateThingRuntimeConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-thing-runtime-configuration.html) na *Referência de comandos da AWS CLI*.