AWS IoT Greengrass contoh menggunakan AWS CLI - AWS Contoh Kode SDK
Tindakan

Ada lebih banyak contoh AWS SDK yang tersedia di repo Contoh SDK AWS Doc. GitHub

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

AWS IoT Greengrass contoh menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan mengimplementasikan skenario umum dengan menggunakan AWS Command Line Interface with AWS IoT Greengrass.

Tindakan merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

Tindakan

Contoh kode berikut menunjukkan cara menggunakanassociate-role-to-group.

AWS CLI

Untuk mengasosiasikan peran dengan kelompok Greengrass

associate-role-to-groupContoh berikut mengaitkan peran IAM yang ditentukan dengan grup Greengrass. Peran grup digunakan oleh fungsi dan konektor Lambda lokal untuk mengakses AWS layanan. Misalnya, peran grup Anda mungkin memberikan izin yang diperlukan untuk integrasi CloudWatch Log.

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

Output:

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

Untuk informasi selengkapnya, lihat Mengonfigurasi Peran Grup di Panduan Pengembang AWS Greengrass IoT.

Contoh kode berikut menunjukkan cara menggunakanassociate-service-role-to-account.

AWS CLI

Untuk mengaitkan peran layanan dengan AWS akun Anda

associate-service-role-to-accountContoh berikut mengaitkan peran layanan IAM, yang ditentukan oleh ARN-nya, dengan Greengrass AWS IoT di akun Anda. AWS Anda harus sebelumnya membuat peran layanan di IAM, dan Anda harus mengaitkan dokumen kebijakan dengannya yang memungkinkan AWS IoT Greengrass untuk mengambil peran ini.

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

Output:

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

Untuk informasi selengkapnya, lihat Peran Layanan Greengrass di Panduan Pengembang Greengrass IoT AWS .

Contoh kode berikut menunjukkan cara menggunakancreate-connector-definition-version.

AWS CLI

Untuk membuat versi definisi konektor

create-connector-definition-versionContoh berikut membuat versi definisi konektor dan mengaitkannya dengan definisi konektor yang ditentukan. Semua konektor dalam versi menentukan nilai untuk parameternya.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakancreate-connector-definition.

AWS CLI

Untuk membuat definisi konektor

create-connector-definitionContoh contoh berikut membuat definisi konektor dan versi definisi konektor awal. Versi awal berisi satu konektor. Semua konektor dalam versi menentukan nilai untuk parameternya.

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

Output:

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

Untuk informasi selengkapnya, lihat Memulai dengan Konektor Greengrass (CLI) AWS di Panduan Pengembang IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-core-definition-version.

AWS CLI

Untuk membuat versi definisi inti

create-core-definition-versionContoh berikut membuat versi definisi inti dan mengaitkannya dengan definisi inti yang ditentukan. Versi ini hanya dapat berisi satu inti. Sebelum Anda dapat membuat inti, Anda harus terlebih dahulu membuat dan menyediakan hal AWS IoT yang sesuai. Proses ini mencakup iot perintah berikut, yang mengembalikan ThingArn dan CertificateArn diperlukan untuk create-core-definition-version perintah.

Buat hal AWS IoT yang sesuai dengan perangkat inti:

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

Output:

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

Buat kunci publik dan pribadi dan sertifikat perangkat inti untuk hal itu. Contoh ini menggunakan create-keys-and-certificate perintah dan memerlukan izin menulis ke direktori saat ini. Atau, Anda dapat menggunakan create-certificate-from-csr perintah.

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"

Output:

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

Buat kebijakan AWS IoT yang memungkinkan iot dan greengrass bertindak. Untuk mempermudah, kebijakan berikut memungkinkan tindakan pada semua sumber daya, tetapi kebijakan Anda harus lebih ketat.

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

Output:

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

Lampirkan kebijakan ke sertifikat:

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

Perintah ini tidak menghasilkan output.

Lampirkan benda itu ke sertifikat:

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

Perintah ini tidak menghasilkan output.

Buat versi definisi inti:

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

Output:

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

Untuk informasi selengkapnya, lihat Mengonfigurasi Inti AWS Greengrass IoT di Panduan Pengembang IoT Greengrass.AWS

Contoh kode berikut menunjukkan cara menggunakancreate-core-definition.

AWS CLI

Contoh 1: Untuk membuat definisi inti kosong

create-core-definitionContoh berikut membuat definisi inti Greengrass kosong (tidak ada versi awal). Sebelum inti dapat digunakan, Anda harus menggunakan create-core-definition-version perintah untuk menyediakan parameter lain untuk inti.

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

Output:

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

Contoh 2: Untuk membuat definisi inti dengan versi awal

create-core-definitionContoh berikut membuat definisi inti yang berisi versi definisi inti awal. Versi ini hanya dapat berisi satu inti. Sebelum Anda dapat membuat inti, Anda harus terlebih dahulu membuat dan menyediakan hal AWS IoT yang sesuai. Proses ini mencakup iot perintah berikut, yang mengembalikan ThingArn dan CertificateArn diperlukan untuk create-core-definition perintah.

Buat hal AWS IoT yang sesuai dengan perangkat inti:

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

Output:

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

Buat kunci publik dan pribadi dan sertifikat perangkat inti untuk hal itu. Contoh ini menggunakan create-keys-and-certificate perintah dan memerlukan izin menulis ke direktori saat ini. Atau, Anda dapat menggunakan create-certificate-from-csr perintah.

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"

Output:

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

Buat kebijakan AWS IoT yang memungkinkan iot dan greengrass bertindak. Untuk mempermudah, kebijakan berikut memungkinkan tindakan pada semua sumber daya, tetapi kebijakan Anda harus lebih ketat.

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

Output:

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

Lampirkan kebijakan ke sertifikat:

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

