Skip to content

Version 命令

version 命令是进行函数版本操作的命令；主要包括别名的查看、发布、删除等功能。

命令解析

当执行命令version -h/version --help时，可以获取帮助文档。

在该命令中，包括了两个子命令：

version list 命令

version list 命令，是查看服务已发布的版本列表的命令。

当执行命令version list -h/version list --help时，可以获取帮助文档。

参数解析

参数全称 参数缩写 Yaml 模式下必填 Cli 模式下必填 参数含义
region - 选填 必填 地区，取值范围：cn-hangzhou, cn-beijing, cn-beijing, cn-hangzhou, cn-shanghai, cn-qingdao, cn-zhangjiakou, cn-huhehaote, cn-shenzhen, cn-chengdu, cn-hongkong, ap-southeast-1, ap-southeast-2, ap-southeast-3, ap-southeast-5, ap-northeast-1, eu-central-1, eu-west-1, us-west-1, us-east-1, ap-south-1
service-name - 选填 必填 服务名
table - 选填 选填 是否以表格形式输出

当前命令还支持部分全局参数（例如-a/--access, --debug等），详情可参考 Serverless Devs 全局参数文档

操作案例

  • 有资源描述文件（Yaml）时，可以直接执行s version list查看当前服务所发布的版本列表；
  • 纯命令行形式（在没有资源描述 Yaml 文件时），需要指定服务所在地区以及服务名称，例如s cli fc version list --region cn-hangzhou --service-name fc-deploy-service；

上述命令的执行结果示例：

fc-deploy-test:
  -
    versionId:        1
    description:      test publish version
    createdTime:      2021-11-08T06:07:00Z
    lastModifiedTime: 2021-11-08T06:07:00Z

如果指定了--table参数，输出示例：

  ┌───────────┬──────────────────────┬──────────────────────┬──────────────────────┐
  │ versionId │     description      │     createdTime      │   lastModifiedTime   │
  ├───────────┼──────────────────────┼──────────────────────┼──────────────────────┤
  │ 1         │ test publish version │ 2021-11-08T06:07:00Z │ 2021-11-08T06:07:00Z │
  └───────────┴──────────────────────┴──────────────────────┴──────────────────────┘

version publish 命令

version publish 命令，是用于发布版本的命令。

当执行命令version publish -h/version publish --help时，可以获取帮助文档。

参数解析

参数全称 参数缩写 Yaml 模式下必填 Cli 模式下必填 参数含义
region - 选填 必填 地区，取值范围：cn-hangzhou, cn-beijing, cn-beijing, cn-hangzhou, cn-shanghai, cn-qingdao, cn-zhangjiakou, cn-huhehaote, cn-shenzhen, cn-chengdu, cn-hongkong, ap-southeast-1, ap-southeast-2, ap-southeast-3, ap-southeast-5, ap-northeast-1, eu-central-1, eu-west-1, us-west-1, us-east-1, ap-south-1
service-name - 选填 必填 服务名
description - 选填 选填 版本描述
ignore-no-chang-error - 选填 选填 忽略发布版本 No changes were made since last publish异常

当前命令还支持部分全局参数（例如-a/--access, --debug等），详情可参考 Serverless Devs 全局参数文档

操作案例

  • 有资源描述文件（Yaml）时，可以直接执行s version publish进行版本的发布；
  • 纯命令行形式（在没有资源描述 Yaml 文件时），需要指定服务所在地区以及服务名称，例如s cli fc version publish --region cn-hangzhou --service-name fc-deploy-service --description "test publish version"；

上述命令的执行结果示例：

fc-deploy-test:
  versionId:        1
  description:      test publish version
  createdTime:      2021-11-08T06:07:00Z
  lastModifiedTime: 2021-11-08T06:07:00Z

权限与策略说明

  • version list 命令所需要的权限策略： AliyunFCReadOnlyAccess

  • version publish 命令所需要的权限策略：

{
  'Version': '1',
  'Statement':
    [
      {
        'Action': 'fc:PublishServiceVersion',
        'Effect': 'Allow',
        'Resource': 'acs:fc:<region>:<account-id>:services/<serviceName>/versions',
      },
    ],
}