Skip to content

Getting Started with Object Storage (S3)

This guide provides the essential information to connect to your S3-compatible object storage bucket. The service uses the widely adopted S3 API, so this guide focuses on the specific connection details rather than the API itself.

Getting Access

Access to the Object Storage service, including the creation of new buckets and user credentials, is currently managed by us. There is no self-service for these actions.

To get started, please contact us with your requirements. We will work with you to:

  1. Create a Bucket: We will create a dedicated bucket for your needs.
  2. Provision Credentials: We will provide you with an Access Key ID and a Secret Access Key.

Secure Your Credentials

Your Secret Access Key is confidential and should be treated like a password. Store it securely and never expose it in client-side code or commit it to your Git repositories.

Connecting to Your Bucket

You can interact with the Object Storage service using any S3-compatible tool or SDK, such as the AWS CLI, boto3 (for Python), or the AWS SDK for Go.

The key is to configure your client to use our specific S3 endpoint.

  • Endpoint URL: Provided to you by us.

AWS CLI Configuration Example

The AWS Command Line Interface (aws-cli) is a common tool for interacting with S3-compatible storage. You can configure it by running aws configure or by editing the configuration files directly.

  1. Create a dedicated profile in ~/.aws/credentials:

    [contain-s3]
aws_access_key_id = YOUR_ACCESS_KEY_ID
aws_secret_access_key = YOUR_SECRET_ACCESS_KEY

  2. List objects in your bucket to verify the connection. Use the --endpoint-url flag to point the client to our service and the --profile flag to use your new credentials.

    aws s3 ls s3://your-bucket-name/ --endpoint-url https://s3.netic.dk --profile netic-s3

Next Steps

You are now ready to use your S3 bucket. Since our service is S3-compatible, you can refer to the extensive documentation available for the S3 API for information on how to perform operations like uploading, downloading, and deleting objects.