AWS IoT Greengrass 를 사용하는 예제 AWS CLI

다음 코드 예제에서는를 AWS Command Line Interface 와 함께 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다 AWS IoT Greengrass.

작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.

각 예제에는 컨텍스트에서 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있는 전체 소스 코드에 대한 링크가 포함되어 있습니다.

주제

작업

작업

다음 코드 예시에서는 associate-role-to-group을 사용하는 방법을 보여 줍니다.

AWS CLI

역할을 Greengrass 그룹과 연결하려면

다음 associate-role-to-group 예제에서는 지정된 IAM 역할을 Greengrass 그룹과 연결합니다. 그룹 역할은 로컬 Lambda 함수 및 커넥터에서 AWS 서비스에 액세스하는 데 사용됩니다. 예를 들어 그룹 역할은 CloudWatch 로그 통합에 필요한 권한을 부여할 수 있습니다.


aws greengrass associate-role-to-group \
    --group-id 2494ee3f-7f8a-4e92-a78b-d205f808b84b \
    --role-arn arn:aws:iam::123456789012:role/GG-Group-Role

출력:


{
    "AssociatedAt": "2019-09-10T20:03:30Z"
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 그룹 역할 구성을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조AssociateRoleToGroup의 섹션을 참조하세요.

다음 코드 예시에서는 associate-service-role-to-account을 사용하는 방법을 보여 줍니다.

AWS CLI

서비스 역할을 AWS 계정과 연결하려면

다음 associate-service-role-to-account 예제에서는에서 지정한 IAM 서비스 역할을 AWS 계정의 AWS IoT GreengrassARN와 연결합니다. 이전에에서 서비스 역할을 생성한 적이 있어야 하며IAM, AWS IoT Greengrass가이 역할을 수임할 수 있도록 허용하는 정책 문서를 해당 문서와 연결해야 합니다.


aws greengrass associate-service-role-to-account \
    --role-arn "arn:aws:iam::123456789012:role/service-role/Greengrass_ServiceRole"

출력:


{
    "AssociatedAt": "2019-06-25T18:12:45Z"
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 Greengrass 서비스 역할을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조AssociateServiceRoleToAccount의 섹션을 참조하세요.

다음 코드 예시에서는 create-connector-definition-version을 사용하는 방법을 보여 줍니다.

AWS CLI

커넥터 정의 버전을 생성하려면

다음 create-connector-definition-version 예제에서는 커넥터 정의 버전을 생성하고 이를 지정된 커넥터 정의와 연결합니다. 버전의 모든 커넥터는 파라미터 값을 정의합니다.


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\"}}]"

출력:


{
    "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"
}

자세한 내용은 AWS CLI 명령 참조CreateConnectorDefinitionVersion의 섹션을 참조API하세요.

다음 코드 예시에서는 create-connector-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

커넥터 정의를 생성하려면

다음 create-connector-definition 예제에서는 커넥터 정의와 초기 커넥터 정의 버전을 생성합니다. 초기 버전에는 커넥터 하나가 포함되어 있습니다. 버전의 모든 커넥터는 파라미터 값을 정의합니다.


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\"}}]}"

출력:


{
    "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"
}

자세한 내용은 IoT Greengrass 개발자 안내서의 Greengrass 커넥터 시작하기(CLI)를 참조하세요. AWS IoT

자세한 API 내용은 AWS CLI 명령 참조CreateConnectorDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 create-core-definition-version을 사용하는 방법을 보여 줍니다.

AWS CLI

코어 정의 버전을 생성하려면

다음 create-core-definition-version 예제에서는 코어 정의 버전을 생성하고 이를 지정된 코어 정의와 연결합니다. 버전에는 하나의 코어만 포함될 수 있습니다. 코어를 생성하려면 먼저 해당 AWS IoT 사물을 생성하고 프로비저닝해야 합니다. 이 프로세스에는 iot 명령에 CertificateArn 필요한 ThingArn 및를 반환하는 다음 create-core-definition-version 명령이 포함됩니다.

코어 디바이스에 해당하는 AWS IoT 사물을 생성합니다.


aws iot create-thing \
    --thing-name "MyCoreDevice"

출력:


{
    "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyCoreDevice",
    "thingName": "MyCoreDevice",
    "thingId": "cb419a19-9099-4515-9cec-e9b0e760608a"
}

사물에 대한 퍼블릭 및 프라이빗 키와 코어 디바이스 인증서를 생성합니다. 이 예제에서는 create-keys-and-certificate 명령을 사용하며 현재 디렉터리에 대한 쓰기 권한이 필요합니다. 또는 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"

출력:


{
    "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"
}

iot 및 greengrass 작업을 허용하는 AWS IoT 정책을 생성합니다. 간소화를 위해 다음 정책은 모든 리소스에 대한 작업을 허용하지만 정책이 더 제한적이어야 합니다.


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\":[\"*\"]}]}"

출력:


{
    "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"
}

정책을 인증서에 연결합니다.


aws iot attach-policy \
    --policy-name "Core_Devices" \
    --target "arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz"

이 명령은 출력을 생성하지 않습니다.

인증서에 사물을 연결합니다.


aws iot attach-thing-principal \
    --thing-name "MyCoreDevice" \
    --principal "arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz"

이 명령은 출력을 생성하지 않습니다.

코어 정의 버전을 생성합니다.


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}]"

출력:


{
    "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"
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 IoT Greengrass Core 구성을 참조하세요. AWS IoT

자세한 API 내용은 AWS CLI 명령 참조CreateCoreDefinitionVersion의 섹션을 참조하세요.

다음 코드 예시에서는 create-core-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

예제 1: 빈 코어 정의를 생성하려면

다음 create-core-definition 예제에서는 빈(최초 버전 없음) Greengrass 코어 정의를 생성합니다. 코어를 사용하려면 먼저 create-core-definition-version 명령을 사용하여 코어에 대한 다른 파라미터를 제공해야 합니다.


aws greengrass create-core-definition \
    --name cliGroup_Core

출력:


{
    "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"
}

예제 2: 초기 버전으로 코어 정의를 생성하려면

다음 create-core-definition 예제에서는 초기 코어 정의 버전을 포함하는 코어 정의를 생성합니다. 버전에는 하나의 코어만 포함될 수 있습니다. 코어를 생성하려면 먼저 해당 AWS IoT 사물을 생성하고 프로비저닝해야 합니다. 이 프로세스에는 iot 명령에 CertificateArn 필요한 ThingArn 및를 반환하는 다음 create-core-definition 명령이 포함됩니다.

코어 디바이스에 해당하는 AWS IoT 사물을 생성합니다.


aws iot create-thing \
    --thing-name "MyCoreDevice"

출력:


{
    "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyCoreDevice",
    "thingName": "MyCoreDevice",
    "thingId": "cb419a19-9099-4515-9cec-e9b0e760608a"
}


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"

출력:


{
    "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"
}


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\":[\"*\"]}]}"

출력:


{
    "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"
}

정책을 인증서에 연결합니다.


aws iot attach-policy \
    --policy-name "Core_Devices" \
    --target "arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz"

이 명령은 출력을 생성하지 않습니다.

인증서에 사물을 연결합니다.


aws iot attach-thing-principal \
    --thing-name "MyCoreDevice" \
    --principal "arn:aws:iot:us-west-2:123456789012:cert/123a15ec415668c2349a76170b64ac0878231c1e21ec83c10e92a1EXAMPLExyz"

이 명령은 출력을 생성하지 않습니다.

코어 정의를 생성합니다.


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}]}"

출력:


