pulumi-newrelic 5.26.0__tar.gz → 5.26.0a1717135317__tar.gz

{pulumi_newrelic-5.26.0 → pulumi_newrelic-5.26.0a1717135317}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pulumi_newrelic
-Version: 5.26.0
+Version: 5.26.0a1717135317
 Summary: A Pulumi package for creating and managing New Relic resources.
 License: Apache-2.0
 Project-URL: Homepage, https://pulumi.io

{pulumi_newrelic-5.26.0 → pulumi_newrelic-5.26.0a1717135317}/pulumi_newrelic/_inputs.py

@@ -1337,11 +1337,13 @@ class NrqlAlertConditionCriticalArgs:
 
     @property
     @pulumi.getter
-    @_utilities.deprecated("""use `threshold_duration` attribute instead""")
     def duration(self) -> Optional[pulumi.Input[int]]:
         """
         In minutes, must be in the range of 1 to 120 (inclusive).
         """
+        warnings.warn("""use `threshold_duration` attribute instead""", DeprecationWarning)
+        pulumi.log.warn("""duration is deprecated: use `threshold_duration` attribute instead""")
+
         return pulumi.get(self, "duration")
 
     @duration.setter
@@ -1386,11 +1388,13 @@ class NrqlAlertConditionCriticalArgs:
 
     @property
     @pulumi.getter(name="timeFunction")
-    @_utilities.deprecated("""use `threshold_occurrences` attribute instead""")
     def time_function(self) -> Optional[pulumi.Input[str]]:
         """
         Valid values are: 'all' or 'any'
         """
+        warnings.warn("""use `threshold_occurrences` attribute instead""", DeprecationWarning)
+        pulumi.log.warn("""time_function is deprecated: use `threshold_occurrences` attribute instead""")
+
         return pulumi.get(self, "time_function")
 
     @time_function.setter
@@ -1402,17 +1406,13 @@ class NrqlAlertConditionCriticalArgs:
 class NrqlAlertConditionNrqlArgs:
     def __init__(__self__, *,
                  query: pulumi.Input[str],
-                 data_account_id: Optional[pulumi.Input[str]] = None,
                  evaluation_offset: Optional[pulumi.Input[int]] = None,
                  since_value: Optional[pulumi.Input[str]] = None):
         """
-        :param pulumi.Input[str] data_account_id: BETA PREVIEW: the `data_account_id` field is in limited release and only enabled for preview on a per-account basis. - The New Relic account ID to use as the basis for the NRQL alert condition's `query`; will default to `account_id` if unspecified.
         :param pulumi.Input[int] evaluation_offset: NRQL queries are evaluated in one-minute time windows. The start time depends on the value you provide in the NRQL condition's `evaluation_offset`.
         :param pulumi.Input[str] since_value: NRQL queries are evaluated in one-minute time windows. The start time depends on the value you provide in the NRQL condition's `since_value`.
         """
         pulumi.set(__self__, "query", query)
-        if data_account_id is not None:
-            pulumi.set(__self__, "data_account_id", data_account_id)
         if evaluation_offset is not None:
             warnings.warn("""use `aggregation_method` attribute instead""", DeprecationWarning)
             pulumi.log.warn("""evaluation_offset is deprecated: use `aggregation_method` attribute instead""")
@@ -1433,25 +1433,15 @@ class NrqlAlertConditionNrqlArgs:
     def query(self, value: pulumi.Input[str]):
         pulumi.set(self, "query", value)
 
-    @property
-    @pulumi.getter(name="dataAccountId")
-    def data_account_id(self) -> Optional[pulumi.Input[str]]:
-        """
-        BETA PREVIEW: the `data_account_id` field is in limited release and only enabled for preview on a per-account basis. - The New Relic account ID to use as the basis for the NRQL alert condition's `query`; will default to `account_id` if unspecified.
-        """
-        return pulumi.get(self, "data_account_id")
-
-    @data_account_id.setter
-    def data_account_id(self, value: Optional[pulumi.Input[str]]):
-        pulumi.set(self, "data_account_id", value)
-
     @property
     @pulumi.getter(name="evaluationOffset")
