Skip to content

Cloud Services

AWS S3, Azure Blob, Google Cloud Storage, and Google Workspace integrations.

14 modules

ModuleDescription
Xóa đối tượng S3Xóa một đối tượng khỏi bucket AWS S3
Tải xuống S3Tải một tệp từ bucket AWS S3 về đường dẫn máy
Liệt kê đối tượng S3Liệt kê các đối tượng trong bucket AWS S3 với bộ lọc tiền tố tùy chọn
Tải lên S3Tải một tệp từ máy lên bucket AWS S3
Tải xuống AWS S3Tải tệp từ bucket AWS S3
Tải lên AWS S3Tải tệp hoặc dữ liệu lên bucket AWS S3
Tải xuống AzureTải tệp từ Azure Blob Storage
Tải lên AzureTải tệp lên Azure Blob Storage
Tải xuống GCSTải tệp từ Google Cloud Storage
Tải lên GCSTải tệp lên Google Cloud Storage
Tạo sự kiện LịchTạo sự kiện mới trong Google Calendar
Danh sách sự kiện LịchLiệt kê sự kiện sắp tới từ Google Calendar
Tìm kiếm GmailTìm kiếm tin nhắn Gmail bằng cú pháp tìm kiếm Gmail
Gửi GmailGửi email qua Gmail API

Modules

Xóa đối tượng S3

aws.s3.delete

Xóa một đối tượng khỏi bucket AWS S3

Parameters:

NameTypeRequiredDefaultDescription
bucketstringYes-S3 bucket name
keystringYes-S3 object key to delete
regionstringNous-east-1AWS region
access_key_idstringNo-AWS access key ID (falls back to env AWS_ACCESS_KEY_ID)
secret_access_keystringNo-AWS secret access key (falls back to env AWS_SECRET_ACCESS_KEY)

Output:

FieldTypeDescription
bucketstringTên bucket S3
keystringKhóa đối tượng đã xóa
deletedbooleanĐối tượng đã được xóa thành công hay chưa

Example: Delete an object

yaml
bucket: my-bucket
key: uploads/old-file.txt

Tải xuống S3

aws.s3.download

Tải một tệp từ bucket AWS S3 về đường dẫn máy

Parameters:

NameTypeRequiredDefaultDescription
bucketstringYes-S3 bucket name
keystringYes-S3 object key (path in bucket)
output_pathstringYes-Local file path to save the downloaded file
regionstringNous-east-1AWS region
access_key_idstringNo-AWS access key ID (falls back to env AWS_ACCESS_KEY_ID)
secret_access_keystringNo-AWS secret access key (falls back to env AWS_SECRET_ACCESS_KEY)

Output:

FieldTypeDescription
pathstringĐường dẫn tệp trên máy nơi tệp được lưu
sizenumberKích thước tệp tính bằng byte
content_typestringLoại MIME của tệp đã tải xuống

Example: Download a file from S3

yaml
bucket: my-bucket
key: data/report.csv
output_path: /tmp/report.csv

Liệt kê đối tượng S3

aws.s3.list

Liệt kê các đối tượng trong bucket AWS S3 với bộ lọc tiền tố tùy chọn

Parameters:

NameTypeRequiredDefaultDescription
bucketstringYes-S3 bucket name
prefixstringNo-Filter objects by key prefix (e.g. "uploads/")
max_keysnumberNo100Maximum number of objects to return
regionstringNous-east-1AWS region
access_key_idstringNo-AWS access key ID (falls back to env AWS_ACCESS_KEY_ID)
secret_access_keystringNo-AWS secret access key (falls back to env AWS_SECRET_ACCESS_KEY)

Output:

FieldTypeDescription
objectsarrayDanh sách các đối tượng S3
countnumberSố lượng đối tượng trả về
truncatedbooleanKết quả có bị cắt ngắn hay không

Example: List objects with prefix

yaml
bucket: my-bucket
prefix: uploads/
max_keys: 50

Tải lên S3

aws.s3.upload

Tải một tệp từ máy lên bucket AWS S3

Parameters:

NameTypeRequiredDefaultDescription
bucketstringYes-S3 bucket name
keystringYes-S3 object key (path in bucket)
file_pathstringYes-Local file path to upload
regionstringNous-east-1AWS region
access_key_idstringNo-AWS access key ID (falls back to env AWS_ACCESS_KEY_ID)
secret_access_keystringNo-AWS secret access key (falls back to env AWS_SECRET_ACCESS_KEY)
content_typestringNo-MIME type of the file (auto-detected if not set)

Output:

FieldTypeDescription
bucketstringTên bucket S3
keystringKhóa đối tượng S3
urlstringURL công khai của đối tượng đã tải lên
sizenumberKích thước tệp tính bằng byte

Example: Upload a local file

