pulumi-newrelic 5.20.0a1709643785__py3-none-any.whl → 5.39.0a1736834464__py3-none-any.whl

pulumi_newrelic/alert_policy.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 
 __all__ = ['AlertPolicyArgs', 'AlertPolicy']
@@ -14,14 +19,14 @@ __all__ = ['AlertPolicyArgs', 'AlertPolicy']
 @pulumi.input_type
 class AlertPolicyArgs:
     def __init__(__self__, *,
-                 account_id: Optional[pulumi.Input[int]] = None,
-                 channel_ids: Optional[pulumi.Input[Sequence[pulumi.Input[int]]]] = None,
+                 account_id: Optional[pulumi.Input[str]] = None,
+                 channel_ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                  incident_preference: Optional[pulumi.Input[str]] = None,
                  name: Optional[pulumi.Input[str]] = None):
         """
         The set of arguments for constructing a AlertPolicy resource.
-        :param pulumi.Input[int] account_id: The New Relic account ID to operate on.  This allows the user to override the `account_id` attribute set on the provider. Defaults to the environment variable `NEW_RELIC_ACCOUNT_ID`.
-        :param pulumi.Input[Sequence[pulumi.Input[int]]] channel_ids: An array of channel IDs (integers) to assign to the policy. Adding or removing channel IDs from this array will result in a new alert policy resource being created and the old one being destroyed. Also note that channel IDs _cannot_ be imported.
+        :param pulumi.Input[str] account_id: The New Relic account ID to operate on.  This allows the user to override the `account_id` attribute set on the provider. Defaults to the environment variable `NEW_RELIC_ACCOUNT_ID`.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] channel_ids: An array of channel IDs (integers) to assign to the policy. Adding or removing channel IDs from this array will result in a new alert policy resource being created and the old one being destroyed. Also note that channel IDs _cannot_ be imported.
         :param pulumi.Input[str] incident_preference: The rollup strategy for the policy.  Options include: `PER_POLICY`, `PER_CONDITION`, or `PER_CONDITION_AND_TARGET`.  The default is `PER_POLICY`.
         :param pulumi.Input[str] name: The name of the policy.
         """
@@ -39,29 +44,27 @@ class AlertPolicyArgs:
 
     @property
     @pulumi.getter(name="accountId")
-    def account_id(self) -> Optional[pulumi.Input[int]]:
+    def account_id(self) -> Optional[pulumi.Input[str]]:
         """
         The New Relic account ID to operate on.  This allows the user to override the `account_id` attribute set on the provider. Defaults to the environment variable `NEW_RELIC_ACCOUNT_ID`.
         """
         return pulumi.get(self, "account_id")
 
     @account_id.setter
-    def account_id(self, value: Optional[pulumi.Input[int]]):
+    def account_id(self, value: Optional[pulumi.Input[str]]):
         pulumi.set(self, "account_id", value)
 
     @property
     @pulumi.getter(name="channelIds")
