集成概览

版本说明

在线调试

ENS在OpenAPI门户提供API调试等功能。在调用前，您需要了解ENS服务提供的版本、接入点、接口风格、调用方式等信息。

调式入口

调试API入口为：ENS API调试入口。

接入点说明

请使用全局接入域名ens.aliyuncs.com

更多信息，请参见服务接入点。

用户身份

您使用阿里云账号登录OpenAPI网站后，默认使用您的阿里云账号进行在线OpenAPI调试。由于阿里云账号拥有所有API的访问权限，存在较高的风险。强烈建议您创建并使用RAM用户进行API访问或日常运维。请根据业务的实际情况按需分配权限后进行接口调用。RAM用户需具备操作ENS资源的权限。具体操作，请参见边缘节点服务 ENS系统权限策略参考。

推荐您使用RAM用户或RAM角色，根据业务的实际情况按需分配权限后进行接口调用。

更多信息

• 身份、凭据与授权

• 流量控制与配额管理

调用方式支持情况

阿里云SDK

• 阿里云为开发者提供了多种编程语言（Java、C#、Go、Py thon、Node.js/TypeScript、PHP、C++ 等）的SDK。开发者只需要集成SDK，通过SDK暴露的方法直接调用OpenAPI 。SDK统一封装了签名逻辑、超时机制、重试机制，并根据文档返回结构化Response对象，易于开发。更多关于阿里云SDK的介绍，请参见阿里云SDK。

• 支持在OpenAPI通过阿里云SDK调用ENS。支持语言及依赖安装方法请参见ENS_SDK中心。

阿里云CLI

• 支持使用阿里云CLI调用ENS。更多信息，请参见使用阿里云CLI。

• 阿里云命令行工具可以帮您在使用命令行终端时，使用aliyun命令与阿里云服务进行交互，管理云服务资源。有关阿里云CLI的更多详细信息，请参见什么是阿里云CLI。

Terraform

• Terraform 是一种开源工具，用于安全高效地预览，配置和管理云基础架构和资源。它与阿里云的资源编排服务的运行机制类似，通过将模板转化为内部数据后完成 OpenAPI 调用。更多详情，请参见什么是Terraform。

• 快速使用Terraform编排ENS，请参见Terraform集成示例。

• 支持资源列表

  支持使用Terraform管理ENS的资源，支持常规资源和数据资源清单的部分如下。如果您还不了解Terraform，请参见什么是Terraform。

  资源类型	资源名称	说明

  资源类型	资源名称	说明
  Resources	alicloud_ens_disk	提供ENS磁盘资源。
  	alicloud_ens_disk_instance_attachment	提供ENS磁盘实例附件资源。
  	alicloud_ens_eip	提供ENS弹性公网IP。
  	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	提供ENS vSwitch资源。
  Data Sources	alicloud_ens_key_pairs	提供当前阿里云用户的ENS密钥对。

资源编排ROS

• 资源编排服务ROS（Resource Orchestration Service）是阿里云提供的一项简化云计算资源管理的服务。开发者和管理员可以编写模板，在模板中定义所需的阿里云资源（例如：ECS 实例、RDS 数据库实例）、资源间的依赖关系等。ROS 的编排引擎将根据模板自动完成所有资源的创建和配置，实现自动化部署及运维。更多详情，请参见什么是资源编排服务。

• 支持使用资源编排服务ROS调用ENS。编排的部分资源包括普通资源和数据资源。

  • 普通资源：

    • ALIYUN::ENS::Disk：用于创建一块按量付费或包年包月数据盘。

    • ALIYUN::ENS::DiskInstanceAttachment：用于为ENS实例挂载数据盘。

    • ALIYUN::ENS::Instance：用于创建ENS实例。

    • ALIYUN::ENS::InstanceSecurityGroupAttachment：用于将一台ENS实例加入到指定的安全组。

    • ALIYUN::ENS::KeyPair：用于导入RSA密钥对公钥。

    • ALIYUN::ENS::Network：用于创建一个专有网络。

    • ALIYUN::ENS::NetworkAcl：用于创建一条网络ACL规则。

    • ALIYUN::ENS::NetworkAclAssociation：用于绑定网络ACL至网络。

    • ALIYUN::ENS::SecurityGroup：用于新建一个安全组。

    • ALIYUN::ENS::Snapshot：用于创建快照。

    • ALIYUN::ENS::VSwitch：用于创建交换机。

  • 数据资源：

    • DATASOURCE::ENS::Instances：用于查询多台ENS实例的详细信息。

• 快速使用资源编排ROSENS，请参见资源编排ROS集成示例。

自定义封装API调用

原生HTTP调用需要您自己实现签名算法，并构建自定义请求，发起HTTP调用。有关签名机制的更多详细信息，请参见文档API概览和V3版本请求体&签名机制。