@scaleway/sdk 1.6.0 → 1.8.0

package/dist/index.cjs

@@ -426,7 +426,7 @@ const assertValidSettings = obj => {
   }
 };
 
-const version = 'v1.5.0';
+const version = 'v1.7.0';
 const userAgent = `scaleway-sdk-js/${version}`;
 
 const isBrowser = () => typeof window !== 'undefined' && typeof window.document !== 'undefined';
@@ -2144,7 +2144,7 @@ const jsonContentHeaders$l = {
 };
 
 /**
- * Apple silicon.
+ * Apple silicon API.
  *
  * Apple Mac mini as a service. Scaleway Apple silicon as-a-Service is built
  * using the latest generation of Apple Mac mini hardware (fifth generation).
@@ -2182,7 +2182,8 @@ let API$o = class API extends API$q {
   }, unmarshalListServerTypesResponse);
 
   /**
-   * Get a server type. Get a server technical details.
+   * Get a server type. Get technical details (CPU, disk size etc.) of a server
+   * type.
    *
    * @param request - The request {@link GetServerTypeRequest}
    * @returns A Promise of ServerType
@@ -2227,7 +2228,7 @@ let API$o = class API extends API$q {
   }, unmarshalListOSResponse$1);
 
   /**
-   * List all Operating System (OS). List all Operating System (OS). The
+   * List all Operating Systems (OS). List all Operating Systems (OS). The
    * response will include the total number of OS as well as their associated
    * IDs, names and labels.
    *
@@ -2772,8 +2773,8 @@ let API$n = class API extends API$q {
   }, unmarshalListServersResponse$1);
 
   /**
-   * List Elastic Metal servers for an organization. List Elastic Metal servers
-   * for a specific organization.
+   * List Elastic Metal servers for an Organization. List Elastic Metal servers
+   * for a specific Organization.
    *
    * @param request - The request {@link ListServersRequest}
    * @returns A Promise of ListServersResponse
@@ -3065,7 +3066,7 @@ let API$n = class API extends API$q {
   }, unmarshalListSettingsResponse);
 
   /**
-   * List all settings. Return all settings for a project ID.
+   * List all settings. Return all settings for a Project ID.
    *
    * @param request - The request {@link ListSettingsRequest}
    * @returns A Promise of ListSettingsResponse
@@ -3073,7 +3074,7 @@ let API$n = class API extends API$q {
   listSettings = (request = {}) => enrichForPagination('settings', this.pageOfListSettings, request);
 
   /**
-   * Update setting. Update a setting for a project ID (enable or disable).
+   * Update setting. Update a setting for a Project ID (enable or disable).
    *
    * @param request - The request {@link UpdateSettingRequest}
    * @returns A Promise of Setting
@@ -3100,7 +3101,7 @@ let API$n = class API extends API$q {
   listOS = (request = {}) => enrichForPagination('os', this.pageOfListOS, request);
 
   /**
-   * Get an OS with an ID. Return specific OS for the ID.
+   * Get OS with an ID. Return the specific OS for the ID.
    *
    * @param request - The request {@link GetOSRequest}
    * @returns A Promise of OS
@@ -3640,12 +3641,13 @@ const jsonContentHeaders$j = {
 /**
  * Cockpit API.
  *
- * This API allows to manage Cockpits. Cockpit API.
+ * Cockpit API. Cockpit's API allows you to activate your Cockpit on your
+ * Projects. Scaleway's Cockpit stores metrics and logs and provides a dedicated
+ * Grafana for dashboarding to visualize them.
  */
 let API$l = class API extends API$q {
   /**
-   * Activate a cockpit. Activate a cockpit associated with the given project
-   * ID.
+   * Activate a Cockpit. Activate the Cockpit of the specified Project ID.
    *
    * @param request - The request {@link ActivateCockpitRequest}
    * @returns A Promise of Cockpit
@@ -3658,7 +3660,7 @@ let API$l = class API extends API$q {
   }, unmarshalCockpit);
 
   /**
-   * Get cockpit. Get the cockpit associated with the given project ID.
+   * Get a Cockpit. Retrieve the Cockpit of the specified Project ID.
    *
    * @param request - The request {@link GetCockpitRequest}
    * @returns A Promise of Cockpit
@@ -3679,7 +3681,8 @@ 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.
+   * Get Cockpit metrics. Get metrics from your Cockpit with the specified
+   * Project ID.
    *
    * @param request - The request {@link GetCockpitMetricsRequest}
    * @returns A Promise of CockpitMetrics
@@ -3691,8 +3694,7 @@ let API$l = class API extends API$q {
   }, unmarshalCockpitMetrics);
 
   /**
-   * Deactivate a cockpit. Deactivate a cockpit associated with the given
-   * project ID.
+   * Deactivate a Cockpit. Deactivate the Cockpit of the specified Project ID.
    *
    * @param request - The request {@link DeactivateCockpitRequest}
    * @returns A Promise of Cockpit
@@ -3705,8 +3707,8 @@ let API$l = class API extends API$q {
   }, unmarshalCockpit);
 
   /**
-   * Reset Grafana. Reset the Grafana of your cockpit associated with the given
-   * project ID.
+   * Reset a Grafana. Reset your Cockpit's Grafana associated with the specified
+   * Project ID.
    *
    * @param request - The request {@link ResetCockpitGrafanaRequest}
    * @returns A Promise of Cockpit
@@ -3719,7 +3721,7 @@ let API$l = class API extends API$q {
   }, unmarshalCockpit);
 
   /**
-   * Create a token. Create a token associated with the given project ID.
+   * Create a token. Create a token associated with the specified Project ID.
    *
    * @param request - The request {@link CreateTokenRequest}
    * @returns A Promise of Token
@@ -3737,7 +3739,7 @@ let API$l = class API extends API$q {
   }, unmarshalListTokensResponse$2);
 
   /**
-   * List tokens. List tokens associated with the given project ID.
+   * List tokens. Get a list of tokens associated with the specified Project ID.
    *
    * @param request - The request {@link ListTokensRequest}
    * @returns A Promise of ListTokensResponse
@@ -3745,7 +3747,7 @@ let API$l = class API extends API$q {
   listTokens = (request = {}) => enrichForPagination('tokens', this.pageOfListTokens, request);
 
   /**
-   * Get token. Get the token associated with the given ID.
+   * Get a token. Retrieve the token associated with the specified token ID.
    *
    * @param request - The request {@link GetTokenRequest}
    * @returns A Promise of Token
@@ -3756,7 +3758,7 @@ let API$l = class API extends API$q {
   }, unmarshalToken$2);
 
   /**
-   * Delete token. Delete the token associated with the given ID.
+   * Delete a token. Delete the token associated with the specified token ID.
    *
    * @param request - The request {@link DeleteTokenRequest}
    */
@@ -3766,7 +3768,7 @@ let API$l = class API extends API$q {
   });
 
   /**
-   * Create an alert contact point. Create an alert contact point for the
+   * Create a contact point. Create a contact point to receive alerts for the
    * default receiver.
    *
    * @param request - The request {@link CreateContactPointRequest}
@@ -3785,8 +3787,8 @@ let API$l = class API extends API$q {
   }, unmarshalListContactPointsResponse);
 
   /**
-   * List alert contact points. List alert contact points associated with the
-   * given cockpit ID.
+   * List contact points. Get a list of contact points for the Cockpit
+   * associated with the specified Project ID.
    *
    * @param request - The request {@link ListContactPointsRequest}
    * @returns A Promise of ListContactPointsResponse
@@ -3794,8 +3796,8 @@ let API$l = class API extends API$q {
   listContactPoints = (request = {}) => enrichForPagination('contactPoints', this.pageOfListContactPoints, request);
 
   /**
-   * Delete an alert contact point. Delete an alert contact point for the
-   * default receiver.
+   * Delete an alert contact point. Delete a contact point for the default
+   * receiver.
    *
    * @param request - The request {@link DeleteContactPointRequest}
    */
@@ -3807,7 +3809,8 @@ let API$l = class API extends API$q {
   });
 
   /**
-   * Enable managed alerts.
+   * Enable managed alerts. Enable the sending of managed alerts for the
+   * specified Project's Cockpit.
    *
    * @param request - The request {@link EnableManagedAlertsRequest}
    */
@@ -3819,7 +3822,8 @@ let API$l = class API extends API$q {
   });
 
   /**
-   * Disable managed alerts.
+   * Disable managed alerts. Disable the sending of managed alerts for the
+   * specified Project's Cockpit.
    *
    * @param request - The request {@link DisableManagedAlertsRequest}
    */
@@ -3831,7 +3835,8 @@ let API$l = class API extends API$q {
   });
 
   /**
-   * Trigger a test alert. Trigger a test alert to all receivers.
+   * Trigger a test alert. Trigger a test alert to all of the Cockpit's
+   * receivers.
    *
    * @param request - The request {@link TriggerTestAlertRequest}
    */
@@ -3843,7 +3848,9 @@ let API$l = class API extends API$q {
   });
 
   /**
-   * Create a grafana user. Create a grafana user for your grafana instance.
+   * Create a Grafana user. Create a Grafana user for your Cockpit's Grafana
+   * instance. Make sure you save the automatically-generated password and the
+   * Grafana user ID.
    *
    * @param request - The request {@link CreateGrafanaUserRequest}
    * @returns A Promise of GrafanaUser
@@ -3861,8 +3868,8 @@ let API$l = class API extends API$q {
   }, unmarshalListGrafanaUsersResponse);
 
   /**
-   * List grafana users. List grafana users who are able to connect to your
-   * grafana instance.
+   * List Grafana users. Get a list of Grafana users who are able to connect to
+   * the Cockpit's Grafana instance.
    *
    * @param request - The request {@link ListGrafanaUsersRequest}
    * @returns A Promise of ListGrafanaUsersResponse
@@ -3870,7 +3877,8 @@ let API$l = class API extends API$q {
   listGrafanaUsers = (request = {}) => enrichForPagination('grafanaUsers', this.pageOfListGrafanaUsers, request);
 
   /**
-   * Delete a grafana user. Delete a grafana user from your grafana instance.
+   * Delete a Grafana user. Delete a Grafana user from a Grafana instance,
+   * specified by the Cockpit's Project ID and the Grafana user ID.
    *
    * @param request - The request {@link DeleteGrafanaUserRequest}
    */
