pulumi-newrelic 5.20.0a1709365820__py3-none-any.whl → 5.21.0a1710157101__py3-none-any.whl

pulumi_newrelic/notification_destination.py

@@ -301,7 +301,72 @@ class NotificationDestination(pulumi.CustomResource):
                  type: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        Create a NotificationDestination resource with the given unique name, props, and options.
+        ## Import
+
+        Destination id can be found in the Destinations page -> three dots at the right of the chosen destination -> copy destination id to clipboard.
+
+        This example is especially useful for slack destinations which *must* be imported.
+
+        1. Add an empty resource to your terraform file:
+
+        terraform
+
+        resource "newrelic_notification_destination" "foo" {
+
+        }
+
+        ```sh
+        $ pulumi import newrelic:index/notificationDestination:NotificationDestination  Run import command: `newrelic_notification_destination.foo <destination_id>`
+        ```
+
+        3. Run the following command after the import successfully done and copy the information to your resource:
+
+        `terraform state show newrelic_notification_destination.foo`
+
+        4. Add `ignore_changes` attribute on `auth_token` in your imported resource:
+
+        terraform
+
+        lifecycle {
+
+            ignore_changes = [auth_token]
+
+          }
+
+        Your imported destination should look like that:
+
+        terraform
+
+        resource "newrelic_notification_destination" "foo" {
+
+          lifecycle {
+
+            ignore_changes = [auth_token]
+
+          }
+
+          name = "*********"
+
+          type = "SLACK"
+
+          auth_token {
+
+            prefix = "Bearer"
+
+          }
+
+          property {
+
+              key   = "teamName"
+            
+              label = "Team Name"
+            
+              value = "******"
+
+          }
+
+        }
+
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[int] account_id: Determines the New Relic account where the notification destination will be created. Defaults to the account associated with the API key used.
@@ -320,7 +385,72 @@ class NotificationDestination(pulumi.CustomResource):
                  args: NotificationDestinationArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Create a NotificationDestination resource with the given unique name, props, and options.
+        ## Import
+
+        Destination id can be found in the Destinations page -> three dots at the right of the chosen destination -> copy destination id to clipboard.
+
+        This example is especially useful for slack destinations which *must* be imported.
+
+        1. Add an empty resource to your terraform file:
+
+        terraform
+
+        resource "newrelic_notification_destination" "foo" {
+
+        }
+
+        ```sh
+        $ pulumi import newrelic:index/notificationDestination:NotificationDestination  Run import command: `newrelic_notification_destination.foo <destination_id>`
+        ```
+
+        3. Run the following command after the import successfully done and copy the information to your resource:
+
+        `terraform state show newrelic_notification_destination.foo`
+
+        4. Add `ignore_changes` attribute on `auth_token` in your imported resource:
+
+        terraform
+
+        lifecycle {
+
+            ignore_changes = [auth_token]
+
+          }
+
+        Your imported destination should look like that:
+
+        terraform
+
+        resource "newrelic_notification_destination" "foo" {
+
+          lifecycle {
+
+            ignore_changes = [auth_token]
+
+          }
+
+          name = "*********"
+
+          type = "SLACK"
+
+          auth_token {
+
+            prefix = "Bearer"
+
+          }
+
+          property {
+
+              key   = "teamName"
+            
+              label = "Team Name"
+            
+              value = "******"
+
+          }
+
+        }
+
         :param str resource_name: The name of the resource.
         :param NotificationDestinationArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.

pulumi_newrelic/nrql_alert_condition.py

@@ -910,8 +910,10 @@ class NrqlAlertCondition(pulumi.CustomResource):
         Use this resource to create and manage NRQL alert conditions in New Relic.
 
         ## Example Usage
+
         ### Type: `static` (default)
 
+        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
@@ -950,6 +952,8 @@ class NrqlAlertCondition(pulumi.CustomResource):
                 threshold_occurrences="ALL",
             ))
         ```
+        <!--End PulumiCodeChooser -->
+
         ## NRQL
 
         The `nrql` block supports the following arguments:
@@ -988,6 +992,7 @@ class NrqlAlertCondition(pulumi.CustomResource):
 
         [Baseline NRQL alert conditions](https://docs.newrelic.com/docs/alerts/new-relic-alerts/defining-conditions/create-baseline-alert-conditions) are dynamic in nature and adjust to the behavior of your data. The example below demonstrates a baseline NRQL alert condition for alerting when transaction durations are above a specified threshold and dynamically adjusts based on data trends.
 
+        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
@@ -1026,11 +1031,13 @@ class NrqlAlertCondition(pulumi.CustomResource):
                 threshold_occurrences="ALL",
             ))
         ```
