diff --git a/.changelog/3047.txt b/.changelog/3047.txt
new file mode 100644
index 0000000000..4eac1035f7
--- /dev/null
+++ b/.changelog/3047.txt
@@ -0,0 +1,3 @@
+```release-note:enhancement
+resource/tencentcloud_kms_key: support check `pending_delete_window_in_days` params
+```
diff --git a/tencentcloud/services/kms/resource_tc_kms_key.go b/tencentcloud/services/kms/resource_tc_kms_key.go
index bc79c5abb5..b0c61430dc 100644
--- a/tencentcloud/services/kms/resource_tc_kms_key.go
+++ b/tencentcloud/services/kms/resource_tc_kms_key.go
@@ -42,10 +42,11 @@ func TencentKmsBasicInfo() map[string]*schema.Schema {
 			Description:   "Specify whether to archive key. Default value is `false`. This field is conflict with `is_enabled`, valid when key_state is `Enabled`, `Disabled`, `Archived`.",
 		},
 		"pending_delete_window_in_days": {
-			Type:        schema.TypeInt,
-			Optional:    true,
-			Default:     7,
-			Description: "Duration in days after which the key is deleted after destruction of the resource, must be between 7 and 30 days. Defaults to 7 days.",
+			Type:         schema.TypeInt,
+			Optional:     true,
+			Default:      7,
+			ValidateFunc: tccommon.ValidateIntegerInRange(7, 30),
+			Description:  "Duration in days after which the key is deleted after destruction of the resource, must be between 7 and 30 days. Defaults to 7 days.",
 		},
 		"tags": {
 			Type:        schema.TypeMap,
diff --git a/tencentcloud/services/kms/resource_tc_kms_key.md b/tencentcloud/services/kms/resource_tc_kms_key.md
index 6f660e3d3b..6ce2f77d29 100644
--- a/tencentcloud/services/kms/resource_tc_kms_key.md
+++ b/tencentcloud/services/kms/resource_tc_kms_key.md
@@ -6,13 +6,14 @@ Create and enable a instance.
 
 ```hcl
 resource "tencentcloud_kms_key" "example" {
-  alias                = "tf-example-kms-key"
-  description          = "example of kms key"
-  key_rotation_enabled = false
-  is_enabled           = true
+  alias                         = "tf-example-kms-key"
+  description                   = "example of kms key"
+  key_rotation_enabled          = false
+  is_enabled                    = true
+  pending_delete_window_in_days = 7
 
   tags = {
-    "createdBy" = "terraform"
+    createdBy = "Terraform"
   }
 }
 ```
@@ -20,7 +21,7 @@ resource "tencentcloud_kms_key" "example" {
 Specify the Key Usage as an asymmetry method.
 
 ```hcl
-resource "tencentcloud_kms_key" "example2" {
+resource "tencentcloud_kms_key" "example" {
   alias       = "tf-example-kms-key"
   description = "example of kms key"
   key_usage   = "ASYMMETRIC_DECRYPT_RSA_2048"
@@ -31,14 +32,14 @@ resource "tencentcloud_kms_key" "example2" {
 Disable the kms key instance.
 
 ```hcl
-resource "tencentcloud_kms_key" "example3" {
+resource "tencentcloud_kms_key" "example" {
   alias                = "tf-example-kms-key"
   description          = "example of kms key"
   key_rotation_enabled = false
   is_enabled           = false
 
   tags = {
-    "test-tag" = "unit-test"
+    createdBy = "Terraform"
   }
 }
 ```
@@ -48,5 +49,5 @@ Import
 KMS keys can be imported using the id, e.g.
 
 ```
-$ terraform import tencentcloud_kms_key.foo 287e8f40-7cbb-11eb-9a3a-5254004f7f94
+$ terraform import tencentcloud_kms_key.example 287e8f40-7cbb-11eb-9a3a-5254004f7f94
 ```
\ No newline at end of file
diff --git a/website/docs/r/kms_key.html.markdown b/website/docs/r/kms_key.html.markdown
index 8ad3cf1eb6..2c4c0850ab 100644
--- a/website/docs/r/kms_key.html.markdown
+++ b/website/docs/r/kms_key.html.markdown
@@ -17,13 +17,14 @@ Provide a resource to create a KMS key.
 
 ```hcl
 resource "tencentcloud_kms_key" "example" {
-  alias                = "tf-example-kms-key"
-  description          = "example of kms key"
-  key_rotation_enabled = false
-  is_enabled           = true
+  alias                         = "tf-example-kms-key"
+  description                   = "example of kms key"
+  key_rotation_enabled          = false
+  is_enabled                    = true
+  pending_delete_window_in_days = 7
 
   tags = {
-    "createdBy" = "terraform"
+    createdBy = "Terraform"
   }
 }
 ```
@@ -31,7 +32,7 @@ resource "tencentcloud_kms_key" "example" {
 ### Specify the Key Usage as an asymmetry method.
 
 ```hcl
-resource "tencentcloud_kms_key" "example2" {
+resource "tencentcloud_kms_key" "example" {
   alias       = "tf-example-kms-key"
   description = "example of kms key"
   key_usage   = "ASYMMETRIC_DECRYPT_RSA_2048"
@@ -42,14 +43,14 @@ resource "tencentcloud_kms_key" "example2" {
 ### Disable the kms key instance.
 
 ```hcl
-resource "tencentcloud_kms_key" "example3" {
+resource "tencentcloud_kms_key" "example" {
   alias                = "tf-example-kms-key"
   description          = "example of kms key"
   key_rotation_enabled = false
   is_enabled           = false
 
   tags = {
-    "test-tag" = "unit-test"
+    createdBy = "Terraform"
   }
 }
 ```
@@ -80,6 +81,6 @@ In addition to all arguments above, the following attributes are exported:
 KMS keys can be imported using the id, e.g.
 
 ```
-$ terraform import tencentcloud_kms_key.foo 287e8f40-7cbb-11eb-9a3a-5254004f7f94
+$ terraform import tencentcloud_kms_key.example 287e8f40-7cbb-11eb-9a3a-5254004f7f94
 ```