@pulumi/azuredevops 3.11.0-alpha.1766173758 → 3.11.0

package/workitemquery.d.ts

@@ -0,0 +1,225 @@
+import * as pulumi from "@pulumi/pulumi";
+/**
+ * Manages a Work Item Query (WIQL based list / tree query) in Azure DevOps.
+ *
+ * A query can live either directly under one of the root areas `Shared Queries` or `My Queries`, or inside another query folder. You must provide exactly one of `area` (either `Shared Queries` or `My Queries`) or `parentId` (an existing folder's ID) when creating a query.
+ *
+ * The WIQL (Work Item Query Language) statement is used to define the query logic. See the [WIQL Syntax Reference](https://learn.microsoft.com/en-us/azure/devops/boards/queries/wiql-syntax?view=azure-devops) for more information.
+ *
+ * ## Example Usage
+ *
+ * ### Basic query under Shared Queries
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as azuredevops from "@pulumi/azuredevops";
+ *
+ * const example = new azuredevops.Project("example", {
+ *     name: "Example Project",
+ *     workItemTemplate: "Agile",
+ *     versionControl: "Git",
+ *     visibility: "private",
+ * });
+ * const allIssues = new azuredevops.Workitemquery("all_issues", {
+ *     projectId: example.id,
+ *     name: "All Active Issues",
+ *     area: "Shared Queries",
+ *     wiql: `SELECT [System.Id], [System.Title], [System.State]
+ * FROM WorkItems
+ * WHERE [System.WorkItemType] = 'Issue'
+ *   AND [System.State] <> 'Closed'
+ * ORDER BY [System.ChangedDate] DESC
+ * `,
+ * });
+ * ```
+ *
+ * ### Query inside a custom folder
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as azuredevops from "@pulumi/azuredevops";
+ *
+ * const example = new azuredevops.Project("example", {
+ *     name: "Example Project",
+ *     workItemTemplate: "Agile",
+ *     versionControl: "Git",
+ *     visibility: "private",
+ * });
+ * const teamFolder = new azuredevops.WorkitemqueryFolder("team_folder", {
+ *     projectId: example.id,
+ *     name: "Team",
+ *     area: "Shared Queries",
+ * });
+ * const myTeamBugs = new azuredevops.Workitemquery("my_team_bugs", {
+ *     projectId: example.id,
+ *     name: "Team Bugs",
+ *     parentId: teamFolder.id,
+ *     wiql: `SELECT [System.Id], [System.Title], [System.State], [System.AssignedTo]
+ * FROM WorkItems
+ * WHERE [System.WorkItemType] = 'Bug'
+ *   AND [System.State] <> 'Closed'
+ * ORDER BY [System.CreatedDate] DESC
+ * `,
+ * });
+ * ```
+ *
+ * ### Applying permissions to a query
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as azuredevops from "@pulumi/azuredevops";
+ * import * as std from "@pulumi/std";
+ *
+ * const example = new azuredevops.Project("example", {
+ *     name: "Example Project",
+ *     workItemTemplate: "Agile",
+ *     versionControl: "Git",
+ *     visibility: "private",
+ * });
+ * const teamFolder = new azuredevops.WorkitemqueryFolder("team_folder", {
+ *     projectId: example.id,
+ *     name: "Team",
+ *     area: "Shared Queries",
+ * });
+ * const myTeamBugs = new azuredevops.Workitemquery("my_team_bugs", {
+ *     projectId: example.id,
+ *     name: "Team Bugs",
+ *     parentId: teamFolder.id,
+ *     wiql: `SELECT [System.Id], [System.Title], [System.State], [System.AssignedTo]
+ * FROM WorkItems
+ * WHERE [System.WorkItemType] = 'Bug'
+ *   AND [System.State] <> 'Closed'
+ * ORDER BY [System.CreatedDate] DESC
+ * `,
+ * });
+ * const example_readers = azuredevops.getGroupOutput({
+ *     projectId: example.id,
+ *     name: "Readers",
+ * });
+ * const queryPermissions = new azuredevops.WorkItemQueryPermissions("query_permissions", {
+ *     projectId: example.id,
+ *     path: std.index.format({
+ *         input: "%s/%s",
+ *         args: [
+ *             teamFolder.name,
+ *             myTeamBugs.name,
+ *         ],
+ *     }).result,
+ *     principal: example_readers.apply(example_readers => example_readers.id),
+ *     permissions: {
+ *         Read: "Allow",
+ *         Contribute: "Deny",
+ *         ManagePermissions: "Deny",
+ *         Delete: "Deny",
+ *     },
+ * });
+ * ```
+ *
+ * ## Relevant Links
+ *
+ * * [Azure DevOps REST API - Work Item Query (Queries)](https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/queries?view=azure-devops-rest-7.1)
+ * * [WIQL Syntax Reference](https://learn.microsoft.com/en-us/azure/devops/boards/queries/wiql-syntax?view=azure-devops)
+ *
+ * ## PAT Permissions Required
+ *
+ * * **Work Items**: Read & Write
+ *
+ * ## Import
+ *
+ * The resource does not support import.
+ */
+export declare class Workitemquery extends pulumi.CustomResource {
+    /**
+     * Get an existing Workitemquery resource's state with the given name, ID, and optional extra
+     * properties used to qualify the lookup.
+     *
+     * @param name The _unique_ name of the resulting resource.
+     * @param id The _unique_ provider ID of the resource to lookup.
+     * @param state Any extra arguments used during the lookup.
+     * @param opts Optional settings to control the behavior of the CustomResource.
+     */
+    static get(name: string, id: pulumi.Input<pulumi.ID>, state?: WorkitemqueryState, opts?: pulumi.CustomResourceOptions): Workitemquery;
+    /**
+     * Returns true if the given object is an instance of Workitemquery.  This is designed to work even
+     * when multiple copies of the Pulumi SDK have been loaded into the same process.
+     */
+    static isInstance(obj: any): obj is Workitemquery;
+    /**
+     * Root folder for the query. Must be one of `Shared Queries` or `My Queries`.
+     */
+    readonly area: pulumi.Output<string | undefined>;
+    /**
+     * The display name of the query.
+     */
+    readonly name: pulumi.Output<string>;
+    /**
+     * The ID of the parent query folder under which to create the query.
+     */
+    readonly parentId: pulumi.Output<string | undefined>;
+    /**
+     * The ID of the Project containing the query.
+     */
+    readonly projectId: pulumi.Output<string>;
+    /**
+     * The WIQL (Work Item Query Language) statement. Length 1–32000 characters.
+     */
+    readonly wiql: pulumi.Output<string>;
+    /**
+     * Create a Workitemquery resource with the given unique name, arguments, and options.
+     *
+     * @param name The _unique_ name of the resource.
+     * @param args The arguments to use to populate this resource's properties.
+     * @param opts A bag of options that control this resource's behavior.
+     */
+    constructor(name: string, args: WorkitemqueryArgs, opts?: pulumi.CustomResourceOptions);
+}
+/**
+ * Input properties used for looking up and filtering Workitemquery resources.
+ */
+export interface WorkitemqueryState {
+    /**
+     * Root folder for the query. Must be one of `Shared Queries` or `My Queries`.
+     */
+    area?: pulumi.Input<string>;
+    /**
+     * The display name of the query.
+     */
+    name?: pulumi.Input<string>;
+    /**
+     * The ID of the parent query folder under which to create the query.
+     */
+    parentId?: pulumi.Input<string>;
+    /**
+     * The ID of the Project containing the query.
+     */
+    projectId?: pulumi.Input<string>;
+    /**
+     * The WIQL (Work Item Query Language) statement. Length 1–32000 characters.
+     */
+    wiql?: pulumi.Input<string>;
+}
+/**
+ * The set of arguments for constructing a Workitemquery resource.
+ */
+export interface WorkitemqueryArgs {
+    /**
+     * Root folder for the query. Must be one of `Shared Queries` or `My Queries`.
+     */
+    area?: pulumi.Input<string>;
+    /**
+     * The display name of the query.
+     */
+    name?: pulumi.Input<string>;
+    /**
+     * The ID of the parent query folder under which to create the query.
+     */
+    parentId?: pulumi.Input<string>;
+    /**
+     * The ID of the Project containing the query.
+     */
+    projectId: pulumi.Input<string>;
+    /**
+     * The WIQL (Work Item Query Language) statement. Length 1–32000 characters.
+     */
+    wiql: pulumi.Input<string>;
+}

