Skip to main content

Object Storage Troubleshooting

This document explains how to troubleshoot issues related to the Object Storage service.


Pre-check items

Before using Object Storage or when troubleshooting issues, check the following items:

Permission management

All buckets in Object Storage are managed via IAM roles and permissions. Using this system, specific permissions can be granted to users or groups. Note that certain bucket operations (such as bucket creation, object access, or permission assignment) may be restricted based on the assigned role. For more details, see Role and permission.

Public access settings for buckets

You can configure whether a bucket allows public access. When public access is enabled, users without permissions can access the bucket. Please proceed with caution. For detailed steps, refer to Configure bucket access settings.


Object upload and download failure

Errors can occur when uploading files to a bucket. These typically happen when the proper permissions are not granted.

Since Object Storage requires role and permission configuration, it is important to check [Permissions] > [Roles] in the target bucket and verify that the required role is granted.

▶️ Solution: Check the bucket permission settings to ensure the role is properly assigned. Add the necessary role and try again. See Role and permission for more information.


Log storage management

Storing Cloud Trail event logs in a bucket may fail if the log storage account is not part of the project or lacks IAM permissions.

To store Cloud Trail logs properly, the log account must be granted the Trail viewer, Organization owner, or Organization admin role.

▶️ Solution: Ensure the log storage account is part of the project and assign the necessary IAM roles before trying again.

info

Even when Object Storage public access is set to Block, Cloud Trail event logs will still be stored.


Credential error

KakaoCloud Object Storage APIs are compatible with S3 APIs and can be used in code-based environments. However, the authentication token issuance methods differ between the two APIs, and attention is required.

▶️ Solution: Use the appropriate API authentication token for your environment. For more information, refer to the following guides: