SDKを使用してメッセージを送受信する前に、ApsaraMQ for RocketMQインスタンス、トピック、コンシューマーグループなどのリソースをApsaraMQ for RocketMQに作成する必要があります。 インスタンスのエンドポイントも取得する必要があります。 SDKを使用するときは、SDKコードでリソースに関する情報を指定する必要があります。
始める前に
背景情報
ApsaraMQ for RocketMQでは、ApsaraMQ for RocketMQコンソールまたはAPI操作を呼び出してリソースを作成できます。 このトピックでは、ApsaraMQ for RocketMQコンソールでリソースを作成する方法について説明します。
API操作を呼び出してリソースを作成する場合は、次のトピックを参照してください。
制限事項
リージョン
ApsaraMQ for RocketMQインスタンスが、このトピックの「開始前」セクションで作成したVPCおよびvSwitchと同じリージョンにあることを確認します。
命名規則
ApsaraMQ For RocketMQインスタンス、トピック、および消費者グループの命名規則については、「クォータと制限」をご参照ください。
トピックのメッセージタイプ
トピックのメッセージタイプは、トピックが送受信するメッセージのタイプと一致している必要があります。 たとえば、通常のメッセージの送受信に使用するトピックを作成した場合、通常のメッセージの送受信にのみ使用できます。 詳細については、「使用状況のメモ」をご参照ください。
インスタンスの作成
ApsaraMQ for RocketMQコンソールにログインします。 左側のナビゲーションウィンドウで、インスタンス数 をクリックします。
上部のナビゲーションバーで、中国 (杭州) などのリージョンを選択します。
インスタンス数 ページで、インスタンスの作成 をクリックします。 Message Queue for Apache RocketMQ インスタンスの作成 パネルで、インスタンスのバージョン パラメーターを 5.0 シリーズ に設定し、[課金方法] パラメーターを設定します。 次に、OK をクリックします。
ApsaraMQ for RocketMQは、次の課金方法をサポートしています。
サブスクリプション: インスタンスに対して選択したコンピューティング仕様とサブスクリプション期間 (月単位) に基づいて、前払いが必要です。
従量課金: 料金は、インスタンスに対して選択したコンピューティング仕様とインスタンスの実際の使用期間 (時間) に基づいて後払いされます。
サーバーレス: メッセージを受信および配信するために開始されたAPI呼び出しの総数に基づいて課金されます。
説明Serverless ApsaraMQ for RocketMQ インスタンスは、中国 (杭州)、中国 (上海)、中国 (北京)、中国 (張家口)、中国 (深セン)、中国 (成都)、シンガポール、ドイツ (フランクフルト) 、および米国 (バージニア) の各リージョンでのみ使用できます。
さまざまな課金方法の課金可能な項目とシナリオについては、「概要」をご参照ください。
購入ページで、インスタンスの仕様を選択し、[今すぐ購入] をクリックします。 次に、画面の指示に従って支払いを完了します。
次の表は、購入ページでパラメーターを設定する方法の例を示しています。 購入ページに表示される仕様については、「インスタンスの選択」をご参照ください。
サーバーレスインスタンスに設定されたパラメーター
パラメーター
例
プライマリエディション
Standard Edition
課金方法
課金方法です。 オンデマンド容量は自動的に指定されます。
メッセージストレージ容量
メッセージの格納に使用されるスペース。 ストレージ容量を指定する必要はありません。 実際の使用量に基づいて、ストレージスペースが課金されます。
VPC ID
vpc-bp1cg09dua6sgh0******
このパラメーターの値は、このトピックの「開始前」セクションで作成したVPCのIDです。
重要ApsaraMQ for RocketMQインスタンスを作成した後、インスタンスが関連付けられているVPCを変更することはできません。 ApsaraMQ for RocketMQインスタンスがデプロイされているVPCを変更する場合は、インスタンスをリリースして新しいインスタンスを購入する必要があります。
VSwitch ID
vsw-bp1vqb0p9nz3irz******
このパラメーターの値は、このトピックの「開始前」セクションで作成したvSwitchのIDです。
サーバーレスApsaraMQ for RocketMQインスタンスには2つのvSwitch IDを選択する必要があります。
重要ApsaraMQ for RocketMQインスタンスを作成した後、インスタンスが関連付けられているvSwitchを変更することはできません。 ApsaraMQ for RocketMQインスタンスが関連付けられているvSwitchを変更する場合は、インスタンスをリリースして新しいインスタンスを購入する必要があります。
インターネットアクセス
Disable
説明この例では、クライアントはVPC内のApsaraMQ for RocketMQブローカーに接続されています。 デフォルトでは、インターネットアクセスは無効です。 インターネット経由でApsaraMQ for RocketMQにアクセスする場合は、このパラメーターを有効に設定します。
インターネットメーター法
内部ネットワークトラフィックの課金方法。 Pay-by-Data-Transferは自動的に指定されます。
VPCでのみ、サーバーレスApsaraMQ for RocketMQインスタンスにアクセスできます。
リソースグループ
serverless ApsaraMQ for RocketMQインスタンスが属するリソースグループ。 この例では、デフォルトのリソースグループが選択されています。
[セキュリティグループ]
このトピックの「開始前」セクションで作成したセキュリティグループ。
サブスクリプションまたは従量課金インスタンス用に設定されたパラメータ
パラメーター
例
プライマリエディション
Standard Edition
サブカテゴリ版
高可用性クラスターエディション (本番環境に推奨)
コンピューティング仕様
rmq.s2.2xlarge
VPC ID
vpc-bp1cg09dua6sgh0******
このパラメーターの値は、このトピックの「開始前」セクションで作成したVPCのIDです。
重要ApsaraMQ for RocketMQインスタンスを作成した後、インスタンスが関連付けられているVPCを変更することはできません。 ApsaraMQ for RocketMQインスタンスがデプロイされているVPCを変更する場合は、インスタンスをリリースして新しいインスタンスを購入する必要があります。
VSwitch ID
vsw-bp1vqb0p9nz3irz******
このパラメーターの値は、このトピックの「開始前」セクションで作成したvSwitchのIDです。
重要ApsaraMQ for RocketMQインスタンスを作成した後、インスタンスが関連付けられているvSwitchを変更することはできません。 ApsaraMQ for RocketMQインスタンスが関連付けられているvSwitchを変更する場合は、インスタンスをリリースして新しいインスタンスを購入する必要があります。
インターネットアクセス
Disable
説明この例では、クライアントはVPC内のApsaraMQ for RocketMQブローカーに接続されています。 デフォルトでは、インターネットアクセスは無効です。 インターネット経由でApsaraMQ for RocketMQにアクセスする場合は、このパラメーターを有効に設定します。
リソースグループ
ApsaraMQ for RocketMQインスタンスが属するリソースグループ。 この例では、デフォルトのリソースグループが選択されています。
ディスク暗号化
Disable
説明ディスク暗号化機能は、ApsaraMQ for RocketMQ 5.x Enterprise Platinum Editionインスタンスでのみサポートされています。
ディスク暗号化キー
key-hzz66c8207****
説明インスタンスがデプロイされているリージョンでディスクの暗号化に使用されるキーのID。 このパラメーターは、[ディスク暗号化] パラメーターを [有効] に設定した場合にのみ必要です。
インスタンスのエンドポイントの取得
インスタンス数 ページで、管理するインスタンスの名前をクリックします。
インスタンスの詳細 ページの [TCPエンドポイント] セクションで、インスタンスのエンドポイントを表示します。
VPCエンドポイント: VPC内のApsaraMQ for RocketMQインスタンスへのアクセスに使用されるエンドポイント。 これは、ApsaraMQ for RocketMQによって提供されるデフォルトのエンドポイントです。
パブリックエンドポイント: インターネット経由でApsaraMQ for RocketMQにアクセスするために使用されるエンドポイント。 インターネットアクセスを有効にした場合にのみ、パブリックエンドポイントが表示されます。
インスタンスのユーザー名とパスワードの取得
この例では、インテリジェント認証を使用して、ApsaraMQ for RocketMQインスタンスのユーザー名とパスワードを取得する方法を説明します。
アクセス制御リスト (ACL) ベースのアクセス認証を使用する場合は、ACLユーザーを作成し、ACLユーザーに必要な権限を付与し、ACLユーザーのユーザー名とパスワードを取得する必要があります。 詳細は、「ユーザー認証」をご参照ください。
クライアントをApsaraMQ for RocketMQブローカーに接続する場合、インスタンスのユーザー名とパスワードを指定するかどうかは、アクセス方法によって決まります。
インターネット経由でApsaraMQ for RocketMQブローカーにアクセスする場合は、インスタンスのユーザー名とパスワードを指定する必要があります。
VPCでApsaraMQ for RocketMQブローカーにアクセスする場合、インスタンスがサーバーレスインスタンスであり、VPCでの認証不要機能が無効になっている場合にのみ、ユーザー名とパスワードを指定する必要があります。 それ以外の場合は、システムはクライアントが使用するVPCエンドポイントに基づいてクライアントを自動的に識別します。
インスタンス数 ページで、管理するインスタンスの名前をクリックします。
表示されるページの左側のナビゲーションウィンドウで、アクセス制御 をクリックします。
スマート認証 タブをクリックして、インスタンスのユーザー名とパスワードを表示します。
Topic の作成
インスタンス数 ページで、管理するインスタンスの名前をクリックします。
左側のナビゲーションウィンドウで、トピック をクリックします。 表示される トピック ページで、トピックの作成 をクリックします。
トピックの作成 パネルで、トピック名と説明を入力し、[メッセージタイプ] パラメーターを [通常のメッセージ] に設定し、OK をクリックします。
コンシューマーグループの作成
インスタンス数 ページで、管理するインスタンスの名前をクリックします。
左側のナビゲーションウィンドウで、グループ をクリックします。 表示される グループ ページで、グループの作成 をクリックします。
グループの作成 パネルで、Group ID パラメーターを設定し、[OK] をクリックします。 パネルの他のパラメータにはデフォルト値を使用できます。