Public/Create-EdgeKvmEntry.ps1
|
Function Create-EdgeKvmEntry { <# .SYNOPSIS Create a named entry in an existing key-value map in Apigee Edge. .DESCRIPTION Create a named entry in an existing key-value map in Apigee Edge. The KVM must exist, and the entry must not exist. This works only on CPS-enabled organizations. .PARAMETER Name Required. The name of the key-value map, in which the entry exists. .PARAMETER Entry Required. The name (or key) of the value to create. .PARAMETER Value Required. A string value to use for the entry. .PARAMETER Environment Optional. A string, the name of the environment with which the key-value map is associated. KVMs can be associated to an organization, an environment, or an API Proxy. If you specify neither Environment nor Proxy, the Name will be resolved in the list of organization-wide Key-Value Maps. .PARAMETER Proxy Optional. A string, the API Proxy within Apigee Edge with which the key-value map is associated. KVMs can be associated to an organization, an environment, or an API Proxy. If you specify neither Environment nor Proxy, the Name will be resolved in the list of organization-wide Key-Value Maps. .PARAMETER Org Optional. The Apigee Edge organization. The default is to use the value from Set-EdgeConnection. .EXAMPLE Create-EdgeKvmEntry -Name kvm101 -Environment test -Entry newkey1 -Value 'newly created value' .EXAMPLE Create-EdgeKvmEntry -Name kvm102 -Proxy api1 -Entry key1 -Value 'value for proxy-specific KVM' .LINK Delete-EdgeKvmEntry .LINK Update-EdgeKvmEntry .FUNCTIONALITY ApigeeEdge #> [cmdletbinding()] PARAM( [Parameter(Mandatory=$True)][string]$Name, [Parameter(Mandatory=$True)][string]$Entry, [Parameter(Mandatory=$True)][string]$Value, [string]$Environment, [string]$Proxy, [string]$Org ) $Options = @{ } if ($PSBoundParameters['Debug']) { $DebugPreference = 'Continue' $Options.Add( 'Debug', $Debug ) } if ($PSBoundParameters['Org']) { $Options.Add( 'Org', $Org ) } if ($PSBoundParameters.ContainsKey('Environment') -and $PSBoundParameters.ContainsKey('Proxy')) { throw [System.ArgumentException] "You may specify only one of -Environment and -Proxy." } if (!$PSBoundParameters['Name']) { throw [System.ArgumentNullException] "Name", "You must specify the -Name option." } if (!$PSBoundParameters['Entry']) { throw [System.ArgumentNullException] "Entry", "You must specify the -Entry option." } if (!$PSBoundParameters['Value']) { throw [System.ArgumentNullException] "Value", "You must specify the -Value option." } $basepath = if ($PSBoundParameters['Environment']) { $( Join-Parts -Separator '/' -Parts 'e', $Environment, 'keyvaluemaps' ) } elseif ($PSBoundParameters['Proxy']) { $(Join-Parts -Separator "/" -Parts 'apis', $Proxy, 'keyvaluemaps' ) } else { 'keyvaluemaps' } $Options.Add( 'Collection', $( Join-Parts -Separator '/' -Parts $basepath, $Name, 'entries' ) ) $Options.Add( 'Payload', @{ name = $Entry; value = $Value } ) Write-Debug ([string]::Format("Options {0}`n", $( ConvertTo-Json $Options -Compress ) ) ) Send-EdgeRequest @Options } |