@scaleway/sdk 1.5.0 → 1.6.0

package/dist/index.cjs

@@ -2,14 +2,14 @@
 
 // eslint-disable-next-line eslint-comments/disable-enable-pair
 /* eslint-disable @typescript-eslint/naming-convention */
-let LevelResolver;
-(function (LevelResolver) {
+let LevelResolver = /*#__PURE__*/function (LevelResolver) {
   LevelResolver[LevelResolver["silent"] = 0] = "silent";
   LevelResolver[LevelResolver["error"] = 1] = "error";
   LevelResolver[LevelResolver["warn"] = 2] = "warn";
   LevelResolver[LevelResolver["info"] = 3] = "info";
   LevelResolver[LevelResolver["debug"] = 4] = "debug";
-})(LevelResolver || (LevelResolver = {}));
+  return LevelResolver;
+}({});
 const shouldLog = (currentLevel, level) => LevelResolver[level] <= currentLevel;
 
 /**
@@ -138,6 +138,24 @@ const isURL = str => {
   return url.protocol === 'http:' || url.protocol === 'https:';
 };
 
+/**
+ * Holds access key and secret key.
+ *
+ * @public
+ */
+
+/**
+ * Holds default values of a Scaleway profile.
+ *
+ * @public
+ */
+
+/**
+ * Holds values of a Scaleway profile.
+ *
+ * @public
+ */
+
 /**
  * Verifies that the payload contains both the accessKey and the secretKey.
  *
@@ -232,6 +250,12 @@ const obfuscateAuthHeadersEntry = ([name, value]) => {
   return [name, value];
 };
 
+/**
+ * A factory to build {@link Settings}.
+ *
+ * @public
+ */
+
 /**
  * Instantiates the SDK from a configuration {@link Profile}.
  *
@@ -327,6 +351,18 @@ const withUserAgentSuffix = userAgent => settings => ({
   userAgent: settings.userAgent ? `${settings.userAgent} ${userAgent}` : userAgent
 });
 
+/**
+ * Holds default values of settings.
+ *
+ * @public
+ */
+
+/**
+ * Settings hold the values of all client options.
+ *
+ * @public
+ */
+
 /**
  * Validates the content of a {@link Settings} object.
  *
@@ -390,7 +426,7 @@ const assertValidSettings = obj => {
   }
 };
 
-const version = 'v1.4.0';
+const version = 'v1.5.0';
 const userAgent = `scaleway-sdk-js/${version}`;
 
 const isBrowser = () => typeof window !== 'undefined' && typeof window.document !== 'undefined';
@@ -692,6 +728,12 @@ class InvalidArgumentsError extends ScalewayError {
  * @public
  */
 
+/**
+ * Details of an {@link QuotasExceededError} error.
+ *
+ * @public
+ */
+
 /**
  * Build the default message for {@link QuotasExceededError}.
  *
@@ -1504,6 +1546,12 @@ const tryAtIntervals = async (retry, strategy, timeout = DEFAULT_TIMEOUT_SECONDS
  * @public
  */
 
+/**
+ * The options to wait until a resource is ready.
+ *
+ * @public
+ */
+
 /**
  * Fetches resource several times until an expected condition is reached, timeouts, or throws an exception.
  *
@@ -3425,6 +3473,20 @@ const unmarshalGrafanaUser = data => {
     role: data.role
   };
 };
+const unmarshalPlan = data => {
+  if (!isJSONObject(data)) {
+    throw new TypeError(`Unmarshalling the type 'Plan' failed as data isn't a dictionary.`);
+  }
+  return {
+    id: data.id,
+    logsIngestionPrice: data.logs_ingestion_price,
+    name: data.name,
+    retentionLogsInterval: data.retention_logs_interval,
+    retentionMetricsInterval: data.retention_metrics_interval,
+    retentionPrice: data.retention_price,
+    sampleIngestionPrice: data.sample_ingestion_price
+  };
+};
 const unmarshalToken$2 = data => {
   if (!isJSONObject(data)) {
     throw new TypeError(`Unmarshalling the type 'Token' failed as data isn't a dictionary.`);
@@ -3447,11 +3509,20 @@ const unmarshalCockpit = data => {
     createdAt: unmarshalDate(data.created_at),
     endpoints: data.endpoints ? unmarshalCockpitEndpoints(data.endpoints) : undefined,
     managedAlertsEnabled: data.managed_alerts_enabled,
+    plan: data.plan ? unmarshalPlan(data.plan) : undefined,
     projectId: data.project_id,
     status: data.status,
     updatedAt: unmarshalDate(data.updated_at)
   };
 };
+const unmarshalCockpitMetrics = data => {
+  if (!isJSONObject(data)) {
+    throw new TypeError(`Unmarshalling the type 'CockpitMetrics' failed as data isn't a dictionary.`);
+  }
+  return {
+    timeseries: unmarshalArrayOfObject(data.timeseries, unmarshalTimeSeries)
+  };
+};
 const unmarshalListContactPointsResponse = data => {
   if (!isJSONObject(data)) {
     throw new TypeError(`Unmarshalling the type 'ListContactPointsResponse' failed as data isn't a dictionary.`);
@@ -3472,6 +3543,15 @@ const unmarshalListGrafanaUsersResponse = data => {
     totalCount: data.total_count
   };
 };
+const unmarshalListPlansResponse = data => {
+  if (!isJSONObject(data)) {
+    throw new TypeError(`Unmarshalling the type 'ListPlansResponse' failed as data isn't a dictionary.`);
+  }
+  return {
+    plans: unmarshalArrayOfObject(data.plans, unmarshalPlan),
+    totalCount: data.total_count
+  };
+};
 const unmarshalListTokensResponse$2 = data => {
   if (!isJSONObject(data)) {
     throw new TypeError(`Unmarshalling the type 'ListTokensResponse' failed as data isn't a dictionary.`);
@@ -3481,6 +3561,12 @@ const unmarshalListTokensResponse$2 = data => {
     totalCount: data.total_count
   };
 };
+const unmarshalSelectPlanResponse = data => {
+  if (!isJSONObject(data)) {
+    throw new TypeError(`Unmarshalling the type 'SelectPlanResponse' failed as data isn't a dictionary.`);
+  }
+  return {};
+};
 const marshalContactPointEmail = (request, defaults) => ({
   to: request.to
 });
@@ -3538,6 +3624,10 @@ const marshalResetCockpitGrafanaRequest = (request, defaults) => ({
 const marshalResetGrafanaUserPasswordRequest = (request, defaults) => ({
   project_id: request.projectId ?? defaults.defaultProjectId
 });
+const marshalSelectPlanRequest = (request, defaults) => ({
+  plan_id: request.planId,
+  project_id: request.projectId ?? defaults.defaultProjectId
+});
 const marshalTriggerTestAlertRequest = (request, defaults) => ({
   project_id: request.projectId ?? defaults.defaultProjectId
 });
@@ -3588,6 +3678,18 @@ let API$l = class API extends API$q {
    */
   waitForCockpit = (request = {}, options) => waitForResource(options?.stop ?? (res => Promise.resolve(!COCKPIT_TRANSIENT_STATUSES.includes(res.status))), this.getCockpit, request, options);
 
