@scaleway/sdk 1.7.0 → 1.8.0

package/dist/index.d.ts

@@ -1238,7 +1238,7 @@ type ReinstallServerRequest = {
 };
 
 /**
- * Apple silicon.
+ * Apple silicon API.
  *
  * Apple Mac mini as a service. Scaleway Apple silicon as-a-Service is built
  * using the latest generation of Apple Mac mini hardware (fifth generation).
@@ -1271,7 +1271,8 @@ declare class API$o extends API$q {
      */
     listServerTypes: (request?: Readonly<ListServerTypesRequest>) => Promise<ListServerTypesResponse>;
     /**
-     * Get a server type. Get a server technical details.
+     * Get a server type. Get technical details (CPU, disk size etc.) of a server
+     * type.
      *
      * @param request - The request {@link GetServerTypeRequest}
      * @returns A Promise of ServerType
@@ -1300,7 +1301,7 @@ declare class API$o extends API$q {
     };
     protected pageOfListOS: (request?: Readonly<ListOSRequest$2>) => Promise<ListOSResponse$1>;
     /**
-     * List all Operating System (OS). List all Operating System (OS). The
+     * List all Operating Systems (OS). List all Operating Systems (OS). The
      * response will include the total number of OS as well as their associated
      * IDs, names and labels.
      *
@@ -1817,7 +1818,7 @@ interface Setting {
     id: string;
     /** Type of the setting. */
     type: SettingType;
-    /** ID of the project ID. */
+    /** ID of the Project ID. */
     projectId: string;
     /** Defines whether the setting is enabled. */
     enabled: boolean;