{
    "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"
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 IoT Greengrass Core 구성을 참조하세요. AWS IoT

자세한 API 내용은 AWS CLI 명령 참조CreateCoreDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 create-deployment을 사용하는 방법을 보여 줍니다.

AWS CLI

Greengrass 그룹의 버전에 대한 배포를 생성하려면

다음 create-deployment 예제에서는 Greengrass 그룹의 지정된 버전을 배포합니다.


aws greengrass create-deployment \
    --deployment-type NewDeployment \
    --group-id "ce2e7d01-3240-4c24-b8e6-f6f6e7a9eeca" \
    --group-version-id "dc40c1e9-e8c8-4d28-a84d-a9cad5f599c9"

출력:


{
    "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"
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 커넥터 시작하기(CLI)를 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조CreateDeployment의 섹션을 참조하세요.

다음 코드 예시에서는 create-device-definition-version을 사용하는 방법을 보여 줍니다.

AWS CLI

디바이스 정의 버전을 생성하려면

다음 create-device-definition-version 예제에서는 디바이스 정의 버전을 생성하고 이를 지정된 디바이스 정의와 연결합니다. 버전은 두 개의 디바이스를 정의합니다. Greengrass 디바이스를 생성하려면 먼저 해당 AWS IoT 사물을 생성하고 프로비저닝해야 합니다. 이 프로세스에는 Greengrass iot 명령에 필요한 정보를 가져오기 위해 실행해야 하는 다음 명령이 포함됩니다.

디바이스에 해당하는 AWS IoT 사물을 생성합니다.


aws iot create-thing \
    --thing-name "InteriorTherm"

출력:


{
    "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/InteriorTherm",
    "thingName": "InteriorTherm",
    "thingId": "01d4763c-78a6-46c6-92be-7add080394bf"
}

사물에 대한 퍼블릭 및 프라이빗 키와 디바이스 인증서를 생성합니다. 이 예제에서는 create-keys-and-certificate 명령을 사용하며 현재 디렉터리에 대한 쓰기 권한이 필요합니다. 또는 다음 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"

출력:


{
    "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"
}

iot 및 greengrass 작업을 허용하는 AWS IoT 정책을 생성합니다. 간소화를 위해 다음 정책은 모든 리소스에 대한 작업을 허용하지만 정책이 더 제한적일 수 있습니다.


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\":[\"*\"]}]}"

출력:


{
    "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"
}

정책을 인증서에 연결합니다.


aws iot attach-policy \
    --policy-name "GG_Devices" \
    --target "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92"

인증서에 사물 연결


aws iot attach-thing-principal \
    --thing-name "InteriorTherm" \
    --principal "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92"

위와 같이 IoT 사물을 생성하고 구성한 후 다음 예제의 처음 두 명령CertificateArn에서 ThingArn 및를 사용합니다.


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}]"

출력:


{
    "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"
}

자세한 내용은 AWS CLI 명령 참조CreateDeviceDefinitionVersion의 섹션을 참조API하세요.

다음 코드 예시에서는 create-device-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

디바이스 정의를 생성하려면

다음 create-device-definition 예제에서는 초기 디바이스 정의 버전을 포함하는 디바이스 정의를 생성합니다. 초기 버전은 두 디바이스를 정의합니다. Greengrass 디바이스를 생성하려면 먼저 해당 AWS IoT 사물을 생성하고 프로비저닝해야 합니다. 이 프로세스에는 Greengrass iot 명령에 필요한 정보를 가져오기 위해 실행해야 하는 다음 명령이 포함됩니다.

디바이스에 해당하는 AWS IoT 사물을 생성합니다.


aws iot create-thing \
    --thing-name "InteriorTherm"

출력:


{
    "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/InteriorTherm",
    "thingName": "InteriorTherm",
    "thingId": "01d4763c-78a6-46c6-92be-7add080394bf"
}


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"

출력:


{
    "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"
}


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\":[\"*\"]}]}"

출력:


{
    "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"
}

정책을 인증서에 연결합니다.


aws iot attach-policy \
    --policy-name "GG_Devices" \
    --target "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92"

인증서에 사물 연결


aws iot attach-thing-principal \
    --thing-name "InteriorTherm" \
    --principal "arn:aws:iot:us-west-2:123456789012:cert/66a415ec415668c2349a76170b64ac0878231c1e21ec83c10e92a18bd568eb92"

위와 같이 IoT 사물을 생성하고 구성한 후 다음 예제의 처음 두 명령CertificateArn에서 ThingArn 및를 사용합니다.


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}]}"

출력:


{
    "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"
}

자세한 API 내용은 AWS CLI 명령 참조CreateDeviceDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 create-function-definition-version을 사용하는 방법을 보여 줍니다.

AWS CLI

함수 정의의 버전을 생성하려면

다음 create-function-definition-version 예제에서는 지정된 함수 정의의 새 버전을 생성합니다. 이 버전은 ID가 인 단일 함수를 지정하고Hello-World-function, 파일 시스템에 대한 액세스를 허용하며, 최대 메모리 크기 및 제한 시간을 지정합니다.


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}}]}"

출력:


{
    "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"
}

자세한 API 내용은 AWS CLI 명령 참조CreateFunctionDefinitionVersion의 섹션을 참조하세요.

다음 코드 예시에서는 create-function-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

Lambda 함수 정의를 생성하려면

다음 create-function-definition 예제에서는 Lambda 함수 목록(이 경우 라는 함수 하나만 나열TempMonitorFunction)과 해당 구성을 제공하여 Lambda 함수 정의와 초기 버전을 생성합니다. 함수 정의를 생성하려면 먼저 Lambda 함수가 필요합니다ARN. 함수와 해당 별칭을 생성하려면 Lambda의 create-function 및 publish-version 명령을 사용합니다. Lambda의 create-function 명령은 AWS IoT Greengrass가 Greengrass 그룹 역할에 권한이 지정되어 있기 때문에 해당 역할을 사용하지 않더라도 실행 역할ARN의를 요구합니다. IAM create-role 명령을 사용하여 빈 역할을 생성하여 Lambda에서 사용할 ARN를 가져오create-function거나 기존 실행 역할을 사용할 수 있습니다.


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}}]}"

출력:


{
    "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"
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 AWS 명령줄 인터페이스를 사용하여 로컬 리소스 액세스를 구성하는 방법을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조CreateFunctionDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 create-group-certificate-authority을 사용하는 방법을 보여 줍니다.

AWS CLI

그룹에 대한 인증 기관(CA)을 생성하려면

다음 create-group-certificate-authority 예제에서는 지정된 그룹에 대한 CA를 생성하거나 교체합니다.


aws greengrass create-group-certificate-authority \
    --group-id "8eaadd72-ce4b-4f15-892a-0cc4f3a343f1"

출력:


{
    "GroupCertificateAuthorityArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/8eaadd72-ce4b-4f15-892a-0cc4f3a343f1/certificateauthorities/d31630d674c4437f6c5dbc0dca56312a902171ce2d086c38e509c8EXAMPLEcc5"
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 IoT Greengrass 보안을 참조하세요. AWS IoT

자세한 API 내용은 AWS CLI 명령 참조CreateGroupCertificateAuthority의 섹션을 참조하세요.

다음 코드 예시에서는 create-group-version을 사용하는 방법을 보여 줍니다.

AWS CLI

Greengrass 그룹의 버전을 생성하려면

다음 create-group-version 예제에서는 그룹 버전을 생성하고 이를 지정된 그룹과 연결합니다. 버전은이 그룹 버전에 포함할 개체가 포함된 코어, 리소스, 커넥터, 함수 및 구독 버전을 참조합니다. 그룹 버전을 생성하려면 먼저 이러한 엔터티를 생성해야 합니다.

초기 버전으로 리소스 정의를 생성하려면 create-resource-definition command.To 초기 버전으로 커넥터 정의를 생성하고, create-connector-definition command.To 초기 버전으로 함수 정의를 생성하고, create-function-definition command.To 초기 버전으로 구독 정의를 생성하고, create-subscription-definition command.To 최신 코어 정의 버전의 ARN를 검색하고, get-group-version 명령을 사용하고, 최신 그룹 버전의 ID를 지정합니다.


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"

출력:


{
    "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"
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 IoT Greengrass 그룹 객체 모델 개요를 참조하세요. AWS IoT

자세한 API 내용은 AWS CLI 명령 참조CreateGroupVersion의 섹션을 참조하세요.

다음 코드 예시에서는 create-group을 사용하는 방법을 보여 줍니다.

AWS CLI

Greeengrass 그룹을 생성하려면

다음 create-group 예제에서는 라는 그룹을 생성합니다cli-created-group.


aws greengrass create-group \
    --name cli-created-group

출력:


{
    "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"
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 IoT Greengrass 그룹 객체 모델 개요를 참조하세요. AWS IoT

자세한 내용은 AWS CLI 명령 참조CreateGroup의 섹션을 참조API하세요.

다음 코드 예시에서는 create-logger-definition-version을 사용하는 방법을 보여 줍니다.

AWS CLI

로거 정의 버전을 생성하려면

다음 create-logger-definition-version 예제에서는 로거 정의 버전을 생성하고 이를 로거 정의와 연결합니다. 버전은 1) 코어 디바이스의 파일 시스템에 대한 시스템 구성 요소 로그, 2) 코어 디바이스의 파일 시스템에 대한 사용자 정의 Lambda 함수 로그, 3) Amazon CloudWatch Logs의 시스템 구성 요소 로그, 4) Amazon CloudWatch Logs의 사용자 정의 Lambda 함수 로그의 네 가지 로깅 구성을 정의합니다. 참고: CloudWatch 로그 통합의 경우 그룹 역할이 적절한 권한을 부여해야 합니다.


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\"}]"

출력:


