GoogleCloudPlatform / GoogleCloudPlatform/gsutil

Feature Request: Document Cloud Storage doesn't validate the existence of logging_bucket in gsutil logging set on command

Open
#1,295 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
918
Forks
335
PR merge metrics
No merged PRs in 30d

Description

https://github.com/GoogleCloudPlatform/gsutil/blob/master/gslib/commands/logging.py#L57

From:

```
logging_bucket must already exist, and all URLs must name
buckets (e.g., gs://bucket).
```

to:

```
Cloud Storage doesn't validate the existence of logging_bucket so users should ensure it already exists, and all URLs must name buckets (e.g., gs://bucket).
```

Contributor guide

Open the contributing guide

Research direction

Start at gslib/commands/logging.py around line 57, where the logging_bucket guidance is documented. Update the wording to explain that Cloud Storage does not validate the bucket's existence and that users should ensure it exists, while preserving the URL requirement. Done means the command documentation matches the requested text.

Written by the indexing model from the issue text.

Assessment

Tech stack
google-cloud, python
Domain
cli, documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.