package/workitemquery.js

@@ -0,0 +1,192 @@
+"use strict";
+// *** WARNING: this file was generated by pulumi-language-nodejs. ***
+// *** Do not edit by hand unless you're certain you know what you are doing! ***
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Workitemquery = void 0;
+const pulumi = require("@pulumi/pulumi");
+const utilities = require("./utilities");
+/**
+ * Manages a Work Item Query (WIQL based list / tree query) in Azure DevOps.
+ *
+ * A query can live either directly under one of the root areas `Shared Queries` or `My Queries`, or inside another query folder. You must provide exactly one of `area` (either `Shared Queries` or `My Queries`) or `parentId` (an existing folder's ID) when creating a query.
+ *
+ * The WIQL (Work Item Query Language) statement is used to define the query logic. See the [WIQL Syntax Reference](https://learn.microsoft.com/en-us/azure/devops/boards/queries/wiql-syntax?view=azure-devops) for more information.
+ *
+ * ## Example Usage
+ *
+ * ### Basic query under Shared Queries
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as azuredevops from "@pulumi/azuredevops";
+ *
+ * const example = new azuredevops.Project("example", {
+ *     name: "Example Project",
+ *     workItemTemplate: "Agile",
+ *     versionControl: "Git",
+ *     visibility: "private",
+ * });
+ * const allIssues = new azuredevops.Workitemquery("all_issues", {
+ *     projectId: example.id,
+ *     name: "All Active Issues",
+ *     area: "Shared Queries",
+ *     wiql: `SELECT [System.Id], [System.Title], [System.State]
+ * FROM WorkItems
+ * WHERE [System.WorkItemType] = 'Issue'
+ *   AND [System.State] <> 'Closed'
+ * ORDER BY [System.ChangedDate] DESC
+ * `,
+ * });
+ * ```
+ *
+ * ### Query inside a custom folder
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as azuredevops from "@pulumi/azuredevops";
+ *
+ * const example = new azuredevops.Project("example", {
+ *     name: "Example Project",
+ *     workItemTemplate: "Agile",
+ *     versionControl: "Git",
+ *     visibility: "private",
+ * });
+ * const teamFolder = new azuredevops.WorkitemqueryFolder("team_folder", {
+ *     projectId: example.id,
+ *     name: "Team",
+ *     area: "Shared Queries",
+ * });
+ * const myTeamBugs = new azuredevops.Workitemquery("my_team_bugs", {
+ *     projectId: example.id,
+ *     name: "Team Bugs",
+ *     parentId: teamFolder.id,
+ *     wiql: `SELECT [System.Id], [System.Title], [System.State], [System.AssignedTo]
+ * FROM WorkItems
+ * WHERE [System.WorkItemType] = 'Bug'
+ *   AND [System.State] <> 'Closed'
+ * ORDER BY [System.CreatedDate] DESC
+ * `,
+ * });
+ * ```
+ *
+ * ### Applying permissions to a query
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as azuredevops from "@pulumi/azuredevops";
+ * import * as std from "@pulumi/std";
+ *
+ * const example = new azuredevops.Project("example", {
+ *     name: "Example Project",
+ *     workItemTemplate: "Agile",
+ *     versionControl: "Git",
+ *     visibility: "private",
+ * });
+ * const teamFolder = new azuredevops.WorkitemqueryFolder("team_folder", {
+ *     projectId: example.id,
+ *     name: "Team",
+ *     area: "Shared Queries",
+ * });
+ * const myTeamBugs = new azuredevops.Workitemquery("my_team_bugs", {
+ *     projectId: example.id,
+ *     name: "Team Bugs",
+ *     parentId: teamFolder.id,
+ *     wiql: `SELECT [System.Id], [System.Title], [System.State], [System.AssignedTo]
+ * FROM WorkItems
+ * WHERE [System.WorkItemType] = 'Bug'
+ *   AND [System.State] <> 'Closed'
+ * ORDER BY [System.CreatedDate] DESC
+ * `,
+ * });
+ * const example_readers = azuredevops.getGroupOutput({
+ *     projectId: example.id,
+ *     name: "Readers",
+ * });
+ * const queryPermissions = new azuredevops.WorkItemQueryPermissions("query_permissions", {
+ *     projectId: example.id,
+ *     path: std.index.format({
+ *         input: "%s/%s",
+ *         args: [
+ *             teamFolder.name,
+ *             myTeamBugs.name,
+ *         ],
+ *     }).result,
+ *     principal: example_readers.apply(example_readers => example_readers.id),
+ *     permissions: {
+ *         Read: "Allow",
+ *         Contribute: "Deny",
+ *         ManagePermissions: "Deny",
+ *         Delete: "Deny",
+ *     },
+ * });
+ * ```
+ *
+ * ## Relevant Links
+ *
+ * * [Azure DevOps REST API - Work Item Query (Queries)](https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/queries?view=azure-devops-rest-7.1)
+ * * [WIQL Syntax Reference](https://learn.microsoft.com/en-us/azure/devops/boards/queries/wiql-syntax?view=azure-devops)
+ *
+ * ## PAT Permissions Required
+ *
+ * * **Work Items**: Read & Write
+ *
+ * ## Import
+ *
+ * The resource does not support import.
+ */
+class Workitemquery extends pulumi.CustomResource {
+    /**
+     * Get an existing Workitemquery resource's state with the given name, ID, and optional extra
+     * properties used to qualify the lookup.
+     *
+     * @param name The _unique_ name of the resulting resource.
+     * @param id The _unique_ provider ID of the resource to lookup.
+     * @param state Any extra arguments used during the lookup.
+     * @param opts Optional settings to control the behavior of the CustomResource.
+     */
+    static get(name, id, state, opts) {
+        return new Workitemquery(name, state, { ...opts, id: id });
+    }
+    /**
+     * Returns true if the given object is an instance of Workitemquery.  This is designed to work even
+     * when multiple copies of the Pulumi SDK have been loaded into the same process.
+     */
+    static isInstance(obj) {
+        if (obj === undefined || obj === null) {
+            return false;
+        }
+        return obj['__pulumiType'] === Workitemquery.__pulumiType;
+    }
+    constructor(name, argsOrState, opts) {
+        let resourceInputs = {};
+        opts = opts || {};
+        if (opts.id) {
+            const state = argsOrState;
+            resourceInputs["area"] = state?.area;
+            resourceInputs["name"] = state?.name;
+            resourceInputs["parentId"] = state?.parentId;
+            resourceInputs["projectId"] = state?.projectId;
+            resourceInputs["wiql"] = state?.wiql;
+        }
+        else {
+            const args = argsOrState;
+            if (args?.projectId === undefined && !opts.urn) {
+                throw new Error("Missing required property 'projectId'");
+            }
+            if (args?.wiql === undefined && !opts.urn) {
+                throw new Error("Missing required property 'wiql'");
+            }
+            resourceInputs["area"] = args?.area;
+            resourceInputs["name"] = args?.name;
+            resourceInputs["parentId"] = args?.parentId;
+            resourceInputs["projectId"] = args?.projectId;
+            resourceInputs["wiql"] = args?.wiql;
+        }
+        opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts);
+        super(Workitemquery.__pulumiType, name, resourceInputs, opts);
+    }
+}
+exports.Workitemquery = Workitemquery;
+/** @internal */
+Workitemquery.__pulumiType = 'azuredevops:index/workitemquery:Workitemquery';
+//# sourceMappingURL=workitemquery.js.map