Perintah ini tidak menghasilkan output.

Lampirkan benda itu ke sertifikat:

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

Perintah ini tidak menghasilkan output.

Buat definisi inti:

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

Output:

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

Untuk informasi selengkapnya, lihat Mengonfigurasi Inti AWS Greengrass IoT di Panduan Pengembang IoT Greengrass.AWS

Contoh kode berikut menunjukkan cara menggunakancreate-deployment.

AWS CLI

Untuk membuat penerapan untuk versi grup Greengrass

create-deploymentContoh berikut menyebarkan versi tertentu dari grup Greengrass.

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

Output:

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

Untuk informasi selengkapnya, lihat Memulai Konektor (CLI) di Panduan Pengembang AWS Greengrass IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-device-definition-version.

AWS CLI

Untuk membuat versi definisi perangkat

create-device-definition-versionContoh berikut membuat versi definisi perangkat dan mengaitkannya dengan definisi perangkat yang ditentukan. Versi ini mendefinisikan dua perangkat. Sebelum Anda dapat membuat perangkat Greengrass, Anda harus terlebih dahulu membuat dan menyediakan hal IoT yang sesuai. AWS Proses ini mencakup iot perintah berikut yang harus Anda jalankan untuk mendapatkan informasi yang diperlukan untuk perintah Greengrass:

Buat AWS IoT yang sesuai dengan perangkat:

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

Output:

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

Buat kunci publik dan pribadi dan sertifikat perangkat untuk benda itu. Contoh ini menggunakan create-keys-and-certificate perintah dan memerlukan izin menulis ke direktori saat ini. Atau, Anda dapat menggunakan create-certificate-from-csr perintah:

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"

Output:

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

Buat kebijakan AWS IoT yang memungkinkan iot dan greengrass bertindak. Untuk mempermudah, kebijakan berikut memungkinkan tindakan pada semua sumber daya, tetapi kebijakan Anda bisa lebih ketat:

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

Output:

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

Lampirkan kebijakan ke sertifikat:

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

Lampirkan benda itu ke sertifikat

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

Setelah Anda membuat dan mengkonfigurasi hal IoT seperti yang ditunjukkan di atas, gunakan ThingArn dan CertificateArn dari dua perintah pertama dalam contoh berikut.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakancreate-device-definition.

AWS CLI

Untuk membuat definisi perangkat

create-device-definitionContoh berikut membuat definisi perangkat yang berisi versi definisi perangkat awal. Versi awal mendefinisikan dua perangkat. Sebelum Anda dapat membuat perangkat Greengrass, Anda harus terlebih dahulu membuat dan menyediakan hal IoT yang sesuai. AWS Proses ini mencakup iot perintah berikut yang harus Anda jalankan untuk mendapatkan informasi yang diperlukan untuk perintah Greengrass:

Buat AWS IoT yang sesuai dengan perangkat:

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

Output:

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

Buat kunci publik dan pribadi dan sertifikat perangkat untuk benda itu. Contoh ini menggunakan create-keys-and-certificate perintah dan memerlukan izin menulis ke direktori saat ini. Atau, Anda dapat menggunakan create-certificate-from-csr perintah:

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"

Output:

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

Buat kebijakan AWS IoT yang memungkinkan iot dan greengrass bertindak. Untuk mempermudah, kebijakan berikut memungkinkan tindakan pada semua sumber daya, tetapi kebijakan Anda bisa lebih ketat:

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

Output:

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

Lampirkan kebijakan ke sertifikat:

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

Lampirkan benda itu ke sertifikat

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

Setelah Anda membuat dan mengkonfigurasi hal IoT seperti yang ditunjukkan di atas, gunakan ThingArn dan CertificateArn dari dua perintah pertama dalam contoh berikut.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakancreate-function-definition-version.

AWS CLI

Untuk membuat versi definisi fungsi

create-function-definition-versionContoh berikut membuat versi baru dari definisi fungsi yang ditentukan. Versi ini menentukan fungsi tunggal yang IDnyaHello-World-function, memungkinkan akses ke sistem file, dan menentukan ukuran memori maksimum dan periode batas waktu.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakancreate-function-definition.

AWS CLI

Untuk membuat definisi fungsi Lambda

create-function-definitionContoh berikut membuat definisi fungsi Lambda dan versi awal dengan menyediakan daftar fungsi Lambda (dalam hal ini, daftar hanya satu fungsi bernamaTempMonitorFunction) dan konfigurasinya. Sebelum Anda dapat membuat definisi fungsi, Anda memerlukan fungsi Lambda ARN. Untuk membuat fungsi dan aliasnya, gunakan Lambda create-function dan publish-version perintah. create-functionPerintah Lambda memerlukan ARN dari peran eksekusi, meskipun Greengrass AWS IoT tidak menggunakan peran itu karena izin ditentukan dalam peran grup Greengrass. Anda dapat menggunakan create-role perintah IAM untuk membuat peran kosong agar ARN dapat digunakan dengan Lambda atau Anda dapat menggunakan peran eksekusi yang create-function ada.

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

Output:

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

Untuk informasi selengkapnya, lihat Cara Mengkonfigurasi Akses Sumber Daya Lokal Menggunakan Antarmuka Baris AWS Perintah di Panduan Pengembang AWS Greengrass IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-group-certificate-authority.

AWS CLI

Untuk membuat otoritas sertifikat (CA) untuk grup

create-group-certificate-authorityContoh berikut membuat atau memutar CA untuk grup tertentu.

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

Output:

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

Untuk informasi selengkapnya, lihat Keamanan AWS Greengrass IoT di Panduan Pengembang Greengrass IoT.AWS

Contoh kode berikut menunjukkan cara menggunakancreate-group-version.

AWS CLI

Untuk membuat versi grup Greengrass

