@pulumiverse/grafana 0.5.0 → 0.5.1

package/dataSourceConfig.d.ts

@@ -1,4 +1,67 @@
 import * as pulumi from "@pulumi/pulumi";
+/**
+ * * [Official documentation](https://grafana.com/docs/grafana/latest/datasources/)
+ * * [HTTP API](https://grafana.com/docs/grafana/latest/developers/http_api/data_source/)
+ *
+ * The required arguments for this resource vary depending on the type of data
+ * source selected (via the 'type' argument).
+ *
+ * Use this resource for configuring multiple datasources, when that configuration (`jsonDataEncoded` field) requires circular references like in the example below.
+ *
+ * > When using the `grafana.DataSourceConfig` resource, the corresponding `grafana.DataSource` resources must have the `jsonDataEncoded` and `httpHeaders` fields ignored. Otherwise, an infinite update loop will occur. See the example below.
+ *
+ * ## Example Usage
+ *
+ * <!--Start PulumiCodeChooser -->
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as grafana from "@pulumiverse/grafana";
+ *
+ * const lokiDataSource = new grafana.DataSource("lokiDataSource", {
+ *     type: "loki",
+ *     url: "http://localhost:3100",
+ * });
+ * const tempoDataSource = new grafana.DataSource("tempoDataSource", {
+ *     type: "tempo",
+ *     url: "http://localhost:3200",
+ * });
+ * const lokiDataSourceConfig = new grafana.DataSourceConfig("lokiDataSourceConfig", {
+ *     uid: lokiDataSource.uid,
+ *     jsonDataEncoded: pulumi.jsonStringify({
+ *         derivedFields: [{
+ *             datasourceUid: tempoDataSource.uid,
+ *             matcherRegex: "[tT]race_?[iI][dD]\"?[:=]\"?(\\w+)",
+ *             matcherType: "regex",
+ *             name: "traceID",
+ *             url: "${__value.raw}",
+ *         }],
+ *     }),
+ * });
+ * const tempoDataSourceConfig = new grafana.DataSourceConfig("tempoDataSourceConfig", {
+ *     uid: tempoDataSource.uid,
+ *     jsonDataEncoded: pulumi.jsonStringify({
+ *         tracesToLogsV2: {
+ *             customQuery: true,
+ *             datasourceUid: lokiDataSource.uid,
+ *             filterBySpanID: false,
+ *             filterByTraceID: false,
+ *             query: "|=\"${__trace.traceId}\" | json",
+ *         },
+ *     }),
+ * });
+ * ```
+ * <!--End PulumiCodeChooser -->
+ *
+ * ## Import
+ *
+ * ```sh
+ * $ pulumi import grafana:index/dataSourceConfig:DataSourceConfig name "{{ uid }}"
+ * ```
+ *
+ * ```sh
+ * $ pulumi import grafana:index/dataSourceConfig:DataSourceConfig name "{{ orgID }}:{{ uid }}"
+ * ```
+ */
 export declare class DataSourceConfig extends pulumi.CustomResource {
     /**
      * Get an existing DataSourceConfig resource's state with the given name, ID, and optional extra
@@ -22,9 +85,7 @@ export declare class DataSourceConfig extends pulumi.CustomResource {
         [key: string]: string;
     } | undefined>;
     /**
-     * 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.
+     * 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: pulumi.Output<string | undefined>;
     /**
@@ -32,9 +93,7 @@ export declare class DataSourceConfig extends pulumi.CustomResource {
      */
     readonly orgId: pulumi.Output<string | undefined>;
     /**
-     * Serialized JSON string containing the secure json data. This attribute can be used to pass secure 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.
+     * Serialized JSON string containing the secure json data. This attribute can be used to pass secure 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 secureJsonDataEncoded: pulumi.Output<string | undefined>;
     /**
@@ -61,9 +120,7 @@ export interface DataSourceConfigState {
         [key: string]: pulumi.Input<string>;
     }>;
     /**
-     * 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.
+     * 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.
      */
     jsonDataEncoded?: pulumi.Input<string>;
     /**
@@ -71,9 +128,7 @@ export interface DataSourceConfigState {
      */
     orgId?: pulumi.Input<string>;
     /**
-     * Serialized JSON string containing the secure json data. This attribute can be used to pass secure 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.
+     * Serialized JSON string containing the secure json data. This attribute can be used to pass secure 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.
      */
     secureJsonDataEncoded?: pulumi.Input<string>;
     /**
@@ -92,9 +147,7 @@ export interface DataSourceConfigArgs {
         [key: string]: pulumi.Input<string>;
     }>;
     /**
-     * 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.
+     * 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.
      */
     jsonDataEncoded?: pulumi.Input<string>;
     /**
@@ -102,9 +155,7 @@ export interface DataSourceConfigArgs {
      */
     orgId?: pulumi.Input<string>;
     /**
-     * Serialized JSON string containing the secure json data. This attribute can be used to pass secure 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.
+     * Serialized JSON string containing the secure json data. This attribute can be used to pass secure 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.
      */
     secureJsonDataEncoded?: pulumi.Input<string>;
     /**

package/dataSourceConfig.js

@@ -5,6 +5,69 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DataSourceConfig = void 0;
 const pulumi = require("@pulumi/pulumi");
 const utilities = require("./utilities");
+/**
+ * * [Official documentation](https://grafana.com/docs/grafana/latest/datasources/)
+ * * [HTTP API](https://grafana.com/docs/grafana/latest/developers/http_api/data_source/)
+ *
+ * The required arguments for this resource vary depending on the type of data
+ * source selected (via the 'type' argument).
+ *
+ * Use this resource for configuring multiple datasources, when that configuration (`jsonDataEncoded` field) requires circular references like in the example below.
+ *
+ * > When using the `grafana.DataSourceConfig` resource, the corresponding `grafana.DataSource` resources must have the `jsonDataEncoded` and `httpHeaders` fields ignored. Otherwise, an infinite update loop will occur. See the example below.
+ *
+ * ## Example Usage
+ *
+ * <!--Start PulumiCodeChooser -->
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as grafana from "@pulumiverse/grafana";
+ *
+ * const lokiDataSource = new grafana.DataSource("lokiDataSource", {
+ *     type: "loki",
+ *     url: "http://localhost:3100",
+ * });
+ * const tempoDataSource = new grafana.DataSource("tempoDataSource", {
+ *     type: "tempo",
+ *     url: "http://localhost:3200",
+ * });
+ * const lokiDataSourceConfig = new grafana.DataSourceConfig("lokiDataSourceConfig", {
+ *     uid: lokiDataSource.uid,
+ *     jsonDataEncoded: pulumi.jsonStringify({
+ *         derivedFields: [{
+ *             datasourceUid: tempoDataSource.uid,
+ *             matcherRegex: "[tT]race_?[iI][dD]\"?[:=]\"?(\\w+)",
+ *             matcherType: "regex",
+ *             name: "traceID",
+ *             url: "${__value.raw}",
+ *         }],
+ *     }),
+ * });
+ * const tempoDataSourceConfig = new grafana.DataSourceConfig("tempoDataSourceConfig", {
+ *     uid: tempoDataSource.uid,
+ *     jsonDataEncoded: pulumi.jsonStringify({
+ *         tracesToLogsV2: {
+ *             customQuery: true,
+ *             datasourceUid: lokiDataSource.uid,
+ *             filterBySpanID: false,
+ *             filterByTraceID: false,
+ *             query: "|=\"${__trace.traceId}\" | json",
+ *         },
+ *     }),
+ * });
+ * ```
+ * <!--End PulumiCodeChooser -->
+ *
+ * ## Import
+ *
+ * ```sh
+ * $ pulumi import grafana:index/dataSourceConfig:DataSourceConfig name "{{ uid }}"
+ * ```
+ *
+ * ```sh
+ * $ pulumi import grafana:index/dataSourceConfig:DataSourceConfig name "{{ orgID }}:{{ uid }}"
+ * ```
+ */
 class DataSourceConfig extends pulumi.CustomResource {
     /**
      * Get an existing DataSourceConfig resource's state with the given name, ID, and optional extra

package/dataSourceConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"dataSourceConfig.js","sourceRoot":"","sources":["../dataSourceConfig.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dataSourceConfig.js","sourceRoot":"","sources":["../dataSourceConfig.ts"],"names":[],"mappings":"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"}

package/dataSourcePermission.d.ts

@@ -1,6 +1,69 @@
 import * as pulumi from "@pulumi/pulumi";
 import * as inputs from "./types/input";
 import * as outputs from "./types/output";
+/**
+ * Manages the entire set of permissions for a datasource. Permissions that aren't specified when applying this resource will be removed.
+ * * [HTTP API](https://grafana.com/docs/grafana/latest/developers/http_api/datasource_permissions/)
+ *
+ * ## Example Usage
+ *
+ * <!--Start PulumiCodeChooser -->
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as grafana from "@pulumiverse/grafana";
+ *
+ * const team = new grafana.Team("team", {});
+ * const foo = new grafana.DataSource("foo", {
+ *     type: "cloudwatch",
+ *     jsonDataEncoded: JSON.stringify({
+ *         defaultRegion: "us-east-1",
+ *         authType: "keys",
+ *     }),
+ *     secureJsonDataEncoded: JSON.stringify({
+ *         accessKey: "123",
+ *         secretKey: "456",
+ *     }),
+ * });
+ * const user = new grafana.User("user", {
+ *     email: "test-ds-permissions@example.com",
+ *     login: "test-ds-permissions",
+ *     password: "hunter2",
+ * });
+ * const sa = new grafana.ServiceAccount("sa", {role: "Viewer"});
+ * const fooPermissions = new grafana.DataSourcePermission("fooPermissions", {
+ *     datasourceUid: foo.uid,
+ *     permissions: [
+ *         {
+ *             teamId: team.id,
+ *             permission: "Edit",
+ *         },
+ *         {
+ *             userId: user.id,
+ *             permission: "Edit",
+ *         },
+ *         {
+ *             builtInRole: "Viewer",
+ *             permission: "Query",
+ *         },
+ *         {
+ *             userId: sa.id,
+ *             permission: "Query",
+ *         },
+ *     ],
+ * });
+ * ```
+ * <!--End PulumiCodeChooser -->
+ *
+ * ## Import
+ *
+ * ```sh
+ * $ pulumi import grafana:index/dataSourcePermission:DataSourcePermission name "{{ datasourceID }}"
+ * ```
+ *
+ * ```sh
+ * $ pulumi import grafana:index/dataSourcePermission:DataSourcePermission name "{{ orgID }}:{{ datasourceID }}"
+ * ```
+ */
 export declare class DataSourcePermission extends pulumi.CustomResource {
     /**
      * Get an existing DataSourcePermission resource's state with the given name, ID, and optional extra
@@ -18,7 +81,7 @@ export declare class DataSourcePermission extends pulumi.CustomResource {
      */
     static isInstance(obj: any): obj is DataSourcePermission;
     /**
-     * Deprecated: Use `datasource_uid` instead.
+     * Deprecated: Use `datasourceUid` instead.
      *
      * @deprecated Use `datasourceUid` instead
      */
@@ -49,7 +112,7 @@ export declare class DataSourcePermission extends pulumi.CustomResource {
  */
 export interface DataSourcePermissionState {
     /**
-     * Deprecated: Use `datasource_uid` instead.
+     * Deprecated: Use `datasourceUid` instead.
      *
      * @deprecated Use `datasourceUid` instead
      */
@@ -72,7 +135,7 @@ export interface DataSourcePermissionState {
  */
 export interface DataSourcePermissionArgs {
     /**
-     * Deprecated: Use `datasource_uid` instead.
+     * Deprecated: Use `datasourceUid` instead.
      *
      * @deprecated Use `datasourceUid` instead
      */

package/dataSourcePermission.js

@@ -5,6 +5,69 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DataSourcePermission = void 0;
 const pulumi = require("@pulumi/pulumi");
 const utilities = require("./utilities");
+/**
+ * Manages the entire set of permissions for a datasource. Permissions that aren't specified when applying this resource will be removed.
+ * * [HTTP API](https://grafana.com/docs/grafana/latest/developers/http_api/datasource_permissions/)
+ *
+ * ## Example Usage
+ *
+ * <!--Start PulumiCodeChooser -->
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as grafana from "@pulumiverse/grafana";
+ *
+ * const team = new grafana.Team("team", {});
+ * const foo = new grafana.DataSource("foo", {
+ *     type: "cloudwatch",
+ *     jsonDataEncoded: JSON.stringify({
+ *         defaultRegion: "us-east-1",
+ *         authType: "keys",
+ *     }),
+ *     secureJsonDataEncoded: JSON.stringify({
+ *         accessKey: "123",
+ *         secretKey: "456",
+ *     }),
+ * });
+ * const user = new grafana.User("user", {
+ *     email: "test-ds-permissions@example.com",
+ *     login: "test-ds-permissions",
+ *     password: "hunter2",
+ * });
+ * const sa = new grafana.ServiceAccount("sa", {role: "Viewer"});
+ * const fooPermissions = new grafana.DataSourcePermission("fooPermissions", {
+ *     datasourceUid: foo.uid,
+ *     permissions: [
+ *         {
+ *             teamId: team.id,
+ *             permission: "Edit",
+ *         },
+ *         {
+ *             userId: user.id,
+ *             permission: "Edit",
+ *         },
+ *         {
+ *             builtInRole: "Viewer",
+ *             permission: "Query",
+ *         },
+ *         {
+ *             userId: sa.id,
+ *             permission: "Query",
+ *         },
+ *     ],
+ * });
+ * ```
+ * <!--End PulumiCodeChooser -->
+ *
+ * ## Import
+ *
+ * ```sh
+ * $ pulumi import grafana:index/dataSourcePermission:DataSourcePermission name "{{ datasourceID }}"
+ * ```
+ *
+ * ```sh
+ * $ pulumi import grafana:index/dataSourcePermission:DataSourcePermission name "{{ orgID }}:{{ datasourceID }}"
+ * ```
+ */
 class DataSourcePermission extends pulumi.CustomResource {
     /**
      * Get an existing DataSourcePermission resource's state with the given name, ID, and optional extra

package/dataSourcePermission.js.map

@@ -1 +1 @@
-{"version":3,"file":"dataSourcePermission.js","sourceRoot":"","sources":["../dataSourcePermission.ts"],"names":[],"mappings":";AAAA,wFAAwF;AACxF,iFAAiF;;;AAEjF,yCAAyC;AAGzC,yCAAyC;AAEzC,MAAa,oBAAqB,SAAQ,MAAM,CAAC,cAAc;IAC3D;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAA2B,EAAE,KAAiC,EAAE,IAAmC;QAC/H,OAAO,IAAI,oBAAoB,CAAC,IAAI,EAAO,KAAK,kCAAO,IAAI,KAAE,EAAE,EAAE,EAAE,IAAG,CAAC;IAC3E,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,oBAAoB,CAAC,YAAY,CAAC;IACrE,CAAC;IA6BD,YAAY,IAAY,EAAE,WAAkE,EAAE,IAAmC;QAC7H,IAAI,cAAc,GAAkB,EAAE,CAAC;QACvC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,EAAE,EAAE;YACT,MAAM,KAAK,GAAG,WAAoD,CAAC;YACnE,cAAc,CAAC,cAAc,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;YACxE,cAAc,CAAC,eAAe,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;YAC1E,cAAc,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;YAC1D,cAAc,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;SACzE;aAAM;YACH,MAAM,IAAI,GAAG,WAAmD,CAAC;YACjE,cAAc,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;YACtE,cAAc,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;YACxE,cAAc,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;YACxD,cAAc,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;SACvE;QACD,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,CAAC,CAAC;QACnE,KAAK,CAAC,oBAAoB,CAAC,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IACzE,CAAC;;AAzEL,oDA0EC;AA5DG,gBAAgB;AACO,iCAAY,GAAG,yDAAyD,CAAC"}
+{"version":3,"file":"dataSourcePermission.js","sourceRoot":"","sources":["../dataSourcePermission.ts"],"names":[],"mappings":";AAAA,wFAAwF;AACxF,iFAAiF;;;AAEjF,yCAAyC;AAGzC,yCAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AACH,MAAa,oBAAqB,SAAQ,MAAM,CAAC,cAAc;IAC3D;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAA2B,EAAE,KAAiC,EAAE,IAAmC;QAC/H,OAAO,IAAI,oBAAoB,CAAC,IAAI,EAAO,KAAK,kCAAO,IAAI,KAAE,EAAE,EAAE,EAAE,IAAG,CAAC;IAC3E,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,oBAAoB,CAAC,YAAY,CAAC;IACrE,CAAC;IA6BD,YAAY,IAAY,EAAE,WAAkE,EAAE,IAAmC;QAC7H,IAAI,cAAc,GAAkB,EAAE,CAAC;QACvC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,EAAE,EAAE;YACT,MAAM,KAAK,GAAG,WAAoD,CAAC;YACnE,cAAc,CAAC,cAAc,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;YACxE,cAAc,CAAC,eAAe,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;YAC1E,cAAc,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;YAC1D,cAAc,CAAC,aAAa,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;SACzE;aAAM;YACH,MAAM,IAAI,GAAG,WAAmD,CAAC;YACjE,cAAc,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;YACtE,cAAc,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;YACxE,cAAc,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;YACxD,cAAc,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;SACvE;QACD,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,CAAC,CAAC;QACnE,KAAK,CAAC,oBAAoB,CAAC,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IACzE,CAAC;;AAzEL,oDA0EC;AA5DG,gBAAgB;AACO,iCAAY,GAAG,yDAAyD,CAAC"}

package/dataSourcePermissionItem.d.ts

@@ -1,4 +1,65 @@
 import * as pulumi from "@pulumi/pulumi";
+/**
+ * Manages a single permission item for a datasource. Conflicts with the "grafana.DataSourcePermission" resource which manages the entire set of permissions for a datasource.
+ *
+ * ## Example Usage
+ *
+ * <!--Start PulumiCodeChooser -->
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as grafana from "@pulumiverse/grafana";
+ *
+ * const teamTeam = new grafana.Team("teamTeam", {});
+ * const foo = new grafana.DataSource("foo", {
+ *     type: "cloudwatch",
+ *     jsonDataEncoded: JSON.stringify({
+ *         defaultRegion: "us-east-1",
+ *         authType: "keys",
+ *     }),
+ *     secureJsonDataEncoded: JSON.stringify({
+ *         accessKey: "123",
+ *         secretKey: "456",
+ *     }),
+ * });
+ * const userUser = new grafana.User("userUser", {
+ *     email: "test-ds-permissions@example.com",
+ *     login: "test-ds-permissions",
+ *     password: "hunter2",
+ * });
+ * const sa = new grafana.ServiceAccount("sa", {role: "Viewer"});
+ * const teamDataSourcePermissionItem = new grafana.DataSourcePermissionItem("teamDataSourcePermissionItem", {
+ *     datasourceUid: foo.uid,
+ *     team: teamTeam.id,
+ *     permission: "Edit",
+ * });
+ * const userDataSourcePermissionItem = new grafana.DataSourcePermissionItem("userDataSourcePermissionItem", {
+ *     datasourceUid: foo.uid,
+ *     user: userUser.id,
+ *     permission: "Edit",
+ * });
+ * const role = new grafana.DataSourcePermissionItem("role", {
+ *     datasourceUid: foo.uid,
+ *     role: "Viewer",
+ *     permission: "Query",
+ * });
+ * const serviceAccount = new grafana.DataSourcePermissionItem("serviceAccount", {
+ *     datasourceUid: foo.uid,
+ *     user: sa.id,
+ *     permission: "Query",
+ * });
+ * ```
+ * <!--End PulumiCodeChooser -->
+ *
+ * ## Import
+ *
+ * ```sh
+ * $ pulumi import grafana:index/dataSourcePermissionItem:DataSourcePermissionItem name "{{ datasourceUID }}:{{ type (role, team, or user) }}:{{ identifier }}"
+ * ```
+ *
+ * ```sh
+ * $ pulumi import grafana:index/dataSourcePermissionItem:DataSourcePermissionItem name "{{ orgID }}:{{ datasourceUID }}:{{ type (role, team, or user) }}:{{ identifier }}"
+ * ```
+ */
 export declare class DataSourcePermissionItem extends pulumi.CustomResource {
     /**
      * Get an existing DataSourcePermissionItem resource's state with the given name, ID, and optional extra

package/dataSourcePermissionItem.js

@@ -5,6 +5,67 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DataSourcePermissionItem = void 0;
 const pulumi = require("@pulumi/pulumi");
 const utilities = require("./utilities");
+/**
+ * Manages a single permission item for a datasource. Conflicts with the "grafana.DataSourcePermission" resource which manages the entire set of permissions for a datasource.
+ *
+ * ## Example Usage
+ *
+ * <!--Start PulumiCodeChooser -->
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as grafana from "@pulumiverse/grafana";
+ *
+ * const teamTeam = new grafana.Team("teamTeam", {});
+ * const foo = new grafana.DataSource("foo", {
+ *     type: "cloudwatch",
+ *     jsonDataEncoded: JSON.stringify({
+ *         defaultRegion: "us-east-1",
+ *         authType: "keys",
+ *     }),
+ *     secureJsonDataEncoded: JSON.stringify({
+ *         accessKey: "123",
+ *         secretKey: "456",
+ *     }),
+ * });
+ * const userUser = new grafana.User("userUser", {
+ *     email: "test-ds-permissions@example.com",
+ *     login: "test-ds-permissions",
+ *     password: "hunter2",
+ * });
+ * const sa = new grafana.ServiceAccount("sa", {role: "Viewer"});
+ * const teamDataSourcePermissionItem = new grafana.DataSourcePermissionItem("teamDataSourcePermissionItem", {
+ *     datasourceUid: foo.uid,
+ *     team: teamTeam.id,
+ *     permission: "Edit",
+ * });
+ * const userDataSourcePermissionItem = new grafana.DataSourcePermissionItem("userDataSourcePermissionItem", {
+ *     datasourceUid: foo.uid,
+ *     user: userUser.id,
+ *     permission: "Edit",
+ * });
+ * const role = new grafana.DataSourcePermissionItem("role", {
+ *     datasourceUid: foo.uid,
+ *     role: "Viewer",
+ *     permission: "Query",
+ * });
+ * const serviceAccount = new grafana.DataSourcePermissionItem("serviceAccount", {
+ *     datasourceUid: foo.uid,
+ *     user: sa.id,
+ *     permission: "Query",
+ * });
+ * ```
+ * <!--End PulumiCodeChooser -->
+ *
+ * ## Import
+ *
+ * ```sh
+ * $ pulumi import grafana:index/dataSourcePermissionItem:DataSourcePermissionItem name "{{ datasourceUID }}:{{ type (role, team, or user) }}:{{ identifier }}"
+ * ```
+ *
+ * ```sh
+ * $ pulumi import grafana:index/dataSourcePermissionItem:DataSourcePermissionItem name "{{ orgID }}:{{ datasourceUID }}:{{ type (role, team, or user) }}:{{ identifier }}"
+ * ```
+ */
 class DataSourcePermissionItem extends pulumi.CustomResource {
     /**
      * Get an existing DataSourcePermissionItem resource's state with the given name, ID, and optional extra

package/dataSourcePermissionItem.js.map

@@ -1 +1 @@
-{"version":3,"file":"dataSourcePermissionItem.js","sourceRoot":"","sources":["../dataSourcePermissionItem.ts"],"names":[],"mappings":";AAAA,wFAAwF;AACxF,iFAAiF;;;AAEjF,yCAAyC;AACzC,yCAAyC;AAEzC,MAAa,wBAAyB,SAAQ,MAAM,CAAC,cAAc;IAC/D;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAA2B,EAAE,KAAqC,EAAE,IAAmC;QACnI,OAAO,IAAI,wBAAwB,CAAC,IAAI,EAAO,KAAK,kCAAO,IAAI,KAAE,EAAE,EAAE,EAAE,IAAG,CAAC;IAC/E,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,wBAAwB,CAAC,YAAY,CAAC;IACzE,CAAC;IAmCD,YAAY,IAAY,EAAE,WAA0E,EAAE,IAAmC;QACrI,IAAI,cAAc,GAAkB,EAAE,CAAC;QACvC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,EAAE,EAAE;YACT,MAAM,KAAK,GAAG,WAAwD,CAAC;YACvE,cAAc,CAAC,eAAe,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;YAC1E,cAAc,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;YAC1D,cAAc,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;YACpE,cAAc,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;YACxD,cAAc,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;YACxD,cAAc,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;SAC3D;aAAM;YACH,MAAM,IAAI,GAAG,WAAuD,CAAC;YACrE,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBAC1D,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;aAChE;YACD,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBACvD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;aAC7D;YACD,cAAc,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;YACxE,cAAc,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;YACxD,cAAc,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;YAClE,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;YACtD,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;YACtD,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;SACzD;QACD,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,CAAC,CAAC;QACnE,KAAK,CAAC,wBAAwB,CAAC,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IAC7E,CAAC;;AAzFL,4DA0FC;AA5EG,gBAAgB;AACO,qCAAY,GAAG,iEAAiE,CAAC"}
+{"version":3,"file":"dataSourcePermissionItem.js","sourceRoot":"","sources":["../dataSourcePermissionItem.ts"],"names":[],"mappings":"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"}

package/folder.d.ts

@@ -1,4 +1,41 @@
 import * as pulumi from "@pulumi/pulumi";
+/**
+ * * [Official documentation](https://grafana.com/docs/grafana/latest/dashboards/manage-dashboards/)
+ * * [HTTP API](https://grafana.com/docs/grafana/latest/developers/http_api/folder/)
+ *
+ * ## Example Usage
+ *
+ * <!--Start PulumiCodeChooser -->
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as grafana from "@pulumiverse/grafana";
+ *
+ * const testFolderFolder = new grafana.Folder("testFolderFolder", {title: "Terraform Test Folder"});
+ * const testFolderDashboard = new grafana.Dashboard("testFolderDashboard", {
+ *     folder: testFolderFolder.id,
+ *     configJson: `{
+ *   "title": "Dashboard in folder",
+ *   "uid": "dashboard-in-folder"
+ * }
+ * `,
+ * });
+ * const testFolderWithUid = new grafana.Folder("testFolderWithUid", {
+ *     uid: "test-folder-uid",
+ *     title: "Terraform Test Folder With UID",
+ * });
+ * ```
+ * <!--End PulumiCodeChooser -->
+ *
+ * ## Import
+ *
+ * ```sh
+ * $ pulumi import grafana:index/folder:Folder name "{{ uid }}"
+ * ```
+ *
+ * ```sh
+ * $ pulumi import grafana:index/folder:Folder name "{{ orgID }}:{{ uid }}"
+ * ```
+ */
 export declare class Folder extends pulumi.CustomResource {
     /**
      * Get an existing Folder resource's state with the given name, ID, and optional extra
@@ -20,12 +57,11 @@ export declare class Folder extends pulumi.CustomResource {
      */
     readonly orgId: pulumi.Output<string | undefined>;
     /**
-     * The uid of the parent folder. If set, the folder will be nested. If not set, the folder will be created in the root
-     * folder. Note: This requires the nestedFolders feature flag to be enabled on your Grafana instance.
+     * The uid of the parent folder. If set, the folder will be nested. If not set, the folder will be created in the root folder. Note: This requires the nestedFolders feature flag to be enabled on your Grafana instance.
      */
     readonly parentFolderUid: pulumi.Output<string | undefined>;
     /**
-     * Prevent deletion of the folder if it is not empty (contains dashboards or alert rules).
+     * Prevent deletion of the folder if it is not empty (contains dashboards or alert rules). Defaults to `false`.
      */
     readonly preventDestroyIfNotEmpty: pulumi.Output<boolean | undefined>;
     /**
@@ -58,12 +94,11 @@ export interface FolderState {
      */
     orgId?: pulumi.Input<string>;
     /**
-     * The uid of the parent folder. If set, the folder will be nested. If not set, the folder will be created in the root
-     * folder. Note: This requires the nestedFolders feature flag to be enabled on your Grafana instance.
+     * The uid of the parent folder. If set, the folder will be nested. If not set, the folder will be created in the root folder. Note: This requires the nestedFolders feature flag to be enabled on your Grafana instance.
      */
     parentFolderUid?: pulumi.Input<string>;
     /**
-     * Prevent deletion of the folder if it is not empty (contains dashboards or alert rules).
+     * Prevent deletion of the folder if it is not empty (contains dashboards or alert rules). Defaults to `false`.
      */
     preventDestroyIfNotEmpty?: pulumi.Input<boolean>;
     /**
@@ -88,12 +123,11 @@ export interface FolderArgs {
      */
     orgId?: pulumi.Input<string>;
     /**
-     * The uid of the parent folder. If set, the folder will be nested. If not set, the folder will be created in the root
-     * folder. Note: This requires the nestedFolders feature flag to be enabled on your Grafana instance.
+     * The uid of the parent folder. If set, the folder will be nested. If not set, the folder will be created in the root folder. Note: This requires the nestedFolders feature flag to be enabled on your Grafana instance.
      */
     parentFolderUid?: pulumi.Input<string>;
     /**
-     * Prevent deletion of the folder if it is not empty (contains dashboards or alert rules).
+     * Prevent deletion of the folder if it is not empty (contains dashboards or alert rules). Defaults to `false`.
      */
     preventDestroyIfNotEmpty?: pulumi.Input<boolean>;
     /**

package/folder.js

@@ -5,6 +5,43 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Folder = void 0;
 const pulumi = require("@pulumi/pulumi");
 const utilities = require("./utilities");
+/**
+ * * [Official documentation](https://grafana.com/docs/grafana/latest/dashboards/manage-dashboards/)
+ * * [HTTP API](https://grafana.com/docs/grafana/latest/developers/http_api/folder/)
+ *
+ * ## Example Usage
+ *
+ * <!--Start PulumiCodeChooser -->
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as grafana from "@pulumiverse/grafana";
+ *
+ * const testFolderFolder = new grafana.Folder("testFolderFolder", {title: "Terraform Test Folder"});
+ * const testFolderDashboard = new grafana.Dashboard("testFolderDashboard", {
+ *     folder: testFolderFolder.id,
+ *     configJson: `{
+ *   "title": "Dashboard in folder",
+ *   "uid": "dashboard-in-folder"
+ * }
+ * `,
+ * });
+ * const testFolderWithUid = new grafana.Folder("testFolderWithUid", {
+ *     uid: "test-folder-uid",
+ *     title: "Terraform Test Folder With UID",
+ * });
+ * ```
+ * <!--End PulumiCodeChooser -->
+ *
+ * ## Import
+ *
+ * ```sh
+ * $ pulumi import grafana:index/folder:Folder name "{{ uid }}"
+ * ```
+ *
+ * ```sh
+ * $ pulumi import grafana:index/folder:Folder name "{{ orgID }}:{{ uid }}"
+ * ```
+ */
 class Folder extends pulumi.CustomResource {
     /**
      * Get an existing Folder resource's state with the given name, ID, and optional extra