Merge branch 'main' into proj/frontend-vpcs

Author: yec-akamai

.golangci.yml

@@ -5,11 +5,9 @@ linters:
   default: all
   disable:
     - bodyclose
-    - contextcheck
     - cyclop
     - depguard
     - dupl
-    - durationcheck
     - err113
     - errcheck
     - errname
@@ -19,30 +17,20 @@ linters:
     - forcetypeassert
     - gochecknoglobals
     - gochecknoinits
-    - gocyclo
     - godot
-    - gosec
     - inamedparam
     - lll
     - musttag
-    - nakedret
     - nilerr
     - nlreturn
-    - noctx
     - noinlineerr
     - nolintlint
     - nonamedreturns
     - perfsprint
     - recvcheck
-    - rowserrcheck
-    - sqlclosecheck
     - staticcheck
-    - tagalign
     - tagliatelle
-    - tparallel
-    - unparam
     - varnamelen
-    - wastedassign
     - wrapcheck
     - wsl
   settings:

alert_channels.go

@@ -0,0 +1,83 @@
+package linodego
+
+import (
+	"context"
+	"encoding/json"
+	"time"
+
+	"github.com/linode/linodego/internal/parseabletime"
+)
+
+type AlertNotificationType string
+
+const (
+	EmailAlertNotification AlertNotificationType = "email"
+)
+
+type AlertChannelType string
+
+const (
+	SystemAlertChannel AlertChannelType = "system"
+	UserAlertChannel   AlertChannelType = "user"
+)
+
+// AlertChannelEnvelope represents a single alert channel entry returned inside alert definition
+type AlertChannelEnvelope struct {
+	ID    int    `json:"id"`
+	Label string `json:"label"`
+	Type  string `json:"type"`
+	URL   string `json:"url"`
+}
+
+// AlertChannel represents a Monitor Channel object.
+type AlertChannel struct {
+	Alerts      []AlertChannelEnvelope `json:"alerts"`
+	ChannelType AlertNotificationType  `json:"channel_type"`
+	Content     ChannelContent         `json:"content"`
+	Created     *time.Time             `json:"-"`
+	CreatedBy   string                 `json:"created_by"`
+	Updated     *time.Time             `json:"-"`
+	UpdatedBy   string                 `json:"updated_by"`
+	ID          int                    `json:"id"`
+	Label       string                 `json:"label"`
+	Type        AlertChannelType       `json:"type"`
+}
+
+type EmailChannelContent struct {
+	EmailAddresses []string `json:"email_addresses"`
+}
+
+// ChannelContent represents the content block for an AlertChannel, which varies by channel type.
+type ChannelContent struct {
+	Email *EmailChannelContent `json:"email"`
+	// Other channel types like 'webhook', 'slack' could be added here as optional fields.
+}
+
+// UnmarshalJSON implements the json.Unmarshaler interface
+func (a *AlertChannel) UnmarshalJSON(b []byte) error {
+	type Mask AlertChannel
+
+	p := struct {
+		*Mask
+
+		Updated *parseabletime.ParseableTime `json:"updated"`
+		Created *parseabletime.ParseableTime `json:"created"`
+	}{
+		Mask: (*Mask)(a),
+	}
+
+	if err := json.Unmarshal(b, &p); err != nil {
+		return err
+	}
+
+	a.Updated = (*time.Time)(p.Updated)
+	a.Created = (*time.Time)(p.Created)
+
+	return nil
+}
+
+// ListAlertChannels gets a paginated list of Alert Channels.
+func (c *Client) ListAlertChannels(ctx context.Context, opts *ListOptions) ([]AlertChannel, error) {
+	endpoint := formatAPIPath("monitor/alert-channels")
+	return getPaginatedResults[AlertChannel](ctx, c, endpoint, opts)
+}

entities.go

