@scaleway/sdk 2.53.0 → 2.55.0

package/dist/api/applesilicon/v1alpha1/api.gen.cjs

@@ -219,5 +219,26 @@ class API extends api.API {
     },
     marshalling_gen.unmarshalServer
   );
+  startConnectivityDiagnostic = (request) => this.client.fetch(
+    {
+      body: JSON.stringify(
+        marshalling_gen.marshalStartConnectivityDiagnosticRequest(
+          request,
+          this.client.settings
+        )
+      ),
+      headers: jsonContentHeaders,
+      method: "POST",
+      path: `/apple-silicon/v1alpha1/zones/${marshalling.validatePathParam("zone", request.zone ?? this.client.settings.defaultZone)}/connectivity-diagnostics`
+    },
+    marshalling_gen.unmarshalStartConnectivityDiagnosticResponse
+  );
+  getConnectivityDiagnostic = (request) => this.client.fetch(
+    {
+      method: "GET",
+      path: `/apple-silicon/v1alpha1/zones/${marshalling.validatePathParam("zone", request.zone ?? this.client.settings.defaultZone)}/connectivity-diagnostics/${marshalling.validatePathParam("diagnosticId", request.diagnosticId)}`
+    },
+    marshalling_gen.unmarshalConnectivityDiagnostic
+  );
 }
 exports.API = API;

package/dist/api/applesilicon/v1alpha1/api.gen.d.ts

@@ -1,6 +1,6 @@
 import { API as ParentAPI } from '../../../bridge';
 import type { WaitForOptions, Zone } from '../../../bridge';
-import type { CreateServerRequest, DeleteServerRequest, GetOSRequest, GetServerRequest, GetServerTypeRequest, ListOSRequest, ListOSResponse, ListServerTypesRequest, ListServerTypesResponse, ListServersRequest, ListServersResponse, OS, RebootServerRequest, ReinstallServerRequest, Server, ServerType, UpdateServerRequest } from './types.gen';
+import type { ConnectivityDiagnostic, CreateServerRequest, DeleteServerRequest, GetConnectivityDiagnosticRequest, GetOSRequest, GetServerRequest, GetServerTypeRequest, ListOSRequest, ListOSResponse, ListServerTypesRequest, ListServerTypesResponse, ListServersRequest, ListServersResponse, OS, RebootServerRequest, ReinstallServerRequest, Server, ServerType, StartConnectivityDiagnosticRequest, StartConnectivityDiagnosticResponse, UpdateServerRequest } from './types.gen';
 /**
  * Apple silicon API.
  *
@@ -120,4 +120,6 @@ export declare class API extends ParentAPI {
      * @returns A Promise of Server
      */
     reinstallServer: (request: Readonly<ReinstallServerRequest>) => Promise<Server>;
+    startConnectivityDiagnostic: (request: Readonly<StartConnectivityDiagnosticRequest>) => Promise<StartConnectivityDiagnosticResponse>;
+    getConnectivityDiagnostic: (request: Readonly<GetConnectivityDiagnosticRequest>) => Promise<ConnectivityDiagnostic>;
 }

package/dist/api/applesilicon/v1alpha1/api.gen.js

@@ -4,7 +4,7 @@ import { validatePathParam, urlParams } from "../../../helpers/marshalling.js";
 import "../../../vendor/base64/index.js";
 import { enrichForPagination } from "../../../scw/fetch/resource-paginator.js";
 import { SERVER_TRANSIENT_STATUSES } from "./content.gen.js";
-import { unmarshalListServerTypesResponse, unmarshalServerType, marshalCreateServerRequest, unmarshalServer, unmarshalListServersResponse, unmarshalListOSResponse, unmarshalOS, marshalUpdateServerRequest, marshalReinstallServerRequest } from "./marshalling.gen.js";
+import { unmarshalListServerTypesResponse, unmarshalServerType, marshalCreateServerRequest, unmarshalServer, unmarshalListServersResponse, unmarshalListOSResponse, unmarshalOS, marshalUpdateServerRequest, marshalReinstallServerRequest, marshalStartConnectivityDiagnosticRequest, unmarshalStartConnectivityDiagnosticResponse, unmarshalConnectivityDiagnostic } from "./marshalling.gen.js";
 const jsonContentHeaders = {
   "Content-Type": "application/json; charset=utf-8"
 };
@@ -217,6 +217,27 @@ class API extends API$1 {
     },
     unmarshalServer
   );
+  startConnectivityDiagnostic = (request) => this.client.fetch(
+    {
+      body: JSON.stringify(
+        marshalStartConnectivityDiagnosticRequest(
+          request,
+          this.client.settings
+        )
+      ),
+      headers: jsonContentHeaders,
+      method: "POST",
+      path: `/apple-silicon/v1alpha1/zones/${validatePathParam("zone", request.zone ?? this.client.settings.defaultZone)}/connectivity-diagnostics`
+    },
+    unmarshalStartConnectivityDiagnosticResponse
+  );
+  getConnectivityDiagnostic = (request) => this.client.fetch(
+    {
+      method: "GET",
+      path: `/apple-silicon/v1alpha1/zones/${validatePathParam("zone", request.zone ?? this.client.settings.defaultZone)}/connectivity-diagnostics/${validatePathParam("diagnosticId", request.diagnosticId)}`
+    },
+    unmarshalConnectivityDiagnostic
+  );
 }
 export {
   API

package/dist/api/applesilicon/v1alpha1/index.gen.d.ts

@@ -1,3 +1,3 @@
 export { API } from './api.gen';
 export * from './content.gen';
-export type { CreateServerRequest, DeleteServerRequest, GetOSRequest, GetServerRequest, GetServerTypeRequest, ListOSRequest, ListOSResponse, ListServerTypesRequest, ListServerTypesResponse, ListServersRequest, ListServersRequestOrderBy, ListServersResponse, OS, RebootServerRequest, ReinstallServerRequest, Server, ServerStatus, ServerType, ServerTypeCPU, ServerTypeDisk, ServerTypeGPU, ServerTypeMemory, ServerTypeNetwork, ServerTypeStock, UpdateServerRequest, } from './types.gen';
+export type { ConnectivityDiagnostic, ConnectivityDiagnosticActionType, ConnectivityDiagnosticDiagnosticStatus, ConnectivityDiagnosticServerHealth, CreateServerRequest, DeleteServerRequest, GetConnectivityDiagnosticRequest, GetOSRequest, GetServerRequest, GetServerTypeRequest, ListOSRequest, ListOSResponse, ListServerTypesRequest, ListServerTypesResponse, ListServersRequest, ListServersRequestOrderBy, ListServersResponse, OS, RebootServerRequest, ReinstallServerRequest, Server, ServerStatus, ServerType, ServerTypeCPU, ServerTypeDisk, ServerTypeGPU, ServerTypeMemory, ServerTypeNetwork, ServerTypeStock, StartConnectivityDiagnosticRequest, StartConnectivityDiagnosticResponse, UpdateServerRequest, } from './types.gen';

package/dist/api/applesilicon/v1alpha1/marshalling.gen.cjs

@@ -121,6 +121,36 @@ const unmarshalServer = (data) => {
     zone: data.zone
   };
 };