+  /**
+   * Get cockpit metrics. Get the cockpit metrics with the given project ID.
+   *
+   * @param request - The request {@link GetCockpitMetricsRequest}
+   * @returns A Promise of CockpitMetrics
+   */
+  getCockpitMetrics = (request = {}) => this.client.fetch({
+    method: 'GET',
+    path: `/cockpit/v1beta1/cockpit/metrics`,
+    urlParams: urlParams(['end_date', request.endDate], ['metric_name', request.metricName], ['project_id', request.projectId ?? this.client.settings.defaultProjectId], ['start_date', request.startDate])
+  }, unmarshalCockpitMetrics);
+
   /**
    * Deactivate a cockpit. Deactivate a cockpit associated with the given
    * project ID.
@@ -3792,6 +3894,32 @@ let API$l = class API extends API$q {
     method: 'POST',
     path: `/cockpit/v1beta1/grafana-users/${validatePathParam('grafanaUserId', request.grafanaUserId)}/reset-password`
   }, unmarshalGrafanaUser);
+  pageOfListPlans = (request = {}) => this.client.fetch({
+    method: 'GET',
+    path: `/cockpit/v1beta1/plans`,
+    urlParams: urlParams(['order_by', request.orderBy ?? 'name_asc'], ['page', request.page], ['page_size', request.pageSize ?? this.client.settings.defaultPageSize])
+  }, unmarshalListPlansResponse);
+
+  /**
+   * List plans. List all pricing plans.
+   *
+   * @param request - The request {@link ListPlansRequest}
+   * @returns A Promise of ListPlansResponse
+   */
+  listPlans = (request = {}) => enrichForPagination('plans', this.pageOfListPlans, request);
+
+  /**
+   * Select pricing plan. Select the wanted pricing plan.
+   *
+   * @param request - The request {@link SelectPlanRequest}
+   * @returns A Promise of SelectPlanResponse
+   */
+  selectPlan = request => this.client.fetch({
+    body: JSON.stringify(marshalSelectPlanRequest(request, this.client.settings)),
+    headers: jsonContentHeaders$j,
+    method: 'POST',
+    path: `/cockpit/v1beta1/select-plan`
+  }, unmarshalSelectPlanResponse);
 };
 
 // This file was automatically generated. DO NOT EDIT.
@@ -7031,22 +7159,8 @@ const marshalSecret = (request, defaults) => ({
   key: request.key,
   value: request.value
 });
