Skip to content

ネームスペースの作成

EMQXでネームスペースを作成する方法は、明示的作成と自動作成の2種類があります。これらの方法により、ニーズに応じて柔軟にネームスペースの作成方法を選択できます。

  • 明示的作成は、厳密に管理された環境に適しています。
  • 自動作成は、手動操作を減らして動的かつ大規模なデプロイメントに適しています。

明示的なネームスペース作成

ネームスペースは、ダッシュボードまたはREST APIを通じて手動で作成できます。明示的に作成されたネームスペースは、直接管理、編集、削除が可能です。

ユースケース:どのネームスペースが存在するかを明確に管理し、細かい制御が必要な場合に推奨されます。

ダッシュボードでのネームスペース作成

ダッシュボードでネームスペースを素早く作成する手順は以下の通りです。

  1. ダッシュボードの左メニューから 管理 -> ネームスペース に移動します。
  2. 作成 をクリックし、表示される ネームスペース作成 ダイアログでネームスペース名を入力します。他のオプションはデフォルトのままにしてください。最大セッション数やレート制限の設定については、ダッシュボードでのネームスペースの設定と管理 を参照してください。
  3. 作成 をクリックすると、新しく作成されたネームスペースがリストに表示されます。

REST APIでのネームスペース作成

ネームスペース固有の設定を適用する前に、以下のAPIを使用してネームスペースを明示的に作成する必要があります。

POST /mt/ns/<namespace>

<namespace> は作成したいネームスペースIDに置き換えてください。リクエストボディは不要です。

自動ネームスペース作成

クライアントが接続すると、EMQXはクライアントのメタデータから client_attrs.tns 属性を抽出してネームスペースを自動的に作成できます。この方法は、手動作成が非現実的な大規模かつ自動化された環境で一般的に使用されます。

ユースケース:各テナントやクライアントに手動設定なしで個別のネームスペースを割り当てる必要がある、信頼されたクライアント接続環境に最適です。

注意

自動作成されたネームスペースはダッシュボードで編集できません。設定やクライアントメタデータから自動的に生成されるのみです。

注意

自動ネームスペース作成は、以下の設定が有効な場合にのみ動作します。

multi_tenancy.allow_only_managed_namespaces = false