create-group-versionContoh berikut membuat versi grup dan mengaitkannya dengan grup yang ditentukan. Versi ini mereferensikan versi inti, sumber daya, konektor, fungsi, dan langganan yang berisi entitas untuk disertakan dalam versi grup ini. Anda harus membuat entitas ini sebelum Anda dapat membuat versi grup.

Untuk membuat definisi sumber daya dengan versi awal, gunakan create-resource-definition perintah.Untuk membuat definisi konektor dengan versi awal, gunakan create-connector-definition perintah.Untuk membuat definisi fungsi dengan versi awal, gunakan create-function-definition perintah.Untuk membuat definisi langganan dengan versi awal, gunakan perintah.Untuk create-subscription-definition mengambil ARN dari versi definisi inti terbaru, gunakan perintah dan tentukan ID versi grup terbaru. get-group-version

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"

Output:

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

Untuk informasi selengkapnya, lihat AWS Ikhtisar Model Objek Grup Greengrass di Panduan Pengembang Greengrass IoT.AWS

Contoh kode berikut menunjukkan cara menggunakancreate-group.

AWS CLI

Untuk membuat grup Greeengrass

create-groupContoh berikut membuat grup bernamacli-created-group.

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

Output:

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

Untuk informasi selengkapnya, lihat AWS Ikhtisar Model Objek Grup Greengrass di Panduan Pengembang Greengrass IoT.AWS

  • Untuk detail API, lihat CreateGroupdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakancreate-logger-definition-version.

AWS CLI

Untuk membuat versi definisi logger

create-logger-definition-versionContoh berikut membuat versi definisi logger dan mengaitkannya dengan definisi logger. Versi ini mendefinisikan empat konfigurasi logging: 1) log komponen sistem pada sistem file perangkat inti, 2) log fungsi Lambda yang ditentukan pengguna pada sistem file perangkat inti, 3) log komponen sistem di Amazon Logs, dan 4) log fungsi Lambda yang ditentukan pengguna di CloudWatch Amazon Logs. CloudWatch Catatan: Untuk integrasi CloudWatch Log, peran grup Anda harus memberikan izin yang sesuai.

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

Output:

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

Untuk informasi selengkapnya, lihat Pemantauan dengan Log AWS Greengrass IoT di Panduan Pengembang Greengrass IoT.AWS

Contoh kode berikut menunjukkan cara menggunakancreate-logger-definition.

AWS CLI

Untuk membuat definisi logger

create-logger-definitionContoh berikut membuat definisi logger yang berisi versi definisi logger awal. Versi awal mendefinisikan tiga konfigurasi logging: 1) log komponen sistem pada sistem file perangkat inti, 2) log fungsi Lambda yang ditentukan pengguna pada sistem file perangkat inti, dan 3) log fungsi Lambda yang ditentukan pengguna di Amazon Logs. CloudWatch Catatan: Untuk integrasi CloudWatch Log, peran grup Anda harus memberikan izin yang sesuai.

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

Output:

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

Untuk informasi selengkapnya, lihat Pemantauan dengan Log AWS Greengrass IoT di Panduan Pengembang Greengrass IoT.AWS

Contoh kode berikut menunjukkan cara menggunakancreate-resource-definition-version.

AWS CLI

Untuk membuat versi definisi sumber daya

create-resource-definition-versionContoh berikut membuat versi baru dari file 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\"}}}]"

Output:

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

Contoh kode berikut menunjukkan cara menggunakancreate-resource-definition.

AWS CLI

Untuk membuat definisi sumber daya

create-resource-definitionContoh berikut membuat definisi sumber daya yang berisi daftar sumber daya yang akan digunakan dalam grup Greengrass. Dalam contoh ini, versi awal definisi sumber daya disertakan dengan menyediakan daftar sumber daya. Daftar ini mencakup satu sumber daya untuk token otorisasi Twilio dan ARN untuk rahasia yang disimpan di Secrets Manager. AWS Anda harus membuat rahasia sebelum Anda dapat membuat definisi sumber daya.

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

Output:

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

Untuk informasi selengkapnya, lihat Cara Mengkonfigurasi Akses Sumber Daya Lokal Menggunakan Antarmuka Baris AWS Perintah di Panduan Pengembang AWS Greengrass IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-software-update-job.

AWS CLI

Untuk membuat pekerjaan pembaruan perangkat lunak untuk inti

create-software-update-jobContoh berikut membuat pekerjaan pembaruan over-the-air (OTA) untuk memperbarui perangkat lunak AWS IoT Greengrass Core pada inti yang namanya. MyFirstGroup_Core Perintah ini memerlukan peran IAM yang memungkinkan akses ke paket pembaruan perangkat lunak di Amazon S3 dan iot.amazonaws.com termasuk sebagai entitas tepercaya.

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

Output:

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

Untuk informasi lebih lanjut, lihat Pembaruan OTA Perangkat Lunak Inti AWS Greengrass IoT di Panduan Pengembang Greengrass IoT.AWS

Contoh kode berikut menunjukkan cara menggunakancreate-subscription-definition-version.

AWS CLI

Untuk membuat versi baru dari definisi langganan

create-subscription-definition-versionContoh berikut membuat versi baru dari definisi langganan yang berisi tiga langganan: pemberitahuan pemicu, input suhu, dan status keluaran.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakancreate-subscription-definition.

AWS CLI

Untuk membuat definisi langganan

create-subscription-definitionContoh berikut membuat definisi langganan dan menentukan versi awalnya. Versi awal berisi tiga langganan: satu untuk topik MQTT tempat konektor berlangganan, satu untuk memungkinkan fungsi menerima pembacaan suhu dari IoT AWS , dan satu lagi untuk memungkinkan AWS IoT menerima informasi status dari konektor. Contoh ini menyediakan ARN untuk alias fungsi Lambda yang dibuat sebelumnya dengan menggunakan perintah Lambda. create-alias

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

