Toolkit/Public/Suspend-RscSla.ps1

#Requires -Version 3
function Suspend-RscSla {
    <#
    .SYNOPSIS
    Resume RSC SLA (service level agreement).
    
    .DESCRIPTION
    The Suspend-RscSLA cmdlet is used to suspend a given
    SLA (service level agreement) on one or more clusters
    on which this SLA is applicable.
    The -SLAId parameter is used for identifying the SLA,
    this parameter is required.
    The -ClusterUuids specifies a list of cluster Uuids on
    which this SLA needs to be suspended.

    .LINK
    Schema reference:
    https://rubrikinc.github.io/rubrik-api-documentation/schema/reference

    .PARAMETER SlaId
    The Id of the SLA which needs to be resumed.

    .PARAMETER ClusterUuids
    The cluster IDs on which the SLA needs to be resumed.

    .PARAMETER AsQuery
    Instead of running the command, the query object is returned.

    .EXAMPLE
    Resume an SLA on two clusters on which it is applied.
    Resume-RscSLA -SlaId xxx-xxx -ClusterUuids yyy-yyy zzz-zzz
    #>


    [CmdletBinding(DefaultParameterSetName = "SuspendSLAInput")]
    Param(
        [Parameter(
            ParameterSetName = "SuspendSLAInput",
            Mandatory = $true,
            ValueFromPipelineByPropertyName = $true,
            HelpMessage = "The SLA ID which needs to be resumed"
        )]
        [String]$SlaId,

        [Parameter(
            ParameterSetName = "SuspendSLAInput",
            Mandatory = $true,
            ValueFromPipelineByPropertyName = $true,
            HelpMessage = "The list of cluster UUIDs on which the SLA is applied"
        )]
        [String[]]$ClusterUuids,

        [Parameter(
            Mandatory = $false,
            ValueFromPipeline = $false,
            HelpMessage = "Return the query object instead of running the query"
        )]
        [Switch]$AsQuery
    )

    Process {
        # Re-use existing connection, or create a new one (stop in case of error):
        Connect-Rsc -ErrorAction Stop | Out-Null

        $query = (New-RscMutationSla -op "Pause")
        $pauseSlaInput = Get-RscType -Name "PauseSlaInput" -InitialValues @{
            "slaId" = $SlaId
            "pauseSla" = $true
            "clusterUuids" = [System.Collections.Generic.List[string]]$ClusterUuids
        }
        $query.Var.input = $pauseSlaInput

        # Skip invoking the query, return the query object
        if ( $AsQuery ) {
            return $query
        }

        # Invoke the query
        $response = Invoke-Rsc -Query $query

        $response
    }
}