AWS IoT Greengrass V2 contoh menggunakan AWS CLI - AWS Command Line Interface
Tindakan

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

AWS IoT Greengrass V2 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 V2.

Tindakan adalah 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-service-role-to-account.

AWS CLI

Untuk mengaitkan peran layanan Greengrass ke akun Anda AWS

associate-service-role-to-accountContoh berikut mengaitkan peran layanan dengan AWS IoT Greengrass untuk akun Anda. AWS 

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

Output:

{
    "associatedAt": "2022-01-19T19:21:53Z"
}

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

Contoh kode berikut menunjukkan cara menggunakanbatch-associate-client-device-with-core-device.

AWS CLI

Untuk mengaitkan perangkat klien dengan perangkat inti

batch-associate-client-device-with-core-deviceContoh berikut mengaitkan dua perangkat klien dengan perangkat inti.

aws greengrassv2 batch-associate-client-device-with-core-device \
  --core-device-thing-name MyGreengrassCore \
  --entries thingName=MyClientDevice1 thingName=MyClientDevice2

Output:

{
    "errorEntries": []
}

Untuk informasi selengkapnya, lihat Berinteraksi dengan perangkat IoT lokal di Panduan Pengembang AWS Greengrass V2.

Contoh kode berikut menunjukkan cara menggunakanbatch-disassociate-client-device-from-core-device.

AWS CLI

Untuk memisahkan perangkat klien dari perangkat inti

batch-disassociate-client-device-from-core-deviceContoh berikut memisahkan dua perangkat klien dari perangkat inti.

aws greengrassv2 batch-disassociate-client-device-from-core-device \
  --core-device-thing-name MyGreengrassCore \
  --entries thingName=MyClientDevice1 thingName=MyClientDevice2

Output:

{
    "errorEntries": []
}

Untuk informasi selengkapnya, lihat Berinteraksi dengan perangkat IoT lokal di Panduan Pengembang AWS Greengrass V2.

Contoh kode berikut menunjukkan cara menggunakancancel-deployment.

AWS CLI

Untuk membatalkan penerapan

cancel-deploymentContoh berikut menghentikan penerapan berkelanjutan ke grup sesuatu.

aws greengrassv2 cancel-deployment \
    --deployment-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Output:

{
    "message": "SUCCESS"
}

Untuk informasi selengkapnya, lihat Batalkan penerapan di Panduan Pengembang AWS Greengrass V2 IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-component-version.

AWS CLI

Contoh 1: Untuk membuat versi komponen dari resep

create-component-versionContoh berikut membuat versi komponen Hello World dari file resep.

aws greengrassv2 create-component-version \
    --inline-recipe fileb://com.example.HelloWorld-1.0.0.json

Isi dari com.example.HelloWorld-1.0.0.json:

{
    "RecipeFormatVersion": "2020-01-25",
    "ComponentName": "com.example.HelloWorld",
    "ComponentVersion": "1.0.0",
    "ComponentDescription": "My first AWS IoT Greengrass component.",
    "ComponentPublisher": "Amazon",
    "ComponentConfiguration": {
        "DefaultConfiguration": {
            "Message": "world"
        }
    },
    "Manifests": [
        {
            "Platform": {
                "os": "linux"
            },
            "Lifecycle": {
                "Run": "echo 'Hello {configuration:/Message}'"
            }
        }
    ]
}

Output:

{
    "arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0",
    "componentName": "com.example.HelloWorld",
    "componentVersion": "1.0.0",
    "creationTimestamp": "2021-01-07T16:24:33.650000-08:00",
    "status": {
        "componentState": "REQUESTED",
        "message": "NONE",
        "errors": {}
    }
}

Untuk informasi selengkapnya, lihat Membuat komponen khusus dan Mengunggah komponen yang akan diterapkan di Panduan Pengembang Greengrass V2 AWS IoT.

Contoh 2: Untuk membuat versi komponen dari fungsi AWS Lambda

create-component-versionContoh berikut membuat versi komponen Hello World dari fungsi AWS Lambda.

