Add support for listing Runs in an organization

[arybolovlev]

Description

This PR adds support for listing Runs in an organization.

Testing plan

1. Create a new organization.
2. Create a new workspace within the new organization.
3. Optionally to validate filters create a new agent pool and attach it to the new workspace.
4. Initialize 2 or more runs.
5. List runs for the organization. Optionally filter by workspace or agent pool name.

External links

• API documentation

Output from tests

Including output from tests may require access to a TFE instance. Ignore this section if you have no environment to test against.

$ TFE_ADDRESS="https://app.terraform.io/" TFE_TOKEN="xLIrzcOP64xzKg.atlasv1.XXX" go test -run TestRunsListForOrganization -v

=== RUN   TestRunsListForOrganization
=== RUN   TestRunsListForOrganization/without_list_options
=== RUN   TestRunsListForOrganization/without_list_options_and_include_as_nil
=== RUN   TestRunsListForOrganization/with_list_options
=== RUN   TestRunsListForOrganization/with_workspace_included
=== RUN   TestRunsListForOrganization/without_a_valid_organization_name
=== RUN   TestRunsListForOrganization/with_filter_by_agent_pool
=== RUN   TestRunsListForOrganization/with_filter_by_workspace
--- PASS: TestRunsListForOrganization (5.76s)
    --- PASS: TestRunsListForOrganization/without_list_options (0.19s)
    --- PASS: TestRunsListForOrganization/without_list_options_and_include_as_nil (0.19s)
    --- PASS: TestRunsListForOrganization/with_list_options (0.14s)
    --- PASS: TestRunsListForOrganization/with_workspace_included (0.21s)
    --- PASS: TestRunsListForOrganization/without_a_valid_organization_name (0.00s)
    --- PASS: TestRunsListForOrganization/with_filter_by_agent_pool (0.18s)
    --- PASS: TestRunsListForOrganization/with_filter_by_workspace (0.23s)
PASS
ok      github.com/hashicorp/go-tfe     6.079s

[datadog-terraform-cloud-hashicorp]

Datadog Report

Branch report: add-org-runs-list
Commit report: 2ea0355
Test service: hashicorp/go-tfe

✅ 0 Failed, 1430 Passed, 167 Skipped, 19m 1.92s Total Time
⬆️ Test Sessions change in coverage: 1 increased (+0.1%)

[brandonc]

This is a good, highly conventional change and I appreciate the extra effort that took. We'll be able to merge this if you were to add a CHANGELOG entry.

[arybolovlev]

This is a good, highly conventional change and I appreciate the extra effort that took. We'll be able to merge this if you were to add a CHANGELOG entry.

Thank you for your quick and accurate review, @brandonc! I have addressed your comments.

[github-actions]

Reminder to the contributor that merged this PR: if your changes have added important functionality or fixed a relevant bug, open a follow-up PR to update CHANGELOG.md with a note on your changes.