API多版本的区别

函数计算FC(Function Compute)API有两个版本,且版本间互相不兼容。本文介绍这两个API版本间的区别,帮助您迅速定位差异,实现升级。

API版本列表

函数计算有以下两个API版本。

API版本

说明

2021-04-06

升级后的版本。如需使用该版本的SDK,请参见SDK参考(2021-04-16推荐)

2016-08-15

升级前的版本。如需使用该版本的SDK,请参见SDK列表

版本差异

对比项

2016-08-15版API

2021-04-06版API

Path中的version参数取值

Path格式为/{version}/services/xxxx

2016-08-15

2021-04-06

qualifier位置

位于Path,例如:/version/serviceName.qualifier/xxx

位于Query,例如:/version/serviceName/xxx?qualifier=xxx

API命名优化

主要涉及以下API的Path变更:

  • CreateVpcBinding

    /{version}/services/{serviceName}/binding
  • DeleteVpcBinding:

    /{version}/services/{serviceName}/binding
  • ListReservedCapacities

    /{version}/reservedCapacities

主要涉及以下API的Path变更:

  • CreateVpcBinding

    /{version}/services/{serviceName}/bindings
  • DeleteVpcBinding:

    /{version}/services/{serviceName}/bindings/{vpcId}
  • ListReservedCapacities

    /{version}/reserved-capacities

签名计算方式

详细信息,请参见签名认证

详细信息,请参见签名机制

对Body数据完整性的校验

不对Body单独做校验。

签名中包含Body的MD5值,此值从请求Header中读Content-MD5键,SDK不做生成。

考虑有对Payload的完整性校验需求,后端会检查请求Header的MD5字段是否为空:

  • 如果为空,则不对Body做校验。

  • 如果不为空,则生成MD5值,与Header的MD5值做比对。

触发器相关API中triggerConfig字段类型

字段类型为Interface。

字段类型为String,您需将不同类型触发器的triggerConfig数据编码成JSON字符串传入API。