**Dokumentasi ini AWS CLI hanya untuk Versi 1. **
Kami mengumumkan akhir dukungan yang akan datang untuk AWS CLI versi 1. AWS CLI Versi 1 sekarang dalam mode pemeliharaan. Kami menyarankan Anda bermigrasi ke AWS CLI versi 2. Untuk tanggal, detail tambahan, dan informasi tentang cara bermigrasi, lihat [ pengumuman](https://aws.amazon.com/blogs/developer/cli-v1-maintenance-mode-announcement/). Untuk dokumentasi yang terkait dengan Versi 2 AWS CLI, lihat Panduan Pengguna [ Versi 2](https://docs.aws.amazon.com/cli/latest/userguide/).
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.
**Topics**
+ [Tindakan](#actions)
## Tindakan
### `associate-service-role-to-account`
Contoh kode berikut menunjukkan cara menggunakan`associate-service-role-to-account`.
**AWS CLI**
**Untuk mengaitkan peran layanan Greengrass ke akun Anda AWS **
`associate-service-role-to-account`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-service-role.html) di Panduan Pengembang *AWS IoT Greengrass V2. *
+ Untuk detail API, lihat [ AssociateServiceRoleToAccount ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/associate-service-role-to-account.html) di Refer *AWS CLI ensi Perintah*.
### `batch-asosiasi-perangkat-klien-dengan-perangkat inti`
Contoh kode berikut menunjukkan cara menggunakan`batch-associate-client-device-with-core-device`.
**AWS CLI**
**Untuk mengaitkan perangkat klien dengan perangkat inti **
`batch-associate-client-device-with-core-device`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/interact-with-local-iot-devices.html) di Panduan * Pengembang *AWS IoT Greengrass V2.
+ Untuk detail API, lihat [ BatchAssociateClientDeviceWithCoreDevice ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/batch-associate-client-device-with-core-device.html) di Refer *AWS CLI ensi Perintah*.
### `batch-disasosiasikan perangkat-klien-dari-perangkat inti`
Contoh kode berikut menunjukkan cara menggunakan`batch-disassociate-client-device-from-core-device`.
**AWS CLI**
**Memisahkan perangkat klien dari perangkat inti **
`batch-disassociate-client-device-from-core-device`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/interact-with-local-iot-devices.html) di Panduan * Pengembang *AWS IoT Greengrass V2.
+ Untuk detail API, lihat [ BatchDisassociateClientDeviceFromCoreDevice ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/batch-disassociate-client-device-from-core-device.html) di Refer *AWS CLI ensi Perintah*.
### `batal-penyebaran`
Contoh kode berikut menunjukkan cara menggunakan`cancel-deployment`.
**AWS CLI**
**Untuk membatalkan penerapan **
`cancel-deployment`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/cancel-deployments.html) di Panduan Pengembang *AWS IoT Greengrass V2. *
+ Untuk detail API, lihat [ CancelDeployment ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/cancel-deployment.html) di Refer *AWS CLI ensi Perintah*.
### `buat-komponen-versi`
Contoh kode berikut menunjukkan cara menggunakan`create-component-version`.
**AWS CLI**
**Contoh 1: Untuk membuat versi komponen dari resep **
`create-component-version`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/create-components.html) dan [ Mengunggah komponen untuk ](https://docs.aws.amazon.com/greengrass/v2/developerguide/upload-components.html) diterapkan di Panduan * Pengembang *AWS IoT Greengrass V2.
**Contoh 2: Untuk membuat versi komponen dari fungsi AWS Lambda **
`create-component-version`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/run-lambda-functions.html) di Panduan Pengembang *AWS IoT Greengrass V2. *
+ Untuk detail API, lihat [ CreateComponentVersion ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/create-component-version.html) di Refer *AWS CLI ensi Perintah*.
### `buat-penyebaran`
Contoh kode berikut menunjukkan cara menggunakan`create-deployment`.
**AWS CLI**
**Contoh 1: Untuk membuat penerapan **
`create-deployment`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/create-deployments.html) di Panduan Pengembang *AWS IoT Greengrass V2. *
**Contoh 2: Untuk membuat penerapan yang memperbarui konfigurasi komponen **
`create-deployment`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/create-deployments.html) dan Memper [ barui konfigurasi komponen ](https://docs.aws.amazon.com/greengrass/v2/developerguide/update-component-configurations.html) di Panduan Pengembang *AWS IoT Greengrass V2. *
+ Untuk detail API, lihat [ CreateDeployment ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/create-deployment.html) di Refer *AWS CLI ensi Perintah*.
### `hapus komponen`
Contoh kode berikut menunjukkan cara menggunakan`delete-component`.
**AWS CLI**
**Untuk menghapus versi komponen **
`delete-component`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) di Panduan * Pengembang *AWS IoT Greengrass V2.
+ Untuk detail API, lihat [ DeleteComponent ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/delete-component.html) di Refer *AWS CLI ensi Perintah*.
### `hapus perangkat inti`
Contoh kode berikut menunjukkan cara menggunakan`delete-core-device`.
**AWS CLI**
**Untuk menghapus perangkat inti **
`delete-core-device`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/configure-greengrass-core-v2.html#uninstall-greengrass-core-v2) di Panduan Pengembang *AWS IoT Greengrass V2. *
+ Untuk detail API, lihat [ DeleteCoreDevice ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/delete-core-device.html) di Refer *AWS CLI ensi Perintah*.
### `deskripsi-komponen`
Contoh kode berikut menunjukkan cara menggunakan`describe-component`.
**AWS CLI**
**Untuk menggambarkan versi komponen **
`describe-component`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) di Panduan * Pengembang *AWS IoT Greengrass V2.
+ Untuk detail API, lihat [ DescribeComponent ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/describe-component.html) di Refer *AWS CLI ensi Perintah*.
### `disassociate-service-role-from-account`
Contoh kode berikut menunjukkan cara menggunakan`disassociate-service-role-from-account`.
**AWS CLI**
**Untuk memisahkan peran layanan Greengrass dari akun Anda AWS **
`disassociate-service-role-from-account`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-service-role.html) di Panduan Pengembang *AWS IoT Greengrass V2. *
+ Untuk detail API, lihat [ DisassociateServiceRoleFromAccount ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/disassociate-service-role-from-account.html) di Refer *AWS CLI ensi Perintah*.
### `artefak versi-komponen`
Contoh kode berikut menunjukkan cara menggunakan`get-component-version-artifact`.
**AWS CLI**
**Untuk mendapatkan URL untuk mengunduh artefak komponen **
`get-component-version-artifact`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) di Panduan * Pengembang *AWS IoT Greengrass V2.
+ Untuk detail API, lihat [ GetComponentVersionArtifact ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-component-version-artifact.html) di Refer *AWS CLI ensi Perintah*.
### `dapatkan-komponen`
Contoh kode berikut menunjukkan cara menggunakan`get-component`.
**AWS CLI**
**Contoh 1: Untuk mengunduh resep komponen dalam format YAML (Linux, macOS, atau Unix) **
`get-component`Contoh 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 ](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html) *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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) di Panduan * Pengembang *AWS IoT Greengrass V2.
**Contoh 2: Untuk mengunduh resep komponen dalam format YAML (Windows CMD) **
`get-component`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) di Panduan * Pengembang *AWS IoT Greengrass V2.
**Contoh 3: Untuk mengunduh resep komponen dalam format YAML (Windows PowerShell) **
`get-component`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) di Panduan * Pengembang *AWS IoT Greengrass V2.
+ Untuk detail API, lihat [ GetComponent ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-component.html) di Refer *AWS CLI ensi Perintah*.
### `dapatkan informasi konektivitas`
Contoh kode berikut menunjukkan cara menggunakan`get-connectivity-info`.
**AWS CLI**
**Untuk mendapatkan informasi konektivitas untuk perangkat inti Greengrass **
`get-connectivity-info`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-core-device-endpoints.html) di Panduan Pengembang *AWS IoT Greengrass V2. *
+ Untuk detail API, lihat [ GetConnectivityInfo ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-connectivity-info.html) di Refer *AWS CLI ensi Perintah*.
### `get-core-device`
Contoh kode berikut menunjukkan cara menggunakan`get-core-device`.
**AWS CLI**
**Untuk mendapatkan perangkat inti **
`get-core-device`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-status.html) di Panduan * Pengembang *AWS IoT Greengrass V2.
+ Untuk detail API, lihat [ GetCoreDevice ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-core-device.html) di Refer *AWS CLI ensi Perintah*.
### `dapatkan penyebaran`
Contoh kode berikut menunjukkan cara menggunakan`get-deployment`.
**AWS CLI**
**Untuk mendapatkan penerapan **
`get-deployment`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-deployments.html) di Panduan * Pengembang *AWS IoT Greengrass V2.
+ Untuk detail API, lihat [ GetDeployment ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-deployment.html) di Refer *AWS CLI ensi Perintah*.
### `get-service-role-for-account`
Contoh kode berikut menunjukkan cara menggunakan`get-service-role-for-account`.
**AWS CLI**
**Untuk mendapatkan peran layanan Greengrass untuk akun Anda AWS **
`get-service-role-for-account`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-service-role.html) di Panduan Pengembang *AWS IoT Greengrass V2. *
+ Untuk detail API, lihat [ GetServiceRoleForAccount ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-service-role-for-account.html) di Refer *AWS CLI ensi Perintah*.
### `daftar-perangkat-klien-yang diasosiasikan dengan-perangkat inti`
Contoh kode berikut menunjukkan cara menggunakan`list-client-devices-associated-with-core-device`.
**AWS CLI**
**Untuk membuat daftar perangkat klien yang terkait dengan perangkat inti **
`list-client-devices-associated-with-core-device`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/interact-with-local-iot-devices.html) di Panduan * Pengembang *AWS IoT Greengrass V2.
+ Untuk detail API, lihat [ ListClientDevicesAssociatedWithCoreDevice ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-client-devices-associated-with-core-device.html) di Refer *AWS CLI ensi Perintah*.
### `versi-komponen daftar`
Contoh kode berikut menunjukkan cara menggunakan`list-component-versions`.
**AWS CLI**
**Untuk mencantumkan versi komponen **
`list-component-versions`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) di Panduan * Pengembang *AWS IoT Greengrass V2.
+ Untuk detail API, lihat [ ListComponentVersions ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-component-versions.html) di Refer *AWS CLI ensi Perintah*.
### `daftar komponen`
Contoh kode berikut menunjukkan cara menggunakan`list-components`.
**AWS CLI**
**Untuk membuat daftar komponen **
`list-components`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) di Panduan * Pengembang *AWS IoT Greengrass V2.
+ Untuk detail API, lihat [ ListComponents ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-components.html) di Refer *AWS CLI ensi Perintah*.
### `daftar perangkat inti`
Contoh kode berikut menunjukkan cara menggunakan`list-core-devices`.
**AWS CLI**
**Untuk membuat daftar perangkat inti **
`list-core-devices`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-status.html) di Panduan * Pengembang *AWS IoT Greengrass V2.
+ Untuk detail API, lihat [ ListCoreDevices ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-core-devices.html) di Refer *AWS CLI ensi Perintah*.
### `penerapan daftar`
Contoh kode berikut menunjukkan cara menggunakan`list-deployments`.
**AWS CLI**
**Untuk mencantumkan penerapan **
`list-deployments`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-deployments.html) di Panduan * Pengembang *AWS IoT Greengrass V2.
+ Untuk detail API, lihat [ ListDeployments ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-deployments.html) di Refer *AWS CLI ensi Perintah*.
### `daftar penerapan yang efektif`
Contoh kode berikut menunjukkan cara menggunakan`list-effective-deployments`.
**AWS CLI**
**Untuk membuat daftar pekerjaan penerapan **
`list-effective-deployments`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-status.html) di Panduan * Pengembang *AWS IoT Greengrass V2.
+ Untuk detail API, lihat [ ListEffectiveDeployments ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-effective-deployments.html) di Refer *AWS CLI ensi Perintah*.
### `daftar komponen yang diinstal`
Contoh kode berikut menunjukkan cara menggunakan`list-installed-components`.
**AWS CLI**
**Untuk membuat daftar komponen yang diinstal pada perangkat inti **
`list-installed-components`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-status.html) di Panduan * Pengembang *AWS IoT Greengrass V2.
+ Untuk detail API, lihat [ ListInstalledComponents ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-installed-components.html) di Refer *AWS CLI ensi Perintah*.
### `list-tags-for-resource`
Contoh kode berikut menunjukkan cara menggunakan`list-tags-for-resource`.
**AWS CLI**
**Untuk mencantumkan tag untuk sumber daya **
`list-tags-for-resource`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/tag-resources.html) di Panduan * Pengembang *AWS IoT Greengrass V2.
+ Untuk detail API, lihat [ ListTagsForResource ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-tags-for-resource.html) di Refer *AWS CLI ensi Perintah*.
### `tag-resource`
Contoh kode berikut menunjukkan cara menggunakan`tag-resource`.
**AWS CLI**
**Untuk menambahkan tanda ke sumber daya**
`tag-resource`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/tag-resources.html) di Panduan * Pengembang *AWS IoT Greengrass V2.
+ Untuk detail API, lihat [ TagResource ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/tag-resource.html) di Refer *AWS CLI ensi Perintah*.
### `untag-resource`
Contoh kode berikut menunjukkan cara menggunakan`untag-resource`.
**AWS CLI**
**Untuk menghapus tag dari sumber daya **
`untag-resource`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/tag-resources.html) di Panduan * Pengembang *AWS IoT Greengrass V2.
+ Untuk detail API, lihat [ UntagResource ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/untag-resource.html) di Refer *AWS CLI ensi Perintah*.
### `perbarui-info konektivitas`
Contoh kode berikut menunjukkan cara menggunakan`update-connectivity-info`.
**AWS CLI**
**Untuk memperbarui informasi konektivitas untuk perangkat inti Greengrass **
`update-connectivity-info`Contoh 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 ](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-core-device-endpoints.html) di Panduan Pengembang *AWS IoT Greengrass V2. *
+ Untuk detail API, lihat [ UpdateConnectivityInfo ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/update-connectivity-info.html) di Refer *AWS CLI ensi Perintah*.