package/workitemquery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workitemquery.js","sourceRoot":"","sources":["../workitemquery.ts"],"names":[],"mappings":";AAAA,sEAAsE;AACtE,iFAAiF;;;AAEjF,yCAAyC;AACzC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgIG;AACH,MAAa,aAAc,SAAQ,MAAM,CAAC,cAAc;IACpD;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAA2B,EAAE,KAA0B,EAAE,IAAmC;QACxH,OAAO,IAAI,aAAa,CAAC,IAAI,EAAO,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC;IAKD;;;OAGG;IACI,MAAM,CAAC,UAAU,CAAC,GAAQ;QAC7B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE;YACnC,OAAO,KAAK,CAAC;SAChB;QACD,OAAO,GAAG,CAAC,cAAc,CAAC,KAAK,aAAa,CAAC,YAAY,CAAC;IAC9D,CAAC;IA+BD,YAAY,IAAY,EAAE,WAAoD,EAAE,IAAmC;QAC/G,IAAI,cAAc,GAAkB,EAAE,CAAC;QACvC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,EAAE,EAAE;YACT,MAAM,KAAK,GAAG,WAA6C,CAAC;YAC5D,cAAc,CAAC,MAAM,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC;YACrC,cAAc,CAAC,MAAM,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC;YACrC,cAAc,CAAC,UAAU,CAAC,GAAG,KAAK,EAAE,QAAQ,CAAC;YAC7C,cAAc,CAAC,WAAW,CAAC,GAAG,KAAK,EAAE,SAAS,CAAC;YAC/C,cAAc,CAAC,MAAM,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC;SACxC;aAAM;YACH,MAAM,IAAI,GAAG,WAA4C,CAAC;YAC1D,IAAI,IAAI,EAAE,SAAS,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC5C,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;aAC5D;YACD,IAAI,IAAI,EAAE,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBACvC,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;aACvD;YACD,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC;YACpC,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC;YACpC,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC;YAC5C,cAAc,CAAC,WAAW,CAAC,GAAG,IAAI,EAAE,SAAS,CAAC;YAC9C,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC;SACvC;QACD,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,CAAC,CAAC;QACnE,KAAK,CAAC,aAAa,CAAC,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IAClE,CAAC;;AAnFL,sCAoFC;AAtEG,gBAAgB;AACO,0BAAY,GAAG,+CAA+C,CAAC"}