-    @_utilities.deprecated("""use `aggregation_method` attribute instead""")
     def evaluation_offset(self) -> Optional[pulumi.Input[int]]:
         """
         NRQL queries are evaluated in one-minute time windows. The start time depends on the value you provide in the NRQL condition's `evaluation_offset`.
         """
+        warnings.warn("""use `aggregation_method` attribute instead""", DeprecationWarning)
+        pulumi.log.warn("""evaluation_offset is deprecated: use `aggregation_method` attribute instead""")
+
         return pulumi.get(self, "evaluation_offset")
 
     @evaluation_offset.setter
@@ -1460,11 +1450,13 @@ class NrqlAlertConditionNrqlArgs:
 
     @property
     @pulumi.getter(name="sinceValue")
-    @_utilities.deprecated("""use `aggregation_method` attribute instead""")
     def since_value(self) -> Optional[pulumi.Input[str]]:
         """
         NRQL queries are evaluated in one-minute time windows. The start time depends on the value you provide in the NRQL condition's `since_value`.
         """
+        warnings.warn("""use `aggregation_method` attribute instead""", DeprecationWarning)
+        pulumi.log.warn("""since_value is deprecated: use `aggregation_method` attribute instead""")
+
         return pulumi.get(self, "since_value")
 
     @since_value.setter
@@ -1525,11 +1517,13 @@ class NrqlAlertConditionTermArgs:
 
     @property
     @pulumi.getter
-    @_utilities.deprecated("""use `threshold_duration` attribute instead""")
     def duration(self) -> Optional[pulumi.Input[int]]:
         """
         In minutes, must be in the range of 1 to 120 (inclusive).
         """
+        warnings.warn("""use `threshold_duration` attribute instead""", DeprecationWarning)
+        pulumi.log.warn("""duration is deprecated: use `threshold_duration` attribute instead""")
+
         return pulumi.get(self, "duration")
 
     @duration.setter
@@ -1586,11 +1580,13 @@ class NrqlAlertConditionTermArgs:
 
     @property
     @pulumi.getter(name="timeFunction")
-    @_utilities.deprecated("""use `threshold_occurrences` attribute instead""")
     def time_function(self) -> Optional[pulumi.Input[str]]:
         """
         Valid values are: 'all' or 'any'
         """
+        warnings.warn("""use `threshold_occurrences` attribute instead""", DeprecationWarning)
+        pulumi.log.warn("""time_function is deprecated: use `threshold_occurrences` attribute instead""")
+
         return pulumi.get(self, "time_function")
 
     @time_function.setter
@@ -1647,11 +1643,13 @@ class NrqlAlertConditionWarningArgs:
 
     @property
     @pulumi.getter
-    @_utilities.deprecated("""use `threshold_duration` attribute instead""")
     def duration(self) -> Optional[pulumi.Input[int]]:
         """
         In minutes, must be in the range of 1 to 120 (inclusive).
         """
+        warnings.warn("""use `threshold_duration` attribute instead""", DeprecationWarning)
+        pulumi.log.warn("""duration is deprecated: use `threshold_duration` attribute instead""")
+
         return pulumi.get(self, "duration")
 
     @duration.setter
@@ -1696,11 +1694,13 @@ class NrqlAlertConditionWarningArgs:
 
     @property
     @pulumi.getter(name="timeFunction")
-    @_utilities.deprecated("""use `threshold_occurrences` attribute instead""")
     def time_function(self) -> Optional[pulumi.Input[str]]:
         """
         Valid values are: 'all' or 'any'
         """