+        <!--End PulumiCodeChooser -->
 
         ## Tags
 
         Manage NRQL alert condition tags with `EntityTags`. For up-to-date documentation about the tagging resource, please check `EntityTags`.
 
+        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
@@ -1084,6 +1091,7 @@ class NrqlAlertCondition(pulumi.CustomResource):
                 ),
             ])
         ```
+        <!--End PulumiCodeChooser -->
 
         <small>alerts.newrelic.com/accounts/**\\<account_id\\>**/policies/**\\<policy_id\\>**/conditions/**\\<condition_id\\>**/edit</small>
 
@@ -1095,6 +1103,7 @@ class NrqlAlertCondition(pulumi.CustomResource):
 
         An example resource from 1.x might look like the following.
 
+        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
@@ -1115,10 +1124,12 @@ class NrqlAlertCondition(pulumi.CustomResource):
                 query="SELECT count(*) FROM TransactionError WHERE appName like '%Dummy App%' FACET appName",
             ))
         ```
+        <!--End PulumiCodeChooser -->
 
         After making the appropriate adjustments mentioned in the deprecation warnings,
         the resource now looks like the following.
 
+        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
@@ -1140,18 +1151,19 @@ class NrqlAlertCondition(pulumi.CustomResource):
                 query="SELECT count(*) FROM TransactionError WHERE appName like '%Dummy App%' FACET appName",
             ))
         ```
+        <!--End PulumiCodeChooser -->
 
         ## Import
 
         NRQL alert conditions can be imported using a composite ID of `<policy_id>:<condition_id>:<conditionType>`, e.g.
 
-         // For `baseline` conditions
+        // For `baseline` conditions
 
         ```sh
         $ pulumi import newrelic:index/nrqlAlertCondition:NrqlAlertCondition foo 538291:6789035:baseline
         ```
 
-         // For `static` conditions
+        // For `static` conditions
 
         ```sh
         $ pulumi import newrelic:index/nrqlAlertCondition:NrqlAlertCondition foo 538291:6789035:static
@@ -1197,8 +1209,10 @@ class NrqlAlertCondition(pulumi.CustomResource):
         Use this resource to create and manage NRQL alert conditions in New Relic.
 
         ## Example Usage
+
         ### Type: `static` (default)
 
+        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
@@ -1237,6 +1251,8 @@ class NrqlAlertCondition(pulumi.CustomResource):
                 threshold_occurrences="ALL",
             ))
         ```
+        <!--End PulumiCodeChooser -->
+
         ## NRQL
 
         The `nrql` block supports the following arguments:
@@ -1275,6 +1291,7 @@ class NrqlAlertCondition(pulumi.CustomResource):
 
         [Baseline NRQL alert conditions](https://docs.newrelic.com/docs/alerts/new-relic-alerts/defining-conditions/create-baseline-alert-conditions) are dynamic in nature and adjust to the behavior of your data. The example below demonstrates a baseline NRQL alert condition for alerting when transaction durations are above a specified threshold and dynamically adjusts based on data trends.
 
+        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
@@ -1313,11 +1330,13 @@ class NrqlAlertCondition(pulumi.CustomResource):
                 threshold_occurrences="ALL",
             ))
         ```
+        <!--End PulumiCodeChooser -->
 
         ## Tags
 
         Manage NRQL alert condition tags with `EntityTags`. For up-to-date documentation about the tagging resource, please check `EntityTags`.
 
+        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
@@ -1371,6 +1390,7 @@ class NrqlAlertCondition(pulumi.CustomResource):
                 ),
             ])
         ```
+        <!--End PulumiCodeChooser -->
 
         <small>alerts.newrelic.com/accounts/**\\<account_id\\>**/policies/**\\<policy_id\\>**/conditions/**\\<condition_id\\>**/edit</small>
 
@@ -1382,6 +1402,7 @@ class NrqlAlertCondition(pulumi.CustomResource):
 
         An example resource from 1.x might look like the following.
 
+        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
@@ -1402,10 +1423,12 @@ class NrqlAlertCondition(pulumi.CustomResource):
                 query="SELECT count(*) FROM TransactionError WHERE appName like '%Dummy App%' FACET appName",
             ))
         ```
+        <!--End PulumiCodeChooser -->
 
         After making the appropriate adjustments mentioned in the deprecation warnings,
         the resource now looks like the following.
 
