Skip to main content

S3 Protocol

Checks if S3 compatible endpoints (like Minio, EMC ECS) are functioning correctly,

info

To check the contents of a S3 bucket use: S3 Bucket

The S3 check:

  • Lists objects in the bucket to check for Read permissions
  • Puts an object into the bucket for Write permissions
  • Downloads previously uploaded object to check for Get permissions
s3-protocol
apiVersion: canaries.flanksource.com/v1
kind: Canary
metadata:
name: s3-protocol-check
spec:
interval: 30
s3:
- name: s3-check
bucketName: flanksource-public
objectPath: dummy
region: us-east-1
accessKey:
valueFrom:
secretKeyRef:
name: aws-credentials
key: AWS_ACCESS_KEY_ID
secretKey:
valueFrom:
secretKeyRef:
name: aws-credentials
key: AWS_SECRET_ACCESS_KEY
FieldDescriptionScheme
bucket*

Bucket name to test against

string

name*

Name of the check, must be unique within the canary

string

objectPath*

Path of object to upload/download for test

string

description

Description for the check

string

display

Expression to change the formatting of the display

Expression

icon

Icon for overwriting default icon on the dashboard

Icon

labels

Labels for check

map[string]string

metrics

Metrics to export from

[]Metrics

test

Evaluate whether a check is healthy

Expression

transform

Transform data from a check into multiple individual checks

Expression

accessKey

EnvVar

secretKey

EnvVar

region

The AWS region

string

endpoint

Custom AWS Endpoint to use

skipTLSVerify

Skip TLS verify when connecting to AWS

boolean