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

# Publikasikan ulang
<a name="republish-rule-action"></a>

Tindakan republish (`republish`) menerbitkan kembali pesan MQTT ke topik MQTT lainnya.

## Persyaratan
<a name="republish-rule-action-requirements"></a>

Tindakan aturan ini memiliki persyaratan sebagai berikut:
+ Peran IAM yang AWS IoT dapat diasumsikan untuk melakukan `iot:Publish` operasi. Untuk informasi selengkapnya, lihat [Pemberian AWS IoT aturan akses yang dibutuhkan](iot-create-role.md).

  Di AWS IoT konsol, Anda dapat memilih atau membuat peran untuk memungkinkan AWS IoT untuk melakukan tindakan aturan ini.

## Parameter
<a name="republish-rule-action-parameters"></a>

Saat Anda membuat AWS IoT aturan dengan tindakan ini, Anda harus menentukan informasi berikut:

`headers`  
Informasi header MQTT Versi 5.0.  
Untuk informasi selengkapnya, lihat [RepublishAction](https://docs.aws.amazon.com//iot/latest/apireference/API_RepublishAction.html)dan [MqttHeaders](https://docs.aws.amazon.com//iot/latest/apireference/API_MqttHeaders.html)di *Referensi AWS API*.

`topic`  
Topik MQTT untuk menerbitkan ulang pesan.  
Untuk menerbitkan ulang ke topik yang dicadangkan, yang dimulai dengan`$`, gunakan `$$` sebagai gantinya. Misalnya, untuk menerbitkan ulang ke topik bayangan perangkat`$aws/things/MyThing/shadow/update`, tentukan topik sebagai`$$aws/things/MyThing/shadow/update`.  
Penerbitan ulang ke [topik pekerjaan yang dipesan](reserved-topics.md#reserved-topics-job) tidak didukung.   
AWS IoT Device Defender topik cadangan tidak mendukung publikasi HTTP.
Mendukung [template substitusi](iot-substitution-templates.md): Ya

`qos`  
(Opsional) Tingkat Kualitas Layanan (QoS) yang akan digunakan saat menerbitkan ulang pesan. Nilai-nilai yang valid: `0`, `1`. Nilai default-nya adalah `0`. Untuk informasi selengkapnya tentang QoS MQTT, lihat. [MQTT](mqtt.md)  
Mendukung [template substitusi](iot-substitution-templates.md): Tidak

`roleArn`  
Peran IAM yang memungkinkan AWS IoT untuk mempublikasikan ke topik MQTT. Untuk informasi selengkapnya, lihat [Persyaratan](#republish-rule-action-requirements).  
Mendukung [template substitusi](iot-substitution-templates.md): Tidak

## Contoh
<a name="republish-rule-action-examples"></a>

Contoh JSON berikut mendefinisikan tindakan republish dalam aturan. AWS IoT 

```
{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "republish": {
                    "topic": "another/topic",
                    "qos": 1,
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_republish"
                }
            }
        ]
    }
}
```

Contoh JSON berikut mendefinisikan tindakan republish dengan template substitusi dalam aturan. AWS IoT 

```
{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'",
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "republish": {
                    "topic": "${topic()}/republish",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_republish"
                }
            }
        ]
    }
}
```

Contoh JSON berikut mendefinisikan tindakan republish dengan `headers` dalam aturan. AWS IoT 

```
{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'",
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "republish": {
                    "topic": "${topic()}/republish",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_republish",
                    "headers": {
                        "payloadFormatIndicator": "UTF8_DATA",
                        "contentType": "rule/contentType",
                        "correlationData": "cnVsZSBjb3JyZWxhdGlvbiBkYXRh",
                        "userProperties": [
                            {
                                "key": "ruleKey1",
                                "value": "ruleValue1"
                            },
                            {
                                "key": "ruleKey2",
                                "value": "ruleValue2"
                            }
                        ]
                    }
                }
            }
        ]
    }
}
```

**catatan**  
IP sumber asli tidak akan diteruskan melalui [tindakan Republish](#republish-rule-action).