How to Update S3 Bucket?

This tutorial provides step-by-step instructions for Akinon Cloud Service users to update product images in Amazon Web Services (AWS) S3 storage service. Whether users prefer using the AWS console or AWS CLI, this guide will walk you through the process. It is an essential resource for Akinon customers seeking to leverage AWS S3 services.

Requirements

Before getting started, make sure the following credentials are provided by Akinon:

S3 Bucket Name
Secret Key
Access Key

Here's how these credentials can be obtained:

If the Akinon Integrator for Image S3 Integration is being utilized, the credentials will be provided within the ImageS3 Integration flow that has been created.
For other image integrations, please be advised to reach out to the Akinon team for the credentials. Akinon team will provide you with the necessary credentials for your S3 bucket.

File Format

The file format for uploading images should include the SKU or base_code of a product as reflected in the Akinon OmniPlatform.

After selecting either the SKU or base_code, it is imperative to consistently maintain the same format, with the file extension being .jpg or .jpeg.

Format: {SKU}_{sequence_no}.{file_type}

Example: 123123_1.jpg / AB123123_3.jpg

Similar to FTP, S3 is a versatile cloud storage platform capable of handling various file types. For further details, more information can be found on the website of the service.

Working Logic

The system operates by uploading and processing photos that have been transferred after the last import date. For example, if the system uploaded photos to S3 on a specific date, the task will only process photos uploaded after that date.

If the Akinon Integrator for Image S3 Integration is being used, the running time of tasks can be configured based on flow activity settings.

If the Akinon Integrator for Image S3 integration is not used, the running time of tasks can be determined according to the working hours of the companies.

Key Points

Here are some important points to be considered:

Pictures will be automatically deleted after 2 weeks from the upload date.
To change the order of photos, all photos for each SKU or base_code in your last upload must be re-uploaded.
When uploading a new image for a product that has been previously uploaded, it's necessary to include the old images along with the new ones.The "Last Modified" property of photos on OmniPlatform is managed by Akinon. As a result, if the previously added photo becomes visible on S3, the photos need to be rewritten or overwritten.
Images should be uploaded individually to the S3 bucket, not within a file.

Connecting to Servers

Any application supporting the S3 service can be used. The following steps outline how to connect to your application folder and list the files within it:

If product photos have been sent before, they can be listed without interfering with the uploading process.
If no photos have been sent yet, S3 bucket will remain empty.
In case there is a large number of files, the list may take some time to load, depending on the internet speed.

For Windows (S3 Browser)

Step 1

When the app is run, user will be prompted to provide the account details:

Account name: An account name can be entered, reflecting the purpose of this account. (For example: "Akinon Product Photo Uploading")
Account type: Amazon S3 Storage
Access Key ID, Secret Access Key: The access_key_id and secret_access_key are provided by Akinon. After providing this information, click Add new account.

Step 2

Due to limited authority, the list of buckets might not be displayed. The app will request you to adjust this manually. To do so, accept this request, type the bucket name and prefix values provided by Akinon, putting a "/" character between the two, and then click Add External Bucket. In some cases, there might not be a bucket prefix; in that case, typing only the bucket name without the trailing "/" character will be sufficient.

For macOS (Cyberduck)

Step 1

Add a new bookmark with the [+] button in the bookmarks tab of the application:

Fill the Access Key ID and Secret Access Key fields with the information provided by Akinon. Additionally, under the "More Options" expandable area, fill the Path field with the bucket name and prefix value separated by a "/" character. In some cases where there is no bucket prefix, simply type the bucket name without the trailing "/" character.

Step 2

When the created bookmark is double-clicked, the bucket will be available for uploading and downloading files.

PreviousIntegrator NextHow to Manage Users in Integrator?

Last updated 16 days ago

Was this helpful?

How to Update S3 Bucket?

Requirements

Before getting started, make sure the following credentials are provided by Akinon:

S3 Bucket Name
Secret Key
Access Key

Here's how these credentials can be obtained:

If the Akinon Integrator for Image S3 Integration is being utilized, the credentials will be provided within the ImageS3 Integration flow that has been created.
For other image integrations, please be advised to reach out to the Akinon team for the credentials. Akinon team will provide you with the necessary credentials for your S3 bucket.

File Format

The file format for uploading images should include the SKU or base_code of a product as reflected in the Akinon OmniPlatform.

After selecting either the SKU or base_code, it is imperative to consistently maintain the same format, with the file extension being .jpg or .jpeg.

Format: {SKU}_{sequence_no}.{file_type}

Example: 123123_1.jpg / AB123123_3.jpg

Similar to FTP, S3 is a versatile cloud storage platform capable of handling various file types. For further details, more information can be found on the website of the service.

Working Logic

If the Akinon Integrator for Image S3 Integration is being used, the running time of tasks can be configured based on flow activity settings.

If the Akinon Integrator for Image S3 integration is not used, the running time of tasks can be determined according to the working hours of the companies.

Key Points

Here are some important points to be considered:

Pictures will be automatically deleted after 2 weeks from the upload date.
To change the order of photos, all photos for each SKU or base_code in your last upload must be re-uploaded.
When uploading a new image for a product that has been previously uploaded, it's necessary to include the old images along with the new ones.The "Last Modified" property of photos on OmniPlatform is managed by Akinon. As a result, if the previously added photo becomes visible on S3, the photos need to be rewritten or overwritten.
Images should be uploaded individually to the S3 bucket, not within a file.

Connecting to Servers

Any application supporting the S3 service can be used. The following steps outline how to connect to your application folder and list the files within it:

If product photos have been sent before, they can be listed without interfering with the uploading process.
If no photos have been sent yet, S3 bucket will remain empty.
In case there is a large number of files, the list may take some time to load, depending on the internet speed.

For Windows (S3 Browser)

Step 1

When the app is run, user will be prompted to provide the account details:

Account name: An account name can be entered, reflecting the purpose of this account. (For example: "Akinon Product Photo Uploading")
Account type: Amazon S3 Storage
Access Key ID, Secret Access Key: The access_key_id and secret_access_key are provided by Akinon. After providing this information, click Add new account.