すべてのプロダクト
Search

このプロダクト

    IoT Platform:統合の概要

    ドキュメントセンター

    IoT Platform:統合の概要

    最終更新日:Mar 22, 2025

    IoT Platform は、視覚的な操作のためのコンソールと、OpenAPI Explorer、Alibaba Cloud SDK、Terraform、Resource Orchestration Service（ROS）などの API 操作を呼び出すための複数のメソッドを提供します。 これにより、開発とデプロイが容易になります。

    API の概要

    Alibaba Cloud API は、開発者がプログラミングによって Alibaba Cloud サービスにアクセスして管理し、自動化されたカスタムソリューションを提供できるようにする一連の API です。 Alibaba Cloud は、開発者がさまざまな Alibaba Cloud サービスの API 操作を効率的に理解して使用できるように OpenAPI Explorer を提供しています。 OpenAPI Explorer は、インテリジェント検索、ドキュメント、オンラインデバッグ、SDK ダウンロード、サンプルコード、エラー診断、呼び出し統計など、API 操作に関連する複数の機能を統合しています。 OpenAPI Explorer では、すべての Alibaba Cloud サービスの API 操作を呼び出し、API リクエストとレスポンスを表示できます。 詳細については、「API とは」をご参照ください。

    バージョン

    OpenAPI Explorer は、2018-01-20 バージョンの API のオンラインデバッグをサポートしています。 2018-01-20 は日付ではなく API バージョン番号です。 2018-01-20 は API の最終更新日ではありません。 OpenAPI Explorer を使用すると、すべてのパブリック API の最新バージョンを呼び出すことができます。 API のバージョンの表示方法の詳細については、「API バージョン」をご参照ください。

    バージョン番号

    説明

    2018-01-20

    推奨バージョン。

    オンラインデバッグ

    OpenAPI Explorer で IoT Platform の API 操作を呼び出すことができます。 IoT Platform の API 操作を呼び出す前に、API バージョン、エンドポイント、リクエストパラメータなど、API に関する情報を理解する必要があります。

    image

    オンラインデバッグページ

    で IoT Platform の API 操作を呼び出すことができます。

    エンドポイント

    エンドポイントは、Alibaba Cloud サービスにアクセスするために使用されます。 Alibaba Cloud サービスのエンドポイントは、パブリックエンドポイントと Virtual Private Cloud（VPC）エンドポイントで構成されます。

    • パブリックエンドポイントはグローバルにアクセスできます。

    • VPC エンドポイントは、特定の Alibaba Cloud リージョンの VPC 内からのみアクセスできます。 VPC エンドポイントには次の利点があります。

      • セキュリティの向上：VPC エンドポイントは VPC 内からのみアクセスできます。 これにより、セキュリティとプライバシーが向上します。

      • 高速な応答：VPC エンドポイントは内部ネットワーク環境を使用して、パブリックエンドポイントよりも高速な応答を提供します。 さらに、VPC エンドポイントを使用することで、ネットワーク遅延や帯域幅制限などの問題から解放されます。

      • 低コスト：VPC エンドポイントは内部ネットワーク経由でアクセスされます。 これにより、外部トラフィックへの依存とパブリック帯域幅の使用コストが削減されます。

    ほとんどの場合、ユーザーまたはビジネスが存在するリージョンに最も近いエンドポイントを選択して、ネットワーク遅延とアプリケーションの応答時間を短縮し、データ転送を高速化できます。 たとえば、ほとんどのユーザーが杭州にいる場合は、中国（杭州）リージョンのエンドポイントを選択することをお勧めします。

    IoT Platform のエンドポイントの詳細については、「IoT Platform リージョン」をご参照ください。

    ユーザー ID

    Alibaba Cloud アカウントを使用して OpenAPI Explorer にログインすると、OpenAPI はデフォルトで Alibaba Cloud アカウントを使用してオンラインデバッグを実行します。 Alibaba Cloud アカウントには、すべての API 操作に対する権限があります。 Alibaba Cloud アカウントを使用して API 操作を呼び出すと、セキュリティリスクが発生する可能性があります。 API 操作の呼び出しまたは日常的な O&M は、Resource Access Management（RAM）ユーザーとして実行することをお勧めします。 RAM ユーザーとして API 操作を呼び出す前に、ビジネス要件に基づいて必要な権限を RAM ユーザーに付与します。 RAM ユーザーは、IoT Platform に対する権限を持っている必要があります。 詳細については、「IoT Platform API 操作と RAM ポリシー間のマッピング」をご参照ください。

    ID

    サポート

    Alibaba Cloud アカウント

    はい

    RAM ユーザー（推奨）

    はい

    RAM ロール（推奨）

    はい

    参照

    統合方法

    説明

    SDK はアプリケーションと簡単に統合でき、最も幅広い操作をカバーしています。 API 操作を呼び出すには、SDK を使用することをお勧めします。

    統合方法

    サポート

    Alibaba Cloud SDK

    はい

    Alibaba Cloud CLI

    はい

    Terraform

    一部サポート

    ROS

    一部サポート

    カスタム API カプセル化

    はい

    • Alibaba Cloud SDK

      • Alibaba Cloud は、Java、C#、Go、Python、Node.js、TypeScript、PHP、C++ など、複数のプログラミング言語で SDK を提供しています。 アプリケーションと SDK を統合して、API 操作を直接呼び出すことができます。 SDK は、署名ロジック、タイムアウトメカニズム、再試行メカニズムをカプセル化し、開発を容易にするリクエストオブジェクトとレスポンスオブジェクトを提供します。 詳細については、「Alibaba Cloud SDK」をご参照ください。

      • IoT Platform SDK を使用して API 操作を呼び出すことができます。 サポートされているプログラミング言語と依存関係のインストール方法の詳細については、「IoT Platform SDK」をご参照ください。

    • Alibaba Cloud CLI

      • Alibaba Cloud CLI を使用すると、aliyun コマンドを実行して Alibaba Cloud サービスと対話し、クラウドサービスリソースを管理できます。 詳細については、「Alibaba Cloud CLI とは」をご参照ください。

      • Alibaba Cloud CLI を使用して、IoT Platform の API 操作を呼び出すことができます。 Alibaba Cloud CLI の入手方法と使用方法の詳細については、「Alibaba Cloud CLI ユーザーガイド」をご参照ください。

    • Terraform

      • Terraform は、クラウドインフラストラクチャとリソースを安全かつ効率的にプレビュー、構成、および管理するために使用されるオープンソースツールです。 Terraform は ROS と同様の方法で動作します。 Terraform は、テンプレートを解釈することで API 操作を呼び出します。 詳細については、「Terraform とは」をご参照ください。

      • Terraform を使用して、IoT Platform の API 操作を呼び出すことができます。 次の表に、Terraform でサポートされているリソースとデータソースを示します。

        タイプ

        リスト

        説明

        リソース

        alicloud_iot_device_group

        デバイスグループリソースを提供します。

        データソース

        alicloud_iot_device_groups

        このデータソースは、現在の Alibaba Cloud アカウント内のすべてのデバイスグループを提供します。

        alicloud_iot_service

        このデータソースを使用して、IoT サービスを自動的にアクティブ化できます。 IoT サービスがアクティブ化されている場合、On 状態が返されます。

    • ROS

      • ROS は、クラウドコンピューティングリソースの管理を簡素化できる Alibaba Cloud サービスです。 Elastic Compute Service（ECS）や ApsaraDB RDS インスタンスなどの必要なクラウドコンピューティングリソースと、リソース間の関係を記述するテンプレートを作成できます。 ROS は、テンプレートに基づいてすべてのリソースを自動的に作成および構成し、自動化されたデプロイと O&M を実装します。 詳細については、「ROS とは」をご参照ください。

      • ROS を使用して、IoT Platform の API 操作を呼び出すことができます。 次の表に、ROS でサポートされているリソースタイプを示します。

        リソースタイプ

        説明

        ALIYUN::IOT::Device

        デバイスを登録します。

        ALIYUN::IOT::DeviceGroup

        デバイスグループを作成します。

        ALIYUN::IOT::Product

        プロダクトを作成します。

        ALIYUN::IOT::ProductTopic

        特定のプロダクトのトピックを作成します。

        ALIYUN::IOT::Rule

        特定のトピックのルールを作成します。

        ALIYUN::IOT::RuleAction

        特定のルールのルールアクションを作成します。

    • カスタム API カプセル化

    使用上の注意

    • Alibaba Cloud アカウントが開始できる 1 秒あたりのクエリ数（QPS）は、API 操作によって異なります。 詳細については、各操作の API リファレンスの「QPS 制限」セクションをご参照ください。

      説明

      Alibaba Cloud アカウントに属するすべての RAM ユーザーは、Alibaba Cloud アカウントの QPS クォータを共有します。

    • API 操作の呼び出し後にエラーが返された場合は、エラーコードに基づいてリクエストパラメータとパラメータ値が有効かどうかを確認できます。 詳細については、「エラーコード」をご参照ください。

    • OpenAPI 問題診断 ページで、返されたリクエスト ID または SDK エラー情報に基づいてセルフサービス診断を実行することもできます。