@pulumiverse/grafana 0.5.0 → 0.5.1

package/getDashboard.d.ts

@@ -1,42 +1,156 @@
 import * as pulumi from "@pulumi/pulumi";
+/**
+ * * [Official documentation](https://grafana.com/docs/grafana/latest/dashboards/)
+ * * [Folder/Dashboard Search HTTP API](https://grafana.com/docs/grafana/latest/developers/http_api/folder_dashboard_search/)
+ * * [Dashboard HTTP API](https://grafana.com/docs/grafana/latest/developers/http_api/dashboard/)
+ *
+ * ## Example Usage
+ *
+ * <!--Start PulumiCodeChooser -->
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as grafana from "@pulumi/grafana";
+ * import * as grafana from "@pulumiverse/grafana";
+ *
+ * const test = new grafana.Dashboard("test", {configJson: JSON.stringify({
+ *     id: 12345,
+ *     uid: "test-ds-dashboard-uid",
+ *     title: "Production Overview",
+ *     tags: ["templated"],
+ *     timezone: "browser",
+ *     schemaVersion: 16,
+ *     version: 0,
+ *     refresh: "25s",
+ * })});
+ * const fromId = grafana.getDashboardOutput({
+ *     dashboardId: test.dashboardId,
+ * });
+ * const fromUid = grafana.getDashboard({
+ *     uid: "test-ds-dashboard-uid",
+ * });
+ * ```
+ * <!--End PulumiCodeChooser -->
+ */
 export declare function getDashboard(args?: GetDashboardArgs, opts?: pulumi.InvokeOptions): Promise<GetDashboardResult>;
 /**
  * A collection of arguments for invoking getDashboard.
  */
 export interface GetDashboardArgs {
+    /**
+     * The numerical ID of the Grafana dashboard. Specify either this or `uid`. Defaults to `-1`.
+     */
     dashboardId?: number;
+    /**
+     * The Organization ID. If not set, the Org ID defined in the provider block will be used.
+     */
     orgId?: string;
+    /**
+     * The uid of the Grafana dashboard. Specify either this or `dashboardId`. Defaults to ``.
+     */
     uid?: string;
 }
 /**
  * A collection of values returned by getDashboard.
  */
 export interface GetDashboardResult {
+    /**
+     * The complete dashboard model JSON.
+     */
     readonly configJson: string;
+    /**
+     * The numerical ID of the Grafana dashboard. Specify either this or `uid`. Defaults to `-1`.
+     */
     readonly dashboardId?: number;
     /**
+     * Deprecated. Use `folderUid` instead
+     *
      * @deprecated Use `folderUid` instead
      */
     readonly folder: number;
+    /**
+     * The UID of the folder where the Grafana dashboard is found.
+     */
     readonly folderUid: string;
     /**
      * The provider-assigned unique ID for this managed resource.
      */
     readonly id: string;
+    /**
+     * Whether or not the Grafana dashboard is starred. Starred Dashboards will show up on your own Home Dashboard by default, and are a convenient way to mark Dashboards that you’re interested in.
+     */
     readonly isStarred: boolean;
+    /**
+     * The Organization ID. If not set, the Org ID defined in the provider block will be used.
+     */
     readonly orgId?: string;
+    /**
+     * URL slug of the dashboard (deprecated).
+     */
     readonly slug: string;
+    /**
+     * The title of the Grafana dashboard.
+     */
     readonly title: string;
+    /**
+     * The uid of the Grafana dashboard. Specify either this or `dashboardId`. Defaults to ``.
+     */
     readonly uid?: string;
+    /**
+     * The full URL of the dashboard.
+     */
     readonly url: string;
+    /**
+     * The numerical version of the Grafana dashboard.
+     */
     readonly version: number;
 }
