1. Registry
  2. Packages
  3. Oracle Cloud Infrastructure
  4. API Docs
  5. ComputeInstanceAgent
  6. getInstanceAgentPlugins
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 Agent Plugins in Oracle Cloud Infrastructure Compute Instance Agent service.

    Gets information about the Oracle Cloud Agent plugins that are available on a specific compute instance.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as oci from "@pulumi/oci";
    
    const testInstanceAgentPlugins = oci.computeinstanceagent.getInstanceAgentPlugins({
        compartmentId: compartmentId,
        instanceagentId: instanceagent.id,
        name: instanceAgentPluginName,
        status: instanceAgentPluginStatus,
    });
    
    import pulumi
    import pulumi_oci as oci
    
    test_instance_agent_plugins = oci.computeinstanceagent.get_instance_agent_plugins(compartment_id=compartment_id,
        instanceagent_id=instanceagent["id"],
        name=instance_agent_plugin_name,
        status=instance_agent_plugin_status)
    
    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.GetInstanceAgentPlugins(ctx, &computeinstanceagent.GetInstanceAgentPluginsArgs{
    			CompartmentId:   compartmentId,
    			InstanceagentId: instanceagent.Id,
    			Name:            pulumi.StringRef(instanceAgentPluginName),
    			Status:          pulumi.StringRef(instanceAgentPluginStatus),
    		}, 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 testInstanceAgentPlugins = Oci.ComputeInstanceAgent.GetInstanceAgentPlugins.Invoke(new()
        {
            CompartmentId = compartmentId,
            InstanceagentId = instanceagent.Id,
            Name = instanceAgentPluginName,
            Status = instanceAgentPluginStatus,
        });
    
    });
    
    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.GetInstanceAgentPluginsArgs;
    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 testInstanceAgentPlugins = ComputeInstanceAgentFunctions.getInstanceAgentPlugins(GetInstanceAgentPluginsArgs.builder()
                .compartmentId(compartmentId)
                .instanceagentId(instanceagent.id())
                .name(instanceAgentPluginName)
                .status(instanceAgentPluginStatus)
                .build());
    
        }
    }
    
    variables:
      testInstanceAgentPlugins:
        fn::invoke:
          function: oci:ComputeInstanceAgent:getInstanceAgentPlugins
          arguments:
            compartmentId: ${compartmentId}
            instanceagentId: ${instanceagent.id}
            name: ${instanceAgentPluginName}
            status: ${instanceAgentPluginStatus}
    
    pulumi {
      required_providers {
        oci = {
          source = "pulumi/oci"
        }
      }
    }
    
    data "oci_computeinstanceagent_getinstanceagentplugins" "testInstanceAgentPlugins" {
      compartment_id   = compartmentId
      instanceagent_id = instanceagent.id
      name             = instanceAgentPluginName
      status           = instanceAgentPluginStatus
    }
    

    Using getInstanceAgentPlugins

    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 getInstanceAgentPlugins(args: GetInstanceAgentPluginsArgs, opts?: InvokeOptions): Promise<GetInstanceAgentPluginsResult>
    function getInstanceAgentPluginsOutput(args: GetInstanceAgentPluginsOutputArgs, opts?: InvokeOutputOptions): Output<GetInstanceAgentPluginsResult>
    def get_instance_agent_plugins(compartment_id: Optional[str] = None,
                                   filters: Optional[Sequence[GetInstanceAgentPluginsFilter]] = None,
                                   instanceagent_id: Optional[str] = None,
                                   name: Optional[str] = None,
                                   status: Optional[str] = None,
                                   opts: Optional[InvokeOptions] = None) -> GetInstanceAgentPluginsResult
    def get_instance_agent_plugins_output(compartment_id: pulumi.Input[Optional[str]] = None,
                                   filters: pulumi.Input[Optional[Sequence[pulumi.Input[GetInstanceAgentPluginsFilterArgs]]]] = None,
                                   instanceagent_id: pulumi.Input[Optional[str]] = None,
                                   name: pulumi.Input[Optional[str]] = None,
                                   status: pulumi.Input[Optional[str]] = None,
                                   opts: Optional[InvokeOutputOptions] = None) -> Output[GetInstanceAgentPluginsResult]
    func GetInstanceAgentPlugins(ctx *Context, args *GetInstanceAgentPluginsArgs, opts ...InvokeOption) (*GetInstanceAgentPluginsResult, error)
    func GetInstanceAgentPluginsOutput(ctx *Context, args *GetInstanceAgentPluginsOutputArgs, opts ...InvokeOption) GetInstanceAgentPluginsResultOutput

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

    public static class GetInstanceAgentPlugins 
    {
        public static Task<GetInstanceAgentPluginsResult> InvokeAsync(GetInstanceAgentPluginsArgs args, InvokeOptions? opts = null)
        public static Output<GetInstanceAgentPluginsResult> Invoke(GetInstanceAgentPluginsInvokeArgs args, InvokeOptions? opts = null)
        public static Output<GetInstanceAgentPluginsResult> Invoke(GetInstanceAgentPluginsInvokeArgs args, InvokeOutputOptions opts)
    }
    public static CompletableFuture<GetInstanceAgentPluginsResult> getInstanceAgentPlugins(GetInstanceAgentPluginsArgs args, InvokeOptions options)
    public static Output<GetInstanceAgentPluginsResult> getInstanceAgentPlugins(GetInstanceAgentPluginsArgs args, InvokeOptions options)
    public static Output<GetInstanceAgentPluginsResult> getInstanceAgentPlugins(GetInstanceAgentPluginsArgs args, InvokeOutputOptions options)
    
    fn::invoke:
      function: oci:ComputeInstanceAgent/getInstanceAgentPlugins:getInstanceAgentPlugins
      arguments:
        # arguments dictionary
    data "oci_compute_instance_agent_get_instance_agent_plugins" "name" {
        # arguments
    }

    The following arguments are supported:

    CompartmentId string
    The ID of the compartment in which the instance resides
    InstanceagentId string
    The OCID of the instance.
    Filters List<GetInstanceAgentPluginsFilter>
    Name string
    The plugin name.
    Status string
    The plugin status.
    CompartmentId string
    The ID of the compartment in which the instance resides
    InstanceagentId string
    The OCID of the instance.
    Filters []GetInstanceAgentPluginsFilter
    Name string
    The plugin name.
    Status string
    The plugin status.
    compartment_id string
    The ID of the compartment in which the instance resides
    instanceagent_id string
    The OCID of the instance.
    filters list(object)
    name string
    The plugin name.
    status string
    The plugin status.
    compartmentId String
    The ID of the compartment in which the instance resides
    instanceagentId String
    The OCID of the instance.
    filters List<GetInstanceAgentPluginsFilter>
    name String
    The plugin name.
    status String
    The plugin status.
    compartmentId string
    The ID of the compartment in which the instance resides
    instanceagentId string
    The OCID of the instance.
    filters GetInstanceAgentPluginsFilter[]
    name string
    The plugin name.
    status string
    The plugin status.
    compartment_id str
    The ID of the compartment in which the instance resides
    instanceagent_id str
    The OCID of the instance.
    filters Sequence[GetInstanceAgentPluginsFilter]
    name str
    The plugin name.
    status str
    The plugin status.
    compartmentId String
    The ID of the compartment in which the instance resides
    instanceagentId String
    The OCID of the instance.
    filters List<Property Map>
    name String
    The plugin name.
    status String
    The plugin status.

    getInstanceAgentPlugins Result

    The following output properties are available:

    CompartmentId string
    Id string
    The provider-assigned unique ID for this managed resource.
    InstanceAgentPlugins List<GetInstanceAgentPluginsInstanceAgentPlugin>
    The list of instance_agent_plugins.
    InstanceagentId string
    Filters List<GetInstanceAgentPluginsFilter>
    Name string
    The plugin name.
    Status string
    The plugin status.
    CompartmentId string
    Id string
    The provider-assigned unique ID for this managed resource.
    InstanceAgentPlugins []GetInstanceAgentPluginsInstanceAgentPlugin
    The list of instance_agent_plugins.
    InstanceagentId string
    Filters []GetInstanceAgentPluginsFilter
    Name string
    The plugin name.
    Status string
    The plugin status.
    compartment_id string
    id string
    The provider-assigned unique ID for this managed resource.
    instance_agent_plugins list(object)
    The list of instance_agent_plugins.
    instanceagent_id string
    filters list(object)
    name string
    The plugin name.
    status string
    The plugin status.
    compartmentId String
    id String
    The provider-assigned unique ID for this managed resource.
    instanceAgentPlugins List<GetInstanceAgentPluginsInstanceAgentPlugin>
    The list of instance_agent_plugins.
    instanceagentId String
    filters List<GetInstanceAgentPluginsFilter>
    name String
    The plugin name.
    status String
    The plugin status.
    compartmentId string
    id string
    The provider-assigned unique ID for this managed resource.
    instanceAgentPlugins GetInstanceAgentPluginsInstanceAgentPlugin[]
    The list of instance_agent_plugins.
    instanceagentId string
    filters GetInstanceAgentPluginsFilter[]
    name string
    The plugin name.
    status string
    The plugin status.
    compartment_id str
    id str
    The provider-assigned unique ID for this managed resource.
    instance_agent_plugins Sequence[GetInstanceAgentPluginsInstanceAgentPlugin]
    The list of instance_agent_plugins.
    instanceagent_id str
    filters Sequence[GetInstanceAgentPluginsFilter]
    name str
    The plugin name.
    status str
    The plugin status.
    compartmentId String
    id String
    The provider-assigned unique ID for this managed resource.
    instanceAgentPlugins List<Property Map>
    The list of instance_agent_plugins.
    instanceagentId String
    filters List<Property Map>
    name String
    The plugin name.
    status String
    The plugin status.

    Supporting Types

    GetInstanceAgentPluginsFilter

    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

    GetInstanceAgentPluginsInstanceAgentPlugin

    Message string
    An optional message from the plugin.
    Name string
    The plugin name.
    Status string
    The plugin status.
    TimeLastUpdatedUtc string
    The last updated time of the plugin, in UTC.
    Message string
    An optional message from the plugin.
    Name string
    The plugin name.
    Status string
    The plugin status.
    TimeLastUpdatedUtc string
    The last updated time of the plugin, in UTC.
    message string
    An optional message from the plugin.
    name string
    The plugin name.
    status string
    The plugin status.
    time_last_updated_utc string
    The last updated time of the plugin, in UTC.
    message String
    An optional message from the plugin.
    name String
    The plugin name.
    status String
    The plugin status.
    timeLastUpdatedUtc String
    The last updated time of the plugin, in UTC.
    message string
    An optional message from the plugin.
    name string
    The plugin name.
    status string
    The plugin status.
    timeLastUpdatedUtc string
    The last updated time of the plugin, in UTC.
    message str
    An optional message from the plugin.
    name str
    The plugin name.
    status str
    The plugin status.
    time_last_updated_utc str
    The last updated time of the plugin, in UTC.
    message String
    An optional message from the plugin.
    name String
    The plugin name.
    status String
    The plugin status.
    timeLastUpdatedUtc String
    The last updated time of the plugin, in UTC.

    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