Functions/Public/catalog-service/Get-vRAResourceAction.psm1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
function Get-vRAResourceAction {
<#
    .SYNOPSIS
    Retrieve available Resource Actions for a resource
    
    .DESCRIPTION
    A resourceAction is a specific type of ResourceOperation that is performed by submitting a request.

    .PARAMETER ResourceId
    The id of the resource

    .INPUTS
    System.String

    .OUTPUTS
    System.Management.Automation.PSObject.

    .EXAMPLE
    Get-vRAConsumerResource -Name vm01 | Get-vRAResourceAction
    
    .EXAMPLE
    Get-vRAConsumerResource -Name vm01 | Get-vRAResourceAction | Select Id, Name, BindingId

#>

[CmdletBinding()][OutputType('System.Management.Automation.PSObject')]

    Param (

        [Parameter(Mandatory=$true,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true)]
        [ValidateNotNullOrEmpty()]
        [String[]]$ResourceId

    )

    Begin {

    }

    Process {

        try {

            foreach ($Id in $ResourceId) {

                # --- Set the uri
                $URI = "/catalog-service/api/consumer/resources/$($Id)/actions"

                # --- Get all available resource actions

                $Response = Invoke-vRARestMethod -Method GET -URI $URI -Verbose:$VerbosePreference

                if ($Response.content.Count -lt 1){

                    throw "No resource Actions available for the resource. Check the users entitlements."

                }

                foreach ($Action in $Response.content) {

                    [PSCustomObject] @{

                        Id = $Action.id
                        Name = $Action.name
                        Description = $Action.description
                        Type = $Action.type
                        ExtensionId = $Action.extensionId
                        ProviderTypeId = $Action.providerTypeId
                        BindingId = $Action.bindingId
                        IconId = $Action.iconId
                        HasForm = $Action.hasForm
                        FormScale = $Action.formScale

                    }

                }

            }

        }
        catch [Exception]{

            throw

        }

    }
    
    End {

    }

}