{
 "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"
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 IoT Greengrass Logs로 모니터링을 참조하세요. AWS IoT

자세한 API 내용은 AWS CLI 명령 참조CreateLoggerDefinitionVersion의 섹션을 참조하세요.

다음 코드 예시에서는 create-logger-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

로거 정의를 생성하려면

다음 create-logger-definition 예제에서는 초기 로거 정의 버전이 포함된 로거 정의를 생성합니다. 초기 버전은 1) 코어 디바이스의 파일 시스템에 대한 시스템 구성 요소 로그, 2) 코어 디바이스의 파일 시스템에 대한 사용자 정의 Lambda 함수 로그, 3) Amazon CloudWatch Logs의 사용자 정의 Lambda 함수 로그의 세 가지 로깅 구성을 정의합니다. 참고: CloudWatch 로그 통합의 경우 그룹 역할이 적절한 권한을 부여해야 합니다.


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\"}]}"

출력:


{
    "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"
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 IoT Greengrass Logs로 모니터링을 참조하세요. AWS IoT

자세한 API 내용은 AWS CLI 명령 참조CreateLoggerDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 create-resource-definition-version을 사용하는 방법을 보여 줍니다.

AWS CLI

리소스 정의 버전을 생성하려면

다음 create-resource-definition-version 예제에서는의 새 버전을 생성합니다 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\"}}}]"

출력:


{
    "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"
}

자세한 API 내용은 AWS CLI 명령 참조CreateResourceDefinitionVersion의 섹션을 참조하세요.

다음 코드 예시에서는 create-resource-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

리소스 정의를 생성하려면

다음 create-resource-definition 예제에서는 Greengrass 그룹에 사용할 리소스 목록이 포함된 리소스 정의를 생성합니다. 이 예제에서는 리소스 목록을 제공하여 리소스 정의의 초기 버전을 포함합니다. 목록에는 Twilio 권한 부여 토큰에 대한 리소스 하나와 AWS Secrets Manager에 저장된 보안 암호에 ARN 대한 리소스 하나가 포함됩니다. 리소스 정의를 생성하려면 먼저 보안 암호를 생성해야 합니다.


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\"}}}]}"

출력:


{
    "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"
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 AWS 명령줄 인터페이스를 사용하여 로컬 리소스 액세스를 구성하는 방법을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조CreateResourceDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 create-software-update-job을 사용하는 방법을 보여 줍니다.

AWS CLI

코어에 대한 소프트웨어 업데이트 작업을 생성하려면

다음 create-software-update-job 예제에서는 이름이 인 over-the-air 코어에서 AWS IoT Greengrass Core 소프트웨어를 업데이트하는 (OTA) 업데이트 작업을 생성합니다MyFirstGroup_Core. 이 명령에는 Amazon S3의 소프트웨어 업데이트 패키지에 대한 액세스를 허용하고를 신뢰할 수 있는 엔터티iot.amazonaws.com로 포함하는 IAM 역할이 필요합니다.


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

출력:


{
    "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"
}

자세한 내용은 OTA AWS IoT Greengrass 개발자 안내서의 IoT Greengrass Core 소프트웨어 업데이트를 참조하세요. AWS IoT

자세한 API 내용은 AWS CLI 명령 참조CreateSoftwareUpdateJob의 섹션을 참조하세요.

다음 코드 예시에서는 create-subscription-definition-version을 사용하는 방법을 보여 줍니다.

AWS CLI

구독 정의의 새 버전을 생성하려면

다음 create-subscription-definition-version 예제에서는 트리거 알림, 온도 입력 및 출력 상태라는 세 가지 구독이 포함된 구독 정의의 새 버전을 생성합니다.


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\"}]"

출력:


{
    "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"
}

자세한 API 내용은 AWS CLI 명령 참조CreateSubscriptionDefinitionVersion의 섹션을 참조하세요.

다음 코드 예시에서는 create-subscription-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

구독 정의를 생성하려면

다음 create-subscription-definition 예제에서는 구독 정의를 생성하고 초기 버전을 지정합니다. 초기 버전에는 세 가지 구독이 포함되어 있습니다. 하나는 커넥터가 구독하는 MQTT 주제에 대한 구독이고, 다른 하나는 함수가 AWS IoT로부터 온도 판독값을 수신하도록 허용하고, 다른 하나는 AWS IoT가 커넥터로부터 상태 정보를 수신하도록 허용합니다. 이 예제에서는 Lambda의 create-alias 명령을 사용하여 이전에 생성된 Lambda 함수 별칭에 ARN 대한를 제공합니다.


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\"}]}"

출력:


{
    "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"
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 커넥터 시작하기(CLI)를 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조CreateSubscriptionDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 delete-connector-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

커넥터 정의를 삭제하려면

다음 delete-connector-definition 예제에서는 지정된 Greengrass 커넥터 정의를 삭제합니다. 그룹에서 사용하는 커넥터 정의를 삭제하면 해당 그룹을 성공적으로 배포할 수 없습니다.


aws greengrass delete-connector-definition \
    --connector-definition-id "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8"

이 명령은 출력을 생성하지 않습니다.

자세한 API 내용은 AWS CLI 명령 참조DeleteConnectorDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 delete-core-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

코어 정의를 삭제하려면

다음 delete-core-definition 예제에서는 모든 버전을 포함하여 지정된 Greengrass 코어 정의를 삭제합니다. Greengrass 그룹과 연결된 코어를 삭제하면 해당 그룹을 성공적으로 배포할 수 없습니다.


aws greengrass delete-core-definition \
    --core-definition-id "ff36cc5f-9f98-4994-b468-9d9b6dc52abd"

이 명령은 출력을 생성하지 않습니다.

자세한 API 내용은 AWS CLI 명령 참조DeleteCoreDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 delete-device-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

디바이스 정의를 삭제하려면

다음 delete-device-definition 예제에서는 모든 버전을 포함하여 지정된 디바이스 정의를 삭제합니다. 그룹 버전에서 사용하는 디바이스 정의 버전을 삭제하면 그룹 버전을 성공적으로 배포할 수 없습니다.


aws greengrass delete-device-definition \
    --device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd"

이 명령은 출력을 생성하지 않습니다.

자세한 API 내용은 AWS CLI 명령 참조DeleteDeviceDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 delete-function-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

함수 정의를 삭제하려면

다음 delete-function-definition 예제에서는 지정된 Greengrass 함수 정의를 삭제합니다. 그룹에서 사용하는 함수 정의를 삭제하면 해당 그룹을 성공적으로 배포할 수 없습니다.


aws greengrass delete-function-definition \
    --function-definition-id "fd4b906a-dff3-4c1b-96eb-52ebfcfac06a"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS CLI 명령 참조DeleteFunctionDefinition의 섹션을 참조API하세요.

다음 코드 예시에서는 delete-group을 사용하는 방법을 보여 줍니다.

AWS CLI

그룹을 삭제하려면

다음 delete-group 예제에서는 지정된 Greengrass 그룹을 삭제합니다.


aws greengrass delete-group \
    --group-id "4e22bd92-898c-436b-ade5-434d883ff749"

이 명령은 출력을 생성하지 않습니다.

자세한 API 내용은 AWS CLI 명령 참조DeleteGroup의 섹션을 참조하세요.

다음 코드 예시에서는 delete-logger-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

로거 정의를 삭제하려면

다음 delete-logger-definition 예제에서는 모든 로거 정의 버전을 포함하여 지정된 로거 정의를 삭제합니다. 그룹 버전에서 사용하는 로거 정의 버전을 삭제하면 그룹 버전을 성공적으로 배포할 수 없습니다.


aws greengrass delete-logger-definition \
    --logger-definition-id "a454b62a-5d56-4ca9-bdc4-8254e1662cb0"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 IoT Greengrass Logs로 모니터링을 참조하세요. AWS IoT

자세한 API 내용은 AWS CLI 명령 참조DeleteLoggerDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 delete-resource-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

리소스 정의를 삭제하려면

다음 delete-resource-definition 예제에서는 모든 리소스 버전을 포함하여 지정된 리소스 정의를 삭제합니다. 그룹에서 사용하는 리소스 정의를 삭제하면 해당 그룹을 성공적으로 배포할 수 없습니다.


aws greengrass delete-resource-definition \
    --resource-definition-id "ad8c101d-8109-4b0e-b97d-9cc5802ab658"

이 명령은 출력을 생성하지 않습니다.

자세한 API 내용은 AWS CLI 명령 참조DeleteResourceDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 delete-subscription-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

구독 정의를 삭제하려면

다음 delete-subscription-definition 예제에서는 지정된 Greengrass 구독 정의를 삭제합니다. 그룹에서 사용 중인 구독을 삭제하면 해당 그룹을 성공적으로 배포할 수 없습니다.


aws greengrass delete-subscription-definition \
    --subscription-definition-id "cd6f1c37-d9a4-4e90-be94-01a7404f5967"

이 명령은 출력을 생성하지 않습니다.

자세한 API 내용은 AWS CLI 명령 참조DeleteSubscriptionDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 disassociate-role-from-group을 사용하는 방법을 보여 줍니다.

AWS CLI

Greengrass 그룹에서 역할을 연결 해제하려면

다음 disassociate-role-from-group 예제에서는 IAM 역할을 지정된 Greengrass 그룹에서 연결 해제합니다.


aws greengrass disassociate-role-from-group \
    --group-id 2494ee3f-7f8a-4e92-a78b-d205f808b84b

출력:


{
    "DisassociatedAt": "2019-09-10T20:05:49Z"
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 그룹 역할 구성을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조DisassociateRoleFromGroup의 섹션을 참조하세요.

다음 코드 예시에서는 disassociate-service-role-from-account을 사용하는 방법을 보여 줍니다.

AWS CLI

AWS 계정에서 서비스 역할을 연결 해제하려면

다음 disassociate-service-role-from-account 예제에서는 AWS 계정과 연결된 서비스 역할을 제거합니다. 어떤 AWS 리전에서도 서비스 역할을 사용하지 않는 경우 delete-role-policy 명령을 사용하여 관리AWSGreengrassResourceAccessRolePolicy형 정책을 역할에서 분리한 다음 delete-role 명령을 사용하여 역할을 삭제합니다.


aws greengrass disassociate-service-role-from-account

출력:


{
    "DisassociatedAt": "2019-06-25T22:12:55Z"
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 Greengrass 서비스 역할을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조DisassociateServiceRoleFromAccount의 섹션을 참조하세요.

다음 코드 예시에서는 get-associated-role을 사용하는 방법을 보여 줍니다.

AWS CLI

Greengrass 그룹과 연결된 역할을 가져오려면

다음 get-associated-role 예제에서는 지정된 Greengrass 그룹과 연결된 IAM 역할을 가져옵니다. 그룹 역할은 로컬 Lambda 함수 및 커넥터에서 AWS 서비스에 액세스하는 데 사용됩니다.


aws greengrass get-associated-role \
    --group-id 2494ee3f-7f8a-4e92-a78b-d205f808b84b

출력:


{
    "RoleArn": "arn:aws:iam::123456789012:role/GG-Group-Role",
    "AssociatedAt": "2019-09-10T20:03:30Z"
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 그룹 역할 구성을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조GetAssociatedRole의 섹션을 참조하세요.

다음 코드 예시에서는 get-bulk-deployment-status을 사용하는 방법을 보여 줍니다.

AWS CLI

대량 배포 상태를 확인하려면

다음 get-bulk-deployment-status 예제에서는 지정된 대량 배포 작업에 대한 상태 정보를 검색합니다. 이 예제에서는 배포할 그룹을 지정한 파일에 잘못된 입력 레코드가 있습니다.


aws greengrass get-bulk-deployment-status \
    --bulk-deployment-id "870fb41b-6288-4e0c-bc76-a7ba4b4d3267"

출력:


{
    "BulkDeploymentMetrics": {
        "InvalidInputRecords": 1,
        "RecordsProcessed": 1,
        "RetryAttempts": 0
    },
    "BulkDeploymentStatus": "Completed",
    "CreatedAt": "2019-06-25T16:11:33.265Z",
    "tags": {}
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 그룹에 대한 대량 배포 생성을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조GetBulkDeploymentStatus의 섹션을 참조하세요.

다음 코드 예시에서는 get-connectivity-info을 사용하는 방법을 보여 줍니다.

AWS CLI

Greengrass 코어의 연결 정보를 가져오려면

다음 get-connectivity-info 예제에서는 디바이스가 지정된 Greengrass 코어에 연결하는 데 사용할 수 있는 엔드포인트를 표시합니다. 연결 정보는 IP 주소 또는 도메인 이름의 목록으로, 해당 포트 번호 및 선택적 고객 정의 메타데이터를 포함합니다.


aws greengrass get-connectivity-info \
    --thing-name "MyGroup_Core"

출력:


{
    "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"
        }
    ]
}

자세한 API 내용은 AWS CLI 명령 참조GetConnectivityInfo의 섹션을 참조하세요.

다음 코드 예시에서는 get-connector-definition-version을 사용하는 방법을 보여 줍니다.

AWS CLI

커넥터 정의의 특정 버전에 대한 정보를 검색하려면

다음 get-connector-definition-version 예제에서는 지정된 커넥터 정의의 지정된 버전에 대한 정보를 검색합니다. 커넥터 정의IDs의 모든 버전의를 검색하려면 list-connector-definition-versions 명령을 사용합니다. 커넥터 정의에 추가된 마지막 버전의 ID를 검색하려면 get-connector-definition 명령을 사용하고 LatestVersion 속성을 확인합니다.


aws greengrass get-connector-definition-version \
    --connector-definition-id "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8" \
    --connector-definition-version-id "63c57963-c7c2-4a26-a7e2-7bf478ea2623"

출력:


{
    "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"
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 Greengrass 커넥터를 사용하여 서비스 및 프로토콜과 통합을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조GetConnectorDefinitionVersion의 섹션을 참조하세요.

다음 코드 예시에서는 get-connector-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

커넥터 정의에 대한 정보를 검색하려면

다음 get-connector-definition 예제에서는 지정된 커넥터 정의에 대한 정보를 검색합니다. 커넥터 정의IDs의를 검색하려면 list-connector-definitions 명령을 사용합니다.


aws greengrass get-connector-definition \
    --connector-definition-id "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8"

출력:


{
    "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": {}
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 Greengrass 커넥터를 사용하여 서비스 및 프로토콜과 통합을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조GetConnectorDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 get-core-definition-version을 사용하는 방법을 보여 줍니다.

AWS CLI

Greengrass 코어 정의의 특정 버전에 대한 세부 정보를 검색하려면

다음 get-core-definition-version 예제에서는 지정된 코어 정의의 지정된 버전에 대한 정보를 검색합니다. 코어 정의IDs의 모든 버전의를 검색하려면 list-core-definition-versions 명령을 사용합니다. 코어 정의에 추가된 마지막 버전의 ID를 검색하려면 get-core-definition 명령을 사용하여 LatestVersion 속성을 확인합니다.


aws greengrass get-core-definition-version \
    --core-definition-id "c906ed39-a1e3-4822-a981-7b9bd57b4b46"  \
    --core-definition-version-id "42aeeac3-fd9d-4312-a8fd-ffa9404a20e0"

출력:


{
    "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"
}

자세한 API 내용은 AWS CLI 명령 참조GetCoreDefinitionVersion의 섹션을 참조하세요.

다음 코드 예시에서는 get-core-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

Greengrass 코어 정의에 대한 세부 정보를 검색하려면

다음 get-core-definition 예제에서는 지정된 코어 정의에 대한 정보를 검색합니다. 코어 정의IDs의를 검색하려면 list-core-definitions 명령을 사용합니다.


aws greengrass get-core-definition \
    --core-definition-id "c906ed39-a1e3-4822-a981-7b9bd57b4b46"

출력:


{
    "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": {}
}

자세한 API 내용은 AWS CLI 명령 참조GetCoreDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 get-deployment-status을 사용하는 방법을 보여 줍니다.

AWS CLI

배포 상태를 검색하려면

다음 get-deployment-status 예제에서는 지정된 Greengrass 그룹의 지정된 배포 상태를 검색합니다. 배포 ID를 가져오려면 list-deployments 명령을 사용하고 그룹 ID를 지정합니다.


aws greengrass get-deployment-status \
    --group-id "1013db12-8b58-45ff-acc7-704248f66731" \
    --deployment-id "1065b8a0-812b-4f21-9d5d-e89b232a530f"

출력:


{
    "DeploymentStatus": "Success",
    "DeploymentType": "NewDeployment",
    "UpdatedAt": "2019-06-18T17:04:44.761Z"
}

자세한 API 내용은 AWS CLI 명령 참조GetDeploymentStatus의 섹션을 참조하세요.

다음 코드 예시에서는 get-device-definition-version을 사용하는 방법을 보여 줍니다.

AWS CLI

디바이스 정의 버전을 가져오려면

다음 get-device-definition-version 예제에서는 지정된 디바이스 정의의 지정된 버전에 대한 정보를 검색합니다. IDs 모든 버전의 디바이스 정의를 검색하려면 list-device-definition-versions 명령을 사용합니다. 디바이스 정의에 추가된 마지막 버전의 ID를 검색하려면 get-device-definition 명령을 사용하여 LatestVersion 속성을 확인합니다.


aws greengrass get-device-definition-version \
    --device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd" \
    --device-definition-version-id "83c13984-6fed-447e-84d5-5b8aa45d5f71"

출력:


{
    "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"
}

자세한 API 내용은 AWS CLI 명령 참조GetDeviceDefinitionVersion의 섹션을 참조하세요.

다음 코드 예시에서는 get-device-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

디바이스 정의를 가져오려면

다음 get-device-definition 예제에서는 지정된 디바이스 정의에 대한 정보를 검색합니다. 디바이스 정의IDs의를 검색하려면 list-device-definitions 명령을 사용합니다.


aws greengrass get-device-definition \
    --device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd"

출력:


{
    "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"
}

자세한 API 내용은 AWS CLI 명령 참조GetDeviceDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 get-function-definition-version을 사용하는 방법을 보여 줍니다.

AWS CLI

Lambda 함수의 특정 버전에 대한 세부 정보를 검색하려면

다음은 지정된 함수 정의의 지정된 버전에 대한 정보를 get-function-definition-version 검색합니다. 함수 정의IDs의 모든 버전의를 검색하려면 list-function-definition-versions 명령을 사용합니다. 함수 정의에 추가된 마지막 버전의 ID를 검색하려면 get-function-definition 명령을 사용하여 LatestVersion 속성을 확인합니다.


aws greengrass get-function-definition-version \
    --function-definition-id "063f5d1a-1dd1-40b4-9b51-56f8993d0f85" \
    --function-definition-version-id "9748fda7-1589-4fcc-ac94-f5559e88678b"

출력:


{
    "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"
}

자세한 API 내용은 AWS CLI 명령 참조GetFunctionDefinitionVersion의 섹션을 참조하세요.

다음 코드 예시에서는 get-function-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

함수 정의를 검색하려면

다음 get-function-definition 예제에서는 지정된 함수 정의에 대한 세부 정보를 표시합니다. 함수 정의IDs의를 검색하려면 list-function-definitions 명령을 사용합니다.


aws greengrass get-function-definition \
    --function-definition-id "063f5d1a-1dd1-40b4-9b51-56f8993d0f85"

출력:


{
    "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": {}
}

자세한 API 내용은 AWS CLI 명령 참조GetFunctionDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 get-group-certificate-authority을 사용하는 방법을 보여 줍니다.

AWS CLI

Greengrass 그룹과 연결된 CA를 검색하려면

다음 get-group-certificate-authority 예제에서는 지정된 Greengrass 그룹과 연결된 인증 기관(CA)을 검색합니다. 인증 기관 ID를 가져오려면 list-group-certificate-authorities 명령을 사용하고 그룹 ID를 지정합니다.


aws greengrass get-group-certificate-authority \
    --group-id "1013db12-8b58-45ff-acc7-704248f66731" \
    --certificate-authority-id "f0430e1736ea8ed30cc5d5de9af67a7e3586bad9ae4d89c2a44163f65fdd8cf6"

출력:


{
    "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"
}

자세한 API 내용은 AWS CLI 명령 참조GetGroupCertificateAuthority의 섹션을 참조하세요.

다음 코드 예시에서는 get-group-certificate-configuration을 사용하는 방법을 보여 줍니다.

AWS CLI

Greengrass 그룹에서 사용하는 인증 기관의 구성을 검색하려면

다음 get-group-certificate-configuration 예제에서는 지정된 Greengrass 그룹에서 사용하는 인증 기관(CA)의 구성을 검색합니다.


aws greengrass get-group-certificate-configuration \
    --group-id "1013db12-8b58-45ff-acc7-704248f66731"

출력:


{
    "CertificateAuthorityExpiryInMilliseconds": 2524607999000,
    "CertificateExpiryInMilliseconds": 604800000,
    "GroupId": "1013db12-8b58-45ff-acc7-704248f66731"
}

자세한 API 내용은 AWS CLI 명령 참조GetGroupCertificateConfiguration의 섹션을 참조하세요.

다음 코드 예시에서는 get-group-version을 사용하는 방법을 보여 줍니다.

AWS CLI

Greengrass 그룹의 버전에 대한 정보를 검색하려면

다음 get-group-version 예제에서는 지정된 그룹의 지정된 버전에 대한 정보를 검색합니다. 그룹의 IDs 모든 버전의를 검색하려면 list-group-versions 명령을 사용합니다. 그룹에 추가된 마지막 버전의 ID를 검색하려면 get-group 명령을 사용하여 LatestVersion 속성을 확인합니다.


aws greengrass get-group-version \
    --group-id "1013db12-8b58-45ff-acc7-704248f66731"  \
    --group-version-id "115136b3-cfd7-4462-b77f-8741a4b00e5e"

출력:


{
    "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"
}

자세한 API 내용은 AWS CLI 명령 참조GetGroupVersion의 섹션을 참조하세요.

다음 코드 예시에서는 get-group을 사용하는 방법을 보여 줍니다.

AWS CLI

Greengrass 그룹에 대한 정보를 검색하려면

다음 get-group 예제에서는 지정된 Greengrass 그룹에 대한 정보를 검색합니다. 그룹의 IDs를 검색하려면 list-groups 명령을 사용합니다.


aws greengrass get-group \
    --group-id "1013db12-8b58-45ff-acc7-704248f66731"

출력:


{
    "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": {}
}

자세한 API 내용은 AWS CLI 명령 참조GetGroup의 섹션을 참조하세요.

다음 코드 예시에서는 get-logger-definition-version을 사용하는 방법을 보여 줍니다.

AWS CLI

로거 정의 버전에 대한 정보를 검색하려면

다음 get-logger-definition-version 예제에서는 지정된 로거 정의의 지정된 버전에 대한 정보를 검색합니다. 로거 정의IDs의 모든 버전의를 검색하려면 list-logger-definition-versions 명령을 사용합니다. 로거 정의에 추가된 마지막 버전의 ID를 검색하려면 get-logger-definition 명령을 사용하여 LatestVersion 속성을 확인합니다.


aws greengrass get-logger-definition-version \
    --logger-definition-id "49eeeb66-f1d3-4e34-86e3-3617262abf23" \
    --logger-definition-version-id "5e3f6f64-a565-491e-8de0-3c0d8e0f2073"

출력:


{
    "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"
}

자세한 API 내용은 AWS CLI 명령 참조GetLoggerDefinitionVersion의 섹션을 참조하세요.

다음 코드 예시에서는 get-logger-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

로거 정의에 대한 정보를 검색하려면

다음 get-logger-definition 예제에서는 지정된 로거 정의에 대한 정보를 검색합니다. 로거 정의IDs의를 검색하려면 list-logger-definitions 명령을 사용합니다.


aws greengrass get-logger-definition \
    --logger-definition-id "49eeeb66-f1d3-4e34-86e3-3617262abf23"

출력:


{
    "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": {}
}

자세한 API 내용은 AWS CLI 명령 참조GetLoggerDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 get-resource-definition-version을 사용하는 방법을 보여 줍니다.

AWS CLI

리소스 정의의 특정 버전에 대한 정보를 검색하려면

다음 get-resource-definition-version 예제에서는 지정된 리소스 정의의 지정된 버전에 대한 정보를 검색합니다. 리소스 정의IDs의 모든 버전의를 검색하려면 list-resource-definition-versions 명령을 사용합니다. 리소스 정의에 추가된 마지막 버전의 ID를 검색하려면 get-resource-definition 명령을 사용하여 LatestVersion 속성을 확인합니다.


aws greengrass get-resource-definition-version \
    --resource-definition-id "ad8c101d-8109-4b0e-b97d-9cc5802ab658" \
    --resource-definition-version-id "26e8829a-491a-464d-9c87-664bf6f6f2be"

출력:


{
    "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"
}

자세한 API 내용은 AWS CLI 명령 참조GetResourceDefinitionVersion의 섹션을 참조하세요.

다음 코드 예시에서는 get-resource-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

리소스 정의에 대한 정보를 검색하려면

다음 get-resource-definition 예제에서는 지정된 리소스 정의에 대한 정보를 검색합니다. 리소스 정의IDs의를 검색하려면 list-resource-definitions 명령을 사용합니다.


aws greengrass get-resource-definition \
    --resource-definition-id "ad8c101d-8109-4b0e-b97d-9cc5802ab658"

출력:


{
    "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": {}
}

자세한 API 내용은 AWS CLI 명령 참조GetResourceDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 get-service-role-for-account을 사용하는 방법을 보여 줍니다.

AWS CLI

계정에 연결된 서비스 역할에 대한 세부 정보를 검색하려면

다음 get-service-role-for-account 예제에서는 AWS 계정에 연결된 서비스 역할에 대한 정보를 검색합니다.


aws greengrass get-service-role-for-account

출력:


{
    "AssociatedAt": "2018-10-18T15:59:20Z",
    "RoleArn": "arn:aws:iam::123456789012:role/service-role/Greengrass_ServiceRole"
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 Greengrass 서비스 역할을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조GetServiceRoleForAccount의 섹션을 참조하세요.

다음 코드 예시에서는 get-subscription-definition-version을 사용하는 방법을 보여 줍니다.

AWS CLI

구독 정의의 특정 버전에 대한 정보를 검색하려면

다음 get-subscription-definition-version 예제에서는 지정된 구독 정의의 지정된 버전에 대한 정보를 검색합니다. 구독 정의IDs의 모든 버전의를 검색하려면 list-subscription-definition-versions 명령을 사용합니다. 구독 정의에 추가된 마지막 버전의 ID를 검색하려면 get-subscription-definition 명령을 사용하여 LatestVersion 속성을 확인합니다.


aws greengrass get-subscription-definition-version \
    --subscription-definition-id "70e49321-83d5-45d2-bc09-81f4917ae152" \
    --subscription-definition-version-id "88ae8699-12ac-4663-ba3f-4d7f0519140b"

출력:


{
    "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"
}

자세한 API 내용은 AWS CLI 명령 참조GetSubscriptionDefinitionVersion의 섹션을 참조하세요.

다음 코드 예시에서는 get-subscription-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

구독 정의에 대한 정보를 검색하려면

다음 get-subscription-definition 예제에서는 지정된 구독 정의에 대한 정보를 검색합니다. 구독 정의IDs의를 검색하려면 list-subscription-definitions 명령을 사용합니다.


aws greengrass get-subscription-definition \
    --subscription-definition-id "70e49321-83d5-45d2-bc09-81f4917ae152"

출력:


{
    "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": {}
}

자세한 API 내용은 AWS CLI 명령 참조GetSubscriptionDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 get-thing-runtime-configuration을 사용하는 방법을 보여 줍니다.

AWS CLI

Greengrass 코어의 런타임 구성을 검색하려면

다음 get-thing-runtime-configuration 예제에서는 Greengrass 코어의 런타임 구성을 검색합니다. 런타임 구성을 검색하려면 먼저 update-thing-runtime-configuration 명령을 사용하여 코어에 대한 런타임 구성을 생성해야 합니다.


aws greengrass get-thing-runtime-configuration \
    --thing-name SampleGreengrassCore

출력:


{
    "RuntimeConfiguration": {
        "TelemetryConfiguration": {
            "ConfigurationSyncStatus": "OutOfSync",
            "Telemetry": "On"
        }
    }
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 원격 측정 설정 구성을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조GetThingRuntimeConfiguration의 섹션을 참조하세요.

다음 코드 예시에서는 list-bulk-deployment-detailed-reports을 사용하는 방법을 보여 줍니다.

AWS CLI

대량 배포의 개별 배포에 대한 정보를 나열하려면

다음 list-bulk-deployment-detailed-reports 예제에서는 상태를 포함하여 대량 배포 작업의 개별 배포에 대한 정보를 표시합니다.


aws greengrass list-bulk-deployment-detailed-reports \
    --bulk-deployment-id 42ce9c42-489b-4ed4-b905-8996aa50ef9d

출력:


{
    "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"
        },
        ...
    ]
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 그룹에 대한 대량 배포 생성을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조ListBulkDeploymentDetailedReports의 섹션을 참조하세요.

다음 코드 예시에서는 list-bulk-deployments을 사용하는 방법을 보여 줍니다.

AWS CLI

대량 배포를 나열하려면

다음 list-bulk-deployments 예제에서는 모든 대량 배포를 나열합니다.


aws greengrass list-bulk-deployments

출력:


{
    "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"
        }
    ]
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 그룹에 대한 대량 배포 생성을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조ListBulkDeployments의 섹션을 참조하세요.

다음 코드 예시에서는 list-connector-definition-versions을 사용하는 방법을 보여 줍니다.

AWS CLI

커넥터 정의에 사용할 수 있는 버전을 나열하려면

다음 list-connector-definition-versions 예제에서는 지정된 커넥터 정의에 사용할 수 있는 버전을 나열합니다. list-connector-definitions 명령을 사용하여 커넥터 정의 ID를 가져옵니다.


aws greengrass list-connector-definition-versions \
    --connector-definition-id "b5c4ebfd-f672-49a3-83cd-31c7216a7bb8"

출력:


{
    "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"
        }
    ]
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 Greengrass 커넥터를 사용하여 서비스 및 프로토콜과 통합을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조ListConnectorDefinitionVersions의 섹션을 참조하세요.

다음 코드 예시에서는 list-connector-definitions을 사용하는 방법을 보여 줍니다.

AWS CLI

정의된 Greengrass 커넥터를 나열하려면

다음 list-connector-definitions 예제에서는 AWS 계정에 정의된 모든 Greengrass 커넥터를 나열합니다.


aws greengrass list-connector-definitions

출력:


{
    "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"
        }
    ]
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 Greengrass 커넥터를 사용하여 서비스 및 프로토콜과 통합을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조ListConnectorDefinitions의 섹션을 참조하세요.

다음 코드 예시에서는 list-core-definition-versions을 사용하는 방법을 보여 줍니다.

AWS CLI

Greengrass 코어 정의의 버전을 나열하려면

다음 list-core-definitions 예제에서는 지정된 Greengrass 코어 정의의 모든 버전을 나열합니다. list-core-definitions 명령을 사용하여 버전 ID를 가져올 수 있습니다.


aws greengrass list-core-definition-versions \
    --core-definition-id "eaf280cb-138c-4d15-af36-6f681a1348f7"

출력:


{
    "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"
        }
    ]
}

자세한 API 내용은 AWS CLI 명령 참조ListCoreDefinitionVersions의 섹션을 참조하세요.

다음 코드 예시에서는 list-core-definitions을 사용하는 방법을 보여 줍니다.

AWS CLI

Greengrass 코어 정의를 나열하려면

다음 list-core-definitions 예제에서는 AWS 계정에 대한 모든 Greengrass 코어 정의를 나열합니다.


aws greengrass list-core-definitions

출력:


{
    "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"
        }
    ]
}

자세한 API 내용은 AWS CLI 명령 참조ListCoreDefinitions의 섹션을 참조하세요.

다음 코드 예시에서는 list-deployments을 사용하는 방법을 보여 줍니다.

AWS CLI

Greengrass 그룹의 배포를 나열하려면

다음 list-deployments 예제에서는 지정된 Greengrass 그룹의 배포를 나열합니다. list-groups 명령을 사용하여 그룹 ID를 조회할 수 있습니다.


aws greengrass list-deployments \
    --group-id "1013db12-8b58-45ff-acc7-704248f66731"

출력:


{
    "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"
        }
    ]
}

