Class: Infrawrench::ExpiringSettingsNamespace

Inherits:
Object
  • Object
show all
Defined in:
lib/infrawrench/client.rb,
sig/infrawrench/sdk.rbs

Overview

client.expiring.settings

Instance Method Summary collapse

Constructor Details

#initialize(transport) ⇒ ExpiringSettingsNamespace

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of ExpiringSettingsNamespace.

Parameters:



3524
3525
3526
 
# File 'lib/infrawrench/client.rb', line 3524

def initialize(transport)
  @transport = transport
end

Instance Method Details

#get(org_id: nil, request_options: nil) ⇒ Hash

Get the organization's expiry alert settings

The lead time feeds both the feed's upcoming bucket and the poller's daily alert scan. An organization that never saved reads the shipped defaults (enabled, 60 days).

Requires permission: org:settings:write.

GET /api/org/orgId/expiring/settings

Parameters:

  • org_id (String, nil) (defaults to: nil) —

    Organization id. Defaults to the org_id the client was constructed with.

  • request_options (Hash, nil) (defaults to: nil) —

    Per-call :headers, :timeout and :open_timeout.

  • org_id: (String, nil) (defaults to: nil)
  • request_options: (Hash[Symbol, untyped], nil) (defaults to: nil)

Returns:

  • (Hash) —

    Parsed JSON, shaped as ExpiryAlertSettings — see sig/infrawrench/sdk.rbs.

Raises:



3544
3545
3546
3547
3548
3549
3550
3551
 
# File 'lib/infrawrench/client.rb', line 3544

def get(org_id: nil, request_options: nil)
  @transport.request(
    http_method: "GET",
    path: "/api/org/{orgId}/expiring/settings",
    path_params: { "orgId" => org_id },
    request_options: request_options
  )
end

#update(org_id: nil, body: nil, request_options: nil) ⇒ Hash

Update the expiry alert settings

Every field is optional so a single toggle can be saved on its own. leadDays must be a whole number from 1 to 365. Saving never resets the alert cooldown.

Requires permission: org:settings:write.

PUT /api/org/orgId/expiring/settings

Raises on 400: Bad request

Parameters:

  • org_id (String, nil) (defaults to: nil) —

    Organization id. Defaults to the org_id the client was constructed with.

  • body (Hash, nil) (defaults to: nil) —

    Request body, shaped as ExpiryAlertSettingsUpdate.

  • request_options (Hash, nil) (defaults to: nil) —

    Per-call :headers, :timeout and :open_timeout.

  • org_id: (String, nil) (defaults to: nil)
  • body: (expiry_alert_settings_update, nil) (defaults to: nil)
  • request_options: (Hash[Symbol, untyped], nil) (defaults to: nil)

Returns:

  • (Hash) —

    Parsed JSON, shaped as ExpiryAlertSettings — see sig/infrawrench/sdk.rbs.

Raises:



3572
3573
3574
3575
3576
3577
3578
3579
3580
 
# File 'lib/infrawrench/client.rb', line 3572

def update(org_id: nil, body: nil, request_options: nil)
  @transport.request(
    http_method: "PUT",
    path: "/api/org/{orgId}/expiring/settings",
    path_params: { "orgId" => org_id },
    body: body,
    request_options: request_options
  )
end