-const marshalUpdateTriggerRequestMnqNatsClientConfig = (request, defaults) => ({
-  mnq_namespace_id: request.mnqNamespaceId,
-  mnq_project_id: request.mnqProjectId,
-  mnq_region: request.mnqRegion,
-  subject: request.subject
-});
-const marshalUpdateTriggerRequestMnqSqsClientConfig = (request, defaults) => ({
-  mnq_namespace_id: request.mnqNamespaceId,
-  mnq_project_id: request.mnqProjectId,
-  mnq_region: request.mnqRegion,
-  queue: request.queue
-});
 const marshalUpdateTriggerRequestSqsClientConfig = (request, defaults) => ({
   access_key: request.accessKey,
-  endpoint: request.endpoint,
-  queue_url: request.queueUrl,
   secret_key: request.secretKey
 });
 const marshalCreateCronRequest = (request, defaults) => ({
@@ -7136,14 +7250,8 @@ const marshalUpdateTriggerRequest = (request, defaults) => ({
   description: request.description,
   name: request.name,
   ...resolveOneOf([{
-    param: 'scw_sqs_config',
-    value: request.scwSqsConfig ? marshalUpdateTriggerRequestMnqSqsClientConfig(request.scwSqsConfig) : undefined
-  }, {
     param: 'sqs_config',
     value: request.sqsConfig ? marshalUpdateTriggerRequestSqsClientConfig(request.sqsConfig) : undefined
-  }, {
-    param: 'scw_nats_config',
-    value: request.scwNatsConfig ? marshalUpdateTriggerRequestMnqNatsClientConfig(request.scwNatsConfig) : undefined
   }])
 });
 
@@ -8661,7 +8769,7 @@ const ListAPIKeysRequest = {
     maxLength: 200
   },
   page: {
-    greaterThanOrEqual: 1
+    greaterThan: 0
   },
   pageSize: {
     greaterThanOrEqual: 1,
@@ -8675,7 +8783,7 @@ const ListApplicationsRequest = {
     pattern: /^[a-zA-Z0-9\(\)\._\- ]+$/
   },
   page: {
-    greaterThanOrEqual: 1
+    greaterThan: 0
   },
   pageSize: {
     greaterThanOrEqual: 1,
@@ -8687,7 +8795,7 @@ const ListGroupsRequest = {
     minLength: 1
   },
   page: {
-    greaterThanOrEqual: 1
+    greaterThan: 0
   },
   pageSize: {
     greaterThanOrEqual: 1,
@@ -8696,7 +8804,7 @@ const ListGroupsRequest = {
 };
 const ListJWTsRequest = {
   page: {
-    greaterThanOrEqual: 1
+    greaterThan: 0
   },
   pageSize: {
     greaterThanOrEqual: 1,
@@ -8705,7 +8813,7 @@ const ListJWTsRequest = {
 };
 const ListPermissionSetsRequest = {
   page: {
-    greaterThanOrEqual: 1
+    greaterThan: 0
   },
   pageSize: {
     greaterThanOrEqual: 1,
@@ -8714,7 +8822,7 @@ const ListPermissionSetsRequest = {
 };
 const ListPoliciesRequest = {
   page: {
-    greaterThanOrEqual: 1
+    greaterThan: 0
   },
   pageSize: {
     greaterThanOrEqual: 1,
@@ -8726,7 +8834,7 @@ const ListPoliciesRequest = {
 };
 const ListQuotaRequest = {
   page: {
-    greaterThanOrEqual: 1
+    greaterThan: 0
   },
   pageSize: {
     greaterThanOrEqual: 1,
@@ -8735,7 +8843,7 @@ const ListQuotaRequest = {
 };
 const ListRulesRequest = {
   page: {
-    greaterThanOrEqual: 1
+    greaterThan: 0
   },
   pageSize: {
     greaterThanOrEqual: 1,
@@ -8748,7 +8856,7 @@ const ListSSHKeysRequest = {
     minLength: 1
   },
   page: {
-    greaterThanOrEqual: 1
+    greaterThan: 0
   },
   pageSize: {
     greaterThanOrEqual: 1,
@@ -8757,7 +8865,7 @@ const ListSSHKeysRequest = {
 };
 const ListUsersRequest = {
   page: {
-    greaterThanOrEqual: 1
+    greaterThan: 0
   },
   pageSize: {
     greaterThanOrEqual: 1,
@@ -10183,7 +10291,7 @@ let API$f = class API extends API$q {
   static LOCALITIES = ['fr-par-1', 'fr-par-2', 'fr-par-3', 'nl-ams-1', 'nl-ams-2', 'pl-waw-1', 'pl-waw-2'];
 
   /**
-   * Get availability. Get availability for all server types.
+   * Get availability. Get availability for all Instance types.
    *
    * @param request - The request {@link GetServerTypesAvailabilityRequest}
    * @returns A Promise of GetServerTypesAvailabilityResponse
@@ -10195,7 +10303,8 @@ let API$f = class API extends API$q {
   }, unmarshalGetServerTypesAvailabilityResponse);
 
   /**
-   * List server types. Get server types technical details.
+   * List Instance types. List available Instance types and their technical
+   * details.
    *
    * @param request - The request {@link ListServersTypesRequest}
    * @returns A Promise of ListServersTypesResponse
@@ -10207,7 +10316,7 @@ let API$f = class API extends API$q {
   }, unmarshalListServersTypesResponse);
 
   /**
-   * List volumes types. Get volumes technical details.
+   * List volumes types. List all volume types and their technical details.
    *
    * @param request - The request {@link ListVolumesTypesRequest}
    * @returns A Promise of ListVolumesTypesResponse
@@ -10224,7 +10333,8 @@ let API$f = class API extends API$q {
   }, unmarshalListServersResponse);
 
   /**
-   * List all servers.
+   * 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
@@ -10238,7 +10348,7 @@ let API$f = class API extends API$q {
   }, unmarshalCreateServerResponse);
 
   /**
-   * Delete a server. Delete a server with the given ID.
+   * Delete an Instance. Delete the Instance with the specified ID.
    *
    * @param request - The request {@link DeleteServerRequest}
    */
@@ -10248,7 +10358,7 @@ let API$f = class API extends API$q {
   });
 
   /**
-   * Get a server. Get the details of a specified Server.
+   * Get an Instance. Get the details of a specified Instance.
    *
    * @param request - The request {@link GetServerRequest}
    * @returns A Promise of GetServerResponse
@@ -10271,8 +10381,8 @@ let API$f = class API extends API$q {
   }, unmarshalUpdateServerResponse);
 
   /**
-   * List server actions. List all actions that can currently be performed on a
-   * server.
+   * 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
@@ -10283,13 +10393,19 @@ let API$f = class API extends API$q {
   }, unmarshalListServerActionsResponse);
 
   /**
-   * Perform action. Perform power related actions on a server. Be wary that
-   * when terminating a server, all the attached volumes (local _and_ block
-   * storage) are deleted. So, if you want to keep your local volumes, you must
-   * use the `archive` action instead of `terminate`. And if you want to keep
-   * block-storage volumes, **you must** detach it beforehand you issue the
-   * `terminate` call. For more information, read the [Volumes](#volumes-7e8a39)
-   * documentation.
+   * 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 all attached volumes.
+   *
+   * Keep in mind that terminating an Instance will result in the deletion of
+   * all attached volumes, including local and block storage. If you want to
+   * preserve your local volumes, you should use the `archive` action instead of
+   * `terminate`. Similarly, if you want to keep your block storage volumes, you
+   * must first detach them before issuing the `terminate` command. For more
+   * information, read the [Volumes](#volumes-7e8a39) documentation.
    *
    * @param request - The request {@link ServerActionRequest}
    * @returns A Promise of ServerActionResponse
@@ -10302,7 +10418,7 @@ let API$f = class API extends API$q {
   }, unmarshalServerActionResponse);
 
   /**
-   * List user data. List all user data keys registered on a given server.
+   * List user data. List all user data keys registered on a specified Instance.
    *
    * @param request - The request {@link ListServerUserDataRequest}
    * @returns A Promise of ListServerUserDataResponse
@@ -10313,7 +10429,7 @@ let API$f = class API extends API$q {
   }, unmarshalListServerUserDataResponse);
 
   /**
-   * Delete user data. Delete the given key from a server user data.
+   * Delete user data. Delete the specified key from an Instance's user data.
    *
    * @param request - The request {@link DeleteServerUserDataRequest}
    */
@@ -10328,7 +10444,7 @@ let API$f = class API extends API$q {
   }, unmarshalListImagesResponse$3);
 
   /**
-   * List instance images. List all images available in an account.
+   * List Instance images. List all existing Instance images.
    *
    * @param request - The request {@link ListImagesRequest}
    * @returns A Promise of ListImagesResponse
@@ -10336,7 +10452,7 @@ let API$f = class API extends API$q {
   listImages = (request = {}) => enrichForPagination('images', this.pageOfListImages, request);
 
   /**
-   * Get an instance image. Get details of an image with the given ID.
+   * Get an Instance image. Get details of an image with the specified ID.
    *
    * @param request - The request {@link GetImageRequest}
    * @returns A Promise of GetImageResponse
@@ -10347,7 +10463,8 @@ let API$f = class API extends API$q {
   }, unmarshalGetImageResponse$1);
 
   /**
-   * Create an instance image.
+   * Create an Instance image. Create an Instance image from the specified
+   * snapshot ID.
    *
    * @param request - The request {@link CreateImageRequest}
    * @returns A Promise of CreateImageResponse
@@ -10366,7 +10483,7 @@ let API$f = class API extends API$q {
   }, unmarshalSetImageResponse);
 
   /**
-   * Delete an instance image. Delete the image with the given ID.
+   * Delete an Instance image. Delete the image with the specified ID.
    *
    * @param request - The request {@link DeleteImageRequest}
    */
@@ -10381,7 +10498,8 @@ let API$f = class API extends API$q {
   }, unmarshalListSnapshotsResponse$1);
 
   /**
-   * List snapshots.
+   * List snapshots. List all snapshots of an Organization in a specified
+   * Availability Zone.
    *
    * @param request - The request {@link ListSnapshotsRequest}
    * @returns A Promise of ListSnapshotsResponse
@@ -10389,7 +10507,9 @@ let API$f = class API extends API$q {
   listSnapshots = (request = {}) => enrichForPagination('snapshots', this.pageOfListSnapshots, request);
 
   /**
-   * Create a snapshot from a given volume or from a QCOW2 file.
+   * 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
@@ -10402,7 +10522,7 @@ let API$f = class API extends API$q {
   }, unmarshalCreateSnapshotResponse);
 
   /**
-   * Get a snapshot. Get details of a snapshot with the given ID.
+   * Get a snapshot. Get details of a snapshot with the specified ID.
    *
    * @param request - The request {@link GetSnapshotRequest}
    * @returns A Promise of GetSnapshotResponse
@@ -10419,7 +10539,7 @@ let API$f = class API extends API$q {
   }, unmarshalSetSnapshotResponse);
 
   /**
-   * Delete a snapshot. Delete the snapshot with the given ID.
+   * Delete a snapshot. Delete the snapshot with the specified ID.
    *
    * @param request - The request {@link DeleteSnapshotRequest}
    */
@@ -10429,7 +10549,7 @@ let API$f = class API extends API$q {
   });
 
   /**
-   * Export a snapshot. Export a snapshot to a given S3 bucket in the same
+   * Export a snapshot. Export a snapshot to a specified S3 bucket in the same
    * region.
    *
    * @param request - The request {@link ExportSnapshotRequest}
@@ -10448,7 +10568,8 @@ let API$f = class API extends API$q {
   }, unmarshalListVolumesResponse);
 
   /**
-   * List volumes.
+   * 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
@@ -10456,7 +10577,8 @@ let API$f = class API extends API$q {
   listVolumes = (request = {}) => enrichForPagination('volumes', this.pageOfListVolumes, request);
 
   /**
-   * Create a volume.
+   * 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
@@ -10469,7 +10591,7 @@ let API$f = class API extends API$q {
   }, unmarshalCreateVolumeResponse);
 
   /**
-   * Get a volume. Get details of a volume with the given ID.
+   * Get a volume. Get details of a volume with the specified ID.
    *
    * @param request - The request {@link GetVolumeRequest}
    * @returns A Promise of GetVolumeResponse
@@ -10480,9 +10602,9 @@ let API$f = class API extends API$q {
   }, unmarshalGetVolumeResponse);
 
   /**
-   * Update a volume. Replace name and/or size properties of given ID volume
-   * with the given value(s). Any volume name can be changed while, for now,
-   * only `b_ssd` volume growing is supported.
+   * 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
@@ -10495,7 +10617,7 @@ let API$f = class API extends API$q {
   }, unmarshalUpdateVolumeResponse);
 
   /**
-   * Delete a volume. Delete the volume with the given ID.
+   * Delete a volume. Delete the volume with the specified ID.
    *
    * @param request - The request {@link DeleteVolumeRequest}
    */
@@ -10510,7 +10632,7 @@ let API$f = class API extends API$q {
   }, unmarshalListSecurityGroupsResponse);
 
   /**
-   * List security groups. List all security groups available in an account.
+   * List security groups. List all existing security groups.
    *
    * @param request - The request {@link ListSecurityGroupsRequest}
    * @returns A Promise of ListSecurityGroupsResponse
@@ -10518,7 +10640,8 @@ let API$f = class API extends API$q {
   listSecurityGroups = (request = {}) => enrichForPagination('securityGroups', this.pageOfListSecurityGroups, request);
 
   /**
-   * Create a security group.
+   * 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
@@ -10531,8 +10654,8 @@ let API$f = class API extends API$q {
   }, unmarshalCreateSecurityGroupResponse);
 
   /**
-   * Get a security group. Get the details of a Security Group with the given
-   * 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
@@ -10543,7 +10666,7 @@ let API$f = class API extends API$q {
   }, unmarshalGetSecurityGroupResponse);
 
   /**
-   * Delete a security group.
+   * Delete a security group. Delete a security group with the specified ID.
    *
    * @param request - The request {@link DeleteSecurityGroupRequest}
    */
@@ -10576,7 +10699,7 @@ let API$f = class API extends API$q {
   }, unmarshalListSecurityGroupRulesResponse);
 
   /**
-   * List rules.
+   * List rules. List the rules of the a specified security group ID.
    *
    * @param request - The request {@link ListSecurityGroupRulesRequest}
    * @returns A Promise of ListSecurityGroupRulesResponse
@@ -10584,7 +10707,7 @@ let API$f = class API extends API$q {
   listSecurityGroupRules = request => enrichForPagination('rules', this.pageOfListSecurityGroupRules, request);
 
   /**
-   * Create rule.
+   * Create rule. Create a rule in the specified security group ID.
    *
    * @param request - The request {@link CreateSecurityGroupRuleRequest}
    * @returns A Promise of CreateSecurityGroupRuleResponse
@@ -10597,10 +10720,10 @@ let API$f = class API extends API$q {
   }, unmarshalCreateSecurityGroupRuleResponse);
 
   /**
-   * Update all the rules of a security group. Replaces the 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
@@ -10613,7 +10736,7 @@ let API$f = class API extends API$q {
   }, unmarshalSetSecurityGroupRulesResponse);
 
   /**
-   * Delete rule. Delete a security group rule with the given ID.
+   * Delete rule. Delete a security group rule with the specified ID.
    *
    * @param request - The request {@link DeleteSecurityGroupRuleRequest}
    */
@@ -10623,7 +10746,7 @@ let API$f = class API extends API$q {
   });
 
   /**
-   * Get rule. Get details of a security group rule with the given ID.
+   * Get rule. Get details of a security group rule with the specified ID.
    *
    * @param request - The request {@link GetSecurityGroupRuleRequest}
    * @returns A Promise of GetSecurityGroupRuleResponse
@@ -10645,7 +10768,8 @@ let API$f = class API extends API$q {
   }, unmarshalListPlacementGroupsResponse);
 
   /**
-   * List placement groups. List all placement groups.
+   * List placement groups. List all placement groups in a specified
+   * Availability Zone.
    *
    * @param request - The request {@link ListPlacementGroupsRequest}
    * @returns A Promise of ListPlacementGroupsResponse
@@ -10653,7 +10777,8 @@ let API$f = class API extends API$q {
   listPlacementGroups = (request = {}) => enrichForPagination('placementGroups', this.pageOfListPlacementGroups, request);
 
   /**
-   * Create a placement group. Create a new placement group.
+   * 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
@@ -10666,7 +10791,7 @@ let API$f = class API extends API$q {
   }, unmarshalCreatePlacementGroupResponse);
 
   /**
-   * Get a placement group. Get the given placement group.
+   * Get a placement group. Get the specified placement group.
    *
    * @param request - The request {@link GetPlacementGroupRequest}
    * @returns A Promise of GetPlacementGroupResponse
@@ -10677,7 +10802,7 @@ let API$f = class API extends API$q {
   }, unmarshalGetPlacementGroupResponse);
 
   /**
-   * Set placement group. Set all parameters of the given placement group.
+   * Set placement group. Set all parameters of the specified placement group.
    *
    * @param request - The request {@link SetPlacementGroupRequest}
    * @returns A Promise of SetPlacementGroupResponse
@@ -10690,7 +10815,7 @@ let API$f = class API extends API$q {
   }, unmarshalSetPlacementGroupResponse);
 
   /**
-   * Update a placement group. Update one or more parameter of the given
+   * Update a placement group. Update one or more parameter of the specified
    * placement group.
    *
    * @param request - The request {@link UpdatePlacementGroupRequest}
@@ -10704,7 +10829,7 @@ let API$f = class API extends API$q {
   }, unmarshalUpdatePlacementGroupResponse);
 
   /**
-   * Delete the given placement group.
+   * Delete the specified placement group.
    *
    * @param request - The request {@link DeletePlacementGroupRequest}
    */
@@ -10714,7 +10839,7 @@ let API$f = class API extends API$q {
   });
 
   /**
-   * Get placement group servers. Get all servers belonging to the given
+   * Get placement group servers. Get all Instances belonging to the specified
    * placement group.
    *
    * @param request - The request {@link GetPlacementGroupServersRequest}
@@ -10726,7 +10851,7 @@ let API$f = class API extends API$q {
   }, unmarshalGetPlacementGroupServersResponse);
 
   /**
-   * Set placement group servers. Set all servers belonging to the given
+   * Set placement group servers. Set all Instances belonging to the specified
    * placement group.
    *
    * @param request - The request {@link SetPlacementGroupServersRequest}
@@ -10740,8 +10865,8 @@ let API$f = class API extends API$q {
   }, unmarshalSetPlacementGroupServersResponse);
 
   /**
-   * Update placement group servers. Update all servers belonging to the given
-   * 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
@@ -10759,7 +10884,7 @@ let API$f = class API extends API$q {
   }, unmarshalListIpsResponse$1);
 
   /**
-   * List all flexible IPs.
+   * List all flexible IPs. List all flexible IPs in a specified zone.
    *
    * @param request - The request {@link ListIpsRequest}
    * @returns A Promise of ListIpsResponse
@@ -10767,7 +10892,8 @@ let API$f = class API extends API$q {
   listIps = (request = {}) => enrichForPagination('ips', this.pageOfListIps, request);
 
   /**
-   * Reserve a flexible IP.
+   * 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
@@ -10780,7 +10906,7 @@ let API$f = class API extends API$q {
   }, unmarshalCreateIpResponse);
 
   /**
-   * Get a flexible IP. Get details of an IP with the given ID or address.
+   * Get a flexible IP. Get details of an IP with the specified ID or address.
    *
    * @param request - The request {@link GetIpRequest}
    * @returns A Promise of GetIpResponse
@@ -10791,7 +10917,8 @@ let API$f = class API extends API$q {
   }, unmarshalGetIpResponse);
 
   /**
-   * Update a flexible IP.
+   * 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
@@ -10804,7 +10931,7 @@ let API$f = class API extends API$q {
   }, unmarshalUpdateIpResponse);
 
   /**
-   * Delete a flexible IP. Delete the IP with the given ID.
+   * Delete a flexible IP. Delete the IP with the specified ID.
    *
    * @param request - The request {@link DeleteIpRequest}
    */
@@ -10819,7 +10946,7 @@ let API$f = class API extends API$q {
   }, unmarshalListPrivateNICsResponse);
 
   /**
-   * List all private NICs. List all private NICs of a given server.
+   * List all private NICs. List all private NICs of a specified Instance.
    *
    * @param request - The request {@link ListPrivateNICsRequest}
    * @returns A Promise of ListPrivateNICsResponse
@@ -10827,7 +10954,7 @@ let API$f = class API extends API$q {
   listPrivateNICs = request => enrichForPagination('privateNics', this.pageOfListPrivateNICs, request);
 
   /**
-   * Create a private NIC connecting a server to a private network.
+   * Create a private NIC connecting an Instance to a Private Network.
    *
    * @param request - The request {@link CreatePrivateNICRequest}
    * @returns A Promise of CreatePrivateNICResponse
@@ -10851,8 +10978,8 @@ let API$f = class API extends API$q {
   }, unmarshalGetPrivateNICResponse);
 
   /**
-   * Update a private NIC. Update one or more parameter/s to a given 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
@@ -10889,7 +11016,7 @@ let API$f = class API extends API$q {
   listBootscripts = (request = {}) => enrichForPagination('bootscripts', this.pageOfListBootscripts, request);
 
   /**
-   * Get bootscripts. Get details of a bootscript with the given ID.
+   * Get bootscripts. Get details of a bootscript with the specified ID.
    *
    * @deprecated
    * @param request - The request {@link GetBootscriptRequest}
@@ -13319,7 +13446,8 @@ const unmarshalHealthCheck = data => {
     pgsqlConfig: data.pgsql_config ? unmarshalHealthCheckPgsqlConfig(data.pgsql_config) : undefined,
     port: data.port,
     redisConfig: data.redis_config ? unmarshalHealthCheckRedisConfig(data.redis_config) : undefined,
-    tcpConfig: data.tcp_config ? unmarshalHealthCheckTcpConfig(data.tcp_config) : undefined
+    tcpConfig: data.tcp_config ? unmarshalHealthCheckTcpConfig(data.tcp_config) : undefined,
+    transientCheckDelay: data.transient_check_delay
   };
 };
 const unmarshalLb = data => {
@@ -13373,10 +13501,12 @@ const unmarshalBackend = data => {
     id: data.id,
     ignoreSslServerVerify: data.ignore_ssl_server_verify,
     lb: data.lb ? unmarshalLb(data.lb) : undefined,
+    maxRetries: data.max_retries,
     name: data.name,
     onMarkedDownAction: data.on_marked_down_action,
     pool: data.pool,
     proxyProtocol: data.proxy_protocol,
+    redispatchAttemptCount: data.redispatch_attempt_count,
     sendProxyV2: data.send_proxy_v2,
     sslBridging: data.ssl_bridging,
     stickySessions: data.sticky_sessions,
@@ -13718,21 +13848,22 @@ const marshalHealthCheck = (request, defaults) => ({
   check_send_proxy: request.checkSendProxy,
   check_timeout: request.checkTimeout,
   port: request.port,
+  transient_check_delay: request.transientCheckDelay,
   ...resolveOneOf([{
+    param: 'tcp_config',
+    value: request.tcpConfig ? marshalHealthCheckTcpConfig(request.tcpConfig) : undefined
+  }, {
     param: 'mysql_config',
     value: request.mysqlConfig ? marshalHealthCheckMysqlConfig(request.mysqlConfig) : undefined
+  }, {
+    param: 'pgsql_config',
+    value: request.pgsqlConfig ? marshalHealthCheckPgsqlConfig(request.pgsqlConfig) : undefined
   }, {
     param: 'ldap_config',
     value: request.ldapConfig ? marshalHealthCheckLdapConfig(request.ldapConfig) : undefined
   }, {
     param: 'redis_config',
     value: request.redisConfig ? marshalHealthCheckRedisConfig(request.redisConfig) : undefined
-  }, {
-    param: 'tcp_config',
-    value: request.tcpConfig ? marshalHealthCheckTcpConfig(request.tcpConfig) : undefined
-  }, {
-    param: 'pgsql_config',
-    value: request.pgsqlConfig ? marshalHealthCheckPgsqlConfig(request.pgsqlConfig) : undefined
   }, {
     param: 'http_config',
     value: request.httpConfig ? marshalHealthCheckHttpConfig(request.httpConfig) : undefined
@@ -13790,9 +13921,11 @@ const marshalCreateBackendRequest = (request, defaults) => ({
   forward_protocol: request.forwardProtocol,
   health_check: marshalHealthCheck(request.healthCheck),
   ignore_ssl_server_verify: request.ignoreSslServerVerify,
+  max_retries: request.maxRetries,
   name: request.name || randomName('lbb'),
   on_marked_down_action: request.onMarkedDownAction ?? 'on_marked_down_action_none',
   proxy_protocol: request.proxyProtocol ?? 'proxy_protocol_unknown',
+  redispatch_attempt_count: request.redispatchAttemptCount,
   send_proxy_v2: request.sendProxyV2,
   server_ip: request.serverIp,
   ssl_bridging: request.sslBridging,
@@ -13899,9 +14032,11 @@ const marshalUpdateBackendRequest = (request, defaults) => ({
   forward_port_algorithm: request.forwardPortAlgorithm,
   forward_protocol: request.forwardProtocol,
   ignore_ssl_server_verify: request.ignoreSslServerVerify,
+  max_retries: request.maxRetries,
   name: request.name,
   on_marked_down_action: request.onMarkedDownAction ?? 'on_marked_down_action_none',
   proxy_protocol: request.proxyProtocol ?? 'proxy_protocol_unknown',
+  redispatch_attempt_count: request.redispatchAttemptCount,
   send_proxy_v2: request.sendProxyV2,
   ssl_bridging: request.sslBridging,
   sticky_sessions: request.stickySessions,
@@ -13928,21 +14063,22 @@ const marshalUpdateHealthCheckRequest = (request, defaults) => ({
   check_send_proxy: request.checkSendProxy,
   check_timeout: request.checkTimeout,
   port: request.port,
+  transient_check_delay: request.transientCheckDelay,
   ...resolveOneOf([{
+    param: 'tcp_config',
+    value: request.tcpConfig ? marshalHealthCheckTcpConfig(request.tcpConfig) : undefined
+  }, {
     param: 'mysql_config',
     value: request.mysqlConfig ? marshalHealthCheckMysqlConfig(request.mysqlConfig) : undefined
+  }, {
+    param: 'pgsql_config',
+    value: request.pgsqlConfig ? marshalHealthCheckPgsqlConfig(request.pgsqlConfig) : undefined
   }, {
     param: 'ldap_config',
     value: request.ldapConfig ? marshalHealthCheckLdapConfig(request.ldapConfig) : undefined
   }, {
     param: 'redis_config',
     value: request.redisConfig ? marshalHealthCheckRedisConfig(request.redisConfig) : undefined
-  }, {
-    param: 'pgsql_config',
-    value: request.pgsqlConfig ? marshalHealthCheckPgsqlConfig(request.pgsqlConfig) : undefined
-  }, {
-    param: 'tcp_config',
-    value: request.tcpConfig ? marshalHealthCheckTcpConfig(request.tcpConfig) : undefined
   }, {
     param: 'http_config',
     value: request.httpConfig ? marshalHealthCheckHttpConfig(request.httpConfig) : undefined
@@ -14003,9 +14139,11 @@ const marshalZonedApiCreateBackendRequest = (request, defaults) => ({
   forward_protocol: request.forwardProtocol,
   health_check: marshalHealthCheck(request.healthCheck),
   ignore_ssl_server_verify: request.ignoreSslServerVerify,
+  max_retries: request.maxRetries,
   name: request.name || randomName('lbb'),
   on_marked_down_action: request.onMarkedDownAction ?? 'on_marked_down_action_none',
   proxy_protocol: request.proxyProtocol ?? 'proxy_protocol_unknown',
+  redispatch_attempt_count: request.redispatchAttemptCount,
   send_proxy_v2: request.sendProxyV2,
   server_ip: request.serverIp,
   ssl_bridging: request.sslBridging,
@@ -14115,9 +14253,11 @@ const marshalZonedApiUpdateBackendRequest = (request, defaults) => ({
   forward_port_algorithm: request.forwardPortAlgorithm,
   forward_protocol: request.forwardProtocol,
   ignore_ssl_server_verify: request.ignoreSslServerVerify,
+  max_retries: request.maxRetries,
   name: request.name,
   on_marked_down_action: request.onMarkedDownAction ?? 'on_marked_down_action_none',
   proxy_protocol: request.proxyProtocol ?? 'proxy_protocol_unknown',
+  redispatch_attempt_count: request.redispatchAttemptCount,
   send_proxy_v2: request.sendProxyV2,
   ssl_bridging: request.sslBridging,
   sticky_sessions: request.stickySessions,
@@ -14144,21 +14284,22 @@ const marshalZonedApiUpdateHealthCheckRequest = (request, defaults) => ({
   check_send_proxy: request.checkSendProxy,
   check_timeout: request.checkTimeout,
   port: request.port,
+  transient_check_delay: request.transientCheckDelay,
   ...resolveOneOf([{
+    param: 'tcp_config',
+    value: request.tcpConfig ? marshalHealthCheckTcpConfig(request.tcpConfig) : undefined
+  }, {
     param: 'mysql_config',
     value: request.mysqlConfig ? marshalHealthCheckMysqlConfig(request.mysqlConfig) : undefined
+  }, {
+    param: 'pgsql_config',
+    value: request.pgsqlConfig ? marshalHealthCheckPgsqlConfig(request.pgsqlConfig) : undefined
   }, {
     param: 'ldap_config',
     value: request.ldapConfig ? marshalHealthCheckLdapConfig(request.ldapConfig) : undefined
   }, {
     param: 'redis_config',
     value: request.redisConfig ? marshalHealthCheckRedisConfig(request.redisConfig) : undefined
-  }, {
-    param: 'pgsql_config',
-    value: request.pgsqlConfig ? marshalHealthCheckPgsqlConfig(request.pgsqlConfig) : undefined
-  }, {
-    param: 'tcp_config',
-    value: request.tcpConfig ? marshalHealthCheckTcpConfig(request.tcpConfig) : undefined
   }, {
     param: 'http_config',
     value: request.httpConfig ? marshalHealthCheckHttpConfig(request.httpConfig) : undefined
@@ -18142,8 +18283,10 @@ const unmarshalSetEndpointsResponse = data => {
     endpoints: unmarshalArrayOfObject(data.endpoints, unmarshalEndpoint)
   };
 };
+const marshalEndpointSpecPrivateNetworkSpecIpamConfig = (request, defaults) => ({});
 const marshalEndpointSpecPrivateNetworkSpec = (request, defaults) => ({
   id: request.id,
+  ipam_config: request.ipamConfig ? marshalEndpointSpecPrivateNetworkSpecIpamConfig(request.ipamConfig) : undefined,
   service_ips: request.serviceIps
 });
 const marshalEndpointSpecPublicNetworkSpec = (request, defaults) => ({});
@@ -18978,6 +19121,13 @@ const unmarshalListSecretsResponse = data => {
     totalCount: data.total_count
   };
 };
+const marshalPasswordGenerationParams = (request, defaults) => ({
+  additional_chars: request.additionalChars,
+  length: request.length,
+  no_digits: request.noDigits,
+  no_lowercase_letters: request.noLowercaseLetters,
+  no_uppercase_letters: request.noUppercaseLetters
+});
 const marshalCreateSecretRequest = (request, defaults) => ({
   description: request.description,
   name: request.name,
@@ -18986,7 +19136,12 @@ const marshalCreateSecretRequest = (request, defaults) => ({
 });
 const marshalCreateSecretVersionRequest = (request, defaults) => ({
   data: request.data,
-  description: request.description
+  description: request.description,
+  disable_previous: request.disablePrevious,
+  ...resolveOneOf([{
+    param: 'password_generation',
+    value: request.passwordGeneration ? marshalPasswordGenerationParams(request.passwordGeneration) : undefined
+  }])
 });
 const marshalUpdateSecretRequest = (request, defaults) => ({
   description: request.description,
@@ -19860,7 +20015,7 @@ let API$2 = class API extends API$q {
   pageOfListPrivateNetworks = (request = {}) => this.client.fetch({
     method: 'GET',
     path: `/vpc/v1/zones/${validatePathParam('zone', request.zone ?? this.client.settings.defaultZone)}/private-networks`,
-    urlParams: urlParams(['name', request.name], ['order_by', request.orderBy ?? 'created_at_asc'], ['organization_id', request.organizationId], ['page', request.page], ['page_size', request.pageSize ?? this.client.settings.defaultPageSize], ['private_network_ids', request.privateNetworkIds], ['project_id', request.projectId], ['tags', request.tags])
+    urlParams: urlParams(['include_regional', request.includeRegional], ['name', request.name], ['order_by', request.orderBy ?? 'created_at_asc'], ['organization_id', request.organizationId], ['page', request.page], ['page_size', request.pageSize ?? this.client.settings.defaultPageSize], ['private_network_ids', request.privateNetworkIds], ['project_id', request.projectId], ['tags', request.tags])
   }, unmarshalListPrivateNetworksResponse);
 
   /**