Output:

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

Untuk informasi selengkapnya, lihat Memulai Konektor (CLI) di Panduan Pengembang AWS Greengrass IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-connector-definition.

AWS CLI

Untuk menghapus definisi konektor

delete-connector-definitionContoh berikut menghapus definisi konektor Greengrass yang ditentukan. Jika Anda menghapus definisi konektor yang digunakan oleh grup, grup tersebut tidak dapat berhasil diterapkan.

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

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakandelete-core-definition.

AWS CLI

Untuk menghapus definisi inti

delete-core-definitionContoh berikut menghapus definisi inti Greengrass yang ditentukan, termasuk semua versi. Jika Anda menghapus inti yang terkait dengan grup Greengrass, grup tersebut tidak dapat digunakan dengan sukses.

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

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakandelete-device-definition.

AWS CLI

Untuk menghapus definisi perangkat

delete-device-definitionContoh berikut menghapus definisi perangkat yang ditentukan, termasuk semua versinya. Jika Anda menghapus versi definisi perangkat yang digunakan oleh versi grup, versi grup tidak dapat berhasil digunakan.

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

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakandelete-function-definition.

AWS CLI

Untuk menghapus definisi fungsi

delete-function-definitionContoh berikut menghapus definisi fungsi Greengrass yang ditentukan. Jika Anda menghapus definisi fungsi yang digunakan oleh grup, grup tersebut tidak dapat berhasil diterapkan.

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

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakandelete-group.

AWS CLI

Untuk menghapus grup

delete-groupContoh berikut menghapus grup Greengrass yang ditentukan.

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

Perintah ini tidak menghasilkan output.

  • Untuk detail API, lihat DeleteGroupdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-logger-definition.

AWS CLI

Untuk menghapus definisi logger

delete-logger-definitionContoh berikut menghapus definisi logger yang ditentukan, termasuk semua versi definisi logger. Jika Anda menghapus versi definisi logger yang digunakan oleh versi grup, versi grup tidak dapat berhasil digunakan.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Pemantauan dengan Log AWS Greengrass IoT di Panduan Pengembang Greengrass IoT.AWS

Contoh kode berikut menunjukkan cara menggunakandelete-resource-definition.

AWS CLI

Untuk menghapus definisi sumber daya

delete-resource-definitionContoh berikut menghapus definisi sumber daya yang ditentukan, termasuk semua versi sumber daya. Jika Anda menghapus definisi sumber daya yang digunakan oleh grup, grup tersebut tidak dapat berhasil diterapkan.

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

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakandelete-subscription-definition.

AWS CLI

Untuk menghapus definisi langganan

delete-subscription-definitionContoh berikut menghapus definisi langganan Greengrass yang ditentukan. Jika Anda menghapus langganan yang sedang digunakan oleh grup, grup tersebut tidak dapat berhasil diterapkan.

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

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakandisassociate-role-from-group.

AWS CLI

Untuk memisahkan peran dari kelompok Greengrass

disassociate-role-from-groupContoh berikut memisahkan peran IAM dari grup Greengrass yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat Mengonfigurasi Peran Grup di Panduan Pengembang AWS Greengrass IoT.

Contoh kode berikut menunjukkan cara menggunakandisassociate-service-role-from-account.

AWS CLI

Untuk memisahkan peran layanan dari akun Anda AWS

disassociate-service-role-from-accountContoh berikut menghapus peran layanan yang terkait dengan AWS akun Anda. Jika Anda tidak menggunakan peran layanan di AWS Wilayah mana pun, gunakan delete-role-policy perintah untuk melepaskan kebijakan AWSGreengrassResourceAccessRolePolicy terkelola dari peran, lalu gunakan delete-role perintah untuk menghapus peran tersebut.

aws greengrass disassociate-service-role-from-account

Output:

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

Untuk informasi selengkapnya, lihat Peran Layanan Greengrass di Panduan Pengembang Greengrass IoT AWS .

Contoh kode berikut menunjukkan cara menggunakanget-associated-role.

AWS CLI

Untuk mendapatkan peran yang terkait dengan kelompok Greengrass

get-associated-roleContoh berikut mendapatkan peran IAM yang terkait dengan grup Greengrass yang ditentukan. Peran grup digunakan oleh fungsi dan konektor Lambda lokal untuk mengakses AWS layanan.

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

Output:

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

Untuk informasi selengkapnya, lihat Mengonfigurasi Peran Grup di Panduan Pengembang AWS Greengrass IoT.

Contoh kode berikut menunjukkan cara menggunakanget-bulk-deployment-status.

AWS CLI

Untuk memeriksa status penyebaran massal Anda

get-bulk-deployment-statusContoh berikut mengambil informasi status untuk operasi penyebaran massal yang ditentukan. Dalam contoh ini, file yang menentukan grup yang akan digunakan memiliki catatan input yang tidak valid.

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

Output:

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

Untuk informasi selengkapnya, lihat Membuat Penerapan Massal untuk Grup di Panduan Pengembang AWS Greengrass IoT.

Contoh kode berikut menunjukkan cara menggunakanget-connectivity-info.

AWS CLI

Untuk mendapatkan informasi konektivitas untuk inti Greengrass

get-connectivity-infoContoh berikut menampilkan titik akhir yang dapat digunakan perangkat untuk terhubung ke inti Greengrass yang ditentukan. Informasi konektivitas adalah daftar alamat IP atau nama domain, dengan nomor port yang sesuai dan metadata yang ditentukan pelanggan opsional.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanget-connector-definition-version.

AWS CLI

Untuk mendapatkan kembali informasi tentang versi tertentu dari definisi konektor