자세한 API 내용은 AWS CLI 명령 참조ListDeployments의 섹션을 참조하세요.

다음 코드 예시에서는 list-device-definition-versions을 사용하는 방법을 보여 줍니다.

AWS CLI

디바이스 정의의 버전을 나열하려면

다음 list-device-definition-versions 예제에서는 지정된 디바이스 정의와 연결된 디바이스 정의 버전을 표시합니다.


aws greengrass list-device-definition-versions \
    --device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd"

출력:


{
    "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"
        }
    ]
}

자세한 API 내용은 AWS CLI 명령 참조ListDeviceDefinitionVersions의 섹션을 참조하세요.

다음 코드 예시에서는 list-device-definitions을 사용하는 방법을 보여 줍니다.

AWS CLI

디바이스 정의를 나열하려면

다음 list-device-definitions 예제에서는 지정된 AWS 리전의 AWS 계정에서 디바이스 정의에 대한 세부 정보를 표시합니다.


aws greengrass list-device-definitions \
    --region us-west-2

출력:


{
    "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"
        }
    ]
}

자세한 API 내용은 AWS CLI 명령 참조ListDeviceDefinitions의 섹션을 참조하세요.

다음 코드 예시에서는 list-function-definition-versions을 사용하는 방법을 보여 줍니다.