+        warnings.warn("""use `threshold_occurrences` attribute instead""", DeprecationWarning)
+        pulumi.log.warn("""time_function is deprecated: use `threshold_occurrences` attribute instead""")
+
         return pulumi.get(self, "time_function")
 
     @time_function.setter

{pulumi_newrelic-5.26.0 → pulumi_newrelic-5.26.0a1717135317}/pulumi_newrelic/_utilities.py

@@ -4,7 +4,6 @@
 
 
 import asyncio
-import functools
 import importlib.metadata
 import importlib.util
 import inspect
@@ -12,7 +11,6 @@ import json
 import os
 import sys
 import typing
-import warnings
 
 import pulumi
 import pulumi.runtime
@@ -21,8 +19,6 @@ from pulumi.runtime.sync_await import _sync_await
 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:
@@ -291,36 +287,5 @@ 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

{pulumi_newrelic-5.26.0 → pulumi_newrelic-5.26.0a1717135317}/pulumi_newrelic/alert_channel.py

@@ -169,7 +169,7 @@ 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 a future major release**. As an alternative, you can set up channels using a combination of the newer resources `NotificationDestination` for a detailed illustration on setting up channels with these resources.
+        > **WARNING:** The `AlertChannel` resource is deprecated and will be removed in the next major release. For managing channel resources in Workflows, use `NotificationChannel`.
 
         ## Example Usage
 
@@ -317,7 +317,7 @@ 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 a future major release**. As an alternative, you can set up channels using a combination of the newer resources `NotificationDestination` for a detailed illustration on setting up channels with these resources.
+        > **WARNING:** The `AlertChannel` resource is deprecated and will be removed in the next major release. For managing channel resources in Workflows, use `NotificationChannel`.
 
         ## Example Usage
 

{pulumi_newrelic-5.26.0 → pulumi_newrelic-5.26.0a1717135317}/pulumi_newrelic/alert_policy.py

@@ -51,11 +51,13 @@ class AlertPolicyArgs:
 
     @property
     @pulumi.getter(name="channelIds")
-    @_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
@@ -127,11 +129,13 @@ class _AlertPolicyState:
 
     @property
     @pulumi.getter(name="channelIds")
-    @_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
@@ -446,11 +450,13 @@ class AlertPolicy(pulumi.CustomResource):
 
     @property
     @pulumi.getter(name="channelIds")
-    @_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

{pulumi_newrelic-5.26.0 → pulumi_newrelic-5.26.0a1717135317}/pulumi_newrelic/alert_policy_channel.py

@@ -133,7 +133,7 @@ class AlertPolicyChannel(pulumi.CustomResource):
         """
         Use this resource to map alert policies to alert channels in New Relic.
 
-        > **WARNING:** The `AlertPolicyChannel` resource is **deprecated** and will be **removed in a future major release**. As an alternative, you can map channels to policies using the resource `Workflow` for a detailed illustration on setting up channels and workflows with these resources.
+        > **WARNING:** The `AlertPolicyChannel` resource is deprecated and will be removed in the next major release. For managing channel resources in Workflows, use `NotificationChannel`.
 
         ## Example Usage
 
@@ -196,7 +196,7 @@ class AlertPolicyChannel(pulumi.CustomResource):
         """
         Use this resource to map alert policies to alert channels in New Relic.
 
-        > **WARNING:** The `AlertPolicyChannel` resource is **deprecated** and will be **removed in a future major release**. As an alternative, you can map channels to policies using the resource `Workflow` for a detailed illustration on setting up channels and workflows with these resources.
+        > **WARNING:** The `AlertPolicyChannel` resource is deprecated and will be removed in the next major release. For managing channel resources in Workflows, use `NotificationChannel`.
 
         ## Example Usage
 

{pulumi_newrelic-5.26.0 → pulumi_newrelic-5.26.0a1717135317}/pulumi_newrelic/get_entity.py

@@ -23,7 +23,7 @@ class GetEntityResult:
     """
     A collection of values returned by getEntity.
     """