get-connector-definition-versionContoh berikut mengambil informasi tentang versi tertentu dari definisi konektor yang ditentukan. Untuk mengambil semua IDs versi definisi konektor, gunakan list-connector-definition-versions perintah. Untuk mengambil ID dari versi terakhir yang ditambahkan ke definisi konektor, gunakan get-connector-definition perintah dan periksa LatestVersion properti.

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

Output:

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

Untuk informasi selengkapnya, lihat Mengintegrasikan dengan Layanan dan Protokol Menggunakan Konektor Greengrass di Panduan Pengembang Greengrass IoT.AWS

Contoh kode berikut menunjukkan cara menggunakanget-connector-definition.

AWS CLI

Untuk mengambil informasi tentang definisi konektor

get-connector-definitionContoh berikut mengambil informasi tentang definisi konektor yang ditentukan. Untuk mengambil definisi konektor Anda, gunakan list-connector-definitions perintah. IDs 

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

Output:

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

Untuk informasi selengkapnya, lihat Mengintegrasikan dengan Layanan dan Protokol Menggunakan Konektor Greengrass di Panduan Pengembang Greengrass IoT.AWS

Contoh kode berikut menunjukkan cara menggunakanget-core-definition-version.

AWS CLI

Untuk mengambil detail tentang versi tertentu dari definisi inti Greengrass

get-core-definition-versionContoh berikut mengambil informasi tentang versi tertentu dari definisi inti yang ditentukan. Untuk mengambil semua IDs versi definisi inti, gunakan list-core-definition-versions perintah. Untuk mengambil ID dari versi terakhir yang ditambahkan ke definisi inti, gunakan get-core-definition perintah dan periksa LatestVersion properti.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanget-core-definition.

AWS CLI

Untuk mengambil detail untuk definisi inti Greengrass

get-core-definitionContoh berikut mengambil informasi tentang definisi inti yang ditentukan. Untuk mengambil definisi inti Anda, gunakan list-core-definitions perintah. IDs 

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanget-deployment-status.

AWS CLI

Untuk mengambil status penerapan

get-deployment-statusContoh berikut mengambil status untuk penyebaran tertentu dari grup Greengrass tertentu. Untuk mendapatkan ID penyebaran, gunakan list-deployments perintah dan tentukan ID grup.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanget-device-definition-version.

AWS CLI

Untuk mendapatkan versi definisi perangkat

get-device-definition-versionContoh berikut mengambil informasi tentang versi tertentu dari definisi perangkat yang ditentukan. Untuk mengambil semua IDs versi definisi perangkat, gunakan list-device-definition-versions perintah. Untuk mengambil ID versi terakhir yang ditambahkan ke definisi perangkat, gunakan get-device-definition perintah dan periksa LatestVersion properti.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanget-device-definition.

AWS CLI

Untuk mendapatkan definisi perangkat

get-device-definitionContoh berikut mengambil informasi tentang definisi perangkat yang ditentukan. Untuk mengambil definisi perangkat Anda, gunakan list-device-definitions perintah. IDs 

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanget-function-definition-version.

AWS CLI

Untuk mengambil detail tentang versi tertentu dari fungsi Lambda

Berikut ini get-function-definition-version mengambil informasi tentang versi tertentu dari definisi fungsi yang ditentukan. Untuk mengambil semua IDs versi definisi fungsi, gunakan list-function-definition-versions perintah. Untuk mengambil ID dari versi terakhir yang ditambahkan ke definisi fungsi, gunakan get-function-definition perintah dan periksa LatestVersion properti.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanget-function-definition.

AWS CLI

Untuk mengambil definisi fungsi

get-function-definitionContoh berikut menampilkan rincian untuk definisi fungsi yang ditentukan. Untuk mengambil definisi fungsi Anda, gunakan list-function-definitions perintah. IDs 

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanget-group-certificate-authority.

AWS CLI

Untuk mengambil CA yang terkait dengan kelompok Greengrass

get-group-certificate-authorityContoh berikut mengambil otoritas sertifikat (CA) yang terkait dengan grup Greengrass yang ditentukan. Untuk mendapatkan ID otoritas sertifikat, gunakan list-group-certificate-authorities perintah dan tentukan ID grup.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanget-group-certificate-configuration.

AWS CLI

Untuk mengambil konfigurasi untuk otoritas sertifikat yang digunakan oleh grup Greengrass

get-group-certificate-configurationContoh berikut mengambil konfigurasi untuk otoritas sertifikat (CA) yang digunakan oleh grup Greengrass yang ditentukan.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanget-group-version.

AWS CLI

Untuk mengambil informasi tentang versi grup Greengrass

get-group-versionContoh berikut mengambil informasi tentang versi tertentu dari grup yang ditentukan. Untuk mengambil semua IDs versi grup, gunakan list-group-versions perintah. Untuk mengambil ID dari versi terakhir yang ditambahkan ke grup, gunakan get-group perintah dan periksa LatestVersion properti.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanget-group.

AWS CLI

Untuk mengambil informasi tentang kelompok Greengrass

get-groupContoh berikut mengambil informasi tentang kelompok Greengrass tertentu. Untuk mengambil grup Anda, gunakan list-groups perintah. IDs 

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

Output:

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

  • Untuk detail API, lihat GetGroupdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-logger-definition-version.

AWS CLI

Untuk mengambil informasi tentang versi definisi logger

get-logger-definition-versionContoh berikut mengambil informasi tentang versi tertentu dari definisi logger yang ditentukan. Untuk mengambil semua IDs versi definisi logger, gunakan perintah. list-logger-definition-versions Untuk mengambil ID dari versi terakhir yang ditambahkan ke definisi logger, gunakan get-logger-definition perintah dan periksa properti. LatestVersion

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanget-logger-definition.

AWS CLI

Untuk mengambil informasi tentang definisi logger

