ENS:統合の概要

バージョンの説明

オンラインデバッグ

ENS は、OpenAPI Explorer での API デバッグなどの機能を提供します。 API 操作を呼び出す前に、ENS が提供するバージョン、エンドポイント、API スタイル、および呼び出し方法について理解しておく必要があります。

OpenAPI Explorer の ENS ページでは、左側メニューに、インスタンス、ディスク、スナップショット、イメージ、セキュリティグループ、ネットワークなどのサービスカテゴリが一覧表示されます。中央のペインでは、API パラメータを設定し、[China (Hangzhou)] などのサービスアドレスを選択して、リクエストパラメータを入力できます。右側のペインでは、[Documentation]、[Debugging Result]、[SDK Sample]、[CLI Sample] の各タブに、API レート制限、リクエストパラメータ、レスポンスパラメータに関する情報が記載された API ドキュメントが表示されます。

デバッグ

ENS API デバッグポータルにアクセスしてください。

エンドポイント

シンガポールリージョンのエンドポイント ens.ap-southeast-1.aliyuncs.com を使用してください。

詳細については、「エンドポイント」をご参照ください。

アイデンティティ

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

RAM ユーザーまたはRAM ロールには必要最小限の権限のみを付与し、RAM ユーザーとして、または RAM ロールを引き受けてオペレーションを呼び出すことを推奨します。

関連ドキュメント

• アイデンティティ、認証情報、および認可

• スロットリングとクォータ管理

呼び出し方法

Alibaba Cloud SDK

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

• Alibaba Cloud SDK を使用してENS API を呼び出すことができます。 サポートされている言語およびインストール手順については、ENS SDK センターをご参照ください。

Alibaba Cloud CLI

• Alibaba Cloud CLI を使用して ENS の API 操作を呼び出すことができます。 詳細については、「サンプルコマンド」をご参照ください。

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

Terraform

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

• Terraform を使用して ENS リソースを編成する方法については、「Terraform を使用したリソースの統合」をご参照ください。

• サポートされているリソース

  Terraform を使用して、通常リソースやデータリソースなどの ENS リソースを管理できます。 Terraform の詳細については、「Terraform とは」をご参照ください。

  リソースタイプ	リソース名	説明
  リソース	alicloud_ens_disk	ディスクを提供します。ENS
  	alicloud_ens_disk_instance_attachment	ディスクインスタンスをアタッチできます。 ENS
  	alicloud_ens_eip	Elastic IP アドレス (EIP) を提供します。ENS
  	alicloud_ens_image	画像リソースを提供します。ENS
  	alicloud_ens_instance	インスタンスを提供します。ENS
  	alicloud_ens_instance_security_group_attachment	インスタンスセキュリティグループのアタッチメントを提供します。ENS
  	alicloud_ens_key_pair	キーペアを提供します。 ENS
  	alicloud_ens_load_balancer	ENS はロードバランサーを提供します。
  	alicloud_ens_network	ネットワークを提供します。ENS
  	alicloud_ens_security_group	セキュリティグループが提供されます。ENS
  	alicloud_ens_snapshot	スナップショットを提供します。ENS
  	alicloud_ens_vswitch	vSwitch を提供するENS
  データソース	alicloud_ens_key_pairs	現在の Alibaba Cloud ユーザーのキーペアを提供します。ENS

Resource Orchestration Service (ROS)

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

• ROS を使用して ENS の API 操作を呼び出すことができます。ROS を使用してオーケストレーションできるリソースには、通常リソースとデータリソースが含まれます。

  • リソース：

    • ALIYUN::ENS::Disk: 従量課金またはサブスクリプションのデータディスクを作成します。

    • ALIYUN::ENS::DiskInstanceAttachment: ENS インスタンスにデータディスクをアタッチします。

    • ALIYUN::ENS::Instance: ENS インスタンスを作成します。

    • ALIYUN::ENS::InstanceSecurityGroupAttachment: ENS インスタンスをセキュリティグループに追加します。

    • ALIYUN::ENS::KeyPair：Rivest-Shamir-Adleman (RSA) で暗号化されたキーペアの公開キーをインポートします。

    • ALIYUN::ENS::Network: 仮想プライベートクラウド (VPC) を作成します。

    • ALIYUN::ENS::NetworkAcl: ネットワークアクセスコントロールリスト (ACL) を作成します。

    • ALIYUN::ENS::NetworkAclAssociation: ACL をネットワークに関連付けます。

    • ALIYUN::ENS::SecurityGroup：セキュリティグループを作成します。

    • ALIYUN::ENS::Snapshot: スナップショットを作成します。

    • ALIYUN::ENS::VSwitch: vSwitch を作成します。

  • データソース：

    • DATASOURCE::ENS::Instances: ENS インスタンスの詳細を照会します。

• ROS を使用して ENS リソースをオーケストレーションする方法については、「ROS を使用したリソースの統合」をご参照ください。

カスタム API カプセル化

ネイティブ HTTP コールを行うには、カスタムリクエストを作成し、リクエストに署名する必要があります。署名メカニズムの詳細については、「機能別の操作一覧」および「リクエスト構文と署名方法 V3」をご参照ください。