-    def channel_ids(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[int]]]]:
+    @_utilities.deprecated("""The `channel_ids` attribute is deprecated and will be removed in the next major release of the provider.""")
+    def channel_ids(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
         An array of channel IDs (integers) to assign to the policy. Adding or removing channel IDs from this array will result in a new alert policy resource being created and the old one being destroyed. Also note that channel IDs _cannot_ be imported.
         """
-        warnings.warn("""The `channel_ids` attribute is deprecated and will be removed in the next major release of the provider.""", DeprecationWarning)
-        pulumi.log.warn("""channel_ids is deprecated: The `channel_ids` attribute is deprecated and will be removed in the next major release of the provider.""")
-
         return pulumi.get(self, "channel_ids")
 
     @channel_ids.setter
-    def channel_ids(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[int]]]]):
+    def channel_ids(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]):
         pulumi.set(self, "channel_ids", value)
 
     @property
@@ -92,14 +95,14 @@ class AlertPolicyArgs:
 @pulumi.input_type
 class _AlertPolicyState:
     def __init__(__self__, *,
-                 account_id: Optional[pulumi.Input[int]] = None,
-                 channel_ids: Optional[pulumi.Input[Sequence[pulumi.Input[int]]]] = None,
+                 account_id: Optional[pulumi.Input[str]] = None,
+                 channel_ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                  incident_preference: Optional[pulumi.Input[str]] = None,
                  name: Optional[pulumi.Input[str]] = None):
         """
         Input properties used for looking up and filtering AlertPolicy resources.
-        :param pulumi.Input[int] account_id: The New Relic account ID to operate on.  This allows the user to override the `account_id` attribute set on the provider. Defaults to the environment variable `NEW_RELIC_ACCOUNT_ID`.
-        :param pulumi.Input[Sequence[pulumi.Input[int]]] channel_ids: An array of channel IDs (integers) to assign to the policy. Adding or removing channel IDs from this array will result in a new alert policy resource being created and the old one being destroyed. Also note that channel IDs _cannot_ be imported.
+        :param pulumi.Input[str] account_id: The New Relic account ID to operate on.  This allows the user to override the `account_id` attribute set on the provider. Defaults to the environment variable `NEW_RELIC_ACCOUNT_ID`.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] channel_ids: An array of channel IDs (integers) to assign to the policy. Adding or removing channel IDs from this array will result in a new alert policy resource being created and the old one being destroyed. Also note that channel IDs _cannot_ be imported.
         :param pulumi.Input[str] incident_preference: The rollup strategy for the policy.  Options include: `PER_POLICY`, `PER_CONDITION`, or `PER_CONDITION_AND_TARGET`.  The default is `PER_POLICY`.
         :param pulumi.Input[str] name: The name of the policy.
         """
@@ -117,29 +120,27 @@ class _AlertPolicyState:
 
     @property
     @pulumi.getter(name="accountId")
-    def account_id(self) -> Optional[pulumi.Input[int]]:
+    def account_id(self) -> Optional[pulumi.Input[str]]:
         """
         The New Relic account ID to operate on.  This allows the user to override the `account_id` attribute set on the provider. Defaults to the environment variable `NEW_RELIC_ACCOUNT_ID`.
         """
         return pulumi.get(self, "account_id")
 
     @account_id.setter
-    def account_id(self, value: Optional[pulumi.Input[int]]):
+    def account_id(self, value: Optional[pulumi.Input[str]]):
         pulumi.set(self, "account_id", value)
 
     @property
     @pulumi.getter(name="channelIds")
-    def channel_ids(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[int]]]]:
+    @_utilities.deprecated("""The `channel_ids` attribute is deprecated and will be removed in the next major release of the provider.""")
+    def channel_ids(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
         An array of channel IDs (integers) to assign to the policy. Adding or removing channel IDs from this array will result in a new alert policy resource being created and the old one being destroyed. Also note that channel IDs _cannot_ be imported.
         """
-        warnings.warn("""The `channel_ids` attribute is deprecated and will be removed in the next major release of the provider.""", DeprecationWarning)
-        pulumi.log.warn("""channel_ids is deprecated: The `channel_ids` attribute is deprecated and will be removed in the next major release of the provider.""")
-
         return pulumi.get(self, "channel_ids")
 
     @channel_ids.setter
-    def channel_ids(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[int]]]]):
+    def channel_ids(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]):
         pulumi.set(self, "channel_ids", value)
 
     @property
@@ -172,8 +173,8 @@ class AlertPolicy(pulumi.CustomResource):
     def __init__(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
-                 account_id: Optional[pulumi.Input[int]] = None,
-                 channel_ids: Optional[pulumi.Input[Sequence[pulumi.Input[int]]]] = None,
+                 account_id: Optional[pulumi.Input[str]] = None,
+                 channel_ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                  incident_preference: Optional[pulumi.Input[str]] = None,
                  name: Optional[pulumi.Input[str]] = None,
                  __props__=None):
@@ -181,14 +182,18 @@ class AlertPolicy(pulumi.CustomResource):
         Use this resource to create and manage New Relic alert policies.
 
         ## Example Usage
+
         ### Basic Usage
 
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
 
