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

# Topik MQTT Bayangan Perangkat
<a name="device-shadow-mqtt"></a>

Layanan Device Shadow menggunakan topik MQTT yang dicadangkan untuk memungkinkan perangkat dan aplikasi mendapatkan, memperbarui, atau menghapus informasi status untuk perangkat (bayangan). 

Menerbitkan dan berlangganan topik bayangan memerlukan otorisasi berbasis topik. AWS IoT berhak untuk menambahkan topik baru ke struktur topik yang ada. Untuk alasan ini, kami menyarankan Anda menghindari langganan wild card ke topik bayangan. Misalnya, hindari berlangganan filter topik seperti `$aws/things/thingName/shadow/#` karena jumlah topik yang cocok dengan filter topik ini mungkin meningkat saat AWS IoT memperkenalkan topik bayangan baru. Untuk contoh pesan yang dipublikasikan pada topik ini lihat[Berinteraksi dengan bayangan](device-shadow-data-flow.md).

Bayangan dapat dinamai atau tidak disebutkan namanya (klasik). Topik yang digunakan oleh masing-masing hanya berbeda dalam awalan topik. Tabel ini menunjukkan awalan topik yang digunakan oleh setiap jenis bayangan.


| Nilai *ShadowTopicPrefix* | Jenis bayangan | 
| --- | --- | 
| \$1aws/things/thingName/shadow | Bayangan tanpa nama (klasik) | 
| \$1aws/things/thingName/shadow/name/shadowName | Bernama bayangan | 

Untuk membuat topik lengkap, pilih jenis bayangan yang ingin Anda rujuk, ganti, dan `shadowName` jika berlaku`thingName`, dengan nilai yang sesuai, lalu tambahkan dengan rintisan topik seperti yang ditunjukkan pada bagian berikut. `ShadowTopicPrefix`

Berikut ini adalah topik MQTT yang digunakan untuk berinteraksi dengan bayangan.

**Topics**
+ [/dapatkan](#get-pub-sub-topic)
+ [/dapatkan/diterima](#get-accepted-pub-sub-topic)
+ [/dapatkan/ditolak](#get-rejected-pub-sub-topic)
+ [/perbarui](#update-pub-sub-topic)
+ [/perbarui/delta](#update-delta-pub-sub-topic)
+ [/perbarui/diterima](#update-accepted-pub-sub-topic)
+ [/pembaruan/dokumen](#update-documents-pub-sub-topic)
+ [/perbarui/ditolak](#update-rejected-pub-sub-topic)
+ [/delete](#delete-pub-sub-topic)
+ [/hapus/diterima](#delete-accepted-pub-sub-topic)
+ [/hapus/ditolak](#delete-rejected-pub-sub-topic)

## /dapatkan
<a name="get-pub-sub-topic"></a>

Publikasikan pesan kosong ke topik ini untuk mendapatkan bayangan perangkat:

```
ShadowTopicPrefix/get
```

AWS IoT merespons dengan menerbitkan salah satu [/dapatkan/diterima](#get-accepted-pub-sub-topic) atau[/dapatkan/ditolak](#get-rejected-pub-sub-topic).

### Contoh kebijakan
<a name="get-policy"></a>

Berikut ini adalah contoh kebijakan yang diperlukan:

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iot:Publish"
            ],
            "Resource": [
                "arn:aws:iot:us-east-1:123456789012:topic/$aws/things/thingName/shadow/get"
            ]
        }
    ]
}
```

## /dapatkan/diterima
<a name="get-accepted-pub-sub-topic"></a>

AWS IoT menerbitkan dokumen bayangan respons ke topik ini saat mengembalikan bayangan perangkat:

```
ShadowTopicPrefix/get/accepted
```

Untuk informasi selengkapnya, lihat [Dokumen negara respons](device-shadow-document.md#device-shadow-example-response-json).

### Contoh kebijakan
<a name="get-accepted-policy"></a>

Berikut ini adalah contoh kebijakan yang diperlukan:

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iot:Subscribe"
            ],
            "Resource": [
                "arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/things/thingName/shadow/get/accepted"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "iot:Receive"
            ],
            "Resource": [
                "arn:aws:iot:us-east-1:123456789012:topic/$aws/things/thingName/shadow/get/accepted"
            ]
        }
    ]
}
```

## /dapatkan/ditolak
<a name="get-rejected-pub-sub-topic"></a>

AWS IoT menerbitkan dokumen respons kesalahan ke topik ini jika tidak dapat mengembalikan bayangan perangkat:

```
ShadowTopicPrefix/get/rejected
```

Untuk informasi selengkapnya, lihat [Dokumen respons kesalahan](device-shadow-document.md#device-shadow-example-error-json).

### Contoh kebijakan
<a name="get-rejected-policy"></a>

Berikut ini adalah contoh kebijakan yang diperlukan:

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "iot:Subscribe"
      ],
      "Resource": [
        "arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/things/thingName/shadow/get/rejected"
      ]
    },
    {
      "Effect": "Allow",
      "Action": [
        "iot:Receive"
      ],
      "Resource": [
        "arn:aws:iot:us-east-1:123456789012:topic/$aws/things/thingName/shadow/get/rejected"
      ]
    }
  ]
}
```

## /perbarui
<a name="update-pub-sub-topic"></a>

Publikasikan dokumen status permintaan ke topik ini untuk memperbarui bayangan perangkat:

```
ShadowTopicPrefix/update
```

Badan pesan berisi [dokumen status permintaan sebagian](device-shadow-document.md#device-shadow-example-request-json).

Klien yang mencoba memperbarui status perangkat akan mengirim dokumen status permintaan JSON dengan `desired` properti seperti ini:

```
{
  "state": {
    "desired": {
      "color": "red",
      "power": "on"
    }
  }
}
```

Perangkat yang memperbarui bayangannya akan mengirim dokumen status permintaan JSON dengan `reported` properti, seperti ini:

```
{
  "state": {
    "reported": {
      "color": "red",
      "power": "on"
    }
  }
}
```

AWS IoT merespons dengan menerbitkan salah satu [/perbarui/diterima](#update-accepted-pub-sub-topic) atau[/perbarui/ditolak](#update-rejected-pub-sub-topic).

### Contoh kebijakan
<a name="update-policy"></a>

Berikut ini adalah contoh kebijakan yang diperlukan:

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iot:Publish"
            ],
            "Resource": [
                "arn:aws:iot:us-east-1:123456789012:topic/$aws/things/thingName/shadow/update"
            ]
        }
    ]
}
```

## /perbarui/delta
<a name="update-delta-pub-sub-topic"></a>

AWS IoT menerbitkan dokumen status respons ke topik ini saat menerima perubahan untuk bayangan perangkat, dan dokumen status respons berisi nilai `desired` dan `reported` status yang berbeda:

```
ShadowTopicPrefix/update/delta
```

Buffer pesan berisi file. [/dokumen status respons delta](device-shadow-document.md#device-shadow-example-response-json-delta)

### Detail isi pesan
<a name="update-delta-rules"></a>
+ Pesan yang dipublikasikan hanya `update/delta` mencakup atribut yang diinginkan yang berbeda antara bagian `desired` dan `reported` bagian. Ini berisi semua atribut ini, terlepas dari apakah atribut ini terkandung dalam pesan pembaruan saat ini atau sudah disimpan di AWS IoT. Atribut yang tidak berbeda antara `reported` bagian `desired` dan bagian tidak termasuk.
+ Jika atribut ada di `reported` bagian tetapi tidak memiliki padanan di `desired` bagian, itu tidak termasuk.
+ Jika atribut ada di `desired` bagian tetapi tidak memiliki padanan di `reported` bagian, itu disertakan.
+ Jika atribut dihapus dari `reported` bagian tetapi masih ada di `desired` bagian, itu disertakan.

### Contoh kebijakan
<a name="update-delta-policy"></a>

Berikut ini adalah contoh kebijakan yang diperlukan:

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iot:Subscribe"
            ],
            "Resource": [
                "arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/things/thingName/shadow/update/delta"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "iot:Receive"
            ],
            "Resource": [
                "arn:aws:iot:us-east-1:123456789012:topic/$aws/things/thingName/shadow/update/delta"
            ]
        }
    ]
}
```

## /perbarui/diterima
<a name="update-accepted-pub-sub-topic"></a>

AWS IoT menerbitkan dokumen status respons ke topik ini saat menerima perubahan untuk bayangan perangkat:

```
ShadowTopicPrefix/update/accepted
```

Buffer pesan berisi file. [/dokumen status respons yang diterima](device-shadow-document.md#device-shadow-example-response-json-accepted)

### Contoh kebijakan
<a name="update-accepted-policy"></a>

Berikut ini adalah contoh kebijakan yang diperlukan:

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iot:Subscribe"
            ],
            "Resource": [
                "arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/things/thingName/shadow/update/accepted"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "iot:Receive"
            ],
            "Resource": [
                "arn:aws:iot:us-east-1:123456789012:topic/$aws/things/thingName/shadow/update/accepted"
            ]
        }
    ]
}
```

## /pembaruan/dokumen
<a name="update-documents-pub-sub-topic"></a>

AWS IoT menerbitkan dokumen status ke topik ini setiap kali pembaruan bayangan berhasil dilakukan:

```
ShadowTopicPrefix/update/documents
```

Badan pesan berisi a[/dokumen dokumen status respon](device-shadow-document.md#device-shadow-example-response-json-documents).

### Contoh kebijakan
<a name="update-documents-policy"></a>

Berikut ini adalah contoh kebijakan yang diperlukan:

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iot:Subscribe"
            ],
            "Resource": [
                "arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/things/thingName/shadow/update/documents"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "iot:Receive"
            ],
            "Resource": [
                "arn:aws:iot:us-east-1:123456789012:topic/$aws/things/thingName/shadow/update/documents"
            ]
        }
    ]
}
```

## /perbarui/ditolak
<a name="update-rejected-pub-sub-topic"></a>

AWS IoT menerbitkan dokumen respons kesalahan ke topik ini saat menolak perubahan bayangan perangkat:

```
ShadowTopicPrefix/update/rejected
```

Badan pesan berisi[Dokumen respons kesalahan](device-shadow-document.md#device-shadow-example-error-json).

### Contoh kebijakan
<a name="update-rejected-policy"></a>

Berikut ini adalah contoh kebijakan yang diperlukan:

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iot:Subscribe"
            ],
            "Resource": [
                "arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/things/thingName/shadow/update/rejected"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "iot:Receive"
            ],
            "Resource": [
                "arn:aws:iot:us-east-1:123456789012:topic/$aws/things/thingName/shadow/update/rejected"
            ]
        }
    ]
}
```