aws greengrassv2 create-component-version \
    --cli-input-json file://lambda-function-component.json

Isi dari lambda-function-component.json:

{
    "lambdaFunction": {
        "lambdaArn": "arn:aws:lambda:us-west-2:123456789012:function:HelloWorldPythonLambda:1",
        "componentName": "com.example.HelloWorld",
        "componentVersion": "1.0.0",
        "componentLambdaParameters": {
            "eventSources": [
                {
                    "topic": "hello/world/+",
                    "type": "IOT_CORE"
                }
            ]
        }
    }
}

Output:

{
    "arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0",
    "componentName": "com.example.HelloWorld",
    "componentVersion": "1.0.0",
    "creationTimestamp": "2021-01-07T17:05:27.347000-08:00",
    "status": {
        "componentState": "REQUESTED",
        "message": "NONE",
        "errors": {}
    }
}

Untuk informasi selengkapnya, lihat Menjalankan fungsi AWS Lambda di Panduan Pengembang AWS Greengrass V2 IoT.

Contoh kode berikut menunjukkan cara menggunakancreate-deployment.

AWS CLI

Contoh 1: Untuk membuat penerapan

create-deploymentContoh berikut menyebarkan AWS IoT Greengrass Command Line Interface ke perangkat inti.

aws greengrassv2 create-deployment \
    --cli-input-json file://cli-deployment.json

Isi dari cli-deployment.json:

{
    "targetArn": "arn:aws:iot:us-west-2:123456789012:thing/MyGreengrassCore",
    "deploymentName": "Deployment for MyGreengrassCore",
    "components": {
        "aws.greengrass.Cli": {
            "componentVersion": "2.0.3"
        }
    },
    "deploymentPolicies": {
        "failureHandlingPolicy": "DO_NOTHING",
        "componentUpdatePolicy": {
            "timeoutInSeconds": 60,
            "action": "NOTIFY_COMPONENTS"
        },
        "configurationValidationPolicy": {
            "timeoutInSeconds": 60
        }
    },
    "iotJobConfiguration": {}
}

Output:

{
    "deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}

Untuk informasi selengkapnya, lihat Membuat penerapan di Panduan Pengembang IoT AWS Greengrass V2.

Contoh 2: Untuk membuat penerapan yang memperbarui konfigurasi komponen

create-deploymentContoh berikut menyebarkan komponen inti Greengrass AWS IoT ke sekelompok perangkat inti. Penerapan ini menerapkan pembaruan konfigurasi berikut untuk komponen inti:

Setel ulang setelan proxy perangkat target ke defaultnya tanpa pengaturan proksi. Setel ulang MQTT pengaturan perangkat target ke defaultnya.Menetapkan opsi untuk inti. JVM JVM

aws greengrassv2 create-deployment \
    --cli-input-json file://nucleus-deployment.json

Isi dari nucleus-deployment.json:

{
    "targetArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/MyGreengrassCoreGroup",
    "deploymentName": "Deployment for MyGreengrassCoreGroup",
    "components": {
        "aws.greengrass.Nucleus": {
            "componentVersion": "2.0.3",
            "configurationUpdate": {
                "reset": [
                    "/networkProxy",
                    "/mqtt"
                ],
                "merge": "{\"jvmOptions\":\"-Xmx64m\",\"logging\":{\"level\":\"WARN\"}}"
            }
        }
    },
    "deploymentPolicies": {
        "failureHandlingPolicy": "ROLLBACK",
        "componentUpdatePolicy": {
            "timeoutInSeconds": 60,
            "action": "NOTIFY_COMPONENTS"
        },
        "configurationValidationPolicy": {
            "timeoutInSeconds": 60
        }
    },
    "iotJobConfiguration": {}
}

Output:

{
    "deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "iotJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
    "iotJobArn": "arn:aws:iot:us-west-2:123456789012:job/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}

Untuk informasi selengkapnya, lihat Membuat penerapan dan Memperbarui konfigurasi komponen di Panduan Pengembang Greengrass AWS V2 IoT.

Contoh kode berikut menunjukkan cara menggunakandelete-component.

AWS CLI

Untuk menghapus versi komponen

delete-componentContoh berikut menghapus komponen Hello World.

aws greengrassv2 delete-component \
    --arn arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Mengelola komponen di Panduan AWS Pengembang Greengrass V2.

Contoh kode berikut menunjukkan cara menggunakandelete-core-device.

AWS CLI

Untuk menghapus perangkat inti

delete-core-deviceContoh berikut menghapus perangkat inti AWS Greengrass IoT.

aws greengrassv2 delete-core-device \
    --core-device-thing-name MyGreengrassCore

Perintah ini tidak menghasilkan output.

Untuk informasi lebih lanjut, lihat Menghapus instalasi perangkat lunak AWS Greengrass Core AWS IoT di Panduan Pengembang IoT Greengrass V2.

Contoh kode berikut menunjukkan cara menggunakandescribe-component.

AWS CLI

Untuk mendeskripsikan versi komponen

describe-componentContoh berikut menjelaskan komponen Hello World.

aws greengrassv2 describe-component \
    --arn arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0

Output:

{
    "arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0",
    "componentName": "com.example.HelloWorld",
    "componentVersion": "1.0.0",
    "creationTimestamp": "2021-01-07T17:12:11.133000-08:00",
    "publisher": "Amazon",
    "description": "My first AWS IoT Greengrass component.",
    "status": {
        "componentState": "DEPLOYABLE",
        "message": "NONE",
        "errors": {}
    },
    "platforms": [
        {
            "attributes": {
                "os": "linux"
            }
        }
    ]
}

Untuk informasi selengkapnya, lihat Mengelola komponen di Panduan AWS Pengembang Greengrass V2.

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

AWS CLI

Untuk memisahkan peran layanan Greengrass dari akun Anda AWS

disassociate-service-role-from-accountContoh berikut memisahkan peran layanan Greengrass dari AWS IoT Greengrass untuk akun Anda. AWS 

aws greengrassv2 disassociate-service-role-from-account

Output:

{
    "disassociatedAt": "2022-01-19T19:26:09Z"
}

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

Contoh kode berikut menunjukkan cara menggunakanget-component-version-artifact.

AWS CLI

Untuk mendapatkan URL untuk men-download artefak komponen

get-component-version-artifactContoh berikut mendapat URL untuk men-download JAR file komponen konsol debug lokal.

aws greengrassv2 get-component-version-artifact \
    --arn arn:aws:greengrass:us-west-2:aws:components:aws.greengrass.LocalDebugConsole:versions:2.0.3 \
    --artifact-name "Uvt6ZEzQ9TKiAuLbfXBX_APdY0TWks3uc46tHFHTzBM=/aws.greengrass.LocalDebugConsole.jar"

Output:

{
    "preSignedUrl": "https://evergreencomponentmanageme-artifactbucket7410c9ef-g18n1iya8kwr.s3.us-west-2.amazonaws.com/public/aws.greengrass.LocalDebugConsole/2.0.3/s3/ggv2-component-releases-prod-pdx/EvergreenHttpDebugView/2ffc496ba41b39568968b22c582b4714a937193ee7687a45527238e696672521/aws.greengrass.LocalDebugConsole/aws.greengrass.LocalDebugConsole.jar?X-Amz-Security-Token=KwfLKSdEXAMPLE..."
}

Untuk informasi selengkapnya, lihat Mengelola komponen di Panduan AWS Pengembang Greengrass V2.

Contoh kode berikut menunjukkan cara menggunakanget-component.

AWS CLI

Contoh 1: Untuk mengunduh resep komponen dalam YAML format (Linux, macOS, atau Unix)

get-componentContoh berikut mengunduh resep komponen Hello World ke file dalam YAML format. Perintah ini melakukan hal berikut:

Menggunakan --query parameter --output dan untuk mengontrol output perintah. Parameter ini mengekstrak gumpalan resep dari output perintah. Untuk informasi selengkapnya tentang mengontrol output, lihat Mengontrol Output AWS Perintah di Panduan Pengguna Antarmuka Baris Perintah. Menggunakan base64 utilitas. Utilitas ini menerjemahkan gumpalan yang diekstraksi ke teks asli. Gumpalan yang dikembalikan oleh get-component perintah yang berhasil adalah teks yang dikodekan base64. Anda harus memecahkan kode gumpalan ini untuk mendapatkan teks asli. Menyimpan teks yang diterjemahkan ke file. Bagian terakhir dari perintah (> com.example.HelloWorld-1.0.0.json) menyimpan teks yang diterjemahkan ke file.

aws greengrassv2 get-component \
    --arn arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0 \
    --recipe-output-format YAML \
    --query recipe \
    --output text | base64 --decode > com.example.HelloWorld-1.0.0.json

Untuk informasi selengkapnya, lihat Mengelola komponen di Panduan AWS Pengembang Greengrass V2.

Contoh 2: Untuk mengunduh resep komponen dalam YAML format (WindowsCMD)

get-componentContoh berikut mengunduh resep komponen Hello World ke file dalam YAML format. Perintah ini menggunakan certutil utilitas.

aws greengrassv2 get-component ^
    --arn arn:aws:greengrass:us-west-2:675946970638:components:com.example.HelloWorld:versions:1.0.0 ^
    --recipe-output-format YAML ^
    --query recipe ^
    --output text > com.example.HelloWorld-1.0.0.yaml.b64

certutil -decode com.example.HelloWorld-1.0.0.yaml.b64 com.example.HelloWorld-1.0.0.yaml

Untuk informasi selengkapnya, lihat Mengelola komponen di Panduan AWS Pengembang Greengrass V2.

Contoh 3: Untuk mengunduh resep komponen dalam YAML format (Windows PowerShell)

get-componentContoh berikut mengunduh resep komponen Hello World ke file dalam YAML format. Perintah ini menggunakan certutil utilitas.

aws greengrassv2 get-component `
    --arn arn:aws:greengrass:us-west-2:675946970638:components:com.example.HelloWorld:versions:1.0.0 `
    --recipe-output-format YAML `
    --query recipe `
    --output text > com.example.HelloWorld-1.0.0.yaml.b64

certutil -decode com.example.HelloWorld-1.0.0.yaml.b64 com.example.HelloWorld-1.0.0.yaml

Untuk informasi selengkapnya, lihat Mengelola komponen di Panduan AWS Pengembang Greengrass V2.

  • Untuk API detailnya, lihat GetComponentdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-connectivity-info.

AWS CLI

Untuk mendapatkan informasi konektivitas untuk perangkat inti Greengrass

get-connectivity-infoContoh berikut mendapatkan informasi konektivitas untuk perangkat inti Greengrass. Perangkat klien menggunakan informasi ini untuk terhubung ke MQTT broker yang berjalan pada perangkat inti ini.

aws greengrassv2 get-connectivity-info \
    --thing-name MyGreengrassCore

Output:

{
    "connectivityInfo": [
        {
            "id": "localIP_192.0.2.0",
            "hostAddress": "192.0.2.0",
            "portNumber": 8883
        }
    ]
}

Untuk informasi selengkapnya, lihat Mengelola titik akhir perangkat inti di Panduan Pengembang Greengrass V2 AWS IoT.

Contoh kode berikut menunjukkan cara menggunakanget-core-device.

AWS CLI

Untuk mendapatkan perangkat inti

get-core-deviceContoh berikut mendapatkan informasi tentang perangkat inti AWS Greengrass IoT.

aws greengrassv2 get-core-device \
    --core-device-thing-name MyGreengrassCore

Output:

{
    "coreDeviceThingName": "MyGreengrassCore",
    "coreVersion": "2.0.3",
    "platform": "linux",
    "architecture": "amd64",
    "status": "HEALTHY",
    "lastStatusUpdateTimestamp": "2021-01-08T04:57:58.838000-08:00",
    "tags": {}
}

Untuk informasi selengkapnya, lihat Periksa status perangkat inti di Panduan Pengembang AWS Greengrass V2 IoT.

  • Untuk API detailnya, lihat GetCoreDevicedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-deployment.

AWS CLI

Untuk mendapatkan penerapan

get-deploymentContoh berikut mendapatkan informasi tentang penyebaran komponen inti Greengrass AWS IoT ke sekelompok perangkat inti.

aws greengrassv2 get-deployment \
    --deployment-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Output:

{
    "targetArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/MyGreengrassCoreGroup",
    "revisionId": "14",
    "deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "deploymentName": "Deployment for MyGreengrassCoreGroup",
    "deploymentStatus": "ACTIVE",
    "iotJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
    "iotJobArn": "arn:aws:iot:us-west-2:123456789012:job/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
    "components": {
        "aws.greengrass.Nucleus": {
            "componentVersion": "2.0.3",
            "configurationUpdate": {
                "merge": "{\"jvmOptions\":\"-Xmx64m\",\"logging\":{\"level\":\"WARN\"}}",
                "reset": [
                    "/networkProxy",
                    "/mqtt"
                ]
            }
        }
    },
    "deploymentPolicies": {
        "failureHandlingPolicy": "ROLLBACK",
        "componentUpdatePolicy": {
            "timeoutInSeconds": 60,
            "action": "NOTIFY_COMPONENTS"
        },
        "configurationValidationPolicy": {
            "timeoutInSeconds": 60
        }
    },
    "iotJobConfiguration": {},
    "creationTimestamp": "2021-01-07T17:21:20.691000-08:00",
    "isLatestForTarget": false,
    "tags": {}
}

Untuk informasi selengkapnya, lihat Menerapkan komponen ke perangkat di Panduan Pengembang AWS Greengrass V2.

  • Untuk API detailnya, lihat GetDeploymentdi Referensi AWS CLI Perintah.

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

AWS CLI

Untuk mendapatkan peran layanan Greengrass untuk akun Anda AWS

get-service-role-for-accountContoh berikut mendapatkan peran layanan yang terkait dengan AWS IoT Greengrass untuk akun Anda. AWS 

aws greengrassv2 get-service-role-for-account

Output:

{
    "associatedAt": "2022-01-19T19:21:53Z",
    "roleArn": "arn:aws:iam::123456789012:role/service-role/Greengrass_ServiceRole"
}

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

Contoh kode berikut menunjukkan cara menggunakanlist-client-devices-associated-with-core-device.

AWS CLI

Untuk membuat daftar perangkat klien yang terkait dengan perangkat inti

list-client-devices-associated-with-core-deviceContoh berikut mencantumkan semua perangkat klien yang terkait dengan perangkat inti.

aws greengrassv2 list-client-devices-associated-with-core-device \
  --core-device-thing-name MyTestGreengrassCore

Output:

{
    "associatedClientDevices": [
        {
            "thingName": "MyClientDevice2",
            "associationTimestamp": "2021-07-12T16:33:55.843000-07:00"
        },
        {
            "thingName": "MyClientDevice1",
            "associationTimestamp": "2021-07-12T16:33:55.843000-07:00"
        }
    ]
}

Untuk informasi selengkapnya, lihat Berinteraksi dengan perangkat IoT lokal di Panduan Pengembang AWS Greengrass V2.

Contoh kode berikut menunjukkan cara menggunakanlist-component-versions.

AWS CLI

Untuk membuat daftar versi komponen

list-component-versionsContoh berikut mencantumkan semua versi komponen Hello World.

aws greengrassv2 list-component-versions \
    --arn arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld

Output:

{
    "componentVersions": [
        {
            "componentName": "com.example.HelloWorld",
            "componentVersion": "1.0.1",
            "arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.1"
        },
        {
            "componentName": "com.example.HelloWorld",
            "componentVersion": "1.0.0",
            "arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.0"
        }
    ]
}

Untuk informasi selengkapnya, lihat Mengelola komponen di Panduan AWS Pengembang Greengrass V2.

Contoh kode berikut menunjukkan cara menggunakanlist-components.

AWS CLI

Untuk daftar komponen

list-componentsContoh berikut mencantumkan setiap komponen dan versi terbarunya yang ditentukan di AWS akun Anda di Wilayah saat ini.

aws greengrassv2 list-components

Output:

{
    "components": [
        {
            "arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld",
            "componentName": "com.example.HelloWorld",
            "latestVersion": {
                "arn": "arn:aws:greengrass:us-west-2:123456789012:components:com.example.HelloWorld:versions:1.0.1",
                "componentVersion": "1.0.1",
                "creationTimestamp": "2021-01-08T16:51:07.352000-08:00",
                "description": "My first AWS IoT Greengrass component.",
                "publisher": "Amazon",
                "platforms": [
                    {
                        "attributes": {
                            "os": "linux"
                        }
                    }
                ]
            }
        }
    ]
}

Untuk informasi selengkapnya, lihat Mengelola komponen di Panduan AWS Pengembang Greengrass V2.

  • Untuk API detailnya, lihat ListComponentsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-core-devices.

AWS CLI

Untuk membuat daftar perangkat inti

list-core-devicesContoh berikut mencantumkan perangkat inti AWS Greengrass IoT di akun Anda di Wilayah saat ini. AWS 

aws greengrassv2 list-core-devices

Output:

{
    "coreDevices": [
        {
            "coreDeviceThingName": "MyGreengrassCore",
            "status": "HEALTHY",
            "lastStatusUpdateTimestamp": "2021-01-08T04:57:58.838000-08:00"
        }
    ]
}

Untuk informasi selengkapnya, lihat Periksa status perangkat inti di Panduan Pengembang AWS Greengrass V2 IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-deployments.

AWS CLI

Untuk membuat daftar penerapan

list-deploymentsContoh berikut mencantumkan revisi terbaru dari setiap penerapan yang ditentukan di AWS akun Anda di Wilayah saat ini.

aws greengrassv2 list-deployments

Output:

{
    "deployments": [
        {
            "targetArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/MyGreengrassCoreGroup",
            "revisionId": "14",
            "deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "deploymentName": "Deployment for MyGreengrassCoreGroup",
            "creationTimestamp": "2021-01-07T17:21:20.691000-08:00",
            "deploymentStatus": "ACTIVE",
            "isLatestForTarget": false
        },
        {
            "targetArn": "arn:aws:iot:us-west-2:123456789012:thing/MyGreengrassCore",
            "revisionId": "1",
            "deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
            "deploymentName": "Deployment for MyGreengrassCore",
            "creationTimestamp": "2021-01-06T16:10:42.407000-08:00",
            "deploymentStatus": "COMPLETED",
            "isLatestForTarget": false
        }
    ]
}

Untuk informasi selengkapnya, lihat Menerapkan komponen ke perangkat di Panduan Pengembang AWS Greengrass V2.

Contoh kode berikut menunjukkan cara menggunakanlist-effective-deployments.

AWS CLI

Untuk membuat daftar pekerjaan penerapan

list-effective-deploymentsContoh berikut mencantumkan penerapan yang berlaku untuk perangkat inti AWS Greengrass IoT.

aws greengrassv2 list-effective-deployments \
    --core-device-thing-name MyGreengrassCore

Output:

{
    "effectiveDeployments": [
        {
            "deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
            "deploymentName": "Deployment for MyGreengrassCore",
            "iotJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
            "targetArn": "arn:aws:iot:us-west-2:123456789012:thing/MyGreengrassCore",
            "coreDeviceExecutionStatus": "COMPLETED",
            "reason": "SUCCESSFUL",
            "creationTimestamp": "2021-01-06T16:10:42.442000-08:00",
            "modifiedTimestamp": "2021-01-08T17:21:27.830000-08:00"
        },
        {
            "deploymentId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
            "deploymentName": "Deployment for MyGreengrassCoreGroup",
            "iotJobId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE44444",
            "iotJobArn": "arn:aws:iot:us-west-2:123456789012:job/a1b2c3d4-5678-90ab-cdef-EXAMPLE44444",
            "targetArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/MyGreengrassCoreGroup",
            "coreDeviceExecutionStatus": "SUCCEEDED",
            "reason": "SUCCESSFUL",
            "creationTimestamp": "2021-01-07T17:19:20.394000-08:00",
            "modifiedTimestamp": "2021-01-07T17:21:20.721000-08:00"
        }
    ]
}

Untuk informasi selengkapnya, lihat Periksa status perangkat inti di Panduan Pengembang AWS Greengrass V2 IoT.

Contoh kode berikut menunjukkan cara menggunakanlist-installed-components.

AWS CLI

Untuk membuat daftar komponen yang diinstal pada perangkat inti

list-installed-componentsContoh berikut mencantumkan komponen yang diinstal pada perangkat inti AWS Greengrass IoT.

aws greengrassv2 list-installed-components \
    --core-device-thing-name MyGreengrassCore

Output:

{
    "installedComponents": [
        {
            "componentName": "aws.greengrass.Cli",
            "componentVersion": "2.0.3",
            "lifecycleState": "RUNNING",
            "isRoot": true
        },
        {
            "componentName": "aws.greengrass.Nucleus",
            "componentVersion": "2.0.3",
            "lifecycleState": "FINISHED",
            "isRoot": true
        }
    ]
}

Untuk informasi selengkapnya, lihat Periksa status perangkat inti di Panduan Pengembang AWS Greengrass V2 IoT.

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

AWS CLI

Untuk membuat daftar tag untuk sumber daya

list-tags-for-resourceContoh berikut mencantumkan semua tag untuk perangkat inti AWS Greengrass IoT.

aws greengrassv2 list-tags-for-resource \
    --resource-arn arn:aws:greengrass:us-west-2:123456789012:coreDevices:MyGreengrassCore

Output:

{
    "tags": {
        "Owner": "richard-roe"
    }
}

Untuk informasi selengkapnya, lihat Menandai sumber daya Anda di Panduan AWS Pengembang Greengrass V2.

Contoh kode berikut menunjukkan cara menggunakantag-resource.

AWS CLI

Untuk menambahkan tanda ke sumber daya

tag-resourceContoh berikut menambahkan tag pemilik ke perangkat inti AWS Greengrass IoT. Anda dapat menggunakan tag ini untuk mengontrol akses ke perangkat inti berdasarkan siapa yang memilikinya.

aws greengrassv2 tag-resource \
    --resource-arn arn:aws:greengrass:us-west-2:123456789012:coreDevices:MyGreengrassCore \
    --tags Owner=richard-roe

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai sumber daya Anda di Panduan AWS Pengembang Greengrass V2.

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

Contoh kode berikut menunjukkan cara menggunakanuntag-resource.

AWS CLI

Untuk menghapus tag dari sumber daya

untag-resourceContoh berikut menghapus tag pemilik dari perangkat inti AWS Greengrass IoT.

aws iotsitewise untag-resource \
    --resource-arn arn:aws:greengrass:us-west-2:123456789012:coreDevices:MyGreengrassCore \
    --tag-keys Owner

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menandai sumber daya Anda di Panduan AWS Pengembang Greengrass V2.

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

Contoh kode berikut menunjukkan cara menggunakanupdate-connectivity-info.

AWS CLI

Untuk memperbarui informasi konektivitas untuk perangkat inti Greengrass

update-connectivity-infoContoh berikut mendapatkan informasi konektivitas untuk perangkat inti Greengrass. Perangkat klien menggunakan informasi ini untuk terhubung ke MQTT broker yang berjalan pada perangkat inti ini.

aws greengrassv2 update-connectivity-info \
    --thing-name MyGreengrassCore \
    --cli-input-json file://core-device-connectivity-info.json

Isi dari core-device-connectivity-info.json:

{
    "connectivityInfo": [
        {
            "hostAddress": "192.0.2.0",
            "portNumber": 8883,
            "id": "localIP_192.0.2.0"
        }
    ]
}

Output:

{
    "version": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}

Untuk informasi selengkapnya, lihat Mengelola titik akhir perangkat inti di Panduan Pengembang Greengrass V2 AWS IoT.