Skip to main content

Object Storage Troubleshooting

This document provides solutions for common issues related to the Object Storage service.

Pre-Check Items​

Before using the Object Storage service, please check the following items to resolve potential issues.

Permission Management​

All buckets in Object Storage can be managed with permissions and roles through IAM. This allows you to grant appropriate permissions to specific users or groups. Certain actions on buckets (such as bucket creation, object retrieval, and granting permissions) may be restricted based on the role. For detailed information on Object Storage permissions and roles, please refer to the Permission Management document.

Public Access Settings for Buckets​

You can configure whether a bucket allows public access. When public access is enabled, external users without access permissions can access the bucket, so exercise caution. For more details, refer to the Bucket Access Settings document.

Object Upload and Download Failure​

An error may occur when uploading files to a bucket, causing the upload to fail. This often happens if the appropriate permissions have not been granted.

Since permissions and roles must be managed for Object Storage buckets, ensure the required permissions are granted by checking [Permissions] > [Roles] in the bucket settings.

▶️ Solution: Verify that the correct roles have been assigned in the bucket's permission settings, add any necessary permissions, and try again. For detailed information on Object Storage permissions and roles, refer to the Permission Management document.

Log Storage Management​

When storing Cloud Trail event logs in a bucket, the process may fail. This issue can occur if the account used for log storage is not part of the project or lacks sufficient IAM permissions.

To ensure Cloud Trail event logs are saved successfully, the log storage account must have Trail Viewer, Organization Owner, or Organization Manager permissions.

▶️ Solution: Check that the log storage account is part of the project, assign the necessary IAM permissions, and try again.

info

Even if public access to Object Storage is restricted to "Blocked," Cloud Trail event logs can still be stored.

Credential Error​

KakaoCloud's Object Storage API allows you to manage resources programmatically and is compatible with the S3 API. Note that the method of issuing authentication tokens for the two APIs may differ.

▶️ Solution: Obtain an API authentication token that suits your environment. For more details on how to issue an authentication token, refer to the following documents: