Volcengine v0.0.43 published on Friday, Jan 16, 2026 by Volcengine
Volcengine v0.0.43 published on Friday, Jan 16, 2026 by Volcengine
Use this data source to query detailed information of rds postgresql planned events
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as volcengine from "@pulumi/volcengine";
const example = volcengine.rds_postgresql.getPlannedEvents({
eventTypes: ["VersionUpgrade"],
instanceId: "postgres-72715e0d9f58",
instanceName: "test-01",
plannedSwitchTimeSearchRangeEnd: "2025-12-15T17:40:53.000Z",
plannedSwitchTimeSearchRangeStart: "2025-12-01T02:06:53.000Z",
statuses: [
"WaitStart",
"Running",
],
});
import pulumi
import pulumi_volcengine as volcengine
example = volcengine.rds_postgresql.get_planned_events(event_types=["VersionUpgrade"],
instance_id="postgres-72715e0d9f58",
instance_name="test-01",
planned_switch_time_search_range_end="2025-12-15T17:40:53.000Z",
planned_switch_time_search_range_start="2025-12-01T02:06:53.000Z",
statuses=[
"WaitStart",
"Running",
])
package main
import (
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
"github.com/volcengine/pulumi-volcengine/sdk/go/volcengine/rds_postgresql"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := rds_postgresql.GetPlannedEvents(ctx, &rds_postgresql.GetPlannedEventsArgs{
EventTypes: []string{
"VersionUpgrade",
},
InstanceId: pulumi.StringRef("postgres-72715e0d9f58"),
InstanceName: pulumi.StringRef("test-01"),
PlannedSwitchTimeSearchRangeEnd: pulumi.StringRef("2025-12-15T17:40:53.000Z"),
PlannedSwitchTimeSearchRangeStart: pulumi.StringRef("2025-12-01T02:06:53.000Z"),
Statuses: []string{
"WaitStart",
"Running",
},
}, nil)
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Volcengine = Pulumi.Volcengine;
return await Deployment.RunAsync(() =>
{
var example = Volcengine.Rds_postgresql.GetPlannedEvents.Invoke(new()
{
EventTypes = new[]
{
"VersionUpgrade",
},
InstanceId = "postgres-72715e0d9f58",
InstanceName = "test-01",
PlannedSwitchTimeSearchRangeEnd = "2025-12-15T17:40:53.000Z",
PlannedSwitchTimeSearchRangeStart = "2025-12-01T02:06:53.000Z",
Statuses = new[]
{
"WaitStart",
"Running",
},
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.volcengine.rds_postgresql.Rds_postgresqlFunctions;
import com.pulumi.volcengine.rds_postgresql.inputs.GetPlannedEventsArgs;
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 example = Rds_postgresqlFunctions.getPlannedEvents(GetPlannedEventsArgs.builder()
.eventTypes("VersionUpgrade")
.instanceId("postgres-72715e0d9f58")
.instanceName("test-01")
.plannedSwitchTimeSearchRangeEnd("2025-12-15T17:40:53.000Z")
.plannedSwitchTimeSearchRangeStart("2025-12-01T02:06:53.000Z")
.statuses(
"WaitStart",
"Running")
.build());
}
}
variables:
example:
fn::invoke:
Function: volcengine:rds_postgresql:getPlannedEvents
Arguments:
eventTypes:
- VersionUpgrade
instanceId: postgres-72715e0d9f58
instanceName: test-01
plannedSwitchTimeSearchRangeEnd: 2025-12-15T17:40:53.000Z
plannedSwitchTimeSearchRangeStart: 2025-12-01T02:06:53.000Z
statuses:
- WaitStart
- Running
Using getPlannedEvents
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 getPlannedEvents(args: GetPlannedEventsArgs, opts?: InvokeOptions): Promise<GetPlannedEventsResult>
function getPlannedEventsOutput(args: GetPlannedEventsOutputArgs, opts?: InvokeOptions): Output<GetPlannedEventsResult>def get_planned_events(event_id: Optional[str] = None,
event_types: Optional[Sequence[str]] = None,
instance_id: Optional[str] = None,
instance_name: Optional[str] = None,
output_file: Optional[str] = None,
planned_begin_time_search_range_end: Optional[str] = None,
planned_begin_time_search_range_start: Optional[str] = None,
planned_switch_time_search_range_end: Optional[str] = None,
planned_switch_time_search_range_start: Optional[str] = None,
statuses: Optional[Sequence[str]] = None,
opts: Optional[InvokeOptions] = None) -> GetPlannedEventsResult
def get_planned_events_output(event_id: Optional[pulumi.Input[str]] = None,
event_types: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
instance_id: Optional[pulumi.Input[str]] = None,
instance_name: Optional[pulumi.Input[str]] = None,
output_file: Optional[pulumi.Input[str]] = None,
planned_begin_time_search_range_end: Optional[pulumi.Input[str]] = None,
planned_begin_time_search_range_start: Optional[pulumi.Input[str]] = None,
planned_switch_time_search_range_end: Optional[pulumi.Input[str]] = None,
planned_switch_time_search_range_start: Optional[pulumi.Input[str]] = None,
statuses: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetPlannedEventsResult]func GetPlannedEvents(ctx *Context, args *GetPlannedEventsArgs, opts ...InvokeOption) (*GetPlannedEventsResult, error)
func GetPlannedEventsOutput(ctx *Context, args *GetPlannedEventsOutputArgs, opts ...InvokeOption) GetPlannedEventsResultOutput> Note: This function is named GetPlannedEvents in the Go SDK.
public static class GetPlannedEvents
{
public static Task<GetPlannedEventsResult> InvokeAsync(GetPlannedEventsArgs args, InvokeOptions? opts = null)
public static Output<GetPlannedEventsResult> Invoke(GetPlannedEventsInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetPlannedEventsResult> getPlannedEvents(GetPlannedEventsArgs args, InvokeOptions options)
public static Output<GetPlannedEventsResult> getPlannedEvents(GetPlannedEventsArgs args, InvokeOptions options)
fn::invoke:
function: volcengine:rds_postgresql/getPlannedEvents:getPlannedEvents
arguments:
# arguments dictionaryThe following arguments are supported:
- Event
Id string - Event ID.
- Event
Types List<string> - Event type. Values: VersionUpgrade, HostOffline.
- Instance
Id string - The id of the PostgreSQL instance.
- Instance
Name string - The name of PostgreSQL instance.
- Output
File string - File name where to save data source results.
- Planned
Begin stringTime Search Range End - Time window end for planned execution time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- Planned
Begin stringTime Search Range Start - Time window start for planned execution time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- Planned
Switch stringTime Search Range End - Time window end for planned switch time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- Planned
Switch stringTime Search Range Start - Time window start for planned switch time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- Statuses List<string>
- Operation event status. Values: Canceled, WaitStart, WaitSwitch, Running, Running_BeforeSwitch, Running_Switching, Running_AfterSwitch, Success, Failed, Timeout, Rollbacking, RollbackFailed.
- Event
Id string - Event ID.
- Event
Types []string - Event type. Values: VersionUpgrade, HostOffline.
- Instance
Id string - The id of the PostgreSQL instance.
- Instance
Name string - The name of PostgreSQL instance.
- Output
File string - File name where to save data source results.
- Planned
Begin stringTime Search Range End - Time window end for planned execution time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- Planned
Begin stringTime Search Range Start - Time window start for planned execution time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- Planned
Switch stringTime Search Range End - Time window end for planned switch time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- Planned
Switch stringTime Search Range Start - Time window start for planned switch time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- Statuses []string
- Operation event status. Values: Canceled, WaitStart, WaitSwitch, Running, Running_BeforeSwitch, Running_Switching, Running_AfterSwitch, Success, Failed, Timeout, Rollbacking, RollbackFailed.
- event
Id String - Event ID.
- event
Types List<String> - Event type. Values: VersionUpgrade, HostOffline.
- instance
Id String - The id of the PostgreSQL instance.
- instance
Name String - The name of PostgreSQL instance.
- output
File String - File name where to save data source results.
- planned
Begin StringTime Search Range End - Time window end for planned execution time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned
Begin StringTime Search Range Start - Time window start for planned execution time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned
Switch StringTime Search Range End - Time window end for planned switch time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned
Switch StringTime Search Range Start - Time window start for planned switch time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- statuses List<String>
- Operation event status. Values: Canceled, WaitStart, WaitSwitch, Running, Running_BeforeSwitch, Running_Switching, Running_AfterSwitch, Success, Failed, Timeout, Rollbacking, RollbackFailed.
- event
Id string - Event ID.
- event
Types string[] - Event type. Values: VersionUpgrade, HostOffline.
- instance
Id string - The id of the PostgreSQL instance.
- instance
Name string - The name of PostgreSQL instance.
- output
File string - File name where to save data source results.
- planned
Begin stringTime Search Range End - Time window end for planned execution time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned
Begin stringTime Search Range Start - Time window start for planned execution time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned
Switch stringTime Search Range End - Time window end for planned switch time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned
Switch stringTime Search Range Start - Time window start for planned switch time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- statuses string[]
- Operation event status. Values: Canceled, WaitStart, WaitSwitch, Running, Running_BeforeSwitch, Running_Switching, Running_AfterSwitch, Success, Failed, Timeout, Rollbacking, RollbackFailed.
- event_
id str - Event ID.
- event_
types Sequence[str] - Event type. Values: VersionUpgrade, HostOffline.
- instance_
id str - The id of the PostgreSQL instance.
- instance_
name str - The name of PostgreSQL instance.
- output_
file str - File name where to save data source results.
- planned_
begin_ strtime_ search_ range_ end - Time window end for planned execution time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned_
begin_ strtime_ search_ range_ start - Time window start for planned execution time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned_
switch_ strtime_ search_ range_ end - Time window end for planned switch time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned_
switch_ strtime_ search_ range_ start - Time window start for planned switch time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- statuses Sequence[str]
- Operation event status. Values: Canceled, WaitStart, WaitSwitch, Running, Running_BeforeSwitch, Running_Switching, Running_AfterSwitch, Success, Failed, Timeout, Rollbacking, RollbackFailed.
- event
Id String - Event ID.
- event
Types List<String> - Event type. Values: VersionUpgrade, HostOffline.
- instance
Id String - The id of the PostgreSQL instance.
- instance
Name String - The name of PostgreSQL instance.
- output
File String - File name where to save data source results.
- planned
Begin StringTime Search Range End - Time window end for planned execution time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned
Begin StringTime Search Range Start - Time window start for planned execution time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned
Switch StringTime Search Range End - Time window end for planned switch time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned
Switch StringTime Search Range Start - Time window start for planned switch time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- statuses List<String>
- Operation event status. Values: Canceled, WaitStart, WaitSwitch, Running, Running_BeforeSwitch, Running_Switching, Running_AfterSwitch, Success, Failed, Timeout, Rollbacking, RollbackFailed.
getPlannedEvents Result
The following output properties are available:
- Id string
- The provider-assigned unique ID for this managed resource.
- Planned
Events List<GetPlanned Events Planned Event> - Planned events list.
- Total
Count int - The total count of query.
- Event
Id string - Event ID.
- Event
Types List<string> - Event type.
- Instance
Id string - Instance ID.
- Instance
Name string - Instance name.
- Output
File string - Planned
Begin stringTime Search Range End - Planned
Begin stringTime Search Range Start - Planned
Switch stringTime Search Range End - Planned
Switch stringTime Search Range Start - Statuses List<string>
- Operation event status.
- Id string
- The provider-assigned unique ID for this managed resource.
- Planned
Events []GetPlanned Events Planned Event - Planned events list.
- Total
Count int - The total count of query.
- Event
Id string - Event ID.
- Event
Types []string - Event type.
- Instance
Id string - Instance ID.
- Instance
Name string - Instance name.
- Output
File string - Planned
Begin stringTime Search Range End - Planned
Begin stringTime Search Range Start - Planned
Switch stringTime Search Range End - Planned
Switch stringTime Search Range Start - Statuses []string
- Operation event status.
- id String
- The provider-assigned unique ID for this managed resource.
- planned
Events List<GetPlanned Events Planned Event> - Planned events list.
- total
Count Integer - The total count of query.
- event
Id String - Event ID.
- event
Types List<String> - Event type.
- instance
Id String - Instance ID.
- instance
Name String - Instance name.
- output
File String - planned
Begin StringTime Search Range End - planned
Begin StringTime Search Range Start - planned
Switch StringTime Search Range End - planned
Switch StringTime Search Range Start - statuses List<String>
- Operation event status.
- id string
- The provider-assigned unique ID for this managed resource.
- planned
Events GetPlanned Events Planned Event[] - Planned events list.
- total
Count number - The total count of query.
- event
Id string - Event ID.
- event
Types string[] - Event type.
- instance
Id string - Instance ID.
- instance
Name string - Instance name.
- output
File string - planned
Begin stringTime Search Range End - planned
Begin stringTime Search Range Start - planned
Switch stringTime Search Range End - planned
Switch stringTime Search Range Start - statuses string[]
- Operation event status.
- id str
- The provider-assigned unique ID for this managed resource.
- planned_
events Sequence[GetPlanned Events Planned Event] - Planned events list.
- total_
count int - The total count of query.
- event_
id str - Event ID.
- event_
types Sequence[str] - Event type.
- instance_
id str - Instance ID.
- instance_
name str - Instance name.
- output_
file str - planned_
begin_ strtime_ search_ range_ end - planned_
begin_ strtime_ search_ range_ start - planned_
switch_ strtime_ search_ range_ end - planned_
switch_ strtime_ search_ range_ start - statuses Sequence[str]
- Operation event status.
- id String
- The provider-assigned unique ID for this managed resource.
- planned
Events List<Property Map> - Planned events list.
- total
Count Number - The total count of query.
- event
Id String - Event ID.
- event
Types List<String> - Event type.
- instance
Id String - Instance ID.
- instance
Name String - Instance name.
- output
File String - planned
Begin StringTime Search Range End - planned
Begin StringTime Search Range Start - planned
Switch StringTime Search Range End - planned
Switch StringTime Search Range Start - statuses List<String>
- Operation event status.
Supporting Types
GetPlannedEventsPlannedEvent
- Business
Impact string - The impact of operation and maintenance events on the business.
- Event
Id string - Event ID.
- Event
Type string - Event type. Values: VersionUpgrade, HostOffline.
- Instance
Id string - The id of the PostgreSQL instance.
- Instance
Name string - The name of PostgreSQL instance.
- Max
Delay stringTime - Maximum delay time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- Planned
Begin stringTime - Planned execution time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- Planned
Event stringReason - Reason for the planned event.
- Planned
Switch stringBegin Time - Planned switch start time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- Planned
Switch stringEnd Time - Planned switch end time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- Region string
- Region.
- Status string
- Operation event status. Values: Canceled, WaitStart, WaitSwitch, Running, Running_BeforeSwitch, Running_Switching, Running_AfterSwitch, Success, Failed, Timeout, Rollbacking, RollbackFailed.
- Business
Impact string - The impact of operation and maintenance events on the business.
- Event
Id string - Event ID.
- Event
Type string - Event type. Values: VersionUpgrade, HostOffline.
- Instance
Id string - The id of the PostgreSQL instance.
- Instance
Name string - The name of PostgreSQL instance.
- Max
Delay stringTime - Maximum delay time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- Planned
Begin stringTime - Planned execution time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- Planned
Event stringReason - Reason for the planned event.
- Planned
Switch stringBegin Time - Planned switch start time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- Planned
Switch stringEnd Time - Planned switch end time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- Region string
- Region.
- Status string
- Operation event status. Values: Canceled, WaitStart, WaitSwitch, Running, Running_BeforeSwitch, Running_Switching, Running_AfterSwitch, Success, Failed, Timeout, Rollbacking, RollbackFailed.
- business
Impact String - The impact of operation and maintenance events on the business.
- event
Id String - Event ID.
- event
Type String - Event type. Values: VersionUpgrade, HostOffline.
- instance
Id String - The id of the PostgreSQL instance.
- instance
Name String - The name of PostgreSQL instance.
- max
Delay StringTime - Maximum delay time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned
Begin StringTime - Planned execution time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned
Event StringReason - Reason for the planned event.
- planned
Switch StringBegin Time - Planned switch start time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned
Switch StringEnd Time - Planned switch end time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- region String
- Region.
- status String
- Operation event status. Values: Canceled, WaitStart, WaitSwitch, Running, Running_BeforeSwitch, Running_Switching, Running_AfterSwitch, Success, Failed, Timeout, Rollbacking, RollbackFailed.
- business
Impact string - The impact of operation and maintenance events on the business.
- event
Id string - Event ID.
- event
Type string - Event type. Values: VersionUpgrade, HostOffline.
- instance
Id string - The id of the PostgreSQL instance.
- instance
Name string - The name of PostgreSQL instance.
- max
Delay stringTime - Maximum delay time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned
Begin stringTime - Planned execution time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned
Event stringReason - Reason for the planned event.
- planned
Switch stringBegin Time - Planned switch start time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned
Switch stringEnd Time - Planned switch end time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- region string
- Region.
- status string
- Operation event status. Values: Canceled, WaitStart, WaitSwitch, Running, Running_BeforeSwitch, Running_Switching, Running_AfterSwitch, Success, Failed, Timeout, Rollbacking, RollbackFailed.
- business_
impact str - The impact of operation and maintenance events on the business.
- event_
id str - Event ID.
- event_
type str - Event type. Values: VersionUpgrade, HostOffline.
- instance_
id str - The id of the PostgreSQL instance.
- instance_
name str - The name of PostgreSQL instance.
- max_
delay_ strtime - Maximum delay time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned_
begin_ strtime - Planned execution time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned_
event_ strreason - Reason for the planned event.
- planned_
switch_ strbegin_ time - Planned switch start time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned_
switch_ strend_ time - Planned switch end time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- region str
- Region.
- status str
- Operation event status. Values: Canceled, WaitStart, WaitSwitch, Running, Running_BeforeSwitch, Running_Switching, Running_AfterSwitch, Success, Failed, Timeout, Rollbacking, RollbackFailed.
- business
Impact String - The impact of operation and maintenance events on the business.
- event
Id String - Event ID.
- event
Type String - Event type. Values: VersionUpgrade, HostOffline.
- instance
Id String - The id of the PostgreSQL instance.
- instance
Name String - The name of PostgreSQL instance.
- max
Delay StringTime - Maximum delay time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned
Begin StringTime - Planned execution time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned
Event StringReason - Reason for the planned event.
- planned
Switch StringBegin Time - Planned switch start time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- planned
Switch StringEnd Time - Planned switch end time. Format: yyyy-MM-ddTHH:mm:ss.sssZ (UTC).
- region String
- Region.
- status String
- Operation event status. Values: Canceled, WaitStart, WaitSwitch, Running, Running_BeforeSwitch, Running_Switching, Running_AfterSwitch, Success, Failed, Timeout, Rollbacking, RollbackFailed.
Package Details
- Repository
- volcengine volcengine/pulumi-volcengine
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
volcengineTerraform Provider.
Volcengine v0.0.43 published on Friday, Jan 16, 2026 by Volcengine
