pulumi-newrelic 5.16.0a1698964311__py3-none-any.whl → 5.58.0a1763707205__py3-none-any.whl

pulumi_newrelic/entity_tags.py

@@ -1,12 +1,17 @@
 # coding=utf-8
-# *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
+# *** WARNING: this file was generated by pulumi-language-python. ***
 # *** Do not edit by hand unless you're certain you know what you are doing! ***
 
-import copy
+import builtins as _builtins
 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 *
@@ -16,29 +21,29 @@ __all__ = ['EntityTagsArgs', 'EntityTags']
 @pulumi.input_type
 class EntityTagsArgs:
     def __init__(__self__, *,
-                 guid: pulumi.Input[str],
+                 guid: pulumi.Input[_builtins.str],
                  tags: pulumi.Input[Sequence[pulumi.Input['EntityTagsTagArgs']]]):
         """
         The set of arguments for constructing a EntityTags resource.
-        :param pulumi.Input[str] guid: The guid of the entity to tag.
+        :param pulumi.Input[_builtins.str] guid: The guid of the entity to tag.
         :param pulumi.Input[Sequence[pulumi.Input['EntityTagsTagArgs']]] tags: A nested block that describes an entity tag. See Nested tag blocks below for details.
         """
         pulumi.set(__self__, "guid", guid)
         pulumi.set(__self__, "tags", tags)
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def guid(self) -> pulumi.Input[str]:
+    def guid(self) -> pulumi.Input[_builtins.str]:
         """
         The guid of the entity to tag.
         """
         return pulumi.get(self, "guid")
 
     @guid.setter
-    def guid(self, value: pulumi.Input[str]):
+    def guid(self, value: pulumi.Input[_builtins.str]):
         pulumi.set(self, "guid", value)
 
-    @property
+    @_builtins.property
     @pulumi.getter
     def tags(self) -> pulumi.Input[Sequence[pulumi.Input['EntityTagsTagArgs']]]:
         """
@@ -54,11 +59,11 @@ class EntityTagsArgs:
 @pulumi.input_type
 class _EntityTagsState:
     def __init__(__self__, *,
-                 guid: Optional[pulumi.Input[str]] = None,
+                 guid: Optional[pulumi.Input[_builtins.str]] = None,
                  tags: Optional[pulumi.Input[Sequence[pulumi.Input['EntityTagsTagArgs']]]] = None):
         """
         Input properties used for looking up and filtering EntityTags resources.
-        :param pulumi.Input[str] guid: The guid of the entity to tag.
+        :param pulumi.Input[_builtins.str] guid: The guid of the entity to tag.
         :param pulumi.Input[Sequence[pulumi.Input['EntityTagsTagArgs']]] tags: A nested block that describes an entity tag. See Nested tag blocks below for details.
         """
         if guid is not None:
@@ -66,19 +71,19 @@ class _EntityTagsState:
         if tags is not None:
             pulumi.set(__self__, "tags", tags)
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def guid(self) -> Optional[pulumi.Input[str]]:
+    def guid(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
         The guid of the entity to tag.
         """
         return pulumi.get(self, "guid")
 
     @guid.setter
-    def guid(self, value: Optional[pulumi.Input[str]]):
+    def guid(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "guid", value)
 
-    @property
+    @_builtins.property
     @pulumi.getter
     def tags(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['EntityTagsTagArgs']]]]:
         """
@@ -91,29 +96,88 @@ class _EntityTagsState:
         pulumi.set(self, "tags", value)
 
 
+@pulumi.type_token("newrelic:index/entityTags:EntityTags")
 class EntityTags(pulumi.CustomResource):
     @overload
     def __init__(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
-                 guid: Optional[pulumi.Input[str]] = None,
-                 tags: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['EntityTagsTagArgs']]]]] = None,
+                 guid: Optional[pulumi.Input[_builtins.str]] = None,
+                 tags: Optional[pulumi.Input[Sequence[pulumi.Input[Union['EntityTagsTagArgs', 'EntityTagsTagArgsDict']]]]] = None,
                  __props__=None):
         """
