@pulumi/gitlab 4.6.0 → 4.7.0-alpha.1648756283

package/getProjects.d.ts

@@ -1,11 +1,13 @@
 import * as pulumi from "@pulumi/pulumi";
 import { output as outputs } from "./types";
 /**
- * Provide details about a list of projects in the Gitlab provider. Listing all projects and group projects with [project filtering](https://docs.gitlab.com/ee/api/projects.html#list-user-projects) or [group project filtering](https://docs.gitlab.com/ee/api/groups.html#list-a-groups-projects) is supported.
+ * The `gitlab.getProjects` data source allows details of multiple projects to be retrieved. Optionally filtered by the set attributes.
  *
- * > **NOTE**: This data source supports all available filters exposed by the `xanzy/go-gitlab` package, which might not expose all available filters exposed by the Gitlab APIs.
+ * > This data source supports all available filters exposed by the xanzy/go-gitlab package, which might not expose all available filters exposed by the Gitlab APIs.
  *
- * > **NOTE**: The owner sub-attributes are only populated if the Gitlab token used has an administrator scope.
+ * > The owner sub-attributes are only populated if the Gitlab token used has an administrator scope.
+ *
+ * **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/projects.html#list-all-projects)
  *
  * ## Example Usage
  *
@@ -33,186 +35,57 @@ export declare function getProjects(args?: GetProjectsArgs, opts?: pulumi.Invoke
  * A collection of arguments for invoking getProjects.
  */
 export interface GetProjectsArgs {
-    /**
-     * Limit by archived status.
-     */
     archived?: boolean;
-    /**
-     * The ID of the group owned by the authenticated user to look projects for within. Cannot be used with `minAccessLevel`, `withProgrammingLanguage` or `statistics`.
-     */
     groupId?: number;
-    /**
-     * Include projects in subgroups of this group. Default is `false`. Needs `groupId`.
-     */
     includeSubgroups?: boolean;
-    /**
-     * The maximum number of project results pages that may be queried. Prevents overloading your Gitlab instance in case of a misconfiguration.
-     */
     maxQueryablePages?: number;
-    /**
-     * Limit by projects that the current user is a member of.
-     */
     membership?: boolean;
-    /**
-     * Limit to projects where current user has at least this access level, refer to the [official documentation](https://docs.gitlab.com/ee/api/members.html) for values. Cannot be used with `groupId`.
-     */
     minAccessLevel?: number;
-    /**
-     * Return projects ordered by `id`, `name`, `path`, `createdAt`, `updatedAt`, or `lastActivityAt` fields. Default is `createdAt`.
-     */
     orderBy?: string;
-    /**
-     * Limit by projects owned by the current user.
-     */
     owned?: boolean;
-    /**
-     * The first page to begin the query on.
-     */
     page?: number;
-    /**
-     * The number of results to return per page.
-     */
     perPage?: number;
-    /**
-     * Return list of authorized projects matching the search criteria.
-     */
     search?: string;
-    /**
-     * Return only the ID, URL, name, and path of each project.
-     */
     simple?: boolean;
-    /**
-     * Return projects sorted in `asc` or `desc` order. Default is `desc`.
-     */
     sort?: string;
-    /**
-     * Limit by projects starred by the current user.
-     */
     starred?: boolean;
-    /**
-     * Include project statistics. Cannot be used with `groupId`.
-     */
     statistics?: boolean;
-    /**
-     * Limit by visibility `public`, `internal`, or `private`.
-     */
     visibility?: string;
-    /**
-     * Include custom attributes in response *(admins only)*.
-     */
     withCustomAttributes?: boolean;
-    /**
-     * Limit by projects with issues feature enabled. Default is `false`.
-     */
     withIssuesEnabled?: boolean;
-    /**
-     * Limit by projects with merge requests feature enabled. Default is `false`.
-     */
     withMergeRequestsEnabled?: boolean;
-    /**
-     * Limit by projects which use the given programming language. Cannot be used with `groupId`.
-     */
     withProgrammingLanguage?: string;
-    /**
-     * Include projects shared to this group. Default is `true`. Needs `groupId`.
-     */
     withShared?: boolean;
 }
 /**
  * A collection of values returned by getProjects.
  */
 export interface GetProjectsResult {
-    /**
-     * Limit by archived status.
-     */
     readonly archived?: boolean;
-    /**
-     * The ID of the group owned by the authenticated user to look projects for within. Cannot be used with `minAccessLevel`, `withProgrammingLanguage` or `statistics`.
-     */
     readonly groupId?: number;
     /**
      * The provider-assigned unique ID for this managed resource.
      */
     readonly id: string;
-    /**
-     * Include projects in subgroups of this group. Default is `false`. Needs `groupId`.
-     */
     readonly includeSubgroups?: boolean;
-    /**
-     * The maximum number of project results pages that may be queried. Prevents overloading your Gitlab instance in case of a misconfiguration.
-     */
     readonly maxQueryablePages?: number;
-    /**
-     * Limit by projects that the current user is a member of.
-     */
     readonly membership?: boolean;
-    /**
-     * Limit to projects where current user has at least this access level, refer to the [official documentation](https://docs.gitlab.com/ee/api/members.html) for values. Cannot be used with `groupId`.
-     */
     readonly minAccessLevel?: number;
-    /**
-     * Return projects ordered by `id`, `name`, `path`, `createdAt`, `updatedAt`, or `lastActivityAt` fields. Default is `createdAt`.
-     */
     readonly orderBy?: string;
-    /**
-     * Limit by projects owned by the current user.
-     */
     readonly owned?: boolean;
-    /**
-     * The first page to begin the query on.
-     */
     readonly page?: number;
-    /**
-     * The number of results to return per page.
-     */
     readonly perPage?: number;
-    /**
-     * A list containing the projects matching the supplied arguments
-     */
     readonly projects: outputs.GetProjectsProject[];
-    /**
-     * Return list of authorized projects matching the search criteria.
-     */
     readonly search?: string;
-    /**
-     * Return only the ID, URL, name, and path of each project.
-     */
     readonly simple?: boolean;
-    /**
-     * Return projects sorted in `asc` or `desc` order. Default is `desc`.
-     */
     readonly sort?: string;
-    /**
-     * Limit by projects starred by the current user.
-     */
     readonly starred?: boolean;
-    /**
-     * Include project statistics. Cannot be used with `groupId`.
-     */
     readonly statistics?: boolean;
-    /**
-     * Limit by visibility `public`, `internal`, or `private`.
-     */
     readonly visibility?: string;
-    /**
-     * Include custom attributes in response *(admins only)*.
-     */
     readonly withCustomAttributes?: boolean;
-    /**
-     * Limit by projects with issues feature enabled. Default is `false`.
-     */
     readonly withIssuesEnabled?: boolean;
-    /**
-     * Limit by projects with merge requests feature enabled. Default is `false`.
-     */
     readonly withMergeRequestsEnabled?: boolean;
-    /**
-     * Limit by projects which use the given programming language. Cannot be used with `groupId`.
-     */
     readonly withProgrammingLanguage?: string;
-    /**
-     * Include projects shared to this group. Default is `true`. Needs `groupId`.
-     */
     readonly withShared?: boolean;
 }
 export declare function getProjectsOutput(args?: GetProjectsOutputArgs, opts?: pulumi.InvokeOptions): pulumi.Output<GetProjectsResult>;