package/workitemqueryFolder.d.ts

@@ -0,0 +1,142 @@
+import * as pulumi from "@pulumi/pulumi";
+/**
+ * Manages a Work Item Query Folder in Azure DevOps.
+ *
+ * Folders allow you to organize queries in a hierarchy beneath either the `Shared Queries` or `My Queries` root folder (area).
+ * You must provide exactly one of `area` (either `Shared Queries` or `My Queries`) or `parentId` (an existing folder's ID) when creating a folder.
+ *
+ * ## Example Usage
+ *
+ * ### Basic folder under Shared Queries
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as azuredevops from "@pulumi/azuredevops";
+ *
+ * const example = new azuredevops.Project("example", {
+ *     name: "Example Project",
+ *     workItemTemplate: "Agile",
+ *     versionControl: "Git",
+ *     visibility: "private",
+ *     description: "Managed by Pulumi",
+ * });
+ * const teamFolder = new azuredevops.WorkitemqueryFolder("team_folder", {
+ *     projectId: example.id,
+ *     name: "Team",
+ *     area: "Shared Queries",
+ * });
+ * ```
+ *
+ * ### Nested folder
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as azuredevops from "@pulumi/azuredevops";
+ *
+ * const parent = new azuredevops.WorkitemqueryFolder("parent", {
+ *     projectId: example.id,
+ *     name: "Parent",
+ *     area: "Shared Queries",
+ * });
+ * const child = new azuredevops.WorkitemqueryFolder("child", {
+ *     projectId: example.id,
+ *     name: "Child",
+ *     parentId: parent.id,
+ * });
+ * ```
+ *
+ * ## Relevant Links
+ *
+ * * [Azure DevOps REST API - Work Item Query (Queries)](https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/queries?view=azure-devops-rest-7.1)
+ *
+ * ## PAT Permissions Required
+ *
+ * * **Work Items**: Read & Write
+ *
+ * ## Import
+ *
+ * The resource does not support import.
+ */
+export declare class WorkitemqueryFolder extends pulumi.CustomResource {
+    /**
+     * Get an existing WorkitemqueryFolder resource's state with the given name, ID, and optional extra
+     * properties used to qualify the lookup.
+     *
+     * @param name The _unique_ name of the resulting resource.
+     * @param id The _unique_ provider ID of the resource to lookup.
+     * @param state Any extra arguments used during the lookup.
+     * @param opts Optional settings to control the behavior of the CustomResource.
+     */
+    static get(name: string, id: pulumi.Input<pulumi.ID>, state?: WorkitemqueryFolderState, opts?: pulumi.CustomResourceOptions): WorkitemqueryFolder;
+    /**
+     * Returns true if the given object is an instance of WorkitemqueryFolder.  This is designed to work even
+     * when multiple copies of the Pulumi SDK have been loaded into the same process.
+     */
+    static isInstance(obj: any): obj is WorkitemqueryFolder;
+    /**
+     * Root folder. Must be one of `Shared Queries` or `My Queries`.
+     */
+    readonly area: pulumi.Output<string | undefined>;
+    /**
+     * The display name of the folder.
+     */
+    readonly name: pulumi.Output<string>;
+    /**
+     * The ID of the parent query folder.
+     */
+    readonly parentId: pulumi.Output<string | undefined>;
+    /**
+     * The ID of the Project containing the folder.
+     */
+    readonly projectId: pulumi.Output<string>;
+    /**
+     * Create a WorkitemqueryFolder resource with the given unique name, arguments, and options.
+     *
+     * @param name The _unique_ name of the resource.
+     * @param args The arguments to use to populate this resource's properties.
+     * @param opts A bag of options that control this resource's behavior.
+     */
+    constructor(name: string, args: WorkitemqueryFolderArgs, opts?: pulumi.CustomResourceOptions);
+}
+/**
+ * Input properties used for looking up and filtering WorkitemqueryFolder resources.
+ */
+export interface WorkitemqueryFolderState {
+    /**
+     * Root folder. Must be one of `Shared Queries` or `My Queries`.
+     */
+    area?: pulumi.Input<string>;
+    /**
+     * The display name of the folder.
+     */
+    name?: pulumi.Input<string>;
+    /**
+     * The ID of the parent query folder.
+     */
+    parentId?: pulumi.Input<string>;
+    /**
+     * The ID of the Project containing the folder.
+     */
+    projectId?: pulumi.Input<string>;
+}
+/**
+ * The set of arguments for constructing a WorkitemqueryFolder resource.
+ */
+export interface WorkitemqueryFolderArgs {
+    /**
+     * Root folder. Must be one of `Shared Queries` or `My Queries`.
+     */
+    area?: pulumi.Input<string>;
+    /**
+     * The display name of the folder.
+     */
+    name?: pulumi.Input<string>;
+    /**
+     * The ID of the parent query folder.
+     */
+    parentId?: pulumi.Input<string>;
+    /**
+     * The ID of the Project containing the folder.
+     */
+    projectId: pulumi.Input<string>;
+}