## /delete
<a name="delete-pub-sub-topic"></a>

Untuk menghapus bayangan perangkat, publikasikan pesan kosong ke topik hapus:

```
ShadowTopicPrefix/delete
```

Isi pesan diabaikan.

Perhatikan bahwa menghapus bayangan tidak mengatur ulang nomor versinya ke 0.

AWS IoT merespons dengan menerbitkan salah satu [/hapus/diterima](#delete-accepted-pub-sub-topic) atau[/hapus/ditolak](#delete-rejected-pub-sub-topic).

### Contoh kebijakan
<a name="delete-policy"></a>

Berikut ini adalah contoh kebijakan yang diperlukan:

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iot:Publish"
            ],
            "Resource": [
                "arn:aws:iot:us-east-1:123456789012:topic/$aws/things/thingName/shadow/delete"
            ]
        }
    ]
}
```

## /hapus/diterima
<a name="delete-accepted-pub-sub-topic"></a>

AWS IoT menerbitkan pesan ke topik ini saat bayangan perangkat dihapus:

```
ShadowTopicPrefix/delete/accepted
```

### Contoh kebijakan
<a name="delete-accepted-policy"></a>

Berikut ini adalah contoh kebijakan yang diperlukan:

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iot:Subscribe"
            ],
            "Resource": [
                "arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/things/thingName/shadow/delete/accepted"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "iot:Receive"
            ],
            "Resource": [
                "arn:aws:iot:us-east-1:123456789012:topic/$aws/things/thingName/shadow/delete/accepted"
            ]
        }
    ]
}
```

## /hapus/ditolak
<a name="delete-rejected-pub-sub-topic"></a>

AWS IoT menerbitkan dokumen respons kesalahan ke topik ini jika tidak dapat menghapus bayangan perangkat:

```
ShadowTopicPrefix/delete/rejected
```

Badan pesan berisi[Dokumen respons kesalahan](device-shadow-document.md#device-shadow-example-error-json).

### Contoh kebijakan
<a name="delete-rejected-policy"></a>

Berikut ini adalah contoh kebijakan yang diperlukan:

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "iot:Subscribe"
            ],
            "Resource": [
                "arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/things/thingName/shadow/delete/rejected"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "iot:Receive"
            ],
            "Resource": [
                "arn:aws:iot:us-east-1:123456789012:topic/$aws/things/thingName/shadow/delete/rejected"
            ]
        }
    ]
}
```