AWS CLI

Lambda 함수의 버전을 나열하려면

다음 list-function-definition-versions 예제에서는 지정된 Lambda 함수의 모든 버전을 나열합니다. list-function-definitions 명령을 사용하여 ID를 가져올 수 있습니다.


aws greengrass list-function-definition-versions \
    --function-definition-id "063f5d1a-1dd1-40b4-9b51-56f8993d0f85"

출력:


{
    "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"
        }
    ]
}

자세한 API 내용은 AWS CLI 명령 참조ListFunctionDefinitionVersions의 섹션을 참조하세요.

다음 코드 예시에서는 list-function-definitions을 사용하는 방법을 보여 줍니다.

AWS CLI

Lambda 함수를 나열하려면

다음 list-function-definitions 예제에서는 AWS 계정에 정의된 모든 Lambda 함수를 나열합니다.


aws greengrass list-function-definitions

출력:


{
    "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"
        }
    ]
}

자세한 API 내용은 AWS CLI 명령 참조ListFunctionDefinitions의 섹션을 참조하세요.

다음 코드 예시에서는 list-group-certificate-authorities을 사용하는 방법을 보여 줍니다.

AWS CLI

그룹의 현재 CAs를 나열하려면

다음 list-group-certificate-authorities 예제에서는 지정된 Greengrass 그룹의 현재 인증 기관(CAs)을 나열합니다.