-    def __init__(__self__, account_id=None, application_id=None, domain=None, entity_tags=None, guid=None, id=None, ignore_case=None, ignore_not_found=None, name=None, serving_apm_application_id=None, tags=None, type=None):
+    def __init__(__self__, account_id=None, application_id=None, domain=None, guid=None, id=None, ignore_case=None, ignore_not_found=None, name=None, serving_apm_application_id=None, tags=None, type=None):
         if account_id and not isinstance(account_id, str):
             raise TypeError("Expected argument 'account_id' to be a str")
         pulumi.set(__self__, "account_id", account_id)
@@ -33,9 +33,6 @@ class GetEntityResult:
         if domain and not isinstance(domain, str):
             raise TypeError("Expected argument 'domain' to be a str")
         pulumi.set(__self__, "domain", domain)
-        if entity_tags and not isinstance(entity_tags, str):
-            raise TypeError("Expected argument 'entity_tags' to be a str")
-        pulumi.set(__self__, "entity_tags", entity_tags)
         if guid and not isinstance(guid, str):
             raise TypeError("Expected argument 'guid' to be a str")
         pulumi.set(__self__, "guid", guid)
@@ -79,15 +76,6 @@ class GetEntityResult:
     def domain(self) -> str:
         return pulumi.get(self, "domain")
 
-    @property
-    @pulumi.getter(name="entityTags")
-    def entity_tags(self) -> str:
-        """
-        A JSON-encoded string, comprising tags associated with the entity fetched.
-        * See the **Additional Examples** section below, for an illustration depicting the usage of `jsondecode` with the attribute `entity_tags`, to get the tags associated with the entity fetched.
-        """
-        return pulumi.get(self, "entity_tags")
-
     @property
     @pulumi.getter
     def guid(self) -> str:
@@ -147,7 +135,6 @@ class AwaitableGetEntityResult(GetEntityResult):
             account_id=self.account_id,
             application_id=self.application_id,
             domain=self.domain,
-            entity_tags=self.entity_tags,
             guid=self.guid,
             id=self.id,
             ignore_case=self.ignore_case,