@@ -3882,8 +3890,8 @@ let API$l = class API extends API$q {
   });
 
   /**
-   * Reset Grafana user password. Reset the Grafana user password from your
-   * grafana instance.
+   * Reset a Grafana user's password. Reset a Grafana user's password specified
+   * by the Cockpit's Project ID and the Grafana user ID.
    *
    * @param request - The request {@link ResetGrafanaUserPasswordRequest}
    * @returns A Promise of GrafanaUser
@@ -3901,7 +3909,7 @@ let API$l = class API extends API$q {
   }, unmarshalListPlansResponse);
 
   /**
-   * List plans. List all pricing plans.
+   * List pricing plans. Get a list of all pricing plans available.
    *
    * @param request - The request {@link ListPlansRequest}
    * @returns A Promise of ListPlansResponse
@@ -3909,7 +3917,9 @@ let API$l = class API extends API$q {
   listPlans = (request = {}) => enrichForPagination('plans', this.pageOfListPlans, request);
 
   /**
-   * Select pricing plan. Select the wanted pricing plan.
+   * Select pricing plan. Select your chosen pricing plan for your Cockpit,
+   * specifying the Cockpit's Project ID and the pricing plan's ID in the
+   * request.
    *
    * @param request - The request {@link SelectPlanRequest}
    * @returns A Promise of SelectPlanResponse
@@ -4123,6 +4133,7 @@ const marshalSecret$1 = (request, defaults) => ({
   value: request.value
 });
 const marshalCreateContainerRequest = (request, defaults) => ({
+  cpu_limit: request.cpuLimit,
   description: request.description,
   environment_variables: request.environmentVariables,
   http_option: request.httpOption ?? 'unknown_http_option',
@@ -4130,7 +4141,7 @@ const marshalCreateContainerRequest = (request, defaults) => ({
   max_scale: request.maxScale,
   memory_limit: request.memoryLimit,
   min_scale: request.minScale,
-  name: request.name || randomName('ctnr'),
+  name: request.name,
   namespace_id: request.namespaceId,
   port: request.port,
   privacy: request.privacy ?? 'unknown_privacy',
@@ -4168,6 +4179,7 @@ const marshalCreateTokenRequest$1 = (request, defaults) => ({
   }])
 });
 const marshalUpdateContainerRequest = (request, defaults) => ({
+  cpu_limit: request.cpuLimit,
   description: request.description,
   environment_variables: request.environmentVariables,
   http_option: request.httpOption ?? 'unknown_http_option',
@@ -4200,11 +4212,7 @@ const jsonContentHeaders$i = {
   'Content-Type': 'application/json; charset=utf-8'
 };
 
-/**
- * Containers API.
- *
- * Serverless Containers API. Containers API.
- */
+/** Serverless Containers API. */
 let API$k = class API extends API$q {
   /** Lists the available regions of the API. */
   static LOCALITIES = ['fr-par', 'nl-ams', 'pl-waw'];
@@ -4215,7 +4223,7 @@ let API$k = class API extends API$q {
   }, unmarshalListNamespacesResponse$3);
 
   /**
-   * List all your namespaces.
+   * List all your namespaces. List all namespaces in a specified region.
    *
    * @param request - The request {@link ListNamespacesRequest}
    * @returns A Promise of ListNamespacesResponse
@@ -4223,7 +4231,7 @@ let API$k = class API extends API$q {
   listNamespaces = (request = {}) => enrichForPagination('namespaces', this.pageOfListNamespaces, request);
 
   /**
-   * Get a namespace. Get the namespace associated with the given id.
+   * Get a namespace. Get the namespace associated with the specified ID.
    *
    * @param request - The request {@link GetNamespaceRequest}
    * @returns A Promise of Namespace
@@ -4243,7 +4251,7 @@ let API$k = class API extends API$q {
   waitForNamespace = (request, options) => waitForResource(options?.stop ?? (res => Promise.resolve(!NAMESPACE_TRANSIENT_STATUSES$2.includes(res.status))), this.getNamespace, request, options);
 
   /**
-   * Create a new namespace.
+   * Create a new namespace. Create a new namespace in a specified region.
    *
    * @param request - The request {@link CreateNamespaceRequest}
    * @returns A Promise of Namespace
@@ -4256,8 +4264,8 @@ let API$k = class API extends API$q {
   }, unmarshalNamespace$3);
 
   /**
-   * Update an existing namespace. Update the space associated with the given
-   * id.
+   * Update an existing namespace. Update the space associated with the
+   * specified ID.
    *
    * @param request - The request {@link UpdateNamespaceRequest}
    * @returns A Promise of Namespace
@@ -4271,7 +4279,7 @@ let API$k = class API extends API$q {
 
   /**
    * Delete an existing namespace. Delete the namespace associated with the
-   * given id.
+   * specified ID.
    *
    * @param request - The request {@link DeleteNamespaceRequest}
    * @returns A Promise of Namespace
@@ -4287,7 +4295,7 @@ let API$k = class API extends API$q {
   }, unmarshalListContainersResponse);
 
   /**
-   * List all your containers.
+   * List all your containers. List all containers for a specified region.
    *
    * @param request - The request {@link ListContainersRequest}
    * @returns A Promise of ListContainersResponse
@@ -4295,7 +4303,7 @@ let API$k = class API extends API$q {
   listContainers = request => enrichForPagination('containers', this.pageOfListContainers, request);
 
   /**
-   * Get a container. Get the container associated with the given id.
+   * Get a container. Get the container associated with the specified ID.
    *
    * @param request - The request {@link GetContainerRequest}
    * @returns A Promise of Container
@@ -4315,7 +4323,7 @@ let API$k = class API extends API$q {
   waitForContainer = (request, options) => waitForResource(options?.stop ?? (res => Promise.resolve(!CONTAINER_TRANSIENT_STATUSES.includes(res.status))), this.getContainer, request, options);
 
   /**
-   * Create a new container.
+   * Create a new container. Create a new container in the specified region.
    *
    * @param request - The request {@link CreateContainerRequest}
    * @returns A Promise of Container
@@ -4329,7 +4337,7 @@ let API$k = class API extends API$q {
 
   /**
    * Update an existing container. Update the container associated with the
-   * given id.
+   * specified ID.
    *
    * @param request - The request {@link UpdateContainerRequest}
    * @returns A Promise of Container
@@ -4342,7 +4350,7 @@ let API$k = class API extends API$q {
   }, unmarshalContainer);
 
   /**
-   * Delete a container. Delete the container associated with the given id.
+   * Delete a container. Delete the container associated with the specified ID.
    *
    * @param request - The request {@link DeleteContainerRequest}
    * @returns A Promise of Container
@@ -4353,7 +4361,7 @@ let API$k = class API extends API$q {
   }, unmarshalContainer);
 
   /**
-   * Deploy a container. Deploy a container associated with the given id.
+   * Deploy a container. Deploy a container associated with the specified ID.
    *
    * @param request - The request {@link DeployContainerRequest}
    * @returns A Promise of Container
@@ -4379,7 +4387,7 @@ let API$k = class API extends API$q {
   listCrons = request => enrichForPagination('crons', this.pageOfListCrons, request);
 
   /**
-   * Get a cron. Get the cron associated with the given id.
+   * Get a cron. Get the cron associated with the specified ID.
    *
    * @param request - The request {@link GetCronRequest}
    * @returns A Promise of Cron
@@ -4412,7 +4420,7 @@ let API$k = class API extends API$q {
   }, unmarshalCron$1);
 
   /**
-   * Update an existing cron. Update the cron associated with the given id.
+   * Update an existing cron. Update the cron associated with the specified ID.
    *
    * @param request - The request {@link UpdateCronRequest}
    * @returns A Promise of Cron
@@ -4425,7 +4433,7 @@ let API$k = class API extends API$q {
   }, unmarshalCron$1);
 
   /**
-   * Delete an existing cron. Delete the cron associated with the given id.
+   * Delete an existing cron. Delete the cron associated with the specified ID.
    *
    * @param request - The request {@link DeleteCronRequest}
    * @returns A Promise of Cron
@@ -4441,7 +4449,8 @@ let API$k = class API extends API$q {
   }, unmarshalListLogsResponse$1);
 
   /**
-   * List your container logs.
+   * List your container logs. List the logs of the container with the specified
+   * ID.
    *
    * @param request - The request {@link ListLogsRequest}
    * @returns A Promise of ListLogsResponse
@@ -4454,7 +4463,8 @@ let API$k = class API extends API$q {
   }, unmarshalListDomainsResponse$3);
 
   /**
-   * List all domain name bindings.
+   * List all domain name bindings. List all domain name bindings in a specified
+   * region.
    *
    * @param request - The request {@link ListDomainsRequest}
    * @returns A Promise of ListDomainsResponse
@@ -4462,7 +4472,8 @@ let API$k = class API extends API$q {
   listDomains = request => enrichForPagination('domains', this.pageOfListDomains, request);
 
   /**
-   * Get a domain name binding.
+   * Get a domain name binding. Get a domain name binding for the container with
+   * the specified ID.
    *
    * @param request - The request {@link GetDomainRequest}
    * @returns A Promise of Domain
@@ -4482,7 +4493,8 @@ let API$k = class API extends API$q {
   waitForDomain = (request, options) => waitForResource(options?.stop ?? (res => Promise.resolve(!DOMAIN_TRANSIENT_STATUSES$3.includes(res.status))), this.getDomain, request, options);
 
   /**
-   * Create a domain name binding.
+   * Create a domain name binding. Create a domain name binding for the
+   * container with the specified ID.
    *
    * @param request - The request {@link CreateDomainRequest}
    * @returns A Promise of Domain
@@ -4495,7 +4507,8 @@ let API$k = class API extends API$q {
   }, unmarshalDomain$3);
 
   /**
-   * Delete a domain name binding.
+   * Delete a domain name binding. Delete the domain name binding with the
+   * specific ID.
    *
    * @param request - The request {@link DeleteDomainRequest}
    * @returns A Promise of Domain
@@ -4536,7 +4549,7 @@ let API$k = class API extends API$q {
   }, unmarshalToken$1);
 
   /**
-   * Get a token.
+   * Get a token. Get a token with a specified ID.
    *
    * @param request - The request {@link GetTokenRequest}
    * @returns A Promise of Token
@@ -4561,7 +4574,8 @@ let API$k = class API extends API$q {
   }, unmarshalListTokensResponse$1);
 
   /**
-   * List all tokens.
+   * List all tokens. List all tokens belonging to a specified Organization or
+   * Project.
    *
    * @param request - The request {@link ListTokensRequest}
    * @returns A Promise of ListTokensResponse
@@ -4569,7 +4583,7 @@ let API$k = class API extends API$q {
   listTokens = (request = {}) => enrichForPagination('tokens', this.pageOfListTokens, request);
 
   /**
-   * Delete a token.
+   * Delete a token. Delete a token with a specified ID.
    *
    * @param request - The request {@link DeleteTokenRequest}
    * @returns A Promise of Token
@@ -5787,9 +5801,10 @@ const jsonContentHeaders$h = {
 };
 
 /**
- * DNS API.
+ * Domains and DNS API.
  *
- * DNS API. Manage your DNS zones and records.
+ * Domains and DNS API. Manage your domains, DNS zones and records with the
+ * Domains and DNS API.
  */
 let API$j = class API extends API$q {
   pageOfListDNSZones = request => this.client.fetch({
@@ -5799,8 +5814,8 @@ let API$j = class API extends API$q {
   }, unmarshalListDNSZonesResponse);
 
   /**
-   * List DNS zones. Returns a list of manageable DNS zones. You can filter the
-   * DNS zones by domain name.
+   * List DNS zones. Retrieve the list of DNS zones you can manage and filter
+   * DNS zones associated with specific domain names.
    *
    * @param request - The request {@link ListDNSZonesRequest}
    * @returns A Promise of ListDNSZonesResponse
@@ -5808,7 +5823,8 @@ let API$j = class API extends API$q {
   listDNSZones = request => enrichForPagination('dnsZones', this.pageOfListDNSZones, request);
 
   /**
-   * Create a DNS zone. Create a new DNS zone.
+   * Create a DNS zone. Create a new DNS zone specified by the domain name, the
+   * subdomain and the Project ID.
    *
    * @param request - The request {@link CreateDNSZoneRequest}
    * @returns A Promise of DNSZone
@@ -5821,7 +5837,7 @@ let API$j = class API extends API$q {
   }, unmarshalDNSZone);
 
   /**
-   * Update a DNS zone. Update the name and/or the organizations for a DNS zone.
+   * Update a DNS zone. Update the name and/or the Organizations for a DNS zone.
    *
    * @param request - The request {@link UpdateDNSZoneRequest}
    * @returns A Promise of DNSZone
@@ -5834,8 +5850,8 @@ let API$j = class API extends API$q {
   }, unmarshalDNSZone);
 
   /**
-   * Clone a DNS zone. Clone an existed DNS zone with all its records into a new
-   * one.
+   * Clone a DNS zone. Clone an existing DNS zone with all its records into a
+   * new DNS zone.
    *
    * @param request - The request {@link CloneDNSZoneRequest}
    * @returns A Promise of DNSZone
@@ -5848,7 +5864,7 @@ let API$j = class API extends API$q {
   }, unmarshalDNSZone);
 
   /**
-   * Delete DNS zone. Delete a DNS zone and all it's records.
+   * Delete a DNS zone. Delete a DNS zone and all its records.
    *
    * @param request - The request {@link DeleteDNSZoneRequest}
    * @returns A Promise of DeleteDNSZoneResponse
@@ -5865,8 +5881,9 @@ let API$j = class API extends API$q {
   }, unmarshalListDNSZoneRecordsResponse);
 
   /**
-   * List DNS zone records. Returns a list of DNS records of a DNS zone with
-   * default NS. You can filter the records by type and name.
+   * List records within a DNS zone. Retrieve a list of DNS records within a DNS
+   * zone that has default name servers. You can filter records by type and
+   * name.
    *
    * @param request - The request {@link ListDNSZoneRecordsRequest}
    * @returns A Promise of ListDNSZoneRecordsResponse
@@ -5874,22 +5891,18 @@ let API$j = class API extends API$q {
   listDNSZoneRecords = request => enrichForPagination('records', this.pageOfListDNSZoneRecords, request);
 
   /**
-   * Update DNS zone records. Only available with default NS.<br/> Send a list
-   * of actions and records.
+   * Update records within a DNS zone. Update records within a DNS zone that has
+   * default name servers and perform several actions on your records.
    *
-   * Action can be:
+   * Actions include:
    *
-   * - Add:
-   * - Add new record
-   * - Can be more specific and add a new IP to an existing A record for example
-   * - Set:
-   * - Edit a record
-   * - Can be more specific and edit an IP from an existing A record for example
-   * - Delete:
-   * - Delete a record
-   * - Can be more specific and delete an IP from an existing A record for example
-   * - Clear:
-   * - Delete all records from a DNS zone
+   * - Add: allows you to add a new record or add a new IP to an existing A
+   *   record, for example
+   * - Set: allows you to edit a record or edit an IP from an existing A record,
+   *   for example
+   * - Delete: allows you to delete a record or delete an IP from an existing A
+   *   record, for example
+   * - Clear: allows you to delete all records from a DNS zone
    *
    * All edits will be versioned.
    *
@@ -5904,8 +5917,8 @@ let API$j = class API extends API$q {
   }, unmarshalUpdateDNSZoneRecordsResponse);
 
   /**
-   * List DNS zone nameservers. Returns a list of Nameservers and their optional
-   * glue records for a DNS zone.
+   * List name servers within a DNS zone. Retrieve a list of name servers within
+   * a DNS zone and their optional glue records.
    *
    * @param request - The request {@link ListDNSZoneNameserversRequest}
    * @returns A Promise of ListDNSZoneNameserversResponse
@@ -5917,8 +5930,8 @@ let API$j = class API extends API$q {
   }, unmarshalListDNSZoneNameserversResponse);
 
   /**
-   * Update DNS zone nameservers. Update DNS zone nameservers and set optional
-   * glue records.
+   * Update name servers within a DNS zone. Update name servers within a DNS
+   * zone and set optional glue records.
    *
    * @param request - The request {@link UpdateDNSZoneNameserversRequest}
    * @returns A Promise of UpdateDNSZoneNameserversResponse
@@ -5931,8 +5944,8 @@ let API$j = class API extends API$q {
   }, unmarshalUpdateDNSZoneNameserversResponse);
 
   /**
-   * Clear DNS zone records. Only available with default NS.<br/> Delete all the
-   * records from a DNS zone. All edits will be versioned.
+   * Clear records within a DNS zone. Delete all records within a DNS zone that
+   * has default name servers.<br/> All edits will be versioned.
    *
    * @param request - The request {@link ClearDNSZoneRecordsRequest}
    * @returns A Promise of ClearDNSZoneRecordsResponse
@@ -5943,7 +5956,8 @@ let API$j = class API extends API$q {
   }, unmarshalClearDNSZoneRecordsResponse);
 
   /**
-   * Export raw DNS zone. Get a DNS zone in a given format with default NS.
+   * Export a raw DNS zone. Export a DNS zone with default name servers, in a
+   * specific format.
    *
    * @param request - The request {@link ExportRawDNSZoneRequest}
    * @returns A Promise of Blob
@@ -5956,8 +5970,8 @@ let API$j = class API extends API$q {
   });
 
   /**
-   * Import raw DNS zone. Import and replace records from a given provider
-   * format with default NS.
+   * Import a raw DNS zone. Import and replace the format of records from a
+   * given provider, with default name servers.
    *
    * @param request - The request {@link ImportRawDNSZoneRequest}
    * @returns A Promise of ImportRawDNSZoneResponse
@@ -5970,8 +5984,8 @@ let API$j = class API extends API$q {
   }, unmarshalImportRawDNSZoneResponse);
 
   /**
-   * Import provider DNS zone. Import and replace records from a given provider
-   * format with default NS.
+   * Import a DNS zone from another provider. Import and replace the format of
+   * records from a given provider, with default name servers.
    *
    * @param request - The request {@link ImportProviderDNSZoneRequest}
    * @returns A Promise of ImportProviderDNSZoneResponse
@@ -5984,8 +5998,9 @@ let API$j = class API extends API$q {
   }, unmarshalImportProviderDNSZoneResponse);
 
   /**
-   * Refresh DNS zone. Refresh SOA DNS zone. You can recreate the given DNS zone
-   * and its sub DNS zone if needed.
+   * Refresh a DNS zone. Refresh an SOA DNS zone to reload the records in the
+   * DNS zone and update the SOA serial. You can recreate the given DNS zone and
+   * its sub DNS zone if needed.
    *
    * @param request - The request {@link RefreshDNSZoneRequest}
    * @returns A Promise of RefreshDNSZoneResponse
@@ -6003,9 +6018,9 @@ let API$j = class API extends API$q {
   }, unmarshalListDNSZoneVersionsResponse);
 
   /**
-   * List DNS zone versions. Get a list of DNS zone versions.<br/> The maximum
-   * version count is 100.<br/> If the count reaches this limit, the oldest
-   * version will be deleted after each new modification.
+   * List versions of a DNS zone. Retrieve a list of a DNS zone's versions.<br/>
+   * The maximum version count is 100. If the count reaches this limit, the
+   * oldest version will be deleted after each new modification.
    *
    * @param request - The request {@link ListDNSZoneVersionsRequest}
    * @returns A Promise of ListDNSZoneVersionsResponse
@@ -6018,8 +6033,8 @@ let API$j = class API extends API$q {
   }, unmarshalListDNSZoneVersionRecordsResponse);
 
   /**
-   * List DNS zone version records. Get a list of records from a previous DNS
-   * zone version.
+   * List records from a given version of a specific DNS zone. Retrieve a list
+   * of records from a specific DNS zone version.
    *
    * @param request - The request {@link ListDNSZoneVersionRecordsRequest}
    * @returns A Promise of ListDNSZoneVersionRecordsResponse
@@ -6027,8 +6042,8 @@ let API$j = class API extends API$q {
   listDNSZoneVersionRecords = request => enrichForPagination('records', this.pageOfListDNSZoneVersionRecords, request);
 
   /**
-   * Get DNS zone version diff. Get all differences from a previous DNS zone
-   * version.
+   * Access differences from a specific DNS zone version. Access a previous DNS
+   * zone version to see the differences from another specific version.
    *
    * @param request - The request {@link GetDNSZoneVersionDiffRequest}
    * @returns A Promise of GetDNSZoneVersionDiffResponse
@@ -6039,7 +6054,8 @@ let API$j = class API extends API$q {
   }, unmarshalGetDNSZoneVersionDiffResponse);
 
   /**
-   * Restore DNS zone version. Restore and activate a previous DNS zone version.
+   * Restore a DNS zone version. Restore and activate a version of a specific
+   * DNS zone.
    *
    * @param request - The request {@link RestoreDNSZoneVersionRequest}
    * @returns A Promise of RestoreDNSZoneVersionResponse
@@ -6052,7 +6068,8 @@ let API$j = class API extends API$q {
   }, unmarshalRestoreDNSZoneVersionResponse);
 
   /**
-   * Get the zone TLS certificate if it exists.
+   * Get a DNS zone's TLS certificate. Get the DNS zone's TLS certificate. If
+   * you do not have a certificate, the ouptut returns `no certificate found`.
    *
    * @param request - The request {@link GetSSLCertificateRequest}
    * @returns A Promise of SSLCertificate
@@ -6072,7 +6089,8 @@ let API$j = class API extends API$q {
   waitForSSLCertificate = (request, options) => waitForResource(options?.stop ?? (res => Promise.resolve(!SSL_CERTIFICATE_TRANSIENT_STATUSES.includes(res.status))), this.getSSLCertificate, request, options);
 
   /**
-   * Create or return the zone TLS certificate.
+   * Create or get the DNS zone's TLS certificate. Create a new TLS certificate
+   * or retrieve information about an existing TLS certificate.
    *
    * @param request - The request {@link CreateSSLCertificateRequest}
    * @returns A Promise of SSLCertificate
@@ -6090,7 +6108,8 @@ let API$j = class API extends API$q {
   }, unmarshalListSSLCertificatesResponse);
 
   /**
-   * List all user TLS certificates.
+   * List a user's TLS certificates. List all the TLS certificates a user has
+   * created, specified by the user's Project ID and the DNS zone.
    *
    * @param request - The request {@link ListSSLCertificatesRequest}
    * @returns A Promise of ListSSLCertificatesResponse
@@ -6098,7 +6117,9 @@ let API$j = class API extends API$q {
   listSSLCertificates = request => enrichForPagination('certificates', this.pageOfListSSLCertificates, request);
 
   /**
-   * Delete an TLS certificate.
+   * Delete a TLS certificate. Delete an existing TLS certificate specified by
+   * its DNS zone. Deleting a TLS certificate is permanent and cannot be
+   * undone.
    *
    * @param request - The request {@link DeleteSSLCertificateRequest}
    * @returns A Promise of DeleteSSLCertificateResponse
@@ -6109,7 +6130,8 @@ let API$j = class API extends API$q {
   }, unmarshalDeleteSSLCertificateResponse);
 
   /**
-   * Get the DNS zone TSIG Key. Get the DNS zone TSIG Key to allow AXFR request.
+   * Get the DNS zone's TSIG key. Retrieve information about the TSIG key of a
+   * given DNS zone to allow AXFR requests.
    *
    * @param request - The request {@link GetDNSZoneTsigKeyRequest}
    * @returns A Promise of GetDNSZoneTsigKeyResponse
@@ -6120,7 +6142,8 @@ let API$j = class API extends API$q {
   }, unmarshalGetDNSZoneTsigKeyResponse);
 
   /**
-   * Delete the DNS zone TSIG Key.
+   * Delete the DNS zone's TSIG key. Delete an existing TSIG key specified by
+   * its DNS zone. Deleting a TSIG key is permanent and cannot be undone.
    *
    * @param request - The request {@link DeleteDNSZoneTsigKeyRequest}
    */
@@ -6662,13 +6685,14 @@ const jsonContentHeaders$g = {
   'Content-Type': 'application/json; charset=utf-8'
 };
 
-/** Flexible IP API. */
+/** Elastic Metal - Flexible IP API. */
 let API$i = class API extends API$q {
   /** Lists the available zones of the API. */
   static LOCALITIES = ['fr-par-1', 'fr-par-2', 'nl-ams-1'];
 
   /**
-   * Create a Flexible IP.
+   * Create a new flexible IP. Generate a new flexible IP within a given zone,
+   * specifying its configuration including Project ID and description.
    *
    * @param request - The request {@link CreateFlexibleIPRequest}
    * @returns A Promise of FlexibleIP
@@ -6681,7 +6705,9 @@ let API$i = class API extends API$q {
   }, unmarshalFlexibleIP);
 
   /**
-   * Get a Flexible IP.
+   * Get an existing flexible IP. Retrieve information about an existing
+   * flexible IP, specified by its ID and zone. Its full details, including
+   * Project ID, description and status, are returned in the response object.
    *
    * @param request - The request {@link GetFlexibleIPRequest}
    * @returns A Promise of FlexibleIP
@@ -6706,7 +6732,7 @@ let API$i = class API extends API$q {
   }, unmarshalListFlexibleIPsResponse);
 
   /**
-   * List Flexible IPs.
+   * List flexible IPs. List all flexible IPs within a given zone.
    *
    * @param request - The request {@link ListFlexibleIPsRequest}
    * @returns A Promise of ListFlexibleIPsResponse
@@ -6714,7 +6740,9 @@ let API$i = class API extends API$q {
   listFlexibleIPs = (request = {}) => enrichForPagination('flexibleIps', this.pageOfListFlexibleIPs, request);
 
   /**
-   * Update a Flexible IP.
+   * Update an existing flexible IP. Update the parameters of an existing
+   * flexible IP, specified by its ID and zone. These parameters include tags
+   * and description.
    *
    * @param request - The request {@link UpdateFlexibleIPRequest}
    * @returns A Promise of FlexibleIP
@@ -6727,7 +6755,9 @@ let API$i = class API extends API$q {
   }, unmarshalFlexibleIP);
 
   /**
-   * Delete a Flexible IP.
+   * Delete an existing flexible IP. Delete an existing flexible IP, specified
+   * by its ID and zone. Note that deleting a flexible IP is permanent and
+   * cannot be undone.
    *
    * @param request - The request {@link DeleteFlexibleIPRequest}
    */
@@ -6737,7 +6767,8 @@ let API$i = class API extends API$q {
   });
 
   /**
-   * Attach a Flexible IP to a server.
+   * Attach an existing flexible IP to a server. Attach an existing flexible IP
+   * to a specified Elastic Metal server.
    *
    * @param request - The request {@link AttachFlexibleIPRequest}
    * @returns A Promise of AttachFlexibleIPsResponse
@@ -6750,7 +6781,8 @@ let API$i = class API extends API$q {
   }, unmarshalAttachFlexibleIPsResponse);
 
   /**
-   * Detach a Flexible IP from a server.
+   * Detach an existing flexible IP from a server. Detach an existing flexible
+   * IP from a specified Elastic Metal server.
    *
    * @param request - The request {@link DetachFlexibleIPRequest}
    * @returns A Promise of DetachFlexibleIPsResponse
@@ -6763,7 +6795,8 @@ let API$i = class API extends API$q {
   }, unmarshalDetachFlexibleIPsResponse);
 
   /**
-   * Generate a virtual MAC on a given Flexible IP.
+   * Generate a virtual MAC address on an existing flexible IP. Generate a
+   * virtual MAC (Media Access Control) address on an existing flexible IP.
    *
    * @param request - The request {@link GenerateMACAddrRequest}
    * @returns A Promise of FlexibleIP
@@ -6776,8 +6809,9 @@ let API$i = class API extends API$q {
   }, unmarshalFlexibleIP);
 
   /**
-   * Duplicate a Virtual MAC. Duplicate a Virtual MAC from a given Flexible IP
-   * onto another attached on the same server.
+   * Duplicate a virtual MAC address to another flexible IP. Duplicate a virtual
+   * MAC address from a given flexible IP to another flexible IP attached to the
+   * same server.
    *
    * @param request - The request {@link DuplicateMACAddrRequest}
    * @returns A Promise of FlexibleIP
@@ -6790,8 +6824,9 @@ let API$i = class API extends API$q {
   }, unmarshalFlexibleIP);
 
   /**
-   * Move a virtual MAC. Move a Virtual MAC from a given Flexible IP onto
-   * another Flexible IP.
+   * Relocate an existing virtual MAC address to a different flexible IP.
+   * Relocate a virtual MAC (Media Access Control) address from an existing
+   * flexible IP to a different flexible IP.
    *
    * @param request - The request {@link MoveMACAddrRequest}
    * @returns A Promise of FlexibleIP
@@ -6804,7 +6839,8 @@ let API$i = class API extends API$q {
   }, unmarshalFlexibleIP);
 
   /**
-   * Remove a virtual MAC from a Flexible IP.
+   * Detach a given virtual MAC address from an existing flexible IP. Detach a
+   * given MAC (Media Access Control) address from an existing flexible IP.
    *
    * @param request - The request {@link DeleteMACAddrRequest}
    */
@@ -6944,6 +6980,7 @@ const unmarshalFunction = data => {
     throw new TypeError(`Unmarshalling the type 'Function' failed as data isn't a dictionary.`);
   }
   return {
+    buildMessage: data.build_message,
     cpuLimit: data.cpu_limit,
     description: data.description,
     domainName: data.domain_name,
@@ -7275,7 +7312,8 @@ let API$h = class API extends API$q {
   }, unmarshalListNamespacesResponse$2);
 
   /**
-   * List all your namespaces.
+   * List all your namespaces. List all existing namespaces in the specified
+   * region.
    *
    * @param request - The request {@link ListNamespacesRequest}
    * @returns A Promise of ListNamespacesResponse
@@ -7283,7 +7321,7 @@ let API$h = class API extends API$q {
   listNamespaces = (request = {}) => enrichForPagination('namespaces', this.pageOfListNamespaces, request);
 
   /**
-   * Get a namespace. Get the namespace associated with the given id.
+   * Get a namespace. Get the namespace associated with the specified ID.
    *
    * @param request - The request {@link GetNamespaceRequest}
    * @returns A Promise of Namespace
@@ -7303,7 +7341,8 @@ let API$h = class API extends API$q {
   waitForNamespace = (request, options) => waitForResource(options?.stop ?? (res => Promise.resolve(!NAMESPACE_TRANSIENT_STATUSES$1.includes(res.status))), this.getNamespace, request, options);
 
   /**
-   * Create a new namespace.
+   * Create a new namespace. Create a new namespace in a specified Organization
+   * or Proejct.
    *
    * @param request - The request {@link CreateNamespaceRequest}
    * @returns A Promise of Namespace
@@ -7316,8 +7355,8 @@ let API$h = class API extends API$q {
   }, unmarshalNamespace$2);
 
   /**
-   * Update an existing namespace. Update the space associated with the given
-   * id.
+   * Update an existing namespace. Update the namespace associated with the
+   * specified ID.
    *
    * @param request - The request {@link UpdateNamespaceRequest}
    * @returns A Promise of Namespace
@@ -7331,7 +7370,7 @@ let API$h = class API extends API$q {
 
   /**
    * Delete an existing namespace. Delete the namespace associated with the
-   * given id.
+   * specified ID.
    *
    * @param request - The request {@link DeleteNamespaceRequest}
    * @returns A Promise of Namespace
@@ -7355,7 +7394,7 @@ let API$h = class API extends API$q {
   listFunctions = request => enrichForPagination('functions', this.pageOfListFunctions, request);
 
   /**
-   * Get a function. Get the function associated with the given id.
+   * Get a function. Get the function associated with the specified ID.
    *
    * @param request - The request {@link GetFunctionRequest}
    * @returns A Promise of Function
@@ -7375,7 +7414,8 @@ let API$h = class API extends API$q {
   waitForFunction = (request, options) => waitForResource(options?.stop ?? (res => Promise.resolve(!FUNCTION_TRANSIENT_STATUSES.includes(res.status))), this.getFunction, request, options);
 
   /**
-   * Create a new function.
+   * Create a new function. Create a new function in the specified region for a
+   * specified Organization or Project.
    *
    * @param request - The request {@link CreateFunctionRequest}
    * @returns A Promise of Function
@@ -7388,8 +7428,8 @@ let API$h = class API extends API$q {
   }, unmarshalFunction);
 
   /**
-   * Update an existing function. Update the function associated with the given
-   * id.
+   * Update an existing function. Update the function associated with the
+   * specified ID.
    *
    * @param request - The request {@link UpdateFunctionRequest}
    * @returns A Promise of Function
@@ -7402,7 +7442,7 @@ let API$h = class API extends API$q {
   }, unmarshalFunction);
 
   /**
-   * Delete a function. Delete the function associated with the given id.
+   * Delete a function. Delete the function associated with the specified ID.
    *
    * @param request - The request {@link DeleteFunctionRequest}
    * @returns A Promise of Function
@@ -7413,7 +7453,7 @@ let API$h = class API extends API$q {
   }, unmarshalFunction);
 
   /**
-   * Deploy a function. Deploy a function associated with the given id.
+   * Deploy a function. Deploy a function associated with the specified ID.
    *
    * @param request - The request {@link DeployFunctionRequest}
    * @returns A Promise of Function
@@ -7438,7 +7478,7 @@ let API$h = class API extends API$q {
 
   /**
    * Get an upload URL of a function. Get an upload URL of a function associated
-   * with the given id.
+   * with the specified ID.
    *
    * @param request - The request {@link GetFunctionUploadURLRequest}
    * @returns A Promise of UploadURL
@@ -7451,7 +7491,7 @@ let API$h = class API extends API$q {
 
   /**
    * Get a download URL of a function. Get a download URL for a function
-   * associated with the given id.
+   * associated with the specified ID.
    *
    * @param request - The request {@link GetFunctionDownloadURLRequest}
    * @returns A Promise of DownloadURL
@@ -7467,7 +7507,7 @@ let API$h = class API extends API$q {
   }, unmarshalListCronsResponse);
 
   /**
-   * List all your crons.
+   * List all crons. List all the cronjobs in a specified region.
    *
    * @param request - The request {@link ListCronsRequest}
    * @returns A Promise of ListCronsResponse
@@ -7475,7 +7515,7 @@ let API$h = class API extends API$q {
   listCrons = request => enrichForPagination('crons', this.pageOfListCrons, request);
 
   /**
-   * Get a cron. Get the cron associated with the given id.
+   * Get a cron. Get the cron associated with the specified ID.
    *
    * @param request - The request {@link GetCronRequest}
    * @returns A Promise of Cron
@@ -7495,7 +7535,8 @@ let API$h = class API extends API$q {
   waitForCron = (request, options) => waitForResource(options?.stop ?? (res => Promise.resolve(!CRON_TRANSIENT_STATUSES.includes(res.status))), this.getCron, request, options);
 
   /**
-   * Create a new cron.
+   * Create a new cron. Create a new cronjob for a function with the specified
+   * ID.
    *
    * @param request - The request {@link CreateCronRequest}
    * @returns A Promise of Cron
@@ -7508,7 +7549,7 @@ let API$h = class API extends API$q {
   }, unmarshalCron);
 
   /**
-   * Update an existing cron. Update the cron associated with the given id.
+   * Update an existing cron. Update the cron associated with the specified ID.
    *
    * @param request - The request {@link UpdateCronRequest}
    * @returns A Promise of Cron
@@ -7521,7 +7562,7 @@ let API$h = class API extends API$q {
   }, unmarshalCron);
 
   /**
-   * Delete an existing cron. Delete the cron associated with the given id.
+   * Delete an existing cron. Delete the cron associated with the specified ID.
    *
    * @param request - The request {@link DeleteCronRequest}
    * @returns A Promise of Cron
@@ -7537,7 +7578,8 @@ let API$h = class API extends API$q {
   }, unmarshalListLogsResponse);
 
   /**
-   * List your application logs.
+   * List application logs. List the application logs of the function with the
+   * specified ID.
    *
    * @param request - The request {@link ListLogsRequest}
    * @returns A Promise of ListLogsResponse
@@ -7550,7 +7592,8 @@ let API$h = class API extends API$q {
   }, unmarshalListDomainsResponse$1);
 
   /**
-   * List all domain name bindings.
+   * List all domain name bindings. List all domain name bindings in a specified
+   * region.
    *
    * @param request - The request {@link ListDomainsRequest}
    * @returns A Promise of ListDomainsResponse
@@ -7558,7 +7601,8 @@ let API$h = class API extends API$q {
   listDomains = request => enrichForPagination('domains', this.pageOfListDomains, request);
 
   /**
-   * Get a domain name binding.
+   * Get a domain name binding. Get a domain name binding for the function with
+   * the specified ID.
    *
    * @param request - The request {@link GetDomainRequest}
    * @returns A Promise of Domain
@@ -7578,7 +7622,8 @@ let API$h = class API extends API$q {
   waitForDomain = (request, options) => waitForResource(options?.stop ?? (res => Promise.resolve(!DOMAIN_TRANSIENT_STATUSES$1.includes(res.status))), this.getDomain, request, options);
 
   /**
-   * Create a domain name binding.
+   * Create a domain name binding. Create a domain name binding for the function
+   * with the specified ID.
    *
    * @param request - The request {@link CreateDomainRequest}
    * @returns A Promise of Domain
@@ -7591,7 +7636,8 @@ let API$h = class API extends API$q {
   }, unmarshalDomain$1);
 
   /**
-   * Delete a domain name binding.
+   * Delete a domain name binding. Delete a domain name binding for the function
+   * with the specified ID.
    *
    * @param request - The request {@link DeleteDomainRequest}
    * @returns A Promise of Domain
@@ -7885,6 +7931,7 @@ const unmarshalUser$1 = data => {
     email: data.email,
     id: data.id,
     lastLoginAt: unmarshalDate(data.last_login_at),
+    mfa: data.mfa,
     organizationId: data.organization_id,
     status: data.status,
     twoFactorEnabled: data.two_factor_enabled,
@@ -8185,7 +8232,7 @@ let API$g = class API extends API$q {
   pageOfListUsers = (request = {}) => this.client.fetch({
     method: 'GET',
     path: `/iam/v1alpha1/users`,
-    urlParams: urlParams(['order_by', request.orderBy ?? 'created_at_asc'], ['organization_id', request.organizationId ?? this.client.settings.defaultOrganizationId], ['page', request.page], ['page_size', request.pageSize ?? this.client.settings.defaultPageSize], ['user_ids', request.userIds])
+    urlParams: urlParams(['mfa', request.mfa], ['order_by', request.orderBy ?? 'created_at_asc'], ['organization_id', request.organizationId ?? this.client.settings.defaultOrganizationId], ['page', request.page], ['page_size', request.pageSize ?? this.client.settings.defaultPageSize], ['user_ids', request.userIds])
   }, unmarshalListUsersResponse$1);
 
   /**
@@ -8203,8 +8250,7 @@ let API$g = class API extends API$q {
   /**
    * Get a given user. Retrieve information about a user, specified by the
    * `user_id` parameter. The user's full details, including `id`, `email`,
-   * `organization_id`, `status` and `two_factor_enabled` are returned in the
-   * response.
+   * `organization_id`, `status` and `mfa` are returned in the response.
    *
    * @param request - The request {@link GetUserRequest}
    * @returns A Promise of User
@@ -10316,7 +10362,7 @@ let API$f = class API extends API$q {
   }, unmarshalListServersTypesResponse);
 
   /**
-   * List volumes types. List all volume types and their technical details.
+   * List volume types. List all volume types and their technical details.
    *
    * @param request - The request {@link ListVolumesTypesRequest}
    * @returns A Promise of ListVolumesTypesResponse
@@ -10405,7 +10451,7 @@ let API$f = class API extends API$q {
    * 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.
+   * information, read the [Volumes](#path-volumes-list-volumes) documentation.
    *
    * @param request - The request {@link ServerActionRequest}
    * @returns A Promise of ServerActionResponse
@@ -11942,9 +11988,9 @@ const jsonContentHeaders$c = {
 };
 
 /**
- * IoT API.
+ * IoT Hub API.
  *
- * This API allows you to manage IoT hubs and devices. IoT API.
+ * This API allows you to manage IoT hubs and devices. IoT Hub API.
  */
 let API$e = class API extends API$q {
   /** Lists the available regions of the API. */
@@ -11956,7 +12002,9 @@ let API$e = class API extends API$q {
   }, unmarshalListHubsResponse);
 
   /**
-   * List hubs.
+   * List hubs. List all Hubs in the specified zone. By default, returned Hubs
+   * are ordered by creation date in ascending order, though this can be
+   * modified via the `order_by` field.
    *
    * @param request - The request {@link ListHubsRequest}
    * @returns A Promise of ListHubsResponse
@@ -11964,7 +12012,8 @@ let API$e = class API extends API$q {
   listHubs = (request = {}) => enrichForPagination('hubs', this.pageOfListHubs, request);
 
   /**
-   * Create a hub.
+   * Create a hub. Create a new Hub in the targeted region, specifying its
+   * configuration including name and product plan.
    *
    * @param request - The request {@link CreateHubRequest}
    * @returns A Promise of Hub
@@ -11977,7 +12026,9 @@ let API$e = class API extends API$q {
   }, unmarshalHub);
 
   /**
-   * Get a hub.
+   * Get a hub. Retrieve information about an existing IoT Hub, specified by its
+   * Hub ID. Its full details, including name, status and endpoint, are returned
+   * in the response object.
    *
    * @param request - The request {@link GetHubRequest}
    * @returns A Promise of Hub
@@ -11997,7 +12048,8 @@ let API$e = class API extends API$q {
   waitForHub = (request, options) => waitForResource(options?.stop ?? (res => Promise.resolve(!HUB_TRANSIENT_STATUSES.includes(res.status))), this.getHub, request, options);
 
   /**
-   * Update a hub.
+   * Update a hub. Update the parameters of an existing IoT Hub, specified by
+   * its Hub ID.
    *
    * @param request - The request {@link UpdateHubRequest}
    * @returns A Promise of Hub
@@ -12010,7 +12062,7 @@ let API$e = class API extends API$q {
   }, unmarshalHub);
 
   /**
-   * Enable a hub.
+   * Enable a hub. Enable an existing IoT Hub, specified by its Hub ID.
    *
    * @param request - The request {@link EnableHubRequest}
    * @returns A Promise of Hub
@@ -12023,7 +12075,7 @@ let API$e = class API extends API$q {
   }, unmarshalHub);
 
   /**
-   * Disable a hub.
+   * Disable a hub. Disable an existing IoT Hub, specified by its Hub ID.
    *
    * @param request - The request {@link DisableHubRequest}
    * @returns A Promise of Hub
@@ -12036,7 +12088,8 @@ let API$e = class API extends API$q {
   }, unmarshalHub);
 
   /**
-   * Delete a hub.
+   * Delete a hub. Delete an existing IoT Hub, specified by its Hub ID. Deleting
+   * a Hub is permanent, and cannot be undone.
    *
    * @param request - The request {@link DeleteHubRequest}
    */
@@ -12047,7 +12100,8 @@ let API$e = class API extends API$q {
   });
 
   /**
-   * Get a hub's metrics.
+   * Get a hub's metrics. Get the metrics of an existing IoT Hub, specified by
+   * its Hub ID.
    *
    * @deprecated
    * @param request - The request {@link GetHubMetricsRequest}
@@ -12060,7 +12114,8 @@ let API$e = class API extends API$q {
   }, unmarshalGetHubMetricsResponse);
 
   /**
-   * Set the certificate authority of a hub.
+   * Set the certificate authority of a hub. Set a particular PEM-encoded
+   * certificate, specified by the Hub ID.
    *
    * @param request - The request {@link SetHubCARequest}
    * @returns A Promise of Hub
@@ -12073,7 +12128,8 @@ let API$e = class API extends API$q {
   }, unmarshalHub);
 
   /**
-   * Get the certificate authority of a hub.
+   * Get the certificate authority of a hub. Get information for a particular
+   * PEM-encoded certificate, specified by the Hub ID.
    *
    * @param request - The request {@link GetHubCARequest}
    * @returns A Promise of GetHubCAResponse
@@ -12089,7 +12145,9 @@ let API$e = class API extends API$q {
   }, unmarshalListDevicesResponse);
 
   /**
-   * List devices.
+   * List devices. List all devices in the specified region. By default,
+   * returned devices are ordered by creation date in ascending order, though
+   * this can be modified via the `order_by` field.
    *
    * @param request - The request {@link ListDevicesRequest}
    * @returns A Promise of ListDevicesResponse
@@ -12097,7 +12155,7 @@ let API$e = class API extends API$q {
   listDevices = (request = {}) => enrichForPagination('devices', this.pageOfListDevices, request);
 
   /**
-   * Add a device.
+   * Add a device. Attach a device to a given Hub.
    *
    * @param request - The request {@link CreateDeviceRequest}
    * @returns A Promise of CreateDeviceResponse
@@ -12110,7 +12168,9 @@ let API$e = class API extends API$q {
   }, unmarshalCreateDeviceResponse);
 
   /**
-   * Get a device.
+   * Get a device. Retrieve information about an existing device, specified by
+   * its device ID. Its full details, including name, status and ID, are
+   * returned in the response object.
    *
    * @param request - The request {@link GetDeviceRequest}
    * @returns A Promise of Device
@@ -12121,7 +12181,8 @@ let API$e = class API extends API$q {
   }, unmarshalDevice);
 
   /**
-   * Update a device.
+   * Update a device. Update the parameters of an existing device, specified by
+   * its device ID.
    *
    * @param request - The request {@link UpdateDeviceRequest}
    * @returns A Promise of Device
@@ -12134,7 +12195,7 @@ let API$e = class API extends API$q {
   }, unmarshalDevice);
 
   /**
-   * Enable a device.
+   * Enable a device. Enable a specific device, specified by its device ID.
    *
    * @param request - The request {@link EnableDeviceRequest}
    * @returns A Promise of Device
@@ -12147,7 +12208,7 @@ let API$e = class API extends API$q {
   }, unmarshalDevice);
 
   /**
-   * Disable a device.
+   * Disable a device. Disable an existing device, specified by its device ID.
    *
    * @param request - The request {@link DisableDeviceRequest}
    * @returns A Promise of Device
@@ -12160,7 +12221,8 @@ let API$e = class API extends API$q {
   }, unmarshalDevice);
 
   /**
-   * Renew a device certificate.
+   * Renew a device certificate. Renew the certificate of an existing device,
+   * specified by its device ID.
    *
    * @param request - The request {@link RenewDeviceCertificateRequest}
    * @returns A Promise of RenewDeviceCertificateResponse
@@ -12173,7 +12235,8 @@ let API$e = class API extends API$q {
   }, unmarshalRenewDeviceCertificateResponse);
 
   /**
-   * Set a custom certificate on a device.
+   * Set a custom certificate on a device. Switch the existing certificate of a
+   * given device with an EM-encoded custom certificate.
    *
    * @param request - The request {@link SetDeviceCertificateRequest}
    * @returns A Promise of SetDeviceCertificateResponse
@@ -12186,7 +12249,9 @@ let API$e = class API extends API$q {
   }, unmarshalSetDeviceCertificateResponse);
 
   /**
-   * Get a device's certificate.
+   * Get a device's certificate. Get information for a particular PEM-encoded
+   * certificate, specified by the device ID. The response returns full details
+   * of the device, including its type of certificate.
    *
    * @param request - The request {@link GetDeviceCertificateRequest}
    * @returns A Promise of GetDeviceCertificateResponse
@@ -12197,7 +12262,8 @@ let API$e = class API extends API$q {
   }, unmarshalGetDeviceCertificateResponse);
 
   /**
-   * Remove a device.
+   * Remove a device. Remove a specific device from the specific Hub it is
+   * attached to.
    *
    * @param request - The request {@link DeleteDeviceRequest}
    */
@@ -12207,7 +12273,8 @@ let API$e = class API extends API$q {
   });
 
   /**
-   * Get a device's metrics.
+   * Get a device's metrics. Get the metrics of an existing device, specified by
+   * its device ID.
    *
    * @deprecated
    * @param request - The request {@link GetDeviceMetricsRequest}
@@ -12225,7 +12292,9 @@ let API$e = class API extends API$q {
   }, unmarshalListRoutesResponse$1);
 
   /**
-   * List routes.
+   * List routes. List all routes in the specified region. By default, returned
+   * routes are ordered by creation date in ascending order, though this can be
+   * modified via the `order_by` field.
    *
    * @param request - The request {@link ListRoutesRequest}
    * @returns A Promise of ListRoutesResponse
@@ -12233,15 +12302,15 @@ let API$e = class API extends API$q {
   listRoutes = (request = {}) => enrichForPagination('routes', this.pageOfListRoutes, request);
 
   /**
-   * Create a route. Multiple route kinds can be created:
+   * Create a route. Multiple kinds of routes can be created, such as:
    *
-   * - Database Route. Create a route that will record subscribed MQTT messages
+   * - Database Route Create a route that will record subscribed MQTT messages
    *   into your database. <b>You need to manage the database by yourself</b>.
    * - REST Route. Create a route that will call a REST API on received subscribed
    *   MQTT messages.
    * - S3 Routes. Create a route that will put subscribed MQTT messages into an S3
-   *   bucket. You need to create the bucket yourself and grant us write access.
-   *   The grant can be done with s3cmd (`s3cmd setacl s3://&lt;my-bucket&gt;
+   *   bucket. You need to create the bucket yourself and grant write access.
+   *   Granting can be done with s3cmd (`s3cmd setacl s3://&lt;my-bucket&gt;
    *   --acl-grant=write:555c69c3-87d0-4bf8-80f1-99a2f757d031:555c69c3-87d0-4bf8-80f1-99a2f757d031`).
    *
    * @param request - The request {@link CreateRouteRequest}
@@ -12255,7 +12324,8 @@ let API$e = class API extends API$q {
   }, unmarshalRoute$1);
 
   /**
-   * Update a route.
+   * Update a route. Update the parameters of an existing route, specified by
+   * its route ID.
    *
    * @param request - The request {@link UpdateRouteRequest}
    * @returns A Promise of Route
@@ -12268,7 +12338,9 @@ let API$e = class API extends API$q {
   }, unmarshalRoute$1);
 
   /**
-   * Get a route.
+   * Get a route. Get information for a particular route, specified by the route
+   * ID. The response returns full details of the route, including its type, the
+   * topic it subscribes to and its configuration.
    *
    * @param request - The request {@link GetRouteRequest}
    * @returns A Promise of Route
@@ -12279,7 +12351,8 @@ let API$e = class API extends API$q {
   }, unmarshalRoute$1);
 
   /**
-   * Delete a route.
+   * Delete a route. Delete an existing route, specified by its route ID.
+   * Deleting a route is permanent, and cannot be undone.
    *
    * @param request - The request {@link DeleteRouteRequest}
    */