@@ -220,88 +93,25 @@ export declare function getProjectsOutput(args?: GetProjectsOutputArgs, opts?: p
  * A collection of arguments for invoking getProjects.
  */
 export interface GetProjectsOutputArgs {
-    /**
-     * Limit by archived status.
-     */
     archived?: pulumi.Input<boolean>;
-    /**
-     * The ID of the group owned by the authenticated user to look projects for within. Cannot be used with `minAccessLevel`, `withProgrammingLanguage` or `statistics`.
-     */
     groupId?: pulumi.Input<number>;
-    /**
-     * Include projects in subgroups of this group. Default is `false`. Needs `groupId`.
-     */
     includeSubgroups?: pulumi.Input<boolean>;
-    /**
-     * The maximum number of project results pages that may be queried. Prevents overloading your Gitlab instance in case of a misconfiguration.
-     */
     maxQueryablePages?: pulumi.Input<number>;
-    /**
-     * Limit by projects that the current user is a member of.
-     */
     membership?: pulumi.Input<boolean>;
-    /**
-     * Limit to projects where current user has at least this access level, refer to the [official documentation](https://docs.gitlab.com/ee/api/members.html) for values. Cannot be used with `groupId`.
-     */
     minAccessLevel?: pulumi.Input<number>;
-    /**
-     * Return projects ordered by `id`, `name`, `path`, `createdAt`, `updatedAt`, or `lastActivityAt` fields. Default is `createdAt`.
-     */
     orderBy?: pulumi.Input<string>;
-    /**
-     * Limit by projects owned by the current user.
-     */
     owned?: pulumi.Input<boolean>;
-    /**
-     * The first page to begin the query on.
-     */
     page?: pulumi.Input<number>;
-    /**
-     * The number of results to return per page.
-     */
     perPage?: pulumi.Input<number>;
-    /**
-     * Return list of authorized projects matching the search criteria.
-     */
     search?: pulumi.Input<string>;
-    /**
-     * Return only the ID, URL, name, and path of each project.
-     */
     simple?: pulumi.Input<boolean>;
-    /**
-     * Return projects sorted in `asc` or `desc` order. Default is `desc`.
-     */
     sort?: pulumi.Input<string>;
-    /**
-     * Limit by projects starred by the current user.
-     */
     starred?: pulumi.Input<boolean>;
-    /**
-     * Include project statistics. Cannot be used with `groupId`.
-     */
     statistics?: pulumi.Input<boolean>;
-    /**
-     * Limit by visibility `public`, `internal`, or `private`.
-     */
     visibility?: pulumi.Input<string>;
-    /**
-     * Include custom attributes in response *(admins only)*.
-     */
     withCustomAttributes?: pulumi.Input<boolean>;
-    /**
-     * Limit by projects with issues feature enabled. Default is `false`.
-     */
     withIssuesEnabled?: pulumi.Input<boolean>;
-    /**
-     * Limit by projects with merge requests feature enabled. Default is `false`.
-     */
     withMergeRequestsEnabled?: pulumi.Input<boolean>;
-    /**
-     * Limit by projects which use the given programming language. Cannot be used with `groupId`.
-     */
     withProgrammingLanguage?: pulumi.Input<string>;
-    /**
-     * Include projects shared to this group. Default is `true`. Needs `groupId`.
-     */
     withShared?: pulumi.Input<boolean>;
 }

package/getProjects.js

@@ -6,11 +6,13 @@ exports.getProjectsOutput = exports.getProjects = void 0;
 const pulumi = require("@pulumi/pulumi");
 const utilities = require("./utilities");
 /**
- * Provide details about a list of projects in the Gitlab provider. Listing all projects and group projects with [project filtering](https://docs.gitlab.com/ee/api/projects.html#list-user-projects) or [group project filtering](https://docs.gitlab.com/ee/api/groups.html#list-a-groups-projects) is supported.
+ * The `gitlab.getProjects` data source allows details of multiple projects to be retrieved. Optionally filtered by the set attributes.
  *
- * > **NOTE**: This data source supports all available filters exposed by the `xanzy/go-gitlab` package, which might not expose all available filters exposed by the Gitlab APIs.
+ * > This data source supports all available filters exposed by the xanzy/go-gitlab package, which might not expose all available filters exposed by the Gitlab APIs.
  *
- * > **NOTE**: The owner sub-attributes are only populated if the Gitlab token used has an administrator scope.
+ * > The owner sub-attributes are only populated if the Gitlab token used has an administrator scope.
+ *
+ * **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/projects.html#list-all-projects)
  *
  * ## Example Usage
  *

package/getProjects.js.map

@@ -1 +1 @@
-{"version":3,"file":"getProjects.js","sourceRoot":"","sources":["../getProjects.ts"],"names":[],"mappings":";AAAA,wFAAwF;AACxF,iFAAiF;;;AAEjF,yCAAyC;AAEzC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,SAAgB,WAAW,CAAC,IAAsB,EAAE,IAA2B;IAC3E,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IAClB,IAAI,CAAC,IAAI,EAAE;QACP,IAAI,GAAG,EAAE,CAAA;KACZ;IAED,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,CAAC,CAAC;IACnE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,sCAAsC,EAAE;QACjE,UAAU,EAAE,IAAI,CAAC,QAAQ;QACzB,SAAS,EAAE,IAAI,CAAC,OAAO;QACvB,kBAAkB,EAAE,IAAI,CAAC,gBAAgB;QACzC,mBAAmB,EAAE,IAAI,CAAC,iBAAiB;QAC3C,YAAY,EAAE,IAAI,CAAC,UAAU;QAC7B,gBAAgB,EAAE,IAAI,CAAC,cAAc;QACrC,SAAS,EAAE,IAAI,CAAC,OAAO;QACvB,OAAO,EAAE,IAAI,CAAC,KAAK;QACnB,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,SAAS,EAAE,IAAI,CAAC,OAAO;QACvB,QAAQ,EAAE,IAAI,CAAC,MAAM;QACrB,QAAQ,EAAE,IAAI,CAAC,MAAM;QACrB,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,SAAS,EAAE,IAAI,CAAC,OAAO;QACvB,YAAY,EAAE,IAAI,CAAC,UAAU;QAC7B,YAAY,EAAE,IAAI,CAAC,UAAU;QAC7B,sBAAsB,EAAE,IAAI,CAAC,oBAAoB;QACjD,mBAAmB,EAAE,IAAI,CAAC,iBAAiB;QAC3C,0BAA0B,EAAE,IAAI,CAAC,wBAAwB;QACzD,yBAAyB,EAAE,IAAI,CAAC,uBAAuB;QACvD,YAAY,EAAE,IAAI,CAAC,UAAU;KAChC,EAAE,IAAI,CAAC,CAAC;AACb,CAAC;AA9BD,kCA8BC;AA8LD,SAAgB,iBAAiB,CAAC,IAA4B,EAAE,IAA2B;IACvF,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;AAC/D,CAAC;AAFD,8CAEC"}
+{"version":3,"file":"getProjects.js","sourceRoot":"","sources":["../getProjects.ts"],"names":[],"mappings":";AAAA,wFAAwF;AACxF,iFAAiF;;;AAEjF,yCAAyC;AAEzC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,SAAgB,WAAW,CAAC,IAAsB,EAAE,IAA2B;IAC3E,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IAClB,IAAI,CAAC,IAAI,EAAE;QACP,IAAI,GAAG,EAAE,CAAA;KACZ;IAED,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,CAAC,CAAC;IACnE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,sCAAsC,EAAE;QACjE,UAAU,EAAE,IAAI,CAAC,QAAQ;QACzB,SAAS,EAAE,IAAI,CAAC,OAAO;QACvB,kBAAkB,EAAE,IAAI,CAAC,gBAAgB;QACzC,mBAAmB,EAAE,IAAI,CAAC,iBAAiB;QAC3C,YAAY,EAAE,IAAI,CAAC,UAAU;QAC7B,gBAAgB,EAAE,IAAI,CAAC,cAAc;QACrC,SAAS,EAAE,IAAI,CAAC,OAAO;QACvB,OAAO,EAAE,IAAI,CAAC,KAAK;QACnB,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,SAAS,EAAE,IAAI,CAAC,OAAO;QACvB,QAAQ,EAAE,IAAI,CAAC,MAAM;QACrB,QAAQ,EAAE,IAAI,CAAC,MAAM;QACrB,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,SAAS,EAAE,IAAI,CAAC,OAAO;QACvB,YAAY,EAAE,IAAI,CAAC,UAAU;QAC7B,YAAY,EAAE,IAAI,CAAC,UAAU;QAC7B,sBAAsB,EAAE,IAAI,CAAC,oBAAoB;QACjD,mBAAmB,EAAE,IAAI,CAAC,iBAAiB;QAC3C,0BAA0B,EAAE,IAAI,CAAC,wBAAwB;QACzD,yBAAyB,EAAE,IAAI,CAAC,uBAAuB;QACvD,YAAY,EAAE,IAAI,CAAC,UAAU;KAChC,EAAE,IAAI,CAAC,CAAC;AACb,CAAC;AA9BD,kCA8BC;AA6DD,SAAgB,iBAAiB,CAAC,IAA4B,EAAE,IAA2B;IACvF,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;AAC/D,CAAC;AAFD,8CAEC"}

package/getRepositoryFile.d.ts

@@ -0,0 +1,57 @@
+import * as pulumi from "@pulumi/pulumi";
+/**
+ * The `gitlab.RepositoryFile` data source allows details of a file in a repository to be retrieved.
+ *
+ * **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/repository_files.html)
+ *
+ * ## Example Usage
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as gitlab from "@pulumi/gitlab";
+ *
+ * const example = pulumi.output(gitlab.getRepositoryFile({
+ *     filePath: "README.md",
+ *     project: "example",
+ *     ref: "main",
+ * }));
+ * ```
+ */
+export declare function getRepositoryFile(args: GetRepositoryFileArgs, opts?: pulumi.InvokeOptions): Promise<GetRepositoryFileResult>;
+/**
+ * A collection of arguments for invoking getRepositoryFile.
+ */
+export interface GetRepositoryFileArgs {
+    filePath: string;
+    project: string;
+    ref: string;
+}
+/**
+ * A collection of values returned by getRepositoryFile.
+ */
+export interface GetRepositoryFileResult {
+    readonly blobId: string;
+    readonly commitId: string;
+    readonly content: string;
+    readonly contentSha256: string;
+    readonly encoding: string;
+    readonly fileName: string;
+    readonly filePath: string;
+    /**
+     * The provider-assigned unique ID for this managed resource.
+     */
+    readonly id: string;
+    readonly lastCommitId: string;
+    readonly project: string;
+    readonly ref: string;
+    readonly size: number;
+}
+export declare function getRepositoryFileOutput(args: GetRepositoryFileOutputArgs, opts?: pulumi.InvokeOptions): pulumi.Output<GetRepositoryFileResult>;
+/**
+ * A collection of arguments for invoking getRepositoryFile.
+ */
+export interface GetRepositoryFileOutputArgs {
+    filePath: pulumi.Input<string>;
+    project: pulumi.Input<string>;
+    ref: pulumi.Input<string>;
+}

package/getRepositoryFile.js

@@ -0,0 +1,42 @@
+"use strict";
+// *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
+// *** Do not edit by hand unless you're certain you know what you are doing! ***
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRepositoryFileOutput = exports.getRepositoryFile = void 0;
+const pulumi = require("@pulumi/pulumi");
+const utilities = require("./utilities");
+/**
+ * The `gitlab.RepositoryFile` data source allows details of a file in a repository to be retrieved.
+ *
+ * **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/repository_files.html)
+ *
+ * ## Example Usage
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as gitlab from "@pulumi/gitlab";
+ *
+ * const example = pulumi.output(gitlab.getRepositoryFile({
+ *     filePath: "README.md",
+ *     project: "example",
+ *     ref: "main",
+ * }));
+ * ```
+ */
+function getRepositoryFile(args, opts) {
+    if (!opts) {
+        opts = {};
+    }
+    opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts);
+    return pulumi.runtime.invoke("gitlab:index/getRepositoryFile:getRepositoryFile", {
+        "filePath": args.filePath,
+        "project": args.project,
+        "ref": args.ref,
+    }, opts);
+}
+exports.getRepositoryFile = getRepositoryFile;
+function getRepositoryFileOutput(args, opts) {
+    return pulumi.output(args).apply(a => getRepositoryFile(a, opts));
+}
+exports.getRepositoryFileOutput = getRepositoryFileOutput;
+//# sourceMappingURL=getRepositoryFile.js.map

