feat(api): aggregated API specs update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 228
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gcore%2Fgcore-b76145629dcc7d96b116490429fbcb6fb4a9c12a3d0a738078a681973c14081d.yml
-openapi_spec_hash: 92240813810f5bc1b57c044484ca978e
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gcore%2Fgcore-516ce876afb897cc3b1c0018510f6e5fb3d35fd8a5323ba374e7f115a7e825af.yml
+openapi_spec_hash: 3738369958f249df6dcff1d73f71b8d9
 config_hash: 4ce0219e37d7ed52a8e999f415c64cd6

src/gcore/resources/cloud/networks/networks.py

@@ -91,6 +91,10 @@ def create(
         Create network
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
           name: Network name
 
           create_router: Defaults to True
@@ -150,6 +154,12 @@ def update(
         Change network name
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          network_id: Network ID
+
           name: Name.
 
           extra_headers: Send extra headers
@@ -182,7 +192,7 @@ def list(
         region_id: int | None = None,
         limit: int | NotGiven = NOT_GIVEN,
         offset: int | NotGiven = NOT_GIVEN,
-        order_by: str | NotGiven = NOT_GIVEN,
+        order_by: Literal["created_at.asc", "created_at.desc", "name.asc", "name.desc"] | NotGiven = NOT_GIVEN,
         tag_key: List[str] | NotGiven = NOT_GIVEN,
         tag_key_value: str | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -196,17 +206,23 @@ def list(
         List networks
 
         Args:
-          limit: Limit the number of returned limit request entities.
+          project_id: Project ID
+
+          region_id: Region ID
+
+          limit: Optional. Limit the number of returned items
 
-          offset: Offset value is used to exclude the first set of records from the result.
+          offset: Optional. Offset value is used to exclude the first set of records from the
+              result
 
-          order_by: Order networks by fields and directions (name.asc). Default is `created_at.asc`.
+          order_by: Ordering networks list result by `name`, `created_at` fields of the network and
+              directions (`created_at.desc`).
 
-          tag_key: Filter by tag keys.
+          tag_key: Optional. Filter by tag keys. ?tag_key=key1&tag_key=key2
 
-          tag_key_value: Filter by tag key-value pairs. Must be a valid JSON string. curl -G
-              --data-urlencode "tag_key_value={"key": "value"}" --url
-              "http://localhost:1111/v1/networks/1/1"
+          tag_key_value: Optional. Filter by tag key-value pairs. curl -G --data-urlencode
+              "tag_key_value={"key": "value"}" --url
+              "https://example.com/cloud/v1/resource/1/1"
 
           extra_headers: Send extra headers
 
@@ -259,6 +275,12 @@ def delete(
         Delete network
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          network_id: Network ID
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -298,6 +320,12 @@ def get(
         Get network
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          network_id: Network ID
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -369,6 +397,10 @@ async def create(
         Create network
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
           name: Network name
 
           create_router: Defaults to True
@@ -428,6 +460,12 @@ async def update(
         Change network name
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          network_id: Network ID
+
           name: Name.
 
           extra_headers: Send extra headers
@@ -460,7 +498,7 @@ def list(
         region_id: int | None = None,
         limit: int | NotGiven = NOT_GIVEN,
         offset: int | NotGiven = NOT_GIVEN,
-        order_by: str | NotGiven = NOT_GIVEN,
+        order_by: Literal["created_at.asc", "created_at.desc", "name.asc", "name.desc"] | NotGiven = NOT_GIVEN,
         tag_key: List[str] | NotGiven = NOT_GIVEN,
         tag_key_value: str | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -474,17 +512,23 @@ def list(
         List networks
 
         Args:
-          limit: Limit the number of returned limit request entities.
+          project_id: Project ID
+
+          region_id: Region ID
+
+          limit: Optional. Limit the number of returned items
 
-          offset: Offset value is used to exclude the first set of records from the result.
+          offset: Optional. Offset value is used to exclude the first set of records from the
+              result
 
-          order_by: Order networks by fields and directions (name.asc). Default is `created_at.asc`.
+          order_by: Ordering networks list result by `name`, `created_at` fields of the network and
+              directions (`created_at.desc`).
 
-          tag_key: Filter by tag keys.
+          tag_key: Optional. Filter by tag keys. ?tag_key=key1&tag_key=key2
 
-          tag_key_value: Filter by tag key-value pairs. Must be a valid JSON string. curl -G
-              --data-urlencode "tag_key_value={"key": "value"}" --url
-              "http://localhost:1111/v1/networks/1/1"
+          tag_key_value: Optional. Filter by tag key-value pairs. curl -G --data-urlencode
+              "tag_key_value={"key": "value"}" --url
+              "https://example.com/cloud/v1/resource/1/1"
 
           extra_headers: Send extra headers
 
@@ -537,6 +581,12 @@ async def delete(
         Delete network
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          network_id: Network ID
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -576,6 +626,12 @@ async def get(
         Get network
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          network_id: Network ID
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request

src/gcore/types/cloud/network.py

@@ -16,9 +16,18 @@ class Network(BaseModel):
     created_at: datetime
     """Datetime when the network was created"""
 
+    creator_task_id: Optional[str] = None
+    """Task that created this entity"""
+
+    default: Optional[bool] = None
+    """True if network has is_default attribute"""
+
     external: bool
     """True if the network `router:external` attribute"""
 
+    mtu: int
+    """MTU (maximum transmission unit). Default value is 1450"""
+
     name: str
     """Network name"""
 
@@ -28,12 +37,18 @@ class Network(BaseModel):
     ports.
     """
 
+    project_id: Optional[int] = None
+    """Project ID"""
+
     region: str
     """Region name"""
 
     region_id: int
     """Region ID"""
 
+    segmentation_id: Optional[int] = None
+    """Id of network segment"""
+
     shared: bool
     """True when the network is shared with your project by external owner"""
 
@@ -50,30 +65,15 @@ class Network(BaseModel):
     values.
     """
 
-    type: str
-    """Network type (vlan, vxlan)"""
-
-    updated_at: datetime
-    """Datetime when the network was last updated"""
-
-    creator_task_id: Optional[str] = None
-    """Task that created this entity"""
-
-    default: Optional[bool] = None
-    """True if network has is_default attribute"""
-
-    mtu: Optional[int] = None
-    """MTU (maximum transmission unit). Default value is 1450"""
-
-    project_id: Optional[int] = None
-    """Project ID"""
-
-    segmentation_id: Optional[int] = None
-    """Id of network segment"""
-
     task_id: Optional[str] = None
     """The UUID of the active task that currently holds a lock on the resource.
 
     This lock prevents concurrent modifications to ensure consistency. If `null`,
     the resource is not locked.
     """
+
+    type: str
+    """Network type (vlan, vxlan)"""
+
+    updated_at: datetime
+    """Datetime when the network was last updated"""

src/gcore/types/cloud/network_create_params.py

@@ -11,8 +11,10 @@
 
 class NetworkCreateParams(TypedDict, total=False):
     project_id: int
+    """Project ID"""
 
     region_id: int
+    """Region ID"""
 
     name: Required[str]
     """Network name"""

src/gcore/types/cloud/network_details.py

@@ -17,9 +17,18 @@ class NetworkDetails(BaseModel):
     created_at: datetime
     """Datetime when the network was created"""
 
+    creator_task_id: Optional[str] = None
+    """Task that created this entity"""
+
+    default: Optional[bool] = None
+    """True if network has is_default attribute"""
+
     external: bool
     """True if the network `router:external` attribute"""
 
+    mtu: int
+    """MTU (maximum transmission unit). Default value is 1450"""
+
     name: str
     """Network name"""
 
@@ -29,15 +38,24 @@ class NetworkDetails(BaseModel):
     ports.
     """
 
+    project_id: Optional[int] = None
+    """Project ID"""
+
     region: str
     """Region name"""
 
     region_id: int
     """Region ID"""
 
+    segmentation_id: Optional[int] = None
+    """Id of network segment"""
+
     shared: bool
     """True when the network is shared with your project by external owner"""
 
+    subnets: List[Subnet]
+    """List of subnets associated with the network"""
+
     tags: List[Tag]
     """List of key-value tags associated with the resource.
 
@@ -48,32 +66,15 @@ class NetworkDetails(BaseModel):
     values.
     """
 
-    type: str
-    """Network type (vlan, vxlan)"""
-
-    updated_at: datetime
-    """Datetime when the network was last updated"""
-
-    creator_task_id: Optional[str] = None
-    """Task that created this entity"""
-
-    default: Optional[bool] = None
-    """True if network has is_default attribute"""
-
-    mtu: Optional[int] = None
-    """MTU (maximum transmission unit). Default value is 1450"""
-
-    project_id: Optional[int] = None
-    """Project ID"""
-
-    segmentation_id: Optional[int] = None
-    """Id of network segment"""
-
-    subnets: Optional[List[Subnet]] = None
-
     task_id: Optional[str] = None
     """The UUID of the active task that currently holds a lock on the resource.
 
     This lock prevents concurrent modifications to ensure consistency. If `null`,
     the resource is not locked.
     """
+
+    type: str
+    """Network type (vlan, vxlan)"""
+
+    updated_at: datetime
+    """Datetime when the network was last updated"""