aws greengrass list-group-certificate-authorities \
    --group-id "1013db12-8b58-45ff-acc7-704248f66731"

출력:


{
    "GroupCertificateAuthorities": [
        {
            "GroupCertificateAuthorityArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731/certificateauthorities/f0430e1736ea8ed30cc5d5de9af67a7e3586bad9ae4d89c2a44163f65fdd8cf6",
            "GroupCertificateAuthorityId": "f0430e1736ea8ed30cc5d5de9af67a7e3586bad9ae4d89c2a44163f65fdd8cf6"
        }
    ]
}

자세한 API 내용은 AWS CLI 명령 참조ListGroupCertificateAuthorities의 섹션을 참조하세요.

다음 코드 예시에서는 list-group-versions을 사용하는 방법을 보여 줍니다.

AWS CLI

Greengrass 그룹의 버전을 나열하려면

다음 list-group-versions 예제에서는 지정된 Greengrass 그룹의 버전을 나열합니다.


aws greengrass list-group-versions \
    --group-id "1013db12-8b58-45ff-acc7-704248f66731"

출력:


{
    "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"
        }
    ]
}

자세한 API 내용은 AWS CLI 명령 참조ListGroupVersions의 섹션을 참조하세요.

다음 코드 예시에서는 list-groups을 사용하는 방법을 보여 줍니다.

