Layer 命令

layer 命令是进行层操作的命令。

命令解析
layer publish 命令
参数解析
操作案例
layer list 命令
参数解析
操作案例
layer detail 命令
参数解析
操作案例
layer versions 命令
参数解析
操作案例
layer download 命令
参数解析
操作案例
layer acl 命令【公测】
参数解析
操作案例
remove layer 命令
权限与策略说明

命令解析

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

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

publish：发布层
list：获取层列表
detail：获取层详情
versions：获取层版本

layer publish 命令

layer publish 命令，是用于层发布的命令。

当执行命令layer publish -h/layer 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`
code	-	必填	必填	层的代码
compatible-runtime	-	选填	选填	支持的`runtime`，取值范围`nodejs14,nodejs12,nodejs10,nodejs8,nodejs6,nodejs4.4,python3.9,python3,python2.7,java11,java8,go1,php7.2,dotnetcore2.1,custom7`
description		选填	选填	发布层的描述
layer-name		必填	必填	层的名字

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

操作案例

有资源描述文件（Yaml）时，可以直接执行s layer publish进行层的发布，例如s layer publish --layer-name demo --code ./code；
纯命令行形式（在没有资源描述 Yaml 文件时），需要指定服务所在地区，例如s cli fc layer publish --region cn-hangzhou --layer-name demo --code ./code ；

Python 项目的依赖库需要放在./code/python路径下，比如./code/python/flask。

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

fc-deploy-test: 544c887879c38e5d0afcaf8b4f8f348e#demo#1

layer list 命令

layer list 命令，是用于获取层列表的命令。

当执行命令layer list -h/layer 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`
prefix	-	选填	选填	层名称的前缀。限定返回的资源名称，假设Prefix为a，则返回的资源名必须以a开头。
public	-	选填	选填	展示个人的公共层
official	-	选填	选填	展示官方的公共层。设置official=true后，public自动设为true，设置为false无效。
table	-	选填	选填

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

操作案例

有资源描述文件（Yaml）时，可以直接执行s layer list获取层列表；
纯命令行形式（在没有资源描述 Yaml 文件时），需要指定服务所在地区，例如s cli fc layer list --region cn-hangzhou；

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

fc-deploy-test:
  -
    layerName:         demo
    arn:               544c887879c38e5d0afcaf8b4f8f348e#demo#1
    version:           1
    description:
    compatibleRuntime:
      - nodejs12
      - nodejs10
      - nodejs8
      - nodejs6
      - python3
      - python2.7

layer detail 命令

layer detail 命令，是用户获取指定层和版本详情的命令。

当执行命令layer detail -h/layer detail --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`
layer-name	-	必填	必填	层名称
version-id	-	必填	必填	层版本

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

操作案例

有资源描述文件（Yaml）时，可以直接执行s layer detail --layer-name layerName --version-id versionId获取指定层和指定版本详情；
纯命令行形式（在没有资源描述 Yaml 文件时），需要指定服务所在地区，例如s cli fc layer detail --region cn-hangzhou --layer-name demo --version-id 1；

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

fc-deploy-test:
  layerName:         demo
  version:           1
  description:
  code:
    repositoryType: null
    location:       https://fc-hz-yunqi-func-code.oss-cn-hangzhou-internal.aliyuncs.com/1583208943291465%2Fdemo%2Fdecddf35-8705-4f80-9baa-2c4a9ffc512b?Expires=1636621101&OSSAccessKeyId=&Signature=cZZHNSpeewLXVoFd2%2FdFuLBe4cc%3D
  codesize:          550
  codeChecksum:      17221560529872498506
  createTime:        2021-11-11T08:46:38Z
  acl:               0
  compatibleRuntime:
    - nodejs12
    - nodejs10
    - nodejs8
    - nodejs6
    - python3
    - python2.7
  arn:               544c887879c38e5d0afcaf8b4f8f348e#demo#1

layer versions 命令

layer versions 命令，是获取指定层版本列表的命令。

当执行命令layer version -h/layer versions --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`
layer-name	-	必填	必填	层名称
table	-	选填	必填	是否以表格形式输出

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

操作案例

有资源描述文件（Yaml）时，可以直接执行s layer versions --layer-name layerName获取指定层中的版本列表；
纯命令行形式（在没有资源描述 Yaml 文件时），需要指定服务所在地区，例如s cli fc layer versions --layer-name layerName --region cn-hangzhou；

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

fc-deploy-test:
  -
    layerName:         demo
    arn:               544c887879c38e5d0afcaf8b4f8f348e#demo#1
    version:           1
    description:
    compatibleRuntime:
      - nodejs12
      - nodejs10
      - nodejs8
      - nodejs6
      - python3
      - python2.7

layer download 命令

layer download 命令，是用户下载指定层版本的命令。

当执行命令layer download -h/layer download --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`
layer-name	-	选填	选填	层名称，当 arn 为空时必填
version-id	-	选填	选填	层版本，当 arn 为空时必填
version-id	-	选填	选填	层 Arn

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

操作案例

有资源描述文件（Yaml）时，可以直接执行s layer download --layer-name layerName --version-id versionId下载层版本的代码包；
纯命令行形式（在没有资源描述 Yaml 文件时），需要指定服务所在地区，例如s cli fc layer download --region cn-hangzhuo --layer-name demo --version-id 1；

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

✔ Downloading: [/189******629/test/7d954393-c5a2-4519-94de-d1a4c9e0611f] 144073/144073 100.00% # 下载的进度条
helloworld: /Users/test/.s/cache/layers/189******629-cn-shenzhen-test/8.zip  # 代码包下载的地址

layer acl 命令

layer acl 命令，个人层设置公开。

说明：如果函数配置其他账户的公共层时，需要使用 arnV2 版本。

当执行命令layer acl -h/layer acl --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`
layer-name	-	必填	必填	层名称
public	-	选填	选填	个人层设置公开

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

操作案例

有资源描述文件（Yaml）时，可以直接执行s layer acl --layer-name layerName --public设置层公开，或者执行s layer acl --layer-name layerName --public false 设置层不公开；
纯命令行形式（在没有资源描述 Yaml 文件时），需要指定服务所在地区，例如s cli fc layer acl --region cn-hangzhuo --layer-name demo；

权限与策略说明

layer list、layer version与layer detail 命令所需要的权限策略： AliyunFCReadOnlyAccess
layer publish 命令所需要的权限策略：

{
  'Version': '1',
  'Statement':
    [
      {
        'Action': 'fc:CreateLayerVersion',
        'Effect': 'Allow',
        'Resource': 'acs:fc:<region>:<account-id>:layers/<layerName>/versions/*',
      },
    ],
}