package/getRepositoryFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRepositoryFile.js","sourceRoot":"","sources":["../getRepositoryFile.ts"],"names":[],"mappings":";AAAA,wFAAwF;AACxF,iFAAiF;;;AAEjF,yCAAyC;AACzC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,iBAAiB,CAAC,IAA2B,EAAE,IAA2B;IACtF,IAAI,CAAC,IAAI,EAAE;QACP,IAAI,GAAG,EAAE,CAAA;KACZ;IAED,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,CAAC,CAAC;IACnE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,kDAAkD,EAAE;QAC7E,UAAU,EAAE,IAAI,CAAC,QAAQ;QACzB,SAAS,EAAE,IAAI,CAAC,OAAO;QACvB,KAAK,EAAE,IAAI,CAAC,GAAG;KAClB,EAAE,IAAI,CAAC,CAAC;AACb,CAAC;AAXD,8CAWC;AAgCD,SAAgB,uBAAuB,CAAC,IAAiC,EAAE,IAA2B;IAClG,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;AACrE,CAAC;AAFD,0DAEC"}

package/getUser.d.ts

@@ -1,142 +1,54 @@
 import * as pulumi from "@pulumi/pulumi";
 /**
- * Provide details about a specific user in the gitlab provider. Especially the ability to lookup the id for linking to other resources.
+ * The `gitlab.User` data source allows details of a user to be retrieved by either the user ID, username or email address.
  *
- * > Some attributes might not be returned depending on if you're an admin or not. Please refer to [Gitlab documentation](https://docs.gitlab.com/ce/api/users.html#single-user) for more details.
+ * > Some attributes might not be returned depending on if you're an admin or not.
+ *
+ * **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/users.html#single-user)
  */
 export declare function getUser(args?: GetUserArgs, opts?: pulumi.InvokeOptions): Promise<GetUserResult>;
 /**
  * A collection of arguments for invoking getUser.
  */
 export interface GetUserArgs {
-    /**
-     * The public email address of the user. **Note**: before GitLab 14.8 the lookup was based on the users primary email address.
-     */
     email?: string;
-    /**
-     * The ID of the user.
-     */
     userId?: number;
-    /**
-     * The username of the user.
-     */
     username?: string;
 }
 /**
  * A collection of values returned by getUser.
  */
 export interface GetUserResult {
-    /**
-     * The avatar URL of the user.
-     */
     readonly avatarUrl: string;
-    /**
-     * The bio of the user.
-     */
     readonly bio: string;
-    /**
-     * Whether the user can create groups.
-     */
     readonly canCreateGroup: boolean;
-    /**
-     * Whether the user can create projects.
-     */
     readonly canCreateProject: boolean;
-    /**
-     * User's color scheme ID.
-     */
     readonly colorSchemeId: number;
-    /**
-     * Date the user was created at.
-     */
     readonly createdAt: string;
-    /**
-     * Current user's sign-in date.
-     */
     readonly currentSignInAt: string;
-    /**
-     * The public email address of the user. **Note**: before GitLab 14.8 the lookup was based on the users primary email address.
-     */
     readonly email: string;
-    /**
-     * The external UID of the user.
-     */
     readonly externUid: string;
-    /**
-     * Whether the user is external.
-     */
     readonly external: boolean;
     /**
      * The provider-assigned unique ID for this managed resource.
      */
     readonly id: string;
-    /**
-     * Whether the user is an admin.
-     */
     readonly isAdmin: boolean;
-    /**
-     * Last user's sign-in date.
-     */
     readonly lastSignInAt: string;
-    /**
-     * LinkedIn profile of the user.
-     */
     readonly linkedin: string;
-    /**
-     * The location of the user.
-     */
     readonly location: string;
-    /**
-     * The name of the user.
-     */
     readonly name: string;
-    /**
-     * Admin notes for this user.
-     */
     readonly note: string;
-    /**
-     * The organization of the user.
-     */
     readonly organization: string;
-    /**
-     * Number of projects the user can create.
-     */
     readonly projectsLimit: number;
-    /**
-     * Skype username of the user.
-     */
     readonly skype: string;
-    /**
-     * Whether the user is active or blocked.
-     */
     readonly state: string;
-    /**
-     * User's theme ID.
-     */
     readonly themeId: number;
-    /**
-     * Twitter username of the user.
-     */
     readonly twitter: string;
-    /**
-     * Whether user's two-factor auth is enabled.
-     */
     readonly twoFactorEnabled: boolean;
-    /**
-     * The ID of the user.
-     */
     readonly userId: number;
-    /**
-     * The UID provider of the user.
-     */
     readonly userProvider: string;
-    /**
-     * The username of the user.
-     */
     readonly username: string;
-    /**
-     * User's website URL.
-     */
     readonly websiteUrl: string;
 }
 export declare function getUserOutput(args?: GetUserOutputArgs, opts?: pulumi.InvokeOptions): pulumi.Output<GetUserResult>;