+/**
+ * * [Official documentation](https://grafana.com/docs/grafana/latest/dashboards/)
+ * * [Folder/Dashboard Search HTTP API](https://grafana.com/docs/grafana/latest/developers/http_api/folder_dashboard_search/)
+ * * [Dashboard HTTP API](https://grafana.com/docs/grafana/latest/developers/http_api/dashboard/)
+ *
+ * ## Example Usage
+ *
+ * <!--Start PulumiCodeChooser -->
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as grafana from "@pulumi/grafana";
+ * import * as grafana from "@pulumiverse/grafana";
+ *
+ * const test = new grafana.Dashboard("test", {configJson: JSON.stringify({
+ *     id: 12345,
+ *     uid: "test-ds-dashboard-uid",
+ *     title: "Production Overview",
+ *     tags: ["templated"],
+ *     timezone: "browser",
+ *     schemaVersion: 16,
+ *     version: 0,
+ *     refresh: "25s",
+ * })});
+ * const fromId = grafana.getDashboardOutput({
+ *     dashboardId: test.dashboardId,
+ * });
+ * const fromUid = grafana.getDashboard({
+ *     uid: "test-ds-dashboard-uid",
+ * });
+ * ```
+ * <!--End PulumiCodeChooser -->
+ */
 export declare function getDashboardOutput(args?: GetDashboardOutputArgs, opts?: pulumi.InvokeOptions): pulumi.Output<GetDashboardResult>;
 /**
  * A collection of arguments for invoking getDashboard.
  */
 export interface GetDashboardOutputArgs {
+    /**
+     * The numerical ID of the Grafana dashboard. Specify either this or `uid`. Defaults to `-1`.
+     */
     dashboardId?: pulumi.Input<number>;
+    /**
+     * The Organization ID. If not set, the Org ID defined in the provider block will be used.
+     */
     orgId?: pulumi.Input<string>;
+    /**
+     * The uid of the Grafana dashboard. Specify either this or `dashboardId`. Defaults to ``.
+     */
     uid?: pulumi.Input<string>;
 }

package/getDashboard.js

@@ -5,6 +5,38 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getDashboardOutput = exports.getDashboard = void 0;
 const pulumi = require("@pulumi/pulumi");
 const utilities = require("./utilities");
+/**
+ * * [Official documentation](https://grafana.com/docs/grafana/latest/dashboards/)
+ * * [Folder/Dashboard Search HTTP API](https://grafana.com/docs/grafana/latest/developers/http_api/folder_dashboard_search/)
+ * * [Dashboard HTTP API](https://grafana.com/docs/grafana/latest/developers/http_api/dashboard/)
+ *
+ * ## Example Usage
+ *
+ * <!--Start PulumiCodeChooser -->
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as grafana from "@pulumi/grafana";
+ * import * as grafana from "@pulumiverse/grafana";
+ *
+ * const test = new grafana.Dashboard("test", {configJson: JSON.stringify({
+ *     id: 12345,
+ *     uid: "test-ds-dashboard-uid",
+ *     title: "Production Overview",
+ *     tags: ["templated"],
+ *     timezone: "browser",
+ *     schemaVersion: 16,
+ *     version: 0,
+ *     refresh: "25s",
+ * })});
+ * const fromId = grafana.getDashboardOutput({
+ *     dashboardId: test.dashboardId,
+ * });
+ * const fromUid = grafana.getDashboard({
+ *     uid: "test-ds-dashboard-uid",
+ * });
+ * ```
+ * <!--End PulumiCodeChooser -->
+ */
 function getDashboard(args, opts) {
     args = args || {};
     opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts || {});
@@ -15,6 +47,38 @@ function getDashboard(args, opts) {
     }, opts);
 }
 exports.getDashboard = getDashboard;
+/**
+ * * [Official documentation](https://grafana.com/docs/grafana/latest/dashboards/)
+ * * [Folder/Dashboard Search HTTP API](https://grafana.com/docs/grafana/latest/developers/http_api/folder_dashboard_search/)
+ * * [Dashboard HTTP API](https://grafana.com/docs/grafana/latest/developers/http_api/dashboard/)
+ *
+ * ## Example Usage
+ *
+ * <!--Start PulumiCodeChooser -->
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as grafana from "@pulumi/grafana";
+ * import * as grafana from "@pulumiverse/grafana";
+ *
+ * const test = new grafana.Dashboard("test", {configJson: JSON.stringify({
+ *     id: 12345,
+ *     uid: "test-ds-dashboard-uid",
+ *     title: "Production Overview",
+ *     tags: ["templated"],
+ *     timezone: "browser",
+ *     schemaVersion: 16,
+ *     version: 0,
+ *     refresh: "25s",
+ * })});
+ * const fromId = grafana.getDashboardOutput({
+ *     dashboardId: test.dashboardId,
+ * });
+ * const fromUid = grafana.getDashboard({
+ *     uid: "test-ds-dashboard-uid",
+ * });
+ * ```
+ * <!--End PulumiCodeChooser -->
+ */
 function getDashboardOutput(args, opts) {
     return pulumi.output(args).apply((a) => getDashboard(a, opts));
 }

