MQTT API エラーコードリファレンスと障害診断 - ApsaraMQ for MQTT

ApsaraMQ for MQTT の API 呼び出しが成功した場合、応答には HTTP ステータスコード 200 が返されます。呼び出しが失敗した場合は、HTTP エラーステータスコード、エラーコード、および説明文を含む応答が返されます。

以下の例は、エラー応答のフォーマットを示しています。

{
  "RequestId": "07AB2E7F-1EF8-4D08-A423-D58E3A26****",
  "HostId": "onsmqtt.cn-hangzhou.aliyuncs.com",
  "Code": "InstancePermissionCheckFailed",
  "Message": "インスタンスの権限を検証中にエラーが発生しました。インスタンスを作成したアカウントおよびその権限設定を確認してください。"
}

下記の表を参照して、リクエスト失敗の原因と解決方法を特定してください。エラーコードはリソースタイプ別に分類されています。

「InternalError」や「InstancePermissionCheckFailed」などの一部のエラーコードは、複数のリソースタイプで共通して発生します。文脈に関わらず、原因および解決方法は同一です。

トークン関連エラー

HTTP ステータスコード	エラーコード	エラーメッセージ	原因	解決方法
404	ApiNotSupport	指定された API はサポートされていません。	該当の API オペレーションはサポートされていません。	API オペレーション名を確認し、対応する API リファレンスでサポートされているオペレーションを確認してください。
400	ApplyTokenOverFlow	トークンの申請回数が上限を超えています。しばらくしてから再度お試しください。	トークン申請リクエストが速度制限されています。	トークン申請頻度を下げ、短時間待ってから再試行してください。
400	CheckAccountInfoFailed	STS トークンによるアカウント情報のチェック中にエラーが発生しました。	Security Token Service (STS) トークン内のアカウント情報が解析できませんでした。	STS トークンが有効であることを確認し、リクエストを再試行してください。
400	InstancePermissionCheckFailed	インスタンスの権限を検証中にエラーが発生しました。インスタンスを作成したアカウントおよびその権限設定を確認してください。	現在のアカウントには、この ApsaraMQ for MQTT インスタンスへのアクセス権限がありません。	インスタンスの所有者を確認し、権限付与ポリシーで必要な権限が付与されているかを確認してください。
500	InternalError	リクエストの処理中にエラーが発生しました。しばらくしてから再度お試しください。	内部サービスエラーが発生しました。	リクエストを再試行してください。エラーが継続する場合は、Alibaba Cloud サポートへお問い合わせください。
400	ParameterCheckFailed	パラメーターの検証中にエラーが発生しました。パラメーターが不足しているか、無効な値が含まれている可能性があります。	1 つ以上の必須パラメーターが不足しているか、無効な値が含まれています。	API リファレンスを参照し、必須パラメーターおよび有効値の範囲を確認したうえで、リクエスト内容を修正してください。
400	PermissionCheckFailed	リソース権限の検証中にエラーが発生しました。インスタンス、Topic、および GroupId を作成したアカウントおよび各リソースの権限設定を確認してください。	現在のアカウントには、インスタンス、Topic、またはグループに対する必要な権限がありません。	リクエストに関与する各リソースの所有者および権限付与ポリシーを確認してください。
500	SystemOverFlow	リクエストの処理中にエラーが発生しました。再度お試しください。	システムによりリクエストが速度制限されています。	リクエスト頻度を下げ、短時間待ってから再試行してください。
400	InvalidParameter.%s	パラメーターの検証中にエラーが発生しました。パラメーターが不足しているか、無効な値が含まれている可能性があります。	`%s` で示されるパラメーターが不足しているか、無効です。	エラーコードに記載された具体的なパラメーター名を確認し、有効な値を指定してください。

グループ関連エラー

HTTP ステータスコード	エラーコード	エラーメッセージ	原因	解決方法
500	CreateGroupIdError	GroupId の作成に失敗しました。しばらくしてから再度お試しください。	グループの作成ができませんでした。	リクエストを再試行してください。エラーが継続する場合は、Alibaba Cloud サポートへお問い合わせください。
400	GroupIdAlreadyExsited	指定された GroupId は既に存在します。	この ID のグループは既に存在します。	別の GroupId を使用するか、要件を満たす場合は既存のグループをご利用ください。
400	GroupIdAlreadyUsedByOtherUsers	現在の GroupId は他のユーザーによって使用されています。別の GroupId に変更してください。	この GroupId は他のユーザーによって使用されています。	別の GroupId を選択してください。
500	InternalError	リクエストの処理中にエラーが発生しました。しばらくしてから再度お試しください。	内部サービスエラーが発生しました。	リクエストを再試行してください。エラーが継続する場合は、Alibaba Cloud サポートへお問い合わせください。
400	ParameterFieldCheckFailed	パラメーターの検証に失敗しました。パラメーターが不足しているか、無効な値が含まれている可能性があります。	1 つ以上の必須パラメーターが不足しているか、無効な値が含まれています。	有効なパラメーター名および値については API リファレンスを確認し、リクエスト内容を修正してください。
400	InstancePermissionCheckFailed	インスタンスの権限を検証中にエラーが発生しました。インスタンスを作成したアカウントおよびその権限設定を確認してください。	現在のアカウントには、この ApsaraMQ for MQTT インスタンスへのアクセス権限がありません。	インスタンスの所有者を確認し、権限付与ポリシーで必要な権限が付与されているかを確認してください。
400	InstanceNotFound	インスタンスが見つかりませんでした。instanceId が無効である可能性があります。	指定された `instanceId` に一致するインスタンスが存在しません。	インスタンスが存在すること、およびリクエスト内の `instanceId` の値が正しいことを確認してください。
400	PermissionCheckFailed	リソース権限の検証中にエラーが発生しました。インスタンス、Topic、および GroupId を作成したアカウントおよび各リソースの権限設定を確認してください。	現在のアカウントには、インスタンス、Topic、またはグループに対する必要な権限がありません。	リクエストに関与する各リソースの所有者および権限付与ポリシーを確認してください。

