Public/Import-EdgeSharedFlow.ps1

# Copyright 2017 Google Inc.
#
# 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
#
# https://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 Import-EdgeSharedFlow {
    <#
    .SYNOPSIS
        Import a sharedflow from a zip file or directory into Apigee Edge.

    .DESCRIPTION
        Import a sharedflow from a zip file or directory into Apigee Edge.

    .PARAMETER Name
        Required. The name to use for the sharedflow, once imported.

    .PARAMETER Source
        Required. A string, repreenting the source of the sharedflow bundle to import. This
        can be the name of a file, in zip format; or it can be the name of a directory, which
        this cmdlet will zip itself. In either case, the structure must be like so:

            .\sharedflowbundle
            .\sharedflowbundle\shared-flow-name.xml
            .\sharedflowbundle\sharedflows
            .\sharedflowbundle\sharedflows\flow1.xml
            .\sharedflowbundle\policies
            .\sharedflowbundle\policies\Policy1.xml
            .\sharedflowbundle\policies\...
            .\sharedflowbundle\resources
            .\sharedflowbundle\resources\...

    .PARAMETER Org
        Optional. The Apigee Edge organization. The default is to use the value from Set-EdgeConnection.

    .EXAMPLE
        Import-EdgeSharedFlow -Name log-to-splunk -Source logToSplunk.zip

    .EXAMPLE
        Import-EdgeSharedFlow -Name log-to-splunk -Source .\sflows\directory-containing-logToSplunk

    .LINK
       Import-EdgeApi

    .LINK
       Deploy-EdgeSharedFlow

    .LINK
       Export-EdgeSharedFlow

    .FUNCTIONALITY
        ApigeeEdge

    #>


    [cmdletbinding()]
    param(
        [Parameter(Mandatory=$True)][string]$Name,
        [Parameter(Mandatory=$True)][string]$Source,
        [string]$Org
    )

    if ($PSBoundParameters['Debug']) {
        $DebugPreference = 'Continue'
    }

    if (!$PSBoundParameters['Name']) {
      throw [System.ArgumentNullException] "Name", "You must specify the -Name option."
    }
    if (!$PSBoundParameters['Source']) {
      throw [System.ArgumentNullException] "Source", "You must specify the -Source option."
    }
    if( ! $PSBoundParameters.ContainsKey('Org')) {
      if( ! $MyInvocation.MyCommand.Module.PrivateData.Connection['Org']) {
        throw [System.ArgumentNullException] 'Org', "use the -Org parameter to specify the organization."
      }
      $Org = $MyInvocation.MyCommand.Module.PrivateData.Connection['Org']
    }

    #Import-EdgeAsset -Name $Name -Source $Source -Org $Org -FsPath "apiproxy" -UriPathElement "apis"
    Import-EdgeAsset -Name $Name -Source $Source -Org $Org -FsPath "sharedflowbundle" -UriPathElement "sharedflows"
}