gcore 0.1.0a2__py3-none-any.whl → 0.3.0__py3-none-any.whl

gcore/resources/cloud/instances/instances.py

@@ -139,18 +139,15 @@ class InstancesResource(SyncAPIResource):
         For Linux,
 
         - Use the `user_data` field to provide a
-          <a href=https://cloudinit.readthedocs.io/en/latest/reference/examples.html>cloud-init
-          script</a> in base64 to apply configurations to the instance.
+          [cloud-init script](https://cloudinit.readthedocs.io/en/latest/reference/examples.html)
+          in base64 to apply configurations to the instance.
         - Specify the `username` and `password` to create a new user.
         - When only `password` is provided, it is set as the password for the default
           user of the image.
-        - The `user_data` is ignored when the `password` is specified.
-
-        For Windows,
-
+        - The `user_data` is ignored when the `password` is specified. For Windows,
         - Use the `user_data` field to provide a
-          <a href=https://cloudbase-init.readthedocs.io/en/latest/userdata.html#cloud-config>cloudbase-init
-          script</a> in base64 to create new users on Windows.
+          [cloudbase-init script](https://cloudbase-init.readthedocs.io/en/latest/userdata.html#cloud-config)
+          in base64 to create new users on Windows.
         - Use the `password` field to set the password for the 'Admin' user on Windows.
         - The password of the Admin user cannot be updated via `user_data`.
         - The `username` cannot be specified in the request.
@@ -179,21 +176,20 @@ class InstancesResource(SyncAPIResource):
           name_template: If you want the instance name to be automatically generated based on IP
               addresses, you can provide a name template instead of specifying the name
               manually. The template should include a placeholder that will be replaced during
-              provisioning. Supported placeholders are: `{ip_octets}` (last 3 octets of the
-              IP), `{two_ip_octets}`, and `{one_ip_octet}`.
+              provisioning. Supported placeholders are: `{`ip_octets`}` (last 3 octets of the
+              IP), `{`two_ip_octets`}`, and `{`one_ip_octet`}`.
 
           password: For Linux instances, 'username' and 'password' are used to create a new user.
               When only 'password' is provided, it is set as the password for the default user
               of the image. For Windows instances, 'username' cannot be specified. Use the
               'password' field to set the password for the 'Admin' user on Windows. Use the
-              'user_data' field to provide a script to create new users on Windows. The
-              password of the Admin user cannot be updated via 'user_data'.
+              '`user_data`' field to provide a script to create new users on Windows. The
+              password of the Admin user cannot be updated via '`user_data`'.
 
           security_groups: Specifies security group UUIDs to be applied to all instance network interfaces.
 
-          servergroup_id: Placement group ID for instance placement policy.
-
-              Supported group types:
+          servergroup_id:
+              Placement group ID for instance placement policy. Supported group types:
 
               - `anti-affinity`: Ensures instances are placed on different hosts for high
                 availability.
@@ -202,7 +198,7 @@ class InstancesResource(SyncAPIResource):
                 sharing if needed.
 
           ssh_key_name: Specifies the name of the SSH keypair, created via the
-              <a href="#operation/SSHKeyCollectionViewSet.post">/v1/ssh_keys endpoint</a>.
+              [/v1/`ssh_keys` endpoint](/docs/api-reference/ssh-keys/add-or-generate-ssh-key).
 
           tags: Key-value tags to associate with the resource. A tag is a key-value pair that
               can be associated with a resource, enabling efficient filtering and grouping for
@@ -210,10 +206,10 @@ class InstancesResource(SyncAPIResource):
               modified by the user. Tags are also integrated with cost reports, allowing cost
               data to be filtered based on tag keys or values.
 
-          user_data: String in base64 format. For Linux instances, 'user_data' is ignored when
+          user_data: String in base64 format. For Linux instances, '`user_data`' is ignored when
               'password' field is provided. For Windows instances, Admin user password is set
-              by 'password' field and cannot be updated via 'user_data'. Examples of the
-              user_data: https://cloudinit.readthedocs.io/en/latest/topics/examples.html
+              by 'password' field and cannot be updated via '`user_data`'. Examples of the
+              `user_data`: https://cloudinit.readthedocs.io/en/latest/topics/examples.html
 
           username: For Linux instances, 'username' and 'password' are used to create a new user.
               For Windows instances, 'username' cannot be specified. Use 'password' field to
@@ -258,6 +254,76 @@ class InstancesResource(SyncAPIResource):
             cast_to=TaskIDList,
         )
 
+    def create_and_poll(
+        self,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        flavor: str,
+        interfaces: Iterable[instance_create_params.Interface],
+        volumes: Iterable[instance_create_params.Volume],
+        allow_app_ports: bool | NotGiven = NOT_GIVEN,
+        configuration: Optional[object] | NotGiven = NOT_GIVEN,
+        name: str | NotGiven = NOT_GIVEN,
+        name_template: str | NotGiven = NOT_GIVEN,
+        password: str | NotGiven = NOT_GIVEN,
+        security_groups: Iterable[instance_create_params.SecurityGroup] | NotGiven = NOT_GIVEN,
+        servergroup_id: str | NotGiven = NOT_GIVEN,
+        ssh_key_name: Optional[str] | NotGiven = NOT_GIVEN,
+        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        user_data: str | NotGiven = NOT_GIVEN,
+        username: str | NotGiven = NOT_GIVEN,
+        polling_interval_seconds: int | NotGiven = NOT_GIVEN,
+        # 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,
+    ) -> Instance:
+        """Create one or many instances or basic VMs and poll for the result."""
+        response = self.create(
+            project_id=project_id,
+            region_id=region_id,
+            flavor=flavor,
+            interfaces=interfaces,
+            volumes=volumes,
+            allow_app_ports=allow_app_ports,
+            configuration=configuration,
+            name_template=name_template,
+            name=name,
+            password=password,
+            security_groups=security_groups,
+            servergroup_id=servergroup_id,
+            ssh_key_name=ssh_key_name,
+            tags=tags,
+            user_data=user_data,
+            username=username,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
+        if not response.tasks or len(response.tasks) != 1:
+            raise ValueError(f"Expected exactly one task to be created")
+        task = self._client.cloud.tasks.poll(
+            task_id=response.tasks[0],
+            extra_headers=extra_headers,
+            polling_interval_seconds=polling_interval_seconds,
+        )
+        if (
+            not task.created_resources
+            or not task.created_resources.instances
+            or len(task.created_resources.instances) != 1
+        ):
+            raise ValueError(f"Expected exactly one resource to be created in a task")
+        return self.get(
+            instance_id=task.created_resources.instances[0],
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+        )
+
     def update(
         self,
         instance_id: str,
@@ -382,9 +448,9 @@ class InstancesResource(SyncAPIResource):
 
           exclude_secgroup: Exclude instances with specified security group name
 
-          flavor_id: Filter out instances by flavor_id. Flavor id must match exactly.
+          flavor_id: Filter out instances by `flavor_id`. Flavor id must match exactly.
 
-          flavor_prefix: Filter out instances by flavor_prefix.
+          flavor_prefix: Filter out instances by `flavor_prefix`.
 
           include_ai: Include GPU clusters' servers
 
@@ -411,22 +477,22 @@ class InstancesResource(SyncAPIResource):
 
           order_by: Order by field and direction.
 
-          profile_name: Filter result by ddos protection profile name. Effective only with with_ddos set
-              to true.
+          profile_name: Filter result by ddos protection profile name. Effective only with `with_ddos`
+              set to true.
 
-          protection_status: Filter result by DDoS protection_status. if parameter is provided. Effective
-              only with with_ddos set to true. (Active, Queued or Error)
+          protection_status: Filter result by DDoS `protection_status`. if parameter is provided. Effective
+              only with `with_ddos` set to true. (Active, Queued or Error)
 
           status: Filters instances by status.
 
           tag_key_value: Optional. Filter by tag key-value pairs. curl -G --data-urlencode
-              "tag_key_value={"key": "value"}" --url
+              "`tag_key_value`={"key": "value"}" --url
               "https://example.com/cloud/v1/resource/1/1"
 
-          tag_value: Optional. Filter by tag values. ?tag_value=value1&tag_value=value2
+          tag_value: Optional. Filter by tag values. ?`tag_value`=value1&`tag_value`=value2
 
           type_ddos_profile: Return bare metals either only with advanced or only basic DDoS protection.
-              Effective only with with_ddos set to true. (advanced or basic)
+              Effective only with `with_ddos` set to true. (advanced or basic)
 
           uuid: Filter the server list result by the UUID of the server. Allowed UUID part
 
@@ -561,6 +627,48 @@ class InstancesResource(SyncAPIResource):
             cast_to=TaskIDList,
         )
 
+    def delete_and_poll(
+        self,
+        instance_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        delete_floatings: bool | NotGiven = NOT_GIVEN,
+        floatings: str | NotGiven = NOT_GIVEN,
+        reserved_fixed_ips: str | NotGiven = NOT_GIVEN,
+        volumes: str | NotGiven = NOT_GIVEN,
+        polling_interval_seconds: int | NotGiven = NOT_GIVEN,
+        # 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,
+    ) -> None:
+        """
+        Delete instance and poll for the result. Only the first task will be polled. If you need to poll more tasks, use the `tasks.poll` method.
+        """
+        response = self.delete(
+            instance_id=instance_id,
+            project_id=project_id,
+            region_id=region_id,
+            delete_floatings=delete_floatings,
+            floatings=floatings,
+            reserved_fixed_ips=reserved_fixed_ips,
+            volumes=volumes,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
+        if not response.tasks:
+            raise ValueError("Expected at least one task to be created")
+        self._client.cloud.tasks.poll(
+            task_id=response.tasks[0],
+            extra_headers=extra_headers,
+            polling_interval_seconds=polling_interval_seconds,
+        )
+
     @overload
     def action(
         self,
@@ -579,7 +687,7 @@ class InstancesResource(SyncAPIResource):
     ) -> TaskIDList:
         """
         The action can be one of: start, stop, reboot, powercycle, suspend or resume.
-        Suspend and resume are not available for baremetal instances.
+        Suspend and resume are not available for bare metal instances.
 
         Args:
           action: Instance action name
@@ -613,7 +721,7 @@ class InstancesResource(SyncAPIResource):
     ) -> TaskIDList:
         """
         The action can be one of: start, stop, reboot, powercycle, suspend or resume.
-        Suspend and resume are not available for baremetal instances.
+        Suspend and resume are not available for bare metal instances.
 
         Args:
           action: Instance action name
@@ -711,6 +819,48 @@ class InstancesResource(SyncAPIResource):
             cast_to=TaskIDList,
         )
 
+    def add_to_placement_group_and_poll(
+        self,
+        instance_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        servergroup_id: str,
+        polling_interval_seconds: int | NotGiven = NOT_GIVEN,
+        # 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,
+    ) -> Instance:
+        """
+        Put instance into the server group and poll for the result. Only the first task will be polled. If you need to poll more tasks, use the `tasks.poll` method.
+        """
+        response = self.add_to_placement_group(
+            instance_id=instance_id,
+            project_id=project_id,
+            region_id=region_id,
+            servergroup_id=servergroup_id,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
+        if not response.tasks:
+            raise ValueError("Expected at least one task to be created")
+        self._client.cloud.tasks.poll(
+            task_id=response.tasks[0],
+            extra_headers=extra_headers,
+            polling_interval_seconds=polling_interval_seconds,
+        )
+        return self.get(
+            instance_id=instance_id,
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+        )
+
     def assign_security_group(
         self,
         instance_id: str,
@@ -730,7 +880,7 @@ class InstancesResource(SyncAPIResource):
         """Assign the security group to the server.
 
         To assign multiple security groups to
-        all ports, use the NULL value for the port_id field
+        all ports, use the NULL value for the `port_id` field
 
         Args:
           name: Security group name, applies to all ports
@@ -863,9 +1013,9 @@ class InstancesResource(SyncAPIResource):
 
         - `language` (str, optional): Language for the response content. Affects the
           `ddos_profile` field. Supported values:
-          - `'en'` (default)
-          - `'de'`
-          - `'ru'`
+        - `'en'` (default)
+        - `'de'`
+        - `'ru'`
 
         Args:
           project_id: Project ID
@@ -983,6 +1133,46 @@ class InstancesResource(SyncAPIResource):
             cast_to=TaskIDList,
         )
 
+    def remove_from_placement_group_and_poll(
+        self,
+        instance_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        polling_interval_seconds: int | NotGiven = NOT_GIVEN,
+        # 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,
+    ) -> Instance:
+        """
+        Remove instance from the server group and poll for the result. Only the first task will be polled. If you need to poll more tasks, use the `tasks.poll` method.
+        """
+        response = self.remove_from_placement_group(
+            instance_id=instance_id,
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
+        if not response.tasks:
+            raise ValueError("Expected at least one task to be created")
+        self._client.cloud.tasks.poll(
+            task_id=response.tasks[0],
+            extra_headers=extra_headers,
+            polling_interval_seconds=polling_interval_seconds,
+        )
+        return self.get(
+            instance_id=instance_id,
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+        )
+
     def resize(
         self,
         instance_id: str,
@@ -1026,6 +1216,48 @@ class InstancesResource(SyncAPIResource):
             cast_to=TaskIDList,
         )
 
+    def resize_and_poll(
+        self,
+        instance_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        flavor_id: str,
+        polling_interval_seconds: int | NotGiven = NOT_GIVEN,
+        # 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,
+    ) -> Instance:
+        """
+        Change flavor of the instance and poll for the result. Only the first task will be polled. If you need to poll more tasks, use the `tasks.poll` method.
+        """
+        response = self.resize(
+            instance_id=instance_id,
+            project_id=project_id,
+            region_id=region_id,
+            flavor_id=flavor_id,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
+        if not response.tasks:
+            raise ValueError("Expected at least one task to be created")
+        self._client.cloud.tasks.poll(
+            task_id=response.tasks[0],
+            extra_headers=extra_headers,
+            polling_interval_seconds=polling_interval_seconds,
+        )
+        return self.get(
+            instance_id=instance_id,
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+        )
+
     def unassign_security_group(
         self,
         instance_id: str,
@@ -1045,7 +1277,7 @@ class InstancesResource(SyncAPIResource):
         """Un-assign the security group to the server.
 
         To un-assign multiple security
-        groups to all ports, use the NULL value for the port_id field
+        groups to all ports, use the NULL value for the `port_id` field
 
         Args:
           name: Security group name, applies to all ports
@@ -1149,18 +1381,15 @@ class AsyncInstancesResource(AsyncAPIResource):
         For Linux,
 
         - Use the `user_data` field to provide a
-          <a href=https://cloudinit.readthedocs.io/en/latest/reference/examples.html>cloud-init
-          script</a> in base64 to apply configurations to the instance.
+          [cloud-init script](https://cloudinit.readthedocs.io/en/latest/reference/examples.html)
+          in base64 to apply configurations to the instance.
         - Specify the `username` and `password` to create a new user.
         - When only `password` is provided, it is set as the password for the default
           user of the image.
-        - The `user_data` is ignored when the `password` is specified.
-
-        For Windows,
-
+        - The `user_data` is ignored when the `password` is specified. For Windows,
         - Use the `user_data` field to provide a
-          <a href=https://cloudbase-init.readthedocs.io/en/latest/userdata.html#cloud-config>cloudbase-init
-          script</a> in base64 to create new users on Windows.
+          [cloudbase-init script](https://cloudbase-init.readthedocs.io/en/latest/userdata.html#cloud-config)
+          in base64 to create new users on Windows.
         - Use the `password` field to set the password for the 'Admin' user on Windows.
         - The password of the Admin user cannot be updated via `user_data`.
         - The `username` cannot be specified in the request.
@@ -1189,21 +1418,20 @@ class AsyncInstancesResource(AsyncAPIResource):
           name_template: If you want the instance name to be automatically generated based on IP
               addresses, you can provide a name template instead of specifying the name
               manually. The template should include a placeholder that will be replaced during
-              provisioning. Supported placeholders are: `{ip_octets}` (last 3 octets of the
-              IP), `{two_ip_octets}`, and `{one_ip_octet}`.
+              provisioning. Supported placeholders are: `{`ip_octets`}` (last 3 octets of the
+              IP), `{`two_ip_octets`}`, and `{`one_ip_octet`}`.
 
           password: For Linux instances, 'username' and 'password' are used to create a new user.
               When only 'password' is provided, it is set as the password for the default user
               of the image. For Windows instances, 'username' cannot be specified. Use the
               'password' field to set the password for the 'Admin' user on Windows. Use the
-              'user_data' field to provide a script to create new users on Windows. The
-              password of the Admin user cannot be updated via 'user_data'.
+              '`user_data`' field to provide a script to create new users on Windows. The
+              password of the Admin user cannot be updated via '`user_data`'.
 
           security_groups: Specifies security group UUIDs to be applied to all instance network interfaces.
 
-          servergroup_id: Placement group ID for instance placement policy.
-
-              Supported group types:
+          servergroup_id:
+              Placement group ID for instance placement policy. Supported group types:
 
               - `anti-affinity`: Ensures instances are placed on different hosts for high
                 availability.
@@ -1212,7 +1440,7 @@ class AsyncInstancesResource(AsyncAPIResource):
                 sharing if needed.
 
           ssh_key_name: Specifies the name of the SSH keypair, created via the
-              <a href="#operation/SSHKeyCollectionViewSet.post">/v1/ssh_keys endpoint</a>.
+              [/v1/`ssh_keys` endpoint](/docs/api-reference/ssh-keys/add-or-generate-ssh-key).
 
           tags: Key-value tags to associate with the resource. A tag is a key-value pair that
               can be associated with a resource, enabling efficient filtering and grouping for
@@ -1220,10 +1448,10 @@ class AsyncInstancesResource(AsyncAPIResource):
               modified by the user. Tags are also integrated with cost reports, allowing cost
               data to be filtered based on tag keys or values.
 
-          user_data: String in base64 format. For Linux instances, 'user_data' is ignored when
+          user_data: String in base64 format. For Linux instances, '`user_data`' is ignored when
               'password' field is provided. For Windows instances, Admin user password is set
-              by 'password' field and cannot be updated via 'user_data'. Examples of the
-              user_data: https://cloudinit.readthedocs.io/en/latest/topics/examples.html
+              by 'password' field and cannot be updated via '`user_data`'. Examples of the
+              `user_data`: https://cloudinit.readthedocs.io/en/latest/topics/examples.html
 
           username: For Linux instances, 'username' and 'password' are used to create a new user.
               For Windows instances, 'username' cannot be specified. Use 'password' field to
@@ -1268,6 +1496,76 @@ class AsyncInstancesResource(AsyncAPIResource):
             cast_to=TaskIDList,
         )
 
+    async def create_and_poll(
+        self,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        flavor: str,
+        interfaces: Iterable[instance_create_params.Interface],
+        volumes: Iterable[instance_create_params.Volume],
+        allow_app_ports: bool | NotGiven = NOT_GIVEN,
+        configuration: Optional[object] | NotGiven = NOT_GIVEN,
+        name: str | NotGiven = NOT_GIVEN,
+        name_template: str | NotGiven = NOT_GIVEN,
+        password: str | NotGiven = NOT_GIVEN,
+        security_groups: Iterable[instance_create_params.SecurityGroup] | NotGiven = NOT_GIVEN,
+        servergroup_id: str | NotGiven = NOT_GIVEN,
+        ssh_key_name: Optional[str] | NotGiven = NOT_GIVEN,
+        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        user_data: str | NotGiven = NOT_GIVEN,
+        username: str | NotGiven = NOT_GIVEN,
+        polling_interval_seconds: int | NotGiven = NOT_GIVEN,
+        # 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,
+    ) -> Instance:
+        """Create one or many instances or basic VMs and poll for the result."""
+        response = await self.create(
+            project_id=project_id,
+            region_id=region_id,
+            flavor=flavor,
+            interfaces=interfaces,
+            volumes=volumes,
+            allow_app_ports=allow_app_ports,
+            configuration=configuration,
+            name_template=name_template,
+            name=name,
+            password=password,
+            security_groups=security_groups,
+            servergroup_id=servergroup_id,
+            ssh_key_name=ssh_key_name,
+            tags=tags,
+            user_data=user_data,
+            username=username,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
+        if not response.tasks or len(response.tasks) != 1:
+            raise ValueError(f"Expected exactly one task to be created")
+        task = await self._client.cloud.tasks.poll(
+            task_id=response.tasks[0],
+            extra_headers=extra_headers,
+            polling_interval_seconds=polling_interval_seconds,
+        )
+        if (
+            not task.created_resources
+            or not task.created_resources.instances
+            or len(task.created_resources.instances) != 1
+        ):
+            raise ValueError(f"Expected exactly one resource to be created in a task")
+        return await self.get(
+            instance_id=task.created_resources.instances[0],
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+        )
+
     async def update(
         self,
         instance_id: str,
@@ -1392,9 +1690,9 @@ class AsyncInstancesResource(AsyncAPIResource):
 
           exclude_secgroup: Exclude instances with specified security group name
 
-          flavor_id: Filter out instances by flavor_id. Flavor id must match exactly.
+          flavor_id: Filter out instances by `flavor_id`. Flavor id must match exactly.
 
-          flavor_prefix: Filter out instances by flavor_prefix.
+          flavor_prefix: Filter out instances by `flavor_prefix`.
 
           include_ai: Include GPU clusters' servers
 
@@ -1421,22 +1719,22 @@ class AsyncInstancesResource(AsyncAPIResource):
 
           order_by: Order by field and direction.
 
-          profile_name: Filter result by ddos protection profile name. Effective only with with_ddos set
-              to true.
+          profile_name: Filter result by ddos protection profile name. Effective only with `with_ddos`
+              set to true.
 
-          protection_status: Filter result by DDoS protection_status. if parameter is provided. Effective
-              only with with_ddos set to true. (Active, Queued or Error)
+          protection_status: Filter result by DDoS `protection_status`. if parameter is provided. Effective
+              only with `with_ddos` set to true. (Active, Queued or Error)
 
           status: Filters instances by status.
 
           tag_key_value: Optional. Filter by tag key-value pairs. curl -G --data-urlencode
-              "tag_key_value={"key": "value"}" --url
+              "`tag_key_value`={"key": "value"}" --url
               "https://example.com/cloud/v1/resource/1/1"
 
-          tag_value: Optional. Filter by tag values. ?tag_value=value1&tag_value=value2
+          tag_value: Optional. Filter by tag values. ?`tag_value`=value1&`tag_value`=value2
 
           type_ddos_profile: Return bare metals either only with advanced or only basic DDoS protection.
-              Effective only with with_ddos set to true. (advanced or basic)
+              Effective only with `with_ddos` set to true. (advanced or basic)
 
           uuid: Filter the server list result by the UUID of the server. Allowed UUID part
 
@@ -1571,6 +1869,48 @@ class AsyncInstancesResource(AsyncAPIResource):
             cast_to=TaskIDList,
         )
 
+    async def delete_and_poll(
+        self,
+        instance_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        delete_floatings: bool | NotGiven = NOT_GIVEN,
+        floatings: str | NotGiven = NOT_GIVEN,
+        reserved_fixed_ips: str | NotGiven = NOT_GIVEN,
+        volumes: str | NotGiven = NOT_GIVEN,
+        polling_interval_seconds: int | NotGiven = NOT_GIVEN,
+        # 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,
+    ) -> None:
+        """
+        Delete instance and poll for the result. Only the first task will be polled. If you need to poll more tasks, use the `tasks.poll` method.
+        """
+        response = await self.delete(
+            instance_id=instance_id,
+            project_id=project_id,
+            region_id=region_id,
+            delete_floatings=delete_floatings,
+            floatings=floatings,
+            reserved_fixed_ips=reserved_fixed_ips,
+            volumes=volumes,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
+        if not response.tasks:
+            raise ValueError("Expected at least one task to be created")
+        await self._client.cloud.tasks.poll(
+            task_id=response.tasks[0],
+            extra_headers=extra_headers,
+            polling_interval_seconds=polling_interval_seconds,
+        )
+
     @overload
     async def action(
         self,
@@ -1589,7 +1929,7 @@ class AsyncInstancesResource(AsyncAPIResource):
     ) -> TaskIDList:
         """
         The action can be one of: start, stop, reboot, powercycle, suspend or resume.
-        Suspend and resume are not available for baremetal instances.
+        Suspend and resume are not available for bare metal instances.
 
         Args:
           action: Instance action name
@@ -1623,7 +1963,7 @@ class AsyncInstancesResource(AsyncAPIResource):
     ) -> TaskIDList:
         """
         The action can be one of: start, stop, reboot, powercycle, suspend or resume.
-        Suspend and resume are not available for baremetal instances.
+        Suspend and resume are not available for bare metal instances.
 
         Args:
           action: Instance action name
@@ -1721,6 +2061,48 @@ class AsyncInstancesResource(AsyncAPIResource):
             cast_to=TaskIDList,
         )
 
+    async def add_to_placement_group_and_poll(
+        self,
+        instance_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        servergroup_id: str,
+        polling_interval_seconds: int | NotGiven = NOT_GIVEN,
+        # 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,
+    ) -> Instance:
+        """
+        Put instance into the server group and poll for the result. Only the first task will be polled. If you need to poll more tasks, use the `tasks.poll` method.
+        """
+        response = await self.add_to_placement_group(
+            instance_id=instance_id,
+            project_id=project_id,
+            region_id=region_id,
+            servergroup_id=servergroup_id,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
+        if not response.tasks:
+            raise ValueError("Expected at least one task to be created")
+        await self._client.cloud.tasks.poll(
+            task_id=response.tasks[0],
+            extra_headers=extra_headers,
+            polling_interval_seconds=polling_interval_seconds,
+        )
+        return await self.get(
+            instance_id=instance_id,
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+        )
+
     async def assign_security_group(
         self,
         instance_id: str,
@@ -1740,7 +2122,7 @@ class AsyncInstancesResource(AsyncAPIResource):
         """Assign the security group to the server.
 
         To assign multiple security groups to
-        all ports, use the NULL value for the port_id field
+        all ports, use the NULL value for the `port_id` field
 
         Args:
           name: Security group name, applies to all ports
@@ -1873,9 +2255,9 @@ class AsyncInstancesResource(AsyncAPIResource):
 
         - `language` (str, optional): Language for the response content. Affects the
           `ddos_profile` field. Supported values:
-          - `'en'` (default)
-          - `'de'`
-          - `'ru'`
+        - `'en'` (default)
+        - `'de'`
+        - `'ru'`
 
         Args:
           project_id: Project ID
@@ -1993,6 +2375,46 @@ class AsyncInstancesResource(AsyncAPIResource):
             cast_to=TaskIDList,
         )
 
+    async def remove_from_placement_group_and_poll(
+        self,
+        instance_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        polling_interval_seconds: int | NotGiven = NOT_GIVEN,
+        # 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,
+    ) -> Instance:
+        """
+        Remove instance from the server group and poll for the result. Only the first task will be polled. If you need to poll more tasks, use the `tasks.poll` method.
+        """
+        response = await self.remove_from_placement_group(
+            instance_id=instance_id,
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
+        if not response.tasks:
+            raise ValueError("Expected at least one task to be created")
+        await self._client.cloud.tasks.poll(
+            task_id=response.tasks[0],
+            extra_headers=extra_headers,
+            polling_interval_seconds=polling_interval_seconds,
+        )
+        return await self.get(
+            instance_id=instance_id,
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+        )
+
     async def resize(
         self,
         instance_id: str,
@@ -2036,6 +2458,48 @@ class AsyncInstancesResource(AsyncAPIResource):
             cast_to=TaskIDList,
         )
 
+    async def resize_and_poll(
+        self,
+        instance_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        flavor_id: str,
+        polling_interval_seconds: int | NotGiven = NOT_GIVEN,
+        # 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,
+    ) -> Instance:
+        """
+        Change flavor of the instance and poll for the result. Only the first task will be polled. If you need to poll more tasks, use the `tasks.poll` method.
+        """
+        response = await self.resize(
+            instance_id=instance_id,
+            project_id=project_id,
+            region_id=region_id,
+            flavor_id=flavor_id,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
+        if not response.tasks:
+            raise ValueError("Expected at least one task to be created")
+        await self._client.cloud.tasks.poll(
+            task_id=response.tasks[0],
+            extra_headers=extra_headers,
+            polling_interval_seconds=polling_interval_seconds,
+        )
+        return await self.get(
+            instance_id=instance_id,
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+        )
+
     async def unassign_security_group(
         self,
         instance_id: str,
@@ -2055,7 +2519,7 @@ class AsyncInstancesResource(AsyncAPIResource):
         """Un-assign the security group to the server.
 
         To un-assign multiple security
-        groups to all ports, use the NULL value for the port_id field
+        groups to all ports, use the NULL value for the `port_id` field
 
         Args:
           name: Security group name, applies to all ports