feat(tmp): [133996720]add new parameters to monitor tmp instance resource (#4144)

* feat(tmp): add new parameters to monitor tmp instance resource

---------

Co-authored-by: vincenthuangwz <van136682262@gmail.com>

Author: iac-agent

.changelog/4144.txt

@@ -0,0 +1,3 @@
+```release-note:enhancement
+resource/tencentcloud_monitor_tmp_instance: support `long_term_storage_retention_time` parameter for configuring archive storage retention duration
+```

go.mod

@@ -70,7 +70,7 @@ require (
 	github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/live v1.3.95
 	github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/mariadb v1.0.672
 	github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/mongodb v1.3.65
-	github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/monitor v1.3.49
+	github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/monitor v1.3.101
 	github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/mps v1.3.45
 	github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/organization v1.3.89
 	github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/postgres v1.3.63

go.sum

@@ -1019,8 +1019,8 @@ github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/mariadb v1.0.672 h1:sR3
 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/mariadb v1.0.672/go.mod h1:o3rBKhtfIJfw4BG22M0CQVLQAc0WqIsbyRI/EW52Ka0=
 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/mongodb v1.3.65 h1:ZMG98KxfY0HefEU0U2/kDm2g9IUSqXAtjKzrM+X3jZE=
 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/mongodb v1.3.65/go.mod h1:AOJNqusaTIhb3EXZfqFDj7YOQGdReMGakBqEdx9tblI=
-github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/monitor v1.3.49 h1:j+xW0faHHUVpf28Ogv7ClWHniprdKoa7j6FEW4WMVbs=
-github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/monitor v1.3.49/go.mod h1:ihQpv91ZdiYflH3B7FTnu13yv06xnVyzbT66lP6dPCg=
+github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/monitor v1.3.101 h1:r8PjkCuXrztjLyBROWTww0RJUq+a+l5ybPLl6GGlov8=
+github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/monitor v1.3.101/go.mod h1:+cX4PEEehIIbyHy9plpXOTShlFWtc9OC1AWcmOrOMT8=
 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/mps v1.3.45 h1:35PD/GXaOl3QhL1fI5a3Q+jcenzR1PqfuGxltOeO48w=
 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/mps v1.3.45/go.mod h1:OrNv7U7R19HZySH5o+/ag3EyAH1tDIwb5z23K5fY5vw=
 github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/mqtt v1.3.7 h1:ms2KfUZ9OYiKx75dqPaOuBTj6QoCJC90FN10d1gr720=

openspec/changes/archive/2026-05-27-add-monitor-tmp-instance-long-term-storage-retention-time/.openspec.yaml

@@ -0,0 +1,2 @@
+schema: spec-driven
+created: 2026-05-25

openspec/changes/archive/2026-05-27-add-monitor-tmp-instance-long-term-storage-retention-time/design.md

@@ -0,0 +1,38 @@
+## Context
+
+The `tencentcloud_monitor_tmp_instance` resource manages Prometheus instances via TencentCloud Monitor APIs. The cloud APIs support an `InstanceAttributes` parameter (type: `[]*PrometheusRuleKV`) that carries special instance properties. One supported attribute is `LongTermStorageRetentionTime` (archive storage retention in days, value range 60-730).
+
+- `CreatePrometheusMultiTenantInstancePostPayMode` supports `InstanceAttributes` to set `LongTermStorageRetentionTime` at creation time.
+- `ModifyPrometheusInstanceAttributes` supports `InstanceAttributes` to update `LongTermStorageRetentionTime` after creation.
+- `DescribePrometheusInstances` returns `InstanceAttributes` in the `PrometheusInstancesItem` struct.
+
+Current resource file: `tencentcloud/services/tmp/resource_tc_monitor_tmp_instance.go`
+Service layer: `tencentcloud/services/monitor/service_tencentcloud_monitor.go`
+
+## Goals / Non-Goals
+
+**Goals:**
+- Add `long_term_storage_retention_time` as an Optional integer parameter (range 60-730) to the resource schema.
+- Pass `InstanceAttributes` with key `LongTermStorageRetentionTime` to the Create API when provided.
+- Pass `InstanceAttributes` with key `LongTermStorageRetentionTime` to the Modify API when the value changes.
+- Read back `LongTermStorageRetentionTime` from the Describe API response's `InstanceAttributes` array.
+- Update unit tests to verify Create/Read/Update with `long_term_storage_retention_time`.
+
+**Non-Goals:**
+- Supporting other `InstanceAttributes` keys (e.g., `CreatedFrom`, `FreeTrialExpireAt`) — out of scope.
+- Adding validation logic for value range in schema (rely on API-side validation).
+
+## Decisions
+
+1. **Parameter mutability**: The parameter is mutable after creation via `ModifyPrometheusInstanceAttributes` API, so updates are supported.
+
+2. **Schema definition**: The parameter will be `Optional` + `Computed` (int type). Optional because users may or may not want to configure archive storage. Computed because the value can be read back from the API (may be set server-side).
+
+3. **Read implementation**: Iterate over `InstanceAttributes` array from `PrometheusInstancesItem`, find the entry with key `LongTermStorageRetentionTime`, parse the string value as integer, and set in state.
+
+4. **Wire format**: The API uses `PrometheusRuleKV` struct (`Key` string, `Value` string), so the integer value is converted to/from string for API communication.
+
+## Risks / Trade-offs
+
+- [Risk] The `InstanceAttributes` array in the API response may contain other keys besides `LongTermStorageRetentionTime` → Mitigation: Only read the specific key we care about, ignore others.
+- [Risk] Backward compatibility concern if existing state files don't have this field → Mitigation: The field is Optional+Computed, so existing configurations without it will simply read the value from the API on next refresh without breaking.

openspec/changes/archive/2026-05-27-add-monitor-tmp-instance-long-term-storage-retention-time/proposal.md

@@ -0,0 +1,23 @@
+## Why
+
+The `tencentcloud_monitor_tmp_instance` resource currently does not support configuring the long-term storage retention time (`LongTermStorageRetentionTime`) via `InstanceAttributes`. The cloud APIs `CreatePrometheusMultiTenantInstancePostPayMode` and `ModifyPrometheusInstanceAttributes` both support the `InstanceAttributes` parameter with key `LongTermStorageRetentionTime` (value: 60-730 days), and the `DescribePrometheusInstances` response returns the `InstanceAttributes` array including this key. Adding this parameter allows users to configure archive storage duration for Prometheus instances via Terraform.
+
+## What Changes
+
+- Add a new optional parameter `long_term_storage_retention_time` (type: int, range: 60-730) to the `tencentcloud_monitor_tmp_instance` resource schema.
+- Wire the parameter to the `CreatePrometheusMultiTenantInstancePostPayMode` API's `InstanceAttributes` field (key: `LongTermStorageRetentionTime`) during resource creation.
+- Wire the parameter to the `ModifyPrometheusInstanceAttributes` API's `InstanceAttributes` field during resource update.
+- Read back the `LongTermStorageRetentionTime` from the `DescribePrometheusInstances` API response's `InstanceAttributes` array in the Read function.
+
+## Capabilities
+
+### New Capabilities
+- `monitor-tmp-instance-long-term-storage-retention-time`: Add `long_term_storage_retention_time` parameter to `tencentcloud_monitor_tmp_instance` resource for configuring archive storage retention duration (60-730 days).
+
+### Modified Capabilities
+
+## Impact
+
+- Resource file: `tencentcloud/services/tmp/resource_tc_monitor_tmp_instance.go` — schema addition, Create/Read/Update logic changes.
+- Test file: `tencentcloud/services/tmp/resource_tc_monitor_tmp_instance_test.go` — updated unit test cases.
+- Documentation: `tencentcloud/services/tmp/resource_tc_monitor_tmp_instance.md` — updated parameter documentation.

openspec/changes/archive/2026-05-27-add-monitor-tmp-instance-long-term-storage-retention-time/specs/monitor-tmp-instance-long-term-storage-retention-time/spec.md

@@ -0,0 +1,28 @@
+# monitor-tmp-instance-long-term-storage-retention-time Specification
+
+## Purpose
+Support configuring the archive storage retention duration (LongTermStorageRetentionTime) for Prometheus instances via the `tencentcloud_monitor_tmp_instance` resource's `InstanceAttributes` parameter.
+
+## Requirements
+### Requirement: Resource supports long_term_storage_retention_time parameter
+The `tencentcloud_monitor_tmp_instance` resource SHALL support an optional `long_term_storage_retention_time` parameter (int type, range 60-730) that allows users to configure the archive storage retention duration for the Prometheus instance.
+
+#### Scenario: Create instance with long_term_storage_retention_time specified
+- **WHEN** user specifies `long_term_storage_retention_time` in the resource configuration
+- **THEN** the system SHALL pass the `InstanceAttributes` field with key `LongTermStorageRetentionTime` and the specified value to the `CreatePrometheusMultiTenantInstancePostPayMode` API request
+
+#### Scenario: Create instance without long_term_storage_retention_time
+- **WHEN** user does not specify `long_term_storage_retention_time` in the resource configuration
+- **THEN** the system SHALL NOT pass the `InstanceAttributes` field to the Create API request, and the resource SHALL be created successfully without archive storage configuration
+
+#### Scenario: Read long_term_storage_retention_time from API
+- **WHEN** the resource Read function is invoked
+- **THEN** the system SHALL read the `InstanceAttributes` array from the `DescribePrometheusInstances` API response, find the entry with key `LongTermStorageRetentionTime`, parse its value as integer, and set it in state
+
+#### Scenario: Modify long_term_storage_retention_time after creation
+- **WHEN** user changes the `long_term_storage_retention_time` value in an existing resource configuration
+- **THEN** the system SHALL pass the `InstanceAttributes` field with key `LongTermStorageRetentionTime` and the new value to the `ModifyPrometheusInstanceAttributes` API request
+
+#### Scenario: Import existing instance with long_term_storage_retention_time
+- **WHEN** user imports an existing Prometheus instance that has `LongTermStorageRetentionTime` set in `InstanceAttributes`
+- **THEN** the system SHALL correctly read and populate the `long_term_storage_retention_time` attribute in state

openspec/changes/archive/2026-05-27-add-monitor-tmp-instance-long-term-storage-retention-time/tasks.md

@@ -0,0 +1,14 @@
+## 1. Schema and CRUD Implementation
+
+- [x] 1.1 Add `long_term_storage_retention_time` parameter (Optional, Computed, int) to the resource schema in `tencentcloud/services/tmp/resource_tc_monitor_tmp_instance.go`
+- [x] 1.2 Wire `long_term_storage_retention_time` to `request.InstanceAttributes` with key `LongTermStorageRetentionTime` in the Create function
+- [x] 1.3 Wire `long_term_storage_retention_time` to `request.InstanceAttributes` with key `LongTermStorageRetentionTime` in the Update function (when changed)
+- [x] 1.4 Read `LongTermStorageRetentionTime` from `PrometheusInstancesItem.InstanceAttributes` in the Read function, parsing the string value to int
+
+## 2. Unit Tests
+
+- [x] 2.1 Update unit test cases in `tencentcloud/services/tmp/resource_tc_monitor_tmp_instance_test.go` to verify Create with `long_term_storage_retention_time`, Read populating the field from `InstanceAttributes`, Read with nil `InstanceAttributes`, and Update modifying the value
+
+## 3. Documentation
+
+- [x] 3.1 Update `tencentcloud/services/tmp/resource_tc_monitor_tmp_instance.md` to include `long_term_storage_retention_time` in the parameter documentation

openspec/specs/monitor-tmp-instance-long-term-storage-retention-time/spec.md

@@ -0,0 +1,28 @@
+# monitor-tmp-instance-long-term-storage-retention-time Specification
+
+## Purpose
+Support configuring the archive storage retention duration (LongTermStorageRetentionTime) for Prometheus instances via the `tencentcloud_monitor_tmp_instance` resource's `InstanceAttributes` parameter.
+
+## Requirements
+### Requirement: Resource supports long_term_storage_retention_time parameter
+The `tencentcloud_monitor_tmp_instance` resource SHALL support an optional `long_term_storage_retention_time` parameter (int type, range 60-730) that allows users to configure the archive storage retention duration for the Prometheus instance.
+
+#### Scenario: Create instance with long_term_storage_retention_time specified
+- **WHEN** user specifies `long_term_storage_retention_time` in the resource configuration
+- **THEN** the system SHALL pass the `InstanceAttributes` field with key `LongTermStorageRetentionTime` and the specified value to the `CreatePrometheusMultiTenantInstancePostPayMode` API request
+
+#### Scenario: Create instance without long_term_storage_retention_time
+- **WHEN** user does not specify `long_term_storage_retention_time` in the resource configuration
+- **THEN** the system SHALL NOT pass the `InstanceAttributes` field to the Create API request, and the resource SHALL be created successfully without archive storage configuration
+
+#### Scenario: Read long_term_storage_retention_time from API
+- **WHEN** the resource Read function is invoked
+- **THEN** the system SHALL read the `InstanceAttributes` array from the `DescribePrometheusInstances` API response, find the entry with key `LongTermStorageRetentionTime`, parse its value as integer, and set it in state
+
+#### Scenario: Modify long_term_storage_retention_time after creation
+- **WHEN** user changes the `long_term_storage_retention_time` value in an existing resource configuration
+- **THEN** the system SHALL pass the `InstanceAttributes` field with key `LongTermStorageRetentionTime` and the new value to the `ModifyPrometheusInstanceAttributes` API request
+
+#### Scenario: Import existing instance with long_term_storage_retention_time
+- **WHEN** user imports an existing Prometheus instance that has `LongTermStorageRetentionTime` set in `InstanceAttributes`
+- **THEN** the system SHALL correctly read and populate the `long_term_storage_retention_time` attribute in state

tencentcloud/services/tmp/resource_tc_monitor_tmp_instance.go

@@ -85,6 +85,13 @@ func ResourceTencentCloudMonitorTmpInstance() *schema.Resource {
 				Computed:    true,
 				Description: "Proxy address.",
 			},
+
+			"long_term_storage_retention_time": {
+				Type:        schema.TypeInt,
+				Optional:    true,
+				Computed:    true,
+				Description: "Long-term storage retention time(in days). Value range: 60-730.",
+			},
 		},
 	}
 }
