Add API Changes for Agent Pools to Workspaces Feature

[Netra2104]

Description

In Atlas, new features were added where the user can change the scope for agent pools to either the entire organization or to specific workspaces. The user can specify a list of allowed workspaces.

Testing plan

External links

• Related PR
• API documentation
• Asana

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.

$ go-tfe % envchain go-tfe go test -run TestAgentPoolsUpdate -v ./... -tags=integration
=== RUN   TestAgentPoolsUpdate
=== RUN   TestAgentPoolsUpdate/with_valid_options
=== RUN   TestAgentPoolsUpdate/when_updating_the_name
=== RUN   TestAgentPoolsUpdate/without_a_valid_agent_pool_ID
=== RUN   TestAgentPoolsUpdate/when_updating_allowed-workspaces
=== RUN   TestAgentPoolsUpdate/when_updating_organization_scope
--- PASS: TestAgentPoolsUpdate (5.57s)
    --- PASS: TestAgentPoolsUpdate/with_valid_options (0.83s)
    --- PASS: TestAgentPoolsUpdate/when_updating_the_name (0.76s)
    --- PASS: TestAgentPoolsUpdate/without_a_valid_agent_pool_ID (0.00s)
    --- PASS: TestAgentPoolsUpdate/when_updating_allowed-workspaces (1.29s)
    --- PASS: TestAgentPoolsUpdate/when_updating_organization_scope (0.88s)
PASS
ok      github.com/hashicorp/go-tfe     (cached)
?       github.com/hashicorp/go-tfe/examples/organizations      [no test files]
?       github.com/hashicorp/go-tfe/examples/workspaces [no test files]
?       github.com/hashicorp/go-tfe/mocks       [no test files]
...

[brandonc]

Typically, unless this is a dependency for another change, we usually wait until new beta API features are generally available before releasing them in go-tfe, because we want this repo to mostly match what is in the API documentation.

[hs26gill]

Looks Great!

[jbonhag]

Nice work!! 🎉

[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.