@@ -12294,7 +12367,7 @@ let API$e = class API extends API$q {
   }, unmarshalListNetworksResponse);
 
   /**
-   * List the Networks.
+   * List the networks.
    *
    * @param request - The request {@link ListNetworksRequest}
    * @returns A Promise of ListNetworksResponse
@@ -12302,7 +12375,9 @@ let API$e = class API extends API$q {
   listNetworks = (request = {}) => enrichForPagination('networks', this.pageOfListNetworks, request);
 
   /**
-   * Create a new Network.
+   * Create a new network. Create a new network for an existing hub. Beside the
+   * default network, you can add networks for different data providers.
+   * Possible network types are Sigfox and REST.
    *
    * @param request - The request {@link CreateNetworkRequest}
    * @returns A Promise of CreateNetworkResponse
@@ -12315,7 +12390,9 @@ let API$e = class API extends API$q {
   }, unmarshalCreateNetworkResponse);
 
   /**
-   * Retrieve a specific Network.
+   * Retrieve a specific network. Retrieve an existing network, specified by its
+   * network ID. The response returns full details of the network, including its
+   * type, the topic prefix and its endpoint.
    *
    * @param request - The request {@link GetNetworkRequest}
    * @returns A Promise of Network
@@ -12326,7 +12403,8 @@ let API$e = class API extends API$q {
   }, unmarshalNetwork);
 
   /**
-   * Delete a Network.
+   * Delete a Network. Delete an existing network, specified by its network ID.
+   * Deleting a network is permanent, and cannot be undone.
    *
    * @param request - The request {@link DeleteNetworkRequest}
    */
@@ -12808,7 +12886,7 @@ const jsonContentHeaders$b = {
   'Content-Type': 'application/json; charset=utf-8'
 };
 
-/** Kapsule API. */
+/** Kubernetes API. */
 let API$d = class API extends API$q {
   /** Lists the available regions of the API. */
   static LOCALITIES = ['fr-par', 'nl-ams', 'pl-waw'];
@@ -16128,7 +16206,8 @@ let API$a = class API extends API$q {
   }, unmarshalListImagesResponse$1);
 
   /**
-   * List marketplace images.
+   * List marketplace images. List all available images on the marketplace,
+   * their UUID, CPU architecture and description.
    *
    * @param request - The request {@link ListImagesRequest}
    * @returns A Promise of ListImagesResponse
@@ -16136,7 +16215,8 @@ let API$a = class API extends API$q {
   listImages = request => enrichForPagination('images', this.pageOfListImages, request);
 
   /**
-   * Get a specific marketplace image.
+   * Get a specific marketplace image. Get detailed information about a
+   * marketplace image, specified by its `image_id` (UUID format).
    *
    * @param request - The request {@link GetImageRequest}
    * @returns A Promise of Image
@@ -16150,7 +16230,24 @@ let API$a = class API extends API$q {
     path: `/marketplace/v2/versions`,
     urlParams: urlParams(['image_id', request.imageId], ['order_by', request.orderBy ?? 'created_at_asc'], ['page', request.page], ['page_size', request.pageSize ?? this.client.settings.defaultPageSize])
   }, unmarshalListVersionsResponse);
+
+  /**
+   * List versions of an Image. Get a list of all available version of an image,
+   * specified by its `image_id` (UUID format).
+   *
+   * @param request - The request {@link ListVersionsRequest}
+   * @returns A Promise of ListVersionsResponse
+   */
   listVersions = request => enrichForPagination('versions', this.pageOfListVersions, request);
