gcore 0.13.0__py3-none-any.whl → 0.15.0__py3-none-any.whl

gcore/resources/storage/storage.py

@@ -6,7 +6,7 @@ from typing_extensions import Literal
 
 import httpx
 
-from ..._types import NOT_GIVEN, Body, Query, Headers, NoneType, NotGiven
+from ..._types import Body, Omit, Query, Headers, NoneType, NotGiven, omit, not_given
 from ..._utils import maybe_transform, async_maybe_transform
 from ..._compat import cached_property
 from .locations import (
@@ -98,14 +98,14 @@ class StorageResource(SyncAPIResource):
         location: Literal["s-ed1", "s-drc2", "s-sgc1", "s-nhn2", "s-darz", "s-ws1", "ams", "sin", "fra", "mia"],
         name: str,
         type: Literal["sftp", "s3"],
-        generate_sftp_password: bool | NotGiven = NOT_GIVEN,
-        sftp_password: str | NotGiven = NOT_GIVEN,
+        generate_sftp_password: bool | Omit = omit,
+        sftp_password: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> Storage:
         """
         Creates a new storage instance (S3 or SFTP) in the specified location and
@@ -138,7 +138,9 @@ class StorageResource(SyncAPIResource):
           timeout: Override the client-level default timeout for this request, in seconds
         """
         return self._post(
-            "/storage/provisioning/v2/storage",
+            "/storage/provisioning/v2/storage"
+            if self._client._base_url_overridden
+            else "https://api.gcore.com//storage/provisioning/v2/storage",
             body=maybe_transform(
                 {
                     "location": location,
@@ -159,14 +161,14 @@ class StorageResource(SyncAPIResource):
         self,
         storage_id: int,
         *,
-        expires: str | NotGiven = NOT_GIVEN,
-        server_alias: str | NotGiven = NOT_GIVEN,
+        expires: str | Omit = omit,
+        server_alias: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> Storage:
         """Updates storage configuration such as expiration date and server alias.
 
@@ -188,7 +190,9 @@ class StorageResource(SyncAPIResource):
           timeout: Override the client-level default timeout for this request, in seconds
         """
         return self._patch(
-            f"/storage/provisioning/v2/storage/{storage_id}",
+            f"/storage/provisioning/v2/storage/{storage_id}"
+            if self._client._base_url_overridden
+            else f"https://api.gcore.com//storage/provisioning/v2/storage/{storage_id}",
             body=maybe_transform(
                 {
                     "expires": expires,
@@ -205,28 +209,30 @@ class StorageResource(SyncAPIResource):
     def list(
         self,
         *,
-        id: str | NotGiven = NOT_GIVEN,
-        limit: int | NotGiven = NOT_GIVEN,
-        location: str | NotGiven = NOT_GIVEN,
-        name: str | NotGiven = NOT_GIVEN,
-        offset: int | NotGiven = NOT_GIVEN,
-        order_by: str | NotGiven = NOT_GIVEN,
-        order_direction: Literal["asc", "desc"] | NotGiven = NOT_GIVEN,
-        show_deleted: bool | NotGiven = NOT_GIVEN,
-        status: Literal["active", "suspended", "deleted", "pending"] | NotGiven = NOT_GIVEN,
-        type: Literal["s3", "sftp"] | NotGiven = NOT_GIVEN,
+        id: str | Omit = omit,
+        limit: int | Omit = omit,
+        location: str | Omit = omit,
+        name: str | Omit = omit,
+        offset: int | Omit = omit,
+        order_by: str | Omit = omit,
+        order_direction: Literal["asc", "desc"] | Omit = omit,
+        show_deleted: bool | Omit = omit,
+        status: Literal["active", "suspended", "deleted", "pending"] | Omit = omit,
+        type: Literal["s3", "sftp"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SyncOffsetPage[Storage]:
         """
         Returns storages with the same filtering and pagination as v2, but in a
-        simplified response shape for easier client consumption. Response format: count:
-        total number of storages matching the filter (independent of pagination)
-        results: the current page of storages according to limit/offset
+        simplified response shape for easier client consumption.
+
+        Response format: count: total number of storages matching the filter
+        (independent of pagination) results: the current page of storages according to
+        limit/offset
 
         Args:
           id: Filter by storage ID
@@ -258,7 +264,9 @@ class StorageResource(SyncAPIResource):
           timeout: Override the client-level default timeout for this request, in seconds
         """
         return self._get_api_list(
-            "/storage/provisioning/v3/storage",
+            "/storage/provisioning/v3/storage"
+            if self._client._base_url_overridden
+            else "https://api.gcore.com//storage/provisioning/v3/storage",
             page=SyncOffsetPage[Storage],
             options=make_request_options(
                 extra_headers=extra_headers,
@@ -293,7 +301,7 @@ class StorageResource(SyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> None:
         """Permanently deletes a storage and all its data.
 
@@ -310,7 +318,9 @@ class StorageResource(SyncAPIResource):
         """
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return self._delete(
-            f"/storage/provisioning/v1/storage/{storage_id}",
+            f"/storage/provisioning/v1/storage/{storage_id}"
+            if self._client._base_url_overridden
+            else f"https://api.gcore.com//storage/provisioning/v1/storage/{storage_id}",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -326,7 +336,7 @@ class StorageResource(SyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> Storage:
         """
         Retrieves detailed information about a specific storage including its
@@ -342,7 +352,9 @@ class StorageResource(SyncAPIResource):
           timeout: Override the client-level default timeout for this request, in seconds
         """
         return self._get(
-            f"/storage/provisioning/v1/storage/{storage_id}",
+            f"/storage/provisioning/v1/storage/{storage_id}"
+            if self._client._base_url_overridden
+            else f"https://api.gcore.com//storage/provisioning/v1/storage/{storage_id}",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -359,7 +371,7 @@ class StorageResource(SyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> None:
         """
         Associates an SSH public key with an SFTP storage, enabling passwordless
@@ -377,7 +389,9 @@ class StorageResource(SyncAPIResource):
         """
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return self._post(
-            f"/storage/provisioning/v1/storage/{storage_id}/key/{key_id}/link",
+            f"/storage/provisioning/v1/storage/{storage_id}/key/{key_id}/link"
+            if self._client._base_url_overridden
+            else f"https://api.gcore.com//storage/provisioning/v1/storage/{storage_id}/key/{key_id}/link",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -388,13 +402,13 @@ class StorageResource(SyncAPIResource):
         self,
         storage_id: int,
         *,
-        client_id: int | NotGiven = NOT_GIVEN,
+        client_id: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> None:
         """
         Restores a previously deleted S3 storage if it was deleted within the last 2
@@ -411,7 +425,9 @@ class StorageResource(SyncAPIResource):
         """
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return self._post(
-            f"/storage/provisioning/v1/storage/{storage_id}/restore",
+            f"/storage/provisioning/v1/storage/{storage_id}/restore"
+            if self._client._base_url_overridden
+            else f"https://api.gcore.com//storage/provisioning/v1/storage/{storage_id}/restore",
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -432,7 +448,7 @@ class StorageResource(SyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> None:
         """
         Removes SSH key association from an SFTP storage, disabling passwordless
@@ -450,7 +466,9 @@ class StorageResource(SyncAPIResource):
         """
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return self._post(
-            f"/storage/provisioning/v1/storage/{storage_id}/key/{key_id}/unlink",
+            f"/storage/provisioning/v1/storage/{storage_id}/key/{key_id}/unlink"
+            if self._client._base_url_overridden
+            else f"https://api.gcore.com//storage/provisioning/v1/storage/{storage_id}/key/{key_id}/unlink",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -500,14 +518,14 @@ class AsyncStorageResource(AsyncAPIResource):
         location: Literal["s-ed1", "s-drc2", "s-sgc1", "s-nhn2", "s-darz", "s-ws1", "ams", "sin", "fra", "mia"],
         name: str,
         type: Literal["sftp", "s3"],
-        generate_sftp_password: bool | NotGiven = NOT_GIVEN,
-        sftp_password: str | NotGiven = NOT_GIVEN,
+        generate_sftp_password: bool | Omit = omit,
+        sftp_password: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> Storage:
         """
         Creates a new storage instance (S3 or SFTP) in the specified location and
@@ -540,7 +558,9 @@ class AsyncStorageResource(AsyncAPIResource):
           timeout: Override the client-level default timeout for this request, in seconds
         """
         return await self._post(
-            "/storage/provisioning/v2/storage",
+            "/storage/provisioning/v2/storage"
+            if self._client._base_url_overridden
+            else "https://api.gcore.com//storage/provisioning/v2/storage",
             body=await async_maybe_transform(
                 {
                     "location": location,
@@ -561,14 +581,14 @@ class AsyncStorageResource(AsyncAPIResource):
         self,
         storage_id: int,
         *,
-        expires: str | NotGiven = NOT_GIVEN,
-        server_alias: str | NotGiven = NOT_GIVEN,
+        expires: str | Omit = omit,
+        server_alias: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> Storage:
         """Updates storage configuration such as expiration date and server alias.
 
@@ -590,7 +610,9 @@ class AsyncStorageResource(AsyncAPIResource):
           timeout: Override the client-level default timeout for this request, in seconds
         """
         return await self._patch(
-            f"/storage/provisioning/v2/storage/{storage_id}",
+            f"/storage/provisioning/v2/storage/{storage_id}"
+            if self._client._base_url_overridden
+            else f"https://api.gcore.com//storage/provisioning/v2/storage/{storage_id}",
             body=await async_maybe_transform(
                 {
                     "expires": expires,
@@ -607,28 +629,30 @@ class AsyncStorageResource(AsyncAPIResource):
     def list(
         self,
         *,
-        id: str | NotGiven = NOT_GIVEN,
-        limit: int | NotGiven = NOT_GIVEN,
-        location: str | NotGiven = NOT_GIVEN,
-        name: str | NotGiven = NOT_GIVEN,
-        offset: int | NotGiven = NOT_GIVEN,
-        order_by: str | NotGiven = NOT_GIVEN,
-        order_direction: Literal["asc", "desc"] | NotGiven = NOT_GIVEN,
-        show_deleted: bool | NotGiven = NOT_GIVEN,
-        status: Literal["active", "suspended", "deleted", "pending"] | NotGiven = NOT_GIVEN,
-        type: Literal["s3", "sftp"] | NotGiven = NOT_GIVEN,
+        id: str | Omit = omit,
+        limit: int | Omit = omit,
+        location: str | Omit = omit,
+        name: str | Omit = omit,
+        offset: int | Omit = omit,
+        order_by: str | Omit = omit,
+        order_direction: Literal["asc", "desc"] | Omit = omit,
+        show_deleted: bool | Omit = omit,
+        status: Literal["active", "suspended", "deleted", "pending"] | Omit = omit,
+        type: Literal["s3", "sftp"] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AsyncPaginator[Storage, AsyncOffsetPage[Storage]]:
         """
         Returns storages with the same filtering and pagination as v2, but in a
-        simplified response shape for easier client consumption. Response format: count:
-        total number of storages matching the filter (independent of pagination)
-        results: the current page of storages according to limit/offset
+        simplified response shape for easier client consumption.
+
+        Response format: count: total number of storages matching the filter
+        (independent of pagination) results: the current page of storages according to
+        limit/offset
 
         Args:
           id: Filter by storage ID
@@ -660,7 +684,9 @@ class AsyncStorageResource(AsyncAPIResource):
           timeout: Override the client-level default timeout for this request, in seconds
         """
         return self._get_api_list(
-            "/storage/provisioning/v3/storage",
+            "/storage/provisioning/v3/storage"
+            if self._client._base_url_overridden
+            else "https://api.gcore.com//storage/provisioning/v3/storage",
             page=AsyncOffsetPage[Storage],
             options=make_request_options(
                 extra_headers=extra_headers,
@@ -695,7 +721,7 @@ class AsyncStorageResource(AsyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> None:
         """Permanently deletes a storage and all its data.
 
@@ -712,7 +738,9 @@ class AsyncStorageResource(AsyncAPIResource):
         """
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._delete(
-            f"/storage/provisioning/v1/storage/{storage_id}",
+            f"/storage/provisioning/v1/storage/{storage_id}"
+            if self._client._base_url_overridden
+            else f"https://api.gcore.com//storage/provisioning/v1/storage/{storage_id}",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -728,7 +756,7 @@ class AsyncStorageResource(AsyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> Storage:
         """
         Retrieves detailed information about a specific storage including its
@@ -744,7 +772,9 @@ class AsyncStorageResource(AsyncAPIResource):
           timeout: Override the client-level default timeout for this request, in seconds
         """
         return await self._get(
-            f"/storage/provisioning/v1/storage/{storage_id}",
+            f"/storage/provisioning/v1/storage/{storage_id}"
+            if self._client._base_url_overridden
+            else f"https://api.gcore.com//storage/provisioning/v1/storage/{storage_id}",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -761,7 +791,7 @@ class AsyncStorageResource(AsyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> None:
         """
         Associates an SSH public key with an SFTP storage, enabling passwordless
@@ -779,7 +809,9 @@ class AsyncStorageResource(AsyncAPIResource):
         """
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._post(
-            f"/storage/provisioning/v1/storage/{storage_id}/key/{key_id}/link",
+            f"/storage/provisioning/v1/storage/{storage_id}/key/{key_id}/link"
+            if self._client._base_url_overridden
+            else f"https://api.gcore.com//storage/provisioning/v1/storage/{storage_id}/key/{key_id}/link",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -790,13 +822,13 @@ class AsyncStorageResource(AsyncAPIResource):
         self,
         storage_id: int,
         *,
-        client_id: int | NotGiven = NOT_GIVEN,
+        client_id: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> None:
         """
         Restores a previously deleted S3 storage if it was deleted within the last 2
@@ -813,7 +845,9 @@ class AsyncStorageResource(AsyncAPIResource):
         """
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._post(
-            f"/storage/provisioning/v1/storage/{storage_id}/restore",
+            f"/storage/provisioning/v1/storage/{storage_id}/restore"
+            if self._client._base_url_overridden
+            else f"https://api.gcore.com//storage/provisioning/v1/storage/{storage_id}/restore",
             options=make_request_options(
                 extra_headers=extra_headers,
                 extra_query=extra_query,
@@ -836,7 +870,7 @@ class AsyncStorageResource(AsyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> None:
         """
         Removes SSH key association from an SFTP storage, disabling passwordless
@@ -854,7 +888,9 @@ class AsyncStorageResource(AsyncAPIResource):
         """
         extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._post(
-            f"/storage/provisioning/v1/storage/{storage_id}/key/{key_id}/unlink",
+            f"/storage/provisioning/v1/storage/{storage_id}/key/{key_id}/unlink"
+            if self._client._base_url_overridden
+            else f"https://api.gcore.com//storage/provisioning/v1/storage/{storage_id}/key/{key_id}/unlink",
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),