本文へジャンプします。

ニフクラ APIリファレンス

クラウド トップ>API>MQTT>DescribeMQTTACLs

DescribeMQTTACLs

処理概要

作成済みのアクセス権限一覧を取得します。

リクエストパラメーター

要素名 説明 必須 最大値 デフォルト値 備考
MQTTInstanceIdentifier アクセス権限を取得するMQTTサーバーのサーバー名を指定します。
英数字、"_"、"-"、"."が使用可能です。
文字列 32  
Username アクセス権限を取得するユーザーのアカウント名を指定します。指定がない場合はすべての権限を取得します。
英数字、"_"、"-"、"."が使用可能です。
文字列 32  

レスポンス

要素名 説明 備考
MQTTInstanceIdentifier MQTTサーバー名 文字列  
Username アカウント名 文字列  
Topic トピック 文字列  
Acc 権限レベル
0:アクセス不可 1:Subscribeのみ可 2:Publishのみ可 3:Subscribe/Publishともに可
数値  

サンプル

リクエストサンプル
curl https://mqtt.api.cloud.nifty.com/mqtt ¥
  -H "x-amz-date:20151103T150000Z" ¥
  -H "authorization: AWS4-HMAC-SHA256 Credential=<YOU APP KEY>/20151103/jp-east-1/mqtt/aws4_request, SignedHeaders=host;x-amz-date, Signature=XXX..." ¥
  -H "x_amz_target:2016-01-25N2016-01-25.DescribeMQTTACLs" ¥
  -H "accept-encoding':gzip, deflate" ¥
  -H "user-agent:<YOUR USER AGENT>" ¥
  -H "content-type:application/x-www-form-urlencoded" ¥
  -H "accept:application/xhtml+xml" ¥
  -H "host: mqtt.api.cloud.nifty.com:443" ¥
  -d "MQTTInstanceIdentifier=samplemqtt" ¥
  -d "Username=sampleuser"
レスポンスサンプル
<?xml version="1.0"?>
<DescribeMQTTACLsResponse
  xmlns="http://mqtt.api.cloud.nifty.com/doc/2015-03-19/"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-ACL"
  xsi:type="DescribeMQTTACLsResponse">
  <DescribeMQTTACLsResult>
    <MQTTACLs>
      <MQTTACL>
        <MQTTInstanceIdentifier>samplemqtt</MQTTInstanceIdentifier>
        <Username>sampleuser</Username>
        <Topic>/myroom/messages</Topic>
        <Acc>3</Acc>
      </MQTTACL>
    </MQTTACLs>
  </DescribeMQTTACLsResult>
</DescribeMQTTACLsResponse>

推奨画面サイズ 1024×768 以上