@@ -144,16 +56,7 @@ export declare function getUserOutput(args?: GetUserOutputArgs, opts?: pulumi.In
  * A collection of arguments for invoking getUser.
  */
 export interface GetUserOutputArgs {
-    /**
-     * The public email address of the user. **Note**: before GitLab 14.8 the lookup was based on the users primary email address.
-     */
     email?: pulumi.Input<string>;
-    /**
-     * The ID of the user.
-     */
     userId?: pulumi.Input<number>;
-    /**
-     * The username of the user.
-     */
     username?: pulumi.Input<string>;
 }

package/getUser.js

@@ -6,9 +6,11 @@ exports.getUserOutput = exports.getUser = void 0;
 const pulumi = require("@pulumi/pulumi");
 const utilities = require("./utilities");
 /**
- * Provide details about a specific user in the gitlab provider. Especially the ability to lookup the id for linking to other resources.
+ * The `gitlab.User` data source allows details of a user to be retrieved by either the user ID, username or email address.
  *
- * > Some attributes might not be returned depending on if you're an admin or not. Please refer to [Gitlab documentation](https://docs.gitlab.com/ce/api/users.html#single-user) for more details.
+ * > Some attributes might not be returned depending on if you're an admin or not.
+ *
+ * **Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/users.html#single-user)
  */
 function getUser(args, opts) {
     args = args || {};

package/getUser.js.map

@@ -1 +1 @@
-{"version":3,"file":"getUser.js","sourceRoot":"","sources":["../getUser.ts"],"names":[],"mappings":";AAAA,wFAAwF;AACxF,iFAAiF;;;AAEjF,yCAAyC;AACzC,yCAAyC;AAEzC;;;;GAIG;AACH,SAAgB,OAAO,CAAC,IAAkB,EAAE,IAA2B;IACnE,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IAClB,IAAI,CAAC,IAAI,EAAE;QACP,IAAI,GAAG,EAAE,CAAA;KACZ;IAED,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,CAAC,CAAC;IACnE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,8BAA8B,EAAE;QACzD,OAAO,EAAE,IAAI,CAAC,KAAK;QACnB,QAAQ,EAAE,IAAI,CAAC,MAAM;QACrB,UAAU,EAAE,IAAI,CAAC,QAAQ;KAC5B,EAAE,IAAI,CAAC,CAAC;AACb,CAAC;AAZD,0BAYC;AA0ID,SAAgB,aAAa,CAAC,IAAwB,EAAE,IAA2B;IAC/E,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;AAC3D,CAAC;AAFD,sCAEC"}
+{"version":3,"file":"getUser.js","sourceRoot":"","sources":["../getUser.ts"],"names":[],"mappings":";AAAA,wFAAwF;AACxF,iFAAiF;;;AAEjF,yCAAyC;AACzC,yCAAyC;AAEzC;;;;;;GAMG;AACH,SAAgB,OAAO,CAAC,IAAkB,EAAE,IAA2B;IACnE,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IAClB,IAAI,CAAC,IAAI,EAAE;QACP,IAAI,GAAG,EAAE,CAAA;KACZ;IAED,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,CAAC,CAAC;IACnE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,8BAA8B,EAAE;QACzD,OAAO,EAAE,IAAI,CAAC,KAAK;QACnB,QAAQ,EAAE,IAAI,CAAC,MAAM;QACrB,UAAU,EAAE,IAAI,CAAC,QAAQ;KAC5B,EAAE,IAAI,CAAC,CAAC;AACb,CAAC;AAZD,0BAYC;AAgDD,SAAgB,aAAa,CAAC,IAAwB,EAAE,IAA2B;IAC/E,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;AAC3D,CAAC;AAFD,sCAEC"}