腾讯云 Serverless 应用中心 - 对象存储 COS 组件

Serverless 应用中心

简介/价格/文档

腾讯云 Serverless 应用中心 - 对象存储 COS 组件

文档简介：

操作场景：对象存储 COS 组件是 serverless-tencent 组件库中的基础组件之一。通过对象存储 COS 组件，可以快速且方便地创建、配置和管理腾讯云的 COS 存储桶。

*此产品及展示信息均由腾讯云官方提供。免费试用咨询热线：400-826-7010，为您提供专业的售前咨询，让您快速了解云产品，助您轻松上云！微信咨询

免费试用、价格特惠

文档详情

操作场景

对象存储 COS 组件是 serverless-tencent 组件库中的基础组件之一。通过对象存储 COS 组件，可以快速且方便地创建、配置和管理腾讯云的 COS 存储桶。

前提条件

已安装 Node.js。

注意：

2020年9月1日起，Serverless 组件不再支持 Node.js10.0 以下版本，请注意升级。

操作步骤

安装

已经安装 Serverless Cloud Framework 。详情请参见安装 Serverless Cloud Framework。

配置

本地创建 serverless.yml 文件，在其中进行如下配置：

		
			touch serverless.yml

				
			# serverless.yml
		
			org: orgDemo
		
			app: appDemo
		
			stage: dev
		
			component: cos
		
			name: cosDemo
		
			inputs:
		
			 bucket: my-bucket
		
			 region: ap-guangzhou

查看详细配置文档 >>

部署

执行以下命令进行部署，返回信息如下：

				
			[root@iZh8dhuyhmexn3Z demo]# scf deploy
		
			serverless-cloud-framework
		
			Action: "deploy" - Stage: "dev" - App: "appDemo" - Instance: "cosDemo"
		
			region: ap-guangzhou
		
			bucket: my-bucket-xxxxxxx
		
			url:    http://my-bucket-xxxxxxx.cos.ap-guangzhou.myqcloud.com
		
			Full details: https://serverless.cloud.tencent.com/instances/appDemo%3Adev%3AcosDemo
		
			3s › cosDemo › Success

说明：

微信扫码授权部署有过期时间，如果想要持久授权，请参考账号配置。

移除

执行以下命令移除部署的服务：

仅删除云函数相关的配置、代码。

关联的其他云资源（如 COS、CLS 等），平台均不会关联删除，您可以前往对应产品控制台删除，避免不必要的计费。

		
			scf remove

账号配置（可选）

当前默认支持 CLI 扫描二维码登录，如您希望配置持久的环境变量/密钥信息，也可以本地创建 .env 文件：

		
			touch .env # 腾讯云的配置信息

在 .env 文件中配置腾讯云的 SecretId 和 SecretKey 信息并保存。

				
			# .env
		
			TENCENT_SECRET_ID=123
		
			TENCENT_SECRET_KEY=123

说明：

如果没有腾讯云账号，请先注册新账号。

如果已有腾讯云账号，可以在 API 密钥管理中获取 SecretId 和 SecretKey。

配置详情

