fix(cam): [122268974] CAM update doc (#3190)

* add

* add

Author: SevenEarth

tencentcloud/services/cam/resource_tc_cam_access_key.md

@@ -1,30 +1,43 @@
-Provides a resource to create a cam access_key
+Provides a resource to create a CAM access key
 
 Example Usage
 
+Create access key
+
 ```hcl
-resource "tencentcloud_cam_access_key" "access_key" {
-  target_uin = 100033690181
+data "tencentcloud_user_info" "info" {}
+
+resource "tencentcloud_cam_access_key" "example" {
+  target_uin = data.tencentcloud_user_info.info.uin
 }
 ```
-Update
+
+Update access key
+
 ```hcl
-resource "tencentcloud_cam_access_key" "access_key" {
-  target_uin = 100033690181
-  status = "Inactive"
+data "tencentcloud_user_info" "info" {}
+
+resource "tencentcloud_cam_access_key" "example" {
+  target_uin = data.tencentcloud_user_info.info.uin
+  status     = "Inactive"
 }
 ```
-Encrypted
+
+Encrypted access key
+
 ```hcl
-resource "tencentcloud_cam_access_key" "access_key" {
-  target_uin = 100033690181
-  pgp_key = "keybase:some_person_that_exists"
+data "tencentcloud_user_info" "info" {}
+
+resource "tencentcloud_cam_access_key" "example" {
+  target_uin = data.tencentcloud_user_info.info.uin
+  pgp_key    = "keybase:some_person_that_exists"
 }
 ```
+
 Import
 
-cam access_key can be imported using the id, e.g.
+cam access key can be imported using the id, e.g.
 
 ```
-terraform import tencentcloud_cam_access_key.access_key access_key_id
+terraform import tencentcloud_cam_access_key.example 100037718101#AKID7F******************
 ```

tencentcloud/services/cam/resource_tc_cam_mfa_flag.go

@@ -27,12 +27,14 @@ func ResourceTencentCloudCamMfaFlag() *schema.Resource {
 		Schema: map[string]*schema.Schema{
 			"op_uin": {
 				Required:    true,
+				ForceNew:    true,
 				Type:        schema.TypeInt,
 				Description: "Operate uin.",
 			},
 
 			"login_flag": {
 				Optional:    true,
+				Computed:    true,
 				Type:        schema.TypeList,
 				MaxItems:    1,
 				Description: "Login flag setting.",
@@ -59,6 +61,7 @@ func ResourceTencentCloudCamMfaFlag() *schema.Resource {
 
 			"action_flag": {
 				Optional:    true,
+				Computed:    true,
 				Type:        schema.TypeList,
 				MaxItems:    1,
 				Description: "Action flag setting.",
@@ -122,6 +125,8 @@ func resourceTencentCloudCamMfaFlagRead(d *schema.ResourceData, meta interface{}
 		return nil
 	}
 
+	_ = d.Set("op_uin", uin)
+
 	if loginFlag != nil {
 		loginFlagMap := map[string]interface{}{}
 

tencentcloud/services/cam/resource_tc_cam_mfa_flag.md

@@ -1,30 +1,31 @@
-Provides a resource to create a cam mfa_flag
+Provides a resource to create a CAM mfa flag
 
 Example Usage
 
 ```hcl
-data "tencentcloud_user_info" "info"{}
+data "tencentcloud_user_info" "info" {}
 
-resource "tencentcloud_cam_mfa_flag" "mfa_flag" {
+resource "tencentcloud_cam_mfa_flag" "example" {
   op_uin = data.tencentcloud_user_info.info.uin
+
   login_flag {
-	phone = 0
-	stoken = 1
-	wechat = 0
+    phone  = 0
+    stoken = 1
+    wechat = 0
   }
+
   action_flag {
-	phone = 0
-	stoken = 1
-	wechat = 0
+    phone  = 0
+    stoken = 1
+    wechat = 0
   }
 }
-
 ```
 
 Import
 
-cam mfa_flag can be imported using the id, e.g.
+CAM mfa flag can be imported using the id, e.g.
 
 ```
-terraform import tencentcloud_cam_mfa_flag.mfa_flag mfa_flag_id
+terraform import tencentcloud_cam_mfa_flag.example 100037718110
 ```

tencentcloud/services/cam/resource_tc_cam_policy_version.go

@@ -175,10 +175,18 @@ func resourceTencentCloudCamPolicyVersionRead(d *schema.ResourceData, meta inter
 
 		if policyVersion.Document != nil {
 			policyVersionMap["document"] = policyVersion.Document
+			_ = d.Set("policy_document", policyVersion.Document)
 		}
 
 		_ = d.Set("policy_version", []interface{}{policyVersionMap})
 
+		if policyVersion.IsDefaultVersion != nil {
+			if *policyVersion.IsDefaultVersion == 0 {
+				_ = d.Set("set_as_default", false)
+			} else {
+				_ = d.Set("set_as_default", true)
+			}
+		}
 	}
 
 	return nil

tencentcloud/services/cam/resource_tc_cam_policy_version.md

@@ -1,59 +1,59 @@
-Provides a resource to create a cam policy_version
+Provides a resource to create a CAM policy version
 
 Example Usage
 
 ```hcl
-resource "tencentcloud_cam_policy_version" "policy_version" {
-  policy_id = 171173780
+resource "tencentcloud_cam_policy_version" "example" {
+  policy_id      = 171173780
+  set_as_default = "false"
   policy_document = jsonencode({
-    "version": "2.0",
-    "statement": [
+    "version" : "3.0",
+    "statement" : [
       {
-        "effect": "allow",
-        "action": [
+        "effect" : "allow",
+        "action" : [
           "sts:AssumeRole"
         ],
-        "resource": [
+        "resource" : [
           "*"
         ]
       },
       {
-        "effect": "allow",
-        "action": [
+        "effect" : "allow",
+        "action" : [
           "cos:PutObject"
         ],
-        "resource": [
+        "resource" : [
           "*"
         ]
       },
       {
-        "effect": "deny",
-        "action": [
+        "effect" : "deny",
+        "action" : [
           "aa:*"
         ],
-        "resource": [
+        "resource" : [
           "*"
         ]
       },
       {
-        "effect": "deny",
-        "action": [
+        "effect" : "deny",
+        "action" : [
           "aa:*"
         ],
-        "resource": [
+        "resource" : [
           "*"
         ]
       }
     ]
   })
-  set_as_default = "false"
 }
 ```
 
 Import
 
-cam policy_version can be imported using the id, e.g.
+CAM policy version can be imported using the id, e.g.
 
 ```
-terraform import tencentcloud_cam_policy_version.policy_version policy_version_id
+terraform import tencentcloud_cam_policy_version.example 234290251#3
 ```

tencentcloud/services/cam/resource_tc_cam_service_linked_role.md

@@ -1,15 +1,22 @@
-Provides a resource to create a cam service_linked_role
+Provides a resource to create a CAM service linked role
 
 Example Usage
 
 ```hcl
-resource "tencentcloud_cam_service_linked_role" "service_linked_role" {
-  qcs_service_name = ["cvm.qcloud.com","ekslog.tke.cloud.tencent.com"]
-  custom_suffix = "tf"
-  description = "desc cam"
+resource "tencentcloud_cam_service_linked_role" "example" {
+  qcs_service_name = ["cvm.qcloud.com", "ekslog.tke.cloud.tencent.com"]
+  custom_suffix    = "tf-example"
+  description      = "description."
   tags = {
-    "createdBy" = "terraform"
+    createdBy = "Terraform"
   }
 }
+```
 
+Import
+
+CAM service linked role can be imported using the id, e.g.
+
+```
+$ terraform import tencentcloud_cam_service_linked_role.example 4611686018441982195
 ```

tencentcloud/services/cam/resource_tc_cam_set_policy_version_config.md

@@ -1,18 +1,18 @@
-Provides a resource to create a cam set_policy_version_config
+Provides a resource to create a CAM set policy version config
 
 Example Usage
 
 ```hcl
-resource "tencentcloud_cam_set_policy_version_config" "set_policy_version_config" {
-  policy_id = 171162811
-  version_id = 2
+resource "tencentcloud_cam_set_policy_version_config" "example" {
+  policy_id  = 234290251
+  version_id = 3
 }
 ```
 
 Import
 
-cam set_policy_version_config can be imported using the id, e.g.
+CAM set policy version config can be imported using the id, e.g.
 
 ```
-terraform import tencentcloud_cam_set_policy_version_config.set_policy_version_config set_policy_version_config_id
+terraform import tencentcloud_cam_set_policy_version_config.example 234290251#3
 ```

tencentcloud/services/cam/resource_tc_cam_tag_role_attachment.md

@@ -1,21 +1,38 @@
-Provides a resource to create a cam tag_role
+Provides a resource to create a CAM tag role
 
 Example Usage
 
+Create by role_id
+
+```hcl
+resource "tencentcloud_cam_tag_role_attachment" "example" {
+  role_id = "4611686018441060141"
+
+  tags {
+    key   = "tagKey"
+    value = "tagValue"
+  }
+}
+```
+
+Create by role_name
+
 ```hcl
-resource "tencentcloud_cam_tag_role_attachment" "tag_role" {
+resource "tencentcloud_cam_tag_role_attachment" "example" {
+  role_name = "tf-example"
+
   tags {
-    key = "test1"
-    value = "test1"
+    key   = "tagKey"
+    value = "tagValue"
   }
-  role_id = "test-cam-tag"
 }
 ```
 
 Import
 
-cam tag_role can be imported using the id, e.g.
+CAM tag role can be imported using the id, e.g.
 
 ```
-terraform import tencentcloud_cam_tag_role_attachment.tag_role tag_role_id
+# Please use role_name#role_id
+terraform import tencentcloud_cam_tag_role_attachment.example tf-example#4611686018441060141
 ```

tencentcloud/services/cam/resource_tc_cam_user_permission_boundary_attachment.md

@@ -1,18 +1,18 @@
-Provides a resource to create a cam user_permission_boundary
+Provides a resource to create a CAM user permission boundary
 
 Example Usage
 
 ```hcl
-resource "tencentcloud_cam_user_permission_boundary_attachment" "user_permission_boundary" {
-  target_uin = 100032767426
-  policy_id = 151113272
+resource "tencentcloud_cam_user_permission_boundary_attachment" "example" {
+  target_uin = 100037718101
+  policy_id  = 234290251
 }
 ```
 
 Import
 
-cam user_permission_boundary can be imported using the id, e.g.
+CAM user permission boundary can be imported using the id, e.g.
 
 ```
-terraform import tencentcloud_cam_user_permission_boundary_attachment.user_permission_boundary user_permission_boundary_id
+terraform import tencentcloud_cam_user_permission_boundary_attachment.example 100037718101#234290251
 ```