SDK是ACM提供给用户在应用运行时获取、发布、监听、删除配置的手段。同时,我们也开放了SDK底层使用的API协议,如SDK不能满足您的使用场景,您也可以基于API协议来实现应用运行时配置操作和监听的功能。

说明 此SDK用于在应用中操作和监听配置,如您需要在管控节点对应用配置进行管理,可考虑使用获取OpenAPI SDK

ACM SDK支持的类型

ACM SDK目前支持以下类型:
  • ACM Java Native SDK:支持ACM配置监听和变更的Java原生SDK。
  • Spring Cloud ACM:支持Spring Cloud Config接口规范的Java SDK。后续将不再继续维护,推荐使用Nacos的 spring-cloud-starter-alibaba-nacos-config
  • ACM Node.js SDK:支持ACM配置监听和变更的Node.js原生SDK。
  • ACM C++ SDK:支持ACM配置监听和变更的C++原生SDK。
  • ACM Python(已开源):支持ACM配置监听和变更的Python原生SDK。
  • ACM PHP(已开源):支持ACM配置监听的PHP原生SDK。
  • Nacos Client:支持ACM配置监听和变更的Java原生SDK。

ACM SDK功能特性

ACM SDK 的功能特性如下:

功能 Java Native Java Spring Cloud Python Node.JS C++ PHP Nacos SDK
获取特定配置 支持 支持 支持 支持 支持 支持 支持
监听特定配置 支持 支持 支持 支持 支持 不支持 支持
写入配置 支持 不支持 支持 不支持 不支持 支持 支持
支持固定租户下枚举配置 支持 不支持 支持 不支持 不支持 不支持 不支持
支持单一IP方式进行服务端连接 支持 不支持 支持 不支持 不支持 不支持 支持
支持多IP LB方式进行服务端连接 支持 支持 支持 支持 支持 支持 支持
支持HmacSHA1算法方式用户认证 支持 支持 支持 支持 支持 支持 支持
支持本地缓存备份 支持 支持 支持 支持 支持 不支持 支持
支持 ECS 实例 RAM 角色鉴权 支持 支持 支持 不支持 不支持 不支持 不支持
开源地址 计划中 计划中 acm-sdk-python 计划中 计划中 acm-sdk-php Nacos
  • 多IP LB方式是指ACM SDK基于地址服务器返回的多ACM服务端IP地址的LoadBalance功能,以提高性能和实现高可用。
  • 本地缓存备份功能可以让ACM SDK在没有服务端连接情况下,通过读取上次获取配置后保存的本地缓存备份文件,来避免客户端应用宕机。
  • spring-cloud-starter-acm后续将不再继续维护,推荐使用Nacos的 spring-cloud-starter-alibaba-nacos-config

地域和接入点列表

地域 地址服务器域名
公网 acm.aliyun.com
华东 1(杭州) addr-hz-internal.edas.aliyun.com
华北 1(青岛) addr-qd-internal.edas.aliyun.com
华东 2(上海) addr-sh-internal.edas.aliyun.com
华北 2(北京) addr-bj-internal.edas.aliyun.com
华南 1(深圳) addr-sz-internal.edas.aliyun.com
中国(香港) addr-hk-internal.edas.aliyuncs.com
新加坡(新加坡) addr-singapore-internal.edas.aliyun.com
澳大利亚(悉尼) addr-ap-southeast-2-internal.edas.aliyun.com
美国(硅谷) addr-us-west-1-internal.acm.aliyun.com
美国(弗吉尼亚) addr-us-east-1-internal.acm.aliyun.com
华东 2(上海)金融云 addr-cn-shanghai-finance-1-internal.edas.aliyun.com