package/getDashboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"getDashboard.js","sourceRoot":"","sources":["../getDashboard.ts"],"names":[],"mappings":";AAAA,wFAAwF;AACxF,iFAAiF;;;AAEjF,yCAAyC;AACzC,yCAAyC;AAEzC,SAAgB,YAAY,CAAC,IAAuB,EAAE,IAA2B;IAC7E,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IAElB,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,yCAAyC,EAAE;QACpE,aAAa,EAAE,IAAI,CAAC,WAAW;QAC/B,OAAO,EAAE,IAAI,CAAC,KAAK;QACnB,KAAK,EAAE,IAAI,CAAC,GAAG;KAClB,EAAE,IAAI,CAAC,CAAC;AACb,CAAC;AATD,oCASC;AAkCD,SAAgB,kBAAkB,CAAC,IAA6B,EAAE,IAA2B;IACzF,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;AACvE,CAAC;AAFD,gDAEC"}
+{"version":3,"file":"getDashboard.js","sourceRoot":"","sources":["../getDashboard.ts"],"names":[],"mappings":";AAAA,wFAAwF;AACxF,iFAAiF;;;AAEjF,yCAAyC;AACzC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,SAAgB,YAAY,CAAC,IAAuB,EAAE,IAA2B;IAC7E,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IAElB,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,yCAAyC,EAAE;QACpE,aAAa,EAAE,IAAI,CAAC,WAAW;QAC/B,OAAO,EAAE,IAAI,CAAC,KAAK;QACnB,KAAK,EAAE,IAAI,CAAC,GAAG;KAClB,EAAE,IAAI,CAAC,CAAC;AACb,CAAC;AATD,oCASC;AA2ED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,SAAgB,kBAAkB,CAAC,IAA6B,EAAE,IAA2B;IACzF,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;AACvE,CAAC;AAFD,gDAEC"}

package/getDashboards.d.ts

@@ -1,17 +1,38 @@
 import * as pulumi from "@pulumi/pulumi";
 import * as outputs from "./types/output";
+/**
+ * Datasource for retrieving all dashboards. Specify list of folder IDs to search in for dashboards.
+ *
+ * * [Official documentation](https://grafana.com/docs/grafana/latest/dashboards/)
+ * * [Folder/Dashboard Search HTTP API](https://grafana.com/docs/grafana/latest/developers/http_api/folder_dashboard_search/)
+ * * [Dashboard HTTP API](https://grafana.com/docs/grafana/latest/developers/http_api/dashboard/)
+ */
 export declare function getDashboards(args?: GetDashboardsArgs, opts?: pulumi.InvokeOptions): Promise<GetDashboardsResult>;
 /**
  * A collection of arguments for invoking getDashboards.
  */
 export interface GetDashboardsArgs {
     /**
+     * Deprecated, use `folderUids` instead.
+     *
      * @deprecated Use `folderUids` instead.
      */
     folderIds?: number[];
+    /**
+     * UIDs of Grafana folders containing dashboards. Specify to filter for dashboards by folder (eg. `["General"]` for General folder), or leave blank to get all dashboards in all folders.
+     */
     folderUids?: string[];
+    /**
+     * Maximum number of dashboard search results to return. Defaults to `5000`.
+     */
     limit?: number;
+    /**
+     * The Organization ID. If not set, the Org ID defined in the provider block will be used.
+     */
     orgId?: string;
+    /**
+     * List of string Grafana dashboard tags to search for, eg. `["prod"]`. Used only as search input, i.e., attribute value will remain unchanged.
+     */
     tags?: string[];
 }
 /**
@@ -20,29 +41,64 @@ export interface GetDashboardsArgs {
 export interface GetDashboardsResult {
     readonly dashboards: outputs.GetDashboardsDashboard[];
     /**
+     * Deprecated, use `folderUids` instead.
+     *
      * @deprecated Use `folderUids` instead.
      */
     readonly folderIds?: number[];
