Ada lebih banyak contoh AWS SDK yang tersedia di repo Contoh [SDK AWS Doc](https://github.com/awsdocs/aws-doc-sdk-examples). GitHub
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* 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 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](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-service-role.html) V2 IoT AWS .*
+ Untuk detail API, lihat [AssociateServiceRoleToAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/associate-service-role-to-account.html)di *Referensi AWS CLI Perintah*.
### `batch-associate-client-device-with-core-device`
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 [Berinteraksi dengan perangkat IoT lokal di Panduan Pengembang AWS](https://docs.aws.amazon.com/greengrass/v2/developerguide/interact-with-local-iot-devices.html) *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 *Referensi AWS CLI Perintah*.
### `batch-disassociate-client-device-from-core-device`
Contoh kode berikut menunjukkan cara menggunakan`batch-disassociate-client-device-from-core-device`.
**AWS CLI**
**Untuk 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 [Berinteraksi dengan perangkat IoT lokal di Panduan Pengembang AWS](https://docs.aws.amazon.com/greengrass/v2/developerguide/interact-with-local-iot-devices.html) *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 *Referensi AWS CLI Perintah*.
### `cancel-deployment`
Contoh kode berikut menunjukkan cara menggunakan`cancel-deployment`.
**AWS CLI**
**Untuk membatalkan penerapan**
`cancel-deployment`Contoh 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](https://docs.aws.amazon.com/greengrass/v2/developerguide/cancel-deployments.html) di Panduan Pengembang *AWS Greengrass* V2 IoT.
+ Untuk detail API, lihat [CancelDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/cancel-deployment.html)di *Referensi AWS CLI Perintah*.
### `create-component-version`
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 yang akan diterapkan](https://docs.aws.amazon.com/greengrass/v2/developerguide/upload-components.html) di Panduan Pengembang *Greengrass V2 AWS IoT*.
**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 Greengrass* V2 IoT.
+ Untuk detail API, lihat [CreateComponentVersion](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/create-component-version.html)di *Referensi AWS CLI Perintah*.
### `create-deployment`
Contoh kode berikut menunjukkan cara menggunakan`create-deployment`.
**AWS CLI**
**Contoh 1: Untuk membuat penerapan**
`create-deployment`Contoh 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](https://docs.aws.amazon.com/greengrass/v2/developerguide/create-deployments.html) di Panduan Pengembang IoT *AWS Greengrass* V2.
**Contoh 2: Untuk membuat penerapan yang memperbarui konfigurasi komponen**
`create-deployment`Contoh berikut menyebarkan komponen inti Greengrass AWS IoT ke sekelompok perangkat inti. Penerapan ini menerapkan pembaruan konfigurasi berikut untuk komponen inti:
Setel ulang pengaturan proxy perangkat target ke defaultnya tanpa pengaturan proxy. Setel ulang pengaturan MQTT perangkat target ke defaultnya.Menetapkan opsi JVM untuk JVM.set level logging untuk nukleus.
```
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 [Memperbarui 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 *Referensi AWS CLI Perintah*.
### `delete-component`
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 *AWS Pengembang Greengrass V2*.
+ Untuk detail API, lihat [DeleteComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/delete-component.html)di *Referensi AWS CLI Perintah*.
### `delete-core-device`
Contoh kode berikut menunjukkan cara menggunakan`delete-core-device`.
**AWS CLI**
**Untuk menghapus perangkat inti**
`delete-core-device`Contoh 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](https://docs.aws.amazon.com/greengrass/v2/developerguide/configure-greengrass-core-v2.html#uninstall-greengrass-core-v2) V2.*
+ Untuk detail API, lihat [DeleteCoreDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/delete-core-device.html)di *Referensi AWS CLI Perintah*.
### `describe-component`
Contoh kode berikut menunjukkan cara menggunakan`describe-component`.
**AWS CLI**
**Untuk mendeskripsikan 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 *AWS Pengembang Greengrass V2*.
+ Untuk detail API, lihat [DescribeComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/describe-component.html)di *Referensi AWS CLI 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 di Panduan Pengembang Greengrass](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-service-role.html) V2 IoT AWS .*
+ Untuk detail API, lihat [DisassociateServiceRoleFromAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/disassociate-service-role-from-account.html)di *Referensi AWS CLI Perintah*.
### `get-component-version-artifact`
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 *AWS Pengembang Greengrass V2*.
+ Untuk detail API, lihat [GetComponentVersionArtifact](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-component-version-artifact.html)di *Referensi AWS CLI Perintah*.
### `get-component`
Contoh kode berikut menunjukkan cara menggunakan`get-component`.
**AWS CLI**
**Contoh 1: Untuk mengunduh resep komponen dalam format YAMM (Linux, macOS, atau Unix)**
`get-component`Contoh berikut mengunduh resep komponen Hello World ke file dalam format YAMM. 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](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html) *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](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-components.html) di Panduan *AWS Pengembang Greengrass V2*.
**Contoh 2: Untuk mengunduh resep komponen dalam format YAMM (Windows CMD)**
`get-component`Contoh berikut mengunduh resep komponen Hello World ke file dalam format YAMM. 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 *AWS Pengembang Greengrass V2*.
**Contoh 3: Untuk mengunduh resep komponen dalam format YAMAL (Windows PowerShell)**
`get-component`Contoh berikut mengunduh resep komponen Hello World ke file dalam format YAMM. 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 *AWS Pengembang Greengrass V2*.
+ Untuk detail API, lihat [GetComponent](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-component.html)di *Referensi AWS CLI Perintah*.
### `get-connectivity-info`
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 di Panduan](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-core-device-endpoints.html) Pengembang *Greengrass V2 AWS IoT*.
+ Untuk detail API, lihat [GetConnectivityInfo](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-connectivity-info.html)di *Referensi AWS CLI 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 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](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-status.html) Pengembang *AWS Greengrass V2 IoT*.
+ Untuk detail API, lihat [GetCoreDevice](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-core-device.html)di *Referensi AWS CLI Perintah*.
### `get-deployment`
Contoh kode berikut menunjukkan cara menggunakan`get-deployment`.
**AWS CLI**
**Untuk mendapatkan penerapan**
`get-deployment`Contoh 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](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-deployments.html) di Panduan Pengembang *AWS Greengrass* V2.
+ Untuk detail API, lihat [GetDeployment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-deployment.html)di *Referensi AWS CLI 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 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](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-service-role.html) V2 IoT AWS .*
+ Untuk detail API, lihat [GetServiceRoleForAccount](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/get-service-role-for-account.html)di *Referensi AWS CLI Perintah*.
### `list-client-devices-associated-with-core-device`
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 [Berinteraksi dengan perangkat IoT lokal di Panduan Pengembang AWS](https://docs.aws.amazon.com/greengrass/v2/developerguide/interact-with-local-iot-devices.html) *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 *Referensi AWS CLI Perintah*.
### `list-component-versions`
Contoh kode berikut menunjukkan cara menggunakan`list-component-versions`.
**AWS CLI**
**Untuk membuat daftar 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 *AWS Pengembang Greengrass V2*.
+ Untuk detail API, lihat [ListComponentVersions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-component-versions.html)di *Referensi AWS CLI Perintah*.
### `list-components`
Contoh kode berikut menunjukkan cara menggunakan`list-components`.
**AWS CLI**
**Untuk 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 *AWS Pengembang Greengrass V2*.
+ Untuk detail API, lihat [ListComponents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-components.html)di *Referensi AWS CLI Perintah*.
### `list-core-devices`
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 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](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-status.html) Pengembang *AWS Greengrass V2 IoT*.
+ Untuk detail API, lihat [ListCoreDevices](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-core-devices.html)di *Referensi AWS CLI Perintah*.
### `list-deployments`
Contoh kode berikut menunjukkan cara menggunakan`list-deployments`.
**AWS CLI**
**Untuk membuat daftar 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 [Menerapkan komponen ke perangkat](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-deployments.html) di Panduan Pengembang *AWS Greengrass* V2.
+ Untuk detail API, lihat [ListDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-deployments.html)di *Referensi AWS CLI Perintah*.
### `list-effective-deployments`
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 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](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-status.html) Pengembang *AWS Greengrass V2 IoT*.
+ Untuk detail API, lihat [ListEffectiveDeployments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-effective-deployments.html)di *Referensi AWS CLI Perintah*.
### `list-installed-components`
Contoh kode berikut menunjukkan cara menggunakan`list-installed-components`.
**AWS CLI**
**Untuk daftar komponen yang diinstal pada perangkat inti**
`list-installed-components`Contoh 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](https://docs.aws.amazon.com/greengrass/v2/developerguide/device-status.html) Pengembang *AWS Greengrass V2 IoT*.
+ Untuk detail API, lihat [ListInstalledComponents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-installed-components.html)di *Referensi AWS CLI Perintah*.
### `list-tags-for-resource`
Contoh kode berikut menunjukkan cara menggunakan`list-tags-for-resource`.
**AWS CLI**
**Untuk membuat daftar tag untuk sumber daya**
`list-tags-for-resource`Contoh 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](https://docs.aws.amazon.com/greengrass/v2/developerguide/tag-resources.html) di Panduan *AWS Pengembang Greengrass V2*.
+ Untuk detail API, lihat [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/list-tags-for-resource.html)di *Referensi AWS CLI 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 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](https://docs.aws.amazon.com/greengrass/v2/developerguide/tag-resources.html) di Panduan *AWS Pengembang Greengrass V2*.
+ Untuk detail API, lihat [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/tag-resource.html)di *Referensi AWS CLI 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 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](https://docs.aws.amazon.com/greengrass/v2/developerguide/tag-resources.html) di Panduan *AWS Pengembang Greengrass V2*.
+ Untuk detail API, lihat [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/untag-resource.html)di *Referensi AWS CLI Perintah*.
### `update-connectivity-info`
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 di Panduan](https://docs.aws.amazon.com/greengrass/v2/developerguide/manage-core-device-endpoints.html) Pengembang *Greengrass V2 AWS IoT*.
+ Untuk detail API, lihat [UpdateConnectivityInfo](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/greengrassv2/update-connectivity-info.html)di *Referensi AWS CLI Perintah*.