@scaleway/sdk 1.6.0 → 1.7.0

package/dist/index.d.ts

@@ -2840,37 +2840,41 @@ type ListTokensRequestOrderBy$2 = 'created_at_asc' | 'created_at_desc' | 'name_a
 type PlanName = 'unknown_name' | 'free' | 'premium' | 'custom';
 /** Cockpit. */
 interface Cockpit {
-    /** Project ID. */
+    /** ID of the Project the Cockpit belongs to. */
     projectId: string;
-    /** Created at. */
+    /** Date and time of the Cockpit's creation. */
     createdAt?: Date;
-    /** Updated at. */
+    /** Date and time of the Cockpit's last update. */
     updatedAt?: Date;
-    /** Endpoints. */
+    /** Endpoints of the Cockpit. */
     endpoints?: CockpitEndpoints;
-    /** Status. */
+    /** Status of the Cockpit. */
     status: CockpitStatus;
-    /** Managed alerts enabled. */
+    /** Specifies whether managed alerts are enabled or disabled. */
     managedAlertsEnabled: boolean;
-    /** Pricing plan. */
+    /** Pricing plan information. */
     plan?: Plan;
 }
 /** Cockpit. endpoints. */
 interface CockpitEndpoints {
+    /** URL for metrics. */
     metricsUrl: string;
+    /** URL for logs. */
     logsUrl: string;
+    /** URL for the alert manager. */
     alertmanagerUrl: string;
+    /** URL for the Grafana dashboard. */
     grafanaUrl: string;
 }
-/** Cockpit metrics. */
+/** Metrics for a given Cockpit. Cockpit metrics. */
 interface CockpitMetrics {
-    /** Timeseries array. */
+    /** Time series array. */
     timeseries: TimeSeries[];
 }
