Oracle Cloud Infrastructure v2.32.0, Apr 24 25

Oracle Cloud Infrastructure v2.32.0 published on Thursday, Apr 24, 2025 by Pulumi

oci.Core.getInstanceMaintenanceEvents

Explore with Pulumi AI

Oracle Cloud Infrastructure v2.32.0 published on Thursday, Apr 24, 2025 by Pulumi

Example Usage

TypeScript
Python
Go
C#
Java
YAML

import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";

const testInstanceMaintenanceEvents = oci.Core.getInstanceMaintenanceEvents({
    compartmentId: compartmentId,
    correlationToken: instanceMaintenanceEventCorrelationToken,
    instanceAction: instanceMaintenanceEventInstanceAction,
    instanceId: testInstance.id,
    state: instanceMaintenanceEventState,
    timeWindowStartGreaterThanOrEqualTo: instanceMaintenanceEventTimeWindowStartGreaterThanOrEqualTo,
    timeWindowStartLessThanOrEqualTo: instanceMaintenanceEventTimeWindowStartLessThanOrEqualTo,
});

import pulumi
import pulumi_oci as oci

test_instance_maintenance_events = oci.Core.get_instance_maintenance_events(compartment_id=compartment_id,
    correlation_token=instance_maintenance_event_correlation_token,
    instance_action=instance_maintenance_event_instance_action,
    instance_id=test_instance["id"],
    state=instance_maintenance_event_state,
    time_window_start_greater_than_or_equal_to=instance_maintenance_event_time_window_start_greater_than_or_equal_to,
    time_window_start_less_than_or_equal_to=instance_maintenance_event_time_window_start_less_than_or_equal_to)

package main

import (
	"github.com/pulumi/pulumi-oci/sdk/v2/go/oci/core"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := core.GetInstanceMaintenanceEvents(ctx, &core.GetInstanceMaintenanceEventsArgs{
			CompartmentId:                       compartmentId,
			CorrelationToken:                    pulumi.StringRef(instanceMaintenanceEventCorrelationToken),
			InstanceAction:                      pulumi.StringRef(instanceMaintenanceEventInstanceAction),
			InstanceId:                          pulumi.StringRef(testInstance.Id),
			State:                               pulumi.StringRef(instanceMaintenanceEventState),
			TimeWindowStartGreaterThanOrEqualTo: pulumi.StringRef(instanceMaintenanceEventTimeWindowStartGreaterThanOrEqualTo),
			TimeWindowStartLessThanOrEqualTo:    pulumi.StringRef(instanceMaintenanceEventTimeWindowStartLessThanOrEqualTo),
		}, 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 testInstanceMaintenanceEvents = Oci.Core.GetInstanceMaintenanceEvents.Invoke(new()
    {
        CompartmentId = compartmentId,
        CorrelationToken = instanceMaintenanceEventCorrelationToken,
        InstanceAction = instanceMaintenanceEventInstanceAction,
        InstanceId = testInstance.Id,
        State = instanceMaintenanceEventState,
        TimeWindowStartGreaterThanOrEqualTo = instanceMaintenanceEventTimeWindowStartGreaterThanOrEqualTo,
        TimeWindowStartLessThanOrEqualTo = instanceMaintenanceEventTimeWindowStartLessThanOrEqualTo,
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.Core.CoreFunctions;
import com.pulumi.oci.Core.inputs.GetInstanceMaintenanceEventsArgs;
import java.util.List;
import java.util.ArrayList;
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 testInstanceMaintenanceEvents = CoreFunctions.getInstanceMaintenanceEvents(GetInstanceMaintenanceEventsArgs.builder()
            .compartmentId(compartmentId)
            .correlationToken(instanceMaintenanceEventCorrelationToken)
            .instanceAction(instanceMaintenanceEventInstanceAction)
            .instanceId(testInstance.id())
            .state(instanceMaintenanceEventState)
            .timeWindowStartGreaterThanOrEqualTo(instanceMaintenanceEventTimeWindowStartGreaterThanOrEqualTo)
            .timeWindowStartLessThanOrEqualTo(instanceMaintenanceEventTimeWindowStartLessThanOrEqualTo)
            .build());

    }
}

variables:
  testInstanceMaintenanceEvents:
    fn::invoke:
      function: oci:Core:getInstanceMaintenanceEvents
      arguments:
        compartmentId: ${compartmentId}
        correlationToken: ${instanceMaintenanceEventCorrelationToken}
        instanceAction: ${instanceMaintenanceEventInstanceAction}
        instanceId: ${testInstance.id}
        state: ${instanceMaintenanceEventState}
        timeWindowStartGreaterThanOrEqualTo: ${instanceMaintenanceEventTimeWindowStartGreaterThanOrEqualTo}
        timeWindowStartLessThanOrEqualTo: ${instanceMaintenanceEventTimeWindowStartLessThanOrEqualTo}

Using getInstanceMaintenanceEvents

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.

TypeScript
Python
Go
C#
Java
YAML

function getInstanceMaintenanceEvents(args: GetInstanceMaintenanceEventsArgs, opts?: InvokeOptions): Promise<GetInstanceMaintenanceEventsResult>
function getInstanceMaintenanceEventsOutput(args: GetInstanceMaintenanceEventsOutputArgs, opts?: InvokeOptions): Output<GetInstanceMaintenanceEventsResult>

def get_instance_maintenance_events(compartment_id: Optional[str] = None,
                                    correlation_token: Optional[str] = None,
                                    filters: Optional[Sequence[_core.GetInstanceMaintenanceEventsFilter]] = None,
                                    instance_action: Optional[str] = None,
                                    instance_id: Optional[str] = None,
                                    state: Optional[str] = None,
                                    time_window_start_greater_than_or_equal_to: Optional[str] = None,
                                    time_window_start_less_than_or_equal_to: Optional[str] = None,
                                    opts: Optional[InvokeOptions] = None) -> GetInstanceMaintenanceEventsResult
def get_instance_maintenance_events_output(compartment_id: Optional[pulumi.Input[str]] = None,
                                    correlation_token: Optional[pulumi.Input[str]] = None,
                                    filters: Optional[pulumi.Input[Sequence[pulumi.Input[_core.GetInstanceMaintenanceEventsFilterArgs]]]] = None,
                                    instance_action: Optional[pulumi.Input[str]] = None,
                                    instance_id: Optional[pulumi.Input[str]] = None,
                                    state: Optional[pulumi.Input[str]] = None,
                                    time_window_start_greater_than_or_equal_to: Optional[pulumi.Input[str]] = None,
                                    time_window_start_less_than_or_equal_to: Optional[pulumi.Input[str]] = None,
                                    opts: Optional[InvokeOptions] = None) -> Output[GetInstanceMaintenanceEventsResult]

func GetInstanceMaintenanceEvents(ctx *Context, args *GetInstanceMaintenanceEventsArgs, opts ...InvokeOption) (*GetInstanceMaintenanceEventsResult, error)
func GetInstanceMaintenanceEventsOutput(ctx *Context, args *GetInstanceMaintenanceEventsOutputArgs, opts ...InvokeOption) GetInstanceMaintenanceEventsResultOutput

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

public static class GetInstanceMaintenanceEvents 
{
    public static Task<GetInstanceMaintenanceEventsResult> InvokeAsync(GetInstanceMaintenanceEventsArgs args, InvokeOptions? opts = null)
    public static Output<GetInstanceMaintenanceEventsResult> Invoke(GetInstanceMaintenanceEventsInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetInstanceMaintenanceEventsResult> getInstanceMaintenanceEvents(GetInstanceMaintenanceEventsArgs args, InvokeOptions options)
public static Output<GetInstanceMaintenanceEventsResult> getInstanceMaintenanceEvents(GetInstanceMaintenanceEventsArgs args, InvokeOptions options)

fn::invoke:
  function: oci:Core/getInstanceMaintenanceEvents:getInstanceMaintenanceEvents
  arguments:
    # arguments dictionary

The following arguments are supported:

CompartmentId string: The OCID of the compartment.
CorrelationToken string: A filter to only return resources that have a matching correlationToken.
Filters List<GetInstanceMaintenanceEventsFilter>
InstanceAction string: A filter to only return resources that match the given instance action.
InstanceId string: The OCID of the instance.
State string: A filter to only return resources that match the given lifecycle state.
TimeWindowStartGreaterThanOrEqualTo string: Starting range to return the maintenances which are not completed (date-time is in RFC3339 format).
TimeWindowStartLessThanOrEqualTo string: Ending range to return the maintenances which are not completed (date-time is in RFC3339 format).

CompartmentId string: The OCID of the compartment.
CorrelationToken string: A filter to only return resources that have a matching correlationToken.
Filters []GetInstanceMaintenanceEventsFilter
InstanceAction string: A filter to only return resources that match the given instance action.
InstanceId string: The OCID of the instance.
State string: A filter to only return resources that match the given lifecycle state.
TimeWindowStartGreaterThanOrEqualTo string: Starting range to return the maintenances which are not completed (date-time is in RFC3339 format).
TimeWindowStartLessThanOrEqualTo string: Ending range to return the maintenances which are not completed (date-time is in RFC3339 format).

compartmentId String: The OCID of the compartment.
correlationToken String: A filter to only return resources that have a matching correlationToken.
filters List<GetInstanceMaintenanceEventsFilter>
instanceAction String: A filter to only return resources that match the given instance action.
instanceId String: The OCID of the instance.
state String: A filter to only return resources that match the given lifecycle state.
timeWindowStartGreaterThanOrEqualTo String: Starting range to return the maintenances which are not completed (date-time is in RFC3339 format).
timeWindowStartLessThanOrEqualTo String: Ending range to return the maintenances which are not completed (date-time is in RFC3339 format).

compartmentId string: The OCID of the compartment.
correlationToken string: A filter to only return resources that have a matching correlationToken.
filters GetInstanceMaintenanceEventsFilter[]
instanceAction string: A filter to only return resources that match the given instance action.
instanceId string: The OCID of the instance.
state string: A filter to only return resources that match the given lifecycle state.
timeWindowStartGreaterThanOrEqualTo string: Starting range to return the maintenances which are not completed (date-time is in RFC3339 format).
timeWindowStartLessThanOrEqualTo string: Ending range to return the maintenances which are not completed (date-time is in RFC3339 format).

compartment_id str: The OCID of the compartment.
correlation_token str: A filter to only return resources that have a matching correlationToken.
filters Sequence[core.GetInstanceMaintenanceEventsFilter]
instance_action str: A filter to only return resources that match the given instance action.
instance_id str: The OCID of the instance.
state str: A filter to only return resources that match the given lifecycle state.
time_window_start_greater_than_or_equal_to str: Starting range to return the maintenances which are not completed (date-time is in RFC3339 format).
time_window_start_less_than_or_equal_to str: Ending range to return the maintenances which are not completed (date-time is in RFC3339 format).

compartmentId String: The OCID of the compartment.
correlationToken String: A filter to only return resources that have a matching correlationToken.
filters List<Property Map>
instanceAction String: A filter to only return resources that match the given instance action.
instanceId String: The OCID of the instance.
state String: A filter to only return resources that match the given lifecycle state.
timeWindowStartGreaterThanOrEqualTo String: Starting range to return the maintenances which are not completed (date-time is in RFC3339 format).
timeWindowStartLessThanOrEqualTo String: Ending range to return the maintenances which are not completed (date-time is in RFC3339 format).

getInstanceMaintenanceEvents Result

The following output properties are available:

CompartmentId string: The OCID of the compartment that contains the instance.
Id string: The provider-assigned unique ID for this managed resource.
InstanceMaintenanceEvents List<GetInstanceMaintenanceEventsInstanceMaintenanceEvent>: The list of instance_maintenance_events.
CorrelationToken string: A unique identifier that will group Instances that have a relationship with one another and must be scheduled together for the Maintenance to proceed. Any Instances that have a relationship with one another from a Maintenance perspective will have a matching correlationToken.
Filters List<GetInstanceMaintenanceEventsFilter>
InstanceAction string: This is the action that will be performed on the Instance by Oracle Cloud Infrastructure when the Maintenance begins.
InstanceId string: The OCID of the instance.
State string: The current state of the maintenance event.
TimeWindowStartGreaterThanOrEqualTo string
TimeWindowStartLessThanOrEqualTo string

CompartmentId string: The OCID of the compartment that contains the instance.
Id string: The provider-assigned unique ID for this managed resource.
InstanceMaintenanceEvents []GetInstanceMaintenanceEventsInstanceMaintenanceEvent: The list of instance_maintenance_events.
CorrelationToken string: A unique identifier that will group Instances that have a relationship with one another and must be scheduled together for the Maintenance to proceed. Any Instances that have a relationship with one another from a Maintenance perspective will have a matching correlationToken.
Filters []GetInstanceMaintenanceEventsFilter
InstanceAction string: This is the action that will be performed on the Instance by Oracle Cloud Infrastructure when the Maintenance begins.
InstanceId string: The OCID of the instance.
State string: The current state of the maintenance event.
TimeWindowStartGreaterThanOrEqualTo string
TimeWindowStartLessThanOrEqualTo string

compartmentId String: The OCID of the compartment that contains the instance.
id String: The provider-assigned unique ID for this managed resource.
instanceMaintenanceEvents List<GetInstanceMaintenanceEventsInstanceMaintenanceEvent>: The list of instance_maintenance_events.
correlationToken String: A unique identifier that will group Instances that have a relationship with one another and must be scheduled together for the Maintenance to proceed. Any Instances that have a relationship with one another from a Maintenance perspective will have a matching correlationToken.
filters List<GetInstanceMaintenanceEventsFilter>
instanceAction String: This is the action that will be performed on the Instance by Oracle Cloud Infrastructure when the Maintenance begins.
instanceId String: The OCID of the instance.
state String: The current state of the maintenance event.
timeWindowStartGreaterThanOrEqualTo String
timeWindowStartLessThanOrEqualTo String

compartmentId string: The OCID of the compartment that contains the instance.
id string: The provider-assigned unique ID for this managed resource.
instanceMaintenanceEvents GetInstanceMaintenanceEventsInstanceMaintenanceEvent[]: The list of instance_maintenance_events.
correlationToken string: A unique identifier that will group Instances that have a relationship with one another and must be scheduled together for the Maintenance to proceed. Any Instances that have a relationship with one another from a Maintenance perspective will have a matching correlationToken.
filters GetInstanceMaintenanceEventsFilter[]
instanceAction string: This is the action that will be performed on the Instance by Oracle Cloud Infrastructure when the Maintenance begins.
instanceId string: The OCID of the instance.
state string: The current state of the maintenance event.
timeWindowStartGreaterThanOrEqualTo string
timeWindowStartLessThanOrEqualTo string

compartment_id str: The OCID of the compartment that contains the instance.
id str: The provider-assigned unique ID for this managed resource.
instance_maintenance_events Sequence[core.GetInstanceMaintenanceEventsInstanceMaintenanceEvent]: The list of instance_maintenance_events.
correlation_token str: A unique identifier that will group Instances that have a relationship with one another and must be scheduled together for the Maintenance to proceed. Any Instances that have a relationship with one another from a Maintenance perspective will have a matching correlationToken.
filters Sequence[core.GetInstanceMaintenanceEventsFilter]
instance_action str: This is the action that will be performed on the Instance by Oracle Cloud Infrastructure when the Maintenance begins.
instance_id str: The OCID of the instance.
state str: The current state of the maintenance event.
time_window_start_greater_than_or_equal_to str
time_window_start_less_than_or_equal_to str

compartmentId String: The OCID of the compartment that contains the instance.
id String: The provider-assigned unique ID for this managed resource.
instanceMaintenanceEvents List<Property Map>: The list of instance_maintenance_events.
correlationToken String: A unique identifier that will group Instances that have a relationship with one another and must be scheduled together for the Maintenance to proceed. Any Instances that have a relationship with one another from a Maintenance perspective will have a matching correlationToken.
filters List<Property Map>
instanceAction String: This is the action that will be performed on the Instance by Oracle Cloud Infrastructure when the Maintenance begins.
instanceId String: The OCID of the instance.
state String: The current state of the maintenance event.
timeWindowStartGreaterThanOrEqualTo String
timeWindowStartLessThanOrEqualTo String

Supporting Types

GetInstanceMaintenanceEventsFilter

Name string
Values List<string>
Regex bool

Name string
Values []string
Regex bool

name String
values List<String>
regex Boolean

name string
values string[]
regex boolean

name str
values Sequence[str]
regex bool

name String
values List<String>
regex Boolean

GetInstanceMaintenanceEventsInstanceMaintenanceEvent

AdditionalDetails Dictionary<string, string>: Additional details of the maintenance in the form of json.
AlternativeResolutionAction string
AlternativeResolutionActions List<string>: These are alternative actions to the requested instanceAction that can be taken to resolve the Maintenance.
CanDeleteLocalStorage bool: For Instances that have local storage, this field is set to true when local storage will be deleted as a result of the Maintenance.
CanReschedule bool: Indicates if this MaintenanceEvent is capable of being rescheduled up to the timeHardDueDate.
CompartmentId string: The OCID of the compartment.
CorrelationToken string: A filter to only return resources that have a matching correlationToken.
CreatedBy string: The creator of the maintenance event.
DefinedTags Dictionary<string, string>: Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
Description string: It is the descriptive information about the maintenance taking place on the customer instance.
DisplayName string: A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
EstimatedDuration string: This is the estimated duration of the Maintenance, once the Maintenance has entered the STARTED state.
FreeformTags Dictionary<string, string>: Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
Id string: The OCID of the maintenance event.
InstanceAction string: A filter to only return resources that match the given instance action.
InstanceId string: The OCID of the instance.
InstanceMaintenanceEventId string
MaintenanceCategory string: This indicates the priority and allowed actions for this Maintenance. Higher priority forms of Maintenance have tighter restrictions and may not be rescheduled, while lower priority/severity Maintenance can be rescheduled, deferred, or even cancelled. Please see the Instance Maintenance documentation for details.
MaintenanceReason string: This is the reason that Maintenance is being performed. See Instance Maintenance documentation for details.
StartWindowDuration string: The duration of the time window Maintenance is scheduled to begin within.
State string: A filter to only return resources that match the given lifecycle state.
TimeCreated string: The date and time the maintenance event was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
TimeFinished string: The time at which the Maintenance actually finished.
TimeHardDueDate string: It is the scheduled hard due date and time of the maintenance event. The maintenance event will happen at this time and the due date will not be extended.
TimeStarted string: The time at which the Maintenance actually started.
TimeWindowStart string: The beginning of the time window when Maintenance is scheduled to begin. The Maintenance will not begin before this time.

AdditionalDetails map[string]string: Additional details of the maintenance in the form of json.
AlternativeResolutionAction string
AlternativeResolutionActions []string: These are alternative actions to the requested instanceAction that can be taken to resolve the Maintenance.
CanDeleteLocalStorage bool: For Instances that have local storage, this field is set to true when local storage will be deleted as a result of the Maintenance.
CanReschedule bool: Indicates if this MaintenanceEvent is capable of being rescheduled up to the timeHardDueDate.
CompartmentId string: The OCID of the compartment.
CorrelationToken string: A filter to only return resources that have a matching correlationToken.
CreatedBy string: The creator of the maintenance event.
DefinedTags map[string]string: Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
Description string: It is the descriptive information about the maintenance taking place on the customer instance.
DisplayName string: A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
EstimatedDuration string: This is the estimated duration of the Maintenance, once the Maintenance has entered the STARTED state.
FreeformTags map[string]string: Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
Id string: The OCID of the maintenance event.
InstanceAction string: A filter to only return resources that match the given instance action.
InstanceId string: The OCID of the instance.
InstanceMaintenanceEventId string
MaintenanceCategory string: This indicates the priority and allowed actions for this Maintenance. Higher priority forms of Maintenance have tighter restrictions and may not be rescheduled, while lower priority/severity Maintenance can be rescheduled, deferred, or even cancelled. Please see the Instance Maintenance documentation for details.
MaintenanceReason string: This is the reason that Maintenance is being performed. See Instance Maintenance documentation for details.
StartWindowDuration string: The duration of the time window Maintenance is scheduled to begin within.
State string: A filter to only return resources that match the given lifecycle state.
TimeCreated string: The date and time the maintenance event was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
TimeFinished string: The time at which the Maintenance actually finished.
TimeHardDueDate string: It is the scheduled hard due date and time of the maintenance event. The maintenance event will happen at this time and the due date will not be extended.
TimeStarted string: The time at which the Maintenance actually started.
TimeWindowStart string: The beginning of the time window when Maintenance is scheduled to begin. The Maintenance will not begin before this time.

additionalDetails Map<String,String>: Additional details of the maintenance in the form of json.
alternativeResolutionAction String
alternativeResolutionActions List<String>: These are alternative actions to the requested instanceAction that can be taken to resolve the Maintenance.
canDeleteLocalStorage Boolean: For Instances that have local storage, this field is set to true when local storage will be deleted as a result of the Maintenance.
canReschedule Boolean: Indicates if this MaintenanceEvent is capable of being rescheduled up to the timeHardDueDate.
compartmentId String: The OCID of the compartment.
correlationToken String: A filter to only return resources that have a matching correlationToken.
createdBy String: The creator of the maintenance event.
definedTags Map<String,String>: Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
description String: It is the descriptive information about the maintenance taking place on the customer instance.
displayName String: A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
estimatedDuration String: This is the estimated duration of the Maintenance, once the Maintenance has entered the STARTED state.
freeformTags Map<String,String>: Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
id String: The OCID of the maintenance event.
instanceAction String: A filter to only return resources that match the given instance action.
instanceId String: The OCID of the instance.
instanceMaintenanceEventId String
maintenanceCategory String: This indicates the priority and allowed actions for this Maintenance. Higher priority forms of Maintenance have tighter restrictions and may not be rescheduled, while lower priority/severity Maintenance can be rescheduled, deferred, or even cancelled. Please see the Instance Maintenance documentation for details.
maintenanceReason String: This is the reason that Maintenance is being performed. See Instance Maintenance documentation for details.
startWindowDuration String: The duration of the time window Maintenance is scheduled to begin within.
state String: A filter to only return resources that match the given lifecycle state.
timeCreated String: The date and time the maintenance event was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
timeFinished String: The time at which the Maintenance actually finished.
timeHardDueDate String: It is the scheduled hard due date and time of the maintenance event. The maintenance event will happen at this time and the due date will not be extended.
timeStarted String: The time at which the Maintenance actually started.
timeWindowStart String: The beginning of the time window when Maintenance is scheduled to begin. The Maintenance will not begin before this time.

additionalDetails {[key: string]: string}: Additional details of the maintenance in the form of json.
alternativeResolutionAction string
alternativeResolutionActions string[]: These are alternative actions to the requested instanceAction that can be taken to resolve the Maintenance.
canDeleteLocalStorage boolean: For Instances that have local storage, this field is set to true when local storage will be deleted as a result of the Maintenance.
canReschedule boolean: Indicates if this MaintenanceEvent is capable of being rescheduled up to the timeHardDueDate.
compartmentId string: The OCID of the compartment.
correlationToken string: A filter to only return resources that have a matching correlationToken.
createdBy string: The creator of the maintenance event.
definedTags {[key: string]: string}: Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
description string: It is the descriptive information about the maintenance taking place on the customer instance.
displayName string: A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
estimatedDuration string: This is the estimated duration of the Maintenance, once the Maintenance has entered the STARTED state.
freeformTags {[key: string]: string}: Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
id string: The OCID of the maintenance event.
instanceAction string: A filter to only return resources that match the given instance action.
instanceId string: The OCID of the instance.
instanceMaintenanceEventId string
maintenanceCategory string: This indicates the priority and allowed actions for this Maintenance. Higher priority forms of Maintenance have tighter restrictions and may not be rescheduled, while lower priority/severity Maintenance can be rescheduled, deferred, or even cancelled. Please see the Instance Maintenance documentation for details.
maintenanceReason string: This is the reason that Maintenance is being performed. See Instance Maintenance documentation for details.
startWindowDuration string: The duration of the time window Maintenance is scheduled to begin within.
state string: A filter to only return resources that match the given lifecycle state.
timeCreated string: The date and time the maintenance event was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
timeFinished string: The time at which the Maintenance actually finished.
timeHardDueDate string: It is the scheduled hard due date and time of the maintenance event. The maintenance event will happen at this time and the due date will not be extended.
timeStarted string: The time at which the Maintenance actually started.
timeWindowStart string: The beginning of the time window when Maintenance is scheduled to begin. The Maintenance will not begin before this time.

additional_details Mapping[str, str]: Additional details of the maintenance in the form of json.
alternative_resolution_action str
alternative_resolution_actions Sequence[str]: These are alternative actions to the requested instanceAction that can be taken to resolve the Maintenance.
can_delete_local_storage bool: For Instances that have local storage, this field is set to true when local storage will be deleted as a result of the Maintenance.
can_reschedule bool: Indicates if this MaintenanceEvent is capable of being rescheduled up to the timeHardDueDate.
compartment_id str: The OCID of the compartment.
correlation_token str: A filter to only return resources that have a matching correlationToken.
created_by str: The creator of the maintenance event.
defined_tags Mapping[str, str]: Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
description str: It is the descriptive information about the maintenance taking place on the customer instance.
display_name str: A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
estimated_duration str: This is the estimated duration of the Maintenance, once the Maintenance has entered the STARTED state.
freeform_tags Mapping[str, str]: Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
id str: The OCID of the maintenance event.
instance_action str: A filter to only return resources that match the given instance action.
instance_id str: The OCID of the instance.
instance_maintenance_event_id str
maintenance_category str: This indicates the priority and allowed actions for this Maintenance. Higher priority forms of Maintenance have tighter restrictions and may not be rescheduled, while lower priority/severity Maintenance can be rescheduled, deferred, or even cancelled. Please see the Instance Maintenance documentation for details.
maintenance_reason str: This is the reason that Maintenance is being performed. See Instance Maintenance documentation for details.
start_window_duration str: The duration of the time window Maintenance is scheduled to begin within.
state str: A filter to only return resources that match the given lifecycle state.
time_created str: The date and time the maintenance event was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
time_finished str: The time at which the Maintenance actually finished.
time_hard_due_date str: It is the scheduled hard due date and time of the maintenance event. The maintenance event will happen at this time and the due date will not be extended.
time_started str: The time at which the Maintenance actually started.
time_window_start str: The beginning of the time window when Maintenance is scheduled to begin. The Maintenance will not begin before this time.

additionalDetails Map<String>: Additional details of the maintenance in the form of json.
alternativeResolutionAction String
alternativeResolutionActions List<String>: These are alternative actions to the requested instanceAction that can be taken to resolve the Maintenance.
canDeleteLocalStorage Boolean: For Instances that have local storage, this field is set to true when local storage will be deleted as a result of the Maintenance.
canReschedule Boolean: Indicates if this MaintenanceEvent is capable of being rescheduled up to the timeHardDueDate.
compartmentId String: The OCID of the compartment.
correlationToken String: A filter to only return resources that have a matching correlationToken.
createdBy String: The creator of the maintenance event.
definedTags Map<String>: Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
description String: It is the descriptive information about the maintenance taking place on the customer instance.
displayName String: A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
estimatedDuration String: This is the estimated duration of the Maintenance, once the Maintenance has entered the STARTED state.
freeformTags Map<String>: Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
id String: The OCID of the maintenance event.
instanceAction String: A filter to only return resources that match the given instance action.
instanceId String: The OCID of the instance.
instanceMaintenanceEventId String
maintenanceCategory String: This indicates the priority and allowed actions for this Maintenance. Higher priority forms of Maintenance have tighter restrictions and may not be rescheduled, while lower priority/severity Maintenance can be rescheduled, deferred, or even cancelled. Please see the Instance Maintenance documentation for details.
maintenanceReason String: This is the reason that Maintenance is being performed. See Instance Maintenance documentation for details.
startWindowDuration String: The duration of the time window Maintenance is scheduled to begin within.
state String: A filter to only return resources that match the given lifecycle state.
timeCreated String: The date and time the maintenance event was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
timeFinished String: The time at which the Maintenance actually finished.
timeHardDueDate String: It is the scheduled hard due date and time of the maintenance event. The maintenance event will happen at this time and the due date will not be extended.
timeStarted String: The time at which the Maintenance actually started.
timeWindowStart String: The beginning of the time window when Maintenance is scheduled to begin. The Maintenance will not begin before this time.

Package Details

Repository: oci pulumi/pulumi-oci
License: Apache-2.0
Notes: This Pulumi package is based on the oci Terraform Provider.

Oracle Cloud Infrastructure v2.32.0 published on Thursday, Apr 24, 2025 by Pulumi

pulumi/pulumi-oci

oci.Core.getInstanceMaintenanceEvents

On this page

On this page

Example Usage

Using getInstanceMaintenanceEvents

getInstanceMaintenanceEvents Result

Supporting Types

GetInstanceMaintenanceEventsFilter

GetInstanceMaintenanceEventsInstanceMaintenanceEvent

Package Details

On this page

On this page