@@ -119,6 +126,15 @@ func resourceTencentCloudMonitorTmpInstanceCreate(d *schema.ResourceData, meta i
 		request.Zone = helper.String(v.(string))
 	}
 
+	if v, ok := d.GetOkExists("long_term_storage_retention_time"); ok {
+		request.InstanceAttributes = []*monitor.PrometheusRuleKV{
+			{
+				Key:   helper.String("LongTermStorageRetentionTime"),
+				Value: helper.String(fmt.Sprintf("%d", v.(int))),
+			},
+		}
+	}
+
 	err := resource.Retry(tccommon.WriteRetryTimeout, func() *resource.RetryError {
 		result, e := meta.(tccommon.ProviderMeta).GetAPIV3Conn().UseMonitorClient().CreatePrometheusMultiTenantInstancePostPayMode(request)
 		if e != nil {
@@ -241,6 +257,17 @@ func resourceTencentCloudMonitorTmpInstanceRead(d *schema.ResourceData, meta int
 		_ = d.Set("proxy_address", tmpInstance.ProxyAddress)
 	}
 
+	if tmpInstance.InstanceAttributes != nil {
+		for _, attr := range tmpInstance.InstanceAttributes {
+			if attr.Key != nil && *attr.Key == "LongTermStorageRetentionTime" && attr.Value != nil {
+				var longTermStorageRetentionTime int
+				fmt.Sscanf(*attr.Value, "%d", &longTermStorageRetentionTime)
+				_ = d.Set("long_term_storage_retention_time", longTermStorageRetentionTime)
+				break
+			}
+		}
+	}
+
 	tcClient := meta.(tccommon.ProviderMeta).GetAPIV3Conn()
 	tagService := svctag.NewTagService(tcClient)
 	tags, err := tagService.DescribeResourceTags(ctx, "monitor", "prom-instance", tcClient.Region, d.Id())
@@ -285,6 +312,17 @@ func resourceTencentCloudMonitorTmpInstanceUpdate(d *schema.ResourceData, meta i
 		}
 	}
 
+	if d.HasChange("long_term_storage_retention_time") {
+		if v, ok := d.GetOkExists("long_term_storage_retention_time"); ok {
+			request.InstanceAttributes = []*monitor.PrometheusRuleKV{
+				{
+					Key:   helper.String("LongTermStorageRetentionTime"),
+					Value: helper.String(fmt.Sprintf("%d", v.(int))),
+				},
+			}
+		}
+	}
+
 	err := resource.Retry(tccommon.WriteRetryTimeout, func() *resource.RetryError {
 		result, e := meta.(tccommon.ProviderMeta).GetAPIV3Conn().UseMonitorClient().ModifyPrometheusInstanceAttributes(request)
 		if e != nil {