-        foo = newrelic.AlertPolicy("foo", incident_preference="PER_POLICY")
+        foo = newrelic.AlertPolicy("foo",
+            name="example",
+            incident_preference="PER_POLICY")
         ```
+
         ### Provision multiple notification channels and add those channels to a policy
 
         The following arguments are supported:
@@ -200,6 +205,7 @@ class AlertPolicy(pulumi.CustomResource):
             * `PER_CONDITION_AND_TARGET` - This sets the incident grouping preference of the policy to **One issue per condition and signal**. Refer to [this page](https://docs.newrelic.com/docs/alerts-applied-intelligence/new-relic-alerts/alert-policies/specify-when-alerts-create-incidents/#preference-signal) for more details on this incident grouping preference.
           * `channel_ids` - (Optional) **DEPRECATED** The `channel_ids` argument is deprecated and will be removed in the next major release of the provider. An array of channel IDs (integers) to assign to the policy. Adding or removing channel IDs from this array will result in a new alert policy resource being created and the old one being destroyed. Also note that channel IDs _cannot_ be imported via `pulumi import` (see Import for info).
           * `account_id` - (Optional) The New Relic account ID to operate on.  This allows the user to override the `account_id` attribute set on the provider. Defaults to the environment variable `NEW_RELIC_ACCOUNT_ID`.
+
         ## Additional Examples
 
         ##### Provision multiple notification channels and add those channels to a policy
@@ -208,21 +214,24 @@ class AlertPolicy(pulumi.CustomResource):
         import pulumi_newrelic as newrelic
 
         # Provision a Slack notification channel.
-        slack_channel = newrelic.AlertChannel("slackChannel",
+        slack_channel = newrelic.AlertChannel("slack_channel",
+            name="slack-example",
             type="slack",
-            config=newrelic.AlertChannelConfigArgs(
-                url="https://hooks.slack.com/services/xxxxxxx/yyyyyyyy",
-                channel="example-alerts-channel",
-            ))
+            config={
+                "url": "https://hooks.slack.com/services/xxxxxxx/yyyyyyyy",
+                "channel": "example-alerts-channel",
+            })
         # Provision an email notification channel.
-        email_channel = newrelic.AlertChannel("emailChannel",
+        email_channel = newrelic.AlertChannel("email_channel",
+            name="email-example",
             type="email",
-            config=newrelic.AlertChannelConfigArgs(
-                recipients="example@testing.com",
-                include_json_attachment="1",
-            ))
+            config={
+                "recipients": "example@testing.com",
+                "include_json_attachment": "1",
+            })
         # Provision the alert policy.
-        policy_with_channels = newrelic.AlertPolicy("policyWithChannels",
+        policy_with_channels = newrelic.AlertPolicy("policy_with_channels",
+            name="example-with-channels",
             incident_preference="PER_CONDITION",
             channel_ids=[
                 slack_channel.id,
@@ -235,10 +244,13 @@ class AlertPolicy(pulumi.CustomResource):
         import pulumi
         import pulumi_newrelic as newrelic
 
+        # Reference an existing Slack notification channel.
         slack_channel = newrelic.get_alert_channel(name="slack-channel-notification")
+        # Reference an existing email notification channel.
         email_channel = newrelic.get_alert_channel(name="test@example.com")
         # Provision the alert policy.
-        policy_with_channels = newrelic.AlertPolicy("policyWithChannels",
+        policy_with_channels = newrelic.AlertPolicy("policy_with_channels",
+            name="example-with-channels",
             incident_preference="PER_CONDITION",
             channel_ids=[
                 slack_channel.id,
@@ -253,14 +265,14 @@ class AlertPolicy(pulumi.CustomResource):
         Example import:
 
         ```sh
-         $ pulumi import newrelic:index/alertPolicy:AlertPolicy foo 23423556:4593020
+        $ pulumi import newrelic:index/alertPolicy:AlertPolicy foo 23423556:4593020
         ```
-         Please note that channel IDs (`channel_ids`) _cannot_ be imported due channels being a separate resource. However, to add channels to an imported alert policy, you can import the policy, add the `channel_ids` attribute with the associated channel IDs, then run `pulumi up`. This will result in the original alert policy being destroyed and a new alert policy being created along with the channels being added to the policy.
+        Please note that channel IDs (`channel_ids`) _cannot_ be imported due channels being a separate resource. However, to add channels to an imported alert policy, you can import the policy, add the `channel_ids` attribute with the associated channel IDs, then run `pulumi up`. This will result in the original alert policy being destroyed and a new alert policy being created along with the channels being added to the policy.
 
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[int] account_id: The New Relic account ID to operate on.  This allows the user to override the `account_id` attribute set on the provider. Defaults to the environment variable `NEW_RELIC_ACCOUNT_ID`.
-        :param pulumi.Input[Sequence[pulumi.Input[int]]] channel_ids: An array of channel IDs (integers) to assign to the policy. Adding or removing channel IDs from this array will result in a new alert policy resource being created and the old one being destroyed. Also note that channel IDs _cannot_ be imported.
+        :param pulumi.Input[str] account_id: The New Relic account ID to operate on.  This allows the user to override the `account_id` attribute set on the provider. Defaults to the environment variable `NEW_RELIC_ACCOUNT_ID`.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] channel_ids: An array of channel IDs (integers) to assign to the policy. Adding or removing channel IDs from this array will result in a new alert policy resource being created and the old one being destroyed. Also note that channel IDs _cannot_ be imported.
         :param pulumi.Input[str] incident_preference: The rollup strategy for the policy.  Options include: `PER_POLICY`, `PER_CONDITION`, or `PER_CONDITION_AND_TARGET`.  The default is `PER_POLICY`.
         :param pulumi.Input[str] name: The name of the policy.
         """
@@ -274,14 +286,18 @@ class AlertPolicy(pulumi.CustomResource):
         Use this resource to create and manage New Relic alert policies.
 
         ## Example Usage
+
         ### Basic Usage
 
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
 
-        foo = newrelic.AlertPolicy("foo", incident_preference="PER_POLICY")
+        foo = newrelic.AlertPolicy("foo",
+            name="example",
+            incident_preference="PER_POLICY")
         ```
