feat: cam (#2292)

* feat: cam

* feat: changelog

* feat: changelog

---------

Co-authored-by: WeiMengXS <nickcchen@tencent.com>

Author: WeiMengXS

.changelog/2292.txt

@@ -0,0 +1,3 @@
+```release-note:new-data-source
+tencentcloud_cam_group_user_account
+```

tencentcloud/data_source_tc_cam_group_user_account.go

@@ -0,0 +1,168 @@
+/*
+Use this data source to query detailed information of cam group_user_account
+
+Example Usage
+
+```hcl
+data "tencentcloud_cam_group_user_account" "group_user_account" {
+  sub_uin = 100033690181
+}
+```
+*/
+package tencentcloud
+
+import (
+	"context"
+
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/resource"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
+	cam "github.com/tencentcloud/tencentcloud-sdk-go/tencentcloud/cam/v20190116"
+	"github.com/tencentcloudstack/terraform-provider-tencentcloud/tencentcloud/internal/helper"
+)
+
+func dataSourceTencentCloudCamGroupUserAccount() *schema.Resource {
+	return &schema.Resource{
+		Read: dataSourceTencentCloudCamGroupUserAccountRead,
+		Schema: map[string]*schema.Schema{
+			"uid": {
+				Optional:    true,
+				Type:        schema.TypeInt,
+				Description: "Sub-user uid.",
+			},
+
+			"rp": {
+				Optional:    true,
+				Type:        schema.TypeInt,
+				Description: "Number per page. The default is 20.",
+			},
+
+			"sub_uin": {
+				Optional:    true,
+				Type:        schema.TypeInt,
+				Description: "Sub-user uin.",
+			},
+
+			"total_num": {
+				Computed:    true,
+				Type:        schema.TypeInt,
+				Description: "The total number of user groups the sub-user has joined.",
+			},
+
+			"group_info": {
+				Computed:    true,
+				Type:        schema.TypeList,
+				Description: "User group information.",
+				Elem: &schema.Resource{
+					Schema: map[string]*schema.Schema{
+						"group_id": {
+							Type:        schema.TypeInt,
+							Computed:    true,
+							Description: "User group ID.",
+						},
+						"group_name": {
+							Type:        schema.TypeString,
+							Computed:    true,
+							Description: "User group name.",
+						},
+						"create_time": {
+							Type:        schema.TypeString,
+							Computed:    true,
+							Description: "Create time.",
+						},
+						"remark": {
+							Type:        schema.TypeString,
+							Computed:    true,
+							Description: "Remark.",
+						},
+					},
+				},
+			},
+
+			"result_output_file": {
+				Type:        schema.TypeString,
+				Optional:    true,
+				Description: "Used to save results.",
+			},
+		},
+	}
+}
+
+func dataSourceTencentCloudCamGroupUserAccountRead(d *schema.ResourceData, meta interface{}) error {
+	defer logElapsed("data_source.tencentcloud_cam_group_user_account.read")()
+	defer inconsistentCheck(d, meta)()
+
+	logId := getLogId(contextNil)
+
+	ctx := context.WithValue(context.TODO(), logIdKey, logId)
+
+	paramMap := make(map[string]interface{})
+	if v, ok := d.GetOkExists("uid"); ok {
+		paramMap["Uid"] = helper.IntUint64(v.(int))
+	}
+
+	if v, ok := d.GetOkExists("rp"); ok {
+		paramMap["Rp"] = helper.IntUint64(v.(int))
+	}
+
+	if v, ok := d.GetOkExists("sub_uin"); ok {
+		paramMap["SubUin"] = helper.IntUint64(v.(int))
+	}
+
+	service := CamService{client: meta.(*TencentCloudClient).apiV3Conn}
+
+	var groupInfoList []*cam.GroupInfo
+	err := resource.Retry(readRetryTimeout, func() *resource.RetryError {
+		result, e := service.DescribeCamGroupUserAccountByFilter(ctx, paramMap)
+		if e != nil {
+			return retryError(e)
+		}
+		groupInfoList = result
+		return nil
+	})
+	if err != nil {
+		return err
+	}
+
+	ids := make([]string, 0, len(groupInfoList))
+	tmpList := make([]map[string]interface{}, 0, len(groupInfoList))
+
+	if len(groupInfoList) > 0 {
+		_ = d.Set("total_num", len(groupInfoList))
+	}
+
+	if groupInfoList != nil {
+		for _, groupInfo := range groupInfoList {
+			groupInfoMap := map[string]interface{}{}
+
+			if groupInfo.GroupId != nil {
+				groupInfoMap["group_id"] = groupInfo.GroupId
+			}
+
+			if groupInfo.GroupName != nil {
+				groupInfoMap["group_name"] = groupInfo.GroupName
+			}
+
+			if groupInfo.CreateTime != nil {
+				groupInfoMap["create_time"] = groupInfo.CreateTime
+			}
+
+			if groupInfo.Remark != nil {
+				groupInfoMap["remark"] = groupInfo.Remark
+			}
+
+			ids = append(ids, helper.UInt64ToStr(*groupInfo.GroupId))
+			tmpList = append(tmpList, groupInfoMap)
+		}
+
+		_ = d.Set("group_info", tmpList)
+	}
+
+	d.SetId(helper.DataResourceIdsHash(ids))
+	output, ok := d.GetOk("result_output_file")
+	if ok && output.(string) != "" {
+		if e := writeToFile(output.(string), tmpList); e != nil {
+			return e
+		}
+	}
+	return nil
+}

tencentcloud/data_source_tc_cam_group_user_account_test.go

@@ -0,0 +1,31 @@
+package tencentcloud
+
+import (
+	"testing"
+
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/resource"
+)
+
+func TestAccTencentCloudCamGroupUserAccountDataSource_basic(t *testing.T) {
+	t.Parallel()
+	resource.Test(t, resource.TestCase{
+		PreCheck: func() {
+			testAccPreCheck(t)
+		},
+		Providers: testAccProviders,
+		Steps: []resource.TestStep{
+			{
+				Config: testAccCamGroupUserAccountDataSource,
+				Check: resource.ComposeTestCheckFunc(testAccCheckTencentCloudDataSourceID("data.tencentcloud_cam_group_user_account.group_user_account"),
+					resource.TestCheckResourceAttr("data.tencentcloud_cam_group_user_account.group_user_account", "sub_uin", "100033690181")),
+			},
+		},
+	})
+}
+
+const testAccCamGroupUserAccountDataSource = `
+
+data "tencentcloud_cam_group_user_account" "group_user_account" {
+  sub_uin = 100033690181
+}
+`

tencentcloud/provider.go

@@ -228,6 +228,7 @@ Cloud Access Management(CAM)
     tencentcloud_cam_account_summary
     tencentcloud_cam_policy_granting_service_access
     tencentcloud_cam_oidc_config
+    tencentcloud_cam_group_user_account
 
   Resource
     tencentcloud_cam_role
@@ -2846,6 +2847,7 @@ func Provider() *schema.Provider {
 			"tencentcloud_cam_list_attached_user_policy":                dataSourceTencentCloudCamListAttachedUserPolicy(),
 			"tencentcloud_cam_secret_last_used_time":                    dataSourceTencentCloudCamSecretLastUsedTime(),
 			"tencentcloud_cam_policy_granting_service_access":           dataSourceTencentCloudCamPolicyGrantingServiceAccess(),
+			"tencentcloud_cam_group_user_account":                       dataSourceTencentCloudCamGroupUserAccount(),
 			"tencentcloud_dlc_check_data_engine_image_can_be_rollback":  dataSourceTencentCloudDlcCheckDataEngineImageCanBeRollback(),
 			"tencentcloud_dlc_check_data_engine_image_can_be_upgrade":   dataSourceTencentCloudDlcCheckDataEngineImageCanBeUpgrade(),
 			"tencentcloud_dlc_describe_user_type":                       dataSourceTencentCloudDlcDescribeUserType(),

tencentcloud/service_tencentcloud_cam.go

@@ -1914,3 +1914,53 @@ func (me *CamService) DescribeCamAccountSummaryByFilter(ctx context.Context) (Ac
 	AccountSummary = response.Response
 	return
 }
+
+func (me *CamService) DescribeCamGroupUserAccountByFilter(ctx context.Context, param map[string]interface{}) (GroupUserAccount []*cam.GroupInfo, errRet error) {
+	var (
+		logId   = getLogId(ctx)
+		request = cam.NewListGroupsForUserRequest()
+	)
+
+	defer func() {
+		if errRet != nil {
+			log.Printf("[CRITAL]%s api[%s] fail, request body [%s], reason[%s]\n", logId, request.GetAction(), request.ToJsonString(), errRet.Error())
+		}
+	}()
+
+	for k, v := range param {
+		if k == "Uid" {
+			request.Uid = v.(*uint64)
+		}
+		if k == "SubUin" {
+			request.SubUin = v.(*uint64)
+		}
+	}
+
+	ratelimit.Check(request.GetAction())
+
+	pageStart := uint64(1)
+	rp := uint64(PAGE_ITEM) //to save in extension
+	result := make([]*cam.GroupInfo, 0)
+	for {
+		request.Page = &pageStart
+		request.Rp = &rp
+		response, err := me.client.UseCamClient().ListGroupsForUser(request)
+		if err != nil {
+			errRet = err
+			return
+		}
+		log.Printf("[DEBUG]%s api[%s] success, request body [%s], response body [%s]\n", logId, request.GetAction(), request.ToJsonString(), response.ToJsonString())
+
+		if response == nil || len(response.Response.GroupInfo) < 1 {
+			break
+		}
+		result = append(result, response.Response.GroupInfo...)
+		if len(response.Response.GroupInfo) < PAGE_ITEM {
+			break
+		}
+
+		pageStart += 1
+	}
+	GroupUserAccount = result
+	return
+}

website/docs/d/cam_group_user_account.html.markdown

@@ -0,0 +1,42 @@
+---
+subcategory: "Cloud Access Management(CAM)"
+layout: "tencentcloud"
+page_title: "TencentCloud: tencentcloud_cam_group_user_account"
+sidebar_current: "docs-tencentcloud-datasource-cam_group_user_account"
+description: |-
+  Use this data source to query detailed information of cam group_user_account
+---
+
+# tencentcloud_cam_group_user_account
+
+Use this data source to query detailed information of cam group_user_account
+
+## Example Usage
+
+```hcl
+data "tencentcloud_cam_group_user_account" "group_user_account" {
+  sub_uin = 100033690181
+}
+```
+
+## Argument Reference
+
+The following arguments are supported:
+
+* `result_output_file` - (Optional, String) Used to save results.
+* `rp` - (Optional, Int) Number per page. The default is 20.
+* `sub_uin` - (Optional, Int) Sub-user uin.
+* `uid` - (Optional, Int) Sub-user uid.
+
+## Attributes Reference
+
+In addition to all arguments above, the following attributes are exported:
+
+* `group_info` - User group information.
+  * `create_time` - Create time.
+  * `group_id` - User group ID.
+  * `group_name` - User group name.
+  * `remark` - Remark.
+* `total_num` - The total number of user groups the sub-user has joined.
+
+

website/tencentcloud.erb

@@ -528,6 +528,9 @@
                                 <li>
                                     <a href="/docs/providers/tencentcloud/d/cam_group_policy_attachments.html">tencentcloud_cam_group_policy_attachments</a>
                                 </li>
+                                <li>
+                                    <a href="/docs/providers/tencentcloud/d/cam_group_user_account.html">tencentcloud_cam_group_user_account</a>
+                                </li>
                                 <li>
                                     <a href="/docs/providers/tencentcloud/d/cam_groups.html">tencentcloud_cam_groups</a>
                                 </li>