get-logger-definitionContoh berikut mengambil informasi tentang definisi logger yang ditentukan. Untuk mengambil definisi logger Anda, gunakan perintah. IDs list-logger-definitions

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanget-resource-definition-version.

AWS CLI

Untuk mengambil informasi tentang versi tertentu dari definisi sumber daya

get-resource-definition-versionContoh berikut mengambil informasi tentang versi tertentu dari definisi sumber daya yang ditentukan. Untuk mengambil semua IDs versi definisi sumber daya, gunakan list-resource-definition-versions perintah. Untuk mengambil ID dari versi terakhir yang ditambahkan ke definisi sumber daya, gunakan get-resource-definition perintah dan periksa LatestVersion properti.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanget-resource-definition.

AWS CLI

Untuk mengambil informasi tentang definisi sumber daya

get-resource-definitionContoh berikut mengambil informasi tentang definisi sumber daya yang ditentukan. Untuk mengambil definisi sumber daya Anda, gunakan list-resource-definitions perintah. IDs 

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanget-service-role-for-account.

AWS CLI

Untuk mengambil detail untuk peran layanan yang dilampirkan ke akun Anda

get-service-role-for-accountContoh berikut mengambil informasi tentang peran layanan yang dilampirkan ke AWS akun Anda.

aws greengrass get-service-role-for-account

Output:

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

Untuk informasi selengkapnya, lihat Peran Layanan Greengrass di Panduan Pengembang Greengrass IoT AWS .

Contoh kode berikut menunjukkan cara menggunakanget-subscription-definition-version.

AWS CLI

Untuk mengambil informasi tentang versi tertentu dari definisi langganan

get-subscription-definition-versionContoh berikut mengambil informasi tentang versi tertentu dari definisi langganan yang ditentukan. Untuk mengambil semua IDs versi definisi langganan, gunakan list-subscription-definition-versions perintah. Untuk mengambil ID dari versi terakhir yang ditambahkan ke definisi langganan, gunakan get-subscription-definition perintah dan periksa LatestVersion properti.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanget-subscription-definition.

AWS CLI

Untuk mengambil informasi tentang definisi langganan

get-subscription-definitionContoh berikut mengambil informasi tentang definisi langganan yang ditentukan. Untuk mengambil definisi langganan Anda, gunakan list-subscription-definitions perintah. IDs 

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanget-thing-runtime-configuration.

AWS CLI

Untuk mengambil konfigurasi runtime dari inti Greengrass

get-thing-runtime-configurationContoh berikut mengambil konfigurasi runtime dari inti Greengrass. Sebelum Anda dapat mengambil konfigurasi runtime, Anda harus menggunakan update-thing-runtime-configuration perintah untuk membuat konfigurasi runtime untuk inti.

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

Output:

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

Untuk informasi selengkapnya, lihat Mengonfigurasi setelan telemetri di Panduan Pengembang Greengrass AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-bulk-deployment-detailed-reports.

AWS CLI

Untuk mencantumkan informasi tentang penerapan individual dalam penyebaran massal

list-bulk-deployment-detailed-reportsContoh berikut menampilkan informasi tentang penyebaran individu dalam operasi penyebaran massal, termasuk status.

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

Output:

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

Untuk informasi selengkapnya, lihat Membuat Penerapan Massal untuk Grup di Panduan Pengembang AWS Greengrass IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-bulk-deployments.

AWS CLI

Untuk membuat daftar penyebaran massal

list-bulk-deploymentsContoh berikut mencantumkan semua penyebaran massal.

aws greengrass list-bulk-deployments

Output:

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

Untuk informasi selengkapnya, lihat Membuat Penerapan Massal untuk Grup di Panduan Pengembang AWS Greengrass IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-connector-definition-versions.

AWS CLI

Untuk membuat daftar versi yang tersedia untuk definisi konektor

list-connector-definition-versionsContoh berikut mencantumkan versi yang tersedia untuk definisi konektor yang ditentukan. Gunakan list-connector-definitions perintah untuk mendapatkan ID definisi konektor.

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

Output:

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

Untuk informasi selengkapnya, lihat Mengintegrasikan dengan Layanan dan Protokol Menggunakan Konektor Greengrass di Panduan Pengembang Greengrass IoT.AWS

Contoh kode berikut menunjukkan cara menggunakanlist-connector-definitions.

AWS CLI

Untuk membuat daftar konektor Greengrass yang didefinisikan

list-connector-definitionsContoh berikut mencantumkan semua konektor Greengrass yang ditentukan untuk akun Anda. AWS 

aws greengrass list-connector-definitions

Output:

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

Untuk informasi selengkapnya, lihat Mengintegrasikan dengan Layanan dan Protokol Menggunakan Konektor Greengrass di Panduan Pengembang Greengrass IoT.AWS

Contoh kode berikut menunjukkan cara menggunakanlist-core-definition-versions.

AWS CLI

Untuk membuat daftar versi definisi inti Greengrass

list-core-definitionsContoh berikut mencantumkan semua versi definisi inti Greengrass yang ditentukan. Anda dapat menggunakan list-core-definitions perintah untuk mendapatkan ID versi.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanlist-core-definitions.

AWS CLI

Untuk membuat daftar definisi Greengrass core

list-core-definitionsContoh berikut mencantumkan semua definisi inti Greengrass untuk akun Anda. AWS 

aws greengrass list-core-definitions

Output:

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

Contoh kode berikut menunjukkan cara menggunakanlist-deployments.

AWS CLI

Untuk membuat daftar penerapan untuk grup Greengrass

list-deploymentsContoh berikut mencantumkan penerapan untuk grup Greengrass yang ditentukan. Anda dapat menggunakan list-groups perintah untuk mencari ID grup Anda.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanlist-device-definition-versions.

AWS CLI

Untuk mencantumkan versi definisi perangkat