+    /**
+     * UIDs of Grafana folders containing dashboards. Specify to filter for dashboards by folder (eg. `["General"]` for General folder), or leave blank to get all dashboards in all folders.
+     */
     readonly folderUids?: string[];
     /**
      * The provider-assigned unique ID for this managed resource.
      */
     readonly id: string;
+    /**
+     * Maximum number of dashboard search results to return. Defaults to `5000`.
+     */
     readonly limit?: number;
+    /**
+     * The Organization ID. If not set, the Org ID defined in the provider block will be used.
+     */
     readonly orgId?: string;
+    /**
+     * List of string Grafana dashboard tags to search for, eg. `["prod"]`. Used only as search input, i.e., attribute value will remain unchanged.
+     */
     readonly tags?: string[];
 }
+/**
+ * Datasource for retrieving all dashboards. Specify list of folder IDs to search in for dashboards.
+ *
+ * * [Official documentation](https://grafana.com/docs/grafana/latest/dashboards/)
+ * * [Folder/Dashboard Search HTTP API](https://grafana.com/docs/grafana/latest/developers/http_api/folder_dashboard_search/)
+ * * [Dashboard HTTP API](https://grafana.com/docs/grafana/latest/developers/http_api/dashboard/)
+ */
 export declare function getDashboardsOutput(args?: GetDashboardsOutputArgs, opts?: pulumi.InvokeOptions): pulumi.Output<GetDashboardsResult>;
 /**
  * A collection of arguments for invoking getDashboards.
  */
 export interface GetDashboardsOutputArgs {
     /**
+     * Deprecated, use `folderUids` instead.
+     *
      * @deprecated Use `folderUids` instead.
      */
     folderIds?: pulumi.Input<pulumi.Input<number>[]>;
+    /**
+     * UIDs of Grafana folders containing dashboards. Specify to filter for dashboards by folder (eg. `["General"]` for General folder), or leave blank to get all dashboards in all folders.
+     */
     folderUids?: pulumi.Input<pulumi.Input<string>[]>;
+    /**
+     * Maximum number of dashboard search results to return. Defaults to `5000`.
+     */
     limit?: pulumi.Input<number>;
+    /**
+     * The Organization ID. If not set, the Org ID defined in the provider block will be used.
+     */
     orgId?: pulumi.Input<string>;
+    /**
+     * List of string Grafana dashboard tags to search for, eg. `["prod"]`. Used only as search input, i.e., attribute value will remain unchanged.
+     */
     tags?: pulumi.Input<pulumi.Input<string>[]>;
 }

package/getDashboards.js

@@ -5,6 +5,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getDashboardsOutput = exports.getDashboards = void 0;
 const pulumi = require("@pulumi/pulumi");
 const utilities = require("./utilities");
+/**
+ * Datasource for retrieving all dashboards. Specify list of folder IDs to search in for dashboards.
+ *
+ * * [Official documentation](https://grafana.com/docs/grafana/latest/dashboards/)
+ * * [Folder/Dashboard Search HTTP API](https://grafana.com/docs/grafana/latest/developers/http_api/folder_dashboard_search/)
+ * * [Dashboard HTTP API](https://grafana.com/docs/grafana/latest/developers/http_api/dashboard/)
+ */
 function getDashboards(args, opts) {
     args = args || {};
     opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts || {});
@@ -17,6 +24,13 @@ function getDashboards(args, opts) {
     }, opts);
 }
 exports.getDashboards = getDashboards;
+/**
+ * Datasource for retrieving all dashboards. Specify list of folder IDs to search in for dashboards.
+ *
+ * * [Official documentation](https://grafana.com/docs/grafana/latest/dashboards/)
+ * * [Folder/Dashboard Search HTTP API](https://grafana.com/docs/grafana/latest/developers/http_api/folder_dashboard_search/)
+ * * [Dashboard HTTP API](https://grafana.com/docs/grafana/latest/developers/http_api/dashboard/)
+ */
 function getDashboardsOutput(args, opts) {
     return pulumi.output(args).apply((a) => getDashboards(a, opts));
 }

package/getDashboards.js.map

