View a markdown version of this page

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 menerapkan skenario umum dengan menggunakan AWS Command Line Interface with AWS IoT Greengrass V2.

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-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 AWS akun Anda.

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

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 Ber interaksi dengan perangkat IoT lokal di Panduan Pengembang AWS IoT Greengrass V2.

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

AWS CLI

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 Ber interaksi dengan perangkat IoT lokal di Panduan Pengembang AWS IoT Greengrass V2.

Contoh kode berikut menunjukkan cara menggunakancancel-deployment.

AWS CLI

Untuk membatalkan penerapan

cancel-deploymentContoh berikut menghentikan penerapan berkelanjutan ke grup benda.

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

Output:

{
    "message": "SUCCESS"
}

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

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 untuk diterapkan di Panduan Pengembang AWS IoT Greengrass V2.

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

Contoh kode berikut menunjukkan cara menggunakancreate-deployment.

AWS CLI

Contoh 1: Untuk membuat penerapan

create-deploymentContoh berikut menerapkan Antarmuka Bar AWS is Perintah IoT Greengrass 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 AWS IoT Greengrass V2.

Contoh 2: Untuk membuat penerapan yang memperbarui konfigurasi komponen

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

Setel ulang pengaturan proxy perangkat target ke default tanpa pengaturan proksi.Setel ulang pengaturan MQTT perangkat target ke defaultnya.Menetapkan opsi JVM untuk nukleus 'level logging untuk nukleus. JVM.Sets 

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 Memper barui konfigurasi komponen di Panduan Pengembang AWS IoT Greengrass V2.

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

Contoh kode berikut menunjukkan cara menggunakandelete-core-device.

AWS CLI

Untuk menghapus perangkat inti

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

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

Perintah ini tidak menghasilkan output.

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

Contoh kode berikut menunjukkan cara menggunakandescribe-component.

AWS CLI

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

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

AWS CLI

Untuk mendapatkan URL untuk mengunduh artefak komponen

get-component-version-artifactContoh berikut mendapatkan URL untuk mengunduh file JAR 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 Pengembang AWS IoT Greengrass V2.

Contoh kode berikut menunjukkan cara menggunakanget-component.

AWS CLI

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

get-componentContoh berikut mengunduh resep komponen Hello World ke file dalam format YAML. 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 mengendalikan output, lihat Meng ontrol Output Per AWS intah di Panduan Pengguna Antarmuka Baris Perintah. Menggunakan base64 utilitas. Utilitas ini memecahkan kode gumpalan yang diekstraksi ke teks asli. Blob yang dikembalikan oleh get-component perintah yang berhasil adalah teks yang dikodekan base64. Anda harus memecahkan kode gumpalan ini untuk mendapatkan teks aslinya. Menyimpan teks yang didekodekan ke file. Bagian terakhir dari perintah (> com.example.HelloWorld-1.0.0.json) menyimpan teks yang didekodekan 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 Pengembang AWS IoT Greengrass V2.

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

get-componentContoh berikut mengunduh resep komponen Hello World ke file dalam format YAML. 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 Pengembang AWS IoT Greengrass V2.

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

get-componentContoh berikut mengunduh resep komponen Hello World ke file dalam format YAML. 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 Pengembang AWS IoT Greengrass V2.

  • Untuk detail API, lihat GetComponent di Refer AWS CLI ensi 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 broker MQTT 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 AWS IoT Greengrass V2.

Contoh kode berikut menunjukkan cara menggunakanget-core-device.

AWS CLI

Untuk mendapatkan perangkat inti

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

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

Contoh kode berikut menunjukkan cara menggunakanget-deployment.

AWS CLI

Untuk mendapatkan penerapan

get-deploymentContoh berikut mendapatkan informasi tentang penyebaran komponen inti AWS IoT Greengrass 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 Menyebarkan komponen ke perangkat di Panduan Pengembang AWS IoT Greengrass V2.

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 AWS akun Anda.

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

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 Ber interaksi dengan perangkat IoT lokal di Panduan Pengembang AWS IoT Greengrass V2.

Contoh kode berikut menunjukkan cara menggunakanlist-component-versions.

AWS CLI

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

Contoh kode berikut menunjukkan cara menggunakanlist-components.

AWS CLI

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

Contoh kode berikut menunjukkan cara menggunakanlist-core-devices.

AWS CLI

Untuk membuat daftar perangkat inti

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

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

Contoh kode berikut menunjukkan cara menggunakanlist-deployments.

AWS CLI

Untuk mencantumkan 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 Menyebarkan komponen ke perangkat di Panduan Pengembang AWS IoT 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 IoT Greengrass.

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

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

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

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

AWS CLI

Untuk mencantumkan tag untuk sumber daya

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

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

  • Untuk detail API, lihat TagResource di Refer AWS CLI ensi 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 IoT Greengrass.

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

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