pulumi-newrelic 5.21.0a1710157101__py3-none-any.whl → 5.39.0a1736834464__py3-none-any.whl

pulumi_newrelic/_utilities.py

@@ -4,6 +4,7 @@
 
 
 import asyncio
+import functools
 import importlib.metadata
 import importlib.util
 import inspect
@@ -11,14 +12,19 @@ import json
 import os
 import sys
 import typing
+import warnings
+import base64
 
 import pulumi
 import pulumi.runtime
 from pulumi.runtime.sync_await import _sync_await
+from pulumi.runtime.proto import resource_pb2
 
 from semver import VersionInfo as SemverVersion
 from parver import Version as PEP440Version
 
+C = typing.TypeVar("C", bound=typing.Callable)
+
 
 def get_env(*args):
     for v in args:
@@ -96,10 +102,6 @@ def _get_semver_version():
 _version = _get_semver_version()
 _version_str = str(_version)
 
-
-def get_version():
-    return _version_str
-
 def get_resource_opts_defaults() -> pulumi.ResourceOptions:
     return pulumi.ResourceOptions(
         version=get_version(),
@@ -262,7 +264,7 @@ def call_plain(
     output = pulumi.runtime.call(tok, props, res, typ)
 
     # Ingoring deps silently. They are typically non-empty, r.f() calls include r as a dependency.
-    result, known, secret, _ = _sync_await(asyncio.ensure_future(_await_output(output)))
+    result, known, secret, _ = _sync_await(asyncio.create_task(_await_output(output)))
 
     problem = None
     if not known:
@@ -287,5 +289,39 @@ async def _await_output(o: pulumi.Output[typing.Any]) -> typing.Tuple[object, bo
         await o._resources,
     )
 
+
+# This is included to provide an upgrade path for users who are using a version
+# of the Pulumi SDK (<3.121.0) that does not include the `deprecated` decorator.
+def deprecated(message: str) -> typing.Callable[[C], C]:
+    """
+    Decorator to indicate a function is deprecated.
+
+    As well as inserting appropriate statements to indicate that the function is
+    deprecated, this decorator also tags the function with a special attribute
+    so that Pulumi code can detect that it is deprecated and react appropriately
+    in certain situations.
+
+    message is the deprecation message that should be printed if the function is called.
+    """
+
+    def decorator(fn: C) -> C:
+        if not callable(fn):
+            raise TypeError("Expected fn to be callable")
+
+        @functools.wraps(fn)
+        def deprecated_fn(*args, **kwargs):
+            warnings.warn(message)
+            pulumi.warn(f"{fn.__name__} is deprecated: {message}")
+
+            return fn(*args, **kwargs)
+
+        deprecated_fn.__dict__["_pulumi_deprecated_callable"] = fn
+        return typing.cast(C, deprecated_fn)
+
+    return decorator
+
 def get_plugin_download_url():
 	return None
+
+def get_version():
+     return _version_str

pulumi_newrelic/account_management.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__ = ['AccountManagementArgs', 'AccountManagement']
@@ -106,14 +111,14 @@ class AccountManagement(pulumi.CustomResource):
         ## Example Usage
 
         ##### Create Account
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
 
-        foo = newrelic.AccountManagement("foo", region="us01")
+        foo = newrelic.AccountManagement("foo",
+            name="Test Account Name",
+            region="us01")
         ```
-        <!--End PulumiCodeChooser -->
 
         ## Import
 
@@ -144,14 +149,14 @@ class AccountManagement(pulumi.CustomResource):
         ## Example Usage
 
         ##### Create Account
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
 
-        foo = newrelic.AccountManagement("foo", region="us01")
+        foo = newrelic.AccountManagement("foo",
+            name="Test Account Name",
+            region="us01")
         ```
-        <!--End PulumiCodeChooser -->
 
         ## Import
 

pulumi_newrelic/alert_channel.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
 from . import outputs
 from ._inputs import *
@@ -17,13 +22,13 @@ __all__ = ['AlertChannelArgs', 'AlertChannel']
 class AlertChannelArgs:
     def __init__(__self__, *,
                  type: pulumi.Input[str],
-                 account_id: Optional[pulumi.Input[int]] = None,
+                 account_id: Optional[pulumi.Input[str]] = None,
                  config: Optional[pulumi.Input['AlertChannelConfigArgs']] = None,
                  name: Optional[pulumi.Input[str]] = None):
         """
         The set of arguments for constructing a AlertChannel resource.
         :param pulumi.Input[str] type: The type of channel.  One of: `email`, `slack`, `opsgenie`, `pagerduty`, `victorops`, or `webhook`.
-        :param pulumi.Input[int] account_id: Determines the New Relic account where the alert channel will be created. Defaults to the account associated with the API key used.
+        :param pulumi.Input[str] account_id: Determines the New Relic account where the alert channel will be created. Defaults to the account associated with the API key used.
         :param pulumi.Input['AlertChannelConfigArgs'] config: A nested block that describes an alert channel configuration.  Only one config block is permitted per alert channel definition.  See Nested config blocks below for details.
         :param pulumi.Input[str] name: The name of the channel.
         """
@@ -49,14 +54,14 @@ class AlertChannelArgs:
 
     @property
     @pulumi.getter(name="accountId")
-    def account_id(self) -> Optional[pulumi.Input[int]]:
+    def account_id(self) -> Optional[pulumi.Input[str]]:
         """
         Determines the New Relic account where the alert channel will be created. Defaults to the account associated with the API key used.
         """
         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
@@ -87,13 +92,13 @@ class AlertChannelArgs:
 @pulumi.input_type
 class _AlertChannelState:
     def __init__(__self__, *,
-                 account_id: Optional[pulumi.Input[int]] = None,
+                 account_id: Optional[pulumi.Input[str]] = None,
                  config: Optional[pulumi.Input['AlertChannelConfigArgs']] = None,
                  name: Optional[pulumi.Input[str]] = None,
                  type: Optional[pulumi.Input[str]] = None):
         """
         Input properties used for looking up and filtering AlertChannel resources.
-        :param pulumi.Input[int] account_id: Determines the New Relic account where the alert channel will be created. Defaults to the account associated with the API key used.
+        :param pulumi.Input[str] account_id: Determines the New Relic account where the alert channel will be created. Defaults to the account associated with the API key used.
         :param pulumi.Input['AlertChannelConfigArgs'] config: A nested block that describes an alert channel configuration.  Only one config block is permitted per alert channel definition.  See Nested config blocks below for details.
         :param pulumi.Input[str] name: The name of the channel.
         :param pulumi.Input[str] type: The type of channel.  One of: `email`, `slack`, `opsgenie`, `pagerduty`, `victorops`, or `webhook`.
@@ -109,14 +114,14 @@ class _AlertChannelState:
 
     @property
     @pulumi.getter(name="accountId")
-    def account_id(self) -> Optional[pulumi.Input[int]]:
+    def account_id(self) -> Optional[pulumi.Input[str]]:
         """
         Determines the New Relic account where the alert channel will be created. Defaults to the account associated with the API key used.
         """
         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
@@ -161,143 +166,135 @@ class AlertChannel(pulumi.CustomResource):
     def __init__(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
-                 account_id: Optional[pulumi.Input[int]] = None,
-                 config: Optional[pulumi.Input[pulumi.InputType['AlertChannelConfigArgs']]] = None,
+                 account_id: Optional[pulumi.Input[str]] = None,
+                 config: Optional[pulumi.Input[Union['AlertChannelConfigArgs', 'AlertChannelConfigArgsDict']]] = None,
                  name: Optional[pulumi.Input[str]] = None,
                  type: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
         Use this resource to create and manage New Relic alert channels.
 
-        > **WARNING:** The `AlertChannel` resource is deprecated and will be removed in the next major release. For managing channel resources in Workflows, use `NotificationChannel`.
+        > **WARNING:** The `AlertChannel` resource is **deprecated** and will be **removed in a future major release**. As an alternative, you can set up channels using a combination of the newer resources `NotificationDestination` and `NotificationChannel`. We **strongly recommend** migrating to these new resources at the earliest. Please refer to this example for a detailed illustration on setting up channels with these resources.
 
         ## Example Usage
 
         ### Email
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
 
         foo = newrelic.AlertChannel("foo",
-            config=newrelic.AlertChannelConfigArgs(
-                include_json_attachment="true",
-                recipients="foo@example.com",
-            ),
-            type="email")
+            name="foo",
+            type="email",
+            config={
+                "recipients": "foo@example.com",
+                "include_json_attachment": "true",
+            })
         ```
-        <!--End PulumiCodeChooser -->
 
         ## Additional Examples
 
         ##### Slack
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
 
         foo = newrelic.AlertChannel("foo",
-            config=newrelic.AlertChannelConfigArgs(
-                channel="example-alerts-channel",
-                url="https://hooks.slack.com/services/XXXXXXX/XXXXXXX/XXXXXXXXXX",
-            ),
-            type="slack")
+            name="slack-example",
+            type="slack",
+            config={
+                "url": "https://hooks.slack.com/services/XXXXXXX/XXXXXXX/XXXXXXXXXX",
+                "channel": "example-alerts-channel",
+            })
         ```
-        <!--End PulumiCodeChooser -->
 
         > **NOTE:** For instructions on setting up Webhooks with Slack, please visit the article linked under the argument `slack` in the aforementioned configuration, or [this article](https://docs.newrelic.com/docs/alerts-applied-intelligence/new-relic-alerts/alert-notifications/notification-channels-control-where-send-alerts/#slack) in New Relic's docs for additional details on setting up the `New Relic Alerts` Slack application, and subsequently using the generated Webhook URL.
 
         ### OpsGenie
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
 
         foo = newrelic.AlertChannel("foo",
-            config=newrelic.AlertChannelConfigArgs(
-                api_key="abc123",
-                recipients="user1@domain.com, user2@domain.com",
-                tags="tag1, tag2",
-                teams="team1, team2",
-            ),
-            type="opsgenie")
+            name="opsgenie-example",
+            type="opsgenie",
+            config={
+                "api_key": "abc123",
+                "teams": "team1, team2",
+                "tags": "tag1, tag2",
+                "recipients": "user1@domain.com, user2@domain.com",
+            })
         ```
-        <!--End PulumiCodeChooser -->
 
         ### PagerDuty
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
 
         foo = newrelic.AlertChannel("foo",
-            config=newrelic.AlertChannelConfigArgs(
-                service_key="abc123",
-            ),
-            type="pagerduty")
+            name="pagerduty-example",
+            type="pagerduty",
+            config={
+                "service_key": "abc123",
+            })
         ```
-        <!--End PulumiCodeChooser -->
 
         ### VictorOps
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
 
         foo = newrelic.AlertChannel("foo",
-            config=newrelic.AlertChannelConfigArgs(
-                key="abc123",
-                route_key="/example",
-            ),
-            type="victorops")
+            name="victorops-example",
+            type="victorops",
+            config={
+                "key": "abc123",
+                "route_key": "/example",
+            })
         ```
-        <!--End PulumiCodeChooser -->
 
         ### Webhook
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
 
         foo = newrelic.AlertChannel("foo",
+            name="webhook-example",
             type="webhook",
-            config=newrelic.AlertChannelConfigArgs(
-                base_url="http://www.test.com",
-                payload_type="application/json",
-                payload={
+            config={
+                "base_url": "http://www.test.com",
+                "payload_type": "application/json",
+                "payload": {
                     "condition_name": "$CONDITION_NAME",
                     "policy_name": "$POLICY_NAME",
                 },
-                headers={
+                "headers": {
                     "header1": value1,
                     "header2": value2,
                 },
-            ))
+            })
         ```
-        <!--End PulumiCodeChooser -->
 
         ### Webhook with complex payload
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
 
         foo = newrelic.AlertChannel("foo",
-            config=newrelic.AlertChannelConfigArgs(
-                base_url="http://www.test.com",
-                payload_string=\"\"\"{
+            name="webhook-example",
+            type="webhook",
+            config={
+                "base_url": "http://www.test.com",
+                "payload_type": "application/json",
+                "payload_string": \"\"\"{
           "my_custom_values": {
             "condition_name": "$CONDITION_NAME",
             "policy_name": "$POLICY_NAME"
           }
         }
-
         \"\"\",
-                payload_type="application/json",
-            ),
-            type="webhook")
+            })
         ```
-        <!--End PulumiCodeChooser -->
 
         ## Import
 
@@ -311,8 +308,8 @@ class AlertChannel(pulumi.CustomResource):
 
         :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 alert channel will be created. Defaults to the account associated with the API key used.
-        :param pulumi.Input[pulumi.InputType['AlertChannelConfigArgs']] config: A nested block that describes an alert channel configuration.  Only one config block is permitted per alert channel definition.  See Nested config blocks below for details.
+        :param pulumi.Input[str] account_id: Determines the New Relic account where the alert channel will be created. Defaults to the account associated with the API key used.
+        :param pulumi.Input[Union['AlertChannelConfigArgs', 'AlertChannelConfigArgsDict']] config: A nested block that describes an alert channel configuration.  Only one config block is permitted per alert channel definition.  See Nested config blocks below for details.
         :param pulumi.Input[str] name: The name of the channel.
         :param pulumi.Input[str] type: The type of channel.  One of: `email`, `slack`, `opsgenie`, `pagerduty`, `victorops`, or `webhook`.
         """
@@ -325,135 +322,127 @@ class AlertChannel(pulumi.CustomResource):
         """
         Use this resource to create and manage New Relic alert channels.
 
-        > **WARNING:** The `AlertChannel` resource is deprecated and will be removed in the next major release. For managing channel resources in Workflows, use `NotificationChannel`.
+        > **WARNING:** The `AlertChannel` resource is **deprecated** and will be **removed in a future major release**. As an alternative, you can set up channels using a combination of the newer resources `NotificationDestination` and `NotificationChannel`. We **strongly recommend** migrating to these new resources at the earliest. Please refer to this example for a detailed illustration on setting up channels with these resources.
 
         ## Example Usage
 
         ### Email
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
 
         foo = newrelic.AlertChannel("foo",
-            config=newrelic.AlertChannelConfigArgs(
-                include_json_attachment="true",
-                recipients="foo@example.com",
-            ),
-            type="email")
+            name="foo",
+            type="email",
+            config={
+                "recipients": "foo@example.com",
+                "include_json_attachment": "true",
+            })
         ```
-        <!--End PulumiCodeChooser -->
 
         ## Additional Examples
 
         ##### Slack
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
 
         foo = newrelic.AlertChannel("foo",
-            config=newrelic.AlertChannelConfigArgs(
-                channel="example-alerts-channel",
-                url="https://hooks.slack.com/services/XXXXXXX/XXXXXXX/XXXXXXXXXX",
-            ),
-            type="slack")
+            name="slack-example",
+            type="slack",
+            config={
+                "url": "https://hooks.slack.com/services/XXXXXXX/XXXXXXX/XXXXXXXXXX",
+                "channel": "example-alerts-channel",
+            })
         ```
-        <!--End PulumiCodeChooser -->
 
         > **NOTE:** For instructions on setting up Webhooks with Slack, please visit the article linked under the argument `slack` in the aforementioned configuration, or [this article](https://docs.newrelic.com/docs/alerts-applied-intelligence/new-relic-alerts/alert-notifications/notification-channels-control-where-send-alerts/#slack) in New Relic's docs for additional details on setting up the `New Relic Alerts` Slack application, and subsequently using the generated Webhook URL.
 
         ### OpsGenie
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
 
         foo = newrelic.AlertChannel("foo",
-            config=newrelic.AlertChannelConfigArgs(
-                api_key="abc123",
-                recipients="user1@domain.com, user2@domain.com",
-                tags="tag1, tag2",
-                teams="team1, team2",
-            ),
-            type="opsgenie")
+            name="opsgenie-example",
+            type="opsgenie",
+            config={
+                "api_key": "abc123",
+                "teams": "team1, team2",
+                "tags": "tag1, tag2",
+                "recipients": "user1@domain.com, user2@domain.com",
+            })
         ```
-        <!--End PulumiCodeChooser -->
 
         ### PagerDuty
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
 
         foo = newrelic.AlertChannel("foo",
-            config=newrelic.AlertChannelConfigArgs(
-                service_key="abc123",
-            ),
-            type="pagerduty")
+            name="pagerduty-example",
+            type="pagerduty",
+            config={
+                "service_key": "abc123",
+            })
         ```
-        <!--End PulumiCodeChooser -->
 
         ### VictorOps
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
 
         foo = newrelic.AlertChannel("foo",
-            config=newrelic.AlertChannelConfigArgs(
-                key="abc123",
-                route_key="/example",
-            ),
-            type="victorops")
+            name="victorops-example",
+            type="victorops",
+            config={
+                "key": "abc123",
+                "route_key": "/example",
+            })
         ```
-        <!--End PulumiCodeChooser -->
 
         ### Webhook
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
 
         foo = newrelic.AlertChannel("foo",
+            name="webhook-example",
             type="webhook",
-            config=newrelic.AlertChannelConfigArgs(
-                base_url="http://www.test.com",
-                payload_type="application/json",
-                payload={
+            config={
+                "base_url": "http://www.test.com",
+                "payload_type": "application/json",
+                "payload": {
                     "condition_name": "$CONDITION_NAME",
                     "policy_name": "$POLICY_NAME",
                 },
-                headers={
+                "headers": {
                     "header1": value1,
                     "header2": value2,
                 },
-            ))
+            })
         ```
-        <!--End PulumiCodeChooser -->
 
         ### Webhook with complex payload
-        <!--Start PulumiCodeChooser -->
         ```python
         import pulumi
         import pulumi_newrelic as newrelic
 
         foo = newrelic.AlertChannel("foo",
-            config=newrelic.AlertChannelConfigArgs(
-                base_url="http://www.test.com",
-                payload_string=\"\"\"{
+            name="webhook-example",
+            type="webhook",
+            config={
+                "base_url": "http://www.test.com",
+                "payload_type": "application/json",
+                "payload_string": \"\"\"{
           "my_custom_values": {
             "condition_name": "$CONDITION_NAME",
             "policy_name": "$POLICY_NAME"
           }
         }
-
         \"\"\",
-                payload_type="application/json",
-            ),
-            type="webhook")
+            })
         ```
-        <!--End PulumiCodeChooser -->
 
         ## Import
 
@@ -480,8 +469,8 @@ class AlertChannel(pulumi.CustomResource):
     def _internal_init(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
-                 account_id: Optional[pulumi.Input[int]] = None,
-                 config: Optional[pulumi.Input[pulumi.InputType['AlertChannelConfigArgs']]] = None,
+                 account_id: Optional[pulumi.Input[str]] = None,
+                 config: Optional[pulumi.Input[Union['AlertChannelConfigArgs', 'AlertChannelConfigArgsDict']]] = None,
                  name: Optional[pulumi.Input[str]] = None,
                  type: Optional[pulumi.Input[str]] = None,
                  __props__=None):
@@ -509,8 +498,8 @@ class AlertChannel(pulumi.CustomResource):
     def get(resource_name: str,
             id: pulumi.Input[str],
             opts: Optional[pulumi.ResourceOptions] = None,
-            account_id: Optional[pulumi.Input[int]] = None,
-            config: Optional[pulumi.Input[pulumi.InputType['AlertChannelConfigArgs']]] = None,
+            account_id: Optional[pulumi.Input[str]] = None,
+            config: Optional[pulumi.Input[Union['AlertChannelConfigArgs', 'AlertChannelConfigArgsDict']]] = None,
             name: Optional[pulumi.Input[str]] = None,
             type: Optional[pulumi.Input[str]] = None) -> 'AlertChannel':
         """
@@ -520,8 +509,8 @@ class AlertChannel(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: Determines the New Relic account where the alert channel will be created. Defaults to the account associated with the API key used.
-        :param pulumi.Input[pulumi.InputType['AlertChannelConfigArgs']] config: A nested block that describes an alert channel configuration.  Only one config block is permitted per alert channel definition.  See Nested config blocks below for details.
+        :param pulumi.Input[str] account_id: Determines the New Relic account where the alert channel will be created. Defaults to the account associated with the API key used.
+        :param pulumi.Input[Union['AlertChannelConfigArgs', 'AlertChannelConfigArgsDict']] config: A nested block that describes an alert channel configuration.  Only one config block is permitted per alert channel definition.  See Nested config blocks below for details.
         :param pulumi.Input[str] name: The name of the channel.
         :param pulumi.Input[str] type: The type of channel.  One of: `email`, `slack`, `opsgenie`, `pagerduty`, `victorops`, or `webhook`.
         """
@@ -537,7 +526,7 @@ class AlertChannel(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="accountId")
-    def account_id(self) -> pulumi.Output[int]:
+    def account_id(self) -> pulumi.Output[str]:
         """
         Determines the New Relic account where the alert channel will be created. Defaults to the account associated with the API key used.
         """