@@ -1 +1 @@
-{"version":3,"file":"getDashboards.js","sourceRoot":"","sources":["../getDashboards.ts"],"names":[],"mappings":";AAAA,wFAAwF;AACxF,iFAAiF;;;AAEjF,yCAAyC;AAGzC,yCAAyC;AAEzC,SAAgB,aAAa,CAAC,IAAwB,EAAE,IAA2B;IAC/E,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IAElB,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,2CAA2C,EAAE;QACtE,WAAW,EAAE,IAAI,CAAC,SAAS;QAC3B,YAAY,EAAE,IAAI,CAAC,UAAU;QAC7B,OAAO,EAAE,IAAI,CAAC,KAAK;QACnB,OAAO,EAAE,IAAI,CAAC,KAAK;QACnB,MAAM,EAAE,IAAI,CAAC,IAAI;KACpB,EAAE,IAAI,CAAC,CAAC;AACb,CAAC;AAXD,sCAWC;AAkCD,SAAgB,mBAAmB,CAAC,IAA8B,EAAE,IAA2B;IAC3F,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;AACxE,CAAC;AAFD,kDAEC"}
+{"version":3,"file":"getDashboards.js","sourceRoot":"","sources":["../getDashboards.ts"],"names":[],"mappings":";AAAA,wFAAwF;AACxF,iFAAiF;;;AAEjF,yCAAyC;AAGzC,yCAAyC;AAEzC;;;;;;GAMG;AACH,SAAgB,aAAa,CAAC,IAAwB,EAAE,IAA2B;IAC/E,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IAElB,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,2CAA2C,EAAE;QACtE,WAAW,EAAE,IAAI,CAAC,SAAS;QAC3B,YAAY,EAAE,IAAI,CAAC,UAAU;QAC7B,OAAO,EAAE,IAAI,CAAC,KAAK;QACnB,OAAO,EAAE,IAAI,CAAC,KAAK;QACnB,MAAM,EAAE,IAAI,CAAC,IAAI;KACpB,EAAE,IAAI,CAAC,CAAC;AACb,CAAC;AAXD,sCAWC;AA8DD;;;;;;GAMG;AACH,SAAgB,mBAAmB,CAAC,IAA8B,EAAE,IAA2B;IAC3F,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;AACxE,CAAC;AAFD,kDAEC"}

package/getDataSource.d.ts

@@ -1,14 +1,57 @@
 import * as pulumi from "@pulumi/pulumi";
+/**
+ * Get details about a Grafana Datasource querying by either name, uid or ID
+ *
+ * ## Example Usage
+ *
+ * <!--Start PulumiCodeChooser -->
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as grafana from "@pulumi/grafana";
+ * import * as grafana from "@pulumiverse/grafana";
+ *
+ * const prometheus = new grafana.DataSource("prometheus", {
+ *     type: "prometheus",
+ *     uid: "prometheus-ds-test-uid",
+ *     url: "https://my-instance.com",
+ *     basicAuthEnabled: true,
+ *     basicAuthUsername: "username",
+ *     jsonDataEncoded: JSON.stringify({
+ *         httpMethod: "POST",
+ *         prometheusType: "Mimir",
+ *         prometheusVersion: "2.4.0",
+ *     }),
+ *     secureJsonDataEncoded: JSON.stringify({
+ *         basicAuthPassword: "password",
+ *     }),
+ * });
+ * const fromName = grafana.getDataSourceOutput({
+ *     name: prometheus.name,
+ * });
+ * const fromId = grafana.getDataSourceOutput({
+ *     id: prometheus.id,
+ * });
+ * const fromUid = grafana.getDataSourceOutput({
+ *     uid: prometheus.uid,
+ * });
+ * ```
+ * <!--End PulumiCodeChooser -->
+ */
 export declare function getDataSource(args?: GetDataSourceArgs, opts?: pulumi.InvokeOptions): Promise<GetDataSourceResult>;
 /**
  * A collection of arguments for invoking getDataSource.
  */
 export interface GetDataSourceArgs {
     /**
+     * Deprecated: Use `uid` instead of `id`
+     *
      * @deprecated Use `uid` instead of `id`
      */
     id?: string;
     name?: string;
+    /**
+     * The Organization ID. If not set, the Org ID defined in the provider block will be used.
+     */
     orgId?: string;
     uid?: string;
 }