@@ -2055,7 +2056,7 @@ type ListSettingsRequest$1 = {
     pageSize?: number;
     /** Sort order for items in the response. */
     orderBy?: ListSettingsRequestOrderBy;
-    /** ID of the project. */
+    /** ID of the Project. */
     projectId?: string;
 };
 type UpdateSettingRequest = {
@@ -2135,8 +2136,8 @@ declare class API$n extends API$q {
     static readonly LOCALITIES: Zone[];
     protected pageOfListServers: (request?: Readonly<ListServersRequest$2>) => Promise<ListServersResponse$1>;
     /**
-     * List Elastic Metal servers for an organization. List Elastic Metal servers
-     * for a specific organization.
+     * List Elastic Metal servers for an Organization. List Elastic Metal servers
+     * for a specific Organization.
      *
      * @param request - The request {@link ListServersRequest}
      * @returns A Promise of ListServersResponse
@@ -2333,7 +2334,7 @@ declare class API$n extends API$q {
     };
     protected pageOfListSettings: (request?: Readonly<ListSettingsRequest$1>) => Promise<ListSettingsResponse>;
     /**
-     * List all settings. Return all settings for a project ID.
+     * List all settings. Return all settings for a Project ID.
      *
      * @param request - The request {@link ListSettingsRequest}
      * @returns A Promise of ListSettingsResponse
@@ -2343,7 +2344,7 @@ declare class API$n extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Setting[], void, void>;
     };
     /**
-     * Update setting. Update a setting for a project ID (enable or disable).
+     * Update setting. Update a setting for a Project ID (enable or disable).
      *
      * @param request - The request {@link UpdateSettingRequest}
      * @returns A Promise of Setting
@@ -2362,7 +2363,7 @@ declare class API$n extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<OS[], void, void>;
     };
     /**
-     * Get an OS with an ID. Return specific OS for the ID.
+     * Get OS with an ID. Return the specific OS for the ID.
      *
      * @param request - The request {@link GetOSRequest}
      * @returns A Promise of OS
@@ -3109,10 +3110,9 @@ type SelectPlanRequest = {
 };
 
 /**
- * Cockpit API documentation.
+ * 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
+ * Cockpit API. Cockpit's API allows you to activate your Cockpit on your
  * Projects. Scaleway's Cockpit stores metrics and logs and provides a dedicated
  * Grafana for dashboarding to visualize them.
  */
@@ -3425,7 +3425,7 @@ interface Container {
     maxScale: number;
     /** Memory limit of the container in MB. */
     memoryLimit: number;
-    /** CPU limit of the container. */
+    /** CPU limit of the container in mvCPU. */
     cpuLimit: number;
     /** Processing time limit for the container. */
     timeout?: string;
@@ -3719,6 +3719,8 @@ type CreateContainerRequest = {
     maxScale?: number;
     /** Memory limit of the container in MB. */
     memoryLimit?: number;
+    /** CPU limit of the container in mvCPU. */
+    cpuLimit?: number;
     /** Processing time limit for the container. */
     timeout?: string;
     /** Privacy setting of the container. */
@@ -3763,6 +3765,8 @@ type UpdateContainerRequest = {
     maxScale?: number;
     /** Memory limit of the container in MB. */
     memoryLimit?: number;
+    /** CPU limit of the container in mvCPU. */
+    cpuLimit?: number;
     /** Processing time limit for the container. */
     timeout?: string;
     /** Defines whether to redeploy failed containers. */
@@ -4003,11 +4007,7 @@ type DeleteTokenRequest$1 = {
     tokenId: string;
 };
 
-/**
- * Containers API.
- *
- * Serverless Containers API. Containers API.
- */
+/** Serverless Containers API. */
 declare class API$k extends API$q {
     /** Lists the available regions of the API. */
     static readonly LOCALITIES: Region[];
@@ -4719,33 +4719,33 @@ interface ListContactsResponse {
 }
 /** List dns zone nameservers response. */
 interface ListDNSZoneNameserversResponse {
-    /** The returned DNS zone nameservers. */
+    /** DNS zone name servers returned. */
     ns: Nameserver$1[];
 }
 /** List dns zone records response. */
 interface ListDNSZoneRecordsResponse {
-    /** The total number of DNS zone records. */
+    /** Total number of DNS zone records. */
     totalCount: number;
-    /** The paginated returned DNS zone records. */
+    /** Paginated returned DNS zone records. */
     records: DomainRecord[];
 }
 /** List dns zone version records response. */
 interface ListDNSZoneVersionRecordsResponse {
-    /** The total number of DNS zones versions records. */
+    /** Total number of DNS zones versions records. */
     totalCount: number;
     records: DomainRecord[];
 }
 /** List dns zone versions response. */
 interface ListDNSZoneVersionsResponse {
-    /** The total number of DNS zones versions. */
+    /** Total number of DNS zones versions. */
     totalCount: number;
     versions: DNSZoneVersion[];
 }
 /** List dns zones response. */
 interface ListDNSZonesResponse {
-    /** The total number of DNS zones. */
+    /** Total number of DNS zones matching the requested criteria. */
     totalCount: number;
-    /** The paginated returned DNS zones. */
+    /** Paginated returned DNS zones. */
     dnsZones: DNSZone[];
 }
 /** List domain hosts response. */
@@ -4858,7 +4858,7 @@ interface RecordIdentifier {
 }
 /** Refresh dns zone response. */
 interface RefreshDNSZoneResponse {
-    /** The returned DNS zones. */
+    /** DNS zones returned. */
     dnsZones: DNSZone[];
 }
 interface RegisterExternalDomainResponse {
@@ -4932,122 +4932,119 @@ interface UpdateContactRequestQuestion {
 }
 /** Update dns zone nameservers response. */
 interface UpdateDNSZoneNameserversResponse {
-    /** The returned DNS zone nameservers. */
+    /** DNS zone name servers returned. */
     ns: Nameserver$1[];
 }
 /** Update dns zone records response. */
 interface UpdateDNSZoneRecordsResponse {
-    /** The returned DNS zone records. */
+    /** DNS zone records returned. */
     records: DomainRecord[];
 }
 type ListDNSZonesRequest = {
-    /** The organization ID on which to filter the returned DNS zones. */
+    /** Organization ID on which to filter the returned DNS zones. */
     organizationId?: string;
-    /** The project ID on which to filter the returned DNS zones. */
+    /** Project ID on which to filter the returned DNS zones. */
     projectId?: string;
-    /** The sort order of the returned DNS zones. */
+    /** Sort order of the returned DNS zones. */
     orderBy?: ListDNSZonesRequestOrderBy;
-    /** The page number for the returned DNS zones. */
+    /** Page number to return, from the paginated results. */
     page?: number;
-    /** The maximum number of DNS zones per page. */
+    /** Maximum number of DNS zones to return per page. */
     pageSize?: number;
-    /** The domain on which to filter the returned DNS zones. */
+    /** Domain on which to filter the returned DNS zones. */
     domain: string;
-    /** The DNS zone on which to filter the returned DNS zones. */
+    /** DNS zone on which to filter the returned DNS zones. */
     dnsZone: string;
 };
 type CreateDNSZoneRequest = {
-    /** The domain of the DNS zone to create. */
+    /** Domain in which to crreate the DNS zone. */
     domain: string;
-    /** The subdomain of the DNS zone to create. */
+    /** Subdomain of the DNS zone to create. */
     subdomain: string;
-    /** The project ID where the DNS zone will be created. */
+    /** Project ID in which to create the DNS zone. */
     projectId?: string;
 };
 type UpdateDNSZoneRequest = {
-    /** The DNS zone to update. */
+    /** DNS zone to update. */
     dnsZone: string;
-    /** The new DNS zone. */
+    /** Name of the new DNS zone to create. */
     newDnsZone: string;
-    /** The project ID of the new DNS zone. */
+    /** Project ID in which to create the new DNS zone. */
     projectId?: string;
 };
 type CloneDNSZoneRequest = {
-    /** The DNS zone to clone. */
+    /** DNS zone to clone. */
     dnsZone: string;
-    /** The destinaton DNS zone. */
+    /** Destination DNS zone in which to clone the chosen DNS zone. */
     destDnsZone: string;
-    /** Whether or not the destination DNS zone will be overwritten. */
+    /** Specifies whether or not the destination DNS zone will be overwritten. */
     overwrite: boolean;
-    /** The project ID of the destination DNS zone. */
+    /** Project ID of the destination DNS zone. */
     projectId?: string;
 };
 type DeleteDNSZoneRequest = {
-    /** The DNS zone to delete. */
+    /** DNS zone to delete. */
     dnsZone: string;
-    /** The project ID of the DNS zone to delete. */
+    /** Project ID of the DNS zone to delete. */
     projectId?: string;
 };
 type ListDNSZoneRecordsRequest = {
-    /** The DNS zone on which to filter the returned DNS zone records. */
+    /** DNS zone on which to filter the returned DNS zone records. */
     dnsZone: string;
-    /** The project ID on which to filter the returned DNS zone records. */
+    /** Project ID on which to filter the returned DNS zone records. */
     projectId?: string;
-    /** The sort order of the returned DNS zone records. */
+    /** Sort order of the returned DNS zone records. */
     orderBy?: ListDNSZoneRecordsRequestOrderBy;
-    /** The page number for the returned DNS zone records. */
+    /** Page number to return, from the paginated results. */
     page?: number;
-    /** The maximum number of DNS zone records per page. */
+    /** Maximum number of DNS zone records per page. */
     pageSize?: number;
-    /** The name on which to filter the returned DNS zone records. */
+    /** Name on which to filter the returned DNS zone records. */
     name: string;
-    /** The record type on which to filter the returned DNS zone records. */
+    /** Record type on which to filter the returned DNS zone records. */
     type?: DomainRecordType;
-    /** The record ID on which to filter the returned DNS zone records. */
+    /** Record ID on which to filter the returned DNS zone records. */
     id?: string;
 };
 type UpdateDNSZoneRecordsRequest = {
-    /** The DNS zone where the DNS zone records will be updated. */
+    /** DNS zone in which to update the DNS zone records. */
     dnsZone: string;
-    /** The changes made to the records. */
+    /** Changes made to the records. */
     changes: RecordChange[];
-    /** Whether or not to return all the records. */
+    /** Specifies whether or not to return all the records. */
     returnAllRecords?: boolean;
     /**
-     * Forbid the creation of the target zone if not existing (default action is
-     * yes).
+     * Disable the creation of the target zone if it does not exist. Target zone
+     * creation is disabled by default.
      */
     disallowNewZoneCreation: boolean;
-    /**
-     * Don't use the autoincremenent serial but the provided one (0 to keep the
-     * same).
-     */
+    /** Use the provided serial (0) instead of the auto-increment serial. */
     serial?: number;
 };
 type ListDNSZoneNameserversRequest = {
-    /** The DNS zone on which to filter the returned DNS zone nameservers. */
+    /** DNS zone on which to filter the returned DNS zone name servers. */
     dnsZone: string;
-    /** The project ID on which to filter the returned DNS zone nameservers. */
+    /** Project ID on which to filter the returned DNS zone name servers. */
     projectId?: string;
 };
 type UpdateDNSZoneNameserversRequest = {
-    /** The DNS zone where the DNS zone nameservers will be updated. */
+    /** DNS zone in which to update the DNS zone name servers. */
     dnsZone: string;
-    /** The new DNS zone nameservers. */
+    /** New DNS zone name servers. */
     ns: Nameserver$1[];
 };
 type ClearDNSZoneRecordsRequest = {
-    /** The DNS zone to clear. */
+    /** DNS zone to clear. */
     dnsZone: string;
 };
 type ExportRawDNSZoneRequest = {
-    /** The DNS zone to export. */
+    /** DNS zone to export. */
     dnsZone: string;
-    /** Format for DNS zone. */
+    /** DNS zone format. */
     format?: RawFormat;
 };
 type ImportRawDNSZoneRequest = {
-    /** The DNS zone to import. */
+    /** DNS zone to import. */
     dnsZone: string;
     /** @deprecated */
     content?: string;
@@ -5061,7 +5058,7 @@ type ImportRawDNSZoneRequest = {
      */
     bindSource?: ImportRawDNSZoneRequestBindSource;
     /**
-     * Import from the nameserver given with tsig use or not.
+     * Import from the name server given with TSIG, to use or not.
      *
      * One-of ('source'): at most one of 'bindSource', 'axfrSource' could be set.
      */
@@ -5073,25 +5070,25 @@ type ImportProviderDNSZoneRequest = {
     onlineV1?: ImportProviderDNSZoneRequestOnlineV1;
 };
 type RefreshDNSZoneRequest = {
-    /** The DNS zone to refresh. */
+    /** DNS zone to refresh. */
     dnsZone: string;
-    /** Whether or not to recreate the DNS zone. */
+    /** Specifies whether or not to recreate the DNS zone. */
     recreateDnsZone: boolean;
-    /** Whether or not to recreate the sub DNS zone. */
+    /** Specifies whether or not to recreate the sub DNS zone. */
     recreateSubDnsZone: boolean;
 };
 type ListDNSZoneVersionsRequest = {
     dnsZone: string;
-    /** The page number for the returned DNS zones versions. */
+    /** Page number to return, from the paginated results. */
     page?: number;
-    /** The maximum number of DNS zones versions per page. */
+    /** Maximum number of DNS zones versions per page. */
     pageSize?: number;
 };
 type ListDNSZoneVersionRecordsRequest = {
     dnsZoneVersionId: string;
-    /** The page number for the returned DNS zones versions records. */
+    /** Page number to return, from the paginated results. */
     page?: number;
-    /** The maximum number of DNS zones versions records per page. */
+    /** Maximum number of DNS zones versions records per page. */
     pageSize?: number;
 };
 type GetDNSZoneVersionDiffRequest = {
@@ -5399,15 +5396,16 @@ type RegistrarApiDeleteDomainHostRequest = {
 };
 
 /**
- * DNS API.
+ * Domains and DNS API.
  *
- * DNS API. Manage your DNS zones and records.
+ * Domains and DNS API. Manage your domains, DNS zones and records with the
+ * Domains and DNS API.
  */
 declare class API$j extends API$q {
     protected pageOfListDNSZones: (request: Readonly<ListDNSZonesRequest>) => Promise<ListDNSZonesResponse>;
     /**
-     * List DNS zones. Returns a list of manageable DNS zones. You can filter the
-     * DNS zones by domain name.
+     * List DNS zones. Retrieve the list of DNS zones you can manage and filter
+     * DNS zones associated with specific domain names.
      *
      * @param request - The request {@link ListDNSZonesRequest}
      * @returns A Promise of ListDNSZonesResponse
@@ -5417,29 +5415,30 @@ declare class API$j extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<DNSZone[], void, void>;
     };
     /**
-     * Create a DNS zone. Create a new DNS zone.
+     * Create a DNS zone. Create a new DNS zone specified by the domain name, the
+     * subdomain and the Project ID.
      *
      * @param request - The request {@link CreateDNSZoneRequest}
      * @returns A Promise of DNSZone
      */
     createDNSZone: (request: Readonly<CreateDNSZoneRequest>) => Promise<DNSZone>;
     /**
-     * Update a DNS zone. Update the name and/or the organizations for a DNS zone.
+     * Update a DNS zone. Update the name and/or the Organizations for a DNS zone.
      *
      * @param request - The request {@link UpdateDNSZoneRequest}
      * @returns A Promise of DNSZone
      */
     updateDNSZone: (request: Readonly<UpdateDNSZoneRequest>) => Promise<DNSZone>;
     /**
-     * Clone a DNS zone. Clone an existed DNS zone with all its records into a new
-     * one.
+     * Clone a DNS zone. Clone an existing DNS zone with all its records into a
+     * new DNS zone.
      *
      * @param request - The request {@link CloneDNSZoneRequest}
      * @returns A Promise of DNSZone
      */
     cloneDNSZone: (request: Readonly<CloneDNSZoneRequest>) => Promise<DNSZone>;
     /**
-     * Delete DNS zone. Delete a DNS zone and all it's records.
+     * Delete a DNS zone. Delete a DNS zone and all its records.
      *
      * @param request - The request {@link DeleteDNSZoneRequest}
      * @returns A Promise of DeleteDNSZoneResponse
@@ -5447,8 +5446,9 @@ declare class API$j extends API$q {
     deleteDNSZone: (request: Readonly<DeleteDNSZoneRequest>) => Promise<DeleteDNSZoneResponse>;
     protected pageOfListDNSZoneRecords: (request: Readonly<ListDNSZoneRecordsRequest>) => Promise<ListDNSZoneRecordsResponse>;
     /**
-     * List DNS zone records. Returns a list of DNS records of a DNS zone with
-     * default NS. You can filter the records by type and name.
+     * List records within a DNS zone. Retrieve a list of DNS records within a DNS
+     * zone that has default name servers. You can filter records by type and
+     * name.
      *
      * @param request - The request {@link ListDNSZoneRecordsRequest}
      * @returns A Promise of ListDNSZoneRecordsResponse
@@ -5458,22 +5458,18 @@ declare class API$j extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<DomainRecord[], void, void>;
     };
     /**
-     * Update DNS zone records. Only available with default NS.<br/> Send a list
-     * of actions and records.
+     * Update records within a DNS zone. Update records within a DNS zone that has
+     * default name servers and perform several actions on your records.
      *
-     * Action can be:
+     * Actions include:
      *
-     * - Add:
-     * - Add new record
-     * - Can be more specific and add a new IP to an existing A record for example
-     * - Set:
-     * - Edit a record
-     * - Can be more specific and edit an IP from an existing A record for example
-     * - Delete:
-     * - Delete a record
-     * - Can be more specific and delete an IP from an existing A record for example
-     * - Clear:
-     * - Delete all records from a DNS zone
+     * - Add: allows you to add a new record or add a new IP to an existing A
+     *   record, for example
+     * - Set: allows you to edit a record or edit an IP from an existing A record,
+     *   for example
+     * - Delete: allows you to delete a record or delete an IP from an existing A
+     *   record, for example
+     * - Clear: allows you to delete all records from a DNS zone
      *
      * All edits will be versioned.
      *
@@ -5482,55 +5478,57 @@ declare class API$j extends API$q {
      */
     updateDNSZoneRecords: (request: Readonly<UpdateDNSZoneRecordsRequest>) => Promise<UpdateDNSZoneRecordsResponse>;
     /**
-     * List DNS zone nameservers. Returns a list of Nameservers and their optional
-     * glue records for a DNS zone.
+     * List name servers within a DNS zone. Retrieve a list of name servers within
+     * a DNS zone and their optional glue records.
      *
      * @param request - The request {@link ListDNSZoneNameserversRequest}
      * @returns A Promise of ListDNSZoneNameserversResponse
      */
     listDNSZoneNameservers: (request: Readonly<ListDNSZoneNameserversRequest>) => Promise<ListDNSZoneNameserversResponse>;
     /**
-     * Update DNS zone nameservers. Update DNS zone nameservers and set optional
-     * glue records.
+     * Update name servers within a DNS zone. Update name servers within a DNS
+     * zone and set optional glue records.
      *
      * @param request - The request {@link UpdateDNSZoneNameserversRequest}
      * @returns A Promise of UpdateDNSZoneNameserversResponse
      */
     updateDNSZoneNameservers: (request: Readonly<UpdateDNSZoneNameserversRequest>) => Promise<UpdateDNSZoneNameserversResponse>;
     /**
-     * Clear DNS zone records. Only available with default NS.<br/> Delete all the
-     * records from a DNS zone. All edits will be versioned.
+     * Clear records within a DNS zone. Delete all records within a DNS zone that
+     * has default name servers.<br/> All edits will be versioned.
      *
      * @param request - The request {@link ClearDNSZoneRecordsRequest}
      * @returns A Promise of ClearDNSZoneRecordsResponse
      */
     clearDNSZoneRecords: (request: Readonly<ClearDNSZoneRecordsRequest>) => Promise<ClearDNSZoneRecordsResponse>;
     /**
-     * Export raw DNS zone. Get a DNS zone in a given format with default NS.
+     * Export a raw DNS zone. Export a DNS zone with default name servers, in a
+     * specific format.
      *
      * @param request - The request {@link ExportRawDNSZoneRequest}
      * @returns A Promise of Blob
      */
     exportRawDNSZone: (request: Readonly<ExportRawDNSZoneRequest>) => Promise<Blob>;
     /**
-     * Import raw DNS zone. Import and replace records from a given provider
-     * format with default NS.
+     * Import a raw DNS zone. Import and replace the format of records from a
+     * given provider, with default name servers.
      *
      * @param request - The request {@link ImportRawDNSZoneRequest}
      * @returns A Promise of ImportRawDNSZoneResponse
      */
     importRawDNSZone: (request: Readonly<ImportRawDNSZoneRequest>) => Promise<ImportRawDNSZoneResponse>;
     /**
-     * Import provider DNS zone. Import and replace records from a given provider
-     * format with default NS.
+     * Import a DNS zone from another provider. Import and replace the format of
+     * records from a given provider, with default name servers.
      *
      * @param request - The request {@link ImportProviderDNSZoneRequest}
      * @returns A Promise of ImportProviderDNSZoneResponse
      */
     importProviderDNSZone: (request: Readonly<ImportProviderDNSZoneRequest>) => Promise<ImportProviderDNSZoneResponse>;
     /**
-     * Refresh DNS zone. Refresh SOA DNS zone. You can recreate the given DNS zone
-     * and its sub DNS zone if needed.
+     * Refresh a DNS zone. Refresh an SOA DNS zone to reload the records in the
+     * DNS zone and update the SOA serial. You can recreate the given DNS zone and
+     * its sub DNS zone if needed.
      *
      * @param request - The request {@link RefreshDNSZoneRequest}
      * @returns A Promise of RefreshDNSZoneResponse
@@ -5538,9 +5536,9 @@ declare class API$j extends API$q {
     refreshDNSZone: (request: Readonly<RefreshDNSZoneRequest>) => Promise<RefreshDNSZoneResponse>;
     protected pageOfListDNSZoneVersions: (request: Readonly<ListDNSZoneVersionsRequest>) => Promise<ListDNSZoneVersionsResponse>;
     /**
-     * List DNS zone versions. Get a list of DNS zone versions.<br/> The maximum
-     * version count is 100.<br/> If the count reaches this limit, the oldest
-     * version will be deleted after each new modification.
+     * List versions of a DNS zone. Retrieve a list of a DNS zone's versions.<br/>
+     * The maximum version count is 100. If the count reaches this limit, the
+     * oldest version will be deleted after each new modification.
      *
      * @param request - The request {@link ListDNSZoneVersionsRequest}
      * @returns A Promise of ListDNSZoneVersionsResponse
@@ -5551,8 +5549,8 @@ declare class API$j extends API$q {
     };
     protected pageOfListDNSZoneVersionRecords: (request: Readonly<ListDNSZoneVersionRecordsRequest>) => Promise<ListDNSZoneVersionRecordsResponse>;
     /**
-     * List DNS zone version records. Get a list of records from a previous DNS
-     * zone version.
+     * List records from a given version of a specific DNS zone. Retrieve a list
+     * of records from a specific DNS zone version.
      *
      * @param request - The request {@link ListDNSZoneVersionRecordsRequest}
      * @returns A Promise of ListDNSZoneVersionRecordsResponse
@@ -5562,22 +5560,24 @@ declare class API$j extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<DomainRecord[], void, void>;
     };
     /**
-     * Get DNS zone version diff. Get all differences from a previous DNS zone
-     * version.
+     * Access differences from a specific DNS zone version. Access a previous DNS
+     * zone version to see the differences from another specific version.
      *
      * @param request - The request {@link GetDNSZoneVersionDiffRequest}
      * @returns A Promise of GetDNSZoneVersionDiffResponse
      */
     getDNSZoneVersionDiff: (request: Readonly<GetDNSZoneVersionDiffRequest>) => Promise<GetDNSZoneVersionDiffResponse>;
     /**
-     * Restore DNS zone version. Restore and activate a previous DNS zone version.
+     * Restore a DNS zone version. Restore and activate a version of a specific
+     * DNS zone.
      *
      * @param request - The request {@link RestoreDNSZoneVersionRequest}
      * @returns A Promise of RestoreDNSZoneVersionResponse
      */
     restoreDNSZoneVersion: (request: Readonly<RestoreDNSZoneVersionRequest>) => Promise<RestoreDNSZoneVersionResponse>;
     /**
-     * Get the zone TLS certificate if it exists.
+     * Get a DNS zone's TLS certificate. Get the DNS zone's TLS certificate. If
+     * you do not have a certificate, the ouptut returns `no certificate found`.
      *
      * @param request - The request {@link GetSSLCertificateRequest}
      * @returns A Promise of SSLCertificate
@@ -5592,7 +5592,8 @@ declare class API$j extends API$q {
      */
     waitForSSLCertificate: (request: Readonly<GetSSLCertificateRequest>, options?: Readonly<WaitForOptions<SSLCertificate>>) => Promise<SSLCertificate>;
     /**
-     * Create or return the zone TLS certificate.
+     * Create or get the DNS zone's TLS certificate. Create a new TLS certificate
+     * or retrieve information about an existing TLS certificate.
      *
      * @param request - The request {@link CreateSSLCertificateRequest}
      * @returns A Promise of SSLCertificate
@@ -5600,7 +5601,8 @@ declare class API$j extends API$q {
     createSSLCertificate: (request: Readonly<CreateSSLCertificateRequest>) => Promise<SSLCertificate>;
     protected pageOfListSSLCertificates: (request: Readonly<ListSSLCertificatesRequest>) => Promise<ListSSLCertificatesResponse>;
     /**
-     * List all user TLS certificates.
+     * List a user's TLS certificates. List all the TLS certificates a user has
+     * created, specified by the user's Project ID and the DNS zone.
      *
      * @param request - The request {@link ListSSLCertificatesRequest}
      * @returns A Promise of ListSSLCertificatesResponse
@@ -5610,21 +5612,25 @@ declare class API$j extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<SSLCertificate[], void, void>;
     };
     /**
-     * Delete an TLS certificate.
+     * Delete a TLS certificate. Delete an existing TLS certificate specified by
+     * its DNS zone. Deleting a TLS certificate is permanent and cannot be
+     * undone.
      *
      * @param request - The request {@link DeleteSSLCertificateRequest}
      * @returns A Promise of DeleteSSLCertificateResponse
      */
     deleteSSLCertificate: (request: Readonly<DeleteSSLCertificateRequest>) => Promise<DeleteSSLCertificateResponse>;
     /**
-     * Get the DNS zone TSIG Key. Get the DNS zone TSIG Key to allow AXFR request.
+     * Get the DNS zone's TSIG key. Retrieve information about the TSIG key of a
+     * given DNS zone to allow AXFR requests.
      *
      * @param request - The request {@link GetDNSZoneTsigKeyRequest}
      * @returns A Promise of GetDNSZoneTsigKeyResponse
      */
     getDNSZoneTsigKey: (request: Readonly<GetDNSZoneTsigKeyRequest>) => Promise<GetDNSZoneTsigKeyResponse>;
     /**
-     * Delete the DNS zone TSIG Key.
+     * Delete the DNS zone's TSIG key. Delete an existing TSIG key specified by
+     * its DNS zone. Deleting a TSIG key is permanent and cannot be undone.
      *
      * @param request - The request {@link DeleteDNSZoneTsigKeyRequest}
      */
@@ -6258,80 +6264,80 @@ type MACAddressStatus = 'unknown' | 'ready' | 'updating' | 'used' | 'error' | 'd
 type MACAddressType = 'unknown_type' | 'vmware' | 'xen' | 'kvm';
 /** Attach flexible i ps response. */
 interface AttachFlexibleIPsResponse {
-    /** Total count of Flexible IPs being updated. */
+    /** Total count of flexible IPs that are being updated. */
     totalCount: number;
-    /** Listing of Flexible IPs in updating state. */
+    /** List of flexible IPs in an updating state. */
     flexibleIps: FlexibleIP[];
 }
 /** Detach flexible i ps response. */
 interface DetachFlexibleIPsResponse {
-    /** Total count of Flexible IPs being detached. */
+    /** Total count of flexible IPs that are being detached. */
     totalCount: number;
-    /** Listing of Flexible IPs in detaching state. */
+    /** List of flexible IPs in a detaching state. */
     flexibleIps: FlexibleIP[];
 }
 /** Flexible ip. */
 interface FlexibleIP {
-    /** ID of the Flexible IP. */
+    /** ID of the flexible IP. */
     id: string;
-    /** Organization ID the Flexible IP is attached to. */
+    /** ID of the Organization the flexible IP is attached to. */
     organizationId: string;
-    /** Project ID the Flexible IP is attached to. */
+    /** ID of the Project the flexible IP is attached to. */
     projectId: string;
-    /** Description of the Flexible IP. */
+    /** Flexible IP description. */
     description: string;
-    /** Tags associated with the Flexible IP. */
+    /** Flexible IP tags. */
     tags: string[];
-    /** Date of last update of the Flexible IP. */
+    /** Date on which the flexible IP was last updated. */
     updatedAt?: Date;
-    /** Date of creation of the Flexible IP. */
+    /** Date on which the flexible IP was created. */
     createdAt?: Date;
     /**
-     * Status of the Flexible IP.
+     * Flexible IP status.
      *
-     * - Ready : Flexible IP is created and ready to be attached to a server or to
-     *   have a virtual MAC generated.
-     * - Updating: Flexible IP is being attached to a server or a virtual MAC
+     * - Ready : flexible IP is created and ready to be attached to a server or to
+     *   be associated with a virtual MAC.
+     * - Updating: flexible IP is being attached to a server or a virtual MAC
      *   operation is ongoing
-     * - Attached: Flexible IP is attached to a server
-     * - Error: a Flexible IP operation resulted in an error
-     * - Detaching: Flexible IP is being detached from a server
-     * - Locked: Flexible IP resource is locked.
+     * - Attached: flexible IP is attached to a server
+     * - Error: a flexible IP operation resulted in an error
+     * - Detaching: flexible IP is being detached from a server
+     * - Locked: the resource of the flexible IP is locked.
      */
     status: FlexibleIPStatus;
-    /** IP of the Flexible IP. */
+    /** IP of the flexible IP. */
     ipAddress: string;
-    /** MAC address of the Flexible IP. */
+    /** MAC address of the flexible IP. */
     macAddress?: MACAddress;
-    /** ID of the server linked to the Flexible IP. */
+    /** ID of the server linked to the flexible IP. */
     serverId?: string;
     /** Reverse DNS value. */
     reverse: string;
-    /** Flexible IP Availability Zone. */
+    /** Availability Zone of the flexible IP. */
     zone: Zone;
 }
 /** List flexible i ps response. */
 interface ListFlexibleIPsResponse {
-    /** Total count of matching Flexible IPs. */
+    /** Total count of matching flexible IPs. */
     totalCount: number;
-    /** Listing of Flexible IPs. */
+    /** List of all flexible IPs. */
     flexibleIps: FlexibleIP[];
 }
 /** Mac address. */
 interface MACAddress {
-    /** ID of the Flexible IP. */
+    /** ID of the flexible IP. */
     id: string;
     /** MAC address of the Virtual MAC. */
     macAddress: string;
-    /** Virtual MAC type. */
+    /** Type of virtual MAC. */
     macType: MACAddressType;
-    /** Virtual MAC status. */
+    /** Status of virtual MAC. */
     status: MACAddressStatus;
-    /** Date of last update of the Virtual MAC. */
+    /** Date on which the virtual MAC was last updated. */
     updatedAt?: Date;
-    /** Date of creation of the Virtual MAC. */
+    /** Date on which the virtual MAC was created. */
     createdAt?: Date;
-    /** MAC Addr IP Availability Zone. */
+    /** MAC address IP Availability Zone. */
     zone: Zone;
 }
 type CreateFlexibleIPRequest = {
@@ -6339,87 +6345,95 @@ type CreateFlexibleIPRequest = {
     zone?: Zone;
     /** ID of the project to associate with the Flexible IP. */
     projectId?: string;
-    /** Description to associate with the Flexible IP, max 255 characters. */
+    /** Flexible IP description (max. of 255 characters). */
     description: string;
-    /** Tags to associate to the Flexible IP. */
+    /** Tags to associate to the flexible IP. */
     tags?: string[];
-    /** Server ID on which to attach the created Flexible IP. */
+    /** ID of the server to which the newly created flexible IP will be attached. */
     serverId?: string;
-    /** Reverse DNS value. */
+    /** Value of the reverse DNS. */
     reverse?: string;
-    /** If true, creates a Flexible IP with an ipv6 address. */
+    /** Defines whether the flexible IP has an IPv6 address. */
     isIpv6: boolean;
 };
 type GetFlexibleIPRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
     zone?: Zone;
-    /** Flexible IP ID. */
+    /** ID of the flexible IP. */
     fipId: string;
 };
 type ListFlexibleIPsRequest$1 = {
     /** Zone to target. If none is passed will use default zone from the config. */
     zone?: Zone;
-    /** The sort order of the returned Flexible IPs. */
+    /** Sort order of the returned flexible IPs. */
     orderBy?: ListFlexibleIPsRequestOrderBy;
-    /** The page number for the returned Flexible IPs. */
+    /** Page number. */
     page?: number;
-    /** The maximum number of Flexible IPs per page. */
+    /** Maximum number of flexible IPs per page. */
     pageSize?: number;
-    /** Filter Flexible IPs with one or more matching tags. */
+    /**
+     * Filter by tag, only flexible IPs with one or more matching tags will be
+     * returned.
+     */
     tags?: string[];
-    /** Filter Flexible IPs by status. */
+    /** Filter by status, only flexible IPs with this status will be returned. */
     status?: FlexibleIPStatus[];
-    /** Filter Flexible IPs by server IDs. */
+    /**
+     * Filter by server IDs, only flexible IPs with these server IDs will be
+     * returned.
+     */
     serverIds?: string[];
-    /** Filter Flexible IPs by organization ID. */
+    /**
+     * Filter by Organization ID, only flexible IPs from this Organization will be
+     * returned.
+     */
     organizationId?: string;
-    /** Filter Flexible IPs by project ID. */
+    /** Filter by Project ID, only flexible IPs from this Project will be returned. */
     projectId?: string;
 };
 type UpdateFlexibleIPRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
     zone?: Zone;
-    /** ID of the Flexible IP to update. */
+    /** ID of the flexible IP to update. */
     fipId: string;
-    /** Description to associate with the Flexible IP, max 255 characters. */
+    /** Flexible IP description (max. 255 characters). */
     description?: string;
-    /** Tags to associate with the Flexible IP. */
+    /** Tags associated with the flexible IP. */
     tags?: string[];
-    /** Reverse DNS value. */
+    /** Value of the reverse DNS. */
     reverse?: string;
 };
 type DeleteFlexibleIPRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
     zone?: Zone;
-    /** ID of the Flexible IP to delete. */
+    /** ID of the flexible IP to delete. */
     fipId: string;
 };
 type AttachFlexibleIPRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
     zone?: Zone;
     /**
-     * A list of Flexible IP IDs to attach. Multiple IDs can be provided as long
-     * as Flexible IPs belong to the same MAC groups (see details about MAC
-     * groups).
+     * List of flexible IP IDs to attach to a server. Multiple IDs can be
+     * provided, but note that flexible IPs must belong to the same MAC group (see
+     * details about MAC groups).
      */
     fipsIds: string[];
-    /** A server ID on which to attach the Flexible IPs. */
+    /** ID of the server on which to attach the flexible IPs. */
     serverId: string;
 };
 type DetachFlexibleIPRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
     zone?: Zone;
     /**
-     * A list of Flexible IP IDs to detach. Multiple IDs can be provided as long
-     * as Flexible IPs belong to the same MAC groups (see details about MAC
-     * groups).
+     * List of flexible IP IDs to detach from a server. Multiple IDs can be
+     * provided. Note that flexible IPs must belong to the same MAC group.
      */
     fipsIds: string[];
 };
 type GenerateMACAddrRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
     zone?: Zone;
-    /** Flexible IP ID on which to generate a Virtual MAC. */
+    /** ID of the flexible IP for which to generate a virtual MAC. */
     fipId: string;
     /** TODO. */
     macType: MACAddressType;
@@ -6428,13 +6442,13 @@ type DuplicateMACAddrRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
     zone?: Zone;
     /**
-     * Flexible IP ID on which to duplicate the Virtual MAC. Flexible IPs need to
-     * be attached to the same server.
+     * ID of the flexible IP on which to duplicate the virtual MAC. Note that the
+     * flexible IPs need to be attached to the same server.
      */
     fipId: string;
     /**
-     * Flexible IP ID to duplicate the Virtual MAC from. Flexible IPs need to be
-     * attached to the same server.
+     * ID of the flexible IP to duplicate the Virtual MAC from. Note that flexible
+     * IPs need to be attached to the same server.
      */
     duplicateFromFipId: string;
 };
@@ -6448,26 +6462,29 @@ type DeleteMACAddrRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
     zone?: Zone;
     /**
-     * Flexible IP ID from which to delete the Virtual MAC. If the Flexible IP
-     * belongs to a MAC group, the MAC will be removed from the MAC group and from
-     * the Flexible IP.
+     * ID of the flexible IP from which to delete the virtual MAC. If the flexible
+     * IP belongs to a MAC group, the MAC will be removed from both the MAC group
+     * and flexible IP.
      */
     fipId: string;
 };
 
-/** Flexible IP API. */
+/** Elastic Metal - Flexible IP API. */
 declare class API$i extends API$q {
     /** Lists the available zones of the API. */
     static readonly LOCALITIES: Zone[];
     /**
-     * Create a Flexible IP.
+     * Create a new flexible IP. Generate a new flexible IP within a given zone,
+     * specifying its configuration including Project ID and description.
      *
      * @param request - The request {@link CreateFlexibleIPRequest}
      * @returns A Promise of FlexibleIP
      */
     createFlexibleIP: (request: Readonly<CreateFlexibleIPRequest>) => Promise<FlexibleIP>;
     /**
-     * Get a Flexible IP.
+     * Get an existing flexible IP. Retrieve information about an existing
+     * flexible IP, specified by its ID and zone. Its full details, including
+     * Project ID, description and status, are returned in the response object.
      *
      * @param request - The request {@link GetFlexibleIPRequest}
      * @returns A Promise of FlexibleIP
@@ -6483,7 +6500,7 @@ declare class API$i extends API$q {
     waitForFlexibleIP: (request: Readonly<GetFlexibleIPRequest>, options?: Readonly<WaitForOptions<FlexibleIP>>) => Promise<FlexibleIP>;
     protected pageOfListFlexibleIPs: (request?: Readonly<ListFlexibleIPsRequest$1>) => Promise<ListFlexibleIPsResponse>;
     /**
-     * List Flexible IPs.
+     * List flexible IPs. List all flexible IPs within a given zone.
      *
      * @param request - The request {@link ListFlexibleIPsRequest}
      * @returns A Promise of ListFlexibleIPsResponse
@@ -6493,57 +6510,67 @@ declare class API$i extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<FlexibleIP[], void, void>;
     };
     /**
-     * Update a Flexible IP.
+     * Update an existing flexible IP. Update the parameters of an existing
+     * flexible IP, specified by its ID and zone. These parameters include tags
+     * and description.
      *
      * @param request - The request {@link UpdateFlexibleIPRequest}
      * @returns A Promise of FlexibleIP
      */
     updateFlexibleIP: (request: Readonly<UpdateFlexibleIPRequest>) => Promise<FlexibleIP>;
     /**
-     * Delete a Flexible IP.
+     * Delete an existing flexible IP. Delete an existing flexible IP, specified
+     * by its ID and zone. Note that deleting a flexible IP is permanent and
+     * cannot be undone.
      *
      * @param request - The request {@link DeleteFlexibleIPRequest}
      */
     deleteFlexibleIP: (request: Readonly<DeleteFlexibleIPRequest>) => Promise<void>;
     /**
-     * Attach a Flexible IP to a server.
+     * Attach an existing flexible IP to a server. Attach an existing flexible IP
+     * to a specified Elastic Metal server.
      *
      * @param request - The request {@link AttachFlexibleIPRequest}
      * @returns A Promise of AttachFlexibleIPsResponse
      */
     attachFlexibleIP: (request: Readonly<AttachFlexibleIPRequest>) => Promise<AttachFlexibleIPsResponse>;
     /**
-     * Detach a Flexible IP from a server.
+     * Detach an existing flexible IP from a server. Detach an existing flexible
+     * IP from a specified Elastic Metal server.
      *
      * @param request - The request {@link DetachFlexibleIPRequest}
      * @returns A Promise of DetachFlexibleIPsResponse
      */
     detachFlexibleIP: (request: Readonly<DetachFlexibleIPRequest>) => Promise<DetachFlexibleIPsResponse>;
     /**
-     * Generate a virtual MAC on a given Flexible IP.
+     * Generate a virtual MAC address on an existing flexible IP. Generate a
+     * virtual MAC (Media Access Control) address on an existing flexible IP.
      *
      * @param request - The request {@link GenerateMACAddrRequest}
      * @returns A Promise of FlexibleIP
      */
     generateMACAddr: (request: Readonly<GenerateMACAddrRequest>) => Promise<FlexibleIP>;
     /**
-     * Duplicate a Virtual MAC. Duplicate a Virtual MAC from a given Flexible IP
-     * onto another attached on the same server.
+     * Duplicate a virtual MAC address to another flexible IP. Duplicate a virtual
+     * MAC address from a given flexible IP to another flexible IP attached to the
+     * same server.
      *
      * @param request - The request {@link DuplicateMACAddrRequest}
      * @returns A Promise of FlexibleIP
      */
     duplicateMACAddr: (request: Readonly<DuplicateMACAddrRequest>) => Promise<FlexibleIP>;
     /**
-     * Move a virtual MAC. Move a Virtual MAC from a given Flexible IP onto
-     * another Flexible IP.
+     * Relocate an existing virtual MAC address to a different flexible IP.
+     * Relocate a virtual MAC (Media Access Control) address from an existing
+     * flexible IP to a different flexible IP.
      *
      * @param request - The request {@link MoveMACAddrRequest}
      * @returns A Promise of FlexibleIP
      */
     moveMACAddr: (request: Readonly<MoveMACAddrRequest>) => Promise<FlexibleIP>;
     /**
-     * Remove a virtual MAC from a Flexible IP.
+     * Detach a given virtual MAC address from an existing flexible IP. Detach a
+     * given MAC (Media Access Control) address from an existing flexible IP.
      *
      * @param request - The request {@link DeleteMACAddrRequest}
      */
@@ -7960,9 +7987,9 @@ interface APIKey {
     updatedAt?: Date;
     /** Date and time of API key expiration. */
     expiresAt?: Date;
-    /** The default Project ID specified for this API key. */
+    /** Default Project ID specified for this API key. */
     defaultProjectId: string;
-    /** Whether or not the API key is editable. */
+    /** Defines whether or not the API key is editable. */
     editable: boolean;
     /** IP address of the device that created the API key. */
     creationIp: string;
@@ -7981,7 +8008,7 @@ interface Application {
     updatedAt?: Date;
     /** ID of the Organization. */
     organizationId: string;
-    /** Whether or not the application is editable. */
+    /** Defines whether or not the application is editable. */
     editable: boolean;
     /** Number of API keys attributed to the application. */
     nbApiKeys: number;
@@ -8118,7 +8145,7 @@ interface Policy {
     createdAt?: Date;
     /** Date and time of last policy update. */
     updatedAt?: Date;
-    /** Whether or not a policy is editable. */
+    /** Defines whether or not a policy is editable. */
     editable: boolean;
     /** Number of rules of the policy. */
     nbRules: number;
@@ -8148,7 +8175,7 @@ interface Policy {
      */
     applicationId?: string;
     /**
-     * Whether or not a policy is attributed to a principal.
+     * Defines whether or not a policy is attributed to a principal.
      *
      * One-of ('principal'): at most one of 'userId', 'groupId', 'applicationId',
      * 'noPrincipal' could be set.
@@ -8166,7 +8193,7 @@ interface Quotum {
      */
     limit?: number;
     /**
-     * Whether or not the quota is unlimited.
+     * Defines whether or not the quota is unlimited.
      *
      * One-of ('value'): at most one of 'limit', 'unlimited' could be set.
      */
@@ -8269,7 +8296,7 @@ interface User$1 {
     twoFactorEnabled?: boolean;
     /** Status of user invitation. */
     status: UserStatus;
-    /** Whether MFA is enabled. */
+    /** Defines whether MFA is enabled. */
     mfa: boolean;
 }
 type ListSSHKeysRequest$1 = {
@@ -8285,11 +8312,11 @@ type ListSSHKeysRequest$1 = {
     name?: string;
     /** Filter by Project ID. */
     projectId?: string;
-    /** Whether to include disabled SSH keys or not. */
+    /** Defines whether to include disabled SSH keys or not. */
     disabled?: boolean;
 };
 type CreateSSHKeyRequest$1 = {
-    /** The name of the SSH key. Max length is 1000. */
+    /** Name of the SSH key. Max length is 1000. */
     name?: string;
     /**
      * SSH public key. Currently only the ssh-rsa, ssh-dss (DSA), ssh-ed25519 and
@@ -8300,7 +8327,7 @@ type CreateSSHKeyRequest$1 = {
     projectId?: string;
 };
 type GetSSHKeyRequest = {
-    /** The ID of the SSH key. */
+    /** ID of the SSH key. */
     sshKeyId: string;
 };
 type UpdateSSHKeyRequest$1 = {
@@ -8346,7 +8373,7 @@ type ListApplicationsRequest$1 = {
     name?: string;
     /** ID of the Organization to filter. */
     organizationId?: string;
-    /** Whether to filter out editable applications or not. */
+    /** Defines whether to filter out editable applications or not. */
     editable?: boolean;
     /** Filter by list of IDs. */
     applicationIds?: string[];
@@ -8469,15 +8496,15 @@ type ListPoliciesRequest$1 = {
     page?: number;
     /** ID of the Organization to filter. */
     organizationId?: string;
-    /** Whether or not filter out editable policies. */
+    /** Defines whether or not filter out editable policies. */
     editable?: boolean;
-    /** Whether or not to filter by list of user IDs. */
+    /** Defines whether or not to filter by list of user IDs. */
     userIds?: string[];
-    /** Whether or not to filter by list of group IDs. */
+    /** Defines whether or not to filter by list of group IDs. */
     groupIds?: string[];
     /** Filter by a list of application IDs. */
     applicationIds?: string[];
-    /** Whether or not the policy is attributed to a principal. */
+    /** Defines whether or not the policy is attributed to a principal. */
     noPrincipal?: boolean;
     /** Name of the policy to fetch. */
     policyName?: string;
@@ -8513,7 +8540,7 @@ type CreatePolicyRequest$1 = {
      */
     applicationId?: string;
     /**
-     * Whether or not a policy is attributed to a principal.
+     * Defines whether or not a policy is attributed to a principal.
      *
      * One-of ('principal'): at most one of 'userId', 'groupId', 'applicationId',
      * 'noPrincipal' could be set.
@@ -8553,7 +8580,7 @@ type UpdatePolicyRequest$1 = {
      */
     applicationId?: string;
     /**
-     * Whether or not the policy is attributed to a principal.
+     * Defines whether or not the policy is attributed to a principal.
      *
      * One-of ('principal'): at most one of 'userId', 'groupId', 'applicationId',
      * 'noPrincipal' could be set.
@@ -8612,9 +8639,9 @@ type ListAPIKeysRequest$1 = {
      *   One-of ('bearer'): at most one of 'applicationId', 'userId' could be set.
      */
     userId?: string;
-    /** Whether to filter out editable API keys or not. */
+    /** Defines whether to filter out editable API keys or not. */
     editable?: boolean;
-    /** Whether to filter out expired API keys or not. */
+    /** Defines whether to filter out expired API keys or not. */
     expired?: boolean;
     /** Filter by access key. */
     accessKey?: string;
@@ -8640,9 +8667,9 @@ type CreateAPIKeyRequest$1 = {
     userId?: string;
     /** Expiration date of the API key. */
     expiresAt?: Date;
-    /** The default Project ID to use with Object Storage. */
+    /** Default Project ID to use with Object Storage. */
     defaultProjectId?: string;
-    /** The description of the API key (max length is 200 characters). */
+    /** Description of the API key (max length is 200 characters). */
     description: string;
 };
 type GetAPIKeyRequest = {
@@ -8652,9 +8679,9 @@ type GetAPIKeyRequest = {
 type UpdateAPIKeyRequest$1 = {
     /** Access key to update. */
     accessKey: string;
-    /** The new default Project ID to set. */
+    /** New default Project ID to set. */
     defaultProjectId?: string;
-    /** The new description to update. */
+    /** New description to update. */
     description?: string;
 };
 type DeleteAPIKeyRequest = {
@@ -9824,7 +9851,10 @@ interface SecurityGroup {
     name: string;
     /** Security group description. */
     description: string;
-    /** True if SMTP is blocked on IPv4 and IPv6. */
+    /**
+     * True if SMTP is blocked on IPv4 and IPv6. This feature is read only, please
+     * open a support ticket if you need to make it configurable.
+     */
     enableDefaultSecurity: boolean;
     /** Default inbound policy. */
     inboundDefaultPolicy: SecurityGroupPolicy;
@@ -10666,7 +10696,10 @@ type CreateSecurityGroupRequest = {
     inboundDefaultPolicy?: SecurityGroupPolicy;
     /** Default policy for outbound rules. */
     outboundDefaultPolicy?: SecurityGroupPolicy;
-    /** True to block SMTP on IPv4 and IPv6. */
+    /**
+     * True to block SMTP on IPv4 and IPv6. This feature is read only, please open
+     * a support ticket if you need to make it configurable.
+     */
     enableDefaultSecurity?: boolean;
 };
 type GetSecurityGroupRequest = {
@@ -11183,7 +11216,10 @@ type SetSecurityGroupRequest = {
     modificationDate?: Date;
     /** Description of the security group. */
     description: string;
-    /** True to block SMTP on IPv4 and IPv6. */
+    /**
+     * True to block SMTP on IPv4 and IPv6. This feature is read only, please open
+     * a support ticket if you need to make it configurable.
+     */
     enableDefaultSecurity: boolean;
     /** Default inbound policy. */
     inboundDefaultPolicy?: SecurityGroupPolicy;
@@ -11238,7 +11274,7 @@ declare class API$f extends API$q {
      */
     listServersTypes: (request?: Readonly<ListServersTypesRequest>) => Promise<ListServersTypesResponse>;
     /**
-     * List volumes types. List all volume types and their technical details.
+     * List volume types. List all volume types and their technical details.
      *
      * @param request - The request {@link ListVolumesTypesRequest}
      * @returns A Promise of ListVolumesTypesResponse
@@ -11293,7 +11329,7 @@ declare class API$f extends API$q {
      * preserve your local volumes, you should use the `archive` action instead of
      * `terminate`. Similarly, if you want to keep your block storage volumes, you
      * must first detach them before issuing the `terminate` command. For more
-     * information, read the [Volumes](#volumes-7e8a39) documentation.
+     * information, read the [Volumes](#path-volumes-list-volumes) documentation.
      *
      * @param request - The request {@link ServerActionRequest}
      * @returns A Promise of ServerActionResponse
@@ -12304,14 +12340,14 @@ interface Certificate$1 {
 }
 /** Create device response. */
 interface CreateDeviceResponse {
-    /** Created device information. */
+    /** Information related to the created device. */
     device?: Device;
     /** Device certificate. */
     certificate?: Certificate$1;
 }
 /** Create network response. */
 interface CreateNetworkResponse {
-    /** Created network. */
+    /** Information related to the created network. */
     network?: Network;
     /** Endpoint Key to keep secret. This cannot be retrieved later. */
     secret: string;
@@ -12338,7 +12374,7 @@ interface CreateRouteRequestS3Config {
 }
 /** Device. */
 interface Device {
-    /** Device ID, also used as MQTT Client ID or Username. */
+    /** Device ID, also used as MQTT Client ID or username. */
     id: string;
     /** Device name. */
     name: string;
@@ -12348,28 +12384,31 @@ interface Device {
     status: DeviceStatus;
     /** Hub ID. */
     hubId: string;
-    /** Device last connection/activity date. */
+    /** Last connection/activity date of a device. */
     lastActivityAt?: Date;
-    /** Whether the device is connected to the Hub or not. */
+    /** Defines whether the device is connected to the Hub. */
     isConnected: boolean;
-    /** Whether to allow device to connect without TLS mutual authentication. */
+    /**
+     * Defines whether to allow the device to connect to the Hub without TLS
+     * mutual authentication.
+     */
     allowInsecure: boolean;
     /**
-     * Whether to allow multiple physical devices to connect with this device's
-     * credentials.
+     * Defines whether to allow multiple physical devices to connect to the Hub
+     * with this device's credentials.
      */
     allowMultipleConnections: boolean;
     /** Filter-sets to restrict the topics the device can publish/subscribe to. */
     messageFilters?: DeviceMessageFilters;
     /**
-     * Whether the device was assigned a custom certificate. Assigning a custom
-     * certificate allows a device to authenticate using that specific certificate
-     * without checking the hub's CA certificate.
+     * Defines whether the device was assigned a custom certificate. Assigning a
+     * custom certificate allows a device to authenticate using that specific
+     * certificate without checking the Hub's CA certificate.
      */
     hasCustomCertificate: boolean;
-    /** Device add date. */
+    /** Date at which the device was added. */
     createdAt?: Date;
-    /** Device last modification date. */
+    /** Date at which the device was last modified. */
     updatedAt?: Date;
 }
 /** Device. message filters. */
@@ -12382,9 +12421,10 @@ interface DeviceMessageFilters {
 /** Device. message filters. rule. */
 interface DeviceMessageFiltersRule {
     /**
-     * How to use the topic list. If accept, the set will accept all topics in the
-     * topics list, but no other. If reject, the set will deny all topics in the
-     * topics list, but all others will be allowed.
+     * How to use the topic list. If set to `accept`, all topics in the topics
+     * list will be allowed, with all other topics being denied. If set to
+     * `reject`, all topics in the topics list will be denied, with all other
+     * topics being allowed.
      */
     policy: DeviceMessageFiltersRulePolicy;
     /**
@@ -12395,7 +12435,7 @@ interface DeviceMessageFiltersRule {
 }
 /** Get device certificate response. */
 interface GetDeviceCertificateResponse {
-    /** Created device information. */
+    /** Information related to the created device. */
     device?: Device;
     /** Device certificate. */
     certificatePem: string;
@@ -12410,7 +12450,7 @@ interface GetHubCAResponse {
 }
 /** Get hub metrics response. */
 interface GetHubMetricsResponse {
-    /** Metrics for a hub over the requested period. */
+    /** Metrics for a Hub over the requested period. */
     metrics: TimeSeries[];
 }
 /** Hub. */
@@ -12423,19 +12463,19 @@ interface Hub {
     status: HubStatus;
     /** Hub feature set. */
     productPlan: HubProductPlan;
-    /** Whether the hub has been enabled. */
+    /** Defines whether the hub has been enabled. */
     enabled: boolean;
     /** Number of registered devices. */
     deviceCount: number;
     /** Number of currently connected devices. */
     connectedDeviceCount: number;
     /**
-     * Host to connect your devices to. Devices should be connected to this host,
-     * port may be 1883 (MQTT), 8883 (MQTT over TLS), 80 (MQTT over Websocket) or
+     * Host to connect your devices to. Devices should be connected to this host.
+     * Port may be 1883 (MQTT), 8883 (MQTT over TLS), 80 (MQTT over Websocket) or
      * 443 (MQTT over Websocket over TLS).
      */
     endpoint: string;
-    /** Disable Hub events. */
+    /** Defines whether to disable Hub events. */
     disableEvents: boolean;
     /** Hub events topic prefix. */
     eventsTopicPrefix: string;
@@ -12450,18 +12490,19 @@ interface Hub {
     /** Organization owning the resource. */
     organizationId: string;
     /**
-     * Enable device auto provisioning. When an unknown device connects to your
-     * hub using a valid certificate chain, it will be automatically provisioned
-     * inside your hub. The hub uses the common name of the device certifcate to
-     * find out if a device with the same name already exists. This setting can
-     * only be enabled on a hub with a custom certificate authority.
+     * Defines whether to enable device auto provisioning. When an unknown device
+     * connects to your hub using a valid certificate chain, it will be
+     * automatically provisioned inside your Hub. The Hub uses the common name of
+     * the device certifcate to find out if a device with the same name already
+     * exists. This setting can only be enabled on a hub with a custom certificate
+     * authority.
      */
     enableDeviceAutoProvisioning: boolean;
     /**
-     * Whether the hub is using a custom certificate authority. After creating a
-     * hub, this flag is set to False as the hub certificates are managed by
-     * Scaleway. Once a custom certificate authority is installed, this flag will
-     * be set to true.
+     * Defines whether the hub is using a custom certificate authority. Flag is
+     * automatically set to `false` after Hub creation, as Hub certificates are
+     * managed by Scaleway. Once a custom certificate authority is set, the flag
+     * will be set to `true`.
      */
     hasCustomCa: boolean;
     /**
@@ -12479,12 +12520,12 @@ interface HubTwinsGraphiteConfig {
 interface ListDevicesResponse {
     /** Total number of devices. */
     totalCount: number;
-    /** A page of devices. */
+    /** Page of devices. */
     devices: Device[];
 }
 /** List hubs response. */
 interface ListHubsResponse {
-    /** Total number of hubs. */
+    /** Total number of Hubs. */
     totalCount: number;
     /** A page of hubs. */
     hubs: Hub[];
@@ -12493,24 +12534,24 @@ interface ListHubsResponse {
 interface ListNetworksResponse {
     /** Total number of Networks. */
     totalCount: number;
-    /** A page of networks. */
+    /** Page of networks. */
     networks: Network[];
 }
 /** List routes response. */
 interface ListRoutesResponse$1 {
     /** Total number of routes. */
     totalCount: number;
-    /** A page of routes. */
+    /** Page of routes. */
     routes: RouteSummary[];
 }
 /** List twin documents response. */
 interface ListTwinDocumentsResponse {
-    /** Twin's document list. */
+    /** List of the twin document. */
     documents: ListTwinDocumentsResponseDocumentSummary[];
 }
 /** List twin documents response. document summary. */
 interface ListTwinDocumentsResponseDocumentSummary {
-    /** Document's name. */
+    /** Name of the document. */
     documentName: string;
 }
 /** Network. */
@@ -12525,7 +12566,7 @@ interface Network {
     endpoint: string;
     /** Hub ID to connect the Network to. */
     hubId: string;
-    /** Network creation date. */
+    /** Date at which the network was created. */
     createdAt?: Date;
     /**
      * Topic prefix for the Network. This prefix will be prepended to all topics
@@ -12535,7 +12576,7 @@ interface Network {
 }
 /** Renew device certificate response. */
 interface RenewDeviceCertificateResponse {
-    /** Created device information. */
+    /** Information related to the created device. */
     device?: Device;
     /** Device certificate. */
     certificate?: Certificate$1;
@@ -12546,7 +12587,7 @@ interface Route$1 {
     id: string;
     /** Route name. */
     name: string;
-    /** ID of the route's hub. */
+    /** Hub ID of the route. */
     hubId: string;
     /**
      * Topic the route subscribes to. It must be a valid MQTT topic and up to
@@ -12555,7 +12596,7 @@ interface Route$1 {
     topic: string;
     /** Route type. */
     type: RouteRouteType;
-    /** Route creation date. */
+    /** Date at which the route was created. */
     createdAt?: Date;
     /**
      * When using S3 Route, S3-specific configuration fields.
@@ -12578,14 +12619,14 @@ interface Route$1 {
      * could be set.
      */
     restConfig?: RouteRestConfig;
-    /** Route last update date. */
+    /** Date at which the route was last updated. */
     updatedAt?: Date;
 }
 /** Route. database config. */
 interface RouteDatabaseConfig {
     /**
-     * Database engine the route will connect to. If not specified, will default
-     * to 'PostgreSQL'.
+     * Database engine the route will connect to. If not specified, the default
+     * database will be 'PostgreSQL'.
      */
     engine: RouteDatabaseConfigEngine;
     /** Database host. */
@@ -12606,7 +12647,7 @@ interface RouteDatabaseConfig {
 }
 /** Route. rest config. */
 interface RouteRestConfig {
-    /** HTTP Verb used to call REST URI. */
+    /** HTTP verb used to call REST URI. */
     verb: RouteRestConfigHttpVerb;
     /** URI of the REST endpoint. */
     uri: string;
@@ -12615,9 +12656,9 @@ interface RouteRestConfig {
 }
 /** Route.s3 config. */
 interface RouteS3Config {
-    /** Region of the S3 route's destination bucket (eg 'fr-par'). */
+    /** Region of the S3 route's destination bucket (e.g., 'fr-par'). */
     bucketRegion: string;
-    /** Name of the S3 route's destination bucket. */
+    /** Destination bucket name of the S3 route. */
     bucketName: string;
     /** Optional string to prefix object names with. */
     objectPrefix: string;
@@ -12633,7 +12674,7 @@ interface RouteSummary {
     id: string;
     /** Route name. */
     name: string;
-    /** ID of the route's hub. */
+    /** Hub ID of the route. */
     hubId: string;
     /**
      * Topic the route subscribes to. It must be a valid MQTT topic and up to
@@ -12642,9 +12683,9 @@ interface RouteSummary {
     topic: string;
     /** Route type. */
     type: RouteRouteType;
-    /** Route creation date. */
+    /** Date at which the route was created. */
     createdAt?: Date;
-    /** Route last update date. */
+    /** Date at which the route was last updated. */
     updatedAt?: Date;
 }
 interface SetDeviceCertificateResponse {
@@ -12653,13 +12694,13 @@ interface SetDeviceCertificateResponse {
 }
 /** Twin document. */
 interface TwinDocument {
-    /** Document's parent twin ID. */
+    /** Parent twin ID of the document. */
     twinId: string;
-    /** Document's name. */
+    /** Name of the document. */
     documentName: string;
-    /** Document's new version. */
+    /** New version of the document. */
     version: number;
-    /** Document's new data. */
+    /** New data related to the document. */
     data?: Record<string, unknown>;
 }
 interface UpdateRouteRequestDatabaseConfig {
@@ -12688,17 +12729,17 @@ type ListHubsRequest = {
      * config.
      */
     region?: Region;
-    /** Page number. */
+    /** Page number to return, from the paginated results. */
     page?: number;
-    /** Page size. The maximum value is 100. */
+    /** Number of Hubs to return within a page. Maximum value is 100. */
     pageSize?: number;
-    /** Ordering of requested hub. */
+    /** Sort order of Hubs in the response. */
     orderBy?: ListHubsRequestOrderBy;
-    /** Filter on project. */
+    /** Only list Hubs of this Project ID. */
     projectId?: string;
-    /** Filter on the organization. */
+    /** Only list Hubs of this Organization ID. */
     organizationId?: string;
-    /** Filter on the name. */
+    /** Hub name. */
     name?: string;
 };
 type CreateHubRequest = {
@@ -12709,13 +12750,16 @@ type CreateHubRequest = {
     region?: Region;
     /** Hub name (up to 255 characters). */
     name?: string;
-    /** Organization/project owning the resource. */
+    /**
+     * Project/Organization ID to filter for, only Hubs from this
+     * Project/Organization will be returned.
+     */
     projectId?: string;
-    /** Hub feature set. */
+    /** Hub product plan. */
     productPlan: HubProductPlan;
     /** Disable Hub events. */
     disableEvents?: boolean;
-    /** Hub events topic prefix (default '$SCW/events'). */
+    /** Topic prefix (default '$SCW/events') of Hub events. */
     eventsTopicPrefix?: string;
     /**
      * BETA - not implemented yet.
@@ -12740,15 +12784,15 @@ type UpdateHubRequest = {
      * config.
      */
     region?: Region;
-    /** Hub ID. */
+    /** ID of the Hub you want to update. */
     hubId: string;
     /** Hub name (up to 255 characters). */
     name?: string;
-    /** Hub feature set. */
+    /** Hub product plan. */
     productPlan?: HubProductPlan;
     /** Disable Hub events. */
     disableEvents?: boolean;
-    /** Hub events topic prefix. */
+    /** Topic prefix of Hub events. */
     eventsTopicPrefix?: string;
     /** Enable device auto provisioning. */
     enableDeviceAutoProvisioning?: boolean;
@@ -12786,7 +12830,10 @@ type DeleteHubRequest = {
     region?: Region;
     /** Hub ID. */
     hubId: string;
-    /** Force deletion of devices added to this hub instead of rejecting operation. */
+    /**
+     * Defines whether to force the deletion of devices added to this Hub or
+     * reject the operation.
+     */
     deleteDevices?: boolean;
 };
 type GetHubMetricsRequest = {
@@ -12797,7 +12844,7 @@ type GetHubMetricsRequest = {
     region?: Region;
     /** Hub ID. */
     hubId: string;
-    /** Start date used to compute the best scale for the returned metrics. */
+    /** Start date used to compute the best scale for returned metrics. */
     startDate: Date;
 };
 type SetHubCARequest = {
@@ -12808,12 +12855,12 @@ type SetHubCARequest = {
     region?: Region;
     /** Hub ID. */
     hubId: string;
-    /** The CA's PEM-encoded certificate. */
+    /** CA's PEM-encoded certificate. */
     caCertPem: string;
     /**
-     * Proof of possession PEM-encoded certificate. The challenge is a PEM-encoded
-     * certificate to prove the possession of the CA. It must be signed by the CA,
-     * and have a Common Name equal to the Hub ID.
+     * Proof of possession of PEM-encoded certificate. Challenge is a PEM-encoded
+     * certificate that acts as proof of possession of the CA. It must be signed
+     * by the CA, and have a Common Name equal to the Hub ID.
      */
     challengeCertPem: string;
 };
@@ -12831,17 +12878,17 @@ type ListDevicesRequest = {
      * config.
      */
     region?: Region;
-    /** Page number. */
+    /** Page number to return, from the paginated results. */
     page?: number;
-    /** Page size. The maximum value is 100. */
+    /** Number of devices to return within a page. Maximum value is 100. */
     pageSize?: number;
     /** Ordering of requested devices. */
     orderBy?: ListDevicesRequestOrderBy;
-    /** Filter on the name. */
+    /** Name to filter for, only devices with this name will be returned. */
     name?: string;
-    /** Filter on the hub. */
+    /** Hub ID to filter for, only devices attached to this Hub will be returned. */
     hubId?: string;
-    /** Filter on the allow_insecure flag. */
+    /** Defines wheter to filter the allow_insecure flag. */
     allowInsecure?: boolean;
     /** Device status (enabled, disabled, etc.). */
     status?: DeviceStatus;
@@ -12854,14 +12901,17 @@ type CreateDeviceRequest = {
     region?: Region;
     /** Device name. */
     name?: string;
-    /** ID of the device's hub. */
+    /** Hub ID of the device. */
     hubId: string;
     /**
-     * Allow plain and server-authenticated SSL connections in addition to
-     * mutually-authenticated ones.
+     * Defines whether to allow plain and server-authenticated SSL connections in
+     * addition to mutually-authenticated ones.
      */
     allowInsecure: boolean;
-    /** Allow multiple physical devices to connect with this device's credentials. */
+    /**
+     * Defines whether to allow multiple physical devices to connect with this
+     * device's credentials.
+     */
     allowMultipleConnections: boolean;
     /**
      * Filter-sets to authorize or deny the device to publish/subscribe to
@@ -12888,14 +12938,17 @@ type UpdateDeviceRequest = {
     region?: Region;
     /** Device ID. */
     deviceId: string;
-    /** Device description. */
+    /** Description for the device. */
     description?: string;
     /**
-     * Allow plain and server-authenticated SSL connections in addition to
-     * mutually-authenticated ones.
+     * Defines whether to allow plain and server-authenticated SSL connections in
+     * addition to mutually-authenticated ones.
      */
     allowInsecure?: boolean;
-    /** Allow multiple physical devices to connect with this device's credentials. */
+    /**
+     * Defines whether to allow multiple physical devices to connect with this
+     * device's credentials.
+     */
     allowMultipleConnections?: boolean;
     /** Filter-sets to restrict the topics the device can publish/subscribe to. */
     messageFilters?: DeviceMessageFilters;
@@ -12937,7 +12990,7 @@ type SetDeviceCertificateRequest = {
     region?: Region;
     /** Device ID. */
     deviceId: string;
-    /** The PEM-encoded custom certificate. */
+    /** PEM-encoded custom certificate. */
     certificatePem: string;
 };
 type GetDeviceCertificateRequest = {
@@ -12975,15 +13028,15 @@ type ListRoutesRequest$1 = {
      * config.
      */
     region?: Region;
-    /** Page number. */
+    /** Page number to return, from the paginated results. */
     page?: number;
-    /** Page size. The maximum value is 100. */
+    /** Number of routes to return within a page. Maximum value is 100. */
     pageSize?: number;
     /** Ordering of requested routes. */
     orderBy?: ListRoutesRequestOrderBy$1;
-    /** Filter on the hub. */
+    /** Hub ID to filter for. */
     hubId?: string;
-    /** Filter on route's name. */
+    /** Route name to filter for. */
     name?: string;
 };
 type CreateRouteRequest$1 = {
@@ -12994,7 +13047,7 @@ type CreateRouteRequest$1 = {
     region?: Region;
     /** Route name. */
     name?: string;
-    /** ID of the route's hub. */
+    /** Hub ID of the route. */
     hubId: string;
     /**
      * Topic the route subscribes to. It must be a valid MQTT topic and up to
@@ -13084,17 +13137,17 @@ type ListNetworksRequest = {
      * config.
      */
     region?: Region;
-    /** Page number. */
+    /** Page number to return, from the paginated results. */
     page?: number;
-    /** Page size. The maximum value is 100. */
+    /** Number of networks to return. The maximum value is 100. */
     pageSize?: number;
     /** Ordering of requested routes. */
     orderBy?: ListNetworksRequestOrderBy;
-    /** Filter on Network name. */
+    /** Network name to filter for. */
     name?: string;
-    /** Filter on the hub. */
+    /** Hub ID to filter for. */
     hubId?: string;
-    /** Filter on the topic prefix. */
+    /** Topic prefix to filter for. */
     topicPrefix?: string;
 };
 type CreateNetworkRequest = {
@@ -13138,7 +13191,7 @@ type GetTwinDocumentRequest = {
     region?: Region;
     /** Twin ID. */
     twinId: string;
-    /** Document name. */
+    /** Name of the document. */
     documentName: string;
 };
 type PutTwinDocumentRequest = {
@@ -13149,15 +13202,15 @@ type PutTwinDocumentRequest = {
     region?: Region;
     /** Twin ID. */
     twinId: string;
-    /** Document name. */
+    /** Name of the document. */
     documentName: string;
     /**
-     * The version of the document to update. If set, ensures that the document's
-     * current version matches before persisting the update.
+     * Version of the document to update. If set, ensures that the current version
+     * of the document matches before persisting the update.
      */
     version?: number;
     /**
-     * New document data. The new data that will replace the contents of the
+     * Data of the new document. New data that will replace the contents of the
      * document.
      */
     data?: Record<string, unknown>;
@@ -13170,20 +13223,20 @@ type PatchTwinDocumentRequest = {
     region?: Region;
     /** Twin ID. */
     twinId: string;
-    /** Document name. */
+    /** Name of the document. */
     documentName: string;
     /**
-     * The version of the document to update. If set, ensures that the document's
-     * current version matches before persisting the update.
+     * The version of the document to update. If set, ensures that the current
+     * version of the document matches before persisting the update.
      */
     version?: number;
     /**
      * Patch data. A json data that will be applied on the document's current
      * data. Patching rules: The patch goes recursively through the patch objects.
-     * If the patch object property is null, then it is removed from the final
-     * object. If the patch object property is a value (number, strings, bool,
-     * arrays), it is replaced. If the patch object property is an object, the
-     * previous rules will be applied recursively on it.
+     * If the patch object property is null, it is removed from the final object.
+     * If the patch object property is a value (number, strings, bool, arrays), it
+     * is replaced. If the patch object property is an object, the previous rules
+     * will be applied recursively on it.
      */
     data?: Record<string, unknown>;
 };
@@ -13195,7 +13248,7 @@ type DeleteTwinDocumentRequest = {
     region?: Region;
     /** Twin ID. */
     twinId: string;
-    /** Document name. */
+    /** Name of the document. */
     documentName: string;
 };
 type ListTwinDocumentsRequest = {
@@ -13218,16 +13271,18 @@ type DeleteTwinDocumentsRequest = {
 };
 
 /**
- * IoT API.
+ * IoT Hub API.
  *
- * This API allows you to manage IoT hubs and devices. IoT API.
+ * This API allows you to manage IoT hubs and devices. IoT Hub API.
  */
 declare class API$e extends API$q {
     /** Lists the available regions of the API. */
     static readonly LOCALITIES: Region[];
     protected pageOfListHubs: (request?: Readonly<ListHubsRequest>) => Promise<ListHubsResponse>;
     /**
-     * List hubs.
+     * List hubs. List all Hubs in the specified zone. By default, returned Hubs
+     * are ordered by creation date in ascending order, though this can be
+     * modified via the `order_by` field.
      *
      * @param request - The request {@link ListHubsRequest}
      * @returns A Promise of ListHubsResponse
@@ -13237,14 +13292,17 @@ declare class API$e extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Hub[], void, void>;
     };
     /**
-     * Create a hub.
+     * Create a hub. Create a new Hub in the targeted region, specifying its
+     * configuration including name and product plan.
      *
      * @param request - The request {@link CreateHubRequest}
      * @returns A Promise of Hub
      */
     createHub: (request: Readonly<CreateHubRequest>) => Promise<Hub>;
     /**
-     * Get a hub.
+     * Get a hub. Retrieve information about an existing IoT Hub, specified by its
+     * Hub ID. Its full details, including name, status and endpoint, are returned
+     * in the response object.
      *
      * @param request - The request {@link GetHubRequest}
      * @returns A Promise of Hub
@@ -13259,34 +13317,37 @@ declare class API$e extends API$q {
      */
     waitForHub: (request: Readonly<GetHubRequest>, options?: Readonly<WaitForOptions<Hub>>) => Promise<Hub>;
     /**
-     * Update a hub.
+     * Update a hub. Update the parameters of an existing IoT Hub, specified by
+     * its Hub ID.
      *
      * @param request - The request {@link UpdateHubRequest}
      * @returns A Promise of Hub
      */
     updateHub: (request: Readonly<UpdateHubRequest>) => Promise<Hub>;
     /**
-     * Enable a hub.
+     * Enable a hub. Enable an existing IoT Hub, specified by its Hub ID.
      *
      * @param request - The request {@link EnableHubRequest}
      * @returns A Promise of Hub
      */
     enableHub: (request: Readonly<EnableHubRequest>) => Promise<Hub>;
     /**
-     * Disable a hub.
+     * Disable a hub. Disable an existing IoT Hub, specified by its Hub ID.
      *
      * @param request - The request {@link DisableHubRequest}
      * @returns A Promise of Hub
      */
     disableHub: (request: Readonly<DisableHubRequest>) => Promise<Hub>;
     /**
-     * Delete a hub.
+     * Delete a hub. Delete an existing IoT Hub, specified by its Hub ID. Deleting
+     * a Hub is permanent, and cannot be undone.
      *
      * @param request - The request {@link DeleteHubRequest}
      */
     deleteHub: (request: Readonly<DeleteHubRequest>) => Promise<void>;
     /**
-     * Get a hub's metrics.
+     * Get a hub's metrics. Get the metrics of an existing IoT Hub, specified by
+     * its Hub ID.
      *
      * @deprecated
      * @param request - The request {@link GetHubMetricsRequest}
@@ -13294,14 +13355,16 @@ declare class API$e extends API$q {
      */
     getHubMetrics: (request: Readonly<GetHubMetricsRequest>) => Promise<GetHubMetricsResponse>;
     /**
-     * Set the certificate authority of a hub.
+     * Set the certificate authority of a hub. Set a particular PEM-encoded
+     * certificate, specified by the Hub ID.
      *
      * @param request - The request {@link SetHubCARequest}
      * @returns A Promise of Hub
      */
     setHubCA: (request: Readonly<SetHubCARequest>) => Promise<Hub>;
     /**
-     * Get the certificate authority of a hub.
+     * Get the certificate authority of a hub. Get information for a particular
+     * PEM-encoded certificate, specified by the Hub ID.
      *
      * @param request - The request {@link GetHubCARequest}
      * @returns A Promise of GetHubCAResponse
@@ -13309,7 +13372,9 @@ declare class API$e extends API$q {
     getHubCA: (request: Readonly<GetHubCARequest>) => Promise<GetHubCAResponse>;
     protected pageOfListDevices: (request?: Readonly<ListDevicesRequest>) => Promise<ListDevicesResponse>;
     /**
-     * List devices.
+     * List devices. List all devices in the specified region. By default,
+     * returned devices are ordered by creation date in ascending order, though
+     * this can be modified via the `order_by` field.
      *
      * @param request - The request {@link ListDevicesRequest}
      * @returns A Promise of ListDevicesResponse
@@ -13319,69 +13384,78 @@ declare class API$e extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Device[], void, void>;
     };
     /**
-     * Add a device.
+     * Add a device. Attach a device to a given Hub.
      *
      * @param request - The request {@link CreateDeviceRequest}
      * @returns A Promise of CreateDeviceResponse
      */
     createDevice: (request: Readonly<CreateDeviceRequest>) => Promise<CreateDeviceResponse>;
     /**
-     * Get a device.
+     * Get a device. Retrieve information about an existing device, specified by
+     * its device ID. Its full details, including name, status and ID, are
+     * returned in the response object.
      *
      * @param request - The request {@link GetDeviceRequest}
      * @returns A Promise of Device
      */
     getDevice: (request: Readonly<GetDeviceRequest>) => Promise<Device>;
     /**
-     * Update a device.
+     * Update a device. Update the parameters of an existing device, specified by
+     * its device ID.
      *
      * @param request - The request {@link UpdateDeviceRequest}
      * @returns A Promise of Device
      */
     updateDevice: (request: Readonly<UpdateDeviceRequest>) => Promise<Device>;
     /**
-     * Enable a device.
+     * Enable a device. Enable a specific device, specified by its device ID.
      *
      * @param request - The request {@link EnableDeviceRequest}
      * @returns A Promise of Device
      */
     enableDevice: (request: Readonly<EnableDeviceRequest>) => Promise<Device>;
     /**
-     * Disable a device.
+     * Disable a device. Disable an existing device, specified by its device ID.
      *
      * @param request - The request {@link DisableDeviceRequest}
      * @returns A Promise of Device
      */
     disableDevice: (request: Readonly<DisableDeviceRequest>) => Promise<Device>;
     /**
-     * Renew a device certificate.
+     * Renew a device certificate. Renew the certificate of an existing device,
+     * specified by its device ID.
      *
      * @param request - The request {@link RenewDeviceCertificateRequest}
      * @returns A Promise of RenewDeviceCertificateResponse
      */
     renewDeviceCertificate: (request: Readonly<RenewDeviceCertificateRequest>) => Promise<RenewDeviceCertificateResponse>;
     /**
-     * Set a custom certificate on a device.
+     * Set a custom certificate on a device. Switch the existing certificate of a
+     * given device with an EM-encoded custom certificate.
      *
      * @param request - The request {@link SetDeviceCertificateRequest}
      * @returns A Promise of SetDeviceCertificateResponse
      */
     setDeviceCertificate: (request: Readonly<SetDeviceCertificateRequest>) => Promise<SetDeviceCertificateResponse>;
     /**
-     * Get a device's certificate.
+     * Get a device's certificate. Get information for a particular PEM-encoded
+     * certificate, specified by the device ID. The response returns full details
+     * of the device, including its type of certificate.
      *
      * @param request - The request {@link GetDeviceCertificateRequest}
      * @returns A Promise of GetDeviceCertificateResponse
      */
     getDeviceCertificate: (request: Readonly<GetDeviceCertificateRequest>) => Promise<GetDeviceCertificateResponse>;
     /**
-     * Remove a device.
+     * Remove a device. Remove a specific device from the specific Hub it is
+     * attached to.
      *
      * @param request - The request {@link DeleteDeviceRequest}
      */
     deleteDevice: (request: Readonly<DeleteDeviceRequest>) => Promise<void>;
     /**
-     * Get a device's metrics.
+     * Get a device's metrics. Get the metrics of an existing device, specified by
+     * its device ID.
      *
      * @deprecated
      * @param request - The request {@link GetDeviceMetricsRequest}
@@ -13390,7 +13464,9 @@ declare class API$e extends API$q {
     getDeviceMetrics: (request: Readonly<GetDeviceMetricsRequest>) => Promise<GetDeviceMetricsResponse>;
     protected pageOfListRoutes: (request?: Readonly<ListRoutesRequest$1>) => Promise<ListRoutesResponse$1>;
     /**
-     * List routes.
+     * List routes. List all routes in the specified region. By default, returned
+     * routes are ordered by creation date in ascending order, though this can be
+     * modified via the `order_by` field.
      *
      * @param request - The request {@link ListRoutesRequest}
      * @returns A Promise of ListRoutesResponse
@@ -13400,15 +13476,15 @@ declare class API$e extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<RouteSummary[], void, void>;
     };
     /**
-     * Create a route. Multiple route kinds can be created:
+     * Create a route. Multiple kinds of routes can be created, such as:
      *
-     * - Database Route. Create a route that will record subscribed MQTT messages
+     * - Database Route Create a route that will record subscribed MQTT messages
      *   into your database. <b>You need to manage the database by yourself</b>.
      * - REST Route. Create a route that will call a REST API on received subscribed
      *   MQTT messages.
      * - S3 Routes. Create a route that will put subscribed MQTT messages into an S3
-     *   bucket. You need to create the bucket yourself and grant us write access.
-     *   The grant can be done with s3cmd (`s3cmd setacl s3://&lt;my-bucket&gt;
+     *   bucket. You need to create the bucket yourself and grant write access.
+     *   Granting can be done with s3cmd (`s3cmd setacl s3://&lt;my-bucket&gt;
      *   --acl-grant=write:555c69c3-87d0-4bf8-80f1-99a2f757d031:555c69c3-87d0-4bf8-80f1-99a2f757d031`).
      *
      * @param request - The request {@link CreateRouteRequest}
@@ -13416,28 +13492,32 @@ declare class API$e extends API$q {
      */
     createRoute: (request: Readonly<CreateRouteRequest$1>) => Promise<Route$1>;
     /**
-     * Update a route.
+     * Update a route. Update the parameters of an existing route, specified by
+     * its route ID.
      *
      * @param request - The request {@link UpdateRouteRequest}
      * @returns A Promise of Route
      */
     updateRoute: (request: Readonly<UpdateRouteRequest$1>) => Promise<Route$1>;
     /**
-     * Get a route.
+     * Get a route. Get information for a particular route, specified by the route
+     * ID. The response returns full details of the route, including its type, the
+     * topic it subscribes to and its configuration.
      *
      * @param request - The request {@link GetRouteRequest}
      * @returns A Promise of Route
      */
     getRoute: (request: Readonly<GetRouteRequest$1>) => Promise<Route$1>;
     /**
-     * Delete a route.
+     * Delete a route. Delete an existing route, specified by its route ID.
+     * Deleting a route is permanent, and cannot be undone.
      *
      * @param request - The request {@link DeleteRouteRequest}
      */
     deleteRoute: (request: Readonly<DeleteRouteRequest$1>) => Promise<void>;
     protected pageOfListNetworks: (request?: Readonly<ListNetworksRequest>) => Promise<ListNetworksResponse>;
     /**
-     * List the Networks.
+     * List the networks.
      *
      * @param request - The request {@link ListNetworksRequest}
      * @returns A Promise of ListNetworksResponse
@@ -13447,21 +13527,26 @@ declare class API$e extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Network[], void, void>;
     };
     /**
-     * Create a new Network.
+     * Create a new network. Create a new network for an existing hub. Beside the
+     * default network, you can add networks for different data providers.
+     * Possible network types are Sigfox and REST.
      *
      * @param request - The request {@link CreateNetworkRequest}
      * @returns A Promise of CreateNetworkResponse
      */
     createNetwork: (request: Readonly<CreateNetworkRequest>) => Promise<CreateNetworkResponse>;
     /**
-     * Retrieve a specific Network.
+     * Retrieve a specific network. Retrieve an existing network, specified by its
+     * network ID. The response returns full details of the network, including its
+     * type, the topic prefix and its endpoint.
      *
      * @param request - The request {@link GetNetworkRequest}
      * @returns A Promise of Network
      */
     getNetwork: (request: Readonly<GetNetworkRequest>) => Promise<Network>;
     /**
-     * Delete a Network.
+     * Delete a Network. Delete an existing network, specified by its network ID.
+     * Deleting a network is permanent, and cannot be undone.
      *
      * @param request - The request {@link DeleteNetworkRequest}
      */
@@ -14350,7 +14435,8 @@ type CreateClusterRequest$2 = {
     /**
      * Autoscaler config for the cluster. This field allows to specify some
      * configuration for the autoscaler, which is an implementation of the
-     * [cluster-autoscaler](https://github.com/kubernetes/autoscaler/tree/master/cluster-autoscaler/).
+     * cluster-autoscaler
+     * (https://github.com/kubernetes/autoscaler/tree/master/cluster-autoscaler/).
      */
     autoscalerConfig?: CreateClusterRequestAutoscalerConfig$1;
     /**
@@ -14737,7 +14823,7 @@ type GetClusterKubeConfigRequest = {
     clusterId: string;
 };
 
-/** Kapsule API. */
+/** Kubernetes API. */
 declare class API$d extends API$q {
     /** Lists the available regions of the API. */
     static readonly LOCALITIES: Region[];
@@ -19916,11 +20002,7 @@ type CreateCredentialRequest = {
     namespaceId: string;
     /** Name of the credentials. */
     name?: string;
-    /**
-     * Permissions associated with these credentials.
-     *
-     * One-of ('optionalPermissions'): at most one of 'permissions' could be set.
-     */
+    /** Permissions associated with these credentials. */
     permissions?: Permissions;
 };
 type DeleteCredentialRequest = {
@@ -19957,11 +20039,7 @@ type UpdateCredentialRequest = {
     credentialId: string;
     /** Name of the credentials. */
     name?: string;
-    /**
-     * Permissions associated with these credentials.
-     *
-     * One-of ('optionalPermissions'): at most one of 'permissions' could be set.
-     */
+    /** Permissions associated with these credentials. */
     permissions?: Permissions;
 };
 type GetCredentialRequest = {
@@ -19975,10 +20053,10 @@ type GetCredentialRequest = {
 };
 
 /**
- * MnQ API (beta).
+ * Messaging and Queuing API.
  *
- * This API allows you to manage Scaleway Messaging and Queueing brokers. MnQ
- * API (beta).
+ * This API allows you to manage Scaleway Messaging and Queueing brokers.
+ * Messaging and Queuing API.
  */
 declare class API$9 extends API$q {
     /** Lists the available regions of the API. */
@@ -22449,7 +22527,7 @@ interface AvailableClusterSetting {
     minValue?: number;
     /** Optional validation rule of the setting. */
     regex?: string;
-    /** Whether or not the setting is deprecated. */
+    /** Defines whether or not the setting is deprecated. */
     deprecated: boolean;
 }
 /** Cluster. */
@@ -22474,7 +22552,7 @@ interface Cluster {
     createdAt?: Date;
     /** Update date (Format ISO 8601). */
     updatedAt?: Date;
-    /** Whether or not TLS is enabled. */
+    /** Defines whether or not TLS is enabled. */
     tlsEnabled: boolean;
     /** List of Database Instance settings. */
     clusterSettings: ClusterSetting[];
@@ -22612,9 +22690,9 @@ interface NodeType {
     vcpus: number;
     /** Quantity of RAM. */
     memory: number;
-    /** The node type is currently disabled. */
+    /** Defines whether node type is currently disabled or not. */
     disabled: boolean;
-    /** The node type is currently in beta. */
+    /** Defines whether node type is currently in beta. */
     beta: boolean;
     /** Zone of the node type. */
     zone: Zone;
@@ -22643,7 +22721,7 @@ interface SetEndpointsResponse {
 type CreateClusterRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
     zone?: Zone;
-    /** The Project ID in which to create the Database Instance. */
+    /** Project ID in which to create the Database Instance. */
     projectId?: string;
     /** Name of the Database Instance. */
     name?: string;
@@ -22668,7 +22746,7 @@ type CreateClusterRequest = {
      * the cluster will be publicly exposed by default.
      */
     endpoints?: EndpointSpec[];
-    /** Whether or not TLS is enabled. */
+    /** Defines whether or not TLS is enabled. */
     tlsEnabled: boolean;
     /** List of advanced settings to be set upon Database Instance initialization. */
     clusterSettings?: ClusterSetting[];
@@ -22759,7 +22837,7 @@ type GetClusterMetricsRequest = {
 type ListNodeTypesRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
     zone?: Zone;
-    /** Whether or not to include disabled types. */
+    /** Defines whether or not to include disabled types. */
     includeDisabledTypes: boolean;
     page?: number;
     pageSize?: number;
@@ -22767,11 +22845,11 @@ type ListNodeTypesRequest = {
 type ListClusterVersionsRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
     zone?: Zone;
-    /** Whether or not to include disabled Redis™ engine versions. */
+    /** Defines whether or not to include disabled Redis™ engine versions. */
     includeDisabled: boolean;
-    /** Whether or not to include beta Redis™ engine versions. */
+    /** Defines whether or not to include beta Redis™ engine versions. */
     includeBeta: boolean;
-    /** Whether or not to include deprecated Redis™ engine versions. */
+    /** Defines whether or not to include deprecated Redis™ engine versions. */
     includeDeprecated: boolean;
     /** List Redis™ engine versions that match a given name pattern. */
     version?: string;
@@ -23258,20 +23336,20 @@ type NamespaceStatus = 'unknown' | 'ready' | 'deleting' | 'error' | 'locked';
 type TagStatus = 'unknown' | 'ready' | 'deleting' | 'error' | 'locked';
 /** Image. */
 interface Image {
-    /** The unique ID of the Image. */
+    /** UUID of the image. */
     id: string;
-    /** The Image name, unique in a namespace. */
+    /** Name of the image, it must be unique within the namespace. */
     name: string;
-    /** The unique ID of the Namespace the image belongs to. */
+    /** UUID of the namespace the image belongs to. */
     namespaceId: string;
-    /** The status of the image. */
+    /** Status of the image. */
     status: ImageStatus;
     /** Details of the image status. */
     statusMessage?: string;
     /**
-     * A `public` image is pullable from internet without authentication, opposed
-     * to a `private` image. `inherit` will use the namespace `is_public`
-     * parameter.
+     * Set to `public` to allow the image to be pulled without authentication.
+     * Else, set to `private`. Set to `inherit` to keep the same visibility
+     * configuration as the namespace.
      */
     visibility: ImageVisibility;
     /**
@@ -23281,39 +23359,39 @@ interface Image {
      * counted twice.
      */
     size: number;
-    /** Creation date. */
+    /** Date and time of image creation. */
     createdAt?: Date;
-    /** Last modification date, from the user or the service. */
+    /** Date and time of last update. */
     updatedAt?: Date;
     /** List of docker tags of the image. */
     tags: string[];
 }
 /** List images response. */
 interface ListImagesResponse {
-    /** Paginated list of images matching filters. */
+    /** Paginated list of images that match the selected filters. */
     images: Image[];
-    /** Total number of images matching filters. */
+    /** Total number of images that match the selected filters. */
     totalCount: number;
 }
 /** List namespaces response. */
 interface ListNamespacesResponse {
-    /** Paginated list of namespaces matching filters. */
+    /** Paginated list of namespaces that match the selected filters. */
     namespaces: Namespace[];
-    /** Total number of namespaces matching filters. */
+    /** Total number of namespaces that match the selected filters. */
     totalCount: number;
 }
 /** List tags response. */
 interface ListTagsResponse {
-    /** Paginated list of tags matching filters. */
+    /** Paginated list of tags that match the selected filters. */
     tags: Tag[];
-    /** Total number of tags matching filters. */
+    /** Total number of tags that match the selected filters. */
     totalCount: number;
 }
 /** Namespace. */
 interface Namespace {
-    /** The unique ID of the namespace. */
+    /** UUID of the namespace. */
     id: string;
-    /** The name of the namespace, unique in a region accross all organizations. */
+    /** Name of the namespace, unique in a region accross all organizations. */
     name: string;
     /** Description of the namespace. */
     description: string;
@@ -23327,16 +23405,16 @@ interface Namespace {
     statusMessage: string;
     /** Endpoint reachable by docker. */
     endpoint: string;
-    /** Namespace visibility policy. */
+    /** Defines whether or not namespace is public. */
     isPublic: boolean;
     /**
      * Total size of the namespace, calculated as the sum of the size of all
      * images in the namespace.
      */
     size: number;
-    /** Creation date. */
+    /** Date and time of creation. */
     createdAt?: Date;
-    /** Last modification date, from the user or the service. */
+    /** Date and time of last update. */
     updatedAt?: Date;
     /** Number of images in the namespace. */
     imageCount: number;
@@ -23345,22 +23423,22 @@ interface Namespace {
 }
 /** Tag. */
 interface Tag {
-    /** The unique ID of the tag. */
+    /** UUID of the tag. */
     id: string;
-    /** Tag name, unique for an image. */
+    /** Tag name, unique to an image. */
     name: string;
-    /** Image ID this tag belongs to. */
+    /** Image ID the of the image the tag belongs to. */
     imageId: string;
     /** Tag status. */
     status: TagStatus;
     /**
-     * Hash of the tag actual content. Several tags of a same image may have the
-     * same digest.
+     * Hash of the tag content. Several tags of a same image may have the same
+     * digest.
      */
     digest: string;
-    /** Creation date. */
+    /** Date and time of creation. */
     createdAt?: Date;
-    /** Last modification date, from the user or the service. */
+    /** Date and time of last update. */
     updatedAt?: Date;
 }
 type ListNamespacesRequest = {
@@ -23376,7 +23454,11 @@ type ListNamespacesRequest = {
      * display.
      */
     pageSize?: number;
-    /** Field by which to order the display of Images. */
+    /**
+     * Criteria to use when ordering namespace listings. Possible values are
+     * `created_at_asc`, `created_at_desc`, `name_asc`, `name_desc`, `region`,
+     * `status_asc` and `status_desc`. The default value is `created_at_asc`.
+     */
     orderBy?: ListNamespacesRequestOrderBy;
     /** Filter by Organization ID. */
     organizationId?: string;
@@ -23391,7 +23473,7 @@ type GetNamespaceRequest = {
      * config.
      */
     region?: Region;
-    /** The unique ID of the Namespace. */
+    /** UUID of the namespace. */
     namespaceId: string;
 };
 type CreateNamespaceRequest = {
@@ -23400,25 +23482,25 @@ type CreateNamespaceRequest = {
      * config.
      */
     region?: Region;
-    /** Define a namespace name. */
+    /** Name of the namespace. */
     name?: string;
-    /** Define a description. */
+    /** Description of the namespace. */
     description: string;
     /**
-     * @deprecated Assign the namespace owner (deprecated).
+     * @deprecated Namespace owner (deprecated).
      *
      *   One-of ('projectIdentifier'): at most one of 'organizationId', 'projectId'
      *   could be set.
      */
     organizationId?: string;
     /**
-     * Assign the namespace to a project ID.
+     * Project ID on which the namespace will be created.
      *
      * One-of ('projectIdentifier'): at most one of 'organizationId', 'projectId'
      * could be set.
      */
     projectId?: string;
-    /** Define the default visibility policy. */
+    /** Defines whether or not namespace is public. */
     isPublic: boolean;
 };
 type UpdateNamespaceRequest = {
@@ -23427,11 +23509,11 @@ type UpdateNamespaceRequest = {
      * config.
      */
     region?: Region;
-    /** Namespace ID to update. */
+    /** ID of the namespace to update. */
     namespaceId: string;
-    /** Define a description. */
+    /** Namespace description. */
     description?: string;
-    /** Define the default visibility policy. */
+    /** Defines whether or not the namespace is public. */
     isPublic?: boolean;
 };
 type DeleteNamespaceRequest = {
@@ -23440,7 +23522,7 @@ type DeleteNamespaceRequest = {
      * config.
      */
     region?: Region;
-    /** The unique ID of the Namespace. */
+    /** UUID of the namespace. */
     namespaceId: string;
 };
 type ListImagesRequest = {
@@ -23456,11 +23538,15 @@ type ListImagesRequest = {
      * display.
      */
     pageSize?: number;
-    /** Field by which to order the display of Images. */
+    /**
+     * Criteria to use when ordering image listings. Possible values are
+     * `created_at_asc`, `created_at_desc`, `name_asc`, `name_desc`, `region`,
+     * `status_asc` and `status_desc`. The default value is `created_at_asc`.
+     */
     orderBy?: ListImagesRequestOrderBy;
-    /** Filter by the Namespace ID. */
+    /** Filter by the namespace ID. */
     namespaceId?: string;
-    /** Filter by the Image name (exact match). */
+    /** Filter by the image name (exact match). */
     name?: string;
     /** Filter by Organization ID. */
     organizationId?: string;
@@ -23473,7 +23559,7 @@ type GetImageRequest = {
      * config.
      */
     region?: Region;
-    /** The unique ID of the Image. */
+    /** UUID of the image. */
     imageId: string;
 };
 type UpdateImageRequest = {
@@ -23482,12 +23568,12 @@ type UpdateImageRequest = {
      * config.
      */
     region?: Region;
-    /** Image ID to update. */
+    /** ID of the image to update. */
     imageId: string;
     /**
-     * A `public` image is pullable from internet without authentication, opposed
-     * to a `private` image. `inherit` will use the namespace `is_public`
-     * parameter.
+     * Set to `public` to allow the image to be pulled without authentication.
+     * Else, set to `private`. Set to `inherit` to keep the same visibility
+     * configuration as the namespace.
      */
     visibility?: ImageVisibility;
 };
@@ -23497,7 +23583,7 @@ type DeleteImageRequest = {
      * config.
      */
     region?: Region;
-    /** The unique ID of the Image. */
+    /** UUID of the image. */
     imageId: string;
 };
 type ListTagsRequest = {
@@ -23506,7 +23592,7 @@ type ListTagsRequest = {
      * config.
      */
     region?: Region;
-    /** The unique ID of the image. */
+    /** UUID of the image. */
     imageId: string;
     /** A positive integer to choose the page to display. */
     page?: number;
@@ -23515,7 +23601,11 @@ type ListTagsRequest = {
      * display.
      */
     pageSize?: number;
-    /** Field by which to order the display of Images. */
+    /**
+     * Criteria to use when ordering tag listings. Possible values are
+     * `created_at_asc`, `created_at_desc`, `name_asc`, `name_desc`, `region`,
+     * `status_asc` and `status_desc`. The default value is `created_at_asc`.
+     */
     orderBy?: ListTagsRequestOrderBy;
     /** Filter by the tag name (exact match). */
     name?: string;
@@ -23526,7 +23616,7 @@ type GetTagRequest = {
      * config.
      */
     region?: Region;
-    /** The unique ID of the Tag. */
+    /** UUID of the tag. */
     tagId: string;
 };
 type DeleteTagRequest = {
@@ -23535,7 +23625,7 @@ type DeleteTagRequest = {
      * config.
      */
     region?: Region;
-    /** The unique ID of the tag. */
+    /** UUID of the tag. */
     tagId: string;
     /**
      * If two tags share the same digest the deletion will fail unless this
@@ -23544,17 +23634,17 @@ type DeleteTagRequest = {
     force: boolean;
 };
 
-/**
- * Registry API.
- *
- * Container registry API. Registry API.
- */
+/** Container Registry API. */
 declare class API$6 extends API$q {
     /** Lists the available regions of the API. */
     static readonly LOCALITIES: Region[];
     protected pageOfListNamespaces: (request?: Readonly<ListNamespacesRequest>) => Promise<ListNamespacesResponse>;
     /**
-     * List all your namespaces.
+     * List namespaces. List all namespaces in a specified region. By default, the
+     * namespaces listed are ordered by creation date in ascending order. This can
+     * be modified via the order_by field. You can also define additional
+     * parameters for your query, such as the `instance_id` and `project_id`
+     * parameters.
      *
      * @param request - The request {@link ListNamespacesRequest}
      * @returns A Promise of ListNamespacesResponse
@@ -23564,7 +23654,10 @@ declare class API$6 extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Namespace[], void, void>;
     };
     /**
-     * Get a namespace. Get the namespace associated with the given id.
+     * Get a namespace. Retrieve information about a given namespace, specified by
+     * its `namespace_id` and region. Full details about the namespace, such as
+     * `description`, `project_id`, `status`, `endpoint`, `is_public`, `size`, and
+     * `image_count` are returned in the response.
      *
      * @param request - The request {@link GetNamespaceRequest}
      * @returns A Promise of Namespace
@@ -23579,23 +23672,28 @@ declare class API$6 extends API$q {
      */
     waitForNamespace: (request: Readonly<GetNamespaceRequest>, options?: Readonly<WaitForOptions<Namespace>>) => Promise<Namespace>;
     /**
-     * Create a new namespace.
+     * Create a namespace. Create a new Container Registry namespace. You must
+     * specify the namespace name and region in which you want it to be created.
+     * Optionally, you can specify the `project_id` and `is_public` in the request
+     * payload.
      *
      * @param request - The request {@link CreateNamespaceRequest}
      * @returns A Promise of Namespace
      */
     createNamespace: (request: Readonly<CreateNamespaceRequest>) => Promise<Namespace>;
     /**
-     * Update an existing namespace. Update the namespace associated with the
-     * given id.
+     * Update a namespace. Update the parameters of a given namespace, specified
+     * by its `namespace_id` and `region`. You can update the `description` and
+     * `is_public` parameters.
      *
      * @param request - The request {@link UpdateNamespaceRequest}
      * @returns A Promise of Namespace
      */
     updateNamespace: (request: Readonly<UpdateNamespaceRequest>) => Promise<Namespace>;
     /**
-     * Delete an existing namespace. Delete the namespace associated with the
-     * given id.
+     * Delete a namespace. Delete a given namespace. You must specify, in the
+     * endpoint, the `region` and `namespace_id` parameters of the namespace you
+     * want to delete.
      *
      * @param request - The request {@link DeleteNamespaceRequest}
      * @returns A Promise of Namespace
@@ -23603,7 +23701,10 @@ declare class API$6 extends API$q {
     deleteNamespace: (request: Readonly<DeleteNamespaceRequest>) => Promise<Namespace>;
     protected pageOfListImages: (request?: Readonly<ListImagesRequest>) => Promise<ListImagesResponse>;
     /**
-     * List all your images.
+     * List images. List all images in a specified region. By default, the images
+     * listed are ordered by creation date in ascending order. This can be
+     * modified via the order_by field. You can also define additional parameters
+     * for your query, such as the `namespace_id` and `project_id` parameters.
      *
      * @param request - The request {@link ListImagesRequest}
      * @returns A Promise of ListImagesResponse
@@ -23613,7 +23714,10 @@ declare class API$6 extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Image[], void, void>;
     };
     /**
-     * Get a image. Get the image associated with the given id.
+     * Get an image. Retrieve information about a given container image, specified
+     * by its `image_id` and region. Full details about the image, such as `name`,
+     * `namespace_id`, `status`, `visibility`, and `size` are returned in the
+     * response.
      *
      * @param request - The request {@link GetImageRequest}
      * @returns A Promise of Image
@@ -23628,14 +23732,16 @@ declare class API$6 extends API$q {
      */
     waitForImage: (request: Readonly<GetImageRequest>, options?: Readonly<WaitForOptions<Image>>) => Promise<Image>;
     /**
-     * Update an existing image. Update the image associated with the given id.
+     * Update an image. Update the parameters of a given image, specified by its
+     * `image_id` and `region`. You can update the `visibility` parameter.
      *
      * @param request - The request {@link UpdateImageRequest}
      * @returns A Promise of Image
      */
     updateImage: (request: Readonly<UpdateImageRequest>) => Promise<Image>;
     /**
-     * Delete an image. Delete the image associated with the given id.
+     * Delete an image. Delete a given image. You must specify, in the endpoint,
+     * the `region` and `image_id` parameters of the image you want to delete.
      *
      * @param request - The request {@link DeleteImageRequest}
      * @returns A Promise of Image
@@ -23643,7 +23749,10 @@ declare class API$6 extends API$q {
     deleteImage: (request: Readonly<DeleteImageRequest>) => Promise<Image>;
     protected pageOfListTags: (request: Readonly<ListTagsRequest>) => Promise<ListTagsResponse>;
     /**
-     * List all your tags.
+     * List tags. List all tags for a given image, specified by region. By
+     * default, the tags listed are ordered by creation date in ascending order.
+     * This can be modified via the order_by field. You can also define additional
+     * parameters for your query, such as the `name`.
      *
      * @param request - The request {@link ListTagsRequest}
      * @returns A Promise of ListTagsResponse
@@ -23653,7 +23762,9 @@ declare class API$6 extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Tag[], void, void>;
     };
     /**
-     * Get a tag. Get the tag associated with the given id.
+     * Get a tag. Retrieve information about a given image tag, specified by its
+     * `tag_id` and region. Full details about the tag, such as `name`,
+     * `image_id`, `status`, and `digest` are returned in the response.
      *
      * @param request - The request {@link GetTagRequest}
      * @returns A Promise of Tag
@@ -23668,7 +23779,8 @@ declare class API$6 extends API$q {
      */
     waitForTag: (request: Readonly<GetTagRequest>, options?: Readonly<WaitForOptions<Tag>>) => Promise<Tag>;
     /**
-     * Delete a tag. Delete the tag associated with the given id.
+     * Delete a tag. Delete a given image tag. You must specify, in the endpoint,
+     * the `region` and `tag_id` parameters of the tag you want to delete.
      *
      * @param request - The request {@link DeleteTagRequest}
      * @returns A Promise of Tag
@@ -23766,8 +23878,8 @@ interface AccessSecretVersionResponse {
     /** 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.
+     * The CRC32 checksum of the data as a base-10 integer. This field is only
+     * available if a CRC32 was supplied during the creation of the version.
      */
     dataCrc32?: number;
 }
@@ -23958,7 +24070,7 @@ type CreateSecretVersionRequest = {
     disablePrevious?: boolean;
     /**
      * Options to generate a password. Optional. If specified, a random password
-     * will be generated. The data and data_crc32 fields must be empty. By
+     * 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.
      *
@@ -23968,9 +24080,9 @@ type CreateSecretVersionRequest = {
     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
+     * specified, 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;
@@ -24117,10 +24229,10 @@ type DestroySecretVersionRequest = {
 };
 
 /**
- * Secret Manager API documentation.
+ * Secret Manager API.
  *
- * This API allows you to conveniently store, access and share sensitive data.
- * Secret Manager API documentation.
+ * Secret Manager API. This API allows you to conveniently store, access and
+ * share sensitive data.
  */
 declare class API$5 extends API$q {
     /** Lists the available regions of the API. */
@@ -24722,8 +24834,8 @@ interface Statistics {
      */
     failedCount: number;
     /**
-     * Number of emails in the final `canceled` state. This meanns emails that
-     * have been canceled upon request.
+     * Number of emails in the final `canceled` state. This means emails that have
+     * been canceled upon request.
      */
     canceledCount: number;
 }
@@ -24875,11 +24987,7 @@ type CheckDomainRequest = {
     domainId: string;
 };
 
-/**
- * Transactional Email API documentation.
- *
- * Tem. Transactional Email API documentation.
- */
+/** Transactional Email API. */
 declare class API$3 extends API$q {
     /** Lists the available regions of the API. */
     static readonly LOCALITIES: Region[];