list-device-definition-versionsContoh berikut menampilkan versi definisi perangkat yang terkait dengan definisi perangkat yang ditentukan.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanlist-device-definitions.

AWS CLI

Untuk mencantumkan definisi perangkat Anda

list-device-definitionsContoh berikut menampilkan detail tentang definisi perangkat di AWS akun Anda di AWS Wilayah yang ditentukan.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanlist-function-definition-versions.

AWS CLI

Untuk membuat daftar versi fungsi Lambda

list-function-definition-versionsContoh berikut mencantumkan semua versi fungsi Lambda yang ditentukan. Anda dapat menggunakan list-function-definitions perintah untuk mendapatkan ID.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanlist-function-definitions.

AWS CLI

Untuk daftar fungsi Lambda

list-function-definitionsContoh berikut mencantumkan semua fungsi Lambda yang ditentukan untuk akun Anda AWS .

aws greengrass list-function-definitions

Output:

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

Contoh kode berikut menunjukkan cara menggunakanlist-group-certificate-authorities.

AWS CLI

Untuk daftar saat ini CAs untuk grup

list-group-certificate-authoritiesContoh berikut mencantumkan otoritas sertifikat saat ini (CAs) untuk grup Greengrass yang ditentukan.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanlist-group-versions.

AWS CLI

Untuk membuat daftar versi grup Greengrass

list-group-versionsContoh berikut mencantumkan versi grup Greengrass yang ditentukan.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanlist-groups.

AWS CLI

Untuk membuat daftar kelompok Greengrass

list-groupsContoh berikut mencantumkan semua grup Greengrass yang didefinisikan di akun Anda. AWS 

aws greengrass list-groups

Output:

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

  • Untuk detail API, lihat ListGroupsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-logger-definition-versions.

AWS CLI

Untuk mendapatkan daftar versi definisi logger

list-logger-definition-versionsContoh berikut mendapatkan daftar semua versi definisi logger yang ditentukan.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanlist-logger-definitions.

AWS CLI

Untuk mendapatkan daftar definisi logger

list-logger-definitionsContoh berikut mencantumkan semua definisi logger untuk AWS akun Anda.

aws greengrass list-logger-definitions

Output:

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

Contoh kode berikut menunjukkan cara menggunakanlist-resource-definition-versions.

AWS CLI

Untuk membuat daftar versi definisi sumber daya

list-resource-definition-versionsContoh berikut mencantumkan versi untuk sumber Greengrass yang ditentukan.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanlist-resource-definitions.

AWS CLI

Untuk membuat daftar sumber daya yang didefinisikan

list-resource-definitionsContoh berikut mencantumkan sumber daya yang didefinisikan untuk AWS IoT Greengrass untuk digunakan.

aws greengrass list-resource-definitions

Output:

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

Contoh kode berikut menunjukkan cara menggunakanlist-subscription-definition-versions.

AWS CLI

Untuk membuat daftar versi definisi langganan

list-subscription-definition-versionsContoh berikut mencantumkan semua versi langganan yang ditentukan. Anda dapat menggunakan list-subscription-definitions perintah untuk mencari ID langganan.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanlist-subscription-definitions.

AWS CLI

Untuk mendapatkan daftar definisi langganan

list-subscription-definitionsContoh berikut mencantumkan semua langganan AWS Greengrass IoT yang ditentukan di akun Anda. AWS 

aws greengrass list-subscription-definitions

Output:

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

Contoh kode berikut menunjukkan cara menggunakanlist-tags-for-resource.

AWS CLI

Untuk mencantumkan tag yang dilampirkan ke sumber daya

list-tags-for-resourceContoh berikut mencantumkan tag dan nilainya yang dilampirkan ke sumber daya yang ditentukan.

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

Output:

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

Untuk informasi lebih lanjut, lihat Menandai Sumber Daya Greengrass Anda di Panduan Pengembang Greengrass IoT.AWS

Contoh kode berikut menunjukkan cara menggunakanreset-deployments.

AWS CLI

Untuk membersihkan informasi penyebaran untuk grup Greengrass

reset-deploymentsContoh berikut membersihkan informasi penyebaran untuk grup Greengrass yang ditentukan. Saat Anda menambahkan--force option, informasi penyebaran diatur ulang tanpa menunggu perangkat inti merespons.

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

Output:

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

Untuk informasi selengkapnya, lihat Mengatur Ulang Penerapan di Panduan Pengembang AWS Greengrass IoT.

Contoh kode berikut menunjukkan cara menggunakanstart-bulk-deployment.

AWS CLI

Untuk memulai operasi penyebaran massal

start-bulk-deploymentContoh berikut memulai operasi penyebaran massal, menggunakan file yang disimpan dalam bucket S3 untuk menentukan grup yang akan digunakan.

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

Output:

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

Untuk informasi selengkapnya, lihat Membuat Penerapan Massal untuk Grup di Panduan Pengembang AWS Greengrass IoT.

Contoh kode berikut menunjukkan cara menggunakanstop-bulk-deployment.

AWS CLI

Untuk menghentikan penyebaran massal

stop-bulk-deploymentContoh berikut menghentikan penyebaran massal yang ditentukan. Jika Anda mencoba menghentikan penyebaran massal yang selesai, Anda menerima kesalahan: InvalidInputException: Cannot change state of finished execution.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Membuat Penerapan Massal untuk Grup di Panduan Pengembang AWS Greengrass IoT.

Contoh kode berikut menunjukkan cara menggunakantag-resource.

AWS CLI

Untuk menerapkan tag ke sumber daya

tag-resourceContoh berikut berlaku dua tag, ResourceType danResourceSubType, ke sumber Greengrass yang ditentukan. Operasi ini dapat menambahkan tag dan nilai baru atau memperbarui nilai untuk tag yang ada. Gunakan untag-resource perintah untuk menghapus tag.

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"