+
         ### Provision multiple notification channels and add those channels to a policy
 
         The following arguments are supported:
@@ -293,6 +309,7 @@ class AlertPolicy(pulumi.CustomResource):
             * `PER_CONDITION_AND_TARGET` - This sets the incident grouping preference of the policy to **One issue per condition and signal**. Refer to [this page](https://docs.newrelic.com/docs/alerts-applied-intelligence/new-relic-alerts/alert-policies/specify-when-alerts-create-incidents/#preference-signal) for more details on this incident grouping preference.
           * `channel_ids` - (Optional) **DEPRECATED** The `channel_ids` argument is deprecated and will be removed in the next major release of the provider. An array of channel IDs (integers) to assign to the policy. Adding or removing channel IDs from this array will result in a new alert policy resource being created and the old one being destroyed. Also note that channel IDs _cannot_ be imported via `pulumi import` (see Import for info).
           * `account_id` - (Optional) The New Relic account ID to operate on.  This allows the user to override the `account_id` attribute set on the provider. Defaults to the environment variable `NEW_RELIC_ACCOUNT_ID`.
+
         ## Additional Examples
 
         ##### Provision multiple notification channels and add those channels to a policy
@@ -301,21 +318,24 @@ class AlertPolicy(pulumi.CustomResource):
         import pulumi_newrelic as newrelic
 
         # Provision a Slack notification channel.
-        slack_channel = newrelic.AlertChannel("slackChannel",
+        slack_channel = newrelic.AlertChannel("slack_channel",
+            name="slack-example",
             type="slack",
-            config=newrelic.AlertChannelConfigArgs(
-                url="https://hooks.slack.com/services/xxxxxxx/yyyyyyyy",
-                channel="example-alerts-channel",
-            ))
+            config={
+                "url": "https://hooks.slack.com/services/xxxxxxx/yyyyyyyy",
+                "channel": "example-alerts-channel",
+            })
         # Provision an email notification channel.
-        email_channel = newrelic.AlertChannel("emailChannel",
+        email_channel = newrelic.AlertChannel("email_channel",
+            name="email-example",
             type="email",
-            config=newrelic.AlertChannelConfigArgs(
-                recipients="example@testing.com",
-                include_json_attachment="1",
-            ))
+            config={
+                "recipients": "example@testing.com",
+                "include_json_attachment": "1",
+            })
         # Provision the alert policy.
-        policy_with_channels = newrelic.AlertPolicy("policyWithChannels",
+        policy_with_channels = newrelic.AlertPolicy("policy_with_channels",
+            name="example-with-channels",
             incident_preference="PER_CONDITION",
             channel_ids=[
                 slack_channel.id,
@@ -328,10 +348,13 @@ class AlertPolicy(pulumi.CustomResource):
         import pulumi
         import pulumi_newrelic as newrelic
 
+        # Reference an existing Slack notification channel.
         slack_channel = newrelic.get_alert_channel(name="slack-channel-notification")
+        # Reference an existing email notification channel.
         email_channel = newrelic.get_alert_channel(name="test@example.com")
         # Provision the alert policy.
-        policy_with_channels = newrelic.AlertPolicy("policyWithChannels",
+        policy_with_channels = newrelic.AlertPolicy("policy_with_channels",
+            name="example-with-channels",
             incident_preference="PER_CONDITION",
             channel_ids=[
                 slack_channel.id,
@@ -346,9 +369,9 @@ class AlertPolicy(pulumi.CustomResource):
         Example import:
 
         ```sh
-         $ pulumi import newrelic:index/alertPolicy:AlertPolicy foo 23423556:4593020
+        $ pulumi import newrelic:index/alertPolicy:AlertPolicy foo 23423556:4593020
         ```
-         Please note that channel IDs (`channel_ids`) _cannot_ be imported due channels being a separate resource. However, to add channels to an imported alert policy, you can import the policy, add the `channel_ids` attribute with the associated channel IDs, then run `pulumi up`. This will result in the original alert policy being destroyed and a new alert policy being created along with the channels being added to the policy.
+        Please note that channel IDs (`channel_ids`) _cannot_ be imported due channels being a separate resource. However, to add channels to an imported alert policy, you can import the policy, add the `channel_ids` attribute with the associated channel IDs, then run `pulumi up`. This will result in the original alert policy being destroyed and a new alert policy being created along with the channels being added to the policy.
 
         :param str resource_name: The name of the resource.
         :param AlertPolicyArgs args: The arguments to use to populate this resource's properties.
@@ -365,8 +388,8 @@ class AlertPolicy(pulumi.CustomResource):
     def _internal_init(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
-                 account_id: Optional[pulumi.Input[int]] = None,
-                 channel_ids: Optional[pulumi.Input[Sequence[pulumi.Input[int]]]] = None,
+                 account_id: Optional[pulumi.Input[str]] = None,
+                 channel_ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                  incident_preference: Optional[pulumi.Input[str]] = None,
                  name: Optional[pulumi.Input[str]] = None,
                  __props__=None):
@@ -392,8 +415,8 @@ class AlertPolicy(pulumi.CustomResource):
     def get(resource_name: str,
             id: pulumi.Input[str],
             opts: Optional[pulumi.ResourceOptions] = None,
-            account_id: Optional[pulumi.Input[int]] = None,
-            channel_ids: Optional[pulumi.Input[Sequence[pulumi.Input[int]]]] = None,
+            account_id: Optional[pulumi.Input[str]] = None,
+            channel_ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
             incident_preference: Optional[pulumi.Input[str]] = None,
             name: Optional[pulumi.Input[str]] = None) -> 'AlertPolicy':
         """
@@ -403,8 +426,8 @@ class AlertPolicy(pulumi.CustomResource):
         :param str resource_name: The unique name of the resulting resource.
         :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[int] account_id: The New Relic account ID to operate on.  This allows the user to override the `account_id` attribute set on the provider. Defaults to the environment variable `NEW_RELIC_ACCOUNT_ID`.
-        :param pulumi.Input[Sequence[pulumi.Input[int]]] channel_ids: An array of channel IDs (integers) to assign to the policy. Adding or removing channel IDs from this array will result in a new alert policy resource being created and the old one being destroyed. Also note that channel IDs _cannot_ be imported.
+        :param pulumi.Input[str] account_id: The New Relic account ID to operate on.  This allows the user to override the `account_id` attribute set on the provider. Defaults to the environment variable `NEW_RELIC_ACCOUNT_ID`.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] channel_ids: An array of channel IDs (integers) to assign to the policy. Adding or removing channel IDs from this array will result in a new alert policy resource being created and the old one being destroyed. Also note that channel IDs _cannot_ be imported.
         :param pulumi.Input[str] incident_preference: The rollup strategy for the policy.  Options include: `PER_POLICY`, `PER_CONDITION`, or `PER_CONDITION_AND_TARGET`.  The default is `PER_POLICY`.
         :param pulumi.Input[str] name: The name of the policy.
         """
@@ -420,7 +443,7 @@ class AlertPolicy(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="accountId")
-    def account_id(self) -> pulumi.Output[int]:
+    def account_id(self) -> pulumi.Output[str]:
         """
         The New Relic account ID to operate on.  This allows the user to override the `account_id` attribute set on the provider. Defaults to the environment variable `NEW_RELIC_ACCOUNT_ID`.
         """
@@ -428,13 +451,11 @@ class AlertPolicy(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="channelIds")
-    def channel_ids(self) -> pulumi.Output[Optional[Sequence[int]]]:
+    @_utilities.deprecated("""The `channel_ids` attribute is deprecated and will be removed in the next major release of the provider.""")
+    def channel_ids(self) -> pulumi.Output[Optional[Sequence[str]]]:
         """
         An array of channel IDs (integers) to assign to the policy. Adding or removing channel IDs from this array will result in a new alert policy resource being created and the old one being destroyed. Also note that channel IDs _cannot_ be imported.
         """
-        warnings.warn("""The `channel_ids` attribute is deprecated and will be removed in the next major release of the provider.""", DeprecationWarning)
-        pulumi.log.warn("""channel_ids is deprecated: The `channel_ids` attribute is deprecated and will be removed in the next major release of the provider.""")
-
         return pulumi.get(self, "channel_ids")
 
     @property