AWS CLI

Greengrass 그룹을 나열하려면

다음 list-groups 예제에서는 AWS 계정에 정의된 모든 Greengrass 그룹을 나열합니다.


aws greengrass list-groups

출력:


{
    "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"
        }
    ]
}

자세한 API 내용은 AWS CLI 명령 참조ListGroups의 섹션을 참조하세요.

다음 코드 예시에서는 list-logger-definition-versions을 사용하는 방법을 보여 줍니다.

AWS CLI

로거 정의의 버전 목록을 가져오려면

다음 list-logger-definition-versions 예제에서는 지정된 로거 정의의 모든 버전 목록을 가져옵니다.


aws greengrass list-logger-definition-versions \
    --logger-definition-id "49eeeb66-f1d3-4e34-86e3-3617262abf23"

출력:


{
    "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"
        }
    ]
}

자세한 API 내용은 AWS CLI 명령 참조ListLoggerDefinitionVersions의 섹션을 참조하세요.

다음 코드 예시에서는 list-logger-definitions을 사용하는 방법을 보여 줍니다.

AWS CLI

로거 정의 목록을 가져오려면

다음 list-logger-definitions 예제에서는 AWS 계정에 대한 모든 로거 정의를 나열합니다.


aws greengrass list-logger-definitions

출력:


{
    "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"
        }
    ]
}

자세한 API 내용은 AWS CLI 명령 참조ListLoggerDefinitions의 섹션을 참조하세요.

다음 코드 예시에서는 list-resource-definition-versions을 사용하는 방법을 보여 줍니다.

AWS CLI

리소스 정의의 버전을 나열하려면

다음 list-resource-definition-versions 예제에서는 지정된 Greengrass 리소스의 버전을 나열합니다.


aws greengrass list-resource-definition-versions \
    --resource-definition-id "ad8c101d-8109-4b0e-b97d-9cc5802ab658"

출력:


{
    "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"
        }
    ]
}

자세한 내용은 AWS CLI 명령 참조ListResourceDefinitionVersions의 섹션을 참조API하세요.

다음 코드 예시에서는 list-resource-definitions을 사용하는 방법을 보여 줍니다.

AWS CLI

정의된 리소스를 나열하려면

다음 list-resource-definitions 예제에서는 사용할 AWS IoT Greengrass에 대해 정의된 리소스를 나열합니다.


aws greengrass list-resource-definitions

출력:


{
    "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"
        }
    ]
}

자세한 API 내용은 AWS CLI 명령 참조ListResourceDefinitions의 섹션을 참조하세요.

다음 코드 예시에서는 list-subscription-definition-versions을 사용하는 방법을 보여 줍니다.

AWS CLI

구독 정의의 버전을 나열하려면

다음 list-subscription-definition-versions 예제에서는 지정된 구독의 모든 버전을 나열합니다. list-subscription-definitions 명령을 사용하여 구독 ID를 조회할 수 있습니다.


aws greengrass list-subscription-definition-versions \
    --subscription-definition-id "70e49321-83d5-45d2-bc09-81f4917ae152"

출력:


{
    "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"
        }
    ]
}

자세한 API 내용은 AWS CLI 명령 참조ListSubscriptionDefinitionVersions의 섹션을 참조하세요.

다음 코드 예시에서는 list-subscription-definitions을 사용하는 방법을 보여 줍니다.

AWS CLI

목록 구독 정의를 가져오려면

다음 list-subscription-definitions 예제에서는 AWS 계정에 정의된 모든 AWS IoT Greengrass 구독을 나열합니다.


aws greengrass list-subscription-definitions

출력:


{
    "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"
        }
    ]
}

자세한 API 내용은 AWS CLI 명령 참조ListSubscriptionDefinitions의 섹션을 참조하세요.

다음 코드 예시에서는 list-tags-for-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

리소스에 연결된 태그를 나열하려면

다음 list-tags-for-resource 예제에서는 지정된 리소스에 연결된 태그와 해당 값을 나열합니다.


aws greengrass list-tags-for-resource \
    --resource-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/resources/ad8c101d-8109-4b0e-b97d-9cc5802ab658"

출력:


