¶ Description
List the buckets in a Huwaei Blob Storage.
¶ Parameters
¶ Parameters Tab
Parameters:
- Bucket Region
- Access key
- Secret key
- Debug information level
- Optional: extra parameters for cURL
- Number of retries on connection error
¶ Description Tab
Parameters:
- Script name
- Short description
- Revision
- Decription
¶ Configuration Tab
See dedicated page for more information.
¶ About
List all Object Storage Service (OBS) buckets that are accessible with the provided Huawei Cloud credentials. One row is produced per bucket. This action is read-only.
HuaweiOBSListBuckets is the fastest way to inventory your Huawei Cloud OBS buckets directly from a pipeline. Internally, it performs a signed request (AK/SK with HWS Signature algorithm) against the OBS ListBuckets endpoint for the selected region. This means:
- Region matters. Huawei Cloud credentials are scoped to a project/region. If you select the wrong region, you may either see no buckets or receive signature/authorization errors from the API.
- Read-only & safe. The action does not modify or delete buckets. It only enumerates what your IAM policy allows.
- Works behind proxies. If your environment requires outbound HTTP/HTTPS through a proxy, use Optional: extra parameters for cURL to pass cURL options (see the “Advanced / Optional parameters” section below).
- Consistent with your existing setup. It uses the very same credentialing prerequisites as HuaweiOBSListFiles. If you already followed the “First-time setup on Huawei side” described in the HuaweiOBSListFiles documentation (obtain Region, Bucket Name, Access Key, Secret Key), you already have everything needed here.
Typical uses include pre-flight checks (does a bucket exist before attempting writes), governance/finops (enumerate storage containers per region), and environment validation during deployments.
¶ Output
The action returns a dataset with one record per bucket that your credentials can see in the selected region. Columns typically include:
- BucketName – the bucket’s logical name.
- CreationTime – the bucket creation timestamp (when available from the API).
- Region/Location – the bucket’s region (some tenants expose this at the bucket level).
Note: Exact columns can vary depending on tenant/endpoint capabilities. Inspect the Data or Records pane after a run to see the final schema in your environment.
¶ Setup & Prerequisites
You can reuse the exact same steps documented in HuaweiOBSListFiles (“Huawei Blob Storage First Time Setup”) to obtain:
- Region
- Access-Key (AK)
- Secret-Key (SK)
You do not need a Bucket Name for this action because it lists all buckets visible to your credentials in the selected region.
¶ Minimal configuration inside the box
- region: pick the region of your Huawei Cloud project (e.g.,
la-south-2). - access key: paste your Access Key ID.
- secret key: paste your Secret Key.
- (Optional) Debug information level: set to
basicorverboseduring troubleshooting. - (Optional) Optional: extra parameters for cURL: add cURL options such as proxy or timeouts (see below).
- Run the action and check the Data/Records tab for the list of buckets.
¶ Optional parameters
¶ Optional: extra parameters for cURL (extra cURL parameters)
Supply raw cURL options to adapt to your network/security needs. A few common patterns:
- HTTPS proxy:
--proxy https://myproxy.company:8443 - Custom CA bundle:
--cacert /path/to/ca.pem - Connect/overall timeouts:
--connect-timeout 10 --max-time 60 - Verbose HTTP traces (in addition to Debug information level):
-v
Use these with care; they are passed as-is to the HTTP client.
¶ Debug information level
nothing: clean logs (default)basic: request summaries and status codesverbose: full request/response traces (headers), useful for signed request debugging
¶ Number of retries on connection error
For transient network issues, increase retries (e.g., from 5 to 10). This only retries transport failures, not hard authorization errors.
¶ Troubleshooting
-
SignatureDoesNotMatch/InvalidAccessKeyId- Verify region matches your project/endpoint.
- Ensure access key/secret key are correct, active, and belong to the current tenant/project.
-
Empty result set
- The credentials are valid but have no OBS buckets in the chosen region, or IAM permissions lack
ListBucket. Try another region or adjust IAM policy.
- The credentials are valid but have no OBS buckets in the chosen region, or IAM permissions lack
-
403 Forbidden/AccessDenied- The AK/SK exists but does not have OBS List permissions. Ask your Huawei Cloud admin to grant least-privilege access that includes listing buckets.
-
Proxy / TLS errors
- Provide a proxy or CA via Optional: extra parameters for cURL (see examples above), and consider
Debug information level=verboseto inspect the TLS handshake details.
- Provide a proxy or CA via Optional: extra parameters for cURL (see examples above), and consider
-
Intermittent timeouts
- Increase Number of retries on connection error, add
--connect-timeout/--max-timein Optional: extra parameters for cURL, and confirm outbound connectivity to the region’s OBS endpoint.
- Increase Number of retries on connection error, add
¶ Security & Best Practices
- Protect your AK/SK. Treat them like passwords. Store in a secure secret store and reference them through your platform’s secret variables when possible.
- Use least privilege. Grant only the OBS actions needed (read/list) to the AK/SK used by pipelines.
- Rotate keys regularly. Replace and revoke old keys per your organization’s policy.
- Prefer temporary credentials (STS) if your governance model allows it.
¶ Notes & Compatibility
- The action queries the OBS API for the selected region. Some tenants expose global buckets; others are strictly region-scoped. Results depend on your account model.
- Behind corporate networks, outbound 443 to Huawei Cloud endpoints must be allowed.
- This action complements HuaweiOBSListFiles: run ListBuckets to enumerate containers, then feed a chosen BucketName into ListFiles to list objects.