@@ -16,33 +59,108 @@ export interface GetDataSourceArgs {
  * A collection of values returned by getDataSource.
  */
 export interface GetDataSourceResult {
+    /**
+     * The method by which Grafana will access the data source: `proxy` or `direct`.
+     */
     readonly accessMode: string;
+    /**
+     * Whether to enable basic auth for the data source.
+     */
     readonly basicAuthEnabled: boolean;
+    /**
+     * Basic auth username.
+     */
     readonly basicAuthUsername: string;
+    /**
+     * (Required by some data source types) The name of the database to use on the selected data source server.
+     */
     readonly databaseName: string;
     /**
+     * Deprecated: Use `uid` instead of `id`
+     *
      * @deprecated Use `uid` instead of `id`
      */
     readonly id: string;
+    /**
+     * Whether to set the data source as default. This should only be `true` to a single data source.
+     */
     readonly isDefault: boolean;
+    /**
+     * Serialized JSON string containing the json data. This attribute can be used to pass configuration options to the data source. To figure out what options a datasource has available, see its docs or inspect the network data when saving it from the Grafana UI. Note that keys in this map are usually camelCased.
+     */
     readonly jsonDataEncoded: string;
     readonly name: string;
+    /**
+     * The Organization ID. If not set, the Org ID defined in the provider block will be used.
+     */
     readonly orgId?: string;
+    /**
+     * The data source type. Must be one of the supported data source keywords.
+     */
     readonly type: string;
     readonly uid: string;
+    /**
+     * The URL for the data source. The type of URL required varies depending on the chosen data source type.
+     */
     readonly url: string;
+    /**
+     * (Required by some data source types) The username to use to authenticate to the data source.
+     */
     readonly username: string;
 }
+/**
+ * Get details about a Grafana Datasource querying by either name, uid or ID
+ *
+ * ## Example Usage
+ *
+ * <!--Start PulumiCodeChooser -->
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as grafana from "@pulumi/grafana";
+ * import * as grafana from "@pulumiverse/grafana";
+ *
+ * const prometheus = new grafana.DataSource("prometheus", {
+ *     type: "prometheus",
+ *     uid: "prometheus-ds-test-uid",
+ *     url: "https://my-instance.com",
+ *     basicAuthEnabled: true,
+ *     basicAuthUsername: "username",
+ *     jsonDataEncoded: JSON.stringify({
+ *         httpMethod: "POST",
+ *         prometheusType: "Mimir",
+ *         prometheusVersion: "2.4.0",
+ *     }),
+ *     secureJsonDataEncoded: JSON.stringify({
+ *         basicAuthPassword: "password",
+ *     }),
+ * });
+ * const fromName = grafana.getDataSourceOutput({
+ *     name: prometheus.name,
+ * });
+ * const fromId = grafana.getDataSourceOutput({
+ *     id: prometheus.id,
+ * });
+ * const fromUid = grafana.getDataSourceOutput({
+ *     uid: prometheus.uid,
+ * });
+ * ```
+ * <!--End PulumiCodeChooser -->
+ */
 export declare function getDataSourceOutput(args?: GetDataSourceOutputArgs, opts?: pulumi.InvokeOptions): pulumi.Output<GetDataSourceResult>;
 /**
  * A collection of arguments for invoking getDataSource.
  */
 export interface GetDataSourceOutputArgs {
     /**
+     * Deprecated: Use `uid` instead of `id`
+     *
      * @deprecated Use `uid` instead of `id`
      */
     id?: pulumi.Input<string>;
     name?: pulumi.Input<string>;
+    /**
+     * The Organization ID. If not set, the Org ID defined in the provider block will be used.
+     */
     orgId?: pulumi.Input<string>;
     uid?: pulumi.Input<string>;
 }

package/getDataSource.js

@@ -5,6 +5,44 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getDataSourceOutput = exports.getDataSource = void 0;
 const pulumi = require("@pulumi/pulumi");
 const utilities = require("./utilities");
+/**
+ * Get details about a Grafana Datasource querying by either name, uid or ID
+ *
+ * ## Example Usage
+ *
+ * <!--Start PulumiCodeChooser -->
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as grafana from "@pulumi/grafana";
+ * import * as grafana from "@pulumiverse/grafana";
+ *
+ * const prometheus = new grafana.DataSource("prometheus", {
+ *     type: "prometheus",
+ *     uid: "prometheus-ds-test-uid",
+ *     url: "https://my-instance.com",
+ *     basicAuthEnabled: true,
+ *     basicAuthUsername: "username",
+ *     jsonDataEncoded: JSON.stringify({
+ *         httpMethod: "POST",
+ *         prometheusType: "Mimir",
+ *         prometheusVersion: "2.4.0",
+ *     }),
+ *     secureJsonDataEncoded: JSON.stringify({
+ *         basicAuthPassword: "password",
+ *     }),
+ * });
+ * const fromName = grafana.getDataSourceOutput({
+ *     name: prometheus.name,
+ * });
+ * const fromId = grafana.getDataSourceOutput({
+ *     id: prometheus.id,
+ * });
+ * const fromUid = grafana.getDataSourceOutput({
+ *     uid: prometheus.uid,
+ * });
+ * ```
+ * <!--End PulumiCodeChooser -->
+ */
 function getDataSource(args, opts) {
     args = args || {};
     opts = pulumi.mergeOptions(utilities.resourceOptsDefaults(), opts || {});
@@ -16,6 +54,44 @@ function getDataSource(args, opts) {
     }, opts);
 }
 exports.getDataSource = getDataSource;
