1. Registry
  2. Packages
  3. Oracle Cloud Infrastructure
  4. API Docs
  5. ComputeInstanceAgent
  6. getInstanceAvailablePlugin
Viewing docs for Oracle Cloud Infrastructure v4.22.0
published on Wednesday, Aug 26, 2026 by Pulumi
oci logo oci logo
Viewing docs for Oracle Cloud Infrastructure v4.22.0
published on Wednesday, Aug 26, 2026 by Pulumi

    This data source provides the list of Instance Available Plugins in Oracle Cloud Infrastructure Compute Instance Agent service.

    Lists the Oracle Cloud Agent plugins that are available for compute instances in a specific compartment.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as oci from "@pulumi/oci";
    
    const testInstanceAvailablePlugins = oci.computeinstanceagent.getInstanceAvailablePlugin({
        compartmentId: compartmentId,
        osName: instanceAvailablePluginOsName,
        osVersion: instanceAvailablePluginOsVersion,
        name: instanceAvailablePluginName,
    });
    
    import pulumi
    import pulumi_oci as oci
    
    test_instance_available_plugins = oci.computeinstanceagent.get_instance_available_plugin(compartment_id=compartment_id,
        os_name=instance_available_plugin_os_name,
        os_version=instance_available_plugin_os_version,
        name=instance_available_plugin_name)
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-oci/sdk/v4/go/oci/computeinstanceagent"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := computeinstanceagent.GetInstanceAvailablePlugin(ctx, &computeinstanceagent.GetInstanceAvailablePluginArgs{
    			CompartmentId: compartmentId,
    			OsName:        instanceAvailablePluginOsName,
    			OsVersion:     instanceAvailablePluginOsVersion,
    			Name:          pulumi.StringRef(instanceAvailablePluginName),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Oci = Pulumi.Oci;
    
    return await Deployment.RunAsync(() => 
    {
        var testInstanceAvailablePlugins = Oci.ComputeInstanceAgent.GetInstanceAvailablePlugin.Invoke(new()
        {
            CompartmentId = compartmentId,
            OsName = instanceAvailablePluginOsName,
            OsVersion = instanceAvailablePluginOsVersion,
            Name = instanceAvailablePluginName,
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.oci.ComputeInstanceAgent.ComputeInstanceAgentFunctions;
    import com.pulumi.oci.ComputeInstanceAgent.inputs.GetInstanceAvailablePluginArgs;
    import java.util.ArrayList;
    import java.util.Arrays;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            final var testInstanceAvailablePlugins = ComputeInstanceAgentFunctions.getInstanceAvailablePlugin(GetInstanceAvailablePluginArgs.builder()
                .compartmentId(compartmentId)
                .osName(instanceAvailablePluginOsName)
                .osVersion(instanceAvailablePluginOsVersion)
                .name(instanceAvailablePluginName)
                .build());
    
        }
    }
    
    variables:
      testInstanceAvailablePlugins:
        fn::invoke:
          function: oci:ComputeInstanceAgent:getInstanceAvailablePlugin
          arguments:
            compartmentId: ${compartmentId}
            osName: ${instanceAvailablePluginOsName}
            osVersion: ${instanceAvailablePluginOsVersion}
            name: ${instanceAvailablePluginName}
    
    pulumi {
      required_providers {
        oci = {
          source = "pulumi/oci"
        }
      }
    }
    
    data "oci_computeinstanceagent_getinstanceavailableplugin" "testInstanceAvailablePlugins" {
      compartment_id = compartmentId
      os_name        = instanceAvailablePluginOsName
      os_version     = instanceAvailablePluginOsVersion
      name           = instanceAvailablePluginName
    }
    

    Using getInstanceAvailablePlugin

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getInstanceAvailablePlugin(args: GetInstanceAvailablePluginArgs, opts?: InvokeOptions): Promise<GetInstanceAvailablePluginResult>
    function getInstanceAvailablePluginOutput(args: GetInstanceAvailablePluginOutputArgs, opts?: InvokeOutputOptions): Output<GetInstanceAvailablePluginResult>
    def get_instance_available_plugin(compartment_id: Optional[str] = None,
                                      filters: Optional[Sequence[GetInstanceAvailablePluginFilter]] = None,
                                      name: Optional[str] = None,
                                      os_name: Optional[str] = None,
                                      os_version: Optional[str] = None,
                                      opts: Optional[InvokeOptions] = None) -> GetInstanceAvailablePluginResult
    def get_instance_available_plugin_output(compartment_id: pulumi.Input[Optional[str]] = None,
                                      filters: pulumi.Input[Optional[Sequence[pulumi.Input[GetInstanceAvailablePluginFilterArgs]]]] = None,
                                      name: pulumi.Input[Optional[str]] = None,
                                      os_name: pulumi.Input[Optional[str]] = None,
                                      os_version: pulumi.Input[Optional[str]] = None,
                                      opts: Optional[InvokeOutputOptions] = None) -> Output[GetInstanceAvailablePluginResult]
    func GetInstanceAvailablePlugin(ctx *Context, args *GetInstanceAvailablePluginArgs, opts ...InvokeOption) (*GetInstanceAvailablePluginResult, error)
    func GetInstanceAvailablePluginOutput(ctx *Context, args *GetInstanceAvailablePluginOutputArgs, opts ...InvokeOption) GetInstanceAvailablePluginResultOutput

    > Note: This function is named GetInstanceAvailablePlugin in the Go SDK.

    public static class GetInstanceAvailablePlugin 
    {
        public static Task<GetInstanceAvailablePluginResult> InvokeAsync(GetInstanceAvailablePluginArgs args, InvokeOptions? opts = null)
        public static Output<GetInstanceAvailablePluginResult> Invoke(GetInstanceAvailablePluginInvokeArgs args, InvokeOptions? opts = null)
        public static Output<GetInstanceAvailablePluginResult> Invoke(GetInstanceAvailablePluginInvokeArgs args, InvokeOutputOptions opts)
    }
    public static CompletableFuture<GetInstanceAvailablePluginResult> getInstanceAvailablePlugin(GetInstanceAvailablePluginArgs args, InvokeOptions options)
    public static Output<GetInstanceAvailablePluginResult> getInstanceAvailablePlugin(GetInstanceAvailablePluginArgs args, InvokeOptions options)
    public static Output<GetInstanceAvailablePluginResult> getInstanceAvailablePlugin(GetInstanceAvailablePluginArgs args, InvokeOutputOptions options)
    
    fn::invoke:
      function: oci:ComputeInstanceAgent/getInstanceAvailablePlugin:getInstanceAvailablePlugin
      arguments:
        # arguments dictionary
    data "oci_compute_instance_agent_get_instance_available_plugin" "name" {
        # arguments
    }

    The following arguments are supported:

    CompartmentId string
    The ID of the compartment for which the plugins are available
    OsName string

    The image (OS) for the compute instance.

    If no match is found, all plugins are returned.

    Examples: CentOS, Oracle Linux, Oracle Autonomous Linux, Canonical Ubuntu, Windows Server

    OsVersion string

    The OS version for the instance.

    If no match is found, all plugins are returned.

    Examples: 9.6, 8 for CentOS and Oracle Linux. 22.04, 22.04 Minimal for Canonical Ubuntu. 2012 R2 Datacenter, 2019 Standard for Windows Server.

    Filters List<GetInstanceAvailablePluginFilter>
    Name string
    The plugin name.
    CompartmentId string
    The ID of the compartment for which the plugins are available
    OsName string

    The image (OS) for the compute instance.

    If no match is found, all plugins are returned.

    Examples: CentOS, Oracle Linux, Oracle Autonomous Linux, Canonical Ubuntu, Windows Server

    OsVersion string

    The OS version for the instance.

    If no match is found, all plugins are returned.

    Examples: 9.6, 8 for CentOS and Oracle Linux. 22.04, 22.04 Minimal for Canonical Ubuntu. 2012 R2 Datacenter, 2019 Standard for Windows Server.

    Filters []GetInstanceAvailablePluginFilter
    Name string
    The plugin name.
    compartment_id string
    The ID of the compartment for which the plugins are available
    os_name string

    The image (OS) for the compute instance.

    If no match is found, all plugins are returned.

    Examples: CentOS, Oracle Linux, Oracle Autonomous Linux, Canonical Ubuntu, Windows Server

    os_version string

    The OS version for the instance.

    If no match is found, all plugins are returned.

    Examples: 9.6, 8 for CentOS and Oracle Linux. 22.04, 22.04 Minimal for Canonical Ubuntu. 2012 R2 Datacenter, 2019 Standard for Windows Server.

    filters list(object)
    name string
    The plugin name.
    compartmentId String
    The ID of the compartment for which the plugins are available
    osName String

    The image (OS) for the compute instance.

    If no match is found, all plugins are returned.

    Examples: CentOS, Oracle Linux, Oracle Autonomous Linux, Canonical Ubuntu, Windows Server

    osVersion String

    The OS version for the instance.

    If no match is found, all plugins are returned.

    Examples: 9.6, 8 for CentOS and Oracle Linux. 22.04, 22.04 Minimal for Canonical Ubuntu. 2012 R2 Datacenter, 2019 Standard for Windows Server.

    filters List<GetInstanceAvailablePluginFilter>
    name String
    The plugin name.
    compartmentId string
    The ID of the compartment for which the plugins are available
    osName string

    The image (OS) for the compute instance.

    If no match is found, all plugins are returned.

    Examples: CentOS, Oracle Linux, Oracle Autonomous Linux, Canonical Ubuntu, Windows Server

    osVersion string

    The OS version for the instance.

    If no match is found, all plugins are returned.

    Examples: 9.6, 8 for CentOS and Oracle Linux. 22.04, 22.04 Minimal for Canonical Ubuntu. 2012 R2 Datacenter, 2019 Standard for Windows Server.

    filters GetInstanceAvailablePluginFilter[]
    name string
    The plugin name.
    compartment_id str
    The ID of the compartment for which the plugins are available
    os_name str

    The image (OS) for the compute instance.

    If no match is found, all plugins are returned.

    Examples: CentOS, Oracle Linux, Oracle Autonomous Linux, Canonical Ubuntu, Windows Server

    os_version str

    The OS version for the instance.

    If no match is found, all plugins are returned.

    Examples: 9.6, 8 for CentOS and Oracle Linux. 22.04, 22.04 Minimal for Canonical Ubuntu. 2012 R2 Datacenter, 2019 Standard for Windows Server.

    filters Sequence[GetInstanceAvailablePluginFilter]
    name str
    The plugin name.
    compartmentId String
    The ID of the compartment for which the plugins are available
    osName String

    The image (OS) for the compute instance.

    If no match is found, all plugins are returned.

    Examples: CentOS, Oracle Linux, Oracle Autonomous Linux, Canonical Ubuntu, Windows Server

    osVersion String

    The OS version for the instance.

    If no match is found, all plugins are returned.

    Examples: 9.6, 8 for CentOS and Oracle Linux. 22.04, 22.04 Minimal for Canonical Ubuntu. 2012 R2 Datacenter, 2019 Standard for Windows Server.

    filters List<Property Map>
    name String
    The plugin name.

    getInstanceAvailablePlugin Result

    The following output properties are available:

    AvailablePlugins List<GetInstanceAvailablePluginAvailablePlugin>
    The list of available_plugins.
    CompartmentId string
    Id string
    The provider-assigned unique ID for this managed resource.
    OsName string
    OsVersion string
    Filters List<GetInstanceAvailablePluginFilter>
    Name string
    The plugin name.
    AvailablePlugins []GetInstanceAvailablePluginAvailablePlugin
    The list of available_plugins.
    CompartmentId string
    Id string
    The provider-assigned unique ID for this managed resource.
    OsName string
    OsVersion string
    Filters []GetInstanceAvailablePluginFilter
    Name string
    The plugin name.
    available_plugins list(object)
    The list of available_plugins.
    compartment_id string
    id string
    The provider-assigned unique ID for this managed resource.
    os_name string
    os_version string
    filters list(object)
    name string
    The plugin name.
    availablePlugins List<GetInstanceAvailablePluginAvailablePlugin>
    The list of available_plugins.
    compartmentId String
    id String
    The provider-assigned unique ID for this managed resource.
    osName String
    osVersion String
    filters List<GetInstanceAvailablePluginFilter>
    name String
    The plugin name.
    availablePlugins GetInstanceAvailablePluginAvailablePlugin[]
    The list of available_plugins.
    compartmentId string
    id string
    The provider-assigned unique ID for this managed resource.
    osName string
    osVersion string
    filters GetInstanceAvailablePluginFilter[]
    name string
    The plugin name.
    available_plugins Sequence[GetInstanceAvailablePluginAvailablePlugin]
    The list of available_plugins.
    compartment_id str
    id str
    The provider-assigned unique ID for this managed resource.
    os_name str
    os_version str
    filters Sequence[GetInstanceAvailablePluginFilter]
    name str
    The plugin name.
    availablePlugins List<Property Map>
    The list of available_plugins.
    compartmentId String
    id String
    The provider-assigned unique ID for this managed resource.
    osName String
    osVersion String
    filters List<Property Map>
    name String
    The plugin name.

    Supporting Types

    GetInstanceAvailablePluginAvailablePlugin

    IsEnabledByDefault bool
    Whether the plugin is enabled or disabled by default.
    IsSupported bool
    Whether the plugin is supported.
    Name string
    The plugin name.
    Summary string
    A brief description of the plugin's functionality.
    IsEnabledByDefault bool
    Whether the plugin is enabled or disabled by default.
    IsSupported bool
    Whether the plugin is supported.
    Name string
    The plugin name.
    Summary string
    A brief description of the plugin's functionality.
    is_enabled_by_default bool
    Whether the plugin is enabled or disabled by default.
    is_supported bool
    Whether the plugin is supported.
    name string
    The plugin name.
    summary string
    A brief description of the plugin's functionality.
    isEnabledByDefault Boolean
    Whether the plugin is enabled or disabled by default.
    isSupported Boolean
    Whether the plugin is supported.
    name String
    The plugin name.
    summary String
    A brief description of the plugin's functionality.
    isEnabledByDefault boolean
    Whether the plugin is enabled or disabled by default.
    isSupported boolean
    Whether the plugin is supported.
    name string
    The plugin name.
    summary string
    A brief description of the plugin's functionality.
    is_enabled_by_default bool
    Whether the plugin is enabled or disabled by default.
    is_supported bool
    Whether the plugin is supported.
    name str
    The plugin name.
    summary str
    A brief description of the plugin's functionality.
    isEnabledByDefault Boolean
    Whether the plugin is enabled or disabled by default.
    isSupported Boolean
    Whether the plugin is supported.
    name String
    The plugin name.
    summary String
    A brief description of the plugin's functionality.

    GetInstanceAvailablePluginFilter

    Name string
    The plugin name.
    Values List<string>
    Regex bool
    Name string
    The plugin name.
    Values []string
    Regex bool
    name string
    The plugin name.
    values list(string)
    regex bool
    name String
    The plugin name.
    values List<String>
    regex Boolean
    name string
    The plugin name.
    values string[]
    regex boolean
    name str
    The plugin name.
    values Sequence[str]
    regex bool
    name String
    The plugin name.
    values List<String>
    regex Boolean

    Package Details

    Repository
    oci pulumi/pulumi-oci
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the oci Terraform Provider.
    oci logo oci logo
    Viewing docs for Oracle Cloud Infrastructure v4.22.0
    published on Wednesday, Aug 26, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial