List tag bindings by resource

project.go

@@ -31,6 +31,9 @@ type Projects interface {
 
 	// Delete a project.
 	Delete(ctx context.Context, projectID string) error
+
+	// ListTagBindings lists all tag bindings associated with the project.
+	ListTagBindings(ctx context.Context, projectID string) ([]*TagBinding, error)
 }
 
 // projects implements Projects
@@ -104,6 +107,10 @@ type ProjectUpdateOptions struct {
 
 	// Optional: A description for the project.
 	Description *string `jsonapi:"attr,description,omitempty"`
+
+	// Associated TagBindings of the project. Note that this will replace
+	// all existing tag bindings.
+	TagBindings []*TagBinding `jsonapi:"relation,tag-bindings,omitempty"`
 }
 
 // List all projects.
@@ -178,6 +185,30 @@ func (s *projects) Read(ctx context.Context, projectID string) (*Project, error)
 	return p, nil
 }
 
+func (s *projects) ListTagBindings(ctx context.Context, projectID string) ([]*TagBinding, error) {
+	if !validStringID(&projectID) {
+		return nil, ErrInvalidProjectID
+	}
+
+	u := fmt.Sprintf("projects/%s/tag-bindings", url.PathEscape(projectID))
+	req, err := s.client.NewRequest("GET", u, nil)
+	if err != nil {
+		return nil, err
+	}
+
+	var list struct {
+		*Pagination
+		Items []*TagBinding
+	}
+
+	err = req.Do(ctx, &list)
+	if err != nil {
+		return nil, err
+	}
+
+	return list.Items, nil
+}
+
 // Update a project by its ID
 func (s *projects) Update(ctx context.Context, projectID string, options ProjectUpdateOptions) (*Project, error) {
 	if !validStringID(&projectID) {

projects_integration_test.go

@@ -197,22 +197,32 @@ func TestProjectsUpdate(t *testing.T) {
 	client := testClient(t)
 	ctx := context.Background()
 
-	orgTest, orgTestCleanup := createOrganization(t, client)
-	defer orgTestCleanup()
+	orgTest, _ := createOrganization(t, client)
+	// defer orgTestCleanup()
 
 	t.Run("with valid options", func(t *testing.T) {
-		kBefore, kTestCleanup := createProject(t, client, orgTest)
-		defer kTestCleanup()
+		kBefore, _ := createProject(t, client, orgTest)
+		// defer kTestCleanup()
 
 		kAfter, err := client.Projects.Update(ctx, kBefore.ID, ProjectUpdateOptions{
 			Name:        String("new project name"),
 			Description: String("updated description"),
+			TagBindings: []*TagBinding{
+				{Key: "foo", Value: "bar"},
+			},
 		})
 		require.NoError(t, err)
 
 		assert.Equal(t, kBefore.ID, kAfter.ID)
 		assert.NotEqual(t, kBefore.Name, kAfter.Name)
 		assert.NotEqual(t, kBefore.Description, kAfter.Description)
+
+		bindings, err := client.Projects.ListTagBindings(ctx, kAfter.ID)
+		require.NoError(t, err)
+
+		assert.Len(t, bindings, 1)
+		assert.Equal(t, "foo", bindings[0].Key)
+		assert.Equal(t, "bar", bindings[0].Value)
 	})
 
 	t.Run("when updating with invalid name", func(t *testing.T) {

workspace.go

@@ -131,6 +131,9 @@ type Workspaces interface {
 	// DeleteDataRetentionPolicy deletes a workspace's data retention policy
 	// **Note: This functionality is only available in Terraform Enterprise.**
 	DeleteDataRetentionPolicy(ctx context.Context, workspaceID string) error
+
+	// ListTagBindings lists all tag bindings associated with the workspace.
+	ListTagBindings(ctx context.Context, workspaceID string) ([]*TagBinding, error)
 }
 
 // workspaces implements Workspaces.
@@ -733,6 +736,30 @@ func (s *workspaces) List(ctx context.Context, organization string, options *Wor
 	return wl, nil
 }
 
+func (s *workspaces) ListTagBindings(ctx context.Context, workspaceID string) ([]*TagBinding, error) {
+	if !validStringID(&workspaceID) {
+		return nil, ErrInvalidWorkspaceID
+	}
+
+	u := fmt.Sprintf("workspaces/%s/tag-bindings", url.PathEscape(workspaceID))
+	req, err := s.client.NewRequest("GET", u, nil)
+	if err != nil {
+		return nil, err
+	}
+
+	var list struct {
+		*Pagination
+		Items []*TagBinding
+	}
+
+	err = req.Do(ctx, &list)
+	if err != nil {
+		return nil, err
+	}
+
+	return list.Items, nil
+}
+
 // Create is used to create a new workspace.
 func (s *workspaces) Create(ctx context.Context, organization string, options WorkspaceCreateOptions) (*Workspace, error) {
 	if !validStringID(&organization) {

workspace_integration_test.go

@@ -1298,10 +1298,14 @@ func TestWorkspacesUpdate(t *testing.T) {
 			assert.Equal(t, *options.TerraformVersion, item.TerraformVersion)
 			assert.Equal(t, options.TriggerPrefixes, item.TriggerPrefixes)
 			assert.Equal(t, *options.WorkingDirectory, item.WorkingDirectory)
-			assert.Len(t, item.TagBindings, 1)
-			assert.Equal(t, "foo", item.TagBindings[0].Key)
-			assert.Equal(t, "bar", item.TagBindings[0].Value)
 		}
+
+		bindings, err := client.Workspaces.ListTagBindings(ctx, wTest.ID)
+		require.NoError(t, err)
+
+		assert.Len(t, bindings, 1)
+		assert.Equal(t, "foo", bindings[0].Key)
+		assert.Equal(t, "bar", bindings[0].Value)
 	})
 
 	t.Run("when options includes both an operations value and an enforcement mode value", func(t *testing.T) {