[7.17](backport #40135) [aws] Fix missing metrics bug when include_linked_accounts set to false

[mergify]

Proposed commit message

This PR is to fix a bug in cloudwatch metricbeat module when include_linked_accounts is false. Because where the wrongly put return, we are missing metrics in pagination. I also added a test for the case when there is more than one page of results from ListMetrics API.

Checklist

• My code follows the style guidelines of this project
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• I have made corresponding change to the default configuration files
• I have added tests that prove my fix is effective or that my feature works
• I have added an entry in CHANGELOG.next.asciidoc or CHANGELOG-developer.next.asciidoc.

Disruptive User Impact

No disruptive user impact.

How to test this PR locally

1. Setup your AWS account to have multiple RDS clusters and make sure we have metrics in CloudWatch.
2. Start Metricbeat with aws.yml looks like this:

- module: aws
  period: 1m
  credential_profile_name: elastic-observability
  metricsets:
    - cloudwatch
  regions: eu-west-3
  latency: 10m
  include_linked_accounts: false
  metrics:
    - namespace: AWS/RDS
      name: ["CPUUtilization"]
      resource_type: rds
      statistic: ["Average"]

You should see metrics only being collected from 2 RDS clusters. But if you change the include_linked_accounts to true, then you will get metrics from all clusters (5 in this case).
3. Apply the changes from this PR and rebuild metricbeat locally. Run with the same aws.yml with include_linked_accounts equals to false and you should see metrics from all clusters now.

Related issues

• Closes [aws] missing metrics when include_linked_accounts set to false #40071

  ---

  This is an automatic backport of pull request [aws] Fix missing metrics bug when include_linked_accounts set to false #40135 done by Mergify.

[mergify]

Cherry-pick of 8da898f has failed:

On branch mergify/bp/7.17/pr-40135
Your branch is up to date with 'origin/7.17'.

You are currently cherry-picking commit 8da898fb47.
  (fix conflicts and run "git cherry-pick --continue")
  (use "git cherry-pick --skip" to skip this patch)
  (use "git cherry-pick --abort" to cancel the cherry-pick operation)

Changes to be committed:
	modified:   CHANGELOG.next.asciidoc

Unmerged paths:
  (use "git add <file>..." to mark resolution)
	both modified:   x-pack/metricbeat/module/aws/utils.go
	both modified:   x-pack/metricbeat/module/aws/utils_test.go

To fix up this pull request, you can check it out locally. See documentation: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/checking-out-pull-requests-locally

[botelastic]

This pull request doesn't have a Team:<team> label.