package/workitemqueryFolder.js

@@ -0,0 +1,116 @@
+"use strict";
+// *** WARNING: this file was generated by pulumi-language-nodejs. ***
+// *** Do not edit by hand unless you're certain you know what you are doing! ***
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkitemqueryFolder = void 0;
+const pulumi = require("@pulumi/pulumi");
+const utilities = require("./utilities");
+/**
+ * Manages a Work Item Query Folder in Azure DevOps.
+ *
+ * Folders allow you to organize queries in a hierarchy beneath either the `Shared Queries` or `My Queries` root folder (area).
+ * You must provide exactly one of `area` (either `Shared Queries` or `My Queries`) or `parentId` (an existing folder's ID) when creating a folder.
+ *
+ * ## Example Usage
+ *
+ * ### Basic folder under Shared Queries
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as azuredevops from "@pulumi/azuredevops";
+ *
+ * const example = new azuredevops.Project("example", {
+ *     name: "Example Project",
+ *     workItemTemplate: "Agile",
+ *     versionControl: "Git",
+ *     visibility: "private",
+ *     description: "Managed by Pulumi",
+ * });
+ * const teamFolder = new azuredevops.WorkitemqueryFolder("team_folder", {
+ *     projectId: example.id,
+ *     name: "Team",
+ *     area: "Shared Queries",
+ * });
+ * ```
+ *
+ * ### Nested folder
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as azuredevops from "@pulumi/azuredevops";
+ *
+ * const parent = new azuredevops.WorkitemqueryFolder("parent", {
+ *     projectId: example.id,
+ *     name: "Parent",
+ *     area: "Shared Queries",
+ * });
+ * const child = new azuredevops.WorkitemqueryFolder("child", {
+ *     projectId: example.id,
+ *     name: "Child",
+ *     parentId: parent.id,
+ * });
+ * ```
+ *
+ * ## Relevant Links
+ *
+ * * [Azure DevOps REST API - Work Item Query (Queries)](https://learn.microsoft.com/en-us/rest/api/azure/devops/wit/queries?view=azure-devops-rest-7.1)
+ *
+ * ## PAT Permissions Required
+ *
+ * * **Work Items**: Read & Write
+ *
+ * ## Import
+ *
+ * The resource does not support import.
+ */
+class WorkitemqueryFolder extends pulumi.CustomResource {
+    /**
+     * Get an existing WorkitemqueryFolder resource's state with the given name, ID, and optional extra
+     * properties used to qualify the lookup.
+     *
+     * @param name The _unique_ name of the resulting resource.
+     * @param id The _unique_ provider ID of the resource to lookup.
+     * @param state Any extra arguments used during the lookup.
+     * @param opts Optional settings to control the behavior of the CustomResource.
+     */
+    static get(name, id, state, opts) {
+        return new WorkitemqueryFolder(name, state, { ...opts, id: id });
+    }
+    /**
+     * Returns true if the given object is an instance of WorkitemqueryFolder.  This is designed to work even
+     * when multiple copies of the Pulumi SDK have been loaded into the same process.
+     */
+    static isInstance(obj) {
+        if (obj === undefined || obj === null) {
+            return false;
+        }
+        return obj['__pulumiType'] === WorkitemqueryFolder.__pulumiType;
+    }
+    constructor(name, argsOrState, opts) {
+        let resourceInputs = {};
+        opts = opts || {};
+        if (opts.id) {
+            const state = argsOrState;
+            resourceInputs["area"] = state?.area;
+            resourceInputs["name"] = state?.name;
+            resourceInputs["parentId"] = state?.parentId;
+            resourceInputs["projectId"] = state?.projectId;
+        }
+        else {
+            const args = argsOrState;
+            if (args?.projectId === undefined && !opts.urn) {
+                throw new Error("Missing required property 'projectId'");
+            }
+            resourceInputs["area"] = args?.area;
+            resourceInputs["name"] = args?.name;
+            resourceInputs["parentId"] = args?.parentId;
+            resourceInputs["projectId"] = args?.projectId;
+        }
+        opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts);
+        super(WorkitemqueryFolder.__pulumiType, name, resourceInputs, opts);
+    }
+}
+exports.WorkitemqueryFolder = WorkitemqueryFolder;
+/** @internal */
+WorkitemqueryFolder.__pulumiType = 'azuredevops:index/workitemqueryFolder:WorkitemqueryFolder';
+//# sourceMappingURL=workitemqueryFolder.js.map

