label-studio-sdk 1.0.20__py3-none-any.whl → 2.0.1__py3-none-any.whl

label_studio_sdk/export_storage/gcs/client.py

@@ -4,12 +4,10 @@ import typing
 from ...core.client_wrapper import SyncClientWrapper
 from ...core.request_options import RequestOptions
 from ...types.gcs_export_storage import GcsExportStorage
-from ...core.pydantic_utilities import parse_obj_as
+from ...core.unchecked_base_model import construct_type
 from json.decoder import JSONDecodeError
 from ...core.api_error import ApiError
-from .types.gcs_create_response import GcsCreateResponse
 from ...core.jsonable_encoder import jsonable_encoder
-from .types.gcs_update_response import GcsUpdateResponse
 from ...core.client_wrapper import AsyncClientWrapper
 
 # this is used as the default value for optional parameters
@@ -21,18 +19,20 @@ class GcsClient:
         self._client_wrapper = client_wrapper
 
     def list(
-        self, *, project: typing.Optional[int] = None, request_options: typing.Optional[RequestOptions] = None
+        self,
+        *,
+        ordering: typing.Optional[str] = None,
+        project: typing.Optional[int] = None,
+        request_options: typing.Optional[RequestOptions] = None,
     ) -> typing.List[GcsExportStorage]:
         """
-
-        You can connect your Google Cloud Storage bucket to Label Studio as a source storage or target storage. Use this API request to get a list of all GCS export (target) storage connections for a specific project.
-
-        The project ID can be found in the URL when viewing the project in Label Studio, or you can retrieve all project IDs using [List all projects](../projects/list).
-
-        For more information about working with external storage, see [Sync data from external storage](https://labelstud.io/guide/storage).
+        Get a list of all GCS export storage connections.
 
         Parameters
         ----------
+        ordering : typing.Optional[str]
+            Which field to use when ordering the results.
+
         project : typing.Optional[int]
             Project ID
 
@@ -57,6 +57,7 @@ class GcsClient:
             "api/storages/export/gcs",
             method="GET",
             params={
+                "ordering": ordering,
                 "project": project,
             },
             request_options=request_options,
@@ -65,7 +66,7 @@ class GcsClient:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
                     typing.List[GcsExportStorage],
-                    parse_obj_as(
+                    construct_type(
                         type_=typing.List[GcsExportStorage],  # type: ignore
                         object_=_response.json(),
                     ),
@@ -87,14 +88,9 @@ class GcsClient:
         google_application_credentials: typing.Optional[str] = OMIT,
         google_project_id: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> GcsCreateResponse:
+    ) -> GcsExportStorage:
         """