yaml
bucket: my-bucket
key: data/report.csv
file_path: /tmp/report.csv

Tải xuống AWS S3

cloud.aws_s3.download

Tải tệp từ bucket AWS S3

Parameters:

NameTypeRequiredDefaultDescription
aws_access_key_idstringNo-AWS access key ID (mặc định là env.AWS_ACCESS_KEY_ID)
aws_secret_access_keystringNo-AWS secret access key (mặc định là env.AWS_SECRET_ACCESS_KEY)
regionstringNous-east-1Vùng AWS (mặc định là env.AWS_REGION hoặc us-east-1)
bucketstringYes-Tên bucket S3
keystringYes-Tên bucket S3
file_pathstringNo-Khóa đối tượng S3 (đường dẫn tệp trong bucket)

Output:

FieldTypeDescription
contentstringFile content (if file_path not provided)
file_pathstringPath where file was saved (if file_path provided)
sizenumberFile size in bytes
content_typestringMIME type of the file

Example: Download to memory

yaml
bucket: my-bucket
key: data/config.json

Example: Download to file

yaml
bucket: my-bucket
key: backups/database.sql
file_path: /tmp/downloaded.sql

Tải lên AWS S3

cloud.aws_s3.upload

Tải tệp hoặc dữ liệu lên bucket AWS S3

Parameters:

NameTypeRequiredDefaultDescription
aws_access_key_idstringNo-AWS access key ID (mặc định là env.AWS_ACCESS_KEY_ID)
aws_secret_access_keystringNo-AWS secret access key (mặc định là env.AWS_SECRET_ACCESS_KEY)
regionstringNous-east-1Vùng AWS (mặc định là env.AWS_REGION hoặc us-east-1)
bucketstringYes-Tên bucket S3
keystringYes-Tên bucket S3
file_pathstringNo-Khóa đối tượng S3 (đường dẫn tệp trong bucket)
contentstringNo-Đường dẫn tệp cục bộ để tải lên
content_typestringNo-Loại MIME của tệp
aclstringNoprivateLoại MIME của tệp

Output:

FieldTypeDescription
urlstringURL S3 của đối tượng đã tải lên
bucketstringURL S3 của đối tượng đã tải lên
keystringURL S3 của đối tượng đã tải lên
etagstringTên bucket

Example: Upload text content

yaml
bucket: my-bucket
key: reports/daily-${timestamp}.txt
content: ${report_text}
content_type: text/plain

Example: Upload local file

yaml
bucket: my-bucket
key: backups/database.sql
file_path: /tmp/backup.sql
acl: private

Tải xuống Azure

cloud.azure.download

Tải tệp từ Azure Blob Storage

Parameters:

NameTypeRequiredDefaultDescription
connection_stringstringNo-Chuỗi kết nối Azure Storage (sử dụng biến env AZURE_STORAGE_CONNECTION_STRING)
containerstringYes-Chuỗi kết nối Azure Storage (sử dụng biến env AZURE_STORAGE_CONNECTION_STRING)
blob_namestringYes-Tên container Azure
destination_pathstringYes-Blob cần tải xuống

Output:

FieldTypeDescription
file_pathstringThe file path
sizenumberSize in bytes
containerstringThe container
blob_namestringThe blob name

Example: Download backup

yaml
container: backups
blob_name: data/backup-2024.zip
destination_path: /tmp/backup.zip

Example: Download image

yaml
container: images
blob_name: photos/vacation.jpg
destination_path: /tmp/photo.jpg

Tải lên Azure

cloud.azure.upload

Tải tệp lên Azure Blob Storage

Parameters:

NameTypeRequiredDefaultDescription
file_pathstringYes-Đường dẫn tệp cục bộ để tải lên
connection_stringstringNo-Đường dẫn tệp cục bộ để tải lên
containerstringYes-Chuỗi kết nối Azure Storage (sử dụng biến env AZURE_STORAGE_CONNECTION_STRING)
blob_namestringNo-Tên container Azure
content_typestringNo-Tên cho blob đã tải lên (mặc định: tên tệp)

Output:

FieldTypeDescription
urlstringLoại MIME (tùy chọn)
containerstringLoại MIME (tùy chọn)
blob_namestringĐịa chỉ URL
sizenumberContainer

Example: Upload image

yaml
file_path: /tmp/screenshot.png
container: images
blob_name: screenshots/2024/screenshot.png
content_type: image/png

Example: Upload document

yaml
file_path: /tmp/report.pdf
container: documents
blob_name: reports/monthly.pdf

Tải xuống GCS

cloud.gcs.download

Tải tệp từ Google Cloud Storage

Parameters:

NameTypeRequiredDefaultDescription
bucketstringYes-Tên bucket GCS
object_namestringYes-Tên bucket GCS
destination_pathstringYes-Đối tượng cần tải xuống

Output:

