Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# AWS IoT Greengrass exemplos usando 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 with 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. A função de grupo é usada por funções e conectores locais do Lambda para acessar serviços. AWS Por exemplo, seu papel de grupo pode conceder as permissões necessárias para a integração do 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
```
Saída:
```
{
"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 obter detalhes da API, consulte [AssociateRoleToGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/associate-role-to-group.html)em *Referência de AWS CLI Comandos*.
### `associate-service-role-to-account`
O código de exemplo a seguir mostra como usar `associate-service-role-to-account`.
**AWS CLI**
**Para associar uma função de serviço à sua AWS conta**
O `associate-service-role-to-account` exemplo a seguir associa uma função de serviço do IAM, especificada por seu ARN, AWS ao IoT Greengrass em sua conta. AWS Você deve ter criado previamente a função de serviço no IAM e associar a ela um documento de política que permita que o AWS IoT Greengrass assuma essa função.
```
aws greengrass associate-service-role-to-account \
--role-arn "arn:aws:iam::123456789012:role/service-role/Greengrass_ServiceRole"
```
Saída:
```
{
"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 obter detalhes da API, consulte [AssociateServiceRoleToAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/associate-service-role-to-account.html)em *Referência de AWS CLI Comandos*.
### `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\"}}]"
```
Saída:
```
{
"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 obter detalhes da API, consulte [CreateConnectorDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-connector-definition-version.html)em *Referência de AWS CLI Comandos*.
### `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\"}}]}"
```
Saída:
```
{
"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 obter detalhes da API, consulte [CreateConnectorDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-connector-definition.html)em *Referência de AWS CLI Comandos*.
### `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, você deve primeiro criar e provisionar a coisa de AWS IoT correspondente. Esse processo inclui os seguintes `iot` comandos, que retornam `ThingArn` e `CertificateArn` necessários para o comando `create-core-definition-version`.
Crie a coisa de AWS IoT que corresponde ao dispositivo principal:
```
aws iot create-thing \
--thing-name "MyCoreDevice"
```
Saída:
```
{
"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"
```
Saída:
```
{
"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"
}
```
Crie uma política de AWS IoT que permita `iot` e `greengrass` aja. 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\":[\"*\"]}]}"
```
Saída:
```
{
"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}]"
```
Saída:
```
{
"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 o AWS IoT Greengrass Core no Guia do Desenvolvedor do AWS IoT Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-core.html).*
+ Para obter detalhes da API, consulte [CreateCoreDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-core-definition-version.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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, você deve primeiro criar e provisionar a coisa de AWS IoT correspondente. Esse processo inclui os seguintes `iot` comandos, que retornam `ThingArn` e `CertificateArn` necessários para o comando `create-core-definition`.
Crie a coisa de AWS IoT que corresponde ao dispositivo principal:
```
aws iot create-thing \
--thing-name "MyCoreDevice"
```
Saída:
```
{
"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"
```
Saída:
```
{
"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"
}
```
Crie uma política de AWS IoT que permita `iot` e `greengrass` aja. 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\":[\"*\"]}]}"
```
Saída:
```
{
"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}]}"
```
Saída:
```
{
"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 o AWS IoT Greengrass Core no Guia do Desenvolvedor do AWS IoT Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-core.html).*
+ Para obter detalhes da API, consulte [CreateCoreDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-core-definition.html)em *Referência de AWS CLI Comandos*.
### `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"
```
Saída:
```
{
"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*.
+ Para obter detalhes da API, consulte [CreateDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-deployment.html)em *Referência de AWS CLI Comandos*.
### `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, você deve primeiro criar e provisionar a coisa de IoT correspondente AWS . Esse processo inclui os seguintes comandos `iot` que devem ser executados para obter informações necessárias para o comando Greengrass:
Crie a coisa de AWS IoT que corresponde ao dispositivo:
```
aws iot create-thing \
--thing-name "InteriorTherm"
```
Saída:
```
{
"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"
```
Saída:
```
{
"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"
}
```
Crie uma política de AWS IoT que permita `iot` e `greengrass` aja. 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\":[\"*\"]}]}"
```
Saída:
```
{
"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}]"
```
Saída:
```
{
"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 obter detalhes da API, consulte [CreateDeviceDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-device-definition-version.html)em *Referência de AWS CLI Comandos*.
### `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, você deve primeiro criar e provisionar a coisa de IoT correspondente AWS . Esse processo inclui os seguintes comandos `iot` que devem ser executados para obter informações necessárias para o comando Greengrass:
Crie a coisa de AWS IoT que corresponde ao dispositivo:
```
aws iot create-thing \
--thing-name "InteriorTherm"
```
Saída:
```
{
"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"
```
Saída:
```
{
"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"
}
```
Crie uma política de AWS IoT que permita `iot` e `greengrass` aja. 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\":[\"*\"]}]}"
```
Saída:
```
{
"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}]}"
```
Saída:
```
{
"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 obter detalhes da API, consulte [CreateDeviceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-device-definition.html)em *Referência de AWS CLI Comandos*.
### `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}}]}"
```
Saída:
```
{
"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 obter detalhes da API, consulte [CreateFunctionDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-function-definition-version.html)em *Referência de AWS CLI Comandos*.
### `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 `create-function` comando do Lambda exige o ARN da função de execução, embora o AWS IoT Greengrass não use essa função porque as permissões são especificadas na função 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}}]}"
```
Saída:
```
{
"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 [Como configurar o acesso a recursos locais usando a interface de linha de AWS comando](https://docs.aws.amazon.com/greengrass/latest/developerguide/lra-cli.html) no Guia do desenvolvedor do *AWS IoT Greengrass*.
+ Para obter detalhes da API, consulte [CreateFunctionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-function-definition.html)em *Referência de AWS CLI Comandos*.
### `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"
```
Saída:
```
{
"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 obter detalhes da API, consulte [CreateGroupCertificateAuthority](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-group-certificate-authority.html)em *Referência de AWS CLI Comandos*.
### `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"
```
Saída:
```
{
"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 [Visão geral do modelo de objetos do grupo AWS IoT Greengrass no](https://docs.aws.amazon.com/greengrass/latest/developerguide/deployments.html#api-overview) Guia do desenvolvedor do AWS IoT Greengrass.*
+ Para obter detalhes da API, consulte [CreateGroupVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-group-version.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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 [Visão geral do modelo de objetos do grupo AWS IoT Greengrass no](https://docs.aws.amazon.com/greengrass/latest/developerguide/deployments.html#api-overview) Guia do desenvolvedor do AWS IoT Greengrass.*
+ Para obter detalhes da API, consulte [CreateGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-group.html)em *Referência de AWS CLI Comandos*.
### `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 registro: 1) registros de componentes do sistema no sistema de arquivos do dispositivo principal, 2) registros de funções Lambda definidos pelo usuário no sistema de arquivos do dispositivo principal, 3) registros de componentes do sistema no Amazon Logs e 4) registros de funções Lambda definidos pelo usuário no Amazon CloudWatch Logs. CloudWatch Observação: para a integração do CloudWatch Logs, 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\"}]"
```
Saída:
```
{
"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 [Monitoramento com registros AWS do IoT Greengrass no](https://docs.aws.amazon.com/greengrass/latest/developerguide/greengrass-logs-overview.html) Guia do desenvolvedor do AWS IoT Greengrass.*
+ Para obter detalhes da API, consulte [CreateLoggerDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-logger-definition-version.html)em *Referência de AWS CLI Comandos*.
### `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 registro: 1) registros de componentes do sistema no sistema de arquivos do dispositivo principal, 2) registros de funções Lambda definidos pelo usuário no sistema de arquivos do dispositivo principal e 3) registros de funções Lambda definidos pelo usuário no Amazon Logs. CloudWatch Observação: para a integração do CloudWatch Logs, 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\"}]}"
```
Saída:
```
{
"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 [Monitoramento com registros AWS do IoT Greengrass no](https://docs.aws.amazon.com/greengrass/latest/developerguide/greengrass-logs-overview.html) Guia do desenvolvedor do AWS IoT Greengrass.*
+ Para obter detalhes da API, consulte [CreateLoggerDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-logger-definition.html)em *Referência de AWS CLI Comandos*.
### `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 `create-resource-definition-version` exemplo 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\"}}}]"
```
Saída:
```
{
"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 obter detalhes da API, consulte [CreateResourceDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-resource-definition-version.html)em *Referência de AWS CLI Comandos*.
### `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 da Twilio e o ARN para um segredo armazenado no Secrets Manager. AWS É 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\"}}}]}"
```
Saída:
```
{
"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 [Como configurar o acesso a recursos locais usando a interface de linha de AWS comando](https://docs.aws.amazon.com/greengrass/latest/developerguide/lra-cli.html) no Guia do desenvolvedor do *AWS IoT Greengrass*.
+ Para obter detalhes da API, consulte [CreateResourceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-resource-definition.html)em *Referência de AWS CLI Comandos*.
### `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 `create-software-update-job` exemplo a seguir cria uma tarefa de atualização over-the-air (OTA) para atualizar o software AWS IoT Greengrass Core no núcleo cujo nome é. `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
```
Saída:
```
{
"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 [Atualizações OTA do software AWS IoT Greengrass Core no](https://docs.aws.amazon.com/greengrass/latest/developerguide/core-ota-update.html) Guia do desenvolvedor do AWS IoT Greengrass.*
+ Para obter detalhes da API, consulte [CreateSoftwareUpdateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-software-update-job.html)em *Referência de AWS CLI Comandos*.
### `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\"}]"
```
Saída:
```
{
"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 obter detalhes da API, consulte [CreateSubscriptionDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-subscription-definition-version.html)em *Referência de AWS CLI Comandos*.
### `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 e uma para permitir que a AWS IoT receba informações de status do conector. AWS 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\"}]}"
```
Saída:
```
{
"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 obter detalhes da API, consulte [CreateSubscriptionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/create-subscription-definition.html)em *Referência de AWS CLI Comandos*.
### `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 obter detalhes da API, consulte [DeleteConnectorDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-connector-definition.html)em *Referência de AWS CLI Comandos*.
### `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 obter detalhes da API, consulte [DeleteCoreDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-core-definition.html)em *Referência de AWS CLI Comandos*.
### `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 obter detalhes da API, consulte [DeleteDeviceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-device-definition.html)em *Referência de AWS CLI Comandos*.
### `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 obter detalhes da API, consulte [DeleteFunctionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-function-definition.html)em *Referência de AWS CLI Comandos*.
### `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.
+ Para obter detalhes da API, consulte [DeleteGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-group.html)em *Referência de AWS CLI Comandos*.
### `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 [Monitoramento com registros AWS do IoT Greengrass no](https://docs.aws.amazon.com/greengrass/latest/developerguide/greengrass-logs-overview.html) Guia do desenvolvedor do AWS IoT Greengrass.*
+ Para obter detalhes da API, consulte [DeleteLoggerDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-logger-definition.html)em *Referência de AWS CLI Comandos*.
### `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 obter detalhes da API, consulte [DeleteResourceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-resource-definition.html)em *Referência de AWS CLI Comandos*.
### `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 obter detalhes da API, consulte [DeleteSubscriptionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/delete-subscription-definition.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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 obter detalhes da API, consulte [DisassociateRoleFromGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/disassociate-role-from-group.html)em *Referência de AWS CLI Comandos*.
### `disassociate-service-role-from-account`
O código de exemplo a seguir mostra como usar `disassociate-service-role-from-account`.
**AWS CLI**
**Para desassociar uma função de serviço da sua conta AWS **
O `disassociate-service-role-from-account` exemplo a seguir remove a função de serviço associada à sua AWS conta. Se você não estiver usando a função de serviço em nenhuma AWS região, use o `delete-role-policy` comando para separar a política `AWSGreengrassResourceAccessRolePolicy` gerenciada da função e, em seguida, use o `delete-role` comando para excluir a função.
```
aws greengrass disassociate-service-role-from-account
```
Saída:
```
{
"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 obter detalhes da API, consulte [DisassociateServiceRoleFromAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/disassociate-service-role-from-account.html)em *Referência de AWS CLI Comandos*.
### `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. A função de grupo é usada por funções e conectores locais do Lambda para acessar serviços. AWS
```
aws greengrass get-associated-role \
--group-id 2494ee3f-7f8a-4e92-a78b-d205f808b84b
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetAssociatedRole](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-associated-role.html)em *Referência de AWS CLI Comandos*.
### `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"
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetBulkDeploymentStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-bulk-deployment-status.html)em *Referência de AWS CLI Comandos*.
### `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"
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetConnectivityInfo](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-connectivity-info.html)em *Referência de AWS CLI Comandos*.
### `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 todas as versões IDs 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"
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetConnectorDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-connector-definition-version.html)em *Referência de AWS CLI Comandos*.
### `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 definições IDs do seu conector, use o `list-connector-definitions` comando.
```
aws greengrass get-connector-definition \
--connector-definition-id "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8"
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetConnectorDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-connector-definition.html)em *Referência de AWS CLI Comandos*.
### `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 todas as versões da definição principal, use o `list-core-definition-versions` comando. IDs 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"
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetCoreDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-core-definition-version.html)em *Referência de AWS CLI Comandos*.
### `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 suas IDs definições principais, use o `list-core-definitions` comando.
```
aws greengrass get-core-definition \
--core-definition-id "c906ed39-a1e3-4822-a981-7b9bd57b4b46"
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetCoreDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-core-definition.html)em *Referência de AWS CLI Comandos*.
### `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"
```
Saída:
```
{
"DeploymentStatus": "Success",
"DeploymentType": "NewDeployment",
"UpdatedAt": "2019-06-18T17:04:44.761Z"
}
```
+ Para obter detalhes da API, consulte [GetDeploymentStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-deployment-status.html)em *Referência de AWS CLI Comandos*.
### `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 todas as versões IDs 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"
```
Saída:
```
{
"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"
}
```
+ Para obter detalhes da API, consulte [GetDeviceDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-device-definition-version.html)em *Referência de AWS CLI Comandos*.
### `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 as definições IDs do seu dispositivo, use o `list-device-definitions` comando.
```
aws greengrass get-device-definition \
--device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd"
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetDeviceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-device-definition.html)em *Referência de AWS CLI Comandos*.
### `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 todas as versões IDs 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"
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetFunctionDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-function-definition-version.html)em *Referência de AWS CLI Comandos*.
### `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 suas definições IDs de função, use o `list-function-definitions` comando.
```
aws greengrass get-function-definition \
--function-definition-id "063f5d1a-1dd1-40b4-9b51-56f8993d0f85"
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetFunctionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-function-definition.html)em *Referência de AWS CLI Comandos*.
### `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"
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetGroupCertificateAuthority](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-group-certificate-authority.html)em *Referência de AWS CLI Comandos*.
### `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"
```
Saída:
```
{
"CertificateAuthorityExpiryInMilliseconds": 2524607999000,
"CertificateExpiryInMilliseconds": 604800000,
"GroupId": "1013db12-8b58-45ff-acc7-704248f66731"
}
```
+ Para obter detalhes da API, consulte [GetGroupCertificateConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-group-certificate-configuration.html)em *Referência de AWS CLI Comandos*.
### `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 todas as versões do grupo, use o `list-group-versions` comando. IDs 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"
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetGroupVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-group-version.html)em *Referência de AWS CLI Comandos*.
### `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 o IDs dos seus grupos, use o `list-groups` comando.
```
aws greengrass get-group \
--group-id "1013db12-8b58-45ff-acc7-704248f66731"
```
Saída:
```
{
"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": {}
}
```
+ Para obter detalhes da API, consulte [GetGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-group.html)em *Referência de AWS CLI Comandos*.
### `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 todas as versões IDs da definição do registrador, 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"
```
Saída:
```
{
"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"
}
```
+ Para obter detalhes da API, consulte [GetLoggerDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-logger-definition-version.html)em *Referência de AWS CLI Comandos*.
### `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 definições IDs do seu registrador, use o `list-logger-definitions` comando.
```
aws greengrass get-logger-definition \
--logger-definition-id "49eeeb66-f1d3-4e34-86e3-3617262abf23"
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetLoggerDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-logger-definition.html)em *Referência de AWS CLI Comandos*.
### `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 todas as versões IDs 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"
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetResourceDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-resource-definition-version.html)em *Referência de AWS CLI Comandos*.
### `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 suas definições IDs de recursos, use o `list-resource-definitions` comando.
```
aws greengrass get-resource-definition \
--resource-definition-id "ad8c101d-8109-4b0e-b97d-9cc5802ab658"
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetResourceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-resource-definition.html)em *Referência de AWS CLI Comandos*.
### `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 `get-service-role-for-account` exemplo a seguir recupera informações sobre a função de serviço vinculada à sua AWS conta.
```
aws greengrass get-service-role-for-account
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetServiceRoleForAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-service-role-for-account.html)em *Referência de AWS CLI Comandos*.
### `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 todas as versões IDs 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"
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetSubscriptionDefinitionVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-subscription-definition-version.html)em *Referência de AWS CLI Comandos*.
### `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 definições IDs de sua assinatura, use o `list-subscription-definitions` comando.
```
aws greengrass get-subscription-definition \
--subscription-definition-id "70e49321-83d5-45d2-bc09-81f4917ae152"
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetSubscriptionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-subscription-definition.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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 obter detalhes da API, consulte [GetThingRuntimeConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/get-thing-runtime-configuration.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListBulkDeploymentDetailedReports](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-bulk-deployment-detailed-reports.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListBulkDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-bulk-deployments.html)em *Referência de AWS CLI Comandos*.
### `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"
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListConnectorDefinitionVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-connector-definition-versions.html)em *Referência de AWS CLI Comandos*.
### `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 `list-connector-definitions` exemplo a seguir lista todos os conectores do Greengrass definidos para sua conta. AWS
```
aws greengrass list-connector-definitions
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListConnectorDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-connector-definitions.html)em *Referência de AWS CLI Comandos*.
### `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"
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListCoreDefinitionVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-core-definition-versions.html)em *Referência de AWS CLI Comandos*.
### `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 `list-core-definitions` exemplo a seguir lista todas as principais definições do Greengrass para sua AWS conta.
```
aws greengrass list-core-definitions
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListCoreDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-core-definitions.html)em *Referência de AWS CLI Comandos*.
### `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"
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-deployments.html)em *Referência de AWS CLI Comandos*.
### `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"
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListDeviceDefinitionVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-device-definition-versions.html)em *Referência de AWS CLI Comandos*.
### `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 `list-device-definitions` exemplo a seguir exibe detalhes sobre as definições do dispositivo em sua AWS conta na AWS região especificada.
```
aws greengrass list-device-definitions \
--region us-west-2
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListDeviceDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-device-definitions.html)em *Referência de AWS CLI Comandos*.
### `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"
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListFunctionDefinitionVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-function-definition-versions.html)em *Referência de AWS CLI Comandos*.
### `list-function-definitions`
O código de exemplo a seguir mostra como usar `list-function-definitions`.
**AWS CLI**
**Listar funções do Lambda**
O `list-function-definitions` exemplo a seguir lista todas as funções do Lambda definidas para sua AWS conta.
```
aws greengrass list-function-definitions
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListFunctionDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-function-definitions.html)em *Referência de AWS CLI Comandos*.
### `list-group-certificate-authorities`
O código de exemplo a seguir mostra como usar `list-group-certificate-authorities`.
**AWS CLI**
**Para listar o atual CAs de um grupo**
O `list-group-certificate-authorities` exemplo a seguir lista as autoridades de certificação atuais (CAs) do grupo Greengrass especificado.
```
aws greengrass list-group-certificate-authorities \
--group-id "1013db12-8b58-45ff-acc7-704248f66731"
```
Saída:
```
{
"GroupCertificateAuthorities": [
{
"GroupCertificateAuthorityArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/certificateauthorities/f0430e1736ea8ed30cc5d5de9af67a7e3586bad9ae4d89c2a44163f65fdd8cf6",
"GroupCertificateAuthorityId": "f0430e1736ea8ed30cc5d5de9af67a7e3586bad9ae4d89c2a44163f65fdd8cf6"
}
]
}
```
+ Para obter detalhes da API, consulte [ListGroupCertificateAuthorities](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-group-certificate-authorities.html)em *Referência de AWS CLI Comandos*.
### `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"
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListGroupVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-group-versions.html)em *Referência de AWS CLI Comandos*.
### `list-groups`
O código de exemplo a seguir mostra como usar `list-groups`.
**AWS CLI**
**Listar os grupos do Greengrass**
O `list-groups` exemplo a seguir lista todos os grupos do Greengrass que estão definidos em sua AWS conta.
```
aws greengrass list-groups
```
Saída:
```
{
"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"
}
]
}
```
+ Para obter detalhes da API, consulte [ListGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-groups.html)em *Referência de AWS CLI Comandos*.
### `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"
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListLoggerDefinitionVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-logger-definition-versions.html)em *Referência de AWS CLI Comandos*.
### `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 `list-logger-definitions` exemplo a seguir lista todas as definições de registrador da sua AWS conta.
```
aws greengrass list-logger-definitions
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListLoggerDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-logger-definitions.html)em *Referência de AWS CLI Comandos*.
### `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"
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListResourceDefinitionVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-resource-definition-versions.html)em *Referência de AWS CLI Comandos*.
### `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 `list-resource-definitions` exemplo a seguir lista os recursos definidos para o AWS IoT Greengrass usar.
```
aws greengrass list-resource-definitions
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListResourceDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-resource-definitions.html)em *Referência de AWS CLI Comandos*.
### `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"
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListSubscriptionDefinitionVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-subscription-definition-versions.html)em *Referência de AWS CLI Comandos*.
### `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 `list-subscription-definitions` exemplo a seguir lista todas as assinaturas do AWS IoT Greengrass definidas em sua conta. AWS
```
aws greengrass list-subscription-definitions
```
Saída:
```
{
"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 obter detalhes da API, consulte [ListSubscriptionDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-subscription-definitions.html)em *Referência de AWS CLI Comandos*.
### `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"
```
Saída:
```
{
"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 da API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/list-tags-for-resource.html)na *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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 obter detalhes da API, consulte [ResetDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/reset-deployments.html)na *Referência de AWS CLI Comandos*.
### `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\"}"
```
Saída:
```
{
"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 da API, consulte [StartBulkDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/start-bulk-deployment.html)na *Referência de AWS CLI Comandos*.
### `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 obter detalhes da API, consulte [StopBulkDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/stop-bulk-deployment.html)na *Referência de AWS CLI Comandos*.
### `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**.
+ Para obter detalhes da API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/tag-resource.html)na *Referência de AWS CLI Comandos*.
### `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 da API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/untag-resource.html)na *Referência de AWS CLI Comandos*.
### `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\"}]"
```
Saída:
```
{
"Version": "312de337-59af-4cf9-a278-2a23bd39c300"
}
```
+ Para obter detalhes da API, consulte [UpdateConnectivityInfo](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-connectivity-info.html)na *Referência de AWS CLI Comandos*.
### `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 obter detalhes da API, consulte [UpdateConnectorDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-connector-definition.html)na *Referência de AWS CLI Comandos*.
### `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 o AWS IoT Greengrass Core no Guia do Desenvolvedor do AWS IoT Greengrass](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-core.html).*
+ Para obter detalhes da API, consulte [UpdateCoreDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-core-definition.html)na *Referência de AWS CLI Comandos*.
### `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 obter detalhes da API, consulte [UpdateDeviceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-device-definition.html)na *Referência de AWS CLI Comandos*.
### `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 obter detalhes da API, consulte [UpdateFunctionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-function-definition.html)na *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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 obter detalhes da API, consulte [UpdateGroupCertificateConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-group-certificate-configuration.html)na *Referência de AWS CLI Comandos*.
### `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 IoT no Guia do AWS desenvolvedor do AWS IoT](https://docs.aws.amazon.com/greengrass/latest/developerguide/gg-config.html) Greengrass.*
+ Para obter detalhes da API, consulte [UpdateGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-group.html)na *Referência de AWS CLI Comandos*.
### `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 [Monitoramento com registros AWS do IoT Greengrass no](https://docs.aws.amazon.com/greengrass/latest/developerguide/greengrass-logs-overview.html) Guia do desenvolvedor do AWS IoT Greengrass.*
+ Para obter detalhes da API, consulte [UpdateLoggerDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-logger-definition.html)na *Referência de AWS CLI Comandos*.
### `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 obter detalhes da API, consulte [UpdateResourceDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-resource-definition.html)na *Referência de AWS CLI Comandos*.
### `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 obter detalhes da API, consulte [UpdateSubscriptionDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-subscription-definition.html)na *Referência de AWS CLI Comandos*.
### `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 obter detalhes da API, consulte [UpdateThingRuntimeConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrass/update-thing-runtime-configuration.html)na *Referência de AWS CLI Comandos*.