{
    "tags": {
        "ResourceSubType": "USB",
        "ResourceType": "Device"
    }
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 Greengrass 리소스 태그 지정을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조ListTagsForResource의 섹션을 참조하세요.

다음 코드 예시에서는 reset-deployments을 사용하는 방법을 보여 줍니다.

AWS CLI

Greengrass 그룹의 배포 정보를 정리하려면

다음 reset-deployments 예제에서는 지정된 Greengrass 그룹에 대한 배포 정보를 정리합니다. 를 추가하면 코어 디바이스--force option가 응답할 때까지 기다리지 않고 배포 정보가 재설정됩니다.


aws greengrass reset-deployments \
    --group-id "1402daf9-71cf-4cfe-8be0-d5e80526d0d8" \
    --force

출력:


{
    "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"
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 배포 재설정을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조ResetDeployments의 섹션을 참조하세요.

다음 코드 예시에서는 start-bulk-deployment을 사용하는 방법을 보여 줍니다.

AWS CLI

대량 배포 작업을 시작하려면

다음 start-bulk-deployment 예제에서는 S3 버킷에 저장된 파일을 사용하여 배포할 그룹을 지정하는 대량 배포 작업을 시작합니다.


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\"}"

출력:


{
    "BulkDeploymentArn": "arn:aws:greengrass:us-west-2:123456789012:/greengrass/bulk/deployments/870fb41b-6288-4e0c-bc76-a7ba4b4d3267",
    "BulkDeploymentId": "870fb41b-6288-4e0c-bc76-a7ba4b4d3267"
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 그룹에 대한 대량 배포 생성을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조StartBulkDeployment의 섹션을 참조하세요.

다음 코드 예시에서는 stop-bulk-deployment을 사용하는 방법을 보여 줍니다.

AWS CLI

대량 배포를 중지하려면

다음 stop-bulk-deployment 예제에서는 지정된 대량 배포를 중지합니다. 완료된 대량 배포를 중지하려고 하면 다음과 같은 오류가 발생합니다. InvalidInputException: Cannot change state of finished execution.


aws greengrass stop-bulk-deployment \
    --bulk-deployment-id "870fb41b-6288-4e0c-bc76-a7ba4b4d3267"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 그룹에 대한 대량 배포 생성을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조StopBulkDeployment의 섹션을 참조하세요.

다음 코드 예시에서는 tag-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

리소스에 태그를 적용하려면

다음 tag-resource 예제에서는 지정된 Greengrass 리소스ResourceTypeResourceSubType에 및 두 개의 태그를 적용합니다. 이 작업은 새 태그와 값을 추가하거나 기존 태그의 값을 업데이트할 수 있습니다. 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"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 Greengrass 리소스 태그 지정을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조TagResource의 섹션을 참조하세요.

다음 코드 예시에서는 untag-resource을 사용하는 방법을 보여 줍니다.

AWS CLI

리소스에서 태그와 해당 값을 제거하려면

다음 untag-resource 예제에서는 키가 지정된 Greengrass 그룹에서 Category인 태그를 제거합니다. 지정된 리소스에 대한 키Category가 없으면 오류가 반환되지 않습니다.


aws greengrass untag-resource \
    --resource-arn "arn:aws:greengrass:us-west-2:123456789012:/greengrass/groups/1013db12-8b58-45ff-acc7-704248f66731" \
    --tag-keys "Category"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 Greengrass 리소스 태그 지정을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조UntagResource의 섹션을 참조하세요.

다음 코드 예시에서는 update-connectivity-info을 사용하는 방법을 보여 줍니다.

AWS CLI

Greengrass 코어의 연결 정보를 업데이트하려면

다음 update-connectivity-info 예제에서는 디바이스가 지정된 Greengrass 코어에 연결하는 데 사용할 수 있는 엔드포인트를 변경합니다. 연결 정보는 IP 주소 또는 도메인 이름의 목록으로, 해당 포트 번호 및 선택적 고객 정의 메타데이터를 포함합니다. 로컬 네트워크가 변경될 때 연결 정보를 업데이트해야 할 수 있습니다.


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\"}]"

출력:


{
    "Version": "312de337-59af-4cf9-a278-2a23bd39c300"
}

자세한 API 내용은 AWS CLI 명령 참조UpdateConnectivityInfo의 섹션을 참조하세요.

다음 코드 예시에서는 update-connector-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

커넥터 정의의 이름을 업데이트하려면

다음 update-connector-definition 예제에서는 지정된 커넥터 정의의 이름을 업데이트합니다. 커넥터의 세부 정보를 업데이트하려면 create-connector-definition-version 명령을 사용하여 새 버전을 생성합니다.


aws greengrass update-connector-definition \
    --connector-definition-id "55d0052b-0d7d-44d6-b56f-21867215e118" \
    --name "GreengrassConnectors2019"

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 커넥터를 사용하여 서비스 및 프로토콜과 통합을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조UpdateConnectorDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 update-core-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

코어 정의를 업데이트하려면

다음 update-core-definition 예제에서는 지정된 코어 정의의 이름을 변경합니다. 코어 정의의 name 속성만 업데이트할 수 있습니다.


aws greengrass update-core-definition \
    --core-definition-id "582efe12-b05a-409e-9a24-a2ba1bcc4a12" \
    --name "MyCoreDevices"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 IoT Greengrass Core 구성을 참조하세요. AWS IoT

자세한 내용은 AWS CLI 명령 참조UpdateCoreDefinition의 섹션을 참조API하세요.

다음 코드 예시에서는 update-device-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

디바이스 정의를 업데이트하려면

다음 update-device-definition 예제에서는 지정된 디바이스 정의의 이름을 변경합니다. 디바이스 정의의 name 속성만 업데이트할 수 있습니다.


aws greengrass update-device-definition \
    --device-definition-id "f9ba083d-5ad4-4534-9f86-026a45df1ccd" \
    --name "TemperatureSensors"

이 명령은 출력을 생성하지 않습니다.

자세한 API 내용은 AWS CLI 명령 참조UpdateDeviceDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 update-function-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

함수 정의의 이름을 업데이트하려면

다음 update-function-definition 예제에서는 지정된 함수 정의의 이름을 업데이트합니다. 함수의 세부 정보를 업데이트하려면 create-function-definition-version 명령을 사용하여 새 버전을 생성합니다.


aws greengrass update-function-definition \
    --function-definition-id "e47952bd-dea9-4e2c-a7e1-37bbe8807f46" \
    --name ObsoleteFunction

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 IoT Greengrass 개발자 안내서의 로컬 Lambda 함수 실행을 참조하세요. AWS IoT

자세한 API 내용은 AWS CLI 명령 참조UpdateFunctionDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 update-group-certificate-configuration을 사용하는 방법을 보여 줍니다.

AWS CLI

그룹 인증서의 만료를 업데이트하려면

다음 update-group-certificate-configuration 예제에서는 지정된 그룹에 대해 생성된 인증서에 대해 10일의 만료를 설정합니다.


aws greengrass update-group-certificate-configuration \
    --group-id "8eaadd72-ce4b-4f15-892a-0cc4f3a343f1" \
    --certificate-expiry-in-milliseconds 864000000

출력:


{
    "CertificateExpiryInMilliseconds": 864000000,
    "CertificateAuthorityExpiryInMilliseconds": 2524607999000,
    "GroupId": "8eaadd72-ce4b-4f15-892a-0cc4f3a343f1"
}

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 IoT Greengrass 보안을 참조하세요. AWS IoT

자세한 API 내용은 AWS CLI 명령 참조UpdateGroupCertificateConfiguration의 섹션을 참조하세요.

다음 코드 예시에서는 update-group을 사용하는 방법을 보여 줍니다.

AWS CLI

그룹 이름을 업데이트하려면

다음 update-group 예제에서는 지정된 Greengrass 그룹의 이름을 업데이트합니다. 그룹의 세부 정보를 업데이트하려면 create-group-version 명령을 사용하여 새 버전을 생성합니다.


aws greengrass update-group \
    --group-id "1402daf9-71cf-4cfe-8be0-d5e80526d0d8" \
    --name TestGroup4of6

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 Configure AWS IoT Greengrass onIoT를 참조하세요. AWS IoT

자세한 API 내용은 AWS CLI 명령 참조UpdateGroup의 섹션을 참조하세요.

다음 코드 예시에서는 update-logger-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

로거 정의를 업데이트하려면

다음 update-logger-definition 예제에서는 지정된 로거 정의의 이름을 변경합니다. 로거 정의의 name 속성만 업데이트할 수 있습니다.


aws greengrass update-logger-definition \
    --logger-definition-id "a454b62a-5d56-4ca9-bdc4-8254e1662cb0" \
    --name "LoggingConfigsForSensors"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 IoT Greengrass Logs로 모니터링을 참조하세요. AWS IoT

자세한 API 내용은 AWS CLI 명령 참조UpdateLoggerDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 update-resource-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

리소스 정의의 이름을 업데이트하려면

다음 update-resource-definition 예제에서는 지정된 리소스 정의의 이름을 업데이트합니다. 리소스의 세부 정보를 변경하려면 create-resource-definition-version 명령을 사용하여 새 버전을 생성합니다.


aws greengrass update-resource-definition \
    --resource-definition-id "c8bb9ebc-c3fd-40a4-9c6a-568d75569d38" \
    --name GreengrassConnectorResources

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 Lambda 함수 및 커넥터를 사용한 로컬 리소스 액세스를 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조UpdateResourceDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 update-subscription-definition을 사용하는 방법을 보여 줍니다.

AWS CLI

구독 정의의 이름을 업데이트하려면

다음 update-subscription-definition 예제에서는 지정된 구독 정의의 이름을 업데이트합니다. 구독에 대한 세부 정보를 변경하려면 create-subscription-definition-version 명령을 사용하여 새 버전을 생성합니다.


aws greengrass update-subscription-definition \
    --subscription-definition-id "fa81bc84-3f59-4377-a84b-5d0134da359b" \
    --name "ObsoleteSubscription"

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 가이드의 제목을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조UpdateSubscriptionDefinition의 섹션을 참조하세요.

다음 코드 예시에서는 update-thing-runtime-configuration을 사용하는 방법을 보여 줍니다.

AWS CLI

Greengrass 코어의 런타임 구성에서 원격 측정을 켜려면

다음 update-thing-runtime-configuration 예제에서는 Greengrass 코어의 런타임 구성을 업데이트하여 원격 측정을 활성화합니다.


aws greengrass update-thing-runtime-configuration \
    --thing-name SampleGreengrassCore \
    --telemetry-configuration {\"Telemetry\":\"On\"}

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 AWS IoT Greengrass 개발자 안내서의 원격 측정 설정 구성을 참조하세요.

자세한 API 내용은 AWS CLI 명령 참조UpdateThingRuntimeConfiguration의 섹션을 참조하세요.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

AWS IoT Events-Data

AWS IoT Greengrass V2