全部产品
Search

搜索本产品

    ApsaraMQ for MQTT：Kebijakan RAM untuk ApsaraMQ for MQTT

    文档中心

    ApsaraMQ for MQTT：Kebijakan RAM untuk ApsaraMQ for MQTT

    更新时间：Mar 12, 2026

    Resource Access Management (RAM) memungkinkan Anda mengontrol akses ke resource ApsaraMQ for MQTT tanpa perlu membagikan pasangan AccessKey akun Alibaba Cloud kepada pengguna lain. Pasangan AccessKey terdiri dari ID AccessKey dan Rahasia AccessKey. Anda dapat membuat pengguna RAM dan memberikan masing-masing pengguna hanya izin yang diperlukan.

    Cara kerja kontrol akses

    ApsaraMQ for MQTT mengotorisasi akses melalui kebijakan RAM. Setiap kebijakan menentukan aksi yang dapat dilakukan oleh pengguna RAM pada resource tertentu. Terdapat empat jenis resource:

    Jenis resourceDeskripsiFormat penamaanContoh
    InstanceInstans broker MQTTacs:mq:*:*:instance/{mqttInstanceId}acs:mq:*:*:instance/post-cn-09k1noy****
    TopicTopik pesan dalam suatu instansacs:mq:*:*:topic/{mqttInstanceId}/{topic}acs:mq:*:*:topic/post-cn-09k1noy**/Topic_**
    GroupGrup klien dalam suatu instansacs:mq:*:*:groupId/{mqttInstanceId}/{gid}acs:mq:*:*:groupId/post-cn-09k1noy**/GID_**
    RuleAturan routing data dalam suatu instansacs:mq:*:*:rule/{mqttInstanceId}/{ruleId}acs:mq:*:*:rule/post-cn-09k1noy**/111**

    Terdapat dua jenis kebijakan:

    • Kebijakan sistem — Ditetapkan sebelumnya oleh Alibaba Cloud, siap digunakan, tetapi tidak dapat diedit.

    • Kebijakan kustom — Didefinisikan dan dikelola oleh Anda. Anda mengelola versi kebijakan tersebut dan dapat memberikan kontrol akses detail halus berbasis resource.

    Untuk informasi lebih lanjut mengenai sintaksis kebijakan, lihat Struktur dan sintaksis kebijakan. Untuk format elemen resource, lihat Resource.

    Prasyarat akses instance

    Sebelum memberikan izin pada topik, grup, atau aturan apa pun, Anda harus terlebih dahulu memberikan aksi mq:MqttInstanceAccess pada instance induknya. Tanpa akses tingkat instance, pengguna RAM tidak dapat mengakses resource di dalam instance tersebut.

    Prasyarat ini berlaku untuk semua kategori izin: operasi konsol, panggilan API, serta publikasi/langganan klien.

    Kebijakan sistem

    ApsaraMQ for MQTT menyediakan empat kebijakan sistem bawaan.

    KebijakanDeskripsi
    AliyunMQFullAccessAkses manajemen penuh ke semua operasi ApsaraMQ for MQTT di konsol, setara dengan akun Alibaba Cloud.
    AliyunMQPubOnlyAccessAkses hanya untuk publikasi. Memungkinkan publikasi pesan melalui SDK ke semua resource di bawah akun Alibaba Cloud.
    AliyunMQSubOnlyAccessAkses hanya untuk berlangganan. Memungkinkan berlangganan pesan melalui SDK dari semua resource di bawah akun Alibaba Cloud.
    AliyunMQReadOnlyAccessAkses hanya-baca. Memungkinkan melihat informasi resource di konsol atau melalui panggilan API.
    Penting

    ApsaraMQ for MQTT tidak memiliki kebijakan sistem independen tersendiri. Kebijakan ini dibagikan dengan ApsaraMQ for RocketMQ — menautkan salah satu kebijakan ini ke pengguna RAM akan memberikan akses ke kedua layanan tersebut.

    AliyunMQFullAccess dan AliyunMQReadOnlyAccess tidak mencakup izin untuk melihat daftar instance di konsol. Berikan mq:MqttInstanceAccess secara terpisah untuk mengaktifkan akses ke daftar instance. Lihat Aksi manajemen instance.

    Aksi kebijakan kustom

    Kebijakan kustom memungkinkan Anda menentukan secara tepat aksi yang dapat dilakukan pengguna RAM pada resource tertentu. Bagian-bagian berikut mencantumkan semua aksi yang tersedia, dikelompokkan berdasarkan cakupannya.

    Untuk contoh kebijakan kustom, lihat Contoh kebijakan izin.

    Aksi publikasi dan langganan klien

    Aksi-aksi ini mengontrol publikasi dan langganan pesan melalui SDK ApsaraMQ for MQTT.

    Format penamaan resource:

    • Topic: acs:mq:*:*:topic/{mqttInstanceId}/{topic}

    • Group ID: acs:mq:*:*:groupId/{mqttInstanceId}/{gid}

    AksiDeskripsi
    mq:PUBMenerbitkan pesan ke topik
    mq:SUBBerlangganan pesan dari topik
    Izin publikasi dan langganan klien tidak dapat diberikan lintas akun Alibaba Cloud.

    Aksi manajemen instance

    Format penamaan resource: acs:mq:*:*:instance/{mqttInstanceId}

    AksiDeskripsi
    mq:MqttInstanceAccessMenanyakan informasi dasar instance. Diperlukan sebelum memberikan izin topik, grup, atau aturan apa pun.
    mq:ListMqttInstanceMenampilkan daftar semua instance
    mq:UpdateMqttInstanceMemodifikasi informasi instance
    mq:DeleteMqttInstanceMenghapus instance
    mq:UpdateMqttInstanceWarnMemperbarui pengaturan peringatan untuk instance
    mq:MqttMetaDataMengakses halaman Ikhtisar dan beranda di konsol ApsaraMQ for MQTT
    Setelah memberikan mq:MqttMetaData, berikan juga mq:ListMqttInstance agar pengguna RAM dapat melihat daftar instance di konsol.

    Aksi manajemen topik

    Format penamaan resource: acs:mq:*:*:topic/{mqttInstanceId}/{topic}

    AksiDeskripsi
    mq:CreateMqttTopicMembuat topik
    mq:DeleteMqttTopicMenghapus topik
    mq:ListMqttTopicMenampilkan daftar topik
    mq:UpdateMqttTopicMemperbarui deskripsi topik
    mq:QueryMqttClientByTopicMenanyakan klien mana yang berlangganan ke topik
    mq:QueryMqttMsgTransTrendMenanyakan statistik pengiriman pesan untuk topik
    mq:SendMqttMessageByConsoleMengirim pesan uji dari konsol

    Aksi manajemen grup

    Format penamaan resource: acs:mq:*:*:groupId/{mqttInstanceId}/{gid}

    AksiDeskripsi
    mq:CreateMqttGroupIdMembuat grup
    mq:DeleteMqttGroupIdMenghapus grup
    mq:ListMqttGroupIdMenampilkan daftar grup
    mq:QueryMqttClientByClientIdMenanyakan informasi klien berdasarkan ID klien
    mq:QueryMqttClientByGroupIdMenanyakan informasi klien berdasarkan ID grup
    mq:QueryMqttHistoryOnlineMenanyakan riwayat koneksi online berdasarkan ID grup
    mq:QueryMqttTraceDeviceMelacak klien tertentu
    mq:QueryMqttDeviceTraceMenanyakan detail klien tertentu

    Aksi manajemen aturan

    Format penamaan resource: acs:mq:*:*:rule/{mqttInstanceId}/{ruleId}

    Saat memberikan izin aturan, pastikan instance, topik, dan grup terkait semuanya berada dalam akun Alibaba Cloud yang sama.

    AksiDeskripsi
    mq:CreateMqttInboundRuleMembuat aturan inbound data
    mq:DeleteMqttInboundRuleMenghapus aturan inbound data
    mq:ListMqttInboundRuleMenampilkan daftar aturan inbound data
    mq:UpdateMqttInboundRuleMemperbarui aturan inbound data
    mq:CreateMqttOutboundRuleMembuat aturan outbound data
    mq:DeleteMqttOutboundRuleMenghapus aturan outbound data
    mq:ListMqttOutboundRuleMenampilkan daftar aturan outbound data
    mq:UpdateMqttOutboundRuleMemperbarui aturan outbound data
    mq:CreateClientStatusNotifyRuleMembuat aturan notifikasi status klien
    mq:DeleteClientStatusNotifyRuleMenghapus aturan notifikasi status klien
    mq:ListClientStatusNotifyRuleMenampilkan daftar aturan notifikasi status klien
    mq:UpdateClientStatusNotifyRuleMemperbarui aturan notifikasi status klien

    Izin operasi API

    Setiap operasi API memerlukan mq:MqttInstanceAccess ditambah satu atau beberapa aksi tambahan. Untuk API terkait aturan, pastikan instance, topik, dan grup terkait semuanya berada dalam akun Alibaba Cloud yang sama.

    Manajemen token

    APIFormat penamaan resourceAksi yang diperlukan
    ApplyTokenInstance: acs:mq:*:*:instance/{mqttInstanceId}, Topic: acs:mq:*:*:topic/{mqttInstanceId}/{topic}mq:MqttInstanceAccess, mq:ApplyToken
    RevokeTokenacs:mq:*:*:*mq:MqttInstanceAccess, mq:RevokeToken
    QueryTokenacs:mq:*:*:*mq:MqttInstanceAccess, mq:QueryToken

    Operasi pesan

    APIAksi yang diperlukan
    SendMessagemq:MqttInstanceAccess, mq:SendMessage

    Operasi grup

    Semua operasi API grup menggunakan format penamaan resource berikut:

    • Instance: acs:mq:*:*:instance/{mqttInstanceId}

    • Grup: acs:mq:*:*:groupId/{mqttInstanceId}/{gid}

    APIAksi yang diperlukan
    CreateGroupIdmq:MqttInstanceAccess, mq:CreateMqttGroupId
    DeleteGroupIdmq:MqttInstanceAccess, mq:DeleteMqttGroupId
    ListGroupIdmq:MqttInstanceAccess, mq:ListMqttGroupId
    QuerySessionByClientIdmq:MqttInstanceAccess, mq:QuerySessionByClientId
    BatchQuerySessionByClientIdsmq:MqttInstanceAccess, mq:BatchQuerySessionByClientIds

    Operasi kredensial perangkat

    APIAksi yang diperlukan
    RegisterDeviceCredentialmq:MqttInstanceAccess, mq:RegisterDeviceCredential
    GetDeviceCredentialmq:MqttInstanceAccess, mq:GetDeviceCredential
    ListDeviceCredentialClientIdmq:MqttInstanceAccess, mq:ListDeviceCredentialClientId
    UnRegisterDeviceCredentialmq:MqttInstanceAccess, mq:UnRegisterDeviceCredential
    RefreshDeviceCredentialmq:MqttInstanceAccess, mq:RefreshDeviceCredential

    Operasi pelacakan pesan

    APIFormat penamaan resourceAksi yang diperlukan
    QueryMqttTraceDevice--mq:MqttInstanceAccess, mq:QueryMqttDeviceTrace
    QueryMqttTraceMessageOfClient--mq:MqttInstanceAccess, mq:QueryMqttDeviceTrace
    QueryMqttTraceMessagePublishInstance: acs:mq:*:*:instance/{mqttInstanceId}mq:MqttInstanceAccess, mq:QueryMqttPubTrace
    QueryMqttTraceMessageSubscribe--mq:MqttInstanceAccess, mq:QueryMqttSubTrace

    Operasi autentikasi kustom

    APIAksi yang diperlukan
    AddCustomAuthIdentitymq:MqttInstanceAccess, mq:AddCustomAuthIdentity
    QueryCustomAuthIdentitymq:MqttInstanceAccess, mq:QueryCustomAuthIdentity
    UpdateCustomAuthIdentitymq:MqttInstanceAccess, mq:UpdateCustomAuthIdentity
    DeleteCustomAuthIdentitymq:MqttInstanceAccess, mq:DeleteCustomAuthIdentity
    AddCustomAuthPermissionmq:MqttInstanceAccess, mq:AddCustomAuthPermission
    QueryCustomAuthPermissionmq:MqttInstanceAccess, mq:QueryCustomAuthPermission
    UpdateCustomAuthPermissionmq:MqttInstanceAccess, mq:UpdateCustomAuthPermission
    DeleteCustomAuthPermissionmq:MqttInstanceAccess, mq:DeleteCustomAuthPermission
    AddCustomAuthConnectBlackmq:MqttInstanceAccess, mq:DeleteCustomAuthConnectBlack
    QueryCustomAuthConnectBlackmq:MqttInstanceAccess, mq:QueryCustomAuthConnectBlack
    DeleteCustomAuthConnectBlackmq:MqttInstanceAccess, mq:AddCustomAuthConnectBlack

    Operasi topik

    Semua operasi API topik menggunakan format penamaan resource berikut:

    • Instance: acs:mq:*:*:instance/{mqttInstanceId}

    • Topic: acs:mq:*:*:topic/{mqttInstanceId}/{topic}

    APIAksi yang diperlukan
    CreateTopicmq:MqttInstanceAccess, mq:CreateMqttTopic
    ListTopicsmq:MqttInstanceAccess, mq:SUB, mq:ListMqttTopic
    DeleteTopicmq:MqttInstanceAccess, mq:PUB, mq:DeleteMqttTopic
    UpdateTopicmq:MqttInstanceAccess, mq:UpdateMqttTopic

    Operasi aturan

    Semua operasi API aturan menggunakan format penamaan resource berikut:

    • Instance: acs:mq:*:*:instance/{mqttInstanceId}

    • Aturan: acs:mq:*:*:rule/{mqttInstanceId}/{ruleId}

    APIAksi yang diperlukan
    CreateMqttInboundRulemq:MqttInstanceAccess, mq:CreateMqttInboundRule
    ListMqttInboundRuleInPagesmq:MqttInstanceAccess, mq:ListMqttInboundRule
    UpdateMqttInboundRulemq:MqttInstanceAccess, mq:UpdateMqttInboundRule
    DeleteMqttInboundRulemq:MqttInstanceAccess, mq:DeleteMqttInboundRule
    CreateMqttOutboundRulemq:MqttInstanceAccess, mq:CreateMqttOutboundRule
    ListMqttOutboundRuleInPagesmq:MqttInstanceAccess, mq:ListMqttOutboundRule
    UpdateMqttOutboundRulemq:MqttInstanceAccess, mq:UpdateMqttOutboundRule
    DeleteMqttOutboundRulemq:MqttInstanceAccess, mq:DeleteMqttOutboundRule
    CreateClientStatusNotifyRulemq:MqttInstanceAccess, mq:CreateClientStatusNotifyRule
    ListClientStatusNotifyRuleInPagesmq:MqttInstanceAccess, mq:ListClientStatusNotifyRule
    UpdateClientStatusNotifyRulemq:MqttInstanceAccess, mq:UpdateClientStatusNotifyRule
    DeleteClientStatusNotifyRulemq:MqttInstanceAccess, mq:DeleteClientStatusNotifyRule

    Operasi pemulihan bencana

    APIAksi yang diperlukan
    DisasterDowngrademq:MqttInstanceAccess, mq:DisasterDowngrade
    DisasterRecoverymq:MqttInstanceAccess, mq:DisasterRecovery

    Untuk referensi API lengkap, lihat Daftar operasi berdasarkan fungsi.

    Lihat juga