+/**
+ * Get details about a Grafana Datasource querying by either name, uid or ID
+ *
+ * ## Example Usage
+ *
+ * <!--Start PulumiCodeChooser -->
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as grafana from "@pulumi/grafana";
+ * import * as grafana from "@pulumiverse/grafana";
+ *
+ * const prometheus = new grafana.DataSource("prometheus", {
+ *     type: "prometheus",
+ *     uid: "prometheus-ds-test-uid",
+ *     url: "https://my-instance.com",
+ *     basicAuthEnabled: true,
+ *     basicAuthUsername: "username",
+ *     jsonDataEncoded: JSON.stringify({
+ *         httpMethod: "POST",
+ *         prometheusType: "Mimir",
+ *         prometheusVersion: "2.4.0",
+ *     }),
+ *     secureJsonDataEncoded: JSON.stringify({
+ *         basicAuthPassword: "password",
+ *     }),
+ * });
+ * const fromName = grafana.getDataSourceOutput({
+ *     name: prometheus.name,
+ * });
+ * const fromId = grafana.getDataSourceOutput({
+ *     id: prometheus.id,
+ * });
+ * const fromUid = grafana.getDataSourceOutput({
+ *     uid: prometheus.uid,
+ * });
+ * ```
+ * <!--End PulumiCodeChooser -->
+ */
 function getDataSourceOutput(args, opts) {
     return pulumi.output(args).apply((a) => getDataSource(a, opts));
 }

package/getDataSource.js.map

@@ -1 +1 @@
-{"version":3,"file":"getDataSource.js","sourceRoot":"","sources":["../getDataSource.ts"],"names":[],"mappings":";AAAA,wFAAwF;AACxF,iFAAiF;;;AAEjF,yCAAyC;AACzC,yCAAyC;AAEzC,SAAgB,aAAa,CAAC,IAAwB,EAAE,IAA2B;IAC/E,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IAElB,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,2CAA2C,EAAE;QACtE,IAAI,EAAE,IAAI,CAAC,EAAE;QACb,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,OAAO,EAAE,IAAI,CAAC,KAAK;QACnB,KAAK,EAAE,IAAI,CAAC,GAAG;KAClB,EAAE,IAAI,CAAC,CAAC;AACb,CAAC;AAVD,sCAUC;AAoCD,SAAgB,mBAAmB,CAAC,IAA8B,EAAE,IAA2B;IAC3F,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;AACxE,CAAC;AAFD,kDAEC"}
+{"version":3,"file":"getDataSource.js","sourceRoot":"","sources":["../getDataSource.ts"],"names":[],"mappings":";AAAA,wFAAwF;AACxF,iFAAiF;;;AAEjF,yCAAyC;AACzC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,SAAgB,aAAa,CAAC,IAAwB,EAAE,IAA2B;IAC/E,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IAElB,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,2CAA2C,EAAE;QACtE,IAAI,EAAE,IAAI,CAAC,EAAE;QACb,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,OAAO,EAAE,IAAI,CAAC,KAAK;QACnB,KAAK,EAAE,IAAI,CAAC,GAAG;KAClB,EAAE,IAAI,CAAC,CAAC;AACb,CAAC;AAVD,sCAUC;AAyED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,SAAgB,mBAAmB,CAAC,IAA8B,EAAE,IAA2B;IAC3F,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;AACxE,CAAC;AAFD,kDAEC"}