@scaleway/sdk 2.72.0 → 2.73.0

package/dist/api/instance/v1/api.gen.d.ts

@@ -4,8 +4,8 @@ import type { ApplyBlockMigrationRequest, AttachServerVolumeRequest, AttachServe
 import type { SetImageResponse, SetSecurityGroupRequest, SetSecurityGroupResponse, SetSecurityGroupRuleRequest, SetSecurityGroupRuleResponse, SetServerRequest, SetServerResponse, SetSnapshotRequest, SetSnapshotResponse } from './types.private.gen';
 /**
  * Instance API.
- *
- * This API allows you to manage your Instances.
+
+This API allows you to manage your CPU and GPU Instances.
  */
 export declare class API extends ParentAPI {
     /** Lists the available zones of the API. */
@@ -18,8 +18,7 @@ export declare class API extends ParentAPI {
      */
     getServerTypesAvailability: (request?: Readonly<GetServerTypesAvailabilityRequest>) => Promise<GetServerTypesAvailabilityResponse>;
     /**
-     * List Instance types. List available Instance types and their technical
-     * details.
+     * List Instance types. List available Instance types and their technical details.
      *
      * @param request - The request {@link ListServersTypesRequest}
      * @returns A Promise of ListServersTypesResponse
@@ -34,8 +33,7 @@ export declare class API extends ParentAPI {
     listVolumesTypes: (request?: Readonly<ListVolumesTypesRequest>) => Promise<ListVolumesTypesResponse>;
     protected pageOfListServers: (request?: Readonly<ListServersRequest>) => Promise<ListServersResponse>;
     /**
-     * List all Instances. List all Instances in a specified Availability Zone,
-     * e.g. `fr-par-1`.
+     * List all Instances. List all Instances in a specified Availability Zone, e.g. `fr-par-1`.
      *
      * @param request - The request {@link ListServersRequest}
      * @returns A Promise of ListServersResponse
@@ -61,34 +59,29 @@ export declare class API extends ParentAPI {
     protected _setServer: (request: Readonly<SetServerRequest>) => Promise<SetServerResponse>;
     protected _updateServer: (request: Readonly<UpdateServerRequest>) => Promise<UpdateServerResponse>;
     /**
-     * List Instance actions. List all actions (e.g. power on, power off, reboot)
-     * that can currently be performed on an Instance.
+     * List Instance actions. List all actions (e.g. power on, power off, reboot) that can currently be performed on an Instance.
      *
      * @param request - The request {@link ListServerActionsRequest}
      * @returns A Promise of ListServerActionsResponse
      */
     listServerActions: (request: Readonly<ListServerActionsRequest>) => Promise<ListServerActionsResponse>;
     /**
-     * Perform action. Perform an action on an Instance. Available actions are:
-     * `poweron`: Start a stopped Instance. `poweroff`: Fully stop the Instance
-     * and release the hypervisor slot. `stop_in_place`: Stop the Instance, but
-     * keep the slot on the hypervisor. `reboot`: Stop the instance and restart
-     * it. `backup`: Create an image with all the volumes of an Instance.
-     * `terminate`: Delete the Instance along with its attached volumes, except
-     * for SBS volumes. `enable_routed_ip`: Migrate the Instance to the new
-     * network stack.
-     *
-     * The `terminate` action will result in the deletion of `l_ssd`, `b_ssd` and
-     * `scratch` volumes types, `sbs_volume` volumes type will only be detached.
-     * If you want to preserve your volumes, you should detach them before the
-     * Instance deletion or `terminate` action.
-     *
-     * The `backup` action can be done with: No `volumes` key in the body: an
-     * image is created with snapshots of all the server volumes, except for the
-     * `scratch` volumes types. `volumes` key in the body with a dictionary as
-     * value, in this dictionary volumes UUID as keys and empty dictionaries as
-     * values : an image is created with the snapshots of the volumes in `volumes`
-     * key. `scratch` volumes types can't be shapshotted.
+     * Perform action. Perform an action on an Instance.
+  Available actions are:
+  * `poweron`: Start a stopped Instance.
+  * `poweroff`: Fully stop the Instance and release the hypervisor slot.
+  * `stop_in_place`: Stop the Instance, but keep the slot on the hypervisor.
+  * `reboot`: Stop the instance and restart it.
+  * `backup`:  Create an image with all the volumes of an Instance.
+  * `terminate`: Delete the Instance along with its attached volumes, except for SBS volumes.
+  * `enable_routed_ip`: Migrate the Instance to the new network stack.
+  
+  The `terminate` action will result in the deletion of `l_ssd`, `b_ssd` and `scratch` volumes types, `sbs_volume` volumes type will only be detached.
+  If you want to preserve your volumes, you should detach them before the Instance deletion or `terminate` action.
+  
+  The `backup` action can be done with:
+  * No `volumes` key in the body: an image is created with snapshots of all the server volumes, except for the `scratch` volumes types.
+  * `volumes` key in the body with a dictionary as value, in this dictionary volumes UUID as keys and empty dictionaries as values : an image is created with the snapshots of the volumes in `volumes` key. `scratch` volumes types can't be shapshotted.
      *
      * @param request - The request {@link ServerActionRequest}
      * @returns A Promise of ServerActionResponse
@@ -108,12 +101,12 @@ export declare class API extends ParentAPI {
      */
     deleteServerUserData: (request: Readonly<DeleteServerUserDataRequest>) => Promise<void>;
     /**
-     * Get Instance compatible types. Get compatible commercial types that can be
-     * used to update the Instance. The compatibility of an Instance offer is
-     * based on: the CPU architecture the OS type the required l_ssd storage size
-     * the required scratch storage size If the specified Instance offer is
-     * flagged as end of service, the best compatible offer is the first
-     * returned.
+     * Get Instance compatible types. Get compatible commercial types that can be used to update the Instance. The compatibility of an Instance offer is based on:
+  * the CPU architecture
+  * the OS type
+  * the required l_ssd storage size
+  * the required scratch storage size
+  If the specified Instance offer is flagged as end of service, the best compatible offer is the first returned.
      *
      * @param request - The request {@link GetServerCompatibleTypesRequest}
      * @returns A Promise of ServerCompatibleTypes
@@ -140,8 +133,7 @@ export declare class API extends ParentAPI {
      */
     getImage: (request: Readonly<GetImageRequest>) => Promise<GetImageResponse>;
     /**
-     * Create an Instance image. Create an Instance image from the specified
-     * snapshot ID.
+     * Create an Instance image. Create an Instance image from the specified snapshot ID.
      *
      * @param request - The request {@link CreateImageRequest}
      * @returns A Promise of CreateImageResponse
@@ -163,8 +155,7 @@ export declare class API extends ParentAPI {
     deleteImage: (request: Readonly<DeleteImageRequest>) => Promise<void>;
     protected pageOfListSnapshots: (request?: Readonly<ListSnapshotsRequest>) => Promise<ListSnapshotsResponse>;
     /**
-     * List snapshots. List all snapshots of an Organization in a specified
-     * Availability Zone.
+     * List snapshots. List all snapshots of an Organization in a specified Availability Zone.
      *
      * @param request - The request {@link ListSnapshotsRequest}
      * @returns A Promise of ListSnapshotsResponse
@@ -174,9 +165,7 @@ export declare class API extends ParentAPI {
         [Symbol.asyncIterator]: () => AsyncGenerator<import("./types.gen").Snapshot[], void, void>;
     };
     /**
-     * Create a snapshot from a specified volume or from a QCOW2 file. Create a
-     * snapshot from a specified volume or from a QCOW2 file in a specified
-     * Availability Zone.
+     * Create a snapshot from a specified volume or from a QCOW2 file. Create a snapshot from a specified volume or from a QCOW2 file in a specified Availability Zone.
      *
      * @param request - The request {@link CreateSnapshotRequest}
      * @returns A Promise of CreateSnapshotResponse
@@ -204,8 +193,7 @@ export declare class API extends ParentAPI {
      */
     deleteSnapshot: (request: Readonly<DeleteSnapshotRequest>) => Promise<void>;
     /**
-     * Export a snapshot. Export a snapshot to a specified Object Storage bucket
-     * in the same region.
+     * Export a snapshot. Export a snapshot to a specified Object Storage bucket in the same region.
      *
      * @param request - The request {@link ExportSnapshotRequest}
      * @returns A Promise of ExportSnapshotResponse
@@ -213,8 +201,7 @@ export declare class API extends ParentAPI {
     exportSnapshot: (request: Readonly<ExportSnapshotRequest>) => Promise<ExportSnapshotResponse>;
     protected pageOfListVolumes: (request?: Readonly<ListVolumesRequest>) => Promise<ListVolumesResponse>;
     /**
-     * List volumes. List volumes in the specified Availability Zone. You can
-     * filter the output by volume type.
+     * List volumes. List volumes in the specified Availability Zone. You can filter the output by volume type.
      *
      * @param request - The request {@link ListVolumesRequest}
      * @returns A Promise of ListVolumesResponse
@@ -224,8 +211,7 @@ export declare class API extends ParentAPI {
         [Symbol.asyncIterator]: () => AsyncGenerator<import("./types.gen").Volume[], void, void>;
     };
     /**
-     * Create a volume. Create a volume of a specified type in an Availability
-     * Zone.
+     * Create a volume. Create a volume of a specified type in an Availability Zone.
      *
      * @param request - The request {@link CreateVolumeRequest}
      * @returns A Promise of CreateVolumeResponse
@@ -239,9 +225,7 @@ export declare class API extends ParentAPI {
      */
     getVolume: (request: Readonly<GetVolumeRequest>) => Promise<GetVolumeResponse>;
     /**
-     * Update a volume. Replace the name and/or size properties of a volume
-     * specified by its ID, with the specified value(s). Any volume name can be
-     * changed, however only `b_ssd` volumes can currently be increased in size.
+     * Update a volume. Replace the name and/or size properties of a volume specified by its ID, with the specified value(s). Any volume name can be changed, however only `b_ssd` volumes can currently be increased in size.
      *
      * @param request - The request {@link UpdateVolumeRequest}
      * @returns A Promise of UpdateVolumeResponse
@@ -265,16 +249,14 @@ export declare class API extends ParentAPI {
         [Symbol.asyncIterator]: () => AsyncGenerator<import("./types.gen").SecurityGroup[], void, void>;
     };
     /**
-     * Create a security group. Create a security group with a specified name and
-     * description.
+     * Create a security group. Create a security group with a specified name and description.
      *
      * @param request - The request {@link CreateSecurityGroupRequest}
      * @returns A Promise of CreateSecurityGroupResponse
      */
     createSecurityGroup: (request: Readonly<CreateSecurityGroupRequest>) => Promise<CreateSecurityGroupResponse>;
     /**
-     * Get a security group. Get the details of a security group with the
-     * specified ID.
+     * Get a security group. Get the details of a security group with the specified ID.
      *
      * @param request - The request {@link GetSecurityGroupRequest}
      * @returns A Promise of GetSecurityGroupResponse
@@ -295,8 +277,7 @@ export declare class API extends ParentAPI {
      */
     updateSecurityGroup: (request: Readonly<UpdateSecurityGroupRequest>) => Promise<UpdateSecurityGroupResponse>;
     /**
-     * Get default rules. Lists the default rules applied to all the security
-     * groups.
+     * Get default rules. Lists the default rules applied to all the security groups.
      *
      * @param request - The request {@link ListDefaultSecurityGroupRulesRequest}
      * @returns A Promise of ListSecurityGroupRulesResponse
@@ -321,10 +302,7 @@ export declare class API extends ParentAPI {
      */
     createSecurityGroupRule: (request: Readonly<CreateSecurityGroupRuleRequest>) => Promise<CreateSecurityGroupRuleResponse>;
     /**
-     * Update all the rules of a security group. Replaces the existing rules of
-     * the security group with the rules provided. This endpoint supports the
-     * update of existing rules, creation of new rules and deletion of existing
-     * rules when they are not passed in the request.
+     * Update all the rules of a security group. Replaces the existing rules of the security group with the rules provided. This endpoint supports the update of existing rules, creation of new rules and deletion of existing rules when they are not passed in the request.
      *
      * @param request - The request {@link SetSecurityGroupRulesRequest}
      * @returns A Promise of SetSecurityGroupRulesResponse
@@ -345,8 +323,7 @@ export declare class API extends ParentAPI {
     getSecurityGroupRule: (request: Readonly<GetSecurityGroupRuleRequest>) => Promise<GetSecurityGroupRuleResponse>;
     protected _setSecurityGroupRule: (request: Readonly<SetSecurityGroupRuleRequest>) => Promise<SetSecurityGroupRuleResponse>;
     /**
-     * Update security group rule. Update the properties of a rule from a
-     * specified security group.
+     * Update security group rule. Update the properties of a rule from a specified security group.
      *
      * @param request - The request {@link UpdateSecurityGroupRuleRequest}
      * @returns A Promise of UpdateSecurityGroupRuleResponse
@@ -354,8 +331,7 @@ export declare class API extends ParentAPI {
     updateSecurityGroupRule: (request: Readonly<UpdateSecurityGroupRuleRequest>) => Promise<UpdateSecurityGroupRuleResponse>;
     protected pageOfListPlacementGroups: (request?: Readonly<ListPlacementGroupsRequest>) => Promise<ListPlacementGroupsResponse>;
     /**
-     * List placement groups. List all placement groups in a specified
-     * Availability Zone.
+     * List placement groups. List all placement groups in a specified Availability Zone.
      *
      * @param request - The request {@link ListPlacementGroupsRequest}
      * @returns A Promise of ListPlacementGroupsResponse
@@ -365,8 +341,7 @@ export declare class API extends ParentAPI {
         [Symbol.asyncIterator]: () => AsyncGenerator<import("./types.gen").PlacementGroup[], void, void>;
     };
     /**
-     * Create a placement group. Create a new placement group in a specified
-     * Availability Zone.
+     * Create a placement group. Create a new placement group in a specified Availability Zone.
      *
      * @param request - The request {@link CreatePlacementGroupRequest}
      * @returns A Promise of CreatePlacementGroupResponse
@@ -387,8 +362,7 @@ export declare class API extends ParentAPI {
      */
     setPlacementGroup: (request: Readonly<SetPlacementGroupRequest>) => Promise<SetPlacementGroupResponse>;
     /**
-     * Update a placement group. Update one or more parameter of the specified
-     * placement group.
+     * Update a placement group. Update one or more parameter of the specified placement group.
      *
      * @param request - The request {@link UpdatePlacementGroupRequest}
      * @returns A Promise of UpdatePlacementGroupResponse
@@ -401,24 +375,21 @@ export declare class API extends ParentAPI {
      */
     deletePlacementGroup: (request: Readonly<DeletePlacementGroupRequest>) => Promise<void>;
     /**
-     * Get placement group servers. Get all Instances belonging to the specified
-     * placement group.
+     * Get placement group servers. Get all Instances belonging to the specified placement group.
      *
      * @param request - The request {@link GetPlacementGroupServersRequest}
      * @returns A Promise of GetPlacementGroupServersResponse
      */
     getPlacementGroupServers: (request: Readonly<GetPlacementGroupServersRequest>) => Promise<GetPlacementGroupServersResponse>;
     /**
-     * Set placement group servers. Set all Instances belonging to the specified
-     * placement group.
+     * Set placement group servers. Set all Instances belonging to the specified placement group.
      *
      * @param request - The request {@link SetPlacementGroupServersRequest}
      * @returns A Promise of SetPlacementGroupServersResponse
      */
     setPlacementGroupServers: (request: Readonly<SetPlacementGroupServersRequest>) => Promise<SetPlacementGroupServersResponse>;
     /**
-     * Update placement group servers. Update all Instances belonging to the
-     * specified placement group.
+     * Update placement group servers. Update all Instances belonging to the specified placement group.
      *
      * @param request - The request {@link UpdatePlacementGroupServersRequest}
      * @returns A Promise of UpdatePlacementGroupServersResponse
@@ -436,8 +407,7 @@ export declare class API extends ParentAPI {
         [Symbol.asyncIterator]: () => AsyncGenerator<import("./types.gen").Ip[], void, void>;
     };
     /**
-     * Reserve a flexible IP. Reserve a flexible IP and attach it to the specified
-     * Instance.
+     * Reserve a flexible IP. Reserve a flexible IP and attach it to the specified Instance.
      *
      * @param request - The request {@link CreateIpRequest}
      * @returns A Promise of CreateIpResponse
@@ -451,8 +421,7 @@ export declare class API extends ParentAPI {
      */
     getIp: (request: Readonly<GetIpRequest>) => Promise<GetIpResponse>;
     /**
-     * Update a flexible IP. Update a flexible IP in the specified zone with the
-     * specified ID.
+     * Update a flexible IP. Update a flexible IP in the specified zone with the specified ID.
      *
      * @param request - The request {@link UpdateIpRequest}
      * @returns A Promise of UpdateIpResponse
@@ -490,8 +459,7 @@ export declare class API extends ParentAPI {
      */
     getPrivateNIC: (request: Readonly<GetPrivateNICRequest>) => Promise<GetPrivateNICResponse>;
     /**
-     * Update a private NIC. Update one or more parameter(s) of a specified
-     * private NIC.
+     * Update a private NIC. Update one or more parameter(s) of a specified private NIC.
      *
      * @param request - The request {@link UpdatePrivateNICRequest}
      * @returns A Promise of PrivateNIC
@@ -505,35 +473,18 @@ export declare class API extends ParentAPI {
     deletePrivateNIC: (request: Readonly<DeletePrivateNICRequest>) => Promise<void>;
     getDashboard: (request?: Readonly<GetDashboardRequest>) => Promise<GetDashboardResponse>;
     /**
-     * Get a volume or snapshot's migration plan. Given a volume or snapshot,
-     * returns the migration plan but does not perform the actual migration. To
-     * perform the migration, you have to call the [Migrate a volume and/or
-     * snapshots to
-     * SBS](#path-volumes-migrate-a-volume-andor-snapshots-to-sbs-scaleway-block-storage)
-     * endpoint afterward. The endpoint returns the resources that should be
-     * migrated together:
-     *
-     * - The volume and any snapshots created from the volume, if the call was made
-     *   to plan a volume migration.
-     * - The base volume of the snapshot (if the volume is not deleted) and its
-     *   related snapshots, if the call was made to plan a snapshot migration. The
-     *   endpoint also returns the validation_key, which must be provided to the
-     *   [Migrate a volume and/or snapshots to
-     *   SBS](#path-volumes-migrate-a-volume-andor-snapshots-to-sbs-scaleway-block-storage)
-     *   endpoint to confirm that all resources listed in the plan should be
-     *   migrated.
+     * Get a volume or snapshot's migration plan. Given a volume or snapshot, returns the migration plan but does not perform the actual migration. To perform the migration, you have to call the [Migrate a volume and/or snapshots to SBS](#path-volumes-migrate-a-volume-andor-snapshots-to-sbs-scaleway-block-storage) endpoint afterward.
+  The endpoint returns the resources that should be migrated together:
+  - the volume and any snapshots created from the volume, if the call was made to plan a volume migration.
+  - the base volume of the snapshot (if the volume is not deleted) and its related snapshots, if the call was made to plan a snapshot migration.
+  The endpoint also returns the validation_key, which must be provided to the [Migrate a volume and/or snapshots to SBS](#path-volumes-migrate-a-volume-andor-snapshots-to-sbs-scaleway-block-storage) endpoint to confirm that all resources listed in the plan should be migrated.
      *
      * @param request - The request {@link PlanBlockMigrationRequest}
      * @returns A Promise of MigrationPlan
      */
     planBlockMigration: (request?: Readonly<PlanBlockMigrationRequest>) => Promise<MigrationPlan>;
     /**
-     * Migrate a volume and/or snapshots to SBS (Scaleway Block Storage). To be
-     * used, the call to this endpoint must be preceded by a call to the [Get a
-     * volume or snapshot's migration
-     * plan](#path-volumes-get-a-volume-or-snapshots-migration-plan) endpoint. To
-     * migrate all resources mentioned in the migration plan, the validation_key
-     * returned in the plan must be provided.
+     * Migrate a volume and/or snapshots to SBS (Scaleway Block Storage). To be used, the call to this endpoint must be preceded by a call to the [Get a volume or snapshot's migration plan](#path-volumes-get-a-volume-or-snapshots-migration-plan) endpoint. To migrate all resources mentioned in the migration plan, the validation_key returned in the plan must be provided.
      *
      * @param request - The request {@link ApplyBlockMigrationRequest}
      */