package/workitemqueryFolder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workitemqueryFolder.js","sourceRoot":"","sources":["../workitemqueryFolder.ts"],"names":[],"mappings":";AAAA,sEAAsE;AACtE,iFAAiF;;;AAEjF,yCAAyC;AACzC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,MAAa,mBAAoB,SAAQ,MAAM,CAAC,cAAc;IAC1D;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAA2B,EAAE,KAAgC,EAAE,IAAmC;QAC9H,OAAO,IAAI,mBAAmB,CAAC,IAAI,EAAO,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1E,CAAC;IAKD;;;OAGG;IACI,MAAM,CAAC,UAAU,CAAC,GAAQ;QAC7B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE;YACnC,OAAO,KAAK,CAAC;SAChB;QACD,OAAO,GAAG,CAAC,cAAc,CAAC,KAAK,mBAAmB,CAAC,YAAY,CAAC;IACpE,CAAC;IA2BD,YAAY,IAAY,EAAE,WAAgE,EAAE,IAAmC;QAC3H,IAAI,cAAc,GAAkB,EAAE,CAAC;QACvC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,EAAE,EAAE;YACT,MAAM,KAAK,GAAG,WAAmD,CAAC;YAClE,cAAc,CAAC,MAAM,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC;YACrC,cAAc,CAAC,MAAM,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC;YACrC,cAAc,CAAC,UAAU,CAAC,GAAG,KAAK,EAAE,QAAQ,CAAC;YAC7C,cAAc,CAAC,WAAW,CAAC,GAAG,KAAK,EAAE,SAAS,CAAC;SAClD;aAAM;YACH,MAAM,IAAI,GAAG,WAAkD,CAAC;YAChE,IAAI,IAAI,EAAE,SAAS,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC5C,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;aAC5D;YACD,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC;YACpC,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC;YACpC,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC;YAC5C,cAAc,CAAC,WAAW,CAAC,GAAG,IAAI,EAAE,SAAS,CAAC;SACjD;QACD,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,CAAC,CAAC;QACnE,KAAK,CAAC,mBAAmB,CAAC,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IACxE,CAAC;;AA1EL,kDA2EC;AA7DG,gBAAgB;AACO,gCAAY,GAAG,2DAA2D,CAAC"}