+
+  /**
+   * Get a specific image version. Get information such as the name, creation
+   * date, last update and published date for an image version specified by its
+   * `version_id` (UUID format).
+   *
+   * @param request - The request {@link GetVersionRequest}
+   * @returns A Promise of Version
+   */
   getVersion = request => this.client.fetch({
     method: 'GET',
     path: `/marketplace/v2/versions/${validatePathParam('versionId', request.versionId)}`
@@ -16171,12 +16268,25 @@ let API$a = class API extends API$q {
   }, unmarshalListLocalImagesResponse);
 
   /**
-   * List local images from a specific image or version.
+   * List local images from a specific image or version. List information about
+   * local images in a specific Availability Zone, specified by its `image_id`
+   * (UUID format), `version_id` (UUID format) or `image_label`. Only one of
+   * these three parameters may be set.
    *
    * @param request - The request {@link ListLocalImagesRequest}
    * @returns A Promise of ListLocalImagesResponse
    */
   listLocalImages = (request = {}) => enrichForPagination('localImages', this.pageOfListLocalImages, request);
+
+  /**
+   * Get a specific local image by ID. Get detailed information about a local
+   * image, including compatible commercial types, supported architecture,
+   * labels and the Availability Zone of the image, specified by its
+   * `local_image_id` (UUID format).
+   *
+   * @param request - The request {@link GetLocalImageRequest}
+   * @returns A Promise of LocalImage
+   */
   getLocalImage = request => this.client.fetch({
     method: 'GET',
     path: `/marketplace/v2/local-images/${validatePathParam('localImageId', request.localImageId)}`
@@ -16186,7 +16296,23 @@ let API$a = class API extends API$q {
     path: `/marketplace/v2/categories`,
     urlParams: urlParams(['page', request.page], ['page_size', request.pageSize ?? this.client.settings.defaultPageSize])
   }, unmarshalListCategoriesResponse);
+
+  /**
+   * List existing image categories. Get a list of all existing categories. The
+   * output can be paginated.
+   *
+   * @param request - The request {@link ListCategoriesRequest}
+   * @returns A Promise of ListCategoriesResponse
+   */
   listCategories = (request = {}) => enrichForPagination('categories', this.pageOfListCategories, request);
+
+  /**
+   * Get a specific category. Get information about a specific category of the
+   * marketplace catalog, specified by its `category_id` (UUID format).
+   *
+   * @param request - The request {@link GetCategoryRequest}
+   * @returns A Promise of Category
+   */
   getCategory = request => this.client.fetch({
     method: 'GET',
     path: `/marketplace/v2/categories/${validatePathParam('categoryId', request.categoryId)}`
@@ -16310,10 +16436,7 @@ const marshalPermissions = (request, defaults) => ({
 const marshalCreateCredentialRequest = (request, defaults) => ({
   name: request.name || randomName('mnq'),
   namespace_id: request.namespaceId,
-  ...resolveOneOf([{
-    param: 'permissions',
-    value: request.permissions ? marshalPermissions(request.permissions) : undefined
-  }])
+  permissions: request.permissions ? marshalPermissions(request.permissions) : undefined
 });
 const marshalCreateNamespaceRequest$1 = (request, defaults) => ({
   name: request.name || randomName('mnq'),
@@ -16322,10 +16445,7 @@ const marshalCreateNamespaceRequest$1 = (request, defaults) => ({
 });
 const marshalUpdateCredentialRequest = (request, defaults) => ({
   name: request.name,
-  ...resolveOneOf([{
-    param: 'permissions',
-    value: request.permissions ? marshalPermissions(request.permissions) : undefined
-  }])
+  permissions: request.permissions ? marshalPermissions(request.permissions) : undefined
 });
 const marshalUpdateNamespaceRequest$1 = (request, defaults) => ({
   name: request.name,
@@ -16338,9 +16458,10 @@ const jsonContentHeaders$9 = {
 };
 
 /**
- * MnQ API (beta).
+ * Messaging and Queuing API.
  *
- * This API allows you to manage Messaging or Queueing brokers. MnQ API (beta).
+ * This API allows you to manage Scaleway Messaging and Queueing brokers.
+ * Messaging and Queuing API.
  */
 let API$9 = class API extends API$q {
   /** Lists the available regions of the API. */
@@ -16352,7 +16473,10 @@ let API$9 = class API extends API$q {
   }, unmarshalListNamespacesResponse$1);
 
   /**
-   * List namespaces.
+   * List namespaces. List all Messaging and Queuing namespaces in the specified
+   * region, for a Scaleway Organization or Project. By default, the namespaces
+   * returned in the list are ordered by creation date in ascending order,
+   * though this can be modified via the `order_by` field.
    *
    * @param request - The request {@link ListNamespacesRequest}
    * @returns A Promise of ListNamespacesResponse
@@ -16360,7 +16484,8 @@ let API$9 = class API extends API$q {
   listNamespaces = (request = {}) => enrichForPagination('namespaces', this.pageOfListNamespaces, request);
 
   /**
-   * Create a namespace.
+   * Create a namespace. Create a Messaging and Queuing namespace, set to the
+   * desired protocol.
    *
    * @param request - The request {@link CreateNamespaceRequest}
    * @returns A Promise of Namespace
@@ -16373,7 +16498,8 @@ let API$9 = class API extends API$q {
   }, unmarshalNamespace$1);
 
   /**
-   * Update the name of a namespace.
+   * Update the name of a namespace. Update the name of a Messaging and Queuing
+   * namespace, specified by its namespace ID.
    *
    * @param request - The request {@link UpdateNamespaceRequest}
    * @returns A Promise of Namespace
@@ -16386,7 +16512,9 @@ let API$9 = class API extends API$q {
   }, unmarshalNamespace$1);
 
   /**
-   * Get a namespace.
+   * Get a namespace. Retrieve information about an existing Messaging and
+   * Queuing namespace, identified by its namespace ID. Its full details,
+   * including name, endpoint and protocol, are returned in the response.
    *
    * @param request - The request {@link GetNamespaceRequest}
    * @returns A Promise of Namespace
@@ -16397,7 +16525,10 @@ let API$9 = class API extends API$q {
   }, unmarshalNamespace$1);
 
   /**
-   * Delete a namespace.
+   * Delete a namespace. Delete a Messaging and Queuing namespace, specified by
+   * its namespace ID. Note that deleting a namespace is irreversible, and any
+   * URLs, credentials and queued messages belonging to this namespace will also
+   * be deleted.
    *
    * @param request - The request {@link DeleteNamespaceRequest}
    */
@@ -16407,8 +16538,11 @@ let API$9 = class API extends API$q {
   });
 
   /**
-   * Create a set of credentials. Create a set of credentials for a specific
-   * namespace.
+   * Create credentials. Create a set of credentials for a Messaging and Queuing
+   * namespace, specified by its namespace ID. If creating credentials for a
+   * NATS namespace, the `permissions` object must not be included in the
+   * request. If creating credentials for an SQS/SNS namespace, the
+   * `permissions` object is required, with all three of its child attributes.
    *
    * @param request - The request {@link CreateCredentialRequest}
    * @returns A Promise of Credential
@@ -16421,7 +16555,9 @@ let API$9 = class API extends API$q {
   }, unmarshalCredential);
 
   /**
-   * Delete credentials.
+   * Delete credentials. Delete a set of credentials, specified by their
+   * credential ID. Deleting credentials is irreversible and cannot be undone.
+   * The credentials can no longer be used to access the namespace.
    *
    * @param request - The request {@link DeleteCredentialRequest}
    */
@@ -16436,7 +16572,9 @@ let API$9 = class API extends API$q {
   }, unmarshalListCredentialsResponse);
 
   /**
-   * List credentials.
+   * List credentials. List existing credentials in the specified region. The
+   * response contains only the metadata for the credentials, not the
+   * credentials themselves (for this, use **Get Credentials**).
    *
    * @param request - The request {@link ListCredentialsRequest}
    * @returns A Promise of ListCredentialsResponse
@@ -16444,7 +16582,10 @@ let API$9 = class API extends API$q {
   listCredentials = (request = {}) => enrichForPagination('credentials', this.pageOfListCredentials, request);
 
   /**
-   * Update a set of credentials.
+   * Update credentials. Update a set of credentials. You can update the
+   * credentials' name, or (in the case of SQS/SNS credentials only) their
+   * permissions. To update the name of NATS credentials, do not include the
+   * `permissions` object in your request.
    *
    * @param request - The request {@link UpdateCredentialRequest}
    * @returns A Promise of Credential
@@ -16457,7 +16598,9 @@ let API$9 = class API extends API$q {
   }, unmarshalCredential);
 
   /**
-   * Get a set of credentials.
+   * Get credentials. Retrieve an existing set of credentials, identified by the
+   * `credential_id`. The credentials themselves, as well as their metadata
+   * (protocol, namespace ID etc), are returned in the response.
    *
    * @param request - The request {@link GetCredentialRequest}
    * @returns A Promise of Credential
@@ -18863,11 +19006,7 @@ const jsonContentHeaders$6 = {
   'Content-Type': 'application/json; charset=utf-8'
 };
 
-/**
- * Registry API.
- *
- * Container registry API. Registry API.
- */
+/** Container Registry API. */
 let API$6 = class API extends API$q {
   /** Lists the available regions of the API. */
   static LOCALITIES = ['fr-par', 'nl-ams', 'pl-waw'];
@@ -18878,7 +19017,11 @@ let API$6 = class API extends API$q {
   }, unmarshalListNamespacesResponse);
 
   /**
-   * List all your namespaces.
+   * List namespaces. List all namespaces in a specified region. By default, the
+   * namespaces listed are ordered by creation date in ascending order. This can
+   * be modified via the order_by field. You can also define additional
+   * parameters for your query, such as the `instance_id` and `project_id`
+   * parameters.
    *
    * @param request - The request {@link ListNamespacesRequest}
    * @returns A Promise of ListNamespacesResponse
@@ -18886,7 +19029,10 @@ let API$6 = class API extends API$q {
   listNamespaces = (request = {}) => enrichForPagination('namespaces', this.pageOfListNamespaces, request);
 
   /**
-   * Get a namespace. Get the namespace associated with the given id.
+   * Get a namespace. Retrieve information about a given namespace, specified by
+   * its `namespace_id` and region. Full details about the namespace, such as
+   * `description`, `project_id`, `status`, `endpoint`, `is_public`, `size`, and
+   * `image_count` are returned in the response.
    *
    * @param request - The request {@link GetNamespaceRequest}
    * @returns A Promise of Namespace
@@ -18906,7 +19052,10 @@ let API$6 = class API extends API$q {
   waitForNamespace = (request, options) => waitForResource(options?.stop ?? (res => Promise.resolve(!NAMESPACE_TRANSIENT_STATUSES.includes(res.status))), this.getNamespace, request, options);
 
   /**
-   * Create a new namespace.
+   * Create a namespace. Create a new Container Registry namespace. You must
+   * specify the namespace name and region in which you want it to be created.
+   * Optionally, you can specify the `project_id` and `is_public` in the request
+   * payload.
    *
    * @param request - The request {@link CreateNamespaceRequest}
    * @returns A Promise of Namespace
@@ -18919,8 +19068,9 @@ let API$6 = class API extends API$q {
   }, unmarshalNamespace);
 
   /**
-   * Update an existing namespace. Update the namespace associated with the
-   * given id.
+   * Update a namespace. Update the parameters of a given namespace, specified
+   * by its `namespace_id` and `region`. You can update the `description` and
+   * `is_public` parameters.
    *
    * @param request - The request {@link UpdateNamespaceRequest}
    * @returns A Promise of Namespace
@@ -18933,8 +19083,9 @@ let API$6 = class API extends API$q {
   }, unmarshalNamespace);
 
   /**
-   * Delete an existing namespace. Delete the namespace associated with the
-   * given id.
+   * Delete a namespace. Delete a given namespace. You must specify, in the
+   * endpoint, the `region` and `namespace_id` parameters of the namespace you
+   * want to delete.
    *
    * @param request - The request {@link DeleteNamespaceRequest}
    * @returns A Promise of Namespace
@@ -18950,7 +19101,10 @@ let API$6 = class API extends API$q {
   }, unmarshalListImagesResponse);
 
   /**
-   * List all your images.
+   * List images. List all images in a specified region. By default, the images
+   * listed are ordered by creation date in ascending order. This can be
+   * modified via the order_by field. You can also define additional parameters
+   * for your query, such as the `namespace_id` and `project_id` parameters.
    *
    * @param request - The request {@link ListImagesRequest}
    * @returns A Promise of ListImagesResponse
@@ -18958,7 +19112,10 @@ let API$6 = class API extends API$q {
   listImages = (request = {}) => enrichForPagination('images', this.pageOfListImages, request);
 
   /**
-   * Get a image. Get the image associated with the given id.
+   * Get an image. Retrieve information about a given container image, specified
+   * by its `image_id` and region. Full details about the image, such as `name`,
+   * `namespace_id`, `status`, `visibility`, and `size` are returned in the
+   * response.
    *
    * @param request - The request {@link GetImageRequest}
    * @returns A Promise of Image
@@ -18978,7 +19135,8 @@ let API$6 = class API extends API$q {
   waitForImage = (request, options) => waitForResource(options?.stop ?? (res => Promise.resolve(!IMAGE_TRANSIENT_STATUSES.includes(res.status))), this.getImage, request, options);
 
   /**
-   * Update an existing image. Update the image associated with the given id.
+   * Update an image. Update the parameters of a given image, specified by its
+   * `image_id` and `region`. You can update the `visibility` parameter.
    *
    * @param request - The request {@link UpdateImageRequest}
    * @returns A Promise of Image
@@ -18991,7 +19149,8 @@ let API$6 = class API extends API$q {
   }, unmarshalImage);
 
   /**
-   * Delete an image. Delete the image associated with the given id.
+   * Delete an image. Delete a given image. You must specify, in the endpoint,
+   * the `region` and `image_id` parameters of the image you want to delete.
    *
    * @param request - The request {@link DeleteImageRequest}
    * @returns A Promise of Image
@@ -19007,7 +19166,10 @@ let API$6 = class API extends API$q {
   }, unmarshalListTagsResponse);
 
   /**
-   * List all your tags.
+   * List tags. List all tags for a given image, specified by region. By
+   * default, the tags listed are ordered by creation date in ascending order.
+   * This can be modified via the order_by field. You can also define additional
+   * parameters for your query, such as the `name`.
    *
    * @param request - The request {@link ListTagsRequest}
    * @returns A Promise of ListTagsResponse
@@ -19015,7 +19177,9 @@ let API$6 = class API extends API$q {
   listTags = request => enrichForPagination('tags', this.pageOfListTags, request);
 
   /**
-   * Get a tag. Get the tag associated with the given id.
+   * Get a tag. Retrieve information about a given image tag, specified by its
+   * `tag_id` and region. Full details about the tag, such as `name`,
+   * `image_id`, `status`, and `digest` are returned in the response.
    *
    * @param request - The request {@link GetTagRequest}
    * @returns A Promise of Tag
@@ -19035,7 +19199,8 @@ let API$6 = class API extends API$q {
   waitForTag = (request, options) => waitForResource(options?.stop ?? (res => Promise.resolve(!TAG_TRANSIENT_STATUSES.includes(res.status))), this.getTag, request, options);
 
   /**
-   * Delete a tag. Delete the tag associated with the given id.
+   * Delete a tag. Delete a given image tag. You must specify, in the endpoint,
+   * the `region` and `tag_id` parameters of the tag you want to delete.
    *
    * @param request - The request {@link DeleteTagRequest}
    * @returns A Promise of Tag
@@ -19071,6 +19236,7 @@ const unmarshalSecret = data => {
     createdAt: unmarshalDate(data.created_at),
     description: data.description,
     id: data.id,
+    isManaged: data.is_managed,
     name: data.name,
     projectId: data.project_id,
     region: data.region,
@@ -19087,6 +19253,7 @@ const unmarshalSecretVersion = data => {
   return {
     createdAt: unmarshalDate(data.created_at),
     description: data.description,
+    isLatest: data.is_latest,
     revision: data.revision,
     secretId: data.secret_id,
     status: data.status,
@@ -19099,6 +19266,7 @@ const unmarshalAccessSecretVersionResponse = data => {
   }
   return {
     data: data.data,
+    dataCrc32: data.data_crc32,
     revision: data.revision,
     secretId: data.secret_id
   };
@@ -19128,6 +19296,9 @@ const marshalPasswordGenerationParams = (request, defaults) => ({
   no_lowercase_letters: request.noLowercaseLetters,
   no_uppercase_letters: request.noUppercaseLetters
 });
+const marshalAddSecretOwnerRequest = (request, defaults) => ({
+  product_name: request.productName
+});
 const marshalCreateSecretRequest = (request, defaults) => ({
   description: request.description,
   name: request.name,
@@ -19136,6 +19307,7 @@ const marshalCreateSecretRequest = (request, defaults) => ({
 });
 const marshalCreateSecretVersionRequest = (request, defaults) => ({
   data: request.data,
+  data_crc32: request.dataCrc32,
   description: request.description,
   disable_previous: request.disablePrevious,
   ...resolveOneOf([{
@@ -19158,10 +19330,10 @@ const jsonContentHeaders$5 = {
 };
 
 /**
- * Secret Manager API documentation.
+ * Secret Manager API.
  *
- * This API allows you to conveniently store, access and share sensitive data.
- * Secret Manager API documentation.
+ * Secret Manager API. This API allows you to conveniently store, access and
+ * share sensitive data.
  */
 let API$5 = class API extends API$q {
   /** Lists the available regions of the API. */
@@ -19221,7 +19393,7 @@ let API$5 = class API extends API$q {
   pageOfListSecrets = (request = {}) => this.client.fetch({
     method: 'GET',
     path: `/secret-manager/v1alpha1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/secrets`,
-    urlParams: urlParams(['name', request.name], ['order_by', request.orderBy ?? 'name_asc'], ['organization_id', request.organizationId], ['page', request.page], ['page_size', request.pageSize ?? this.client.settings.defaultPageSize], ['project_id', request.projectId], ['tags', request.tags])
+    urlParams: urlParams(['is_managed', request.isManaged], ['name', request.name], ['order_by', request.orderBy ?? 'name_asc'], ['organization_id', request.organizationId], ['page', request.page], ['page_size', request.pageSize ?? this.client.settings.defaultPageSize], ['project_id', request.projectId], ['tags', request.tags])
   }, unmarshalListSecretsResponse);
 
   /**
@@ -19245,6 +19417,18 @@ let API$5 = class API extends API$q {
     path: `/secret-manager/v1alpha1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/secrets/${validatePathParam('secretId', request.secretId)}`
   });
 
+  /**
+   * Allow a product to use the secret.
+   *
+   * @param request - The request {@link AddSecretOwnerRequest}
+   */
+  addSecretOwner = request => this.client.fetch({
+    body: JSON.stringify(marshalAddSecretOwnerRequest(request, this.client.settings)),
+    headers: jsonContentHeaders$5,
+    method: 'POST',
+    path: `/secret-manager/v1alpha1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/secrets/${validatePathParam('secretId', request.secretId)}/add-owner`
+  });
+
   /**
    * Create a version. Create a version of a given secret specified by the
    * `region` and `secret_id` parameters.
@@ -19329,20 +19513,6 @@ let API$5 = class API extends API$q {
    */
   listSecretVersionsByName = request => enrichForPagination('versions', this.pageOfListSecretVersionsByName, request);
 
-  /**
-   * Delete a version. Delete a secret's version and the sensitive data
-   * contained in it. Deleting a version is permanent and cannot be undone.
-   *
-   * @param request - The request {@link DestroySecretVersionRequest}
-   * @returns A Promise of SecretVersion
-   */
-  destroySecretVersion = request => this.client.fetch({
-    body: '{}',
-    headers: jsonContentHeaders$5,
-    method: 'POST',
-    path: `/secret-manager/v1alpha1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/secrets/${validatePathParam('secretId', request.secretId)}/versions/${validatePathParam('revision', request.revision)}/destroy`
-  }, unmarshalSecretVersion);
-
   /**
    * Enable a version. Make a specific version accessible. You must specify the
    * `region`, `secret_id` and `revision` parameters.
@@ -19396,6 +19566,20 @@ let API$5 = class API extends API$q {
     method: 'GET',
     path: `/secret-manager/v1alpha1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/secrets-by-name/${validatePathParam('secretName', request.secretName)}/versions/${validatePathParam('revision', request.revision)}/access`
   }, unmarshalAccessSecretVersionResponse);
+
+  /**
+   * Delete a version. Delete a secret's version and the sensitive data
+   * contained in it. Deleting a version is permanent and cannot be undone.
+   *
+   * @param request - The request {@link DestroySecretVersionRequest}
+   * @returns A Promise of SecretVersion
+   */
+  destroySecretVersion = request => this.client.fetch({
+    body: '{}',
+    headers: jsonContentHeaders$5,
+    method: 'POST',
+    path: `/secret-manager/v1alpha1/regions/${validatePathParam('region', request.region ?? this.client.settings.defaultRegion)}/secrets/${validatePathParam('secretId', request.secretId)}/versions/${validatePathParam('revision', request.revision)}/destroy`
+  }, unmarshalSecretVersion);
 };
 
 // This file was automatically generated. DO NOT EDIT.
@@ -19785,11 +19969,7 @@ const jsonContentHeaders$3 = {
   'Content-Type': 'application/json; charset=utf-8'
 };
 
-/**
- * Transactional Email API documentation.
- *
- * Tem. Transactional Email API documentation.
- */
+/** Transactional Email API. */
 let API$3 = class API extends API$q {
   /** Lists the available regions of the API. */
   static LOCALITIES = ['fr-par'];
@@ -20019,7 +20199,10 @@ let API$2 = class API extends API$q {
   }, unmarshalListPrivateNetworksResponse);
 
   /**
-   * List private networks.
+   * List Private Networks. List existing Private Networks in a specified
+   * Availability Zone. By default, the Private Networks returned in the list
+   * are ordered by creation date in ascending order, though this can be
+   * modified via the order_by field.
    *
    * @param request - The request {@link ListPrivateNetworksRequest}
    * @returns A Promise of ListPrivateNetworksResponse
@@ -20027,7 +20210,8 @@ let API$2 = class API extends API$q {
   listPrivateNetworks = (request = {}) => enrichForPagination('privateNetworks', this.pageOfListPrivateNetworks, request);
 
   /**
-   * Create a private network.
+   * Create a Private Network. Create a new Private Network. Once created, you
+   * can attach Scaleway resources in the same Availability Zone.
    *
    * @param request - The request {@link CreatePrivateNetworkRequest}
    * @returns A Promise of PrivateNetwork
@@ -20040,7 +20224,9 @@ let API$2 = class API extends API$q {
   }, unmarshalPrivateNetwork);
 
   /**
-   * Get a private network.
+   * Get a Private Network. Retrieve information about an existing Private
+   * Network, specified by its Private Network ID. Its full details are returned
+   * in the response object.
    *
    * @param request - The request {@link GetPrivateNetworkRequest}
    * @returns A Promise of PrivateNetwork
@@ -20051,7 +20237,8 @@ let API$2 = class API extends API$q {
   }, unmarshalPrivateNetwork);
 
   /**
-   * Update private network.
+   * Update Private Network. Update parameters (such as name or tags) of an
+   * existing Private Network, specified by its Private Network ID.
    *
    * @param request - The request {@link UpdatePrivateNetworkRequest}
    * @returns A Promise of PrivateNetwork
@@ -20064,7 +20251,8 @@ let API$2 = class API extends API$q {
   }, unmarshalPrivateNetwork);
 
   /**
-   * Delete a private network.
+   * Delete a Private Network. Delete an existing Private Network. Note that you
+   * must first detach all resources from the network, in order to delete it.
    *
    * @param request - The request {@link DeletePrivateNetworkRequest}
    */