fix(clb): [137495591] tencentcloud_clb_security_group_attachment update doc (#3119)

* add

* add

Author: SevenEarth

.changelog/3119.txt

@@ -0,0 +1,3 @@
+```release-note:enhancement
+resource/tencentcloud_clb_security_group_attachment: update doc
+```

tencentcloud/services/clb/resource_tc_clb_instance.go

@@ -107,6 +107,7 @@ func ResourceTencentCloudClbInstance() *schema.Resource {
 			"security_groups": {
 				Type:        schema.TypeList,
 				Optional:    true,
+				Computed:    true,
 				Elem:        &schema.Schema{Type: schema.TypeString},
 				Description: "Security groups of the CLB instance. Supports both `OPEN` and `INTERNAL` CLBs.",
 			},

tencentcloud/services/clb/resource_tc_clb_security_group_attachment.md

@@ -1,18 +1,63 @@
-Provides a resource to create a clb security_group_attachment
+Provides a resource to create a clb security group attachment
+
+~> **NOTE:** If resource `tencentcloud_clb_security_group_attachment` is used to manage the security group of clb instance, the `security_groups` field cannot be explicitly used in resource `tencentcloud_clb_instance`
 
 Example Usage
 
 ```hcl
-resource "tencentcloud_clb_security_group_attachment" "security_group_attachment" {
-  security_group = "sg-ijato2x1"
-  load_balancer_ids = ["lb-5dnrkgry"]
+variable "availability_zone" {
+  default = "ap-guangzhou-6"
+}
+
+// create vpc
+resource "tencentcloud_vpc" "vpc" {
+  cidr_block = "10.0.0.0/16"
+  name       = "vpc"
+}
+
+// create subnet
+resource "tencentcloud_subnet" "subnet" {
+  vpc_id            = tencentcloud_vpc.vpc.id
+  availability_zone = var.availability_zone
+  name              = "subnet"
+  cidr_block        = "10.0.1.0/24"
+  is_multicast      = false
+}
+
+// create security group
+resource "tencentcloud_security_group" "example" {
+  name        = "tf-example"
+  description = "sg desc."
+  project_id  = 0
+
+  tags = {
+    createBy = "Terraform"
+  }
+}
+
+// create clb instance
+resource "tencentcloud_clb_instance" "example" {
+  network_type = "INTERNAL"
+  clb_name     = "clb-example"
+  project_id   = 0
+  vpc_id       = tencentcloud_vpc.vpc.id
+  subnet_id    = tencentcloud_subnet.subnet.id
+  tags = {
+    createBy = "Terraform"
+  }
+}
+
+// attachment
+resource "tencentcloud_clb_security_group_attachment" "example" {
+  security_group    = tencentcloud_security_group.example.id
+  load_balancer_ids = [tencentcloud_clb_instance.example.id]
 }
 ```
 
 Import
 
-clb security_group_attachment can be imported using the id, e.g.
+clb security group attachment can be imported using the id, e.g.
 
 ```
-terraform import tencentcloud_clb_security_group_attachment.security_group_attachment security_group_id#clb_id
+terraform import tencentcloud_clb_security_group_attachment.example sg-13mgpbm3#lb-gjz8ntf2
 ```

website/docs/r/clb_security_group_attachment.html.markdown

@@ -4,19 +4,64 @@ layout: "tencentcloud"
 page_title: "TencentCloud: tencentcloud_clb_security_group_attachment"
 sidebar_current: "docs-tencentcloud-resource-clb_security_group_attachment"
 description: |-
-  Provides a resource to create a clb security_group_attachment
+  Provides a resource to create a clb security group attachment
 ---
 
 # tencentcloud_clb_security_group_attachment
 
-Provides a resource to create a clb security_group_attachment
+Provides a resource to create a clb security group attachment
+
+~> **NOTE:** If resource `tencentcloud_clb_security_group_attachment` is used to manage the security group of clb instance, the `security_groups` field cannot be explicitly used in resource `tencentcloud_clb_instance`
 
 ## Example Usage
 
 ```hcl
-resource "tencentcloud_clb_security_group_attachment" "security_group_attachment" {
-  security_group    = "sg-ijato2x1"
-  load_balancer_ids = ["lb-5dnrkgry"]
+variable "availability_zone" {
+  default = "ap-guangzhou-6"
+}
+
+// create vpc
+resource "tencentcloud_vpc" "vpc" {
+  cidr_block = "10.0.0.0/16"
+  name       = "vpc"
+}
+
+// create subnet
+resource "tencentcloud_subnet" "subnet" {
+  vpc_id            = tencentcloud_vpc.vpc.id
+  availability_zone = var.availability_zone
+  name              = "subnet"
+  cidr_block        = "10.0.1.0/24"
+  is_multicast      = false
+}
+
+// create security group
+resource "tencentcloud_security_group" "example" {
+  name        = "tf-example"
+  description = "sg desc."
+  project_id  = 0
+
+  tags = {
+    createBy = "Terraform"
+  }
+}
+
+// create clb instance
+resource "tencentcloud_clb_instance" "example" {
+  network_type = "INTERNAL"
+  clb_name     = "clb-example"
+  project_id   = 0
+  vpc_id       = tencentcloud_vpc.vpc.id
+  subnet_id    = tencentcloud_subnet.subnet.id
+  tags = {
+    createBy = "Terraform"
+  }
+}
+
+// attachment
+resource "tencentcloud_clb_security_group_attachment" "example" {
+  security_group    = tencentcloud_security_group.example.id
+  load_balancer_ids = [tencentcloud_clb_instance.example.id]
 }
 ```
 
@@ -37,9 +82,9 @@ In addition to all arguments above, the following attributes are exported:
 
 ## Import
 
-clb security_group_attachment can be imported using the id, e.g.
+clb security group attachment can be imported using the id, e.g.
 
 ```
-terraform import tencentcloud_clb_security_group_attachment.security_group_attachment security_group_id#clb_id
+terraform import tencentcloud_clb_security_group_attachment.example sg-13mgpbm3#lb-gjz8ntf2
 ```