diff --git a/packages/google-cloud-storage-control/google/cloud/storage_control/gapic_version.py b/packages/google-cloud-storage-control/google/cloud/storage_control/gapic_version.py index 3b0a9d9a8d43..558c8aab67c5 100644 --- a/packages/google-cloud-storage-control/google/cloud/storage_control/gapic_version.py +++ b/packages/google-cloud-storage-control/google/cloud/storage_control/gapic_version.py @@ -13,4 +13,4 @@ # See the License for the specific language governing permissions and # limitations under the License. # -__version__ = "0.1.2" # {x-release-please-version} +__version__ = "0.0.0" # {x-release-please-version} diff --git a/packages/google-cloud-storage-control/google/cloud/storage_control_v2/gapic_version.py b/packages/google-cloud-storage-control/google/cloud/storage_control_v2/gapic_version.py index 3b0a9d9a8d43..558c8aab67c5 100644 --- a/packages/google-cloud-storage-control/google/cloud/storage_control_v2/gapic_version.py +++ b/packages/google-cloud-storage-control/google/cloud/storage_control_v2/gapic_version.py @@ -13,4 +13,4 @@ # See the License for the specific language governing permissions and # limitations under the License. # -__version__ = "0.1.2" # {x-release-please-version} +__version__ = "0.0.0" # {x-release-please-version} diff --git a/packages/google-cloud-storage-control/google/cloud/storage_control_v2/services/storage_control/async_client.py b/packages/google-cloud-storage-control/google/cloud/storage_control_v2/services/storage_control/async_client.py index a4ff62a4c887..dbe5e35f2add 100644 --- a/packages/google-cloud-storage-control/google/cloud/storage_control_v2/services/storage_control/async_client.py +++ b/packages/google-cloud-storage-control/google/cloud/storage_control_v2/services/storage_control/async_client.py @@ -279,7 +279,9 @@ async def create_folder( timeout: Union[float, object] = gapic_v1.method.DEFAULT, metadata: Sequence[Tuple[str, str]] = (), ) -> storage_control.Folder: - r"""Creates a new folder. + r"""Creates a new folder. This operation is only + applicable to a hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in allowlist preview. .. code-block:: python @@ -311,9 +313,15 @@ async def sample_create_folder(): Args: request (Optional[Union[google.cloud.storage_control_v2.types.CreateFolderRequest, dict]]): The request object. Request message for CreateFolder. + This operation is only applicable to a + hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in + allowlist preview. parent (:class:`str`): Required. Name of the bucket in which - the folder will reside. + the folder will reside. The bucket must + be a hierarchical namespace enabled + bucket. This corresponds to the ``parent`` field on the ``request`` instance; if ``request`` is provided, this @@ -346,7 +354,11 @@ async def sample_create_folder(): Returns: google.cloud.storage_control_v2.types.Folder: - A folder. + A folder resource. This resource can + only exist in a hierarchical namespace + enabled bucket. Hierarchical namespace + buckets are in allowlist preview. + """ # Create or coerce a protobuf request object. # Quick check: If we got a request object, we should *not* have @@ -403,7 +415,10 @@ async def delete_folder( timeout: Union[float, object] = gapic_v1.method.DEFAULT, metadata: Sequence[Tuple[str, str]] = (), ) -> None: - r"""Permanently deletes an empty folder. + r"""Permanently deletes an empty folder. This operation + is only applicable to a hierarchical namespace enabled + bucket. Hierarchical namespace buckets are in allowlist + preview. .. code-block:: python @@ -431,6 +446,10 @@ async def sample_delete_folder(): Args: request (Optional[Union[google.cloud.storage_control_v2.types.DeleteFolderRequest, dict]]): The request object. Request message for DeleteFolder. + This operation is only applicable to a + hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in + allowlist preview. name (:class:`str`): Required. Name of the folder. Format: ``projects/{project}/buckets/{bucket}/folders/{folder}`` @@ -492,7 +511,10 @@ async def get_folder( timeout: Union[float, object] = gapic_v1.method.DEFAULT, metadata: Sequence[Tuple[str, str]] = (), ) -> storage_control.Folder: - r"""Returns metadata for the specified folder. + r"""Returns metadata for the specified folder. This + operation is only applicable to a hierarchical namespace + enabled bucket. Hierarchical namespace buckets are in + allowlist preview. .. code-block:: python @@ -522,7 +544,11 @@ async def sample_get_folder(): Args: request (Optional[Union[google.cloud.storage_control_v2.types.GetFolderRequest, dict]]): - The request object. Request message for GetFolder. + The request object. Request message for GetFolder. This + operation is only applicable to a + hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in + allowlist preview. name (:class:`str`): Required. Name of the folder. Format: ``projects/{project}/buckets/{bucket}/folders/{folder}`` @@ -538,7 +564,11 @@ async def sample_get_folder(): Returns: google.cloud.storage_control_v2.types.Folder: - A folder. + A folder resource. This resource can + only exist in a hierarchical namespace + enabled bucket. Hierarchical namespace + buckets are in allowlist preview. + """ # Create or coerce a protobuf request object. # Quick check: If we got a request object, we should *not* have @@ -604,7 +634,9 @@ async def list_folders( timeout: Union[float, object] = gapic_v1.method.DEFAULT, metadata: Sequence[Tuple[str, str]] = (), ) -> pagers.ListFoldersAsyncPager: - r"""Retrieves a list of folders for a given bucket. + r"""Retrieves a list of folders. This operation is only + applicable to a hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in allowlist preview. .. code-block:: python @@ -635,10 +667,15 @@ async def sample_list_folders(): Args: request (Optional[Union[google.cloud.storage_control_v2.types.ListFoldersRequest, dict]]): - The request object. Request message for ListFolders. + The request object. Request message for ListFolders. This + operation is only applicable to a + hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in + allowlist preview. parent (:class:`str`): Required. Name of the bucket in which - to look for folders. + to look for folders. The bucket must be + a hierarchical namespace enabled bucket. This corresponds to the ``parent`` field on the ``request`` instance; if ``request`` is provided, this @@ -729,9 +766,12 @@ async def rename_folder( timeout: Union[float, object] = gapic_v1.method.DEFAULT, metadata: Sequence[Tuple[str, str]] = (), ) -> operation_async.AsyncOperation: - r"""Renames a source folder to a destination folder. - During a rename, the source and destination folders are - locked until the long running operation completes. + r"""Renames a source folder to a destination folder. This + operation is only applicable to a hierarchical namespace + enabled bucket. During a rename, the source and + destination folders are locked until the long running + operation completes. + Hierarchical namespace buckets are in allowlist preview. .. code-block:: python @@ -767,6 +807,10 @@ async def sample_rename_folder(): Args: request (Optional[Union[google.cloud.storage_control_v2.types.RenameFolderRequest, dict]]): The request object. Request message for RenameFolder. + This operation is only applicable to a + hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in + allowlist preview. name (:class:`str`): Required. Name of the source folder being renamed. Format: @@ -790,9 +834,9 @@ async def sample_rename_folder(): google.api_core.operation_async.AsyncOperation: An object representing a long-running operation. - The result type for the operation will be - :class:`google.cloud.storage_control_v2.types.Folder` A - folder. + The result type for the operation will be :class:`google.cloud.storage_control_v2.types.Folder` A folder resource. This resource can only exist in a hierarchical namespace + enabled bucket. Hierarchical namespace buckets are in + allowlist preview. """ # Create or coerce a protobuf request object. diff --git a/packages/google-cloud-storage-control/google/cloud/storage_control_v2/services/storage_control/client.py b/packages/google-cloud-storage-control/google/cloud/storage_control_v2/services/storage_control/client.py index 39c9e0ba3a2c..14f56fff2d45 100644 --- a/packages/google-cloud-storage-control/google/cloud/storage_control_v2/services/storage_control/client.py +++ b/packages/google-cloud-storage-control/google/cloud/storage_control_v2/services/storage_control/client.py @@ -725,7 +725,9 @@ def create_folder( timeout: Union[float, object] = gapic_v1.method.DEFAULT, metadata: Sequence[Tuple[str, str]] = (), ) -> storage_control.Folder: - r"""Creates a new folder. + r"""Creates a new folder. This operation is only + applicable to a hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in allowlist preview. .. code-block:: python @@ -757,9 +759,15 @@ def sample_create_folder(): Args: request (Union[google.cloud.storage_control_v2.types.CreateFolderRequest, dict]): The request object. Request message for CreateFolder. + This operation is only applicable to a + hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in + allowlist preview. parent (str): Required. Name of the bucket in which - the folder will reside. + the folder will reside. The bucket must + be a hierarchical namespace enabled + bucket. This corresponds to the ``parent`` field on the ``request`` instance; if ``request`` is provided, this @@ -792,7 +800,11 @@ def sample_create_folder(): Returns: google.cloud.storage_control_v2.types.Folder: - A folder. + A folder resource. This resource can + only exist in a hierarchical namespace + enabled bucket. Hierarchical namespace + buckets are in allowlist preview. + """ # Create or coerce a protobuf request object. # Quick check: If we got a request object, we should *not* have @@ -861,7 +873,10 @@ def delete_folder( timeout: Union[float, object] = gapic_v1.method.DEFAULT, metadata: Sequence[Tuple[str, str]] = (), ) -> None: - r"""Permanently deletes an empty folder. + r"""Permanently deletes an empty folder. This operation + is only applicable to a hierarchical namespace enabled + bucket. Hierarchical namespace buckets are in allowlist + preview. .. code-block:: python @@ -889,6 +904,10 @@ def sample_delete_folder(): Args: request (Union[google.cloud.storage_control_v2.types.DeleteFolderRequest, dict]): The request object. Request message for DeleteFolder. + This operation is only applicable to a + hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in + allowlist preview. name (str): Required. Name of the folder. Format: ``projects/{project}/buckets/{bucket}/folders/{folder}`` @@ -964,7 +983,10 @@ def get_folder( timeout: Union[float, object] = gapic_v1.method.DEFAULT, metadata: Sequence[Tuple[str, str]] = (), ) -> storage_control.Folder: - r"""Returns metadata for the specified folder. + r"""Returns metadata for the specified folder. This + operation is only applicable to a hierarchical namespace + enabled bucket. Hierarchical namespace buckets are in + allowlist preview. .. code-block:: python @@ -994,7 +1016,11 @@ def sample_get_folder(): Args: request (Union[google.cloud.storage_control_v2.types.GetFolderRequest, dict]): - The request object. Request message for GetFolder. + The request object. Request message for GetFolder. This + operation is only applicable to a + hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in + allowlist preview. name (str): Required. Name of the folder. Format: ``projects/{project}/buckets/{bucket}/folders/{folder}`` @@ -1010,7 +1036,11 @@ def sample_get_folder(): Returns: google.cloud.storage_control_v2.types.Folder: - A folder. + A folder resource. This resource can + only exist in a hierarchical namespace + enabled bucket. Hierarchical namespace + buckets are in allowlist preview. + """ # Create or coerce a protobuf request object. # Quick check: If we got a request object, we should *not* have @@ -1077,7 +1107,9 @@ def list_folders( timeout: Union[float, object] = gapic_v1.method.DEFAULT, metadata: Sequence[Tuple[str, str]] = (), ) -> pagers.ListFoldersPager: - r"""Retrieves a list of folders for a given bucket. + r"""Retrieves a list of folders. This operation is only + applicable to a hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in allowlist preview. .. code-block:: python @@ -1108,10 +1140,15 @@ def sample_list_folders(): Args: request (Union[google.cloud.storage_control_v2.types.ListFoldersRequest, dict]): - The request object. Request message for ListFolders. + The request object. Request message for ListFolders. This + operation is only applicable to a + hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in + allowlist preview. parent (str): Required. Name of the bucket in which - to look for folders. + to look for folders. The bucket must be + a hierarchical namespace enabled bucket. This corresponds to the ``parent`` field on the ``request`` instance; if ``request`` is provided, this @@ -1201,9 +1238,12 @@ def rename_folder( timeout: Union[float, object] = gapic_v1.method.DEFAULT, metadata: Sequence[Tuple[str, str]] = (), ) -> operation.Operation: - r"""Renames a source folder to a destination folder. - During a rename, the source and destination folders are - locked until the long running operation completes. + r"""Renames a source folder to a destination folder. This + operation is only applicable to a hierarchical namespace + enabled bucket. During a rename, the source and + destination folders are locked until the long running + operation completes. + Hierarchical namespace buckets are in allowlist preview. .. code-block:: python @@ -1239,6 +1279,10 @@ def sample_rename_folder(): Args: request (Union[google.cloud.storage_control_v2.types.RenameFolderRequest, dict]): The request object. Request message for RenameFolder. + This operation is only applicable to a + hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in + allowlist preview. name (str): Required. Name of the source folder being renamed. Format: @@ -1262,9 +1306,9 @@ def sample_rename_folder(): google.api_core.operation.Operation: An object representing a long-running operation. - The result type for the operation will be - :class:`google.cloud.storage_control_v2.types.Folder` A - folder. + The result type for the operation will be :class:`google.cloud.storage_control_v2.types.Folder` A folder resource. This resource can only exist in a hierarchical namespace + enabled bucket. Hierarchical namespace buckets are in + allowlist preview. """ # Create or coerce a protobuf request object. diff --git a/packages/google-cloud-storage-control/google/cloud/storage_control_v2/services/storage_control/transports/grpc.py b/packages/google-cloud-storage-control/google/cloud/storage_control_v2/services/storage_control/transports/grpc.py index e531a496e854..241b4c790288 100644 --- a/packages/google-cloud-storage-control/google/cloud/storage_control_v2/services/storage_control/transports/grpc.py +++ b/packages/google-cloud-storage-control/google/cloud/storage_control_v2/services/storage_control/transports/grpc.py @@ -252,7 +252,9 @@ def create_folder( ) -> Callable[[storage_control.CreateFolderRequest], storage_control.Folder]: r"""Return a callable for the create folder method over gRPC. - Creates a new folder. + Creates a new folder. This operation is only + applicable to a hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in allowlist preview. Returns: Callable[[~.CreateFolderRequest], @@ -278,7 +280,10 @@ def delete_folder( ) -> Callable[[storage_control.DeleteFolderRequest], empty_pb2.Empty]: r"""Return a callable for the delete folder method over gRPC. - Permanently deletes an empty folder. + Permanently deletes an empty folder. This operation + is only applicable to a hierarchical namespace enabled + bucket. Hierarchical namespace buckets are in allowlist + preview. Returns: Callable[[~.DeleteFolderRequest], @@ -304,7 +309,10 @@ def get_folder( ) -> Callable[[storage_control.GetFolderRequest], storage_control.Folder]: r"""Return a callable for the get folder method over gRPC. - Returns metadata for the specified folder. + Returns metadata for the specified folder. This + operation is only applicable to a hierarchical namespace + enabled bucket. Hierarchical namespace buckets are in + allowlist preview. Returns: Callable[[~.GetFolderRequest], @@ -332,7 +340,9 @@ def list_folders( ]: r"""Return a callable for the list folders method over gRPC. - Retrieves a list of folders for a given bucket. + Retrieves a list of folders. This operation is only + applicable to a hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in allowlist preview. Returns: Callable[[~.ListFoldersRequest], @@ -358,9 +368,12 @@ def rename_folder( ) -> Callable[[storage_control.RenameFolderRequest], operations_pb2.Operation]: r"""Return a callable for the rename folder method over gRPC. - Renames a source folder to a destination folder. - During a rename, the source and destination folders are - locked until the long running operation completes. + Renames a source folder to a destination folder. This + operation is only applicable to a hierarchical namespace + enabled bucket. During a rename, the source and + destination folders are locked until the long running + operation completes. + Hierarchical namespace buckets are in allowlist preview. Returns: Callable[[~.RenameFolderRequest], diff --git a/packages/google-cloud-storage-control/google/cloud/storage_control_v2/services/storage_control/transports/grpc_asyncio.py b/packages/google-cloud-storage-control/google/cloud/storage_control_v2/services/storage_control/transports/grpc_asyncio.py index dcafb552a417..0e59eab1c1b8 100644 --- a/packages/google-cloud-storage-control/google/cloud/storage_control_v2/services/storage_control/transports/grpc_asyncio.py +++ b/packages/google-cloud-storage-control/google/cloud/storage_control_v2/services/storage_control/transports/grpc_asyncio.py @@ -259,7 +259,9 @@ def create_folder( ]: r"""Return a callable for the create folder method over gRPC. - Creates a new folder. + Creates a new folder. This operation is only + applicable to a hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in allowlist preview. Returns: Callable[[~.CreateFolderRequest], @@ -285,7 +287,10 @@ def delete_folder( ) -> Callable[[storage_control.DeleteFolderRequest], Awaitable[empty_pb2.Empty]]: r"""Return a callable for the delete folder method over gRPC. - Permanently deletes an empty folder. + Permanently deletes an empty folder. This operation + is only applicable to a hierarchical namespace enabled + bucket. Hierarchical namespace buckets are in allowlist + preview. Returns: Callable[[~.DeleteFolderRequest], @@ -313,7 +318,10 @@ def get_folder( ]: r"""Return a callable for the get folder method over gRPC. - Returns metadata for the specified folder. + Returns metadata for the specified folder. This + operation is only applicable to a hierarchical namespace + enabled bucket. Hierarchical namespace buckets are in + allowlist preview. Returns: Callable[[~.GetFolderRequest], @@ -342,7 +350,9 @@ def list_folders( ]: r"""Return a callable for the list folders method over gRPC. - Retrieves a list of folders for a given bucket. + Retrieves a list of folders. This operation is only + applicable to a hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in allowlist preview. Returns: Callable[[~.ListFoldersRequest], @@ -370,9 +380,12 @@ def rename_folder( ]: r"""Return a callable for the rename folder method over gRPC. - Renames a source folder to a destination folder. - During a rename, the source and destination folders are - locked until the long running operation completes. + Renames a source folder to a destination folder. This + operation is only applicable to a hierarchical namespace + enabled bucket. During a rename, the source and + destination folders are locked until the long running + operation completes. + Hierarchical namespace buckets are in allowlist preview. Returns: Callable[[~.RenameFolderRequest], diff --git a/packages/google-cloud-storage-control/google/cloud/storage_control_v2/types/storage_control.py b/packages/google-cloud-storage-control/google/cloud/storage_control_v2/types/storage_control.py index 9a1276d8ff9e..7d1af2a8b4e6 100644 --- a/packages/google-cloud-storage-control/google/cloud/storage_control_v2/types/storage_control.py +++ b/packages/google-cloud-storage-control/google/cloud/storage_control_v2/types/storage_control.py @@ -61,7 +61,9 @@ class PendingRenameInfo(proto.Message): class Folder(proto.Message): - r"""A folder. + r"""A folder resource. This resource can only exist in a + hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in allowlist preview. Attributes: name (str): @@ -112,7 +114,10 @@ class Folder(proto.Message): class GetFolderRequest(proto.Message): - r"""Request message for GetFolder. + r"""Request message for GetFolder. This operation is only + applicable to a hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in allowlist preview. + .. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields @@ -159,12 +164,15 @@ class GetFolderRequest(proto.Message): class CreateFolderRequest(proto.Message): - r"""Request message for CreateFolder. + r"""Request message for CreateFolder. This operation is only + applicable to a hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in allowlist preview. Attributes: parent (str): Required. Name of the bucket in which the - folder will reside. + folder will reside. The bucket must be a + hierarchical namespace enabled bucket. folder (google.cloud.storage_control_v2.types.Folder): Required. Properties of the new folder being created. The bucket and name of the folder are specified in the parent @@ -181,10 +189,9 @@ class CreateFolderRequest(proto.Message): to be present and all missing ancestor folders will be created atomically. request_id (str): - Optional. A unique identifier for this request. UUID is the - recommended format, but other formats are still accepted. - This request is only idempotent if a ``request_id`` is - provided. + Optional. A unique identifier for this + request. UUID is the recommended format, but + other formats are still accepted. """ parent: str = proto.Field( @@ -211,7 +218,10 @@ class CreateFolderRequest(proto.Message): class DeleteFolderRequest(proto.Message): - r"""Request message for DeleteFolder. + r"""Request message for DeleteFolder. This operation is only + applicable to a hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in allowlist preview. + .. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields @@ -232,10 +242,9 @@ class DeleteFolderRequest(proto.Message): This field is a member of `oneof`_ ``_if_metageneration_not_match``. request_id (str): - Optional. A unique identifier for this request. UUID is the - recommended format, but other formats are still accepted. - This request is only idempotent if a ``request_id`` is - provided. + Optional. A unique identifier for this + request. UUID is the recommended format, but + other formats are still accepted. """ name: str = proto.Field( @@ -259,12 +268,15 @@ class DeleteFolderRequest(proto.Message): class ListFoldersRequest(proto.Message): - r"""Request message for ListFolders. + r"""Request message for ListFolders. This operation is only + applicable to a hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in allowlist preview. Attributes: parent (str): Required. Name of the bucket in which to look - for folders. + for folders. The bucket must be a hierarchical + namespace enabled bucket. page_size (int): Optional. Maximum number of folders to return in a single response. The service will use this @@ -365,7 +377,10 @@ def raw_page(self): class RenameFolderRequest(proto.Message): - r"""Request message for RenameFolder. + r"""Request message for RenameFolder. This operation is only + applicable to a hierarchical namespace enabled bucket. + Hierarchical namespace buckets are in allowlist preview. + .. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields diff --git a/packages/google-cloud-storage-control/samples/generated_samples/snippet_metadata_google.storage.control.v2.json b/packages/google-cloud-storage-control/samples/generated_samples/snippet_metadata_google.storage.control.v2.json index 55af026bc856..932c0e2b46a6 100644 --- a/packages/google-cloud-storage-control/samples/generated_samples/snippet_metadata_google.storage.control.v2.json +++ b/packages/google-cloud-storage-control/samples/generated_samples/snippet_metadata_google.storage.control.v2.json @@ -8,7 +8,7 @@ ], "language": "PYTHON", "name": "google-cloud-storage-control", - "version": "0.1.2" + "version": "0.1.0" }, "snippets": [ {