Merge pull request #12392 from linode/staging

Release v.1.144.0 - staging → master

Author: abailly-akamai

package.json

@@ -27,7 +27,7 @@
     "typescript-eslint": "^8.29.0",
     "@typescript-eslint/eslint-plugin": "^8.29.0",
     "@typescript-eslint/parser": "^8.29.0",
-    "@linode/eslint-plugin-cloud-manager": "^0.0.10"
+    "@linode/eslint-plugin-cloud-manager": "^0.0.11"
   },
   "scripts": {
     "lint:all": "pnpm -r --parallel lint",

packages/api-v4/CHANGELOG.md

@@ -1,3 +1,24 @@
+## [2025-06-17] - v0.142.0
+
+
+### Added:
+
+- `has_user_data` to `Linode` type ([#12352](https://github.com/linode/manager/pull/12352))
+
+### Changed:
+
+- Make AccountMaintenance description field type more specific ([#12293](https://github.com/linode/manager/pull/12293))
+- Include `private_network` in BaseDatabase type ([#12324](https://github.com/linode/manager/pull/12324))
+- Make `placement_group` defined but nullable in `Linode` type ([#12352](https://github.com/linode/manager/pull/12352))
+- Make PrivateNetwork public_access property optional and UpdateDatabasePayload private_network property optional ([#12354](https://github.com/linode/manager/pull/12354))
+
+### Upcoming Features:
+
+- IAM RBAC: Add role and new entity types ([#12296](https://github.com/linode/manager/pull/12296))
+- Add ACLP `getCloudPulseServiceByServiceType` service and update `ServiceTypes` per API specs ([#12307](https://github.com/linode/manager/pull/12307))
+- IAM RBAC: implement the two new APIs and renamed old endpoints and queries to align terminology with the current focus on roles ([#12344](https://github.com/linode/manager/pull/12344))
+- Change references of `interface` to `linode_interface` for firewall types ([#12367](https://github.com/linode/manager/pull/12367))
+
 ## [2025-06-03] - v0.141.0
 
 ### Added:

packages/api-v4/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linode/api-v4",
-  "version": "0.141.0",
+  "version": "0.142.0",
   "homepage": "https://github.com/linode/manager/tree/develop/packages/api-v4",
   "bugs": {
     "url": "https://github.com/linode/manager/issues"

packages/api-v4/src/account/types.ts

@@ -570,7 +570,7 @@ export interface SaveCreditCardData {
 
 export interface AccountMaintenance {
   complete_time: string;
-  description: string;
+  description: 'emergency' | 'scheduled';
   entity: {
     id: number;
     label: string;

packages/api-v4/src/cloudpulse/services.ts

@@ -12,6 +12,7 @@ import type {
   JWEToken,
   JWETokenPayLoad,
   MetricDefinition,
+  ServiceTypes,
   ServiceTypesList,
 } from './types';
 import type { Filter, Params, ResourcePage } from 'src/types';
@@ -48,3 +49,9 @@ export const getCloudPulseServiceTypes = () =>
     setURL(`${API_ROOT}/monitor/services`),
     setMethod('GET'),
   );
+
+export const getCloudPulseServiceByServiceType = (serviceType: string) =>
+  Request<ServiceTypes>(
+    setURL(`${API_ROOT}/monitor/services/${encodeURIComponent(serviceType)}`),
+    setMethod('GET'),
+  );

packages/api-v4/src/cloudpulse/types.ts

@@ -164,7 +164,14 @@ export interface CloudPulseMetricsList {
 }
 
 export interface ServiceTypes {
+  alert: {
+    evaluation_periods_seconds: number[];
+    polling_interval_seconds: number[];
+    scope: string[];
+  };
+  is_beta: boolean;
   label: string;
+  regions: string;
   service_type: string;
 }
 

packages/api-v4/src/databases/types.ts

@@ -128,7 +128,7 @@ export interface DatabaseInstance {
 export type ClusterSize = 1 | 2 | 3;
 
 export interface PrivateNetwork {
-  public_access: boolean;
+  public_access?: boolean;
   subnet_id: null | number;
   vpc_id: null | number;
 }
@@ -196,6 +196,7 @@ export interface PendingUpdates {
 // Database is the base interface for the shape of data returned by /databases/{engine}/instances
 interface BaseDatabase extends DatabaseInstance {
   port: number;
+  private_network?: null | PrivateNetwork; //  TODO (UIE-8831): Confirm whether this still needs to be optional (?) post VPC release.
   /** @Deprecated used by rdbms-legacy only, rdbms-default always uses TLS */
   ssl_connection: boolean;
   total_disk_size_gb: number;
@@ -240,6 +241,7 @@ export interface UpdateDatabasePayload {
   cluster_size?: number;
   engine_config?: DatabaseInstanceAdvancedConfig;
   label?: string;
+  private_network?: null | PrivateNetwork;
   type?: string;
   updates?: UpdatesSchedule;
   version?: string;

packages/api-v4/src/entities/types.ts

@@ -4,8 +4,10 @@ export type EntityType =
   | 'firewall'
   | 'image'
   | 'linode'
+  | 'lkecluster'
   | 'longview'
   | 'nodebalancer'
+  | 'placement_group'
   | 'stackscript'
   | 'volume'
   | 'vpc';

packages/api-v4/src/firewalls/types.ts

@@ -2,7 +2,10 @@ export type FirewallStatus = 'deleted' | 'disabled' | 'enabled';
 
 export type FirewallRuleProtocol = 'ALL' | 'ICMP' | 'IPENCAP' | 'TCP' | 'UDP';
 
-export type FirewallDeviceEntityType = 'interface' | 'linode' | 'nodebalancer';
+export type FirewallDeviceEntityType =
+  | 'linode'
+  | 'linode_interface'
+  | 'nodebalancer';
 
 export type FirewallPolicyType = 'ACCEPT' | 'DROP';
 
@@ -68,7 +71,7 @@ export interface FirewallTemplate {
 
 export interface CreateFirewallPayload {
   devices?: null | {
-    interfaces?: number[];
+    linode_interfaces?: number[];
     linodes?: number[];
     nodebalancers?: number[];
   };

packages/api-v4/src/iam/iam.ts

@@ -1,40 +1,43 @@
 import { BETA_API_ROOT } from '../constants';
 import Request, { setData, setMethod, setURL } from '../request';
 
-import type { IamAccountPermissions, IamUserPermissions } from './types';
+import type {
+  EntityTypePermissions,
+  IamAccountRoles,
+  IamUserRoles,
+  PermissionType,
+} from './types';
 
 /**
- * getUserPermissions
+ * getUserRoles
  *
  * Returns the full permissions structure for this User. This includes all entities on
  * the Account alongside what level of access this User has to each of them.
  *
- * @param username { number } the username to look up.
+ * @param username { string } the username to look up.
  *
  */
-export const getUserPermissions = (username: string) =>
-  Request<IamUserPermissions>(
+export const getUserRoles = (username: string) =>
+  Request<IamUserRoles>(
     setURL(
       `${BETA_API_ROOT}/iam/users/${encodeURIComponent(
         username,
       )}/role-permissions`,
     ),
     setMethod('GET'),
   );
+
 /**
- * updateUserPermissions
+ * updateUserRoles
  *
- * Update the permissions a User has.
+ * Update the roles a User has.
  *
- * @param username { number } ID of the client to be viewed.
- * @param data { object } the Permissions object to update.
+ * @param username { string } username of the user to be updated.
+ * @param data { object } the Roles object to update.
  *
  */
-export const updateUserPermissions = (
-  username: string,
-  data: IamUserPermissions,
-) =>
-  Request<IamUserPermissions>(
+export const updateUserRoles = (username: string, data: IamUserRoles) =>
+  Request<IamUserRoles>(
     setURL(
       `${BETA_API_ROOT}/iam/users/${encodeURIComponent(
         username,
@@ -45,14 +48,55 @@ export const updateUserPermissions = (
   );
 
 /**
- * getAccountPermissions
+ * getAccountRoles
  *
- * Return all permissions for account.
+ * Return all roles for account.
  *
  */
-export const getAccountPermissions = () => {
-  return Request<IamAccountPermissions>(
+export const getAccountRoles = () => {
+  return Request<IamAccountRoles>(
     setURL(`${BETA_API_ROOT}/iam/role-permissions`),
     setMethod('GET'),
   );
 };
+
+/**
+ * getUserAccountPermissions
+ *
+ * Returns the current permissions for this User on the account.
+ *
+ * @param username { string } the username to look up.
+ *
+ */
+export const getUserAccountPermissions = (username: string) =>
+  Request<PermissionType[]>(
+    setURL(
+      `${BETA_API_ROOT}/iam/users/${encodeURIComponent(
+        username,
+      )}/permissions/account`,
+    ),
+    setMethod('GET'),
+  );
+
+/**
+ * getUserEntityPermissions
+ *
+ * Returns the current permissions for this User on the entity.
+ *
+ * @param username { string } the username to look up.
+ * @param entityType { EntityTypePermissions } the entityType to look up.
+ * @param entityId { number } the entityId to look up.
+ */
+export const getUserEntityPermissions = (
+  username: string,
+  entityType: EntityTypePermissions,
+  entityId: number,
+) =>
+  Request<PermissionType[]>(
+    setURL(
+      `${BETA_API_ROOT}/iam/users/${encodeURIComponent(
+        username,
+      )}/permissions/${entityType}/${entityId}`,
+    ),
+    setMethod('GET'),
+  );