Perintah ini tidak menghasilkan output.

Untuk informasi lebih lanjut, lihat Menandai Sumber Daya Greengrass Anda di Panduan Pengembang Greengrass IoT.AWS

  • Untuk detail API, lihat TagResourcedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanuntag-resource.

AWS CLI

Untuk menghapus tag dan nilainya dari sumber daya

untag-resourceContoh berikut menghapus tag yang kuncinya Category dari grup Greengrass yang ditentukan. Jika kunci Category tidak ada untuk sumber daya yang ditentukan, tidak ada kesalahan yang dikembalikan.

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

Perintah ini tidak menghasilkan output.

Untuk informasi lebih lanjut, lihat Menandai Sumber Daya Greengrass Anda di Panduan Pengembang Greengrass IoT.AWS

  • Untuk detail API, lihat UntagResourcedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanupdate-connectivity-info.

AWS CLI

Untuk memperbarui informasi konektivitas untuk inti Greengrass

update-connectivity-infoContoh berikut mengubah titik akhir yang dapat digunakan perangkat untuk terhubung ke inti Greengrass yang ditentukan. Informasi konektivitas adalah daftar alamat IP atau nama domain, dengan nomor port yang sesuai dan metadata yang ditentukan pelanggan opsional. Anda mungkin perlu memperbarui informasi konektivitas saat jaringan lokal berubah.

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

Output:

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

Contoh kode berikut menunjukkan cara menggunakanupdate-connector-definition.

AWS CLI

Untuk memperbarui nama untuk definisi konektor

update-connector-definitionContoh berikut memperbarui nama untuk definisi konektor yang ditentukan. Jika Anda ingin memperbarui detail untuk konektor, gunakan create-connector-definition-version perintah untuk membuat versi baru.

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

Untuk informasi selengkapnya, lihat Mengintegrasikan dengan Layanan dan Protokol Menggunakan Konektor di Panduan Pengembang AWS Greengrass IoT.

Contoh kode berikut menunjukkan cara menggunakanupdate-core-definition.

AWS CLI

Untuk memperbarui definisi inti

update-core-definitionContoh berikut mengubah nama definisi inti yang ditentukan. Anda hanya dapat memperbarui name properti definisi inti.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengonfigurasi Inti AWS Greengrass IoT di Panduan Pengembang IoT Greengrass.AWS

Contoh kode berikut menunjukkan cara menggunakanupdate-device-definition.

AWS CLI

Untuk memperbarui definisi perangkat

update-device-definitionContoh berikut mengubah nama definisi perangkat yang ditentukan. Anda hanya dapat memperbarui name properti definisi perangkat.

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

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakanupdate-function-definition.

AWS CLI

Untuk memperbarui nama untuk definisi fungsi

update-function-definitionContoh berikut memperbarui nama untuk definisi fungsi yang ditentukan. Jika Anda ingin memperbarui detail untuk fungsi tersebut, gunakan create-function-definition-version perintah untuk membuat versi baru.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menjalankan Fungsi Lambda Lokal di Panduan Pengembang AWS Greengrass IoT.

Contoh kode berikut menunjukkan cara menggunakanupdate-group-certificate-configuration.

AWS CLI

Untuk memperbarui berakhirnya sertifikat grup

update-group-certificate-configurationContoh berikut menetapkan kadaluwarsa 10 hari untuk sertifikat yang dihasilkan untuk grup yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat Keamanan AWS Greengrass IoT di Panduan Pengembang Greengrass IoT.AWS

Contoh kode berikut menunjukkan cara menggunakanupdate-group.

AWS CLI

Untuk memperbarui nama grup

update-groupContoh berikut memperbarui nama grup Greengrass yang ditentukan. Jika Anda ingin memperbarui detail untuk grup, gunakan create-group-version perintah untuk membuat versi baru.

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

Untuk informasi selengkapnya, lihat Mengonfigurasi AWS Greengrass IoT di IoT di Panduan Pengembang AWS IoT.AWS

  • Untuk detail API, lihat UpdateGroupdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanupdate-logger-definition.

AWS CLI

Untuk memperbarui definisi logger

update-logger-definitionContoh berikut mengubah nama definisi logger yang ditentukan. Anda hanya dapat memperbarui name properti definisi logger.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Pemantauan dengan Log AWS Greengrass IoT di Panduan Pengembang Greengrass IoT.AWS

Contoh kode berikut menunjukkan cara menggunakanupdate-resource-definition.

AWS CLI

Untuk memperbarui nama untuk definisi sumber daya

update-resource-definitionContoh berikut memperbarui nama untuk definisi sumber daya yang ditentukan. Jika Anda ingin mengubah detail untuk sumber daya, gunakan create-resource-definition-version perintah untuk membuat versi baru.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengakses Sumber Daya Lokal dengan Fungsi dan Konektor Lambda di Panduan Pengembang AWS Greengrass IoT.

Contoh kode berikut menunjukkan cara menggunakanupdate-subscription-definition.

AWS CLI

Untuk memperbarui nama untuk definisi langganan

update-subscription-definitionContoh berikut memperbarui nama untuk definisi langganan yang ditentukan. Jika Anda ingin mengubah detail langganan, gunakan create-subscription-definition-version perintah untuk membuat versi baru.

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

Perintah ini tidak menghasilkan output.

Untuk informasi lebih lanjut, lihat judul di panduan.

Contoh kode berikut menunjukkan cara menggunakanupdate-thing-runtime-configuration.

AWS CLI

Untuk mengaktifkan telemetri dalam konfigurasi runtime inti Greengrass

update-thing-runtime-configurationContoh berikut memperbarui konfigurasi runtime inti Greengrass untuk mengaktifkan telemetri.

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

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengonfigurasi setelan telemetri di Panduan Pengembang Greengrass AWS IoT.