+        Use this resource to create, update, and delete tags for a New Relic One entity.
+
+        ## Example Usage
+
+        ```python
+        import pulumi
+        import pulumi_newrelic as newrelic
+
+        foo = newrelic.get_entity(name="Example application",
+            type="APPLICATION",
+            domain="APM")
+        foo_entity_tags = newrelic.EntityTags("foo",
+            guid=foo.guid,
+            tags=[
+                {
+                    "key": "my-key",
+                    "values": [
+                        "my-value",
+                        "my-other-value",
+                    ],
+                },
+                {
+                    "key": "my-key-2",
+                    "values": ["my-value-2"],
+                },
+            ])
+        ```
+
+        ### Example of applying multiple tags to multiple entities using a nested `dynamic` block
+        ```python
+        import pulumi
+        import pulumi_newrelic as newrelic
+        import pulumi_std as std
+
+        apps = std.toset(input=[
+            "Example App Name 1",
+            "Example App Name 2",
+        ]).result
+        custom_tags = {
+            "tag-key-1": "tag-value-1",
+            "tag-key-2": "tag-value-2",
+            "tag-key-3": "tag-value-3",
+        }
+        foo = {__key: newrelic.get_entity(name=__key,
+            type="APPLICATION",
+            domain="APM") for __key, __value in apps}
+        foo_entity_tags = []
+        for range in [{"key": k, "value": v} for [k, v] in enumerate(apps)]:
+            foo_entity_tags.append(newrelic.EntityTags(f"foo-{range['key']}",
+                tags=[{
+                    "key": entry["key"],
+                    "values": [entry["value"]],
+                } for entry in [{"key": k, "value": v} for k, v in custom_tags]],
+                guid=foo[range["key"]].guid))
+        ```
+
         ## Import
 
         New Relic One entity tags can be imported using a concatenated string of the format
 