Topic 関連エラー

HTTP ステータスコード	エラーコード	エラーメッセージ	原因	解決方法
400	ParameterFieldCheckFailed	パラメーターの検証に失敗しました。パラメーターが不足しているか、無効な値が含まれている可能性があります。	1 つ以上の必須パラメーターが不足しているか、無効な値が含まれています。	有効なパラメーター名および値については API リファレンスを確認し、リクエスト内容を修正してください。
400	MqttTopicNumExceeded	Topic の最大数を超えました。	インスタンスの Topic 数上限に達しています。	不要な Topic を削除して、クォータを解放してください。
400	MqttTopicExist	指定された Topic は既に存在します。パラメーターを確認してください。	この名前の Topic はインスタンス上に既に存在します。	別の Topic 名を使用するか、要件を満たす場合は既存の Topic をご利用ください。
400	InstanceNotFound	インスタンスが見つかりませんでした。instanceId が無効である可能性があります。	指定された `instanceId` に一致するインスタンスが存在しません。	インスタンスが存在すること、およびリクエスト内の `instanceId` の値が正しいことを確認してください。
400	ResourcePermissionCheckFailed	リソース権限の検証中にエラーが発生しました。インスタンス、Topic、および GroupId を作成したアカウントおよび各リソースの権限設定を確認してください。	現在のアカウントには、指定されたリソースに対する必要な権限がありません。	インスタンス、Topic、およびグループの所有者および権限付与ポリシーを確認してください。
400	CreateMqttTopicFailed	MQTT Topic の作成中にエラーが発生しました。パラメーターを確認して再度お試しください。	ApsaraMQ for MQTT インスタンス上で Topic を作成できませんでした。	すべてのパラメーター値が有効であることを確認し、再試行してください。
400	InstancePermissionCheckFailed	インスタンスの権限を検証中にエラーが発生しました。インスタンスを作成したアカウントおよびその権限設定を確認してください。	現在のアカウントには、この ApsaraMQ for MQTT インスタンスへのアクセス権限がありません。	インスタンスの所有者を確認し、権限付与ポリシーで必要な権限が付与されているかを確認してください。
400	PermissionCheckFailed	リソース権限の検証中にエラーが発生しました。インスタンス、Topic、および GroupId を作成したアカウントおよび各リソースの権限設定を確認してください。	現在のアカウントには、インスタンス、Topic、またはグループに対する必要な権限がありません。	リクエストに関与する各リソースの所有者および権限付与ポリシーを確認してください。

ルール関連エラー

HTTP ステータスコード	エラーコード	エラーメッセージ	原因	解決方法
400	ParameterFieldCheckFailed	パラメーターの検証に失敗しました。パラメーターが不足しているか、無効な値が含まれている可能性があります。	1 つ以上の必須パラメーターが不足しているか、無効な値が含まれています。	有効なパラメーター名および値については API リファレンスを確認し、リクエスト内容を修正してください。
400	InstancePermissionCheckFailed	インスタンスの権限を検証中にエラーが発生しました。インスタンスを作成したアカウントおよびその権限設定を確認してください。	現在のアカウントには、この ApsaraMQ for MQTT インスタンスへのアクセス権限がありません。	インスタンスの所有者を確認し、権限付与ポリシーで必要な権限が付与されているかを確認してください。
400	PermissionCheckFailed	リソース権限の検証中にエラーが発生しました。インスタンス、Topic、および GroupId を作成したアカウントおよび各リソースの権限設定を確認してください。	現在のアカウントには、インスタンス、Topic、またはグループに対する必要な権限がありません。	リクエストに関与する各リソースの所有者および権限付与ポリシーを確認してください。
400	ResourcePermissionCheckFailed	リソース権限の検証中にエラーが発生しました。インスタンス、Topic、および GroupId を作成したアカウントおよび各リソースの権限設定を確認してください。	現在のアカウントには、指定されたリソースに対する必要な権限がありません。	インスタンス、Topic、およびグループの所有者および権限付与ポリシーを確認してください。
400	CreateMqttRuleFailed	MQTT ルールの作成中にエラーが発生しました。パラメーターを確認して再度お試しください。	ApsaraMQ for MQTT インスタンス上でルールを作成できませんでした。	すべてのパラメーター値が有効であることを確認し、再試行してください。
400	MqttRuleExist	指定された MQTT ルールは既に存在します。パラメーターを確認してください。	指定されたルールはインスタンス上に既に存在します。	別のルール構成を使用するか、要件を満たす場合は既存のルールをご利用ください。
400	MqttRuleNumExceeded	ルールの最大数を超えました。	インスタンスのルール数上限に達しています。	不要なルールを削除して、クォータを解放してください。
400	InstanceNotFound	インスタンスが見つかりませんでした。instanceId が無効である可能性があります。	指定された `instanceId` に一致するインスタンスが存在しません。	インスタンスが存在すること、およびリクエスト内の `instanceId` の値が正しいことを確認してください。

ApsaraMQ for MQTT のエラーコード一覧については、「サービスエラーコード」をご参照ください。