@@ -0,0 +1,26 @@
+package linodego
+
+import "context"
+
+// LinodeEntity is anything in Linode with IAM Permissions
+type LinodeEntity struct {
+	ID    int    `json:"id"`
+	Label string `json:"label"`
+	Type  string `json:"type"`
+}
+
+// ListEntities returns a paginated list of all entities
+func (c *Client) ListEntities(ctx context.Context, opts *ListOptions) ([]LinodeEntity, error) {
+	return getPaginatedResults[LinodeEntity](ctx, c, "entities", opts)
+}
+
+// GetEntityRoles returns a list of roles for the entity and user
+func (c *Client) GetEntityRoles(ctx context.Context, username string, entityType string, entityID int) ([]string, error) {
+	perms, err := doGETRequest[[]string](ctx, c,
+		formatAPIPath("iam/users/%s/permissions/%s/%d", username, entityType, entityID))
+	if err != nil || perms == nil {
+		return nil, err
+	}
+
+	return (*perms), err
+}

iam.go

@@ -0,0 +1,80 @@
+package linodego
+
+import "context"
+
+// UserRolePermissions are the account and entity permissions for the User
+type UserRolePermissions struct {
+	AccountAccess []string     `json:"account_access"`
+	EntityAccess  []UserAccess `json:"entity_access"`
+}
+
+// GetUpdateOptions converts UserRolePermissions for use in UpdateUserRolePermissions
+func (p *UserRolePermissions) GetUpdateOptions() UserRolePermissionsUpdateOptions {
+	return UserRolePermissionsUpdateOptions{
+		AccountAccess: p.AccountAccess,
+		EntityAccess:  p.EntityAccess,
+	}
+}
+
+// UserRolePermissionsUpdateOptions are fields accepted by UpdateUserRolePermissions
+type UserRolePermissionsUpdateOptions struct {
+	AccountAccess []string     `json:"account_access"`
+	EntityAccess  []UserAccess `json:"entity_access"`
+}
+
+// UserAccess is the breakdown of entities Roles
+type UserAccess struct {
+	ID    int      `json:"id"`
+	Type  string   `json:"type"`
+	Roles []string `json:"roles"`
+}
+
+// AccountRolePermissions are the account and entity roles for the Account
+type AccountRolePermissions struct {
+	AccountAccess []AccountAccess `json:"account_access"`
+	EntityAccess  []AccountAccess `json:"entity_access"`
+}
+
+// AccountAccess is the Roles for each Type for the Account
+type AccountAccess struct {
+	Type  string `json:"type"`
+	Roles []Role `json:"roles"`
+}
+
+// Role is the IAM Role and its Permissions
+type Role struct {
+	Name        string   `json:"name"`
+	Description string   `json:"description"`
+	Permissions []string `json:"permissions"`
+}
+
+// GetUserRolePermissions returns any role permissions for username
+func (c *Client) GetUserRolePermissions(ctx context.Context, username string) (*UserRolePermissions, error) {
+	return doGETRequest[UserRolePermissions](ctx, c,
+		formatAPIPath("iam/users/%s/role-permissions", username),
+	)
+}
+
+// UpdateUserRolePermissions updates any role permissions for username
+func (c *Client) UpdateUserRolePermissions(ctx context.Context, username string, opts UserRolePermissionsUpdateOptions) (*UserRolePermissions, error) {
+	return doPUTRequest[UserRolePermissions](ctx, c,
+		formatAPIPath("iam/users/%s/role-permissions", username),
+		opts,
+	)
+}
+
+// GetAccountRolePermissions returns the role permissions for this Account
+func (c *Client) GetAccountRolePermissions(ctx context.Context) (*AccountRolePermissions, error) {
+	return doGETRequest[AccountRolePermissions](ctx, c, "iam/role-permissions")
+}
+
+// GetUserAccountPermissions returns the account permissions for username
+func (c *Client) GetUserAccountPermissions(ctx context.Context, username string) ([]string, error) {
+	perms, err := doGETRequest[[]string](ctx, c,
+		formatAPIPath("iam/users/%s/permissions/account", username))
+	if err != nil || perms == nil {
+		return nil, err
+	}
+
+	return (*perms), err
+}