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.
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: