Oracle Cloud Infrastructure v3.10.0 published on Wednesday, Nov 5, 2025 by Pulumi
oci.FleetAppsManagement.getMaintenanceWindows
Start a Neo task
Explain and create an oci.FleetAppsManagement.getMaintenanceWindows resource
This data source provides the list of Maintenance Windows in Oracle Cloud Infrastructure Fleet Apps Management service.
Returns a list of all the Maintenance Windows in the specified compartment.
The query parameter compartmentId is required unless the query parameter id is specified.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";
const testMaintenanceWindows = oci.FleetAppsManagement.getMaintenanceWindows({
compartmentId: compartmentId,
displayName: maintenanceWindowDisplayName,
id: maintenanceWindowId,
state: maintenanceWindowState,
timeScheduleStartGreaterThanOrEqualTo: maintenanceWindowTimeScheduleStartGreaterThanOrEqualTo,
});
import pulumi
import pulumi_oci as oci
test_maintenance_windows = oci.FleetAppsManagement.get_maintenance_windows(compartment_id=compartment_id,
display_name=maintenance_window_display_name,
id=maintenance_window_id,
state=maintenance_window_state,
time_schedule_start_greater_than_or_equal_to=maintenance_window_time_schedule_start_greater_than_or_equal_to)
package main
import (
"github.com/pulumi/pulumi-oci/sdk/v3/go/oci/fleetappsmanagement"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := fleetappsmanagement.GetMaintenanceWindows(ctx, &fleetappsmanagement.GetMaintenanceWindowsArgs{
CompartmentId: pulumi.StringRef(compartmentId),
DisplayName: pulumi.StringRef(maintenanceWindowDisplayName),
Id: pulumi.StringRef(maintenanceWindowId),
State: pulumi.StringRef(maintenanceWindowState),
TimeScheduleStartGreaterThanOrEqualTo: pulumi.StringRef(maintenanceWindowTimeScheduleStartGreaterThanOrEqualTo),
}, 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 testMaintenanceWindows = Oci.FleetAppsManagement.GetMaintenanceWindows.Invoke(new()
{
CompartmentId = compartmentId,
DisplayName = maintenanceWindowDisplayName,
Id = maintenanceWindowId,
State = maintenanceWindowState,
TimeScheduleStartGreaterThanOrEqualTo = maintenanceWindowTimeScheduleStartGreaterThanOrEqualTo,
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.FleetAppsManagement.FleetAppsManagementFunctions;
import com.pulumi.oci.FleetAppsManagement.inputs.GetMaintenanceWindowsArgs;
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 testMaintenanceWindows = FleetAppsManagementFunctions.getMaintenanceWindows(GetMaintenanceWindowsArgs.builder()
.compartmentId(compartmentId)
.displayName(maintenanceWindowDisplayName)
.id(maintenanceWindowId)
.state(maintenanceWindowState)
.timeScheduleStartGreaterThanOrEqualTo(maintenanceWindowTimeScheduleStartGreaterThanOrEqualTo)
.build());
}
}
variables:
testMaintenanceWindows:
fn::invoke:
function: oci:FleetAppsManagement:getMaintenanceWindows
arguments:
compartmentId: ${compartmentId}
displayName: ${maintenanceWindowDisplayName}
id: ${maintenanceWindowId}
state: ${maintenanceWindowState}
timeScheduleStartGreaterThanOrEqualTo: ${maintenanceWindowTimeScheduleStartGreaterThanOrEqualTo}
Using getMaintenanceWindows
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 getMaintenanceWindows(args: GetMaintenanceWindowsArgs, opts?: InvokeOptions): Promise<GetMaintenanceWindowsResult>
function getMaintenanceWindowsOutput(args: GetMaintenanceWindowsOutputArgs, opts?: InvokeOptions): Output<GetMaintenanceWindowsResult>def get_maintenance_windows(compartment_id: Optional[str] = None,
display_name: Optional[str] = None,
filters: Optional[Sequence[GetMaintenanceWindowsFilter]] = None,
id: Optional[str] = None,
state: Optional[str] = None,
time_schedule_start_greater_than_or_equal_to: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetMaintenanceWindowsResult
def get_maintenance_windows_output(compartment_id: Optional[pulumi.Input[str]] = None,
display_name: Optional[pulumi.Input[str]] = None,
filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetMaintenanceWindowsFilterArgs]]]] = None,
id: Optional[pulumi.Input[str]] = None,
state: Optional[pulumi.Input[str]] = None,
time_schedule_start_greater_than_or_equal_to: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetMaintenanceWindowsResult]func GetMaintenanceWindows(ctx *Context, args *GetMaintenanceWindowsArgs, opts ...InvokeOption) (*GetMaintenanceWindowsResult, error)
func GetMaintenanceWindowsOutput(ctx *Context, args *GetMaintenanceWindowsOutputArgs, opts ...InvokeOption) GetMaintenanceWindowsResultOutput> Note: This function is named GetMaintenanceWindows in the Go SDK.
public static class GetMaintenanceWindows
{
public static Task<GetMaintenanceWindowsResult> InvokeAsync(GetMaintenanceWindowsArgs args, InvokeOptions? opts = null)
public static Output<GetMaintenanceWindowsResult> Invoke(GetMaintenanceWindowsInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetMaintenanceWindowsResult> getMaintenanceWindows(GetMaintenanceWindowsArgs args, InvokeOptions options)
public static Output<GetMaintenanceWindowsResult> getMaintenanceWindows(GetMaintenanceWindowsArgs args, InvokeOptions options)
fn::invoke:
function: oci:FleetAppsManagement/getMaintenanceWindows:getMaintenanceWindows
arguments:
# arguments dictionaryThe following arguments are supported:
- Compartment
Id string - The ID of the compartment in which to list resources. Empty only if the resource OCID query param is not specified.
- Display
Name string - A filter to return only resources that match the entire display name given.
- Filters
List<Get
Maintenance Windows Filter> - Id string
- Unique identifier or OCID for listing a single maintenance window by id. Either compartmentId or id must be provided.
- State string
- A filter to return only resources whose lifecycleState matches the given lifecycleState.
- Time
Schedule stringStart Greater Than Or Equal To - A filter to return only resources whose timeScheduleStart is greater than or equal to the provided date and time.
- Compartment
Id string - The ID of the compartment in which to list resources. Empty only if the resource OCID query param is not specified.
- Display
Name string - A filter to return only resources that match the entire display name given.
- Filters
[]Get
Maintenance Windows Filter - Id string
- Unique identifier or OCID for listing a single maintenance window by id. Either compartmentId or id must be provided.
- State string
- A filter to return only resources whose lifecycleState matches the given lifecycleState.
- Time
Schedule stringStart Greater Than Or Equal To - A filter to return only resources whose timeScheduleStart is greater than or equal to the provided date and time.
- compartment
Id String - The ID of the compartment in which to list resources. Empty only if the resource OCID query param is not specified.
- display
Name String - A filter to return only resources that match the entire display name given.
- filters
List<Get
Maintenance Windows Filter> - id String
- Unique identifier or OCID for listing a single maintenance window by id. Either compartmentId or id must be provided.
- state String
- A filter to return only resources whose lifecycleState matches the given lifecycleState.
- time
Schedule StringStart Greater Than Or Equal To - A filter to return only resources whose timeScheduleStart is greater than or equal to the provided date and time.
- compartment
Id string - The ID of the compartment in which to list resources. Empty only if the resource OCID query param is not specified.
- display
Name string - A filter to return only resources that match the entire display name given.
- filters
Get
Maintenance Windows Filter[] - id string
- Unique identifier or OCID for listing a single maintenance window by id. Either compartmentId or id must be provided.
- state string
- A filter to return only resources whose lifecycleState matches the given lifecycleState.
- time
Schedule stringStart Greater Than Or Equal To - A filter to return only resources whose timeScheduleStart is greater than or equal to the provided date and time.
- compartment_
id str - The ID of the compartment in which to list resources. Empty only if the resource OCID query param is not specified.
- display_
name str - A filter to return only resources that match the entire display name given.
- filters
Sequence[Get
Maintenance Windows Filter] - id str
- Unique identifier or OCID for listing a single maintenance window by id. Either compartmentId or id must be provided.
- state str
- A filter to return only resources whose lifecycleState matches the given lifecycleState.
- time_
schedule_ strstart_ greater_ than_ or_ equal_ to - A filter to return only resources whose timeScheduleStart is greater than or equal to the provided date and time.
- compartment
Id String - The ID of the compartment in which to list resources. Empty only if the resource OCID query param is not specified.
- display
Name String - A filter to return only resources that match the entire display name given.
- filters List<Property Map>
- id String
- Unique identifier or OCID for listing a single maintenance window by id. Either compartmentId or id must be provided.
- state String
- A filter to return only resources whose lifecycleState matches the given lifecycleState.
- time
Schedule StringStart Greater Than Or Equal To - A filter to return only resources whose timeScheduleStart is greater than or equal to the provided date and time.
getMaintenanceWindows Result
The following output properties are available:
- Maintenance
Window List<GetCollections Maintenance Windows Maintenance Window Collection> - The list of maintenance_window_collection.
- Compartment
Id string - Compartment OCID
- Display
Name string - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. Example:
My new resource - Filters
List<Get
Maintenance Windows Filter> - Id string
- The OCID of the resource.
- State string
- The current state of the MaintenanceWindow.
- Time
Schedule stringStart Greater Than Or Equal To
- Maintenance
Window []GetCollections Maintenance Windows Maintenance Window Collection - The list of maintenance_window_collection.
- Compartment
Id string - Compartment OCID
- Display
Name string - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. Example:
My new resource - Filters
[]Get
Maintenance Windows Filter - Id string
- The OCID of the resource.
- State string
- The current state of the MaintenanceWindow.
- Time
Schedule stringStart Greater Than Or Equal To
- maintenance
Window List<GetCollections Maintenance Windows Maintenance Window Collection> - The list of maintenance_window_collection.
- compartment
Id String - Compartment OCID
- display
Name String - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. Example:
My new resource - filters
List<Get
Maintenance Windows Filter> - id String
- The OCID of the resource.
- state String
- The current state of the MaintenanceWindow.
- time
Schedule StringStart Greater Than Or Equal To
- maintenance
Window GetCollections Maintenance Windows Maintenance Window Collection[] - The list of maintenance_window_collection.
- compartment
Id string - Compartment OCID
- display
Name string - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. Example:
My new resource - filters
Get
Maintenance Windows Filter[] - id string
- The OCID of the resource.
- state string
- The current state of the MaintenanceWindow.
- time
Schedule stringStart Greater Than Or Equal To
- maintenance_
window_ Sequence[Getcollections Maintenance Windows Maintenance Window Collection] - The list of maintenance_window_collection.
- compartment_
id str - Compartment OCID
- display_
name str - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. Example:
My new resource - filters
Sequence[Get
Maintenance Windows Filter] - id str
- The OCID of the resource.
- state str
- The current state of the MaintenanceWindow.
- time_
schedule_ strstart_ greater_ than_ or_ equal_ to
- maintenance
Window List<Property Map>Collections - The list of maintenance_window_collection.
- compartment
Id String - Compartment OCID
- display
Name String - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. Example:
My new resource - filters List<Property Map>
- id String
- The OCID of the resource.
- state String
- The current state of the MaintenanceWindow.
- time
Schedule StringStart Greater Than Or Equal To
Supporting Types
GetMaintenanceWindowsFilter
GetMaintenanceWindowsMaintenanceWindowCollection
GetMaintenanceWindowsMaintenanceWindowCollectionItem
- Compartment
Id string - The ID of the compartment in which to list resources. Empty only if the resource OCID query param is not specified.
- Dictionary<string, string>
- Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"} - Description string
- A user-friendly description. To provide some insight about the resource. Avoid entering confidential information.
- Display
Name string - A filter to return only resources that match the entire display name given.
- Duration string
- Duration of the maintenance window. Specify how long the maintenance window remains open.
- Dictionary<string, string>
- Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"} - Id string
- Unique identifier or OCID for listing a single maintenance window by id. Either compartmentId or id must be provided.
- Is
Outage bool - Does the maintenenace window cause outage? An outage indicates whether a maintenance window can consider operations that require downtime. It means a period when the application is not accessible.
- Is
Recurring bool - Is this a recurring maintenance window?
- Lifecycle
Details string - A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in Failed state.
- Recurrences string
- Recurrence rule specification if maintenance window recurring. Specify the frequency of running the maintenance window.
- Resource
Region string - Associated region
- State string
- A filter to return only resources whose lifecycleState matches the given lifecycleState.
- Dictionary<string, string>
- System tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"orcl-cloud.free-tier-retained": "true"} - Time
Created string - The time this resource was created. An RFC3339 formatted datetime string.
- Time
Schedule stringStart - Specify the date and time of the day that the maintenance window starts.
- Time
Updated string - The time this resource was last updated. An RFC3339 formatted datetime string.
- Compartment
Id string - The ID of the compartment in which to list resources. Empty only if the resource OCID query param is not specified.
- map[string]string
- Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"} - Description string
- A user-friendly description. To provide some insight about the resource. Avoid entering confidential information.
- Display
Name string - A filter to return only resources that match the entire display name given.
- Duration string
- Duration of the maintenance window. Specify how long the maintenance window remains open.
- map[string]string
- Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"} - Id string
- Unique identifier or OCID for listing a single maintenance window by id. Either compartmentId or id must be provided.
- Is
Outage bool - Does the maintenenace window cause outage? An outage indicates whether a maintenance window can consider operations that require downtime. It means a period when the application is not accessible.
- Is
Recurring bool - Is this a recurring maintenance window?
- Lifecycle
Details string - A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in Failed state.
- Recurrences string
- Recurrence rule specification if maintenance window recurring. Specify the frequency of running the maintenance window.
- Resource
Region string - Associated region
- State string
- A filter to return only resources whose lifecycleState matches the given lifecycleState.
- map[string]string
- System tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"orcl-cloud.free-tier-retained": "true"} - Time
Created string - The time this resource was created. An RFC3339 formatted datetime string.
- Time
Schedule stringStart - Specify the date and time of the day that the maintenance window starts.
- Time
Updated string - The time this resource was last updated. An RFC3339 formatted datetime string.
- compartment
Id String - The ID of the compartment in which to list resources. Empty only if the resource OCID query param is not specified.
- Map<String,String>
- Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"} - description String
- A user-friendly description. To provide some insight about the resource. Avoid entering confidential information.
- display
Name String - A filter to return only resources that match the entire display name given.
- duration String
- Duration of the maintenance window. Specify how long the maintenance window remains open.
- Map<String,String>
- Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"} - id String
- Unique identifier or OCID for listing a single maintenance window by id. Either compartmentId or id must be provided.
- is
Outage Boolean - Does the maintenenace window cause outage? An outage indicates whether a maintenance window can consider operations that require downtime. It means a period when the application is not accessible.
- is
Recurring Boolean - Is this a recurring maintenance window?
- lifecycle
Details String - A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in Failed state.
- recurrences String
- Recurrence rule specification if maintenance window recurring. Specify the frequency of running the maintenance window.
- resource
Region String - Associated region
- state String
- A filter to return only resources whose lifecycleState matches the given lifecycleState.
- Map<String,String>
- System tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"orcl-cloud.free-tier-retained": "true"} - time
Created String - The time this resource was created. An RFC3339 formatted datetime string.
- time
Schedule StringStart - Specify the date and time of the day that the maintenance window starts.
- time
Updated String - The time this resource was last updated. An RFC3339 formatted datetime string.
- compartment
Id string - The ID of the compartment in which to list resources. Empty only if the resource OCID query param is not specified.
- {[key: string]: string}
- Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"} - description string
- A user-friendly description. To provide some insight about the resource. Avoid entering confidential information.
- display
Name string - A filter to return only resources that match the entire display name given.
- duration string
- Duration of the maintenance window. Specify how long the maintenance window remains open.
- {[key: string]: string}
- Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"} - id string
- Unique identifier or OCID for listing a single maintenance window by id. Either compartmentId or id must be provided.
- is
Outage boolean - Does the maintenenace window cause outage? An outage indicates whether a maintenance window can consider operations that require downtime. It means a period when the application is not accessible.
- is
Recurring boolean - Is this a recurring maintenance window?
- lifecycle
Details string - A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in Failed state.
- recurrences string
- Recurrence rule specification if maintenance window recurring. Specify the frequency of running the maintenance window.
- resource
Region string - Associated region
- state string
- A filter to return only resources whose lifecycleState matches the given lifecycleState.
- {[key: string]: string}
- System tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"orcl-cloud.free-tier-retained": "true"} - time
Created string - The time this resource was created. An RFC3339 formatted datetime string.
- time
Schedule stringStart - Specify the date and time of the day that the maintenance window starts.
- time
Updated string - The time this resource was last updated. An RFC3339 formatted datetime string.
- compartment_
id str - The ID of the compartment in which to list resources. Empty only if the resource OCID query param is not specified.
- Mapping[str, str]
- Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"} - description str
- A user-friendly description. To provide some insight about the resource. Avoid entering confidential information.
- display_
name str - A filter to return only resources that match the entire display name given.
- duration str
- Duration of the maintenance window. Specify how long the maintenance window remains open.
- Mapping[str, str]
- Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"} - id str
- Unique identifier or OCID for listing a single maintenance window by id. Either compartmentId or id must be provided.
- is_
outage bool - Does the maintenenace window cause outage? An outage indicates whether a maintenance window can consider operations that require downtime. It means a period when the application is not accessible.
- is_
recurring bool - Is this a recurring maintenance window?
- lifecycle_
details str - A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in Failed state.
- recurrences str
- Recurrence rule specification if maintenance window recurring. Specify the frequency of running the maintenance window.
- resource_
region str - Associated region
- state str
- A filter to return only resources whose lifecycleState matches the given lifecycleState.
- Mapping[str, str]
- System tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"orcl-cloud.free-tier-retained": "true"} - time_
created str - The time this resource was created. An RFC3339 formatted datetime string.
- time_
schedule_ strstart - Specify the date and time of the day that the maintenance window starts.
- time_
updated str - The time this resource was last updated. An RFC3339 formatted datetime string.
- compartment
Id String - The ID of the compartment in which to list resources. Empty only if the resource OCID query param is not specified.
- Map<String>
- Defined tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"foo-namespace.bar-key": "value"} - description String
- A user-friendly description. To provide some insight about the resource. Avoid entering confidential information.
- display
Name String - A filter to return only resources that match the entire display name given.
- duration String
- Duration of the maintenance window. Specify how long the maintenance window remains open.
- Map<String>
- Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example:
{"bar-key": "value"} - id String
- Unique identifier or OCID for listing a single maintenance window by id. Either compartmentId or id must be provided.
- is
Outage Boolean - Does the maintenenace window cause outage? An outage indicates whether a maintenance window can consider operations that require downtime. It means a period when the application is not accessible.
- is
Recurring Boolean - Is this a recurring maintenance window?
- lifecycle
Details String - A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in Failed state.
- recurrences String
- Recurrence rule specification if maintenance window recurring. Specify the frequency of running the maintenance window.
- resource
Region String - Associated region
- state String
- A filter to return only resources whose lifecycleState matches the given lifecycleState.
- Map<String>
- System tags for this resource. Each key is predefined and scoped to a namespace. Example:
{"orcl-cloud.free-tier-retained": "true"} - time
Created String - The time this resource was created. An RFC3339 formatted datetime string.
- time
Schedule StringStart - Specify the date and time of the day that the maintenance window starts.
- time
Updated String - The time this resource was last updated. An RFC3339 formatted datetime string.
Package Details
- Repository
- oci pulumi/pulumi-oci
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
ociTerraform Provider.