FieldTypeDescription
file_pathstringThe file path
sizenumberSize in bytes
bucketstringStorage bucket name
object_namestringObject name in storage

Example: Download backup

yaml
bucket: my-backups
object_name: data/backup-2024.zip
destination_path: /tmp/backup.zip

Example: Download image

yaml
bucket: image-storage
object_name: photos/vacation.jpg
destination_path: /tmp/photo.jpg

Tải lên GCS

cloud.gcs.upload

Tải tệp lên Google Cloud Storage

Parameters:

NameTypeRequiredDefaultDescription
file_pathstringYes-Đường dẫn tệp cục bộ để tải lên
bucketstringYes-Đường dẫn tệp cục bộ để tải lên
object_namestringNo-Tên bucket GCS
content_typestringNo-Tên cho đối tượng đã tải lên (mặc định: tên tệp)
publicbooleanNoFalseLoại MIME (tùy chọn)

Output:

FieldTypeDescription
urlstringLàm cho tệp có thể truy cập công khai
bucketstringLàm cho tệp có thể truy cập công khai
object_namestringĐịa chỉ URL
sizenumberTên bucket lưu trữ
public_urlstringTên đối tượng trong lưu trữ

Example: Upload image

yaml
file_path: /tmp/screenshot.png
bucket: my-bucket
object_name: screenshots/2024/screenshot.png
content_type: image/png
public: true

Example: Upload CSV data

yaml
file_path: /tmp/report.csv
bucket: data-backup
object_name: reports/daily.csv

Tạo sự kiện Lịch

google.calendar.create_event

Tạo sự kiện mới trong Google Calendar

Parameters:

NameTypeRequiredDefaultDescription
access_tokenstringYes-Google OAuth2 access token with Calendar write scope
summarystringYes-Title of the calendar event
start_timestringYes-Event start time in ISO 8601 format
end_timestringYes-Event end time in ISO 8601 format
descriptionstringNo-Detailed description of the event
locationstringNo-Event location or meeting link
attendeesstringNo-Comma-separated list of attendee email addresses
timezonestringNoUTCTimezone for the event (IANA timezone)

Output:

FieldTypeDescription
event_idstringID sự kiện đã tạo
summarystringTiêu đề sự kiện
startstringThời gian bắt đầu sự kiện
endstringThời gian kết thúc sự kiện
html_linkstringLiên kết để xem sự kiện trong Google Calendar

Example: Create a meeting event

yaml
access_token: <oauth2-token>
summary: Sprint Planning
start_time: 2026-03-01T10:00:00
end_time: 2026-03-01T11:00:00
attendees: alice@example.com, bob@example.com
timezone: America/New_York

Danh sách sự kiện Lịch

google.calendar.list_events

Liệt kê sự kiện sắp tới từ Google Calendar

Parameters:

NameTypeRequiredDefaultDescription
access_tokenstringYes-Google OAuth2 access token with Calendar read scope
max_resultsnumberNo10Maximum number of events to return
time_minstringNo-Only return events starting after this time (ISO 8601). Defaults to now.
time_maxstringNo-Only return events starting before this time (ISO 8601)

Output:

FieldTypeDescription
eventsarrayDanh sách sự kiện lịch
countnumberSố lượng sự kiện trả về

Example: List next 5 events

yaml
access_token: <oauth2-token>
max_results: 5

Tìm kiếm Gmail

google.gmail.search

Tìm kiếm tin nhắn Gmail bằng cú pháp tìm kiếm Gmail

Parameters:

NameTypeRequiredDefaultDescription
access_tokenstringYes-Google OAuth2 access token with Gmail read scope
querystringYes-Gmail search query (e.g. "from:user@example.com subject:invoice")
max_resultsnumberNo10Maximum number of messages to return

Output:

FieldTypeDescription
messagesarrayDanh sách tin nhắn phù hợp
totalnumberTổng số tin nhắn trả về

Example: Search for emails from a specific sender

yaml
access_token: <oauth2-token>
query: from:boss@company.com is:unread
max_results: 5

Gửi Gmail

google.gmail.send

Gửi email qua Gmail API

Parameters:

NameTypeRequiredDefaultDescription
access_tokenstringYes-Google OAuth2 access token with Gmail send scope
tostringYes-Recipient email address
subjectstringYes-Email subject line
bodystringYes-Email body content
htmlbooleanNoFalseWhether the body is HTML content
ccstringNo-CC email address(es), comma-separated
bccstringNo-BCC email address(es), comma-separated

Output:

FieldTypeDescription
message_idstringID tin nhắn Gmail
thread_idstringID chuỗi Gmail
tostringĐịa chỉ email người nhận

Example: Send a plain text email

yaml
access_token: <oauth2-token>
to: user@example.com
subject: Test Email
body: Hello, this is a test email.

Released under the Apache 2.0 License.