Public/New-AGMLibImage.ps1

# Copyright 2022 Google Inc. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.


Function New-AGMLibImage ([string]$appid,[string]$policyid,[string]$backuptype,[string]$capturetype,[string]$label,[switch][alias("m")]$monitor,[switch][alias("w")]$wait) 
{
    <#
    .SYNOPSIS
    Creates a new image
 
    .EXAMPLE
    New-AGMLibImage
    You will be prompted for Application ID
 
    .EXAMPLE
    New-AGMLibImage 2133445
    Create a new snapshot for AppID 2133445
 
    .EXAMPLE
    New-AGMLibImage -appid 2133445 -policyid 5678
    Create a new snapshot for AppID 2133445 using policyID 5678
    We learned the policy ID by using: Get-AGMLibPolicies -appid 2133445
 
    .EXAMPLE
    New-AGMLibImage -appid 2133445 -label "Dev image after upgrade"
    Create a new snapshot for AppID 2133445 with a label.
 
    .EXAMPLE
    New-AGMLibImage -appid 2133445 -backuptype log
    Create a new log snapshot for AppID 2133445
 
 
    .EXAMPLE
    New-AGMLibImage -appid 2133445 -backuptype log -m
    Create a new log snapshot for AppID 2133445 and monitor the resulting job to completion
 
 
    .DESCRIPTION
    A function to create new snapshot images
 
    * Databases with log protection
    If a database has log protection, you will need to specify -backuptype
 
    -backuptype log This will run a log snapshot
    -backuptype db This will run a DB snapshot
 
    * Monitoring options:
 
    -wait This will wait up to 2 minutes for the job to start, checking every 15 seconds to show you the job name
    -monitor Same as -wait but will also run Get-AGMLibFollowJobStatus to monitor the job to completion
 
    #>


    if ( (!($AGMSESSIONID)) -or (!($AGMIP)) )
    {
        Get-AGMErrorMessage -messagetoprint "Not logged in or session expired. Please login using Connect-AGM"
        return
    }
    $sessiontest = Get-AGMVersion
    if ($sessiontest.errormessage)
    {
        $sessiontest
        return
    }
    
    if ($capturetype)
    {
        $backuptype = $capturetype
    }


    if ($backuptype)
    {
        if (( $backuptype -ne "db") -and ( $backuptype -ne "log"))
        {
            Get-AGMErrorMessage -messagetoprint "Requested backuptype $backuptype is invalid, use either `'-backuptype db`' or `'-backuptype log`'"
            return
        }
    }
    if (!($backuptype))
    {
        $backuptype = ""
    }

    if (!($appid))
    {
        [string]$appid = Read-Host "AppID"
    }
    if ($policyid)
    {
        $policygrab = Get-AGMLibPolicies -appid $appid  | where-object { $_.id -eq $policyid }
        if ($policygrab.op.count -ne 1)
        {
            Get-AGMErrorMessage -messagetoprint "Failed to find policy ID $policyid for App ID $appid. Please check the Policy ID and AppID with Get-AGMLibApplicationID and Get-AGMLibPolicies"
            return
        }
        $policyname = $policygrab.name

    }


    if (!($policyid))
    {     
        $appgrab = Get-AGMApplication -filtervalue appid=$appid 
        $sltid = $appgrab.sla.slt.id
        if (!($sltid))
        {
            Get-AGMErrorMessage -messagetoprint "Failed to learn SLT ID for App ID $appid"
            return
        }
        else 
        {
        $policygrab = Get-AGMSltPolicy -id $sltid
        }
        if (!($policygrab))
        {
            Get-AGMErrorMessage -messagetoprint "Failed to learn Policies for SLT ID $sltid"
            return
        }
        else 
        {
            $policyid = $($policygrab | Where-Object {$_.op -eq "snap"} | Select-Object -last 1).id
            $policyname = $($policygrab | Where-Object {$_.op -eq "snap"} | Select-Object -last 1).name
            if (!($policyid))
            {
                $policyid = $($policygrab | Where-Object {$_.op -eq "DirectOnVault"} | Select-Object -last 1).id
                $policyname = $($policygrab | Where-Object {$_.op -eq "DirectOnVault"} | Select-Object -last 1).name
            }

            if (!($policyid))
            {
                Get-AGMErrorMessage -messagetoprint "Failed to learn any Policy ID for SLT ID $sltid"
                return
            }
        }
        # help the user
        write-host -nonewline  "Running this command: New-AGMLibImage -appid $appid -policyid $policyid"
        if ($backuptype) 
        {
            write-host -nonewline " -backuptype $backuptype"
        }
        if ($label) 
        {
            write-host -nonewline " -label $label"
        }
        write-host ""
    }
    

    # now create JSON
    $policy = @{id=$policyid}
    $body = [ordered]@{}
    if ($label)
    {
        $body += @{label=$label}
    }
    $body += @{policy=$policy}
    if ($backuptype)
    {
        $body += @{backuptype=$backuptype}
    }
    $json = $body | ConvertTo-Json
    $runbackup = Post-AGMAPIData  -endpoint /application/$appid/backup -body $json
    if ($runbackup.err_message)
    {
        $runbackup
        return
    }
    if ($monitor)
    {
        $wait = $true
    }
    if ($wait)
    {
        Start-Sleep -s 2
        $i=1
        while ($i -lt 9)
        {
            Clear-Host
            write-host "Checking for an on-demand job with Policyname `'$policyname`' for appid $appid)"
            $jobgrab = Get-AGMJob -filtervalue "appid=$appid&policyname=$policyname&isscheduled=False" -sort queuedate:desc -limit 1 
            if (!($jobgrab.jobname))
            {
                write-host "Job not running yet, will wait 15 seconds and check again. Check $i of 8"
                Start-Sleep -s 15
                $jobgrab = Get-AGMJob -filtervalue "appid=$appid&policyname=$policyname&isscheduled=False" -sort queuedate:desc -limit 1 
                if (!($jobgrab.jobname))
                {
                    $i++
                }
            }
            else
            {   
                $i=9
                if ($monitor)
                {
                    $jobgrab| select-object jobname,status,progress,queuedate,startdate,duration,targethost | Format-Table *
                }
                else 
                {
                    $jobgrab| select-object jobname,status,progress,queuedate,startdate,targethost
                }
            }
        }
        if (($jobgrab.jobname) -and ($monitor))
        {
            Get-AGMLibFollowJobStatus $jobgrab.jobname
        }
    }
}