NewRelicPS

1.0.2

NewRelicPS.NotificationChannels.psm1

<#
.Synopsis
  Gets a New Relic notification channel
.Description
  Returns data on all New Relic notification channels or a single channel
.Example
  Get-NRNotificationChannel -APIKey $APIKey
  Returns information for all channels in the account associated with the provided API key
.Example
  Get-NRNotificationChannel -APIKey $APIKey -Name 'MyChannel'
  Returns information for the channel named MyChannel in the account associated with the provided API key
.Parameter APIKey
  Can be either the account level REST API key or an admin user's API Key. See more here: https://docs.newrelic.com/docs/apis/get-started/intro-apis/types-new-relic-api-keys
.Parameter Name
  If provided, filters the returned data to the channel name specified.
#>
Function Get-NRNotificationChannel {
  [CMDLetBinding()]
  Param (
    [Parameter (Mandatory = $true)]
    [string] $APIKey,
    [Parameter (ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true)]
    [string] $Name
  )
  Begin {
    $url = 'https://api.newrelic.com/v2/alerts_channels.json'

    $headers = @{
      'X-Api-Key' = $APIKey
    }
  }
  Process {
    $Result = (Invoke-RestMethod $url -headers $headers -method 'Get').channels

    # The API doesn't have a filter option, so filter the list of results to the specified name
    If ($Name) {
      Return $Result | Where-Object {$_.name -eq $Name}
    }
    Else {
      Return $Result
    }
  }
}

<#
.Synopsis
  Creates a New Relic notification channel
.Description
  Creates a New Relic notification channel
.Example
  New-NRNotificationChannel -APIKey $APIKey -Name 'MyChannel' -Type 'Email' -Configuration $JSONConfiguration
  Creates a new emmail notification channel. For a list of channel types and their JSON configurtions see https://rpm.newrelic.com/api/explore/alerts_channels/create
.Parameter APIKey
  Must be an admin user's API Key, not an account-level REST API Key. See more here: https://docs.newrelic.com/docs/apis/get-started/intro-apis/types-new-relic-api-keys
.Parameter Type
  The type of notification channel to create. The CMDLet will only let you specify valid types.
.Parameter Configuration
  This is a JSON-formatted configuration. For a list of channel types and their JSON configurtions see https://rpm.newrelic.com/api/explore/alerts_channels/create
#>
Function New-NRNotificationChannel {
  [CMDLetBinding(SupportsShouldProcess = $true)]
  Param (
    [Parameter (Mandatory = $true)]
    [string] $APIKey,
    [Parameter (Mandatory = $true, ValueFromPipelineByPropertyName = $true)]
    [string] $Name,
    [Parameter (Mandatory = $true, ValueFromPipelineByPropertyName = $true)]
    [ValidateSet ('User','Email','OpsGenie','PagerDuty','Slack','VicorOps','Webhook','xMatters')]
    [string] $Type,
    [Parameter (Mandatory = $true, ValueFromPipelineByPropertyName = $true)]
    [hashtable] $Configuration
  )
  Begin {
    $url = 'https://api.newrelic.com/v2/alerts_channels.json'
    $headers = @{
      'X-Api-Key' = $APIKey
    }
  }
  Process {
    $body = @{
      'channel' = [ordered]@{
        'name'          = $Name
        'type'          = $Type
        'configuration' = $Configuration
      }
    } | ConvertTo-Json
    if ($PSCmdlet.ShouldProcess($Name,'Create Notification Channel')) {
      Return (Invoke-RestMethod $url -headers $headers -body $body -method 'Post' -ContentType 'application/json').channels
    }
  }
}

<#
.Synopsis
  Removes a New Relic notification channel
.Description
  Removes a New Relic notification channel
.Example
  Remove-NRNotificationChannel -APIKey $APIKey -ChannelId 1234
  Removes the notification channel with Id 1234 from the account associated with the provided API Key
.Example
  $ChannelsToRemove.Id | Remove-NRNotificationChannel -APIKey $APIKey
  Removes all channels in $ChannelsToRemove from the account assocaited with the provided API key
.Parameter APIKey
  Must be an admin user's API Key, not an account-level REST API Key. See more here: https://docs.newrelic.com/docs/apis/get-started/intro-apis/types-new-relic-api-keys
.Parameter Type
  The type of notification channel to create. The CMDLet will only let you specify valid types.
.Parameter Configuration
  This is a JSON-formatted configuration. For a list of channel types and their JSON configurtions see https://rpm.newrelic.com/api/explore/alerts_channels/create
#>
Function Remove-NRNotificationChannel {
  [CMDLetBinding(SupportsShouldProcess = $true)]
  Param (
    [Parameter (Mandatory = $true)]
    [string] $APIKey,
    [Parameter (Mandatory = $true, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true)]
    [string] $ChannelId
  )
  Begin {
    $headers = @{
      'X-Api-Key' = $APIKey
    }
  }
  Process {
    $url = "https://api.newrelic.com/v2/alerts_channels/$ChannelId.json"
    if ($PSCmdlet.ShouldProcess($ChannelId,'Delete Notification Channel')) {
      Return Invoke-RestMethod $url -headers $headers -method 'Delete'
    }
  }
}