-        `<guid>`, e.g. bash
+         `<guid>`, e.g.
+
+        bash
 
         ```sh
-         $ pulumi import newrelic:index/entityTags:EntityTags foo MjUyMDUyOHxBUE18QVBRTElDQVRJT058MjE1MDM3Nzk1
+        $ pulumi import newrelic:index/entityTags:EntityTags foo MjUyMDUyOHxBUE18QVBRTElDQVRJT058MjE1MDM3Nzk1
         ```
 
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[str] guid: The guid of the entity to tag.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['EntityTagsTagArgs']]]] tags: A nested block that describes an entity tag. See Nested tag blocks below for details.
+        :param pulumi.Input[_builtins.str] guid: The guid of the entity to tag.
+        :param pulumi.Input[Sequence[pulumi.Input[Union['EntityTagsTagArgs', 'EntityTagsTagArgsDict']]]] tags: A nested block that describes an entity tag. See Nested tag blocks below for details.
         """
         ...
     @overload
@@ -122,14 +186,72 @@ class EntityTags(pulumi.CustomResource):
                  args: EntityTagsArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
+        Use this resource to create, update, and delete tags for a New Relic One entity.
+
+        ## Example Usage
+
+        ```python
+        import pulumi
+        import pulumi_newrelic as newrelic
+
+        foo = newrelic.get_entity(name="Example application",
+            type="APPLICATION",
+            domain="APM")
+        foo_entity_tags = newrelic.EntityTags("foo",
+            guid=foo.guid,
+            tags=[
+                {
+                    "key": "my-key",
+                    "values": [
+                        "my-value",
+                        "my-other-value",
+                    ],
+                },
+                {
+                    "key": "my-key-2",
+                    "values": ["my-value-2"],
+                },
+            ])
+        ```
+
+        ### Example of applying multiple tags to multiple entities using a nested `dynamic` block
+        ```python
+        import pulumi
+        import pulumi_newrelic as newrelic
+        import pulumi_std as std
+
+        apps = std.toset(input=[
+            "Example App Name 1",
+            "Example App Name 2",
+        ]).result
+        custom_tags = {
+            "tag-key-1": "tag-value-1",
+            "tag-key-2": "tag-value-2",
+            "tag-key-3": "tag-value-3",
+        }
+        foo = {__key: newrelic.get_entity(name=__key,
+            type="APPLICATION",
+            domain="APM") for __key, __value in apps}
+        foo_entity_tags = []
+        for range in [{"key": k, "value": v} for [k, v] in enumerate(apps)]:
+            foo_entity_tags.append(newrelic.EntityTags(f"foo-{range['key']}",
+                tags=[{
+                    "key": entry["key"],
+                    "values": [entry["value"]],
+                } for entry in [{"key": k, "value": v} for k, v in custom_tags]],
+                guid=foo[range["key"]].guid))
+        ```
+
         ## Import
 
         New Relic One entity tags can be imported using a concatenated string of the format
 
-        `<guid>`, e.g. bash
+         `<guid>`, e.g.
+
+        bash
 
         ```sh
-         $ pulumi import newrelic:index/entityTags:EntityTags foo MjUyMDUyOHxBUE18QVBRTElDQVRJT058MjE1MDM3Nzk1
+        $ pulumi import newrelic:index/entityTags:EntityTags foo MjUyMDUyOHxBUE18QVBRTElDQVRJT058MjE1MDM3Nzk1
         ```
 
         :param str resource_name: The name of the resource.
@@ -147,8 +269,8 @@ class EntityTags(pulumi.CustomResource):
     def _internal_init(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
-                 guid: Optional[pulumi.Input[str]] = None,
-                 tags: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['EntityTagsTagArgs']]]]] = None,
+                 guid: Optional[pulumi.Input[_builtins.str]] = None,
+                 tags: Optional[pulumi.Input[Sequence[pulumi.Input[Union['EntityTagsTagArgs', 'EntityTagsTagArgsDict']]]]] = None,
                  __props__=None):
         opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
         if not isinstance(opts, pulumi.ResourceOptions):
@@ -174,8 +296,8 @@ class EntityTags(pulumi.CustomResource):
     def get(resource_name: str,
             id: pulumi.Input[str],
             opts: Optional[pulumi.ResourceOptions] = None,
-            guid: Optional[pulumi.Input[str]] = None,
-            tags: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['EntityTagsTagArgs']]]]] = None) -> 'EntityTags':
+            guid: Optional[pulumi.Input[_builtins.str]] = None,
+            tags: Optional[pulumi.Input[Sequence[pulumi.Input[Union['EntityTagsTagArgs', 'EntityTagsTagArgsDict']]]]] = None) -> 'EntityTags':
         """
         Get an existing EntityTags resource's state with the given name, id, and optional extra
         properties used to qualify the lookup.
@@ -183,8 +305,8 @@ class EntityTags(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[str] guid: The guid of the entity to tag.
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['EntityTagsTagArgs']]]] tags: A nested block that describes an entity tag. See Nested tag blocks below for details.
+        :param pulumi.Input[_builtins.str] guid: The guid of the entity to tag.
+        :param pulumi.Input[Sequence[pulumi.Input[Union['EntityTagsTagArgs', 'EntityTagsTagArgsDict']]]] tags: A nested block that describes an entity tag. See Nested tag blocks below for details.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
 
@@ -194,15 +316,15 @@ class EntityTags(pulumi.CustomResource):
         __props__.__dict__["tags"] = tags
         return EntityTags(resource_name, opts=opts, __props__=__props__)
 
-    @property
+    @_builtins.property
     @pulumi.getter
-    def guid(self) -> pulumi.Output[str]:
+    def guid(self) -> pulumi.Output[_builtins.str]:
         """
         The guid of the entity to tag.
         """
         return pulumi.get(self, "guid")
 
-    @property
+    @_builtins.property
     @pulumi.getter
     def tags(self) -> pulumi.Output[Sequence['outputs.EntityTagsTag']]:
         """