完整配置

				
			# serverless.yml
		
			app: appDemo # (否) 该应用名称
		
			stage: dev # (否) 用于区分环境信息，默认值为 dev
		
			component: cos # (是) 组件名称，此处为 cos
		
			name: cos-demo # (是) 实例名称
		
			inputs:
		
			 src:
		
			 src: ./
		
			 exclude:
		
			 - .env
		
			 bucket: my-bucket
		
			 targetDir: /
		
			 protocol: https
		
			 region: ap-guangzhou
		
			 replace: false # 部署时会先清理桶内所有文件，谨慎使用！！！
		
			 website: false
		
			 websiteConfig:
		
			 index: index.html
		
			 error: index.html
		
			 ignoreHtmlExt: false # 是否是否忽略 html 扩展名，默认 false
		
			 disableErrorStatus: false # 是否禁用错误码，默认 false
		
			 acl:
		
			 permissions: private
		
			 grantRead: id="1234567"
		
			 grantWrite: id="1234567"
		
			 grantFullControl: id="1234567"
		
			 cors:
		
			 - maxAgeSeconds: 0
		
			 allowedMethods:
		
			 - GET
		
			 allowedOrigins:
		
			 - '*'
		
			 allowedHeaders:
		
			 - '*'
		
			 exposeHeaders:
		
			 - ''
		
			 tags:
		
			 - key: abc
		
			 value: xyz
		
			 policy:
		
			 - Principal:
		
			 qcs:
		
			 - 'qcs::cam::anyone:anyone'
		
			 Effect: 'Allow'
		
			 Action:
		
			 - 'name/cos:HeadBucket'
		
			 - 'name/cos:ListMultipartUploads'
		
			 - 'name/cos:ListParts'
		
			 - 'name/cos:GetObject'
		
			 - 'name/cos:HeadObject'
		
			 - 'name/cos:OptionsObject'
		
			 Resource:
		
			 - qcs::cos:ap-guangzhou:uid/123456789:my-bucket-123456789/*
		
			 - Principal:
		
			 qcs:
		
			 - 'qcs::cam::uin/10023456789:uin/10023456789'
		
			 Effect: 'Deny'
		
			 Action:
		
			 - 'name/cos:*'
		
			 Resource:
		
			 - qcs::cos:ap-guangzhou:uid/123456789:my-bucket-123456789/*

配置说明

主要参数说明如下：

参数	必选	类型	默认值	描述
bucket	是	string	-	存储桶名称，如若不添加 AppId 后缀，则系统会自动添加，后缀为大写
region	是	string	-	存储桶所属的区域
src	否	string	-	要上传到存储桶的文件或目录
targetDir	否	string	/	要上传到存储桶的目标目录，默认目录是根路径 /
protocol	否	string	https	访问协议
acl	否	Acl	-	访问控制配置
cors	否	Cors[]	-	跨域资源共享配置
tags	否	Tag[]	-	标签配置
policy	否	Policy	-	策略控制配置
replace	否	boolean	false	是否是替换式部署，如果为 true，部署时将先删除对应 bucket 的所有旧文件。
website	否	boolean	false	是否开启静态网站能力
websiteConfig	否	WebsiteConfig	-	静态网站相关配置，只有 website 为 true 时才生效

Acl

参数	必选	类型	默认值	描述
permissions	否	string	private	定义存储桶的访问控制列表(ACL)属性。有关枚举值（如 private、public-read），请参见 ACl 概述中的“存储桶的预设 ACL”部分
grantRead	否	string	-	授予读取权限，以 id ="OwnerUin" 格式授权对存储桶读取的权限，例如 id="100000000001"
grantWrite	否	string	-	授予写入权限，以 id ="OwnerUin" 格式授权对存储桶写入的权限，例如 id="100000000001"
grantFullControl	否	string	-	授予全权控制权限，以 id ="OwnerUin" 格式授权对存储桶全权控制的权限，例如 id="100000000001"

Cors

参数	必选	类型	描述
id	是	string	配置规则的
maxAgeSeconds	是	number	设置 OPTIONS 请求得到结果的有效期
allowedMethods	是	string[]	允许的 HTTP 操作，枚举值：GET，PUT，HEAD，POST，DELETE
allowedOrigins	是	string[]	允许的访问来源，支持通配符 *，格式为：协议://域名[:端口]，例如：http://www.qq.com
allowedHeaders	是	string[]	在发送 OPTIONS 请求时告知服务端，接下来的请求可以使用哪些自定义的 HTTP 请求头部，支持通配符*
exposeHeaders	是	string[]	设置浏览器可以接收到的来自服务器端的自定义头部信息

Tag

参数	必选	类型	描述
key	是	string	标签的 Key，长度不超过 128 字节, 支持英文字母、数字、空格、加号、减号、下划线、等号、点号、冒号、斜线
value	是	string	标签的 Value，长度不超过 256 字节, 支持英文字母、数字、空格、加号、减号、下划线、等号、点号、冒号、斜线

Policy

详情见 COS API 授权策略使用指引和访问策略语言概述。

说明：

Principal、Effect、Action、Resource 均为首字母大写。

WebsiteConfig

静态网站相关配置如下：

参数	必选	类型	描述
index	否	string	index.html
error	否	string	error.html
disableErrorStatus	否	boolean	false
ignoreHtmlExt	否	boolean	false

相似文档

腾讯云 Serverless 应用中心 - 内容分发网络 CDN 组件
操作场景：腾讯云 CDN 组件是 serverless-tencent 组件库中的基础组件之一。通过 CDN 组件，您可以快速方便的创建、配置和管理腾讯云的 CDN 产品。
腾讯云 Serverless 应用中心 - 数据库 PostgreSQL 组件
操作场景： PostgreSQL for Serverless（ServerlessDB）是一款基于 PostgreSQL 数据库实现的按需分配资源的数据库产品，其数据库将根据您的实际请求数来自动分配资源。PostgreSQL for Serverless 仅需创建实例，即可正常使用，您无需关心数据库实例规格，仅需要在数据库处于活动状态期间按照实际用量进行付费，不需要为数据库的闲时进行付费。
腾讯云 Serverless 应用中心 - 私有网络 VPC 组件
操作场景：腾讯云 VPC 组件支持通过serverless.yml配置，快速创建指定名称的私有网络和子网，并输出 VPCID 和 SubnetID，便于配置其他组件所需的网络信息。
腾讯云 Serverless 应用中心 - Layer 组件
操作场景： Layer 组件是 serverless-tencent 组件库中的基础组件之一。您可以通过该组件快速且方便地创建、配置和管理腾讯云函数的层资源。
腾讯云 Serverless 应用中心 - 云原生数据库 TDSQL-C 组件
操作场景：该教程指导您通过 Serverless Cloud Framework 组件，快速创建一个 TDSQL-C Serverless 数据库实例。

文档中心

全民上云·上云补贴申领

免费试用（限企业）

操作场景

前提条件

操作步骤

安装

配置

部署

移除

账号配置（可选）

配置详情

完整配置

配置说明

Acl

Cors

Tag

Policy

WebsiteConfig