s3

Kubemq s3 target Connector

Kubemq aws-s3 target connector allows services using kubemq server to access aws s3 service.

Prerequisites

The following required to run the aws-s3 target connector:

• kubemq cluster
• aws account with s3 active service
• kubemq-targets deployment

Configuration

s3 target connector configuration properties:

Example:

bindings:
  - name: kubemq-query-aws-s3
    source:
      kind: kubemq.query
      name: kubemq-query
      properties:
        address: "kubemq-cluster:50000"
        client_id: "kubemq-query-aws-s3-connector"
        auth_token: ""
        channel: "query.aws.s3"
        group:   ""
        auto_reconnect: "true"
        reconnect_interval_seconds: "1"
        max_reconnects: "0"
    target:
      kind: aws.s3
      name: aws-s3
      properties:
        aws_key: "id"
        aws_secret_key: 'json'
        region:  "region"
        token: ""

Usage

List Buckets

list all buckets.

List Buckets:

Example:

{
  "metadata": {
    "method": "list_buckets"
  },
  "data": null
}

List Bucket Items

list all items in the selected bucket

List Bucket Items:

Example:

{
  "metadata": {
    "method": "list_bucket_items",
    "bucket_name": "my_bucket_name"
  },
  "data": null
}

Create Bucket

create a new bucket, name must be unique

Create Bucket :

Example:

{
  "metadata": {
    "method": "create_bucket",
    "bucket_name": "my_bucket_name"
  },
  "data": null
}

Upload Item

upload item to bucket.

Upload Bucket Items:

Example:

{
  "metadata": {
    "method": "upload_item",
    "bucket_name": "my_bucket_name",
    "item_name": "my_item_name"
  },
  "data": "bXkgaXRlbSBoZXJl"
}

Get Item

Get item by item name from bucket

Get Bucket Items:

Example:

{
  "metadata": {
    "method": "get_item",
    "bucket_name": "my_bucket_name",
    "item_name": "my_item_name"
  },
  "data": null
}

Delete Item

delete item by item name from bucket

Delete Item:

Example:

{
  "metadata": {
    "method": "delete_item_from_bucket",
    "bucket_name": "my_bucket_name",
    "item_name": "my_item_name"
  },
  "data": null
}

Delete All Items

delete all items from a bucket

Delete All Items:

Example:

{
  "metadata": {
    "method": "delete_item_from_bucket",
    "bucket_name": "my_bucket_name"
  },
  "data": null
}

Copy Item

copy an item from one bucket to another

Copy Items:

Example:

{
  "metadata": {
    "method": "copy_item",
    "bucket_name": "my_bucket_name",
    "copy_source": "my_bucket_source_name",
    "item_name": "my_item_name"
  },
  "data": null
}

Delete Bucket

delete a bucket by name.

Delete Bucket:

Example:

{
  "metadata": {
    "method": "delete_bucket",
    "bucket_name": "my_bucket_name"
  },
  "data": null
}