Merge pull request #1104 from hashicorp/sebasslash/tf-25028_add-policies-paths-runs-param

beta: add policy-paths run param

Author: sebasslash

run.go

@@ -141,6 +141,7 @@ type Run struct {
 	IsDestroy              bool                 `jsonapi:"attr,is-destroy"`
 	Message                string               `jsonapi:"attr,message"`
 	Permissions            *RunPermissions      `jsonapi:"attr,permissions"`
+	PolicyPaths            []string             `jsonapi:"attr,policy-paths,omitempty"`
 	PositionInQueue        int                  `jsonapi:"attr,position-in-queue"`
 	PlanOnly               bool                 `jsonapi:"attr,plan-only"`
 	Refresh                bool                 `jsonapi:"attr,refresh"`
@@ -385,6 +386,12 @@ type RunCreateOptions struct {
 	// resource addresses.
 	ReplaceAddrs []string `jsonapi:"attr,replace-addrs,omitempty"`
 
+	// PolicyPaths is a list of relative directory paths that point to policy
+	// configuration files.
+	//
+	// **Note: This field is in BETA and subject to change.**
+	PolicyPaths []string `jsonapi:"attr,policy-paths,omitempty"`
+
 	// AutoApply determines if the run should be applied automatically without
 	// user confirmation. It defaults to the Workspace.AutoApply setting.
 	AutoApply *bool `jsonapi:"attr,auto-apply,omitempty"`

run_integration_test.go

@@ -353,6 +353,24 @@ func TestRunsCreate(t *testing.T) {
 			}
 		}
 	})
+
+	t.Run("with policy paths", func(t *testing.T) {
+		skipUnlessBeta(t)
+
+		opts := RunCreateOptions{
+			Message:     String("creating with policy paths"),
+			Workspace:   wTest,
+			PolicyPaths: []string{"./path/to/dir1", "./path/to/dir2"},
+		}
+
+		r, err := client.Runs.Create(ctx, opts)
+		require.NoError(t, err)
+		require.NotEmpty(t, r.PolicyPaths)
+
+		assert.Len(t, r.PolicyPaths, 2)
+		assert.Contains(t, r.PolicyPaths, "./path/to/dir1")
+		assert.Contains(t, r.PolicyPaths, "./path/to/dir2")
+	})
 }
 
 func TestRunsRead_CostEstimate(t *testing.T) {
@@ -403,6 +421,31 @@ func TestRunsReadWithOptions(t *testing.T) {
 	})
 }
 
+func TestRunsReadWithPolicyPaths(t *testing.T) {
+	skipUnlessBeta(t)
+
+	client := testClient(t)
+	ctx := context.Background()
+
+	wTest, wTestCleanup := createWorkspace(t, client, nil)
+	t.Cleanup(wTestCleanup)
+
+	_, cvCleanup := createUploadedConfigurationVersion(t, client, wTest)
+	t.Cleanup(cvCleanup)
+
+	r, err := client.Runs.Create(ctx, RunCreateOptions{
+		Workspace:   wTest,
+		PolicyPaths: []string{"./foo"},
+	})
+	require.NoError(t, err)
+
+	r, err = client.Runs.Read(ctx, r.ID)
+	require.NoError(t, err)
+
+	require.NotEmpty(t, r.PolicyPaths)
+	assert.Contains(t, r.PolicyPaths, "./foo")
+}
+
 func TestRunsApply(t *testing.T) {
 	client := testClient(t)
 	ctx := context.Background()