-/** Alert contact point. Contact point. */
+/** Contact point. */
 interface ContactPoint {
     /**
-     * Alert contact point configuration.
+     * Contact point configuration.
      *
      * One-of ('configuration'): at most one of 'email' could be set.
      */
@@ -2881,118 +2885,157 @@ interface ContactPointEmail {
 }
 /** Grafana user. */
 interface GrafanaUser {
+    /** ID of the Grafana user. */
     id: number;
+    /** Username of the Grafana user. */
     login: string;
+    /** Role assigned to the Grafana user. */
     role: GrafanaUserRole;
+    /** The Grafana user's password. */
     password?: string;
 }
-/** List contact points response. */
+/** Response returned when listing contact points. List contact points response. */
 interface ListContactPointsResponse {
-    /** Total count of contact points. */
+    /** Count of all contact points created. */
     totalCount: number;
-    /** Contact points array. */
+    /** Array of contact points. */
     contactPoints: ContactPoint[];
-    /** Has receivers other than default. */
+    /**
+     * Specifies whether the contact point has other receivers than the default
+     * receiver.
+     */
     hasAdditionalReceivers: boolean;
-    /** Has unmanaged contact points. */
+    /** Specifies whether there are unmanaged contact points. */
     hasAdditionalContactPoints: boolean;
 }
-/** List grafana users response. */
+/** Response returned when listing Grafana users. List grafana users response. */
 interface ListGrafanaUsersResponse {
+    /** Count of all Grafana users. */
     totalCount: number;
+    /** Information on all Grafana users. */
     grafanaUsers: GrafanaUser[];
 }
-/** List all pricing plans response. List plans response. */
+/** Response returned when listing all pricing plans. List plans response. */
 interface ListPlansResponse {
+    /** Count of all pricing plans. */
     totalCount: number;
+    /** Information on plans. */
     plans: Plan[];
 }
 /** List tokens response. */
 interface ListTokensResponse$2 {
+    /** Count of all tokens created. */
     totalCount: number;
+    /** List of all tokens created. */
     tokens: Token$2[];
 }
-/** Plan. */
+/** Pricing plan. Plan. */
 interface Plan {
-    /** Plan id. */
+    /** ID of a given pricing plan. */
     id: string;
-    /** Plan name. */
+    /** Name of a given pricing plan. */
     name: PlanName;
     /** Retention for metrics. */
     retentionMetricsInterval?: string;
     /** Retention for logs. */
     retentionLogsInterval?: string;
-    /** Ingestion price for 1million samples in cents. */
+    /** Ingestion price for 1 million samples in cents. */
     sampleIngestionPrice: number;
-    /** Ingestion price in cents for 1 Go of logs. */
+    /** Ingestion price for 1 GB of logs in cents. */
     logsIngestionPrice: number;
     /** Retention price in euros per month. */
     retentionPrice: number;
 }
-/** Select pricing plan response. Select plan response. */
+/** Response returned when selecting a pricing plan. Select plan response. */
 interface SelectPlanResponse {
 }
 /** Token. */
 interface Token$2 {
+    /** ID of the token. */
     id: string;
+    /** ID of the Project. */
     projectId: string;
+    /** Name of the token. */
     name: string;
+    /** Date and time of the token's creation. */
     createdAt?: Date;
+    /** Date and time of the token's last update. */
     updatedAt?: Date;
+    /** Token's permissions. */
     scopes?: TokenScopes;
+    /** Token's secret key. */
     secretKey?: string;
 }
 /** Token scopes. */
 interface TokenScopes {
+    /** Permission to fetch metrics. */
     queryMetrics: boolean;
+    /** Permission to write metrics. */
     writeMetrics: boolean;
+    /** Permission to setup metrics rules. */
     setupMetricsRules: boolean;
+    /** Permission to fetch logs. */
     queryLogs: boolean;
+    /** Permission to write logs. */
     writeLogs: boolean;
+    /** Permission to setup logs rules. */
     setupLogsRules: boolean;
+    /** Permission to setup alerts. */
     setupAlerts: boolean;
 }
 type ActivateCockpitRequest = {
+    /** ID of the Project the Cockpit belongs to. */
     projectId?: string;
 };
 type GetCockpitRequest = {
+    /** ID of the Project the Cockpit belongs to. */
     projectId?: string;
 };
 type GetCockpitMetricsRequest = {
-    /** Project ID. */
+    /** ID of the Project the Cockpit belongs to. */
     projectId?: string;
-    /** Start date. */
+    /** Desired time range's start date for the metrics. */
     startDate?: Date;
-    /** End date. */
+    /** Desired time range's end date for the metrics. */
     endDate?: Date;
-    /** Metric name. */
+    /** Name of the metric requested. */
     metricName?: string;
 };
 type DeactivateCockpitRequest = {
+    /** ID of the Project the Cockpit belongs to. */
     projectId?: string;
 };
 type ResetCockpitGrafanaRequest = {
+    /** ID of the Project the Cockpit belongs to. */
     projectId?: string;
 };
 type CreateTokenRequest$2 = {
+    /** ID of the Project. */
     projectId?: string;
+    /** Name of the token. */
     name?: string;
+    /** Token's permissions. */
     scopes?: TokenScopes;
 };
 type ListTokensRequest$2 = {
+    /** Page number. */
     page?: number;
+    /** Page size. */
     pageSize?: number;
     orderBy?: ListTokensRequestOrderBy$2;
+    /** ID of the Project. */
     projectId?: string;
 };
 type GetTokenRequest$2 = {
+    /** ID of the token. */
     tokenId: string;
 };
 type DeleteTokenRequest$2 = {
+    /** ID of the token. */
     tokenId: string;
 };
 type CreateContactPointRequest = {
-    /** Project ID. */
+    /** ID of the Project in which to create the contact point. */
     projectId?: string;
     /** Contact point to create. */
     contactPoint?: ContactPoint;
@@ -3002,68 +3045,87 @@ type ListContactPointsRequest = {
     page?: number;
     /** Page size. */
     pageSize?: number;
-    /** Project ID. */
+    /** ID of the Project from which to list the contact points. */
     projectId?: string;
 };
 type DeleteContactPointRequest = {
+    /** ID of the Project. */
     projectId?: string;
     /** Contact point to delete. */
     contactPoint?: ContactPoint;
 };
 type EnableManagedAlertsRequest = {
+    /** ID of the Project. */
     projectId?: string;
 };
 type DisableManagedAlertsRequest = {
+    /** ID of the Project. */
     projectId?: string;
 };
 type TriggerTestAlertRequest = {
     projectId?: string;
 };
 type CreateGrafanaUserRequest = {
+    /** ID of the Project. */
     projectId?: string;
+    /** Username of the Grafana user. */
     login: string;
+    /** Role assigned to the Grafana user. */
     role?: GrafanaUserRole;
 };
 type ListGrafanaUsersRequest = {
+    /** Page number. */
     page?: number;
+    /** Page size. */
     pageSize?: number;
     orderBy?: ListGrafanaUsersRequestOrderBy;
+    /** ID of the Project. */
     projectId?: string;
 };
 type DeleteGrafanaUserRequest = {
+    /** ID of the Grafana user. */
     grafanaUserId: number;
+    /** ID of the Project. */
     projectId?: string;
 };
 type ResetGrafanaUserPasswordRequest = {
+    /** ID of the Grafana user. */
     grafanaUserId: number;
+    /** ID of the Project. */
     projectId?: string;
 };
 type ListPlansRequest = {
+    /** Page number. */
     page?: number;
+    /** Page size. */
     pageSize?: number;
     orderBy?: ListPlansRequestOrderBy;
 };
 type SelectPlanRequest = {
+    /** ID of the Project. */
     projectId?: string;
+    /** ID of the pricing plan. */
     planId: string;
 };
 
 /**
- * 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.
  */
 declare class API$l 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
      */
     activateCockpit: (request?: Readonly<ActivateCockpitRequest>) => Promise<Cockpit>;
     /**
-     * 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
@@ -3078,30 +3140,30 @@ declare class API$l extends API$q {
      */
     waitForCockpit: (request?: Readonly<GetCockpitRequest>, options?: Readonly<WaitForOptions<Cockpit>>) => Promise<Cockpit>;
     /**
-     * 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
      */
     getCockpitMetrics: (request?: Readonly<GetCockpitMetricsRequest>) => Promise<CockpitMetrics>;
     /**
-     * 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
      */
     deactivateCockpit: (request?: Readonly<DeactivateCockpitRequest>) => Promise<Cockpit>;
     /**
-     * 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
      */
     resetCockpitGrafana: (request?: Readonly<ResetCockpitGrafanaRequest>) => Promise<Cockpit>;
     /**
-     * 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
@@ -3109,7 +3171,7 @@ declare class API$l extends API$q {
     createToken: (request?: Readonly<CreateTokenRequest$2>) => Promise<Token$2>;
     protected pageOfListTokens: (request?: Readonly<ListTokensRequest$2>) => Promise<ListTokensResponse$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
@@ -3119,20 +3181,20 @@ declare class API$l extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Token$2[], void, void>;
     };
     /**
-     * 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
      */
     getToken: (request: Readonly<GetTokenRequest$2>) => Promise<Token$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}
      */
     deleteToken: (request: Readonly<DeleteTokenRequest$2>) => Promise<void>;
     /**
-     * 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}
@@ -3141,8 +3203,8 @@ declare class API$l extends API$q {
     createContactPoint: (request?: Readonly<CreateContactPointRequest>) => Promise<ContactPoint>;
     protected pageOfListContactPoints: (request?: Readonly<ListContactPointsRequest>) => Promise<ListContactPointsResponse>;
     /**
-     * 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
@@ -3152,32 +3214,37 @@ declare class API$l extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<ContactPoint[], void, void>;
     };
     /**
-     * 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}
      */
     deleteContactPoint: (request?: Readonly<DeleteContactPointRequest>) => Promise<void>;
     /**
-     * Enable managed alerts.
+     * Enable managed alerts. Enable the sending of managed alerts for the
+     * specified Project's Cockpit.
      *
      * @param request - The request {@link EnableManagedAlertsRequest}
      */
     enableManagedAlerts: (request?: Readonly<EnableManagedAlertsRequest>) => Promise<void>;
     /**
-     * Disable managed alerts.
+     * Disable managed alerts. Disable the sending of managed alerts for the
+     * specified Project's Cockpit.
      *
      * @param request - The request {@link DisableManagedAlertsRequest}
      */
     disableManagedAlerts: (request?: Readonly<DisableManagedAlertsRequest>) => Promise<void>;
     /**
-     * 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}
      */
     triggerTestAlert: (request?: Readonly<TriggerTestAlertRequest>) => Promise<void>;
     /**
-     * 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
@@ -3185,8 +3252,8 @@ declare class API$l extends API$q {
     createGrafanaUser: (request: Readonly<CreateGrafanaUserRequest>) => Promise<GrafanaUser>;
     protected pageOfListGrafanaUsers: (request?: Readonly<ListGrafanaUsersRequest>) => Promise<ListGrafanaUsersResponse>;
     /**
-     * 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
@@ -3196,14 +3263,15 @@ declare class API$l extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<GrafanaUser[], void, void>;
     };
     /**
-     * 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}
      */
     deleteGrafanaUser: (request: Readonly<DeleteGrafanaUserRequest>) => Promise<void>;
     /**
-     * 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
@@ -3211,7 +3279,7 @@ declare class API$l extends API$q {
     resetGrafanaUserPassword: (request: Readonly<ResetGrafanaUserPasswordRequest>) => Promise<GrafanaUser>;
     protected pageOfListPlans: (request?: Readonly<ListPlansRequest>) => Promise<ListPlansResponse>;
     /**
-     * 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
@@ -3221,7 +3289,9 @@ declare class API$l extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Plan[], void, void>;
     };
     /**
-     * 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
@@ -3339,66 +3409,107 @@ type NullValue$2 = 'NULL_VALUE';
 type TokenStatus$1 = 'unknown' | 'ready' | 'deleting' | 'error' | 'creating';
 /** Container. */
 interface Container {
+    /** UUID of the container. */
     id: string;
+    /** Name of the container. */
     name: string;
+    /** UUID of the namespace the container belongs to. */
     namespaceId: string;
+    /** Status of the container. */
     status: ContainerStatus;
+    /** Environment variables of the container. */
     environmentVariables: Record<string, string>;
+    /** Minimum number of instances to scale the container to. */
     minScale: number;
+    /** Maximum number of instances to scale the container to. */
     maxScale: number;
+    /** Memory limit of the container in MB. */
     memoryLimit: number;
+    /** CPU limit of the container. */
     cpuLimit: number;
+    /** Processing time limit for the container. */
     timeout?: string;
+    /** Last error message of the container. */
     errorMessage?: string;
+    /** Privacy setting of the container. */
     privacy: ContainerPrivacy;
+    /** Description of the container. */
     description?: string;
+    /**
+     * Name of the registry image (e.g.
+     * "rg.fr-par.scw.cloud/something/image:tag").
+     */
     registryImage: string;
+    /** Number of maximum concurrent executions of the container. */
     maxConcurrency: number;
+    /** Domain name attributed to the contaioner. */
     domainName: string;
+    /** Protocol the container uses. */
     protocol: ContainerProtocol;
+    /** Port the container listens on. */
     port: number;
+    /** Secret environment variables of the container. */
     secretEnvironmentVariables: SecretHashedValue$1[];
     /**
-     * Configure how HTTP and HTTPS requests are handled. Possible values:
+     * Configuration for the handling of HTTP and HTTPS requests. Possible values:
      *
      * - Redirected: Responds to HTTP request with a 301 redirect to ask the clients
      *   to use HTTPS.
      * - Enabled: Serve both HTTP and HTTPS traffic.
      */
     httpOption: ContainerHttpOption;
+    /** Region in which the container will be deployed. */
     region: Region;
 }
 /** Cron. */
 interface Cron$1 {
+    /** UUID of the cron. */
     id: string;
+    /** UUID of the container invoked by this cron. */
     containerId: string;
+    /** UNIX cron shedule. */
     schedule: string;
+    /** Arguments to pass with the cron. */
     args?: Record<string, unknown>;
+    /** Status of the cron. */
     status: CronStatus$1;
+    /** Name of the cron. */
     name: string;
 }
 /** Domain. */
 interface Domain$3 {
+    /** UUID of the domain. */
     id: string;
+    /** Domain assigned to the container. */
     hostname: string;
+    /** UUID of the container. */
     containerId: string;
+    /** URL (TBD). */
     url: string;
+    /** Status of the domain. */
     status: DomainStatus$3;
+    /** Last error message of the domain. */
     errorMessage?: string;
 }
 /** List containers response. */
 interface ListContainersResponse {
+    /** Array of containers. */
     containers: Container[];
+    /** Total number of containers. */
     totalCount: number;
 }
 /** List crons response. */
 interface ListCronsResponse$1 {
+    /** Array of crons. */
     crons: Cron$1[];
+    /** Total number of crons. */
     totalCount: number;
 }
 /** List domains response. */
 interface ListDomainsResponse$3 {
+    /** Array of domains. */
     domains: Domain$3[];
+    /** Total number of domains. */
     totalCount: number;
 }
 /** List logs response. */
@@ -3408,7 +3519,9 @@ interface ListLogsResponse$1 {
 }
 /** List namespaces response. */
 interface ListNamespacesResponse$3 {
+    /** Array of the namespaces. */
     namespaces: Namespace$3[];
+    /** Total number of namespaces. */
     totalCount: number;
 }
 interface ListTokensResponse$1 {
@@ -3429,17 +3542,29 @@ interface Log$1 {
 }
 /** Namespace. */
 interface Namespace$3 {
+    /** UUID of the namespace. */
     id: string;
+    /** Name of the namespace. */
     name: string;
+    /** Environment variables of the namespace. */
     environmentVariables: Record<string, string>;
+    /** UUID of the Organization the namespace belongs to. */
     organizationId: string;
+    /** UUID of the Project the namespace belongs to. */
     projectId: string;
+    /** Status of the namespace. */
     status: NamespaceStatus$2;
+    /** UUID of the registry namespace. */
     registryNamespaceId: string;
+    /** Last error message of the namesace. */
     errorMessage?: string;
+    /** Registry endpoint of the namespace. */
     registryEndpoint: string;
+    /** Description of the endpoint. */
     description?: string;
+    /** Secret environment variables of the namespace. */
     secretEnvironmentVariables: SecretHashedValue$1[];
+    /** Region in which the namespace will be created. */
     region: Region;
 }
 interface Secret$2 {
@@ -3452,16 +3577,29 @@ interface SecretHashedValue$1 {
 }
 /** Token. */
 interface Token$1 {
+    /** UUID of the token. */
     id: string;
+    /** Identifier of the token. */
     token: string;
-    /** One-of ('scope'): at most one of 'containerId', 'namespaceId' could be set. */
+    /**
+     * UUID of the container the token belongs to.
+     *
+     * One-of ('scope'): at most one of 'containerId', 'namespaceId' could be set.
+     */
     containerId?: string;
-    /** One-of ('scope'): at most one of 'containerId', 'namespaceId' could be set. */
+    /**
+     * UUID of the namespace the token belongs to.
+     *
+     * One-of ('scope'): at most one of 'containerId', 'namespaceId' could be set.
+     */
     namespaceId?: string;
-    /** @deprecated */
+    /** @deprecated Public key of the token. */
     publicKey?: string;
+    /** Status of the token. */
     status: TokenStatus$1;
+    /** Description of the token. */
     description?: string;
+    /** Expiry date of the token. */
     expiresAt?: Date;
 }
 type ListNamespacesRequest$3 = {
@@ -3470,11 +3608,17 @@ type ListNamespacesRequest$3 = {
      * config.
      */
     region?: Region;
+    /** Page number. */
     page?: number;
+    /** Number of namespaces per page. */
     pageSize?: number;
+    /** Order of the namespaces. */
     orderBy?: ListNamespacesRequestOrderBy$3;
+    /** Name of the namespaces. */
     name?: string;
+    /** UUID of the Organization the namespace belongs to. */
     organizationId?: string;
+    /** UUID of the Project the namespace belongs to. */
     projectId?: string;
 };
 type GetNamespaceRequest$3 = {
@@ -3483,6 +3627,7 @@ type GetNamespaceRequest$3 = {
      * config.
      */
     region?: Region;
+    /** UUID of the namespace to get. */
     namespaceId: string;
 };
 type CreateNamespaceRequest$3 = {
@@ -3491,10 +3636,15 @@ type CreateNamespaceRequest$3 = {
      * config.
      */
     region?: Region;
+    /** Name of the namespace to create. */
     name?: string;
+    /** Environment variables of the namespace to create. */
     environmentVariables?: Record<string, string>;
+    /** UUID of the Project in which the namespace will be created. */
     projectId?: string;
+    /** Description of the namespace to create. */
     description?: string;
+    /** Secret environment variables of the namespace to create. */
     secretEnvironmentVariables?: Secret$2[];
 };
 type UpdateNamespaceRequest$3 = {
@@ -3503,9 +3653,13 @@ type UpdateNamespaceRequest$3 = {
      * config.
      */
     region?: Region;
+    /** UUID of the namespace to update. */
     namespaceId: string;
+    /** Environment variables of the namespace to update. */
     environmentVariables?: Record<string, string>;
+    /** Description of the namespace to update. */
     description?: string;
+    /** Secret environment variables of the namespace to update. */
     secretEnvironmentVariables?: Secret$2[];
 };
 type DeleteNamespaceRequest$3 = {
@@ -3514,6 +3668,7 @@ type DeleteNamespaceRequest$3 = {
      * config.
      */
     region?: Region;
+    /** UUID of the namespace to delete. */
     namespaceId: string;
 };
 type ListContainersRequest = {
@@ -3522,12 +3677,19 @@ type ListContainersRequest = {
      * config.
      */
     region?: Region;
+    /** Page number. */
     page?: number;
+    /** Number of containers per page. */
     pageSize?: number;
+    /** Order of the containers. */
     orderBy?: ListContainersRequestOrderBy;
+    /** UUID of the namespace the container belongs to. */
     namespaceId: string;
+    /** Name of the container. */
     name?: string;
+    /** UUID of the Organization the container belongs to. */
     organizationId?: string;
+    /** UUID of the Project the container belongs to. */
     projectId?: string;
 };
 type GetContainerRequest = {
@@ -3536,6 +3698,7 @@ type GetContainerRequest = {
      * config.
      */
     region?: Region;
+    /** UUID of the container to get. */
     containerId: string;
 };
 type CreateContainerRequest = {
@@ -3544,19 +3707,36 @@ type CreateContainerRequest = {
      * config.
      */
     region?: Region;
+    /** UUID of the namespace the container belongs to. */
     namespaceId: string;
-    name?: string;
+    /** Name of the container. */
+    name: string;
+    /** Environment variables of the container. */
     environmentVariables?: Record<string, string>;
+    /** Minimum number of instances to scale the container to. */
     minScale?: number;
+    /** Maximum number of instances to scale the container to. */
     maxScale?: number;
+    /** Memory limit of the container in MB. */
     memoryLimit?: number;
+    /** Processing time limit for the container. */
     timeout?: string;
+    /** Privacy setting of the container. */
     privacy?: ContainerPrivacy;
+    /** Description of the container. */
     description?: string;
+    /**
+     * Name of the registry image (e.g.
+     * "rg.fr-par.scw.cloud/something/image:tag").
+     */
     registryImage?: string;
+    /** Number of maximum concurrent executions of the container. */
     maxConcurrency?: number;
+    /** Protocol the container uses. */
     protocol?: ContainerProtocol;
+    /** Port the container listens on. */
     port?: number;
+    /** Secret environment variables of the container. */
     secretEnvironmentVariables?: Secret$2[];
     /**
      * Configure how HTTP and HTTPS requests are handled. Possible values:
@@ -3573,16 +3753,30 @@ type UpdateContainerRequest = {
      * config.
      */
     region?: Region;
+    /** UUID of the container to update. */
     containerId: string;
+    /** Environment variables of the container. */
     environmentVariables?: Record<string, string>;
+    /** Minimum number of instances to scale the container to. */
     minScale?: number;
+    /** Maximum number of instances to scale the container to. */
     maxScale?: number;
+    /** Memory limit of the container in MB. */
     memoryLimit?: number;
+    /** Processing time limit for the container. */
     timeout?: string;
+    /** Defines whether to redeploy failed containers. */
     redeploy?: boolean;
+    /** Privacy settings of the container. */
     privacy?: ContainerPrivacy;
+    /** Description of the container. */
     description?: string;
+    /**
+     * Name of the registry image (e.g.
+     * "rg.fr-par.scw.cloud/something/image:tag").
+     */
     registryImage?: string;
+    /** Number of maximum concurrent executions of the container. */
     maxConcurrency?: number;
     protocol?: ContainerProtocol;
     port?: number;
@@ -3602,6 +3796,7 @@ type DeleteContainerRequest = {
      * config.
      */
     region?: Region;
+    /** UUID of the container to delete. */
     containerId: string;
 };
 type DeployContainerRequest = {
@@ -3610,6 +3805,7 @@ type DeployContainerRequest = {
      * config.
      */
     region?: Region;
+    /** UUID of the container to deploy. */
     containerId: string;
 };
 type ListCronsRequest$1 = {
@@ -3618,9 +3814,13 @@ type ListCronsRequest$1 = {
      * config.
      */
     region?: Region;
+    /** Page number. */
     page?: number;
+    /** Number of crons per page. */
     pageSize?: number;
+    /** Order of the crons. */
     orderBy?: ListCronsRequestOrderBy$1;
+    /** UUID of the container invoked by the cron. */
     containerId: string;
 };
 type GetCronRequest$1 = {
@@ -3629,6 +3829,7 @@ type GetCronRequest$1 = {
      * config.
      */
     region?: Region;
+    /** UUID of the cron to get. */
     cronId: string;
 };
 type CreateCronRequest$1 = {
@@ -3637,9 +3838,13 @@ type CreateCronRequest$1 = {
      * config.
      */
     region?: Region;
+    /** UUID of the container to invoke by the cron. */
     containerId: string;
+    /** UNIX cron shedule. */
     schedule: string;
+    /** Arguments to pass with the cron. */
     args?: Record<string, unknown>;
+    /** Name of the cron to create. */
     name?: string;
 };
 type UpdateCronRequest$1 = {
@@ -3648,10 +3853,15 @@ type UpdateCronRequest$1 = {
      * config.
      */
     region?: Region;
+    /** UUID of the cron to update. */
     cronId: string;
+    /** UUID of the container invoked by the cron. */
     containerId?: string;
+    /** UNIX cron schedule. */
     schedule?: string;
+    /** Arguments to pass with the cron. */
     args?: Record<string, unknown>;
+    /** Name of the cron. */
     name?: string;
 };
 type DeleteCronRequest$1 = {
@@ -3660,6 +3870,7 @@ type DeleteCronRequest$1 = {
      * config.
      */
     region?: Region;
+    /** UUID of the cron to delete. */
     cronId: string;
 };
 type ListLogsRequest$1 = {
@@ -3668,9 +3879,13 @@ type ListLogsRequest$1 = {
      * config.
      */
     region?: Region;
+    /** UUID of the container. */
     containerId: string;
+    /** Page number. */
     page?: number;
+    /** Number of logs per page. */
     pageSize?: number;
+    /** Order of the logs. */
     orderBy?: ListLogsRequestOrderBy$1;
 };
 type ListDomainsRequest$2 = {
@@ -3679,9 +3894,13 @@ type ListDomainsRequest$2 = {
      * config.
      */
     region?: Region;
+    /** Page number. */
     page?: number;
+    /** Number of domains per page. */
     pageSize?: number;
+    /** Order of the domains. */
     orderBy?: ListDomainsRequestOrderBy$2;
+    /** UUID of the container the domain belongs to. */
     containerId: string;
 };
 type GetDomainRequest$2 = {
@@ -3690,6 +3909,7 @@ type GetDomainRequest$2 = {
      * config.
      */
     region?: Region;
+    /** UUID of the domain to get. */
     domainId: string;
 };
 type CreateDomainRequest$2 = {
@@ -3698,7 +3918,9 @@ type CreateDomainRequest$2 = {
      * config.
      */
     region?: Region;
+    /** Domain to assign. */
     hostname: string;
+    /** UUID of the container to assign the domain to. */
     containerId: string;
 };
 type DeleteDomainRequest$1 = {
@@ -3707,6 +3929,7 @@ type DeleteDomainRequest$1 = {
      * config.
      */
     region?: Region;
+    /** UUID of the domain to delete. */
     domainId: string;
 };
 type IssueJWTRequest$1 = {
@@ -3727,11 +3950,21 @@ type CreateTokenRequest$1 = {
      * config.
      */
     region?: Region;
-    /** One-of ('scope'): at most one of 'containerId', 'namespaceId' could be set. */
+    /**
+     * UUID of the container to create the token for.
+     *
+     * One-of ('scope'): at most one of 'containerId', 'namespaceId' could be set.
+     */
     containerId?: string;
-    /** One-of ('scope'): at most one of 'containerId', 'namespaceId' could be set. */
+    /**
+     * UUID of the namespace to create the token for.
+     *
+     * One-of ('scope'): at most one of 'containerId', 'namespaceId' could be set.
+     */
     namespaceId?: string;
+    /** Description of the token. */
     description?: string;
+    /** Expiry date of the token. */
     expiresAt?: Date;
 };
 type GetTokenRequest$1 = {
@@ -3740,6 +3973,7 @@ type GetTokenRequest$1 = {
      * config.
      */
     region?: Region;
+    /** UUID of the token to get. */
     tokenId: string;
 };
 type ListTokensRequest$1 = {
@@ -3748,10 +3982,15 @@ type ListTokensRequest$1 = {
      * config.
      */
     region?: Region;
+    /** Page number. */
     page?: number;
+    /** Number of tokens per page. */
     pageSize?: number;
+    /** Order of the tokens. */
     orderBy?: ListTokensRequestOrderBy$1;
+    /** UUID of the container the token belongs to. */
     containerId?: string;
+    /** UUID of the namespace the token belongs to. */
     namespaceId?: string;
 };
 type DeleteTokenRequest$1 = {
@@ -3760,6 +3999,7 @@ type DeleteTokenRequest$1 = {
      * config.
      */
     region?: Region;
+    /** UUID of the token to delete. */
     tokenId: string;
 };
 
@@ -3773,7 +4013,7 @@ declare class API$k extends API$q {
     static readonly LOCALITIES: Region[];
     protected pageOfListNamespaces: (request?: Readonly<ListNamespacesRequest$3>) => Promise<ListNamespacesResponse$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
@@ -3783,7 +4023,7 @@ declare class API$k extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Namespace$3[], void, void>;
     };
     /**
-     * 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
@@ -3798,15 +4038,15 @@ declare class API$k extends API$q {
      */
     waitForNamespace: (request: Readonly<GetNamespaceRequest$3>, options?: Readonly<WaitForOptions<Namespace$3>>) => Promise<Namespace$3>;
     /**
-     * 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
      */
     createNamespace: (request?: Readonly<CreateNamespaceRequest$3>) => Promise<Namespace$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
@@ -3814,7 +4054,7 @@ declare class API$k extends API$q {
     updateNamespace: (request: Readonly<UpdateNamespaceRequest$3>) => Promise<Namespace$3>;
     /**
      * 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
@@ -3822,7 +4062,7 @@ declare class API$k extends API$q {
     deleteNamespace: (request: Readonly<DeleteNamespaceRequest$3>) => Promise<Namespace$3>;
     protected pageOfListContainers: (request: Readonly<ListContainersRequest>) => Promise<ListContainersResponse>;
     /**
-     * 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
@@ -3832,7 +4072,7 @@ declare class API$k extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Container[], void, void>;
     };
     /**
-     * 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
@@ -3847,7 +4087,7 @@ declare class API$k extends API$q {
      */
     waitForContainer: (request: Readonly<GetContainerRequest>, options?: Readonly<WaitForOptions<Container>>) => Promise<Container>;
     /**
-     * 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
@@ -3855,21 +4095,21 @@ declare class API$k extends API$q {
     createContainer: (request: Readonly<CreateContainerRequest>) => Promise<Container>;
     /**
      * 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
      */
     updateContainer: (request: Readonly<UpdateContainerRequest>) => Promise<Container>;
     /**
-     * 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
      */
     deleteContainer: (request: Readonly<DeleteContainerRequest>) => Promise<Container>;
     /**
-     * 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
@@ -3887,7 +4127,7 @@ declare class API$k extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Cron$1[], void, void>;
     };
     /**
-     * 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
@@ -3909,14 +4149,14 @@ declare class API$k extends API$q {
      */
     createCron: (request: Readonly<CreateCronRequest$1>) => Promise<Cron$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
      */
     updateCron: (request: Readonly<UpdateCronRequest$1>) => Promise<Cron$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
@@ -3924,7 +4164,8 @@ declare class API$k extends API$q {
     deleteCron: (request: Readonly<DeleteCronRequest$1>) => Promise<Cron$1>;
     protected pageOfListLogs: (request: Readonly<ListLogsRequest$1>) => Promise<ListLogsResponse$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
@@ -3935,7 +4176,8 @@ declare class API$k extends API$q {
     };
     protected pageOfListDomains: (request: Readonly<ListDomainsRequest$2>) => Promise<ListDomainsResponse$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
@@ -3945,7 +4187,8 @@ declare class API$k extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Domain$3[], void, void>;
     };
     /**
-     * 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
@@ -3960,14 +4203,16 @@ declare class API$k extends API$q {
      */
     waitForDomain: (request: Readonly<GetDomainRequest$2>, options?: Readonly<WaitForOptions<Domain$3>>) => Promise<Domain$3>;
     /**
-     * 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
      */
     createDomain: (request: Readonly<CreateDomainRequest$2>) => Promise<Domain$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
@@ -3987,7 +4232,7 @@ declare class API$k extends API$q {
      */
     createToken: (request?: Readonly<CreateTokenRequest$1>) => Promise<Token$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
@@ -4003,7 +4248,8 @@ declare class API$k extends API$q {
     waitForToken: (request: Readonly<GetTokenRequest$1>, options?: Readonly<WaitForOptions<Token$1>>) => Promise<Token$1>;
     protected pageOfListTokens: (request?: Readonly<ListTokensRequest$1>) => Promise<ListTokensResponse$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
@@ -4013,7 +4259,7 @@ declare class API$k extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Token$1[], void, void>;
     };
     /**
-     * Delete a token.
+     * Delete a token. Delete a token with a specified ID.
      *
      * @param request - The request {@link DeleteTokenRequest}
      * @returns A Promise of Token
@@ -6422,20 +6668,32 @@ interface CreateTriggerRequestSqsClientConfig {
 }
 /** Cron. */
 interface Cron {
+    /** UUID of the cron. */
     id: string;
+    /** UUID of the function the cron applies to. */
     functionId: string;
+    /** Schedule of the cron. */
     schedule: string;
+    /** Arguments to pass with the cron. */
     args?: Record<string, unknown>;
+    /** Status of the cron. */
     status: CronStatus;
+    /** Name of the cron. */
     name: string;
 }
 /** Domain. */
 interface Domain$1 {
+    /** UUID of the domain. */
     id: string;
+    /** Hostname associated with the function. */
     hostname: string;
+    /** UUID of the function the domain is associated with. */
     functionId: string;
+    /** URL of the function. */
     url: string;
+    /** State of the doamin. */
     status: DomainStatus$1;
+    /** Error message if the domain is in "error" state. */
     errorMessage?: string;
 }
 interface DownloadURL {
@@ -6444,26 +6702,46 @@ interface DownloadURL {
 }
 /** Function. */
 interface Function {
+    /** UUID of the function. */
     id: string;
+    /** Name of the function. */
     name: string;
+    /** UUID of the namespace the function belongs to. */
     namespaceId: string;
+    /** Status of the function. */
     status: FunctionStatus;
+    /** Environment variables of the function. */
     environmentVariables: Record<string, string>;
+    /** Minimum number of instances to scale the function to. */
     minScale: number;
+    /** Maximum number of instances to scale the function to. */
     maxScale: number;
+    /** Runtime of the function. */
     runtime: FunctionRuntime;
+    /** Memory limit of the function in MB. */
     memoryLimit: number;
+    /** CPU limit of the function. */
     cpuLimit: number;
+    /** Request processing time limit for the function. */
     timeout?: string;
+    /** Handler to use for the function. */
     handler: string;
+    /** Error message if the function is in "error" state. */
     errorMessage?: string;
+    /** Description of the current build step. */
+    buildMessage?: string;
+    /** Privacy setting of the function. */
     privacy: FunctionPrivacy;
+    /** Description of the function. */
     description?: string;
+    /** Domain name associated with the function. */
     domainName: string;
+    /** Secret environment variables of the function. */
     secretEnvironmentVariables: SecretHashedValue[];
+    /** Region in which the function is deployed. */
     region: Region;
     /**
-     * Configure how HTTP and HTTPS requests are handled. Possible values:
+     * Configuration for handling of HTTP and HTTPS requests. Possible values:
      *
      * - Redirected: Responds to HTTP request with a 301 redirect to ask the clients
      *   to use HTTPS.
@@ -6474,32 +6752,43 @@ interface Function {
 }
 /** List crons response. */
 interface ListCronsResponse {
+    /** Array of crons. */
     crons: Cron[];
+    /** Total number of crons. */
     totalCount: number;
 }
 /** List domains response. */
 interface ListDomainsResponse$1 {
+    /** Array of domains. */
     domains: Domain$1[];
+    /** Total number of domains. */
     totalCount: number;
 }
 /** List function runtimes response. */
 interface ListFunctionRuntimesResponse {
+    /** Array of runtimes available. */
     runtimes: Runtime$1[];
+    /** Total number of runtimes. */
     totalCount: number;
 }
 /** List functions response. */
 interface ListFunctionsResponse {
+    /** Array of functions. */
     functions: Function[];
+    /** Total number of functions. */
     totalCount: number;
 }
 /** List logs response. */
 interface ListLogsResponse {
+    /** Array of logs. */
     logs: Log[];
+    /** Total number of logs. */
     totalCount: number;
 }
 /** List namespaces response. */
 interface ListNamespacesResponse$2 {
     namespaces: Namespace$2[];
+    /** Total number of namespaces. */
     totalCount: number;
 }
 interface ListTokensResponse {
@@ -6512,10 +6801,13 @@ interface ListTriggersResponse {
 }
 /** Log. */
 interface Log {
+    /** Message of the log. */
     message: string;
+    /** Timestamp of the log. */
     timestamp?: Date;
+    /** UUID of the log. */
     id: string;
-    /** Contains the severity of the log (info, debug, error, ...). */
+    /** Severity of the log (info, debug, error etc.). */
     level: string;
     /** Source of the log (core runtime or user code). */
     source: string;
@@ -6524,17 +6816,29 @@ interface Log {
 }
 /** Namespace. */
 interface Namespace$2 {
+    /** UUID of the namespace. */
     id: string;
+    /** Name of the namespace. */
     name: string;
+    /** Environment variables of the namespace. */
     environmentVariables: Record<string, string>;
+    /** UUID of the Organization the namespace belongs to. */
     organizationId: string;
+    /** UUID of the Project the namespace belongs to. */
     projectId: string;
+    /** Status of the namespace. */
     status: NamespaceStatus$1;
+    /** UUID of the registry namespace. */
     registryNamespaceId: string;
+    /** Error message if the namespace is in "error" state. */
     errorMessage?: string;
+    /** Registry endpoint of the namespace. */
     registryEndpoint: string;
+    /** Description of the namespace. */
     description?: string;
+    /** Secret environment variables of the namespace. */
     secretEnvironmentVariables: SecretHashedValue[];
+    /** Region in which the namespace is located. */
     region: Region;
 }
 interface Runtime$1 {
@@ -6559,16 +6863,29 @@ interface SecretHashedValue {
 }
 /** Token. */
 interface Token {
+    /** UUID of the token. */
     id: string;
+    /** String of the token. */
     token: string;
-    /** One-of ('scope'): at most one of 'functionId', 'namespaceId' could be set. */
+    /**
+     * UUID of the function the token is associated with.
+     *
+     * One-of ('scope'): at most one of 'functionId', 'namespaceId' could be set.
+     */
     functionId?: string;
-    /** One-of ('scope'): at most one of 'functionId', 'namespaceId' could be set. */
+    /**
+     * UUID of the namespace the token is assoicated with.
+     *
+     * One-of ('scope'): at most one of 'functionId', 'namespaceId' could be set.
+     */
     namespaceId?: string;
-    /** @deprecated */
+    /** @deprecated Public key of the token. */
     publicKey?: string;
+    /** Status of the token. */
     status: TokenStatus;
+    /** Description of the token. */
     description?: string;
+    /** Date on which the token expires. */
     expiresAt?: Date;
 }
 interface Trigger {
@@ -6616,12 +6933,14 @@ interface TriggerSqsClientConfig {
     secretKey: string;
 }
 interface UpdateTriggerRequestSqsClientConfig {
-    accessKey: string;
-    secretKey: string;
+    accessKey?: string;
+    secretKey?: string;
 }
 /** Upload url. */
 interface UploadURL {
+    /** Upload URL to upload the function to. */
     url: string;
+    /** HTTP headers. */
     headers: Record<string, string[]>;
 }
 type ListNamespacesRequest$2 = {
@@ -6630,11 +6949,17 @@ type ListNamespacesRequest$2 = {
      * config.
      */
     region?: Region;
+    /** Page number. */
     page?: number;
+    /** Number of namespaces per page. */
     pageSize?: number;
+    /** Order of the namespaces. */
     orderBy?: ListNamespacesRequestOrderBy$2;
+    /** Name of the namespace. */
     name?: string;
+    /** UUID of the Organization the namespace belongs to. */
     organizationId?: string;
+    /** UUID of the Project the namespace belongs to. */
     projectId?: string;
 };
 type GetNamespaceRequest$2 = {
@@ -6643,6 +6968,7 @@ type GetNamespaceRequest$2 = {
      * config.
      */
     region?: Region;
+    /** UUID of the namespace. */
     namespaceId: string;
 };
 type CreateNamespaceRequest$2 = {
@@ -6652,9 +6978,13 @@ type CreateNamespaceRequest$2 = {
      */
     region?: Region;
     name?: string;
+    /** Environment variables of the namespace. */
     environmentVariables?: Record<string, string>;
+    /** UUID of the project in which the namespace will be created. */
     projectId?: string;
+    /** Description of the namespace. */
     description?: string;
+    /** Secret environment variables of the namespace. */
     secretEnvironmentVariables?: Secret$1[];
 };
 type UpdateNamespaceRequest$2 = {
@@ -6663,9 +6993,13 @@ type UpdateNamespaceRequest$2 = {
      * config.
      */
     region?: Region;
+    /** UUID of the namespapce. */
     namespaceId: string;
+    /** Environment variables of the namespace. */
     environmentVariables?: Record<string, string>;
+    /** Description of the namespace. */
     description?: string;
+    /** Secret environment variables of the namespace. */
     secretEnvironmentVariables?: Secret$1[];
 };
 type DeleteNamespaceRequest$2 = {
@@ -6674,6 +7008,7 @@ type DeleteNamespaceRequest$2 = {
      * config.
      */
     region?: Region;
+    /** UUID of the namespace. */
     namespaceId: string;
 };
 type ListFunctionsRequest = {
@@ -6682,12 +7017,19 @@ type ListFunctionsRequest = {
      * config.
      */
     region?: Region;
+    /** Page number. */
     page?: number;
+    /** Number of functions per page. */
     pageSize?: number;
+    /** Order of the functions. */
     orderBy?: ListFunctionsRequestOrderBy;
+    /** UUID of the namespace the function belongs to. */
     namespaceId: string;
+    /** Name of the function. */
     name?: string;
+    /** UUID of the Organziation the function belongs to. */
     organizationId?: string;
+    /** UUID of the Project the function belongs to. */
     projectId?: string;
 };
 type GetFunctionRequest = {
@@ -6696,6 +7038,7 @@ type GetFunctionRequest = {
      * config.
      */
     region?: Region;
+    /** UUID of the function. */
     functionId: string;
 };
 type CreateFunctionRequest = {
@@ -6704,16 +7047,27 @@ type CreateFunctionRequest = {
      * config.
      */
     region?: Region;
+    /** Name of the function to create. */
     name?: string;
+    /** UUID of the namespace the function will be created in. */
     namespaceId: string;
+    /** Environment variables of the function. */
     environmentVariables?: Record<string, string>;
+    /** Minumum number of instances to scale the function to. */
     minScale?: number;
+    /** Maximum number of instances to scale the function to. */
     maxScale?: number;
+    /** Runtime to use with the function. */
     runtime?: FunctionRuntime;
+    /** Memory limit of the function in MB. */
     memoryLimit?: number;
+    /** Request processing time limit for the function. */
     timeout?: string;
+    /** Handler to use with the function. */
     handler?: string;
+    /** Privacy setting of the function. */
     privacy?: FunctionPrivacy;
+    /** Description of the function. */
     description?: string;
     secretEnvironmentVariables?: Secret$1[];
     /**
@@ -6731,17 +7085,29 @@ type UpdateFunctionRequest = {
      * config.
      */
     region?: Region;
+    /** UUID of the function to update. */
     functionId: string;
+    /** Environment variables of the function to update. */
     environmentVariables?: Record<string, string>;
+    /** Minumum number of instances to scale the function to. */
     minScale?: number;
+    /** Maximum number of instances to scale the function to. */
     maxScale?: number;
+    /** Runtime to use with the function. */
     runtime?: FunctionRuntime;
+    /** Memory limit of the function in MB. */
     memoryLimit?: number;
+    /** Processing time limit for the function. */
     timeout?: string;
+    /** Redeploy failed function. */
     redeploy?: boolean;
+    /** Handler to use with the function. */
     handler?: string;
+    /** Privacy setting of the function. */
     privacy?: FunctionPrivacy;
+    /** Description of the function. */
     description?: string;
+    /** Secret environment variables of the function. */
     secretEnvironmentVariables?: Secret$1[];
     /**
      * Configure how HTTP and HTTPS requests are handled. Possible values:
@@ -6758,6 +7124,7 @@ type DeleteFunctionRequest = {
      * config.
      */
     region?: Region;
+    /** UUID of the function to delete. */
     functionId: string;
 };
 type DeployFunctionRequest = {
@@ -6766,6 +7133,7 @@ type DeployFunctionRequest = {
      * config.
      */
     region?: Region;
+    /** UUID of the function to deploy. */
     functionId: string;
 };
 type ListFunctionRuntimesRequest = {
@@ -6781,6 +7149,7 @@ type GetFunctionUploadURLRequest = {
      * config.
      */
     region?: Region;
+    /** UUID of the function to get the upload URL for. */
     functionId: string;
     contentLength: number;
 };
@@ -6790,6 +7159,7 @@ type GetFunctionDownloadURLRequest = {
      * config.
      */
     region?: Region;
+    /** UUID of the function to get the the download URL for. */
     functionId: string;
 };
 type ListCronsRequest = {
@@ -6798,9 +7168,13 @@ type ListCronsRequest = {
      * config.
      */
     region?: Region;
+    /** Page number. */
     page?: number;
+    /** Number of crons per page. */
     pageSize?: number;
+    /** Order of the crons. */
     orderBy?: ListCronsRequestOrderBy;
+    /** UUID of the function. */
     functionId: string;
 };
 type GetCronRequest = {
@@ -6809,6 +7183,7 @@ type GetCronRequest = {
      * config.
      */
     region?: Region;
+    /** UUID of the cron to get. */
     cronId: string;
 };
 type CreateCronRequest = {
@@ -6817,9 +7192,13 @@ type CreateCronRequest = {
      * config.
      */
     region?: Region;
+    /** UUID of the function to use the cron with. */
     functionId: string;
+    /** Schedule of the cron in UNIX cron format. */
     schedule: string;
+    /** Arguments to use with the cron. */
     args?: Record<string, unknown>;
+    /** Name of the cron. */
     name?: string;
 };
 type UpdateCronRequest = {
@@ -6828,10 +7207,15 @@ type UpdateCronRequest = {
      * config.
      */
     region?: Region;
+    /** UUID of the cron to update. */
     cronId: string;
+    /** UUID of the function to use the cron with. */
     functionId?: string;
+    /** Schedule of the cron in UNIX cron format. */
     schedule?: string;
+    /** Arguments to use with the cron. */
     args?: Record<string, unknown>;
+    /** Name of the cron. */
     name?: string;
 };
 type DeleteCronRequest = {
@@ -6840,6 +7224,7 @@ type DeleteCronRequest = {
      * config.
      */
     region?: Region;
+    /** UUID of the cron to delete. */
     cronId: string;
 };
 type ListLogsRequest = {
@@ -6848,9 +7233,13 @@ type ListLogsRequest = {
      * config.
      */
     region?: Region;
+    /** UUID of the function to get the logs for. */
     functionId: string;
+    /** Page number. */
     page?: number;
+    /** Number of logs per page. */
     pageSize?: number;
+    /** Order of the logs. */
     orderBy?: ListLogsRequestOrderBy;
 };
 type ListDomainsRequest$1 = {
@@ -6859,9 +7248,13 @@ type ListDomainsRequest$1 = {
      * config.
      */
     region?: Region;
+    /** Page number. */
     page?: number;
+    /** Number of domains per page. */
     pageSize?: number;
+    /** Order of the domains. */
     orderBy?: ListDomainsRequestOrderBy;
+    /** UUID of the function the domain is assoicated with. */
     functionId: string;
 };
 type GetDomainRequest$1 = {
@@ -6870,6 +7263,7 @@ type GetDomainRequest$1 = {
      * config.
      */
     region?: Region;
+    /** UUID of the domain to get. */
     domainId: string;
 };
 type CreateDomainRequest$1 = {
@@ -6878,7 +7272,9 @@ type CreateDomainRequest$1 = {
      * config.
      */
     region?: Region;
+    /** Hostame to create. */
     hostname: string;
+    /** UUID of the function to associate the domain with. */
     functionId: string;
 };
 type DeleteDomainRequest = {
@@ -6887,6 +7283,7 @@ type DeleteDomainRequest = {
      * config.
      */
     region?: Region;
+    /** UUID of the domain to delete. */
     domainId: string;
 };
 type IssueJWTRequest = {
@@ -6907,11 +7304,21 @@ type CreateTokenRequest = {
      * config.
      */
     region?: Region;
-    /** One-of ('scope'): at most one of 'functionId', 'namespaceId' could be set. */
+    /**
+     * UUID of the function to associate the token with.
+     *
+     * One-of ('scope'): at most one of 'functionId', 'namespaceId' could be set.
+     */
     functionId?: string;
-    /** One-of ('scope'): at most one of 'functionId', 'namespaceId' could be set. */
+    /**
+     * UUID of the namespace to associate the token with.
+     *
+     * One-of ('scope'): at most one of 'functionId', 'namespaceId' could be set.
+     */
     namespaceId?: string;
+    /** Description of the token. */
     description?: string;
+    /** Date on which the token expires. */
     expiresAt?: Date;
 };
 type GetTokenRequest = {
@@ -6920,6 +7327,7 @@ type GetTokenRequest = {
      * config.
      */
     region?: Region;
+    /** UUID of the token to get. */
     tokenId: string;
 };
 type ListTokensRequest = {
@@ -6928,10 +7336,15 @@ type ListTokensRequest = {
      * config.
      */
     region?: Region;
+    /** Page number. */
     page?: number;
+    /** Number of tokens per page. */
     pageSize?: number;
+    /** Sort order for the tokens. */
     orderBy?: ListTokensRequestOrderBy;
+    /** UUID of the function the token is assoicated with. */
     functionId?: string;
+    /** UUID of the namespace the token is associated with. */
     namespaceId?: string;
 };
 type DeleteTokenRequest = {
@@ -6940,6 +7353,7 @@ type DeleteTokenRequest = {
      * config.
      */
     region?: Region;
+    /** UUID of the token to delete. */
     tokenId: string;
 };
 type CreateTriggerRequest = {
@@ -6949,7 +7363,7 @@ type CreateTriggerRequest = {
      */
     region?: Region;
     name: string;
-    description: string;
+    description?: string;
     functionId: string;
     /**
      * One-of ('config'): at most one of 'scwSqsConfig', 'sqsConfig',
@@ -7031,7 +7445,8 @@ declare class API$h extends API$q {
     static readonly LOCALITIES: Region[];
     protected pageOfListNamespaces: (request?: Readonly<ListNamespacesRequest$2>) => Promise<ListNamespacesResponse$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
@@ -7041,7 +7456,7 @@ declare class API$h extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Namespace$2[], void, void>;
     };
     /**
-     * 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
@@ -7056,15 +7471,16 @@ declare class API$h extends API$q {
      */
     waitForNamespace: (request: Readonly<GetNamespaceRequest$2>, options?: Readonly<WaitForOptions<Namespace$2>>) => Promise<Namespace$2>;
     /**
-     * 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
      */
     createNamespace: (request?: Readonly<CreateNamespaceRequest$2>) => Promise<Namespace$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
@@ -7072,7 +7488,7 @@ declare class API$h extends API$q {
     updateNamespace: (request: Readonly<UpdateNamespaceRequest$2>) => Promise<Namespace$2>;
     /**
      * 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
@@ -7090,7 +7506,7 @@ declare class API$h extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Function[], void, void>;
     };
     /**
-     * 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
@@ -7105,29 +7521,30 @@ declare class API$h extends API$q {
      */
     waitForFunction: (request: Readonly<GetFunctionRequest>, options?: Readonly<WaitForOptions<Function>>) => Promise<Function>;
     /**
-     * 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
      */
     createFunction: (request: Readonly<CreateFunctionRequest>) => Promise<Function>;
     /**
-     * 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
      */
     updateFunction: (request: Readonly<UpdateFunctionRequest>) => Promise<Function>;
     /**
-     * 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
      */
     deleteFunction: (request: Readonly<DeleteFunctionRequest>) => Promise<Function>;
     /**
-     * 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
@@ -7142,7 +7559,7 @@ declare class API$h extends API$q {
     listFunctionRuntimes: (request?: Readonly<ListFunctionRuntimesRequest>) => Promise<ListFunctionRuntimesResponse>;
     /**
      * 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
@@ -7150,7 +7567,7 @@ declare class API$h extends API$q {
     getFunctionUploadURL: (request: Readonly<GetFunctionUploadURLRequest>) => Promise<UploadURL>;
     /**
      * 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
@@ -7158,7 +7575,7 @@ declare class API$h extends API$q {
     getFunctionDownloadURL: (request: Readonly<GetFunctionDownloadURLRequest>) => Promise<DownloadURL>;
     protected pageOfListCrons: (request: Readonly<ListCronsRequest>) => Promise<ListCronsResponse>;
     /**
-     * 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
@@ -7168,7 +7585,7 @@ declare class API$h extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Cron[], void, void>;
     };
     /**
-     * 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
@@ -7183,21 +7600,22 @@ declare class API$h extends API$q {
      */
     waitForCron: (request: Readonly<GetCronRequest>, options?: Readonly<WaitForOptions<Cron>>) => Promise<Cron>;
     /**
-     * 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
      */
     createCron: (request: Readonly<CreateCronRequest>) => Promise<Cron>;
     /**
-     * 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
      */
     updateCron: (request: Readonly<UpdateCronRequest>) => Promise<Cron>;
     /**
-     * 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
@@ -7205,7 +7623,8 @@ declare class API$h extends API$q {
     deleteCron: (request: Readonly<DeleteCronRequest>) => Promise<Cron>;
     protected pageOfListLogs: (request: Readonly<ListLogsRequest>) => Promise<ListLogsResponse>;
     /**
-     * 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
@@ -7216,7 +7635,8 @@ declare class API$h extends API$q {
     };
     protected pageOfListDomains: (request: Readonly<ListDomainsRequest$1>) => Promise<ListDomainsResponse$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
@@ -7226,7 +7646,8 @@ declare class API$h extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Domain$1[], void, void>;
     };
     /**
-     * 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
@@ -7241,14 +7662,16 @@ declare class API$h extends API$q {
      */
     waitForDomain: (request: Readonly<GetDomainRequest$1>, options?: Readonly<WaitForOptions<Domain$1>>) => Promise<Domain$1>;
     /**
-     * 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
      */
     createDomain: (request: Readonly<CreateDomainRequest$1>) => Promise<Domain$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
@@ -7842,10 +8265,12 @@ interface User$1 {
     lastLoginAt?: Date;
     /** Type of user. */
     type: UserType;
-    /** Whether MFA is enabled. */
-    twoFactorEnabled: boolean;
+    /** @deprecated Deprecated, use "mfa" instead. */
+    twoFactorEnabled?: boolean;
     /** Status of user invitation. */
     status: UserStatus;
+    /** Whether MFA is enabled. */
+    mfa: boolean;
 }
 type ListSSHKeysRequest$1 = {
     /** Sort order of the SSH keys. */
@@ -7899,6 +8324,8 @@ type ListUsersRequest$2 = {
     organizationId?: string;
     /** Filter by list of IDs. */
     userIds?: string[];
+    /** Filter by MFA status. */
+    mfa?: boolean;
 };
 type GetUserRequest = {
     /** ID of the user to find. */
@@ -8338,8 +8765,7 @@ declare class API$g 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
@@ -19167,7 +19593,8 @@ type GetCategoryRequest = {
 declare class API$a extends API$q {
     protected pageOfListImages: (request: Readonly<ListImagesRequest$1>) => Promise<ListImagesResponse$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
@@ -19177,21 +19604,40 @@ declare class API$a extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Image$1[], void, void>;
     };
     /**
-     * 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
      */
     getImage: (request: Readonly<GetImageRequest$1>) => Promise<Image$1>;
     protected pageOfListVersions: (request: Readonly<ListVersionsRequest>) => Promise<ListVersionsResponse>;
+    /**
+     * 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: Readonly<ListVersionsRequest>) => Promise<ListVersionsResponse> & {
         all: () => Promise<Version[]>;
         [Symbol.asyncIterator]: () => AsyncGenerator<Version[], void, void>;
     };
+    /**
+     * 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: Readonly<GetVersionRequest>) => Promise<Version>;
     protected pageOfListLocalImages: (request?: Readonly<ListLocalImagesRequest>) => Promise<ListLocalImagesResponse>;
     /**
-     * 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
@@ -19200,12 +19646,35 @@ declare class API$a extends API$q {
         all: () => Promise<LocalImage[]>;
         [Symbol.asyncIterator]: () => AsyncGenerator<LocalImage[], void, void>;
     };
+    /**
+     * 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: Readonly<GetLocalImageRequest>) => Promise<LocalImage>;
     protected pageOfListCategories: (request?: Readonly<ListCategoriesRequest>) => Promise<ListCategoriesResponse>;
+    /**
+     * 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?: Readonly<ListCategoriesRequest>) => Promise<ListCategoriesResponse> & {
         all: () => Promise<Category[]>;
         [Symbol.asyncIterator]: () => AsyncGenerator<Category[], void, void>;
     };
+    /**
+     * 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: Readonly<GetCategoryRequest>) => Promise<Category>;
 }
 
@@ -19260,23 +19729,25 @@ type ListNamespacesRequestOrderBy$1 = 'created_at_asc' | 'created_at_desc' | 'up
 type NamespaceProtocol = 'unknown' | 'nats' | 'sqs_sns';
 /** Credential. */
 interface Credential {
-    /** Credential ID. */
+    /** ID of the credentials. */
     id: string;
-    /** Credential name. */
+    /** Name of the credentials. */
     name: string;
-    /** Namespace containing the Credential. */
+    /** Namespace containing the credentials. */
     namespaceId: string;
-    /** Protocol associated to the Credential. */
+    /** Protocol associated with the credentials. */
     protocol: NamespaceProtocol;
     /**
-     * Credentials file used to connect to the NATS service.
+     * Object containing the credentials, if the credentials are for a NATS
+     * namespace.
      *
      * One-of ('credentialType'): at most one of 'natsCredentials',
      * 'sqsSnsCredentials' could be set.
      */
     natsCredentials?: CredentialNATSCredsFile;
     /**
-     * Credential used to connect to the SQS/SNS service.
+     * Object containing the credentials and their metadata, if the credentials
+     * are for an SQS/SNS namespace.
      *
      * One-of ('credentialType'): at most one of 'natsCredentials',
      * 'sqsSnsCredentials' could be set.
@@ -19290,25 +19761,26 @@ interface CredentialNATSCredsFile {
 }
 /** Credential.sqssns creds. */
 interface CredentialSQSSNSCreds {
-    /** ID of the key. */
+    /** Access key ID. */
     accessKey: string;
-    /** Secret value of the key. */
+    /** Secret key ID. */
     secretKey?: string;
-    /** List of permissions associated to this Credential. */
+    /** Permissions associated with these credentials. */
     permissions?: Permissions;
 }
 /** Credential summary. */
 interface CredentialSummary {
-    /** Credential ID. */
+    /** ID of the credentials. */
     id: string;
-    /** Credential name. */
+    /** Name of the credentials. */
     name: string;
-    /** Namespace containing the Credential. */
+    /** Namespace containing the credentials. */
     namespaceId: string;
-    /** Protocol associated to the Credential. */
+    /** Protocol associated with the credentials. */
     protocol: NamespaceProtocol;
     /**
-     * Credential used to connect to the SQS/SNS service.
+     * Object containing the credentials and their metadata, if the credentials
+     * are for an SQS/SNS namespace.
      *
      * One-of ('credentialType'): at most one of 'sqsSnsCredentials' could be set.
      */
@@ -19316,23 +19788,23 @@ interface CredentialSummary {
 }
 /** Credential summary.sqssns creds. */
 interface CredentialSummarySQSSNSCreds {
-    /** ID of the key. */
+    /** Access key ID. */
     accessKey: string;
-    /** List of permissions associated to this Credential. */
+    /** Permissions associated with these credentials. */
     permissions?: Permissions;
 }
 /** List credentials response. */
 interface ListCredentialsResponse {
-    /** Total number of existing Credentials. */
+    /** Total count of existing credentials (matching any filters specified). */
     totalCount: number;
-    /** A page of Credentials. */
+    /** Credentials on this page. */
     credentials: CredentialSummary[];
 }
 /** List namespaces response. */
 interface ListNamespacesResponse$1 {
-    /** Total number of existing Namespaces. */
+    /** Total count of existing namespaces (matching any filters specified). */
     totalCount: number;
-    /** A page of Namespaces. */
+    /** Namespaces on this page. */
     namespaces: Namespace$1[];
 }
 /** Namespace. */
@@ -19341,13 +19813,13 @@ interface Namespace$1 {
     id: string;
     /** Namespace name. */
     name: string;
-    /** Endpoint of the service matching the Namespace protocol. */
+    /** Endpoint of the service matching the namespace's protocol. */
     endpoint: string;
     /** Namespace protocol. */
     protocol: NamespaceProtocol;
-    /** Project containing the Namespace. */
+    /** Project ID of the Project containing the namespace. */
     projectId: string;
-    /** Region where the Namespace is deployed. */
+    /** Region where the namespace is deployed. */
     region: Region;
     /** Namespace creation date. */
     createdAt?: Date;
@@ -19356,11 +19828,20 @@ interface Namespace$1 {
 }
 /** Permissions. */
 interface Permissions {
-    /** Defines if user can publish messages to the service. */
+    /**
+     * Defines whether the credentials bearer can publish messages to the service
+     * (send messages to SQS queues or publish to SNS topics).
+     */
     canPublish?: boolean;
-    /** Defines if user can receive messages from the service. */
+    /**
+     * Defines whether the credentials bearer can receive messages from the
+     * service.
+     */
     canReceive?: boolean;
-    /** Defines if user can manage the associated resource(s). */
+    /**
+     * Defines whether the credentials bearer can manage the associated resources
+     * (SQS queues or SNS topics or subscriptions).
+     */
     canManage?: boolean;
 }
 type ListNamespacesRequest$1 = {
@@ -19369,15 +19850,15 @@ type ListNamespacesRequest$1 = {
      * config.
      */
     region?: Region;
-    /** Will list only the Namespaces owned by the specified organization. */
+    /** Include only namespaces in this Organization. */
     organizationId?: string;
-    /** Will list only the Namespaces contained into the specified project. */
+    /** Include only namespaces in this Project. */
     projectId?: string;
-    /** Indicate the page number of results to be returned. */
+    /** Page number to return. */
     page?: number;
-    /** Maximum number of results returned by page. */
+    /** Maximum number of namespaces to return per page. */
     pageSize?: number;
-    /** Field used for sorting results. */
+    /** Order in which to return results. */
     orderBy?: ListNamespacesRequestOrderBy$1;
 };
 type CreateNamespaceRequest$1 = {
@@ -19388,7 +19869,10 @@ type CreateNamespaceRequest$1 = {
     region?: Region;
     /** Namespace name. */
     name?: string;
-    /** Namespace protocol. */
+    /**
+     * Namespace protocol. You must specify a valid protocol (and not `unknown`)
+     * to avoid an error.
+     */
     protocol: NamespaceProtocol;
     /** Project containing the Namespace. */
     projectId?: string;
@@ -19419,7 +19903,7 @@ type DeleteNamespaceRequest$1 = {
      * config.
      */
     region?: Region;
-    /** ID of the Namespace to delete. */
+    /** ID of the namespace to delete. */
     namespaceId: string;
 };
 type CreateCredentialRequest = {
@@ -19428,12 +19912,12 @@ type CreateCredentialRequest = {
      * config.
      */
     region?: Region;
-    /** Namespace containing the Credential. */
+    /** Namespace containing the credentials. */
     namespaceId: string;
-    /** Credential name. */
+    /** Name of the credentials. */
     name?: string;
     /**
-     * List of permissions associated to this Credential.
+     * Permissions associated with these credentials.
      *
      * One-of ('optionalPermissions'): at most one of 'permissions' could be set.
      */
@@ -19445,7 +19929,7 @@ type DeleteCredentialRequest = {
      * config.
      */
     region?: Region;
-    /** ID of the Credential to delete. */
+    /** ID of the credentials to delete. */
     credentialId: string;
 };
 type ListCredentialsRequest = {
@@ -19454,13 +19938,13 @@ type ListCredentialsRequest = {
      * config.
      */
     region?: Region;
-    /** Namespace containing the Credential. */
+    /** Namespace containing the credentials. */
     namespaceId?: string;
-    /** Indicate the page number of results to be returned. */
+    /** Page number to return. */
     page?: number;
-    /** Maximum number of results returned by page. */
+    /** Maximum number of credentials to return per page. */
     pageSize?: number;
-    /** Field used for sorting results. */
+    /** Order in which to return results. */
     orderBy?: ListCredentialsRequestOrderBy;
 };
 type UpdateCredentialRequest = {
@@ -19469,12 +19953,12 @@ type UpdateCredentialRequest = {
      * config.
      */
     region?: Region;
-    /** ID of the Credential to update. */
+    /** ID of the credentials to update. */
     credentialId: string;
-    /** Credential name. */
+    /** Name of the credentials. */
     name?: string;
     /**
-     * List of permissions associated to this Credential.
+     * Permissions associated with these credentials.
      *
      * One-of ('optionalPermissions'): at most one of 'permissions' could be set.
      */
@@ -19486,21 +19970,25 @@ type GetCredentialRequest = {
      * config.
      */
     region?: Region;
-    /** ID of the Credential to get. */
+    /** ID of the credentials to get. */
     credentialId: string;
 };
 
 /**
  * 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).
  */
 declare class API$9 extends API$q {
     /** Lists the available regions of the API. */
     static readonly LOCALITIES: Region[];
     protected pageOfListNamespaces: (request?: Readonly<ListNamespacesRequest$1>) => Promise<ListNamespacesResponse$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
@@ -19510,49 +19998,63 @@ declare class API$9 extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Namespace$1[], void, void>;
     };
     /**
-     * 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
      */
     createNamespace: (request: Readonly<CreateNamespaceRequest$1>) => Promise<Namespace$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
      */
     updateNamespace: (request: Readonly<UpdateNamespaceRequest$1>) => Promise<Namespace$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
      */
     getNamespace: (request: Readonly<GetNamespaceRequest$1>) => Promise<Namespace$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}
      */
     deleteNamespace: (request: Readonly<DeleteNamespaceRequest$1>) => Promise<void>;
     /**
-     * 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
      */
     createCredential: (request: Readonly<CreateCredentialRequest>) => Promise<Credential>;
     /**
-     * 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}
      */
     deleteCredential: (request: Readonly<DeleteCredentialRequest>) => Promise<void>;
     protected pageOfListCredentials: (request?: Readonly<ListCredentialsRequest>) => Promise<ListCredentialsResponse>;
     /**
-     * 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
@@ -19562,14 +20064,19 @@ declare class API$9 extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<CredentialSummary[], void, void>;
     };
     /**
-     * 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
      */
     updateCredential: (request: Readonly<UpdateCredentialRequest>) => Promise<Credential>;
     /**
-     * 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
@@ -23258,20 +23765,25 @@ interface AccessSecretVersionResponse {
     revision: number;
     /** The base64-encoded secret payload of the version. */
     data: string;
+    /**
+     * The CRC32 checksum of the data as a base-10 integer. This field is present
+     * only if a CRC32 was supplied during the creation of the version.
+     */
+    dataCrc32?: number;
 }
 /** List secret versions response. */
 interface ListSecretVersionsResponse {
-    /** Number of versions. */
-    totalCount: number;
     /** Single page of versions. */
     versions: SecretVersion[];
+    /** Number of versions. */
+    totalCount: number;
 }
 /** List secrets response. */
 interface ListSecretsResponse {
-    /** Count of all secrets matching the requested criteria. */
-    totalCount: number;
     /** Single page of secrets matching the requested criteria. */
     secrets: Secret[];
+    /** Count of all secrets matching the requested criteria. */
+    totalCount: number;
 }
 /** Password generation params. */
 interface PasswordGenerationParams {
@@ -23305,22 +23817,24 @@ interface Secret {
     updatedAt?: Date;
     /** List of the secret's tags. */
     tags: string[];
-    /** Region of the secret. */
-    region: Region;
     /** Number of versions for this secret. */
     versionCount: number;
     /** Updated description of the secret. */
     description?: string;
+    /** True for secrets that are managed by another product. */
+    isManaged: boolean;
+    /** Region of the secret. */
+    region: Region;
 }
 /** Secret version. */
 interface SecretVersion {
-    /** ID of the secret. */
-    secretId: string;
     /**
      * Version number. The first version of the secret is numbered 1, and all
      * subsequent revisions augment by 1.
      */
     revision: number;
+    /** ID of the secret. */
+    secretId: string;
     /**
      * Current status of the version. `unknown`: the version is in an invalid
      * state. `enabled`: the version is accessible. `disabled`: the version is not
@@ -23334,6 +23848,8 @@ interface SecretVersion {
     updatedAt?: Date;
     /** Description of the version. */
     description?: string;
+    /** True if the version is the latest one. */
+    isLatest: boolean;
 }
 type CreateSecretRequest = {
     /**
@@ -23393,13 +23909,15 @@ type ListSecretsRequest = {
     organizationId?: string;
     /** Filter by Project ID (optional). */
     projectId?: string;
-    /** Filter by secret name (optional). */
-    name?: string;
-    /** List of tags to filter on (optional). */
-    tags?: string[];
     orderBy?: ListSecretsRequestOrderBy;
     page?: number;
     pageSize?: number;
+    /** List of tags to filter on (optional). */
+    tags?: string[];
+    /** Filter by secret name (optional). */
+    name?: string;
+    /** Filter by managed / not managed (optional). */
+    isManaged?: boolean;
 };
 type DeleteSecretRequest = {
     /**
@@ -23410,6 +23928,17 @@ type DeleteSecretRequest = {
     /** ID of the secret. */
     secretId: string;
 };
+type AddSecretOwnerRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** ID of the secret. */
+    secretId: string;
+    /** Name of the product to add. */
+    productName: string;
+};
 type CreateSecretVersionRequest = {
     /**
      * Region to target. If none is passed will use default region from the
@@ -23423,20 +23952,28 @@ type CreateSecretVersionRequest = {
     /** Description of the version. */
     description?: string;
     /**
-     * Disable the previous secret version. If there is no previous version or if
-     * the previous version was already disabled, does nothing.
+     * Disable the previous secret version. Optional. If there is no previous
+     * version or if the previous version was already disabled, does nothing.
      */
-    disablePrevious: boolean;
+    disablePrevious?: boolean;
     /**
-     * Options to generate a password. If specified, a random password will be
-     * generated. The data field must be empty. By default, the generator will use
-     * upper and lower case letters, and digits. This behavior can be tuned using
-     * the generation params.
+     * Options to generate a password. Optional. If specified, a random password
+     * will be generated. The data and data_crc32 fields must be empty. By
+     * default, the generator will use upper and lower case letters, and digits.
+     * This behavior can be tuned using the generation parameters.
      *
      * One-of ('PasswordGeneration'): at most one of 'passwordGeneration' could be
      * set.
      */
     passwordGeneration?: PasswordGenerationParams;
+    /**
+     * The CRC32 checksum of the data as a base-10 integer. Optional. If
+     * specified, the Secret Manager will verify the integrity of the data
+     * received against the given CRC32. An error is returned if the CRC32 does
+     * not match. Otherwise, the CRC32 will be stored and returned along with the
+     * SecretVersion on futur accesses.
+     */
+    dataCrc32?: number;
 };
 type GetSecretVersionRequest = {
     /**
@@ -23508,7 +24045,7 @@ type ListSecretVersionsByNameRequest = {
     /** Filter results by status. */
     status?: SecretVersionStatus[];
 };
-type DestroySecretVersionRequest = {
+type EnableSecretVersionRequest = {
     /**
      * Region to target. If none is passed will use default region from the
      * config.
@@ -23522,7 +24059,7 @@ type DestroySecretVersionRequest = {
      */
     revision: string;
 };
-type EnableSecretVersionRequest = {
+type DisableSecretVersionRequest = {
     /**
      * Region to target. If none is passed will use default region from the
      * config.
@@ -23536,7 +24073,7 @@ type EnableSecretVersionRequest = {
      */
     revision: string;
 };
-type DisableSecretVersionRequest = {
+type AccessSecretVersionRequest = {
     /**
      * Region to target. If none is passed will use default region from the
      * config.
@@ -23550,28 +24087,28 @@ type DisableSecretVersionRequest = {
      */
     revision: string;
 };
-type AccessSecretVersionRequest = {
+type AccessSecretVersionByNameRequest = {
     /**
      * Region to target. If none is passed will use default region from the
      * config.
      */
     region?: Region;
-    /** ID of the secret. */
-    secretId: string;
+    /** Name of the secret. */
+    secretName: string;
     /**
      * Version number. The first version of the secret is numbered 1, and all
      * subsequent revisions augment by 1. Value can be a number or "latest".
      */
     revision: string;
 };
-type AccessSecretVersionByNameRequest = {
+type DestroySecretVersionRequest = {
     /**
      * Region to target. If none is passed will use default region from the
      * config.
      */
     region?: Region;
-    /** Name of the secret. */
-    secretName: string;
+    /** ID of the secret. */
+    secretId: string;
     /**
      * Version number. The first version of the secret is numbered 1, and all
      * subsequent revisions augment by 1. Value can be a number or "latest".
@@ -23640,6 +24177,12 @@ declare class API$5 extends API$q {
      * @param request - The request {@link DeleteSecretRequest}
      */
     deleteSecret: (request: Readonly<DeleteSecretRequest>) => Promise<void>;
+    /**
+     * Allow a product to use the secret.
+     *
+     * @param request - The request {@link AddSecretOwnerRequest}
+     */
+    addSecretOwner: (request: Readonly<AddSecretOwnerRequest>) => Promise<void>;
     /**
      * Create a version. Create a version of a given secret specified by the
      * `region` and `secret_id` parameters.
@@ -23700,14 +24243,6 @@ declare class API$5 extends API$q {
         all: () => Promise<SecretVersion[]>;
         [Symbol.asyncIterator]: () => AsyncGenerator<SecretVersion[], void, void>;
     };
-    /**
-     * 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: Readonly<DestroySecretVersionRequest>) => Promise<SecretVersion>;
     /**
      * Enable a version. Make a specific version accessible. You must specify the
      * `region`, `secret_id` and `revision` parameters.
@@ -23742,11 +24277,20 @@ declare class API$5 extends API$q {
      * @returns A Promise of AccessSecretVersionResponse
      */
     accessSecretVersionByName: (request: Readonly<AccessSecretVersionByNameRequest>) => Promise<AccessSecretVersionResponse>;
+    /**
+     * 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: Readonly<DestroySecretVersionRequest>) => Promise<SecretVersion>;
 }
 
 type index_gen$5_AccessSecretVersionByNameRequest = AccessSecretVersionByNameRequest;
 type index_gen$5_AccessSecretVersionRequest = AccessSecretVersionRequest;
 type index_gen$5_AccessSecretVersionResponse = AccessSecretVersionResponse;
+type index_gen$5_AddSecretOwnerRequest = AddSecretOwnerRequest;
 type index_gen$5_CreateSecretRequest = CreateSecretRequest;
 type index_gen$5_CreateSecretVersionRequest = CreateSecretVersionRequest;
 type index_gen$5_DeleteSecretRequest = DeleteSecretRequest;
@@ -23776,6 +24320,7 @@ declare namespace index_gen$5 {
     index_gen$5_AccessSecretVersionByNameRequest as AccessSecretVersionByNameRequest,
     index_gen$5_AccessSecretVersionRequest as AccessSecretVersionRequest,
     index_gen$5_AccessSecretVersionResponse as AccessSecretVersionResponse,
+    index_gen$5_AddSecretOwnerRequest as AddSecretOwnerRequest,
     index_gen$5_CreateSecretRequest as CreateSecretRequest,
     index_gen$5_CreateSecretVersionRequest as CreateSecretVersionRequest,
     index_gen$5_DeleteSecretRequest as DeleteSecretRequest,
@@ -24521,81 +25066,96 @@ interface ListPrivateNetworksResponse {
 }
 /** Private network. */
 interface PrivateNetwork {
-    /** The private network ID. */
+    /** Private Network ID. */
     id: string;
-    /** The private network name. */
+    /** Private Network name. */
     name: string;
-    /** The private network organization. */
+    /** Scaleway Organization the Private Network belongs to. */
     organizationId: string;
-    /** The private network project ID. */
+    /** Scaleway Project the Private Network belongs to. */
     projectId: string;
-    /** The zone in which the private network is available. */
+    /** Availability Zone in which the Private Network is available. */
     zone: Zone;
-    /** The private network tags. */
+    /** Tags of the Private Network. */
     tags: string[];
-    /** The private network creation date. */
+    /** Date the Private Network was created. */
     createdAt?: Date;
-    /** The last private network modification date. */
+    /** Date the Private Network was last modified. */
     updatedAt?: Date;
-    /** Private network subnets CIDR. */
+    /** Private Network subnets CIDR. */
     subnets: string[];
 }
 type ListPrivateNetworksRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
     zone?: Zone;
-    /** The sort order of the returned private networks. */
+    /** Sort order of the returned Private Networks. */
     orderBy?: ListPrivateNetworksRequestOrderBy;
-    /** The page number for the returned private networks. */
+    /** Page number to return, from the paginated results. */
     page?: number;
-    /** The maximum number of private networks per page. */
+    /** Maximum number of Private Networks to return per page. */
     pageSize?: number;
-    /** Filter private networks with names containing this string. */
+    /**
+     * Name to filter for. Only Private Networks with names containing this string
+     * will be returned.
+     */
     name?: string;
-    /** Filter private networks with one or more matching tags. */
+    /**
+     * Tags to filter for. Only Private Networks with one or more matching tags
+     * will be returned.
+     */
     tags?: string[];
-    /** The organization ID on which to filter the returned private networks. */
+    /**
+     * Organization ID to filter for. Only Private Networks belonging to this
+     * Organization will be returned.
+     */
     organizationId?: string;
-    /** The project ID on which to filter the returned private networks. */
+    /**
+     * Project ID to filter for. Only Private Networks belonging to this Project
+     * will be returned.
+     */
     projectId?: string;
-    /** The PrivateNetwork IDs on which to filter the returned private networks. */
+    /**
+     * Private Network IDs to filter for. Only Private Networks with one of these
+     * IDs will be returned.
+     */
     privateNetworkIds?: string[];
-    /** Include regional Private Networks. */
+    /** Defines whether to include regional Private Networks in the response. */
     includeRegional?: boolean;
 };
 type CreatePrivateNetworkRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
     zone?: Zone;
-    /** The name of the private network. */
+    /** Name for the Private Network. */
     name?: string;
-    /** The project ID of the private network. */
+    /** Scaleway Project in which to create the Private Network. */
     projectId?: string;
-    /** The private networks tags. */
+    /** Tags for the Private Network. */
     tags?: string[];
-    /** Private network subnets CIDR. */
+    /** Private Network subnets CIDR. */
     subnets?: string[];
 };
 type GetPrivateNetworkRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
     zone?: Zone;
-    /** The private network id. */
+    /** Private Network ID. */
     privateNetworkId: string;
 };
 type UpdatePrivateNetworkRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
     zone?: Zone;
-    /** The private network ID. */
+    /** Private Network ID. */
     privateNetworkId: string;
-    /** The name of the private network. */
+    /** Name of the private network. */
     name?: string;
-    /** The private networks tags. */
+    /** Tags for the Private Network. */
     tags?: string[];
-    /** @deprecated Private network subnets CIDR (deprecated). */
+    /** @deprecated Private Network subnets CIDR (deprecated). */
     subnets?: string[];
 };
 type DeletePrivateNetworkRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
     zone?: Zone;
-    /** The private network ID. */
+    /** Private Network ID. */
     privateNetworkId: string;
 };
 
@@ -24605,7 +25165,10 @@ declare class API$2 extends API$q {
     static readonly LOCALITIES: Zone[];
     protected pageOfListPrivateNetworks: (request?: Readonly<ListPrivateNetworksRequest>) => Promise<ListPrivateNetworksResponse>;
     /**
-     * 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
@@ -24615,28 +25178,33 @@ declare class API$2 extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<PrivateNetwork[], void, void>;
     };
     /**
-     * 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
      */
     createPrivateNetwork: (request?: Readonly<CreatePrivateNetworkRequest>) => Promise<PrivateNetwork>;
     /**
-     * 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
      */
     getPrivateNetwork: (request: Readonly<GetPrivateNetworkRequest>) => Promise<PrivateNetwork>;
     /**
-     * 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
      */
     updatePrivateNetwork: (request: Readonly<UpdatePrivateNetworkRequest>) => Promise<PrivateNetwork>;
     /**
-     * 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}
      */