From 729652454fe690ff0d3f0b5c0e34fd25e5b2da21 Mon Sep 17 00:00:00 2001 From: Cathy Ouyang Date: Mon, 8 Apr 2024 14:40:50 -0700 Subject: [PATCH 1/2] docs: reference Storage Control in readme --- README.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/README.rst b/README.rst index 61b5a62eb..c0599118d 100644 --- a/README.rst +++ b/README.rst @@ -14,6 +14,12 @@ A comprehensive list of changes in each version may be found in the `CHANGELOG`_ - `Client Library Documentation`_ - `github.com/googleapis/python-storage`_ +Certain control plane and long-running operations for Cloud Storage (including Folder +and Managed Folder operations) are supported via the `Storage Control Client`_. +The `Storage Control API`_ creates one space to perform metadata-specific, control plane, +and long-running operations apart from the Storage API. Separating these operations from +the Storage API improves API standardization and lets you run faster releases. + Read more about the client libraries for Cloud APIs, including the older Google APIs Client Libraries, in `Client Libraries Explained`_. @@ -28,6 +34,8 @@ Google APIs Client Libraries, in `Client Libraries Explained`_. .. _Product Documentation: https://cloud.google.com/storage .. _CHANGELOG: https://github.com/googleapis/python-storage/blob/main/CHANGELOG.md .. _github.com/googleapis/python-storage: https://github.com/googleapis/python-storage +.. _Storage Control Client: https://cloud.google.com/python/docs/reference/google-cloud-storage-control/latest +.. _Storage Control API: https://cloud.google.com/storage/docs/reference/rpc/google.storage.control.v2 .. _Client Libraries Explained: https://cloud.google.com/apis/docs/client-libraries-explained Quick Start From 1cfb286b56cb6c8e70af53aee443b74659e1ac41 Mon Sep 17 00:00:00 2001 From: Cathy Ouyang Date: Mon, 15 Apr 2024 16:46:04 -0700 Subject: [PATCH 2/2] review comment --- README.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/README.rst b/README.rst index c0599118d..9eef57645 100644 --- a/README.rst +++ b/README.rst @@ -17,8 +17,7 @@ A comprehensive list of changes in each version may be found in the `CHANGELOG`_ Certain control plane and long-running operations for Cloud Storage (including Folder and Managed Folder operations) are supported via the `Storage Control Client`_. The `Storage Control API`_ creates one space to perform metadata-specific, control plane, -and long-running operations apart from the Storage API. Separating these operations from -the Storage API improves API standardization and lets you run faster releases. +and long-running operations apart from the Storage API. Read more about the client libraries for Cloud APIs, including the older Google APIs Client Libraries, in `Client Libraries Explained`_.