@@ -160,7 +147,6 @@ class AwaitableGetEntityResult(GetEntityResult):
 
 def get_entity(account_id: Optional[str] = None,
                domain: Optional[str] = None,
-               entity_tags: Optional[str] = None,
                ignore_case: Optional[bool] = None,
                ignore_not_found: Optional[bool] = None,
                name: Optional[str] = None,
@@ -168,12 +154,69 @@ def get_entity(account_id: Optional[str] = None,
                type: Optional[str] = None,
                opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetEntityResult:
     """
-    Use this data source to access information about an existing resource.
+    Use this data source to get information about a specific entity in New Relic One that already exists.
+
+    ### Example: Filter By Account ID
+
+    The default behaviour of this data source is to retrieve entities matching the specified parameters (such as `name`, `domain`, `type`) from NerdGraph with the credentials specified in the configuration of the provider (account ID and API Key), filter them by the account ID specified in the configuration of the provider, and return the first match.
+
+    This would mean, if no entity with the specified search parameters is found associated with the account ID in the configuration of the provider, i.e. `NEW_RELIC_ACCOUNT_ID`, an error is thrown, stating that no matching entity has been found.
+
+    ```python
+    import pulumi
+    import pulumi_newrelic as newrelic
+
+    # The entity returned by this configuration would have to 
+    # belong to the account_id specified in the provider 
+    # configuration, i.e. NEW_RELIC_ACCOUNT_ID.
+    app = newrelic.get_entity(name="my-app",
+        domain="APM",
+        type="APPLICATION")
+    ```
+    However, in order to cater to scenarios in which it could be necessary to retrieve an entity belonging to a subaccount using the account ID and API Key of the parent account (for instance, when entities with identical names are present in both the parent account and subaccounts, since matching entities from subaccounts too are returned by NerdGraph), the `account_id` attribute of this data source may be availed. This ensures that the account ID in the configuration of the provider, used to filter entities returned by the API is now overridden by the `account_id` specified in the configuration; i.e., in the below example, the data source would now return an entity matching the specified `name`, belonging to the account with the ID `account_id`.
+    ```python
+    import pulumi
+    import pulumi_newrelic as newrelic
+
+    # The entity returned by this configuration, unlike in 
+    # the above example, would have to belong to the account_id 
+    # specified in the configuration below, i.e. 654321.
+    app = newrelic.get_entity(name="my-app",
+        account_id="654321",
+        domain="APM",
+        type="APPLICATION")
+    ```
+    The following example explains a use case along the lines of the aforementioned; using the `account_id` argument in the data source to allow the filtering criteria to be the `account_id` specified (of the subaccount), and not the account ID in the provider configuration.
+
+    In simpler terms, when entities are queried from the parent account, entities with matching names are returned from subaccounts too, hence, specifying the `account_id` of the subaccount in the configuration allows the entity returned to belong to the subaccount with `account_id`.
+    ### Query for an OTEL entity
+
+    ```python
+    import pulumi
+    import pulumi_newrelic as newrelic
+
+    app = newrelic.get_entity(name="my-otel-app",
+        domain="EXT",
+        type="SERVICE",
+        tags=[newrelic.GetEntityTagArgs(
+            key="accountID",
+            value="12345",
+        )])
+    ```
+
+    ### Query for an entity by type (AWS Lambda entity in this example)
+
+    ```python
+    import pulumi
+    import pulumi_newrelic as newrelic
+
+    app = newrelic.get_entity(name="my_lambda_trace",
+        type="AWSLAMBDAFUNCTION")
+    ```
+
 
     :param str account_id: The New Relic account ID the entity to be returned would be associated with, i.e. if specified, the data source would filter matching entities received by `account_id` and return the first match. If not, matching entities are filtered by the account ID specified in the configuration of the provider. See the **Example: Filter By Account ID** section above for more details.
     :param str domain: The entity's domain. Valid values are APM, BROWSER, INFRA, MOBILE, SYNTH, and EXT. If not specified, all domains are searched.
-    :param str entity_tags: A JSON-encoded string, comprising tags associated with the entity fetched.
-           * See the **Additional Examples** section below, for an illustration depicting the usage of `jsondecode` with the attribute `entity_tags`, to get the tags associated with the entity fetched.
     :param bool ignore_case: Ignore case of the `name` when searching for the entity. Defaults to false.
     :param bool ignore_not_found: A boolean argument that, when set to true, prevents an error from being thrown when the queried entity is not found. Instead, a warning is displayed. Defaults to `false`.
            
@@ -185,7 +228,6 @@ def get_entity(account_id: Optional[str] = None,
     __args__ = dict()
     __args__['accountId'] = account_id
     __args__['domain'] = domain
-    __args__['entityTags'] = entity_tags
     __args__['ignoreCase'] = ignore_case
     __args__['ignoreNotFound'] = ignore_not_found
     __args__['name'] = name
@@ -198,7 +240,6 @@ def get_entity(account_id: Optional[str] = None,
         account_id=pulumi.get(__ret__, 'account_id'),
         application_id=pulumi.get(__ret__, 'application_id'),
         domain=pulumi.get(__ret__, 'domain'),
-        entity_tags=pulumi.get(__ret__, 'entity_tags'),
         guid=pulumi.get(__ret__, 'guid'),
         id=pulumi.get(__ret__, 'id'),
         ignore_case=pulumi.get(__ret__, 'ignore_case'),
@@ -212,7 +253,6 @@ def get_entity(account_id: Optional[str] = None,
 @_utilities.lift_output_func(get_entity)
 def get_entity_output(account_id: Optional[pulumi.Input[Optional[str]]] = None,
                       domain: Optional[pulumi.Input[Optional[str]]] = None,
-                      entity_tags: Optional[pulumi.Input[Optional[str]]] = None,
                       ignore_case: Optional[pulumi.Input[Optional[bool]]] = None,
                       ignore_not_found: Optional[pulumi.Input[Optional[bool]]] = None,
                       name: Optional[pulumi.Input[str]] = None,
@@ -220,12 +260,69 @@ def get_entity_output(account_id: Optional[pulumi.Input[Optional[str]]] = None,
                       type: Optional[pulumi.Input[Optional[str]]] = None,
                       opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetEntityResult]:
     """
-    Use this data source to access information about an existing resource.
+    Use this data source to get information about a specific entity in New Relic One that already exists.
+
+    ### Example: Filter By Account ID
+
+    The default behaviour of this data source is to retrieve entities matching the specified parameters (such as `name`, `domain`, `type`) from NerdGraph with the credentials specified in the configuration of the provider (account ID and API Key), filter them by the account ID specified in the configuration of the provider, and return the first match.
+
+    This would mean, if no entity with the specified search parameters is found associated with the account ID in the configuration of the provider, i.e. `NEW_RELIC_ACCOUNT_ID`, an error is thrown, stating that no matching entity has been found.
+
+    ```python
+    import pulumi
+    import pulumi_newrelic as newrelic
+
+    # The entity returned by this configuration would have to 
+    # belong to the account_id specified in the provider 
+    # configuration, i.e. NEW_RELIC_ACCOUNT_ID.
+    app = newrelic.get_entity(name="my-app",
+        domain="APM",
+        type="APPLICATION")
+    ```
+    However, in order to cater to scenarios in which it could be necessary to retrieve an entity belonging to a subaccount using the account ID and API Key of the parent account (for instance, when entities with identical names are present in both the parent account and subaccounts, since matching entities from subaccounts too are returned by NerdGraph), the `account_id` attribute of this data source may be availed. This ensures that the account ID in the configuration of the provider, used to filter entities returned by the API is now overridden by the `account_id` specified in the configuration; i.e., in the below example, the data source would now return an entity matching the specified `name`, belonging to the account with the ID `account_id`.
+    ```python
+    import pulumi
+    import pulumi_newrelic as newrelic
+
+    # The entity returned by this configuration, unlike in 
+    # the above example, would have to belong to the account_id 
+    # specified in the configuration below, i.e. 654321.
+    app = newrelic.get_entity(name="my-app",
+        account_id="654321",
+        domain="APM",
+        type="APPLICATION")
+    ```
+    The following example explains a use case along the lines of the aforementioned; using the `account_id` argument in the data source to allow the filtering criteria to be the `account_id` specified (of the subaccount), and not the account ID in the provider configuration.
+
+    In simpler terms, when entities are queried from the parent account, entities with matching names are returned from subaccounts too, hence, specifying the `account_id` of the subaccount in the configuration allows the entity returned to belong to the subaccount with `account_id`.
+    ### Query for an OTEL entity
+
+    ```python
+    import pulumi
+    import pulumi_newrelic as newrelic
+
+    app = newrelic.get_entity(name="my-otel-app",
+        domain="EXT",
+        type="SERVICE",
+        tags=[newrelic.GetEntityTagArgs(
+            key="accountID",
+            value="12345",
+        )])
+    ```
+
+    ### Query for an entity by type (AWS Lambda entity in this example)
+
+    ```python
+    import pulumi
+    import pulumi_newrelic as newrelic
+
+    app = newrelic.get_entity(name="my_lambda_trace",
+        type="AWSLAMBDAFUNCTION")
+    ```
+
 
     :param str account_id: The New Relic account ID the entity to be returned would be associated with, i.e. if specified, the data source would filter matching entities received by `account_id` and return the first match. If not, matching entities are filtered by the account ID specified in the configuration of the provider. See the **Example: Filter By Account ID** section above for more details.
     :param str domain: The entity's domain. Valid values are APM, BROWSER, INFRA, MOBILE, SYNTH, and EXT. If not specified, all domains are searched.
-    :param str entity_tags: A JSON-encoded string, comprising tags associated with the entity fetched.
-           * See the **Additional Examples** section below, for an illustration depicting the usage of `jsondecode` with the attribute `entity_tags`, to get the tags associated with the entity fetched.
     :param bool ignore_case: Ignore case of the `name` when searching for the entity. Defaults to false.
     :param bool ignore_not_found: A boolean argument that, when set to true, prevents an error from being thrown when the queried entity is not found. Instead, a warning is displayed. Defaults to `false`.
            

{pulumi_newrelic-5.26.0 → pulumi_newrelic-5.26.0a1717135317}/pulumi_newrelic/infra_alert_condition.py

@@ -595,7 +595,7 @@ class InfraAlertCondition(pulumi.CustomResource):
         """
         Use this resource to create and manage Infrastructure alert conditions in New Relic.
 
-        > **WARNING:** The `InfraAlertCondition` resource is deprecated and will be removed in the next major release. The resource NrqlAlertCondition examples.
+        > **WARNING:** The `InfraAlertCondition` resource is deprecated and will be removed in the next major release. The resource NrqlAlertCondition would be a preferred alternative to configure alert conditions - in most cases, feature parity can be achieved with a NRQL query.
 
         ## Example Usage
 
@@ -753,7 +753,7 @@ class InfraAlertCondition(pulumi.CustomResource):
         """
         Use this resource to create and manage Infrastructure alert conditions in New Relic.
 
-        > **WARNING:** The `InfraAlertCondition` resource is deprecated and will be removed in the next major release. The resource NrqlAlertCondition examples.
+        > **WARNING:** The `InfraAlertCondition` resource is deprecated and will be removed in the next major release. The resource NrqlAlertCondition would be a preferred alternative to configure alert conditions - in most cases, feature parity can be achieved with a NRQL query.
 
         ## Example Usage
 

{pulumi_newrelic-5.26.0 → pulumi_newrelic-5.26.0a1717135317}/pulumi_newrelic/notification_channel.py

@@ -573,12 +573,8 @@ class NotificationChannel(pulumi.CustomResource):
         ## Additional Information
 
         More details about the channels API can be found [here](https://docs.newrelic.com/docs/apis/nerdgraph/examples/nerdgraph-api-notifications-channels).
-        ### Moving from Legacy Alert Channels to Notification Channels
-        As described in the documentation of this resource, channels can be created and managed using `NotificationDestination`, which is **deprecated** and will be **removed in a future major release**, as stated in the documentation of the resource.
 
-        If you're currently using `AlertChannel` to manage channels, we **strongly recommend** migrating to these notifications-based resources at the earliest.
-
-        Please refer to the examples in this page, or this example for illustrations on setting up channels with these resources.
+        > **NOTE:** `AlertChannel` are legacy resources.
 
         ## Import
 
@@ -903,12 +899,8 @@ class NotificationChannel(pulumi.CustomResource):
         ## Additional Information
 
         More details about the channels API can be found [here](https://docs.newrelic.com/docs/apis/nerdgraph/examples/nerdgraph-api-notifications-channels).
-        ### Moving from Legacy Alert Channels to Notification Channels
-        As described in the documentation of this resource, channels can be created and managed using `NotificationDestination`, which is **deprecated** and will be **removed in a future major release**, as stated in the documentation of the resource.
-
-        If you're currently using `AlertChannel` to manage channels, we **strongly recommend** migrating to these notifications-based resources at the earliest.
 
-        Please refer to the examples in this page, or this example for illustrations on setting up channels with these resources.
+        > **NOTE:** `AlertChannel` are legacy resources.
 
         ## Import