+const unmarshalConnectivityDiagnosticServerHealth = (data) => {
+  if (!json.isJSONObject(data)) {
+    throw new TypeError(
+      `Unmarshalling the type 'ConnectivityDiagnosticServerHealth' failed as data isn't a dictionary.`
+    );
+  }
+  return {
+    isAgentAlive: data.is_agent_alive,
+    isMdmAlive: data.is_mdm_alive,
+    isServerAlive: data.is_server_alive,
+    isSshPortUp: data.is_ssh_port_up,
+    isVncPortUp: data.is_vnc_port_up,
+    lastCheckinDate: marshalling.unmarshalDate(data.last_checkin_date)
+  };
+};
+const unmarshalConnectivityDiagnostic = (data) => {
+  if (!json.isJSONObject(data)) {
+    throw new TypeError(
+      `Unmarshalling the type 'ConnectivityDiagnostic' failed as data isn't a dictionary.`
+    );
+  }
+  return {
+    errorMessage: data.error_message,
+    healthDetails: data.health_details ? unmarshalConnectivityDiagnosticServerHealth(data.health_details) : void 0,
+    id: data.id,
+    isHealthy: data.is_healthy,
+    status: data.status,
+    supportedActions: data.supported_actions
+  };
+};
 const unmarshalListOSResponse = (data) => {
   if (!json.isJSONObject(data)) {
     throw new TypeError(
@@ -153,6 +183,16 @@ const unmarshalListServersResponse = (data) => {
     totalCount: data.total_count
   };
 };
+const unmarshalStartConnectivityDiagnosticResponse = (data) => {
+  if (!json.isJSONObject(data)) {
+    throw new TypeError(
+      `Unmarshalling the type 'StartConnectivityDiagnosticResponse' failed as data isn't a dictionary.`
+    );
+  }
+  return {
+    diagnosticId: data.diagnostic_id
+  };
+};
 const marshalCreateServerRequest = (request, defaults) => ({
   name: request.name || randomName("as"),
   os_id: request.osId,
@@ -162,16 +202,22 @@ const marshalCreateServerRequest = (request, defaults) => ({
 const marshalReinstallServerRequest = (request, defaults) => ({
   os_id: request.osId
 });
+const marshalStartConnectivityDiagnosticRequest = (request, defaults) => ({
+  server_id: request.serverId
+});
 const marshalUpdateServerRequest = (request, defaults) => ({
   name: request.name,
   schedule_deletion: request.scheduleDeletion
 });
 exports.marshalCreateServerRequest = marshalCreateServerRequest;
 exports.marshalReinstallServerRequest = marshalReinstallServerRequest;
+exports.marshalStartConnectivityDiagnosticRequest = marshalStartConnectivityDiagnosticRequest;
 exports.marshalUpdateServerRequest = marshalUpdateServerRequest;
+exports.unmarshalConnectivityDiagnostic = unmarshalConnectivityDiagnostic;
 exports.unmarshalListOSResponse = unmarshalListOSResponse;
 exports.unmarshalListServerTypesResponse = unmarshalListServerTypesResponse;
 exports.unmarshalListServersResponse = unmarshalListServersResponse;
 exports.unmarshalOS = unmarshalOS;
 exports.unmarshalServer = unmarshalServer;
 exports.unmarshalServerType = unmarshalServerType;
+exports.unmarshalStartConnectivityDiagnosticResponse = unmarshalStartConnectivityDiagnosticResponse;

package/dist/api/applesilicon/v1alpha1/marshalling.gen.d.ts

@@ -1,11 +1,14 @@
 import type { DefaultValues } from '../../../bridge';
-import type { CreateServerRequest, ListOSResponse, ListServerTypesResponse, ListServersResponse, OS, ReinstallServerRequest, Server, ServerType, UpdateServerRequest } from './types.gen';
+import type { ConnectivityDiagnostic, CreateServerRequest, ListOSResponse, ListServerTypesResponse, ListServersResponse, OS, ReinstallServerRequest, Server, ServerType, StartConnectivityDiagnosticRequest, StartConnectivityDiagnosticResponse, UpdateServerRequest } from './types.gen';
 export declare const unmarshalOS: (data: unknown) => OS;
 export declare const unmarshalServerType: (data: unknown) => ServerType;
 export declare const unmarshalServer: (data: unknown) => Server;
+export declare const unmarshalConnectivityDiagnostic: (data: unknown) => ConnectivityDiagnostic;
 export declare const unmarshalListOSResponse: (data: unknown) => ListOSResponse;
 export declare const unmarshalListServerTypesResponse: (data: unknown) => ListServerTypesResponse;
 export declare const unmarshalListServersResponse: (data: unknown) => ListServersResponse;
+export declare const unmarshalStartConnectivityDiagnosticResponse: (data: unknown) => StartConnectivityDiagnosticResponse;
 export declare const marshalCreateServerRequest: (request: CreateServerRequest, defaults: DefaultValues) => Record<string, unknown>;
 export declare const marshalReinstallServerRequest: (request: ReinstallServerRequest, defaults: DefaultValues) => Record<string, unknown>;
+export declare const marshalStartConnectivityDiagnosticRequest: (request: StartConnectivityDiagnosticRequest, defaults: DefaultValues) => Record<string, unknown>;
 export declare const marshalUpdateServerRequest: (request: UpdateServerRequest, defaults: DefaultValues) => Record<string, unknown>;

package/dist/api/applesilicon/v1alpha1/marshalling.gen.js

@@ -119,6 +119,36 @@ const unmarshalServer = (data) => {
     zone: data.zone
   };
 };
+const unmarshalConnectivityDiagnosticServerHealth = (data) => {
+  if (!isJSONObject(data)) {
+    throw new TypeError(
+      `Unmarshalling the type 'ConnectivityDiagnosticServerHealth' failed as data isn't a dictionary.`
+    );
+  }
+  return {
+    isAgentAlive: data.is_agent_alive,
+    isMdmAlive: data.is_mdm_alive,
+    isServerAlive: data.is_server_alive,
+    isSshPortUp: data.is_ssh_port_up,
+    isVncPortUp: data.is_vnc_port_up,
+    lastCheckinDate: unmarshalDate(data.last_checkin_date)
+  };
+};
+const unmarshalConnectivityDiagnostic = (data) => {
+  if (!isJSONObject(data)) {
+    throw new TypeError(
+      `Unmarshalling the type 'ConnectivityDiagnostic' failed as data isn't a dictionary.`
+    );
+  }
+  return {
+    errorMessage: data.error_message,
+    healthDetails: data.health_details ? unmarshalConnectivityDiagnosticServerHealth(data.health_details) : void 0,
+    id: data.id,
+    isHealthy: data.is_healthy,
+    status: data.status,
+    supportedActions: data.supported_actions
+  };
+};
 const unmarshalListOSResponse = (data) => {
   if (!isJSONObject(data)) {
     throw new TypeError(
@@ -151,6 +181,16 @@ const unmarshalListServersResponse = (data) => {
     totalCount: data.total_count
   };
 };
+const unmarshalStartConnectivityDiagnosticResponse = (data) => {
+  if (!isJSONObject(data)) {
+    throw new TypeError(
+      `Unmarshalling the type 'StartConnectivityDiagnosticResponse' failed as data isn't a dictionary.`
+    );
+  }
+  return {
+    diagnosticId: data.diagnostic_id
+  };
+};
 const marshalCreateServerRequest = (request, defaults) => ({
   name: request.name || randomName("as"),
   os_id: request.osId,
@@ -160,6 +200,9 @@ const marshalCreateServerRequest = (request, defaults) => ({
 const marshalReinstallServerRequest = (request, defaults) => ({
   os_id: request.osId
 });
+const marshalStartConnectivityDiagnosticRequest = (request, defaults) => ({
+  server_id: request.serverId
+});
 const marshalUpdateServerRequest = (request, defaults) => ({
   name: request.name,
   schedule_deletion: request.scheduleDeletion
@@ -167,11 +210,14 @@ const marshalUpdateServerRequest = (request, defaults) => ({
 export {
   marshalCreateServerRequest,
   marshalReinstallServerRequest,
+  marshalStartConnectivityDiagnosticRequest,
   marshalUpdateServerRequest,
+  unmarshalConnectivityDiagnostic,
   unmarshalListOSResponse,
   unmarshalListServerTypesResponse,
   unmarshalListServersResponse,
   unmarshalOS,
   unmarshalServer,
-  unmarshalServerType
+  unmarshalServerType,
+  unmarshalStartConnectivityDiagnosticResponse
 };

package/dist/api/applesilicon/v1alpha1/types.gen.d.ts

@@ -1,4 +1,6 @@
 import type { Zone } from '../../../bridge';
+export type ConnectivityDiagnosticActionType = 'reboot_server' | 'reinstall_server';
+export type ConnectivityDiagnosticDiagnosticStatus = 'unknown_status' | 'processing' | 'error' | 'completed';
 export type ListServersRequestOrderBy = 'created_at_asc' | 'created_at_desc';
 export type ServerStatus = 'unknown_status' | 'starting' | 'ready' | 'error' | 'rebooting' | 'updating' | 'locking' | 'locked' | 'unlocking' | 'reinstalling';
 export type ServerTypeStock = 'unknown_stock' | 'no_stock' | 'low_stock' | 'high_stock';
@@ -41,6 +43,14 @@ export interface ServerTypeMemory {
 export interface ServerTypeNetwork {
     publicBandwidthBps: number;
 }
+export interface ConnectivityDiagnosticServerHealth {
+    lastCheckinDate?: Date;
+    isServerAlive: boolean;
+    isAgentAlive: boolean;
+    isMdmAlive: boolean;
+    isSshPortUp: boolean;
+    isVncPortUp: boolean;
+}
 export interface ServerType {
     /** CPU description. */
     cpu?: ServerTypeCPU;
@@ -112,6 +122,14 @@ export interface Server {
      */
     delivered: boolean;
 }
+export interface ConnectivityDiagnostic {
+    id: string;
+    status: ConnectivityDiagnosticDiagnosticStatus;
+    isHealthy: boolean;
+    healthDetails?: ConnectivityDiagnosticServerHealth;
+    supportedActions: ConnectivityDiagnosticActionType[];
+    errorMessage: string;
+}
 export type CreateServerRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
     zone?: Zone;
@@ -134,6 +152,11 @@ export type DeleteServerRequest = {
     /** UUID of the server you want to delete. */
     serverId: string;
 };
+export type GetConnectivityDiagnosticRequest = {
+    /** Zone to target. If none is passed will use default zone from the config. */
+    zone?: Zone;
+    diagnosticId: string;
+};
 export type GetOSRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
     zone?: Zone;
@@ -224,6 +247,14 @@ export type ReinstallServerRequest = {
      */
     osId?: string;
 };
+export type StartConnectivityDiagnosticRequest = {
+    /** Zone to target. If none is passed will use default zone from the config. */
+    zone?: Zone;
+    serverId: string;
+};
+export interface StartConnectivityDiagnosticResponse {
+    diagnosticId: string;
+}
 export type UpdateServerRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
     zone?: Zone;

package/dist/api/block/v1alpha1/api.gen.cjs

@@ -59,7 +59,8 @@ class API extends api.API {
           request.pageSize ?? this.client.settings.defaultPageSize
         ],
         ["product_resource_id", request.productResourceId],
-        ["project_id", request.projectId]
+        ["project_id", request.projectId],
+        ["tags", request.tags]
       )
     },
     marshalling_gen.unmarshalListVolumesResponse
@@ -84,7 +85,7 @@ class API extends api.API {
    * @param request - The request {@link CreateVolumeRequest}
    * @returns A Promise of Volume
    */
-  createVolume = (request) => this.client.fetch(
+  createVolume = (request = {}) => this.client.fetch(
     {
       body: JSON.stringify(
         marshalling_gen.marshalCreateVolumeRequest(request, this.client.settings)

package/dist/api/block/v1alpha1/api.gen.d.ts

@@ -45,7 +45,7 @@ export declare class API extends ParentAPI {
      * @param request - The request {@link CreateVolumeRequest}
      * @returns A Promise of Volume
      */
-    createVolume: (request: Readonly<CreateVolumeRequest>) => Promise<Volume>;
+    createVolume: (request?: Readonly<CreateVolumeRequest>) => Promise<Volume>;
     /**
      * Get a volume. Retrieve technical information about a specific volume.
      * Details such as size, type, and status are returned in the response.

package/dist/api/block/v1alpha1/api.gen.js

@@ -57,7 +57,8 @@ class API extends API$1 {
           request.pageSize ?? this.client.settings.defaultPageSize
         ],
         ["product_resource_id", request.productResourceId],
-        ["project_id", request.projectId]
+        ["project_id", request.projectId],
+        ["tags", request.tags]
       )
     },
     unmarshalListVolumesResponse
@@ -82,7 +83,7 @@ class API extends API$1 {
    * @param request - The request {@link CreateVolumeRequest}
    * @returns A Promise of Volume
    */
-  createVolume = (request) => this.client.fetch(
+  createVolume = (request = {}) => this.client.fetch(
     {
       body: JSON.stringify(
         marshalCreateVolumeRequest(request, this.client.settings)

package/dist/api/block/v1alpha1/marshalling.gen.cjs

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const randomName = require("@scaleway/random-name");
 const json = require("../../../helpers/json.cjs");
 const customMarshalling = require("../../../scw/custom-marshalling.cjs");
 const marshalling = require("../../../helpers/marshalling.cjs");
@@ -133,7 +134,7 @@ const unmarshalListVolumesResponse = (data) => {
   };
 };
 const marshalCreateSnapshotRequest = (request, defaults) => ({
-  name: request.name,
+  name: request.name || randomName("snp"),
   project_id: request.projectId ?? defaults.defaultProjectId,
   tags: request.tags,
   volume_id: request.volumeId
@@ -146,7 +147,7 @@ const marshalCreateVolumeRequestFromSnapshot = (request, defaults) => ({
   snapshot_id: request.snapshotId
 });
 const marshalCreateVolumeRequest = (request, defaults) => ({
-  name: request.name,
+  name: request.name || randomName("vol"),
   project_id: request.projectId ?? defaults.defaultProjectId,
   tags: request.tags,
   ...marshalling.resolveOneOf([

package/dist/api/block/v1alpha1/marshalling.gen.js

@@ -1,3 +1,4 @@
+import randomName from "@scaleway/random-name";
 import { isJSONObject } from "../../../helpers/json.js";
 import { unmarshalMoney } from "../../../scw/custom-marshalling.js";
 import { unmarshalDate, unmarshalArrayOfObject, resolveOneOf } from "../../../helpers/marshalling.js";
@@ -131,7 +132,7 @@ const unmarshalListVolumesResponse = (data) => {
   };
 };
 const marshalCreateSnapshotRequest = (request, defaults) => ({
-  name: request.name,
+  name: request.name || randomName("snp"),
   project_id: request.projectId ?? defaults.defaultProjectId,
   tags: request.tags,
   volume_id: request.volumeId
@@ -144,7 +145,7 @@ const marshalCreateVolumeRequestFromSnapshot = (request, defaults) => ({
   snapshot_id: request.snapshotId
 });
 const marshalCreateVolumeRequest = (request, defaults) => ({
-  name: request.name,
+  name: request.name || randomName("vol"),
   project_id: request.projectId ?? defaults.defaultProjectId,
   tags: request.tags,
   ...resolveOneOf([

package/dist/api/block/v1alpha1/types.gen.d.ts

@@ -134,7 +134,7 @@ export type CreateSnapshotRequest = {
     /** UUID of the volume to snapshot. */
     volumeId: string;
     /** Name of the snapshot. */
-    name: string;
+    name?: string;
     /** UUID of the project to which the volume and the snapshot belong. */
     projectId?: string;
     /** List of tags assigned to the snapshot. */
@@ -144,7 +144,7 @@ export type CreateVolumeRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
     zone?: Zone;
     /** Name of the volume. */
-    name: string;
+    name?: string;
     /**
      * The maximum IO/s expected, according to the different options available in
      * stock (`5000 | 15000`).
@@ -302,6 +302,11 @@ export type ListVolumesRequest = {
      * ID).
      */
     productResourceId?: string;
+    /**
+     * Filter by tags. Only volumes with one or more matching tags will be
+     * returned.
+     */
+    tags?: string[];
 };
 export interface ListVolumesResponse {
     /** Paginated returned list of volumes. */

package/dist/api/cockpit/v1/api.gen.cjs

@@ -207,7 +207,9 @@ class GlobalAPI extends api.API {
   );
   /**
    * List plan types. Retrieve a list of available pricing plan types.
+   * Deprecated, retention is now managed at the data source level.
    *
+   * @deprecated
    * @param request - The request {@link GlobalApiListPlansRequest}
    * @returns A Promise of ListPlansResponse
    */
@@ -215,8 +217,10 @@ class GlobalAPI extends api.API {
   /**
    * Apply a pricing plan. Apply a pricing plan on a given Project. You must
    * specify the ID of the pricing plan type. Note that you will be billed for
-   * the plan you apply.
+   * the plan you apply. Deprecated, retention is now managed at the data source
+   * level.
    *
+   * @deprecated
    * @param request - The request {@link GlobalApiSelectPlanRequest}
    * @returns A Promise of Plan
    */
@@ -233,8 +237,10 @@ class GlobalAPI extends api.API {
   );
   /**
    * Get current plan. Retrieve a pricing plan for the given Project, specified
-   * by the ID of the Project.
+   * by the ID of the Project. Deprecated, retention is now managed at the data
+   * source level.
    *
+   * @deprecated
    * @param request - The request {@link GlobalApiGetCurrentPlanRequest}
    * @returns A Promise of Plan
    */
@@ -253,6 +259,19 @@ class GlobalAPI extends api.API {
 class RegionalAPI extends api.API {
   /** Lists the available regions of the API. */
   static LOCALITIES = ["fr-par", "nl-ams", "pl-waw"];
+  /**
+   * Get the Cockpit configuration.
+   *
+   * @param request - The request {@link RegionalApiGetConfigRequest}
+   * @returns A Promise of GetConfigResponse
+   */
+  getConfig = (request = {}) => this.client.fetch(
+    {
+      method: "GET",
+      path: `/cockpit/v1/regions/${marshalling.validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/config`
+    },
+    marshalling_gen.unmarshalGetConfigResponse
+  );
   /**
    * Create a data source. You must specify the data source type upon creation.
    * Available data source types include:

package/dist/api/cockpit/v1/api.gen.d.ts

@@ -1,6 +1,6 @@
 import { API as ParentAPI } from '../../../bridge';
 import type { Region } from '../../../bridge';
-import type { AlertManager, ContactPoint, DataSource, GlobalApiCreateGrafanaUserRequest, GlobalApiDeleteGrafanaUserRequest, GlobalApiGetCurrentPlanRequest, GlobalApiGetGrafanaProductDashboardRequest, GlobalApiGetGrafanaRequest, GlobalApiListGrafanaProductDashboardsRequest, GlobalApiListGrafanaUsersRequest, GlobalApiListPlansRequest, GlobalApiResetGrafanaUserPasswordRequest, GlobalApiSelectPlanRequest, GlobalApiSyncGrafanaDataSourcesRequest, Grafana, GrafanaProductDashboard, GrafanaUser, ListContactPointsResponse, ListDataSourcesResponse, ListGrafanaProductDashboardsResponse, ListGrafanaUsersResponse, ListManagedAlertsResponse, ListPlansResponse, ListTokensResponse, Plan, RegionalApiCreateContactPointRequest, RegionalApiCreateDataSourceRequest, RegionalApiCreateTokenRequest, RegionalApiDeleteContactPointRequest, RegionalApiDeleteDataSourceRequest, RegionalApiDeleteTokenRequest, RegionalApiDisableAlertManagerRequest, RegionalApiDisableManagedAlertsRequest, RegionalApiEnableAlertManagerRequest, RegionalApiEnableManagedAlertsRequest, RegionalApiGetAlertManagerRequest, RegionalApiGetDataSourceRequest, RegionalApiGetTokenRequest, RegionalApiGetUsageOverviewRequest, RegionalApiListContactPointsRequest, RegionalApiListDataSourcesRequest, RegionalApiListManagedAlertsRequest, RegionalApiListTokensRequest, RegionalApiTriggerTestAlertRequest, RegionalApiUpdateDataSourceRequest, Token, UsageOverview } from './types.gen';
+import type { AlertManager, ContactPoint, DataSource, GetConfigResponse, GlobalApiCreateGrafanaUserRequest, GlobalApiDeleteGrafanaUserRequest, GlobalApiGetCurrentPlanRequest, GlobalApiGetGrafanaProductDashboardRequest, GlobalApiGetGrafanaRequest, GlobalApiListGrafanaProductDashboardsRequest, GlobalApiListGrafanaUsersRequest, GlobalApiListPlansRequest, GlobalApiResetGrafanaUserPasswordRequest, GlobalApiSelectPlanRequest, GlobalApiSyncGrafanaDataSourcesRequest, Grafana, GrafanaProductDashboard, GrafanaUser, ListContactPointsResponse, ListDataSourcesResponse, ListGrafanaProductDashboardsResponse, ListGrafanaUsersResponse, ListManagedAlertsResponse, ListPlansResponse, ListTokensResponse, Plan, RegionalApiCreateContactPointRequest, RegionalApiCreateDataSourceRequest, RegionalApiCreateTokenRequest, RegionalApiDeleteContactPointRequest, RegionalApiDeleteDataSourceRequest, RegionalApiDeleteTokenRequest, RegionalApiDisableAlertManagerRequest, RegionalApiDisableManagedAlertsRequest, RegionalApiEnableAlertManagerRequest, RegionalApiEnableManagedAlertsRequest, RegionalApiGetAlertManagerRequest, RegionalApiGetConfigRequest, RegionalApiGetDataSourceRequest, RegionalApiGetTokenRequest, RegionalApiGetUsageOverviewRequest, RegionalApiListContactPointsRequest, RegionalApiListDataSourcesRequest, RegionalApiListManagedAlertsRequest, RegionalApiListTokensRequest, RegionalApiTriggerTestAlertRequest, RegionalApiUpdateDataSourceRequest, Token, UsageOverview } from './types.gen';
 /**
  * Cockpit Global API.
  *
@@ -94,7 +94,9 @@ export declare class GlobalAPI extends ParentAPI {
     protected pageOfListPlans: (request?: Readonly<GlobalApiListPlansRequest>) => Promise<ListPlansResponse>;
     /**
      * List plan types. Retrieve a list of available pricing plan types.
+     * Deprecated, retention is now managed at the data source level.
      *
+     * @deprecated
      * @param request - The request {@link GlobalApiListPlansRequest}
      * @returns A Promise of ListPlansResponse
      */
@@ -105,16 +107,20 @@ export declare class GlobalAPI extends ParentAPI {
     /**
      * Apply a pricing plan. Apply a pricing plan on a given Project. You must
      * specify the ID of the pricing plan type. Note that you will be billed for
-     * the plan you apply.
+     * the plan you apply. Deprecated, retention is now managed at the data source
+     * level.
      *
+     * @deprecated
      * @param request - The request {@link GlobalApiSelectPlanRequest}
      * @returns A Promise of Plan
      */
     selectPlan: (request?: Readonly<GlobalApiSelectPlanRequest>) => Promise<Plan>;
     /**
      * Get current plan. Retrieve a pricing plan for the given Project, specified
-     * by the ID of the Project.
+     * by the ID of the Project. Deprecated, retention is now managed at the data
+     * source level.
      *
+     * @deprecated
      * @param request - The request {@link GlobalApiGetCurrentPlanRequest}
      * @returns A Promise of Plan
      */
@@ -131,6 +137,13 @@ export declare class GlobalAPI extends ParentAPI {
 export declare class RegionalAPI extends ParentAPI {
     /** Lists the available regions of the API. */
     static readonly LOCALITIES: Region[];
+    /**
+     * Get the Cockpit configuration.
+     *
+     * @param request - The request {@link RegionalApiGetConfigRequest}
+     * @returns A Promise of GetConfigResponse
+     */
+    getConfig: (request?: Readonly<RegionalApiGetConfigRequest>) => Promise<GetConfigResponse>;
     /**
      * Create a data source. You must specify the data source type upon creation.
      * Available data source types include:

package/dist/api/cockpit/v1/api.gen.js

@@ -2,7 +2,7 @@ import { API as API$1 } from "../../../scw/api.js";
 import { urlParams, validatePathParam } from "../../../helpers/marshalling.js";
 import "../../../vendor/base64/index.js";
 import { enrichForPagination } from "../../../scw/fetch/resource-paginator.js";
-import { unmarshalGrafana, marshalGlobalApiSyncGrafanaDataSourcesRequest, marshalGlobalApiCreateGrafanaUserRequest, unmarshalGrafanaUser, unmarshalListGrafanaUsersResponse, marshalGlobalApiResetGrafanaUserPasswordRequest, unmarshalListGrafanaProductDashboardsResponse, unmarshalGrafanaProductDashboard, unmarshalListPlansResponse, marshalGlobalApiSelectPlanRequest, unmarshalPlan, marshalRegionalApiCreateDataSourceRequest, unmarshalDataSource, unmarshalListDataSourcesResponse, marshalRegionalApiUpdateDataSourceRequest, unmarshalUsageOverview, marshalRegionalApiCreateTokenRequest, unmarshalToken, unmarshalListTokensResponse, unmarshalAlertManager, marshalRegionalApiEnableAlertManagerRequest, marshalRegionalApiDisableAlertManagerRequest, marshalRegionalApiCreateContactPointRequest, unmarshalContactPoint, unmarshalListContactPointsResponse, marshalRegionalApiDeleteContactPointRequest, unmarshalListManagedAlertsResponse, marshalRegionalApiEnableManagedAlertsRequest, marshalRegionalApiDisableManagedAlertsRequest, marshalRegionalApiTriggerTestAlertRequest } from "./marshalling.gen.js";
+import { unmarshalGrafana, marshalGlobalApiSyncGrafanaDataSourcesRequest, marshalGlobalApiCreateGrafanaUserRequest, unmarshalGrafanaUser, unmarshalListGrafanaUsersResponse, marshalGlobalApiResetGrafanaUserPasswordRequest, unmarshalListGrafanaProductDashboardsResponse, unmarshalGrafanaProductDashboard, unmarshalListPlansResponse, marshalGlobalApiSelectPlanRequest, unmarshalPlan, unmarshalGetConfigResponse, marshalRegionalApiCreateDataSourceRequest, unmarshalDataSource, unmarshalListDataSourcesResponse, marshalRegionalApiUpdateDataSourceRequest, unmarshalUsageOverview, marshalRegionalApiCreateTokenRequest, unmarshalToken, unmarshalListTokensResponse, unmarshalAlertManager, marshalRegionalApiEnableAlertManagerRequest, marshalRegionalApiDisableAlertManagerRequest, marshalRegionalApiCreateContactPointRequest, unmarshalContactPoint, unmarshalListContactPointsResponse, marshalRegionalApiDeleteContactPointRequest, unmarshalListManagedAlertsResponse, marshalRegionalApiEnableManagedAlertsRequest, marshalRegionalApiDisableManagedAlertsRequest, marshalRegionalApiTriggerTestAlertRequest } from "./marshalling.gen.js";
 const jsonContentHeaders = {
   "Content-Type": "application/json; charset=utf-8"
 };
@@ -205,7 +205,9 @@ class GlobalAPI extends API$1 {
   );
   /**
    * List plan types. Retrieve a list of available pricing plan types.
+   * Deprecated, retention is now managed at the data source level.
    *
+   * @deprecated
    * @param request - The request {@link GlobalApiListPlansRequest}
    * @returns A Promise of ListPlansResponse
    */
@@ -213,8 +215,10 @@ class GlobalAPI extends API$1 {
   /**
    * Apply a pricing plan. Apply a pricing plan on a given Project. You must
    * specify the ID of the pricing plan type. Note that you will be billed for
-   * the plan you apply.
+   * the plan you apply. Deprecated, retention is now managed at the data source
+   * level.
    *
+   * @deprecated
    * @param request - The request {@link GlobalApiSelectPlanRequest}
    * @returns A Promise of Plan
    */
@@ -231,8 +235,10 @@ class GlobalAPI extends API$1 {
   );
   /**
    * Get current plan. Retrieve a pricing plan for the given Project, specified
-   * by the ID of the Project.
+   * by the ID of the Project. Deprecated, retention is now managed at the data
+   * source level.
    *
+   * @deprecated
    * @param request - The request {@link GlobalApiGetCurrentPlanRequest}
    * @returns A Promise of Plan
    */
@@ -251,6 +257,19 @@ class GlobalAPI extends API$1 {
 class RegionalAPI extends API$1 {
   /** Lists the available regions of the API. */
   static LOCALITIES = ["fr-par", "nl-ams", "pl-waw"];
+  /**
+   * Get the Cockpit configuration.
+   *
+   * @param request - The request {@link RegionalApiGetConfigRequest}
+   * @returns A Promise of GetConfigResponse
+   */
+  getConfig = (request = {}) => this.client.fetch(
+    {
+      method: "GET",
+      path: `/cockpit/v1/regions/${validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/config`
+    },
+    unmarshalGetConfigResponse
+  );
   /**
    * Create a data source. You must specify the data source type upon creation.
    * Available data source types include:

package/dist/api/cockpit/v1/index.gen.d.ts

@@ -1,3 +1,3 @@
 export { GlobalAPI, RegionalAPI } from './api.gen';
-export type { Alert, AlertManager, ContactPoint, ContactPointEmail, DataSource, DataSourceOrigin, DataSourceType, GlobalApiCreateGrafanaUserRequest, GlobalApiDeleteGrafanaUserRequest, GlobalApiGetCurrentPlanRequest, GlobalApiGetGrafanaProductDashboardRequest, GlobalApiGetGrafanaRequest, GlobalApiListGrafanaProductDashboardsRequest, GlobalApiListGrafanaUsersRequest, GlobalApiListPlansRequest, GlobalApiResetGrafanaUserPasswordRequest, GlobalApiSelectPlanRequest, GlobalApiSyncGrafanaDataSourcesRequest, Grafana, GrafanaProductDashboard, GrafanaUser, GrafanaUserRole, ListContactPointsResponse, ListDataSourcesRequestOrderBy, ListDataSourcesResponse, ListGrafanaProductDashboardsResponse, ListGrafanaUsersRequestOrderBy, ListGrafanaUsersResponse, ListManagedAlertsRequestOrderBy, ListManagedAlertsResponse, ListPlansRequestOrderBy, ListPlansResponse, ListTokensRequestOrderBy, ListTokensResponse, Plan, PlanName, RegionalApiCreateContactPointRequest, RegionalApiCreateDataSourceRequest, RegionalApiCreateTokenRequest, RegionalApiDeleteContactPointRequest, RegionalApiDeleteDataSourceRequest, RegionalApiDeleteTokenRequest, RegionalApiDisableAlertManagerRequest, RegionalApiDisableManagedAlertsRequest, RegionalApiEnableAlertManagerRequest, RegionalApiEnableManagedAlertsRequest, RegionalApiGetAlertManagerRequest, RegionalApiGetDataSourceRequest, RegionalApiGetTokenRequest, RegionalApiGetUsageOverviewRequest, RegionalApiListContactPointsRequest, RegionalApiListDataSourcesRequest, RegionalApiListManagedAlertsRequest, RegionalApiListTokensRequest, RegionalApiTriggerTestAlertRequest, RegionalApiUpdateDataSourceRequest, Token, TokenScope, Usage, UsageOverview, UsageUnit, } from './types.gen';
+export type { Alert, AlertManager, ContactPoint, ContactPointEmail, DataSource, DataSourceOrigin, DataSourceType, GetConfigResponse, GetConfigResponseRetention, GlobalApiCreateGrafanaUserRequest, GlobalApiDeleteGrafanaUserRequest, GlobalApiGetCurrentPlanRequest, GlobalApiGetGrafanaProductDashboardRequest, GlobalApiGetGrafanaRequest, GlobalApiListGrafanaProductDashboardsRequest, GlobalApiListGrafanaUsersRequest, GlobalApiListPlansRequest, GlobalApiResetGrafanaUserPasswordRequest, GlobalApiSelectPlanRequest, GlobalApiSyncGrafanaDataSourcesRequest, Grafana, GrafanaProductDashboard, GrafanaUser, GrafanaUserRole, ListContactPointsResponse, ListDataSourcesRequestOrderBy, ListDataSourcesResponse, ListGrafanaProductDashboardsResponse, ListGrafanaUsersRequestOrderBy, ListGrafanaUsersResponse, ListManagedAlertsRequestOrderBy, ListManagedAlertsResponse, ListPlansRequestOrderBy, ListPlansResponse, ListTokensRequestOrderBy, ListTokensResponse, Plan, PlanName, RegionalApiCreateContactPointRequest, RegionalApiCreateDataSourceRequest, RegionalApiCreateTokenRequest, RegionalApiDeleteContactPointRequest, RegionalApiDeleteDataSourceRequest, RegionalApiDeleteTokenRequest, RegionalApiDisableAlertManagerRequest, RegionalApiDisableManagedAlertsRequest, RegionalApiEnableAlertManagerRequest, RegionalApiEnableManagedAlertsRequest, RegionalApiGetAlertManagerRequest, RegionalApiGetConfigRequest, RegionalApiGetDataSourceRequest, RegionalApiGetTokenRequest, RegionalApiGetUsageOverviewRequest, RegionalApiListContactPointsRequest, RegionalApiListDataSourcesRequest, RegionalApiListManagedAlertsRequest, RegionalApiListTokensRequest, RegionalApiTriggerTestAlertRequest, RegionalApiUpdateDataSourceRequest, Token, TokenScope, Usage, UsageOverview, UsageUnit, } from './types.gen';
 export * as ValidationRules from './validation-rules.gen';