-
-        Create a new target storage connection to Google Cloud Storage.
-
-        For information about the required fields and prerequisites, see [Google Cloud Storage](https://labelstud.io/guide/storage#Google-Cloud-Storage) in the Label Studio documentation.
-
-        <Tip>After you add the storage, you should validate the connection before attempting to sync your data. Your data will not be exported until you [sync your connection](sync).</Tip>
+        Create a new GCS export storage connection to store annotations.
 
         Parameters
         ----------
@@ -127,7 +123,7 @@ class GcsClient:
 
         Returns
         -------
-        GcsCreateResponse
+        GcsExportStorage
 
 
         Examples
@@ -161,9 +157,9 @@ class GcsClient:
         try:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
-                    GcsCreateResponse,
-                    parse_obj_as(
-                        type_=GcsCreateResponse,  # type: ignore
+                    GcsExportStorage,
+                    construct_type(
+                        type_=GcsExportStorage,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
@@ -172,108 +168,13 @@ class GcsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    def validate(
-        self,
-        *,
-        id: typing.Optional[int] = OMIT,
-        can_delete_objects: typing.Optional[bool] = OMIT,
-        title: typing.Optional[str] = OMIT,
-        description: typing.Optional[str] = OMIT,
-        project: typing.Optional[int] = OMIT,
-        bucket: typing.Optional[str] = OMIT,
-        prefix: typing.Optional[str] = OMIT,
-        google_application_credentials: typing.Optional[str] = OMIT,
-        google_project_id: typing.Optional[str] = OMIT,
-        request_options: typing.Optional[RequestOptions] = None,
-    ) -> None:
-        """
-
-        Validate a specific GCS export storage connection. This is useful to ensure that the storage configuration settings are correct and operational before attempting to export data.
-
-        Parameters
-        ----------
-        id : typing.Optional[int]
-            Storage ID. If set, storage with specified ID will be updated
-
-        can_delete_objects : typing.Optional[bool]
-            Deletion from storage enabled.
-
-        title : typing.Optional[str]
-            Storage title
-
-        description : typing.Optional[str]
-            Storage description
-
-        project : typing.Optional[int]
-            Project ID
-
-        bucket : typing.Optional[str]
-            GCS bucket name
-
-        prefix : typing.Optional[str]
-            GCS bucket prefix
-
-        google_application_credentials : typing.Optional[str]
-            The content of GOOGLE_APPLICATION_CREDENTIALS json file. Check official Google Cloud Authentication documentation for more details.
-
-        google_project_id : typing.Optional[str]
-            Google project ID
-
-        request_options : typing.Optional[RequestOptions]
-            Request-specific configuration.
-
-        Returns
-        -------
-        None
-
-        Examples
-        --------
-        from label_studio_sdk import LabelStudio
-
-        client = LabelStudio(
-            api_key="YOUR_API_KEY",
-        )
-        client.export_storage.gcs.validate()
-        """
-        _response = self._client_wrapper.httpx_client.request(
-            "api/storages/export/gcs/validate",
-            method="POST",
-            json={
-                "id": id,
-                "can_delete_objects": can_delete_objects,
-                "title": title,
-                "description": description,
-                "project": project,
-                "bucket": bucket,
-                "prefix": prefix,
-                "google_application_credentials": google_application_credentials,
-                "google_project_id": google_project_id,
-            },
-            headers={
-                "content-type": "application/json",
-            },
-            request_options=request_options,
-            omit=OMIT,
-        )
-        try:
-            if 200 <= _response.status_code < 300:
-                return
-            _response_json = _response.json()
-        except JSONDecodeError:
-            raise ApiError(status_code=_response.status_code, body=_response.text)
-        raise ApiError(status_code=_response.status_code, body=_response_json)
-
     def get(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> GcsExportStorage:
         """
-
-        Get a specific GCS export storage connection. You will need to provide the export storage ID. You can find this using [List export storages](list).
-
-        For more information about working with external storage, see [Sync data from external storage](https://labelstud.io/guide/storage).
+        Get a specific GCS export storage connection.
 
         Parameters
         ----------
         id : int
-            A unique integer value identifying this gcs export storage.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -303,7 +204,7 @@ class GcsClient:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
                     GcsExportStorage,
-                    parse_obj_as(
+                    construct_type(
                         type_=GcsExportStorage,  # type: ignore
                         object_=_response.json(),
                     ),
@@ -315,15 +216,11 @@ class GcsClient:
 
     def delete(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> None:
         """
-
-        Delete a specific GCS export storage connection. You will need to provide the export storage ID. You can find this using [List export storages](list).
-
-        Deleting an export/target storage connection does not affect tasks with synced data in Label Studio. If you want to remove the tasks that were synced from the external storage, you will need to delete them manually from within the Label Studio UI or use the [Delete tasks](../../tasks/delete-all-tasks) API.
+        Delete a specific GCS export storage connection.
 
         Parameters
         ----------
         id : int
-            A unique integer value identifying this gcs export storage.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -369,17 +266,13 @@ class GcsClient:
         google_application_credentials: typing.Optional[str] = OMIT,
         google_project_id: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> GcsUpdateResponse:
+    ) -> GcsExportStorage:
         """
-
-        Update a specific GCS export storage connection. You will need to provide the export storage ID. You can find this using [List export storages](list).
-
-        For more information about working with external storage, see [Sync data from external storage](https://labelstud.io/guide/storage).
+        Update a specific GCS export storage connection.
 
         Parameters
         ----------
         id : int
-            A unique integer value identifying this gcs export storage.
 
         can_delete_objects : typing.Optional[bool]
             Deletion from storage enabled.
@@ -410,7 +303,7 @@ class GcsClient:
 
         Returns
         -------
-        GcsUpdateResponse
+        GcsExportStorage
 
 
         Examples
@@ -446,9 +339,9 @@ class GcsClient:
         try:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
-                    GcsUpdateResponse,
-                    parse_obj_as(
-                        type_=GcsUpdateResponse,  # type: ignore
+                    GcsExportStorage,
+                    construct_type(
+                        type_=GcsExportStorage,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
@@ -459,12 +352,7 @@ class GcsClient:
 
     def sync(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> GcsExportStorage:
         """
-
-        Sync tasks to a GCS export/target storage connection. You will need to provide the export storage ID. You can find this using [List export storages](list).
-
-        Sync operations with external buckets only go one way. They either create tasks from objects in the bucket (source/import storage) or push annotations to the output bucket (export/target storage). Changing something on the bucket side doesn’t guarantee consistency in results.
-
-        <Note>Before proceeding, you should review [How sync operations work - Source storage](https://labelstud.io/guide/storage#Source-storage) to ensure that your data remains secure and private.</Note>
+        Sync tasks from an GCS export storage connection.
 
         Parameters
         ----------
@@ -498,7 +386,7 @@ class GcsClient:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
                     GcsExportStorage,
-                    parse_obj_as(
+                    construct_type(
                         type_=GcsExportStorage,  # type: ignore
                         object_=_response.json(),
                     ),
@@ -508,127 +396,125 @@ class GcsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-
-class AsyncGcsClient:
-    def __init__(self, *, client_wrapper: AsyncClientWrapper):
-        self._client_wrapper = client_wrapper
-
-    async def list(
-        self, *, project: typing.Optional[int] = None, request_options: typing.Optional[RequestOptions] = None
-    ) -> typing.List[GcsExportStorage]:
+    def validate(
+        self,
+        *,
+        id: typing.Optional[int] = OMIT,
+        can_delete_objects: typing.Optional[bool] = OMIT,
+        title: typing.Optional[str] = OMIT,
+        description: typing.Optional[str] = OMIT,
+        project: typing.Optional[int] = OMIT,
+        bucket: typing.Optional[str] = OMIT,
+        prefix: typing.Optional[str] = OMIT,
+        google_application_credentials: typing.Optional[str] = OMIT,
+        google_project_id: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> None:
         """
+        Validate a specific GCS export storage connection.
 
-        You can connect your Google Cloud Storage bucket to Label Studio as a source storage or target storage. Use this API request to get a list of all GCS export (target) storage connections for a specific project.
+        Parameters
+        ----------
+        id : typing.Optional[int]
+            Storage ID. If set, storage with specified ID will be updated
+
+        can_delete_objects : typing.Optional[bool]
+            Deletion from storage enabled.
 
-        The project ID can be found in the URL when viewing the project in Label Studio, or you can retrieve all project IDs using [List all projects](../projects/list).
+        title : typing.Optional[str]
+            Storage title
 
-        For more information about working with external storage, see [Sync data from external storage](https://labelstud.io/guide/storage).
+        description : typing.Optional[str]
+            Storage description
 
-        Parameters
-        ----------
         project : typing.Optional[int]
             Project ID
 
+        bucket : typing.Optional[str]
+            GCS bucket name
+
+        prefix : typing.Optional[str]
+            GCS bucket prefix
+
+        google_application_credentials : typing.Optional[str]
+            The content of GOOGLE_APPLICATION_CREDENTIALS json file. Check official Google Cloud Authentication documentation for more details.
+
+        google_project_id : typing.Optional[str]
+            Google project ID
+
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        typing.List[GcsExportStorage]
-
+        None
 
         Examples
         --------
-        import asyncio
-
-        from label_studio_sdk import AsyncLabelStudio
+        from label_studio_sdk import LabelStudio
 
-        client = AsyncLabelStudio(
+        client = LabelStudio(
             api_key="YOUR_API_KEY",
         )
-
-
-        async def main() -> None:
-            await client.export_storage.gcs.list()
-
-
-        asyncio.run(main())
+        client.export_storage.gcs.validate()
         """
-        _response = await self._client_wrapper.httpx_client.request(
-            "api/storages/export/gcs",
-            method="GET",
-            params={
+        _response = self._client_wrapper.httpx_client.request(
+            "api/storages/export/gcs/validate",
+            method="POST",
+            json={
+                "id": id,
+                "can_delete_objects": can_delete_objects,
+                "title": title,
+                "description": description,
                 "project": project,
+                "bucket": bucket,
+                "prefix": prefix,
+                "google_application_credentials": google_application_credentials,
+                "google_project_id": google_project_id,
+            },
+            headers={
+                "content-type": "application/json",
             },
             request_options=request_options,
+            omit=OMIT,
         )
         try:
             if 200 <= _response.status_code < 300:
-                return typing.cast(
-                    typing.List[GcsExportStorage],
-                    parse_obj_as(
-                        type_=typing.List[GcsExportStorage],  # type: ignore
-                        object_=_response.json(),
-                    ),
-                )
+                return
             _response_json = _response.json()
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    async def create(
+
+class AsyncGcsClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def list(
         self,
         *,
-        can_delete_objects: typing.Optional[bool] = OMIT,
-        title: typing.Optional[str] = OMIT,
-        description: typing.Optional[str] = OMIT,
-        project: typing.Optional[int] = OMIT,
-        bucket: typing.Optional[str] = OMIT,
-        prefix: typing.Optional[str] = OMIT,
-        google_application_credentials: typing.Optional[str] = OMIT,
-        google_project_id: typing.Optional[str] = OMIT,
+        ordering: typing.Optional[str] = None,
+        project: typing.Optional[int] = None,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> GcsCreateResponse:
+    ) -> typing.List[GcsExportStorage]:
         """
-
-        Create a new target storage connection to Google Cloud Storage.
-
-        For information about the required fields and prerequisites, see [Google Cloud Storage](https://labelstud.io/guide/storage#Google-Cloud-Storage) in the Label Studio documentation.
-
-        <Tip>After you add the storage, you should validate the connection before attempting to sync your data. Your data will not be exported until you [sync your connection](sync).</Tip>
+        Get a list of all GCS export storage connections.
 
         Parameters
         ----------
-        can_delete_objects : typing.Optional[bool]
-            Deletion from storage enabled.
-
-        title : typing.Optional[str]
-            Storage title
-
-        description : typing.Optional[str]
-            Storage description
+        ordering : typing.Optional[str]
+            Which field to use when ordering the results.
 
         project : typing.Optional[int]
             Project ID
 
-        bucket : typing.Optional[str]
-            GCS bucket name
-
-        prefix : typing.Optional[str]
-            GCS bucket prefix
-
-        google_application_credentials : typing.Optional[str]
-            The content of GOOGLE_APPLICATION_CREDENTIALS json file. Check official Google Cloud Authentication documentation for more details.
-
-        google_project_id : typing.Optional[str]
-            Google project ID
-
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
 
         Returns
         -------
-        GcsCreateResponse
+        typing.List[GcsExportStorage]
 
 
         Examples
@@ -643,36 +529,26 @@ class AsyncGcsClient:
 
 
         async def main() -> None:
-            await client.export_storage.gcs.create()
+            await client.export_storage.gcs.list()
 
 
         asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
             "api/storages/export/gcs",
-            method="POST",
-            json={
-                "can_delete_objects": can_delete_objects,
-                "title": title,
-                "description": description,
+            method="GET",
+            params={
+                "ordering": ordering,
                 "project": project,
-                "bucket": bucket,
-                "prefix": prefix,
-                "google_application_credentials": google_application_credentials,
-                "google_project_id": google_project_id,
-            },
-            headers={
-                "content-type": "application/json",
             },
             request_options=request_options,
-            omit=OMIT,
         )
         try:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
-                    GcsCreateResponse,
-                    parse_obj_as(
-                        type_=GcsCreateResponse,  # type: ignore
+                    typing.List[GcsExportStorage],
+                    construct_type(
+                        type_=typing.List[GcsExportStorage],  # type: ignore
                         object_=_response.json(),
                     ),
                 )
@@ -681,10 +557,9 @@ class AsyncGcsClient:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
 
-    async def validate(
+    async def create(
         self,
         *,
-        id: typing.Optional[int] = OMIT,
         can_delete_objects: typing.Optional[bool] = OMIT,
         title: typing.Optional[str] = OMIT,
         description: typing.Optional[str] = OMIT,
@@ -694,16 +569,12 @@ class AsyncGcsClient:
         google_application_credentials: typing.Optional[str] = OMIT,
         google_project_id: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> None:
+    ) -> GcsExportStorage:
         """
-
-        Validate a specific GCS export storage connection. This is useful to ensure that the storage configuration settings are correct and operational before attempting to export data.
+        Create a new GCS export storage connection to store annotations.
 
         Parameters
         ----------
-        id : typing.Optional[int]
-            Storage ID. If set, storage with specified ID will be updated
-
         can_delete_objects : typing.Optional[bool]
             Deletion from storage enabled.
 
@@ -733,7 +604,8 @@ class AsyncGcsClient:
 
         Returns
         -------
-        None
+        GcsExportStorage
+
 
         Examples
         --------
@@ -747,16 +619,15 @@ class AsyncGcsClient:
 
 
         async def main() -> None:
-            await client.export_storage.gcs.validate()
+            await client.export_storage.gcs.create()
 
 
         asyncio.run(main())
         """
         _response = await self._client_wrapper.httpx_client.request(
-            "api/storages/export/gcs/validate",
+            "api/storages/export/gcs",
             method="POST",
             json={
-                "id": id,
                 "can_delete_objects": can_delete_objects,
                 "title": title,
                 "description": description,
@@ -774,7 +645,13 @@ class AsyncGcsClient:
         )
         try:
             if 200 <= _response.status_code < 300:
-                return
+                return typing.cast(
+                    GcsExportStorage,
+                    construct_type(
+                        type_=GcsExportStorage,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
             _response_json = _response.json()
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, body=_response.text)
@@ -782,15 +659,11 @@ class AsyncGcsClient:
 
     async def get(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> GcsExportStorage:
         """
-
-        Get a specific GCS export storage connection. You will need to provide the export storage ID. You can find this using [List export storages](list).
-
-        For more information about working with external storage, see [Sync data from external storage](https://labelstud.io/guide/storage).
+        Get a specific GCS export storage connection.
 
         Parameters
         ----------
         id : int
-            A unique integer value identifying this gcs export storage.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -828,7 +701,7 @@ class AsyncGcsClient:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
                     GcsExportStorage,
-                    parse_obj_as(
+                    construct_type(
                         type_=GcsExportStorage,  # type: ignore
                         object_=_response.json(),
                     ),
@@ -840,15 +713,11 @@ class AsyncGcsClient:
 
     async def delete(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> None:
         """
-
-        Delete a specific GCS export storage connection. You will need to provide the export storage ID. You can find this using [List export storages](list).
-
-        Deleting an export/target storage connection does not affect tasks with synced data in Label Studio. If you want to remove the tasks that were synced from the external storage, you will need to delete them manually from within the Label Studio UI or use the [Delete tasks](../../tasks/delete-all-tasks) API.
+        Delete a specific GCS export storage connection.
 
         Parameters
         ----------
         id : int
-            A unique integer value identifying this gcs export storage.
 
         request_options : typing.Optional[RequestOptions]
             Request-specific configuration.
@@ -902,17 +771,13 @@ class AsyncGcsClient:
         google_application_credentials: typing.Optional[str] = OMIT,
         google_project_id: typing.Optional[str] = OMIT,
         request_options: typing.Optional[RequestOptions] = None,
-    ) -> GcsUpdateResponse:
+    ) -> GcsExportStorage:
         """
-
-        Update a specific GCS export storage connection. You will need to provide the export storage ID. You can find this using [List export storages](list).
-
-        For more information about working with external storage, see [Sync data from external storage](https://labelstud.io/guide/storage).
+        Update a specific GCS export storage connection.
 
         Parameters
         ----------
         id : int
-            A unique integer value identifying this gcs export storage.
 
         can_delete_objects : typing.Optional[bool]
             Deletion from storage enabled.
@@ -943,7 +808,7 @@ class AsyncGcsClient:
 
         Returns
         -------
-        GcsUpdateResponse
+        GcsExportStorage
 
 
         Examples
@@ -987,9 +852,9 @@ class AsyncGcsClient:
         try:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
-                    GcsUpdateResponse,
-                    parse_obj_as(
-                        type_=GcsUpdateResponse,  # type: ignore
+                    GcsExportStorage,
+                    construct_type(
+                        type_=GcsExportStorage,  # type: ignore
                         object_=_response.json(),
                     ),
                 )
@@ -1000,12 +865,7 @@ class AsyncGcsClient:
 
     async def sync(self, id: int, *, request_options: typing.Optional[RequestOptions] = None) -> GcsExportStorage:
         """
-
-        Sync tasks to a GCS export/target storage connection. You will need to provide the export storage ID. You can find this using [List export storages](list).
-
-        Sync operations with external buckets only go one way. They either create tasks from objects in the bucket (source/import storage) or push annotations to the output bucket (export/target storage). Changing something on the bucket side doesn’t guarantee consistency in results.
-
-        <Note>Before proceeding, you should review [How sync operations work - Source storage](https://labelstud.io/guide/storage#Source-storage) to ensure that your data remains secure and private.</Note>
+        Sync tasks from an GCS export storage connection.
 
         Parameters
         ----------
@@ -1047,7 +907,7 @@ class AsyncGcsClient:
             if 200 <= _response.status_code < 300:
                 return typing.cast(
                     GcsExportStorage,
-                    parse_obj_as(
+                    construct_type(
                         type_=GcsExportStorage,  # type: ignore
                         object_=_response.json(),
                     ),
@@ -1056,3 +916,101 @@ class AsyncGcsClient:
         except JSONDecodeError:
             raise ApiError(status_code=_response.status_code, body=_response.text)
         raise ApiError(status_code=_response.status_code, body=_response_json)
+
+    async def validate(
+        self,
+        *,
+        id: typing.Optional[int] = OMIT,
+        can_delete_objects: typing.Optional[bool] = OMIT,
+        title: typing.Optional[str] = OMIT,
+        description: typing.Optional[str] = OMIT,
+        project: typing.Optional[int] = OMIT,
+        bucket: typing.Optional[str] = OMIT,
+        prefix: typing.Optional[str] = OMIT,
+        google_application_credentials: typing.Optional[str] = OMIT,
+        google_project_id: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> None:
+        """
+        Validate a specific GCS export storage connection.
+
+        Parameters
+        ----------
+        id : typing.Optional[int]
+            Storage ID. If set, storage with specified ID will be updated
+
+        can_delete_objects : typing.Optional[bool]
+            Deletion from storage enabled.
+
+        title : typing.Optional[str]
+            Storage title
+
+        description : typing.Optional[str]
+            Storage description
+
+        project : typing.Optional[int]
+            Project ID
+
+        bucket : typing.Optional[str]
+            GCS bucket name
+
+        prefix : typing.Optional[str]
+            GCS bucket prefix
+
+        google_application_credentials : typing.Optional[str]
+            The content of GOOGLE_APPLICATION_CREDENTIALS json file. Check official Google Cloud Authentication documentation for more details.
+
+        google_project_id : typing.Optional[str]
+            Google project ID
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        None
+
+        Examples
+        --------
+        import asyncio
+
+        from label_studio_sdk import AsyncLabelStudio
+
+        client = AsyncLabelStudio(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.export_storage.gcs.validate()
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "api/storages/export/gcs/validate",
+            method="POST",
+            json={
+                "id": id,
+                "can_delete_objects": can_delete_objects,
+                "title": title,
+                "description": description,
+                "project": project,
+                "bucket": bucket,
+                "prefix": prefix,
+                "google_application_credentials": google_application_credentials,
+                "google_project_id": google_project_id,
+            },
+            headers={
+                "content-type": "application/json",
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)