@scaleway/sdk 1.6.0 → 1.7.0

package/dist/index.cjs

@@ -426,7 +426,7 @@ const assertValidSettings = obj => {
   }
 };
 
-const version = 'v1.5.0';
+const version = 'v1.6.0';
 const userAgent = `scaleway-sdk-js/${version}`;
 
 const isBrowser = () => typeof window !== 'undefined' && typeof window.document !== 'undefined';
@@ -3638,14 +3638,16 @@ const jsonContentHeaders$j = {
 };
 
 /**
- * Cockpit API.
+ * Cockpit API documentation.
  *
- * This API allows to manage Cockpits. Cockpit API.
+ * Cockpit's API allows you to monitor your applications and their
+ * infrastructure. 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
@@ -4130,7 +4140,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',
@@ -4215,7 +4225,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 +4233,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 +4253,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 +4266,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 +4281,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 +4297,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 +4305,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 +4325,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 +4339,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 +4352,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 +4363,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 +4389,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 +4422,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 +4435,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 +4451,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 +4465,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 +4474,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 +4495,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 +4509,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 +4551,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 +4576,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 +4585,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
@@ -6944,6 +6960,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 +7292,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 +7301,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 +7321,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 +7335,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 +7350,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 +7374,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 +7394,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 +7408,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 +7422,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 +7433,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 +7458,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 +7471,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 +7487,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 +7495,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 +7515,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 +7529,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 +7542,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 +7558,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 +7572,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 +7581,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 +7602,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 +7616,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 +7911,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 +8212,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 +8230,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
@@ -16128,7 +16154,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 +16163,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 +16178,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 +16216,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 +16244,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)}`
@@ -16340,7 +16414,8 @@ const jsonContentHeaders$9 = {
 /**
  * MnQ API (beta).
  *
- * This API allows you to manage Messaging or Queueing brokers. MnQ API (beta).
+ * This API allows you to manage Scaleway Messaging and Queueing brokers. MnQ
+ * API (beta).
  */
 let API$9 = class API extends API$q {
   /** Lists the available regions of the API. */
@@ -16352,7 +16427,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 +16438,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 +16452,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 +16466,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 +16479,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 +16492,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 +16509,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 +16526,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 +16536,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 +16552,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
@@ -19071,6 +19168,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 +19185,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 +19198,7 @@ const unmarshalAccessSecretVersionResponse = data => {
   }
   return {
     data: data.data,
+    dataCrc32: data.data_crc32,
     revision: data.revision,
     secretId: data.secret_id
   };
@@ -19128,6 +19228,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 +19239,7 @@ const marshalCreateSecretRequest = (request, defaults) => ({
 });
 const marshalCreateSecretVersionRequest = (request, defaults) => ({
   data: request.data,
+  data_crc32: request.dataCrc32,
   description: request.description,
   disable_previous: request.disablePrevious,
   ...resolveOneOf([{
@@ -19221,7 +19325,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 +19349,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 +19445,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 +19498,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.
@@ -20019,7 +20135,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 +20146,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 +20160,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 +20173,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 +20187,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}
    */