Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Samples(Storage): Add sample and test for ListBuckets With Partial Success#3279

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to ourterms of service andprivacy statement. We’ll occasionally send you account related emails.

Already on GitHub?Sign in to your account

Draft
mahendra-google wants to merge1 commit intoGoogleCloudPlatform:main
base:main
Choose a base branch
Loading
frommahendra-google:list-bucket-partials-support

Conversation

@mahendra-google
Copy link
Contributor

@mahendra-googlemahendra-google commentedDec 9, 2025
edited
Loading

This PR adds a new code sample and test for theListBucketsoperation using theReturnPartialSuccess parameter inListBucketOptions.

TheReturnPartialSuccess flag allows the API to return a list of buckets even if specific regions are temporarily unavailable, rather than failing the entire request. This sample demonstrates how to consume the resulting Reachable and Unreachable collections. Please seeb/459649174.Note: - PR will be marked as ready to review onceGoogle.Cloud.Storage.V1 new package is released.

@snippet-bot
Copy link

Here is the summary of changes.

You are about to add 1 region tag.

This comment is generated bysnippet-bot.
If you find problems with this result, please file an issue at:
https://github.com/googleapis/repo-automation-bots/issues.
To update this comment, addsnippet-bot:force-run label or use the checkbox below:

  • Refresh this comment

@product-auto-labelproduct-auto-labelbot added api: storageIssues related to the Cloud Storage API. samplesIssues that are directly related to samples. labelsDec 9, 2025
@gemini-code-assist
Copy link

Summary of Changes

Hello@mahendra-google, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request introduces a new C# code sample and an accompanying test for the Google Cloud Storage client library. The sample demonstrates how to effectively use theListBuckets operation with theReturnPartialSuccess parameter, enabling the API to return available bucket information even when certain regions are temporarily inaccessible. This feature significantly improves the resilience of bucket listing by providing partial results rather than a complete failure, and the sample illustrates how to process both reachable and unreachable bucket collections.

Highlights

  • New Sample Added: Introduced a new C# sample for theListBuckets operation utilizing theReturnPartialSuccess option.
  • New Test Case: Implemented a corresponding XUnit test to validate the functionality of the newListBucketsWithPartialSuccess sample.
  • Dependency Update: Updated theGoogle.Cloud.Storage.V1 NuGet package to version4.14.0.
  • Test Fixture Enhancement: Enhanced theStorageFixture.CreateBucket method to allow specifying astorageClass for bucket creation, supporting test scenarios.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on ourdocumentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either/gemini <command> or@gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

FeatureCommandDescription
Code Review/gemini reviewPerforms a code review for the current pull request in its current state.
Pull Request Summary/gemini summaryProvides a summary of the current pull request in its current state.
Comment@gemini-code-assistResponds in comments when explicitly tagged, both in pull request comments and review comments.
Help/gemini helpDisplays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a.gemini/ folder in the base of the repository. Detailed instructions can be foundhere.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on@gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign uphere.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with theGemini Code Assist IDE Extension.

Footnotes

  1. Review thePrivacy Notices,Generative AI Prohibited Use Policy,Terms of Service, and learn how to configure Gemini Code Assist in GitHubhere. Gemini can make mistakes, so double check it anduse code with caution.

Copy link

@gemini-code-assistgemini-code-assistbot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

Code Review

This pull request introduces a new code sample and corresponding test for listing buckets with partial success enabled. The changes are well-implemented, and the test correctly verifies the functionality while avoiding flakiness. I have one suggestion to improve the clarity and robustness of the new sample code by removing an optional parameter that could lead to unhandled exceptions.

Comment on lines +33 to +40
public (IReadOnlyList<Bucket> Reachable, IReadOnlyList<string> Unreachable) ListBucketsWithPartialSuccess
(string projectId = "your-project-id", bool returnPartialSuccess = true)
{
var storage = StorageClient.Create();
var pagedResult = storage.ListBuckets(projectId, options: new ListBucketsOptions
{
ReturnPartialSuccess = returnPartialSuccess
});

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

medium

The method is namedListBucketsWithPartialSuccess, which strongly implies that theReturnPartialSuccess option is always enabled. Exposing areturnPartialSuccess parameter to disable this feature can be confusing for users of this sample.

Furthermore, if this method is called withreturnPartialSuccess: false and some storage locations are unreachable, thestorage.ListBuckets call will throw an exception. Since this sample doesn't include error handling for that scenario, it could lead to an unexpected crash.

To make the sample more focused, clear, and robust, I suggest removing thereturnPartialSuccess parameter and hardcoding the option totrue.

Please also remove the corresponding<param name="returnPartialSuccess"> documentation block from lines 30-32.

public(IReadOnlyList<Bucket>Reachable,IReadOnlyList<string>Unreachable)ListBucketsWithPartialSuccess(stringprojectId="your-project-id"){varstorage=StorageClient.Create();varpagedResult=storage.ListBuckets(projectId,options:newListBucketsOptions{ReturnPartialSuccess=true});

@mahendra-google
Copy link
ContributorAuthor

mahendra-google commentedDec 9, 2025
edited
Loading

Converting this PR into draft mode as the latest Nuget package forGoogle.Cloud.Storage.V1 is not released yet (containing theReturnPartialSuccess boolean flag inListBucketOptions ). I will make this PR ready to review once the package is released.

@mahendra-googlemahendra-google marked this pull request as draftDecember 9, 2025 09:08
@mahendra-googlemahendra-googleforce-pushed thelist-bucket-partials-support branch fromef03f67 to7c0bb19CompareDecember 9, 2025 11:20
@amanda-tarafaamanda-tarafa removed their assignmentDec 9, 2025
Sign up for freeto join this conversation on GitHub. Already have an account?Sign in to comment

Reviewers

1 more reviewer

@gemini-code-assistgemini-code-assist[bot]gemini-code-assist[bot] left review comments

Reviewers whose approvals may not affect merge requirements

At least 1 approving review is required to merge this pull request.

Assignees

@BrennaEppBrennaEpp

Labels

api: storageIssues related to the Cloud Storage API.samplesIssues that are directly related to samples.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@mahendra-google@amanda-tarafa@BrennaEpp

[8]ページ先頭

©2009-2025 Movatter.jp