+        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
@@ -1427,18 +1450,19 @@ class NrqlAlertCondition(pulumi.CustomResource):
                 query="SELECT count(*) FROM TransactionError WHERE appName like '%Dummy App%' FACET appName",
             ))
         ```
+        <!--End PulumiCodeChooser -->
 
         ## Import
 
         NRQL alert conditions can be imported using a composite ID of `<policy_id>:<condition_id>:<conditionType>`, e.g.
 
-         // For `baseline` conditions
+        // For `baseline` conditions
 
         ```sh
         $ pulumi import newrelic:index/nrqlAlertCondition:NrqlAlertCondition foo 538291:6789035:baseline
         ```
 
-         // For `static` conditions
+        // For `static` conditions
 
         ```sh
         $ pulumi import newrelic:index/nrqlAlertCondition:NrqlAlertCondition foo 538291:6789035:static

pulumi_newrelic/nrql_drop_rule.py

@@ -182,6 +182,7 @@ class NrqlDropRule(pulumi.CustomResource):
         """
         ## Example Usage
 
+        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
@@ -202,14 +203,26 @@ class NrqlDropRule(pulumi.CustomResource):
             description="Removes containerId from metric aggregates to reduce metric cardinality.",
             nrql="SELECT containerId FROM Metric")
         ```
+        <!--End PulumiCodeChooser -->
+
+        ## Using `newrelic-cli` to List Out Drop Rules
+
+        All NRQL Drop Rules associated with a New Relic account may be listed out using the following newrelic-cli command:
+
+        This would print all drop rules associated with your New Relic account to the terminal.
+        The number of rules to be printed can be customized using the `limit` argument of this command.
+        For instance, the following command limits the number of drop rules printed to two.
+
+        More details on the command and its arguments (for instance, the format in which the droprules are to be listed in the terminal, which is JSON by default) can be found in the output of the `newrelic nrql droprules --help` command.
+        If you do not have **newrelic-cli** installed on your device already, head over to [this page](https://github.com/newrelic/newrelic-cli#installation--upgrades) for instructions.
 
         ## Import
 
         New Relic NRQL drop rules can be imported using a concatenated string of the format
 
-        `<account_id>:<rule_id>`, e.g.
+         `<account_id>:<rule_id>`, e.g.
 
-         bash
+        bash
 
         ```sh
         $ pulumi import newrelic:index/nrqlDropRule:NrqlDropRule foo 12345:34567
@@ -231,6 +244,7 @@ class NrqlDropRule(pulumi.CustomResource):
         """
         ## Example Usage
 
+        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
@@ -251,14 +265,26 @@ class NrqlDropRule(pulumi.CustomResource):
             description="Removes containerId from metric aggregates to reduce metric cardinality.",
             nrql="SELECT containerId FROM Metric")
         ```
+        <!--End PulumiCodeChooser -->
+
+        ## Using `newrelic-cli` to List Out Drop Rules
+
+        All NRQL Drop Rules associated with a New Relic account may be listed out using the following newrelic-cli command:
+
+        This would print all drop rules associated with your New Relic account to the terminal.
+        The number of rules to be printed can be customized using the `limit` argument of this command.
+        For instance, the following command limits the number of drop rules printed to two.
+
+        More details on the command and its arguments (for instance, the format in which the droprules are to be listed in the terminal, which is JSON by default) can be found in the output of the `newrelic nrql droprules --help` command.
+        If you do not have **newrelic-cli** installed on your device already, head over to [this page](https://github.com/newrelic/newrelic-cli#installation--upgrades) for instructions.
 
         ## Import
 
         New Relic NRQL drop rules can be imported using a concatenated string of the format
 
-        `<account_id>:<rule_id>`, e.g.
+         `<account_id>:<rule_id>`, e.g.
 
-         bash
+        bash
 
         ```sh
         $ pulumi import newrelic:index/nrqlDropRule:NrqlDropRule foo 12345:34567

pulumi_newrelic/obfuscation_expression.py

@@ -169,6 +169,7 @@ class ObfuscationExpression(pulumi.CustomResource):
 
         ## Example Usage
 
+        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
@@ -178,12 +179,13 @@ class ObfuscationExpression(pulumi.CustomResource):
             description="The description",
             regex="(regex.*)")
         ```
+        <!--End PulumiCodeChooser -->
 
         ## Import
 
         New Relic obfuscation expression can be imported using the expression ID, e.g.
 
-         bash
+        bash
 
         ```sh
         $ pulumi import newrelic:index/obfuscationExpression:ObfuscationExpression foo 34567
@@ -207,6 +209,7 @@ class ObfuscationExpression(pulumi.CustomResource):
 
         ## Example Usage
 
+        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
@@ -216,12 +219,13 @@ class ObfuscationExpression(pulumi.CustomResource):
             description="The description",
             regex="(regex.*)")
         ```
+        <!--End PulumiCodeChooser -->
 
         ## Import
 
         New Relic obfuscation expression can be imported using the expression ID, e.g.
 
-         bash
+        bash
 
         ```sh
         $ pulumi import newrelic:index/obfuscationExpression:ObfuscationExpression foo 34567

pulumi_newrelic/obfuscation_rule.py

@@ -235,6 +235,7 @@ class ObfuscationRule(pulumi.CustomResource):
 
         ## Example Usage
 
+        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
@@ -252,12 +253,13 @@ class ObfuscationRule(pulumi.CustomResource):
                 method="MASK",
             )])
         ```
+        <!--End PulumiCodeChooser -->
 
         ## Import
 
         New Relic obfuscation rule can be imported using the rule ID, e.g.
 
-         bash
+        bash
 
         ```sh
         $ pulumi import newrelic:index/obfuscationRule:ObfuscationRule foo 34567
@@ -283,6 +285,7 @@ class ObfuscationRule(pulumi.CustomResource):
 
         ## Example Usage
 
+        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
@@ -300,12 +303,13 @@ class ObfuscationRule(pulumi.CustomResource):
                 method="MASK",
             )])
         ```
+        <!--End PulumiCodeChooser -->
 
         ## Import
 
         New Relic obfuscation rule can be imported using the rule ID, e.g.
 
-         bash
+        bash
 
         ```sh
         $ pulumi import newrelic:index/obfuscationRule:ObfuscationRule foo 34567

pulumi_newrelic/one_dashboard.py

@@ -269,7 +269,7 @@ class OneDashboard(pulumi.CustomResource):
 
         New Relic dashboards can be imported using their GUID, e.g.
 
-         bash
+        bash
 
         ```sh
         $ pulumi import newrelic:index/oneDashboard:OneDashboard my_dashboard <dashboard GUID>
@@ -295,7 +295,7 @@ class OneDashboard(pulumi.CustomResource):
 
         New Relic dashboards can be imported using their GUID, e.g.
 
-         bash
+        bash
 
         ```sh
         $ pulumi import newrelic:index/oneDashboard:OneDashboard my_dashboard <dashboard GUID>

pulumi_newrelic/one_dashboard_json.py

@@ -151,7 +151,7 @@ class OneDashboardJson(pulumi.CustomResource):
 
         New Relic dashboards can be imported using their GUID, e.g.
 
-         bash
+        bash
 
         ```sh
         $ pulumi import newrelic:index/oneDashboardJson:OneDashboardJson my_dashboard <dashboard GUID>
@@ -173,7 +173,7 @@ class OneDashboardJson(pulumi.CustomResource):
 
         New Relic dashboards can be imported using their GUID, e.g.
 
-         bash
+        bash
 
         ```sh
         $ pulumi import newrelic:index/oneDashboardJson:OneDashboardJson my_dashboard <dashboard GUID>

pulumi_newrelic/one_dashboard_raw.py

@@ -235,8 +235,10 @@ class OneDashboardRaw(pulumi.CustomResource):
         > **NOTE:** The OneDashboardJson resource is preferred for configuring dashboards in New Relic. This resource does not support the latest dashboard features and will receive less investment compared to newrelic_one_dashboard_json.
 
         ## Example Usage
+
         ### Create A New Relic One Dashboard With RawConfiguration
 
+        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import json
@@ -308,6 +310,7 @@ class OneDashboardRaw(pulumi.CustomResource):
             ],
         )])
         ```
+        <!--End PulumiCodeChooser -->
 
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
@@ -327,8 +330,10 @@ class OneDashboardRaw(pulumi.CustomResource):
         > **NOTE:** The OneDashboardJson resource is preferred for configuring dashboards in New Relic. This resource does not support the latest dashboard features and will receive less investment compared to newrelic_one_dashboard_json.
 
         ## Example Usage
+
         ### Create A New Relic One Dashboard With RawConfiguration
 
+        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import json
@@ -400,6 +405,7 @@ class OneDashboardRaw(pulumi.CustomResource):
             ],
         )])
         ```
+        <!--End PulumiCodeChooser -->
 
         :param str resource_name: The name of the resource.
         :param OneDashboardRawArgs args: The arguments to use to populate this resource's properties.