Version 命令

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

命令解析

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

在该命令中,包括了三个子命令:

version list 命令

version list 命令,是查看函数已发布的版本列表的命令。

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

参数解析

参数全称参数缩写Yaml 模式下必填Cli 模式下必填参数含义
region-选填必填地域名称,取值范围参见函数计算开服地域
function-name-选填必填函数名

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

操作案例

  • 有资源描述文件(Yaml)时,可以直接执行s version list查看当前函数所发布的版本列表;
  • 纯命令行形式(在没有资源描述 Yaml 文件时),需要指定函数所在地区以及函数名称,例如s cli fc3 version list --region cn-hangzhou --function-name test-function

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

fc3-deploy-test:
  -
    createdTime:      2023-09-25T06:57:24Z
    description:      test publish version 2
    lastModifiedTime: 2023-09-25T06:57:24Z
    versionId:        2
  -
    createdTime:      2023-09-25T06:46:28Z
    description:      test publish version
    lastModifiedTime: 2023-09-25T06:46:28Z
    versionId:        1

version publish 命令

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

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

参数解析

参数全称参数缩写Yaml 模式下必填Cli 模式下必填参数含义
region-选填必填地域名称,取值范围参见函数计算开服地域
function-name-选填必填函数名
description-选填选填版本描述

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

操作案例

  • 有资源描述文件(Yaml)时,可以直接执行s version publish进行版本的发布;
  • 纯命令行形式(在没有资源描述 Yaml 文件时),需要指定函数所在地区以及函数名称,例如s cli fc3 version publish --region cn-hangzhou --function-name test-function --description "test publish version"

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

fc3-deploy-test:
  createdTime:      2023-09-25T06:46:28Z
  description:      test publish version
  lastModifiedTime: 2023-09-25T06:46:28Z
  versionId:        1

version remove 命令

version remove 命令,是用户删除指定已发布的版本命令。

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

参数解析

参数全称参数缩写Yaml 模式下必填Cli 模式下必填参数含义
region-选填必填地域名称,取值范围参见函数计算开服地域
function-name-选填必填函数名
version-id-必填必填版本 Id
assume-yesy选填选填在交互时,默认选择y

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

操作案例

  • 有资源描述文件(Yaml)时,可以直接执行s version remove --version-id versionId删除指定versionId的版本;
  • 纯命令行形式(在没有资源描述 Yaml 文件时),需要指定函数所在地区以及函数名称,例如s cli fc3 version remove --region cn-hangzhou --function-name test-function --version-id versionId

权限与策略说明

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

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

    {
      "Version": "1",
      "Statement": [
        {
          "Action": "fc:PublishFunctionVersion",
          "Effect": "Allow",
          "Resource": "acs:fc:{region}:{uid}:functions/{functionName}/versions/*"
        }
      ]
    }
    
  • version remove 命令所需要的权限策略: AliyunFCReadOnlyAccess

    {
      "Version": "1",
      "Statement": [
        {
          "Action": "fc:DeleteFunctionVersion",
          "Effect": "Allow",
          "Resource": "acs:fc:{region}:{uid}:functions/{functionName}/versions/*"
        }
      ]
    }
    
在 GitHub 上编辑本页面 更新时间: Thu, Feb 22, 2024