PyPI - pulumi-newrelic - Versions diffs - 5.42.1__py3-none-any.whl → 5.58.0a1766556761__py3-none-any.whl - Mend

pulumi-newrelic 5.42.1py3-none-any.whl → 5.58.0a1766556761py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (92) hide show

pulumi_newrelic/__init__.py +19 -1
pulumi_newrelic/_inputs.py +4314 -3779
pulumi_newrelic/_utilities.py +1 -1
pulumi_newrelic/account_management.py +37 -36
pulumi_newrelic/alert_channel.py +63 -62
pulumi_newrelic/alert_condition.py +219 -218
pulumi_newrelic/alert_muting_rule.py +96 -95
pulumi_newrelic/alert_policy.py +71 -70
pulumi_newrelic/alert_policy_channel.py +54 -53
pulumi_newrelic/api_access_key.py +186 -201
pulumi_newrelic/browser_application.py +115 -114
pulumi_newrelic/cloud/__init__.py +3 -1
pulumi_newrelic/cloud/_inputs.py +2226 -2118
pulumi_newrelic/cloud/aws_govcloud_integrations.py +101 -96
pulumi_newrelic/cloud/aws_govcloud_link_account.py +71 -70
pulumi_newrelic/cloud/aws_integrations.py +240 -192
pulumi_newrelic/cloud/aws_link_account.py +71 -70
pulumi_newrelic/cloud/azure_integrations.py +180 -132
pulumi_newrelic/cloud/azure_link_account.py +105 -104
pulumi_newrelic/cloud/gcp_integrations.py +115 -114
pulumi_newrelic/cloud/gcp_link_account.py +56 -55
pulumi_newrelic/cloud/oci_link_account.py +926 -0
pulumi_newrelic/cloud/outputs.py +1512 -1410
pulumi_newrelic/config/__init__.py +2 -1
pulumi_newrelic/config/__init__.pyi +2 -2
pulumi_newrelic/config/vars.py +15 -15
pulumi_newrelic/data_partition_rule.py +114 -113
pulumi_newrelic/entity_tags.py +79 -22
pulumi_newrelic/events_to_metrics_rule.py +97 -96
pulumi_newrelic/get_account.py +22 -22
pulumi_newrelic/get_alert_channel.py +53 -21
pulumi_newrelic/get_alert_policy.py +52 -26
pulumi_newrelic/get_application.py +14 -14
pulumi_newrelic/get_authentication_domain.py +10 -10
pulumi_newrelic/get_cloud_account.py +22 -22
pulumi_newrelic/get_entity.py +53 -53
pulumi_newrelic/get_group.py +22 -22
pulumi_newrelic/get_key_transaction.py +26 -26
pulumi_newrelic/get_notification_destination.py +31 -31
pulumi_newrelic/get_obfuscation_expression.py +16 -16
pulumi_newrelic/get_service_level_alert_helper.py +54 -54
pulumi_newrelic/get_test_grok_pattern.py +23 -23
pulumi_newrelic/get_user.py +22 -22
pulumi_newrelic/group.py +54 -53
pulumi_newrelic/infra_alert_condition.py +257 -256
pulumi_newrelic/insights/__init__.py +2 -1
pulumi_newrelic/insights/_inputs.py +33 -33
pulumi_newrelic/insights/event.py +6 -5
pulumi_newrelic/insights/outputs.py +23 -23
pulumi_newrelic/key_transaction.py +106 -105
pulumi_newrelic/log_parsing_rule.py +148 -147
pulumi_newrelic/monitor_downtime.py +148 -154
pulumi_newrelic/notification_channel.py +218 -163
pulumi_newrelic/notification_destination.py +123 -136
pulumi_newrelic/nrql_alert_condition.py +513 -414
pulumi_newrelic/nrql_drop_rule.py +108 -147
pulumi_newrelic/obfuscation_expression.py +71 -70
pulumi_newrelic/obfuscation_rule.py +91 -90
pulumi_newrelic/one_dashboard.py +95 -94
pulumi_newrelic/one_dashboard_json.py +64 -63
pulumi_newrelic/one_dashboard_raw.py +116 -115
pulumi_newrelic/outputs.py +3026 -2665
pulumi_newrelic/pipeline_cloud_rule.py +335 -0
pulumi_newrelic/plugins/__init__.py +2 -1
pulumi_newrelic/plugins/_inputs.py +159 -159
pulumi_newrelic/plugins/application_settings.py +186 -171
pulumi_newrelic/plugins/outputs.py +109 -109
pulumi_newrelic/plugins/workload.py +133 -132
pulumi_newrelic/provider.py +136 -116
pulumi_newrelic/pulumi-plugin.json +1 -1
pulumi_newrelic/service_level.py +78 -77
pulumi_newrelic/synthetics/__init__.py +2 -1
pulumi_newrelic/synthetics/_inputs.py +128 -128
pulumi_newrelic/synthetics/alert_condition.py +97 -96
pulumi_newrelic/synthetics/broken_links_monitor.py +218 -189
pulumi_newrelic/synthetics/cert_check_monitor.py +226 -197
pulumi_newrelic/synthetics/get_private_location.py +22 -22
pulumi_newrelic/synthetics/get_secure_credential.py +20 -20
pulumi_newrelic/synthetics/monitor.py +399 -370
pulumi_newrelic/synthetics/multi_location_alert_condition.py +120 -119
pulumi_newrelic/synthetics/outputs.py +86 -86
pulumi_newrelic/synthetics/private_location.py +107 -106
pulumi_newrelic/synthetics/script_monitor.py +385 -294
pulumi_newrelic/synthetics/secure_credential.py +88 -87
pulumi_newrelic/synthetics/step_monitor.py +241 -212
pulumi_newrelic/user.py +71 -70
pulumi_newrelic/workflow.py +141 -140
{pulumi_newrelic-5.42.1.dist-info → pulumi_newrelic-5.58.0a1766556761.dist-info}/METADATA +4 -4
pulumi_newrelic-5.58.0a1766556761.dist-info/RECORD +92 -0
{pulumi_newrelic-5.42.1.dist-info → pulumi_newrelic-5.58.0a1766556761.dist-info}/WHEEL +1 -1
pulumi_newrelic-5.42.1.dist-info/RECORD +0 -90
{pulumi_newrelic-5.42.1.dist-info → pulumi_newrelic-5.58.0a1766556761.dist-info}/top_level.txt +0 -0

pulumi_newrelic/api_access_key.py CHANGED Viewed

@@ -1,8 +1,8 @@
 # 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
@@ -19,23 +19,25 @@ __all__ = ['ApiAccessKeyArgs', 'ApiAccessKey']
 @pulumi.input_type
 class ApiAccessKeyArgs:
     def __init__(__self__, *,
-                 account_id: pulumi.Input[str],
-                 key_type: pulumi.Input[str],
-                 ingest_type: Optional[pulumi.Input[str]] = None,
-                 name: Optional[pulumi.Input[str]] = None,
-                 notes: Optional[pulumi.Input[str]] = None,
-                 user_id: Optional[pulumi.Input[str]] = None):
+                 key_type: pulumi.Input[_builtins.str],
+                 account_id: Optional[pulumi.Input[_builtins.str]] = None,
+                 ingest_type: Optional[pulumi.Input[_builtins.str]] = None,
+                 name: Optional[pulumi.Input[_builtins.str]] = None,
+                 notes: Optional[pulumi.Input[_builtins.str]] = None,
+                 user_id: Optional[pulumi.Input[_builtins.str]] = None):
         """
         The set of arguments for constructing a ApiAccessKey resource.
-        :param pulumi.Input[str] account_id: The New Relic account ID of the account you wish to create the API access key.
-        :param pulumi.Input[str] key_type: What type of API key to create. Valid options are `INGEST` or `USER`, case-sensitive.
-        :param pulumi.Input[str] ingest_type: Required if `key_type = INGEST`. Valid options are `BROWSER` or `LICENSE`, case-sensitive.
-        :param pulumi.Input[str] name: The name of the key.
-        :param pulumi.Input[str] notes: Any notes about this ingest key.
-        :param pulumi.Input[str] user_id: Required if `key_type = USER`. The New Relic user ID yous wish to create the API access key for in an account.
-        """
-        pulumi.set(__self__, "account_id", account_id)
+        :param pulumi.Input[_builtins.str] key_type: The type of API key to create. Valid options are `INGEST` or `USER` (case-sensitive).
+               - If `key_type` is `INGEST`, then `ingest_type` must be specified.
+               - If `key_type` is `USER`, then `user_id` must be specified.
+        :param pulumi.Input[_builtins.str] account_id: The New Relic account ID where the API access key will be created.
+        :param pulumi.Input[_builtins.str] ingest_type: Required if `key_type` is `INGEST`. Valid options are `BROWSER` or `LICENSE` (case-sensitive).
+        :param pulumi.Input[_builtins.str] notes: Additional notes about the API access key.
+        :param pulumi.Input[_builtins.str] user_id: Required if `key_type` is `USER`. The New Relic user ID for which the API access key will be created.
+        """
         pulumi.set(__self__, "key_type", key_type)
+        if account_id is not None:
+            pulumi.set(__self__, "account_id", account_id)
         if ingest_type is not None:
             pulumi.set(__self__, "ingest_type", ingest_type)
         if name is not None:
@@ -45,98 +47,99 @@ class ApiAccessKeyArgs:
         if user_id is not None:
             pulumi.set(__self__, "user_id", user_id)
-    @property
-    @pulumi.getter(name="accountId")
-    def account_id(self) -> pulumi.Input[str]:
-        """
-        The New Relic account ID of the account you wish to create the API access key.
-        """
-        return pulumi.get(self, "account_id")
-    @account_id.setter
-    def account_id(self, value: pulumi.Input[str]):
-        pulumi.set(self, "account_id", value)
-    @property
+    @_builtins.property
     @pulumi.getter(name="keyType")
-    def key_type(self) -> pulumi.Input[str]:
+    def key_type(self) -> pulumi.Input[_builtins.str]:
         """
-        What type of API key to create. Valid options are `INGEST` or `USER`, case-sensitive.
+        The type of API key to create. Valid options are `INGEST` or `USER` (case-sensitive).
+        - If `key_type` is `INGEST`, then `ingest_type` must be specified.
+        - If `key_type` is `USER`, then `user_id` must be specified.
         """
         return pulumi.get(self, "key_type")
     @key_type.setter
-    def key_type(self, value: pulumi.Input[str]):
+    def key_type(self, value: pulumi.Input[_builtins.str]):
         pulumi.set(self, "key_type", value)
-    @property
+    @_builtins.property
+    @pulumi.getter(name="accountId")
+    def account_id(self) -> Optional[pulumi.Input[_builtins.str]]:
+        """
+        The New Relic account ID where the API access key will be created.
+        """
+        return pulumi.get(self, "account_id")
+    @account_id.setter
+    def account_id(self, value: Optional[pulumi.Input[_builtins.str]]):
+        pulumi.set(self, "account_id", value)
+    @_builtins.property
     @pulumi.getter(name="ingestType")
-    def ingest_type(self) -> Optional[pulumi.Input[str]]:
+    def ingest_type(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
-        Required if `key_type = INGEST`. Valid options are `BROWSER` or `LICENSE`, case-sensitive.
+        Required if `key_type` is `INGEST`. Valid options are `BROWSER` or `LICENSE` (case-sensitive).
         """
         return pulumi.get(self, "ingest_type")
     @ingest_type.setter
-    def ingest_type(self, value: Optional[pulumi.Input[str]]):
+    def ingest_type(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "ingest_type", value)
-    @property
+    @_builtins.property
     @pulumi.getter
-    def name(self) -> Optional[pulumi.Input[str]]:
-        """
-        The name of the key.
-        """
+    def name(self) -> Optional[pulumi.Input[_builtins.str]]:
         return pulumi.get(self, "name")
     @name.setter
-    def name(self, value: Optional[pulumi.Input[str]]):
+    def name(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "name", value)
-    @property
+    @_builtins.property
     @pulumi.getter
-    def notes(self) -> Optional[pulumi.Input[str]]:
+    def notes(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
-        Any notes about this ingest key.
+        Additional notes about the API access key.
         """
         return pulumi.get(self, "notes")
     @notes.setter
-    def notes(self, value: Optional[pulumi.Input[str]]):
+    def notes(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "notes", value)
-    @property
+    @_builtins.property
     @pulumi.getter(name="userId")
-    def user_id(self) -> Optional[pulumi.Input[str]]:
+    def user_id(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
-        Required if `key_type = USER`. The New Relic user ID yous wish to create the API access key for in an account.
+        Required if `key_type` is `USER`. The New Relic user ID for which the API access key will be created.
         """
         return pulumi.get(self, "user_id")
     @user_id.setter
-    def user_id(self, value: Optional[pulumi.Input[str]]):
+    def user_id(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "user_id", value)
 @pulumi.input_type
 class _ApiAccessKeyState:
     def __init__(__self__, *,
-                 account_id: Optional[pulumi.Input[str]] = None,
-                 ingest_type: Optional[pulumi.Input[str]] = None,
-                 key: Optional[pulumi.Input[str]] = None,
-                 key_type: Optional[pulumi.Input[str]] = None,
-                 name: Optional[pulumi.Input[str]] = None,
-                 notes: Optional[pulumi.Input[str]] = None,
-                 user_id: Optional[pulumi.Input[str]] = None):
+                 account_id: Optional[pulumi.Input[_builtins.str]] = None,
+                 ingest_type: Optional[pulumi.Input[_builtins.str]] = None,
+                 key: Optional[pulumi.Input[_builtins.str]] = None,
+                 key_type: Optional[pulumi.Input[_builtins.str]] = None,
+                 name: Optional[pulumi.Input[_builtins.str]] = None,
+                 notes: Optional[pulumi.Input[_builtins.str]] = None,
+                 user_id: Optional[pulumi.Input[_builtins.str]] = None):
         """
         Input properties used for looking up and filtering ApiAccessKey resources.
-        :param pulumi.Input[str] account_id: The New Relic account ID of the account you wish to create the API access key.
-        :param pulumi.Input[str] ingest_type: Required if `key_type = INGEST`. Valid options are `BROWSER` or `LICENSE`, case-sensitive.
-        :param pulumi.Input[str] key: The actual API key. This attribute is masked and not be visible in your terminal, CI, etc.
-        :param pulumi.Input[str] key_type: What type of API key to create. Valid options are `INGEST` or `USER`, case-sensitive.
-        :param pulumi.Input[str] name: The name of the key.
-        :param pulumi.Input[str] notes: Any notes about this ingest key.
-        :param pulumi.Input[str] user_id: Required if `key_type = USER`. The New Relic user ID yous wish to create the API access key for in an account.
+        :param pulumi.Input[_builtins.str] account_id: The New Relic account ID where the API access key will be created.
+        :param pulumi.Input[_builtins.str] ingest_type: Required if `key_type` is `INGEST`. Valid options are `BROWSER` or `LICENSE` (case-sensitive).
+        :param pulumi.Input[_builtins.str] key: The actual API key.
+               - <span style="color:tomato;">It is important to exercise caution when exporting the value of `key`, as it is sensitive information</span>. Avoid logging or exposing it inappropriately.
+        :param pulumi.Input[_builtins.str] key_type: The type of API key to create. Valid options are `INGEST` or `USER` (case-sensitive).
+               - If `key_type` is `INGEST`, then `ingest_type` must be specified.
+               - If `key_type` is `USER`, then `user_id` must be specified.
+        :param pulumi.Input[_builtins.str] notes: Additional notes about the API access key.
+        :param pulumi.Input[_builtins.str] user_id: Required if `key_type` is `USER`. The New Relic user ID for which the API access key will be created.
         """
         if account_id is not None:
             pulumi.set(__self__, "account_id", account_id)
@@ -153,147 +156,140 @@ class _ApiAccessKeyState:
         if user_id is not None:
             pulumi.set(__self__, "user_id", user_id)
-    @property
+    @_builtins.property
     @pulumi.getter(name="accountId")
-    def account_id(self) -> Optional[pulumi.Input[str]]:
+    def account_id(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
-        The New Relic account ID of the account you wish to create the API access key.
+        The New Relic account ID where the API access key will be created.
         """
         return pulumi.get(self, "account_id")
     @account_id.setter
-    def account_id(self, value: Optional[pulumi.Input[str]]):
+    def account_id(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "account_id", value)
-    @property
+    @_builtins.property
     @pulumi.getter(name="ingestType")
-    def ingest_type(self) -> Optional[pulumi.Input[str]]:
+    def ingest_type(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
-        Required if `key_type = INGEST`. Valid options are `BROWSER` or `LICENSE`, case-sensitive.
+        Required if `key_type` is `INGEST`. Valid options are `BROWSER` or `LICENSE` (case-sensitive).
         """
         return pulumi.get(self, "ingest_type")
     @ingest_type.setter
-    def ingest_type(self, value: Optional[pulumi.Input[str]]):
+    def ingest_type(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "ingest_type", value)
-    @property
+    @_builtins.property
     @pulumi.getter
-    def key(self) -> Optional[pulumi.Input[str]]:
+    def key(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
-        The actual API key. This attribute is masked and not be visible in your terminal, CI, etc.
+        The actual API key.
+        - <span style="color:tomato;">It is important to exercise caution when exporting the value of `key`, as it is sensitive information</span>. Avoid logging or exposing it inappropriately.
         """
         return pulumi.get(self, "key")
     @key.setter
-    def key(self, value: Optional[pulumi.Input[str]]):
+    def key(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "key", value)
-    @property
+    @_builtins.property
     @pulumi.getter(name="keyType")
-    def key_type(self) -> Optional[pulumi.Input[str]]:
+    def key_type(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
-        What type of API key to create. Valid options are `INGEST` or `USER`, case-sensitive.
+        The type of API key to create. Valid options are `INGEST` or `USER` (case-sensitive).
+        - If `key_type` is `INGEST`, then `ingest_type` must be specified.
+        - If `key_type` is `USER`, then `user_id` must be specified.
         """
         return pulumi.get(self, "key_type")
     @key_type.setter
-    def key_type(self, value: Optional[pulumi.Input[str]]):
+    def key_type(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "key_type", value)
-    @property
+    @_builtins.property
     @pulumi.getter
-    def name(self) -> Optional[pulumi.Input[str]]:
-        """
-        The name of the key.
-        """
+    def name(self) -> Optional[pulumi.Input[_builtins.str]]:
         return pulumi.get(self, "name")
     @name.setter
-    def name(self, value: Optional[pulumi.Input[str]]):
+    def name(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "name", value)
-    @property
+    @_builtins.property
     @pulumi.getter
-    def notes(self) -> Optional[pulumi.Input[str]]:
+    def notes(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
-        Any notes about this ingest key.
+        Additional notes about the API access key.
         """
         return pulumi.get(self, "notes")
     @notes.setter
-    def notes(self, value: Optional[pulumi.Input[str]]):
+    def notes(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "notes", value)
-    @property
+    @_builtins.property
     @pulumi.getter(name="userId")
-    def user_id(self) -> Optional[pulumi.Input[str]]:
+    def user_id(self) -> Optional[pulumi.Input[_builtins.str]]:
         """
-        Required if `key_type = USER`. The New Relic user ID yous wish to create the API access key for in an account.
+        Required if `key_type` is `USER`. The New Relic user ID for which the API access key will be created.
         """
         return pulumi.get(self, "user_id")
     @user_id.setter
-    def user_id(self, value: Optional[pulumi.Input[str]]):
+    def user_id(self, value: Optional[pulumi.Input[_builtins.str]]):
         pulumi.set(self, "user_id", value)
+@pulumi.type_token("newrelic:index/apiAccessKey:ApiAccessKey")
 class ApiAccessKey(pulumi.CustomResource):
     @overload
     def __init__(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
-                 account_id: Optional[pulumi.Input[str]] = None,
-                 ingest_type: Optional[pulumi.Input[str]] = None,
-                 key_type: Optional[pulumi.Input[str]] = None,
-                 name: Optional[pulumi.Input[str]] = None,
-                 notes: Optional[pulumi.Input[str]] = None,
-                 user_id: Optional[pulumi.Input[str]] = None,
+                 account_id: Optional[pulumi.Input[_builtins.str]] = None,
+                 ingest_type: Optional[pulumi.Input[_builtins.str]] = None,
+                 key_type: Optional[pulumi.Input[_builtins.str]] = None,
+                 name: Optional[pulumi.Input[_builtins.str]] = None,
+                 notes: Optional[pulumi.Input[_builtins.str]] = None,
+                 user_id: Optional[pulumi.Input[_builtins.str]] = None,
                  __props__=None):
         """
-        Use this resource to programmatically create and manage the following types of keys:
-        - [User API keys](https://docs.newrelic.com/docs/apis/get-started/intro-apis/types-new-relic-api-keys#user-api-key)
-        - License (or ingest) keys, including:
-            - General [license key](https://docs.newrelic.com/docs/accounts/install-new-relic/account-setup/license-key) used for APM
-            - [Browser license key](https://docs.newrelic.com/docs/browser/new-relic-browser/configuration/copy-browser-monitoring-license-key-app-id)
+        ## Import
-        Please visit the New Relic article ['Use NerdGraph to manage license keys and User API keys'](https://docs.newrelic.com/docs/apis/nerdgraph/examples/use-nerdgraph-manage-license-keys-user-keys)
-        for more information.
+        Existing API access keys can be imported using a composite ID of `<api_access_key_id>:<key_type>`, where `<key_type>` is either `INGEST` or `USER`. Refer to the considerations listed in the Important Considerations section above regarding limitations on importing the actual key value.
-        > **IMPORTANT!**
-        Please be very careful when updating existing `ApiAccessKey` resources as only `newrelic_api_access_key.name`
-        and `newrelic_api_access_key.notes` are updatable. All other resource attributes will force a resource recreation which will
-        invalidate the previous API key(s).
+        For example:
-        ## Example Usage
+        ```sh
+        $ pulumi import newrelic:index/apiAccessKey:ApiAccessKey foobar "131313133A331313130B5F13DF01313FDB13B13133EE5E133D13EAAB3A3C13D3:INGEST"
+        ```
-        > **WARNING:** Creating 'Ingest - License' and 'Ingest - Browser' keys using this resource is restricted to 'core' or 'full platform' New Relic user accounts. If you've signed up as a 'basic' user with New Relic, or have been added as a 'basic' user to your organization on New Relic, you would not be able to use your account to create 'Ingest' keys. If you see the message `"You do not have permission to create this key"` in the response of the API called by this resource, it could be owing to the aforementioned. For more insights into user account types on New Relic and associated privileges, please check out this [page](https://docs.newrelic.com/docs/accounts/accounts-billing/new-relic-one-user-management/user-type/#api-access).
+        For customers using Terraform v1.5 and above, it is recommended to use the `import {}` block in your Terraform configuration. This allows Terraform to generate the resource configuration automatically during the import process by running a `pulumi preview -generate-config-out=<filename>.tf`, reducing manual effort and ensuring accuracy.
-        ## Extended Usage
+        For example:
-        This module may be used to create a user or ingest key using the `create_access_keys_service` resource, and fetch the created key using `fetch_access_keys_service`, by performing a NerdGraph query under the hood, using the ID of the key created via the resource to fetch the created key.
-        Please refer\\
-        create access keys and fetch access keys for more info.
+        hcl
-        ## Import
+        import {
-        Existing API access keys can be imported using a composite ID of `<api_access_key_id>:<key_type>`. `<key_type>`
-        will be either `INGEST` or `USER`.
+          id = "131313133A331313130B5F13DF01313FDB13B13133EE5E133D13EAAB3A3C13D3:INGEST"
-        For example:
+          to = newrelic_api_access_key.foobar
-        ```sh
-        $ pulumi import newrelic:index/apiAccessKey:ApiAccessKey foobar "1234567:INGEST"
-        ```
+        }
+        This approach simplifies the import process and ensures that the resource configuration aligns with the imported state.
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[str] account_id: The New Relic account ID of the account you wish to create the API access key.
-        :param pulumi.Input[str] ingest_type: Required if `key_type = INGEST`. Valid options are `BROWSER` or `LICENSE`, case-sensitive.
-        :param pulumi.Input[str] key_type: What type of API key to create. Valid options are `INGEST` or `USER`, case-sensitive.
-        :param pulumi.Input[str] name: The name of the key.
-        :param pulumi.Input[str] notes: Any notes about this ingest key.
-        :param pulumi.Input[str] user_id: Required if `key_type = USER`. The New Relic user ID yous wish to create the API access key for in an account.
+        :param pulumi.Input[_builtins.str] account_id: The New Relic account ID where the API access key will be created.
+        :param pulumi.Input[_builtins.str] ingest_type: Required if `key_type` is `INGEST`. Valid options are `BROWSER` or `LICENSE` (case-sensitive).
+        :param pulumi.Input[_builtins.str] key_type: The type of API key to create. Valid options are `INGEST` or `USER` (case-sensitive).
+               - If `key_type` is `INGEST`, then `ingest_type` must be specified.
+               - If `key_type` is `USER`, then `user_id` must be specified.
+        :param pulumi.Input[_builtins.str] notes: Additional notes about the API access key.
+        :param pulumi.Input[_builtins.str] user_id: Required if `key_type` is `USER`. The New Relic user ID for which the API access key will be created.
         """
         ...
     @overload
@@ -302,40 +298,31 @@ class ApiAccessKey(pulumi.CustomResource):
                  args: ApiAccessKeyArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Use this resource to programmatically create and manage the following types of keys:
-        - [User API keys](https://docs.newrelic.com/docs/apis/get-started/intro-apis/types-new-relic-api-keys#user-api-key)
-        - License (or ingest) keys, including:
-            - General [license key](https://docs.newrelic.com/docs/accounts/install-new-relic/account-setup/license-key) used for APM
-            - [Browser license key](https://docs.newrelic.com/docs/browser/new-relic-browser/configuration/copy-browser-monitoring-license-key-app-id)
+        ## Import
-        Please visit the New Relic article ['Use NerdGraph to manage license keys and User API keys'](https://docs.newrelic.com/docs/apis/nerdgraph/examples/use-nerdgraph-manage-license-keys-user-keys)
-        for more information.
+        Existing API access keys can be imported using a composite ID of `<api_access_key_id>:<key_type>`, where `<key_type>` is either `INGEST` or `USER`. Refer to the considerations listed in the Important Considerations section above regarding limitations on importing the actual key value.
-        > **IMPORTANT!**
-        Please be very careful when updating existing `ApiAccessKey` resources as only `newrelic_api_access_key.name`
-        and `newrelic_api_access_key.notes` are updatable. All other resource attributes will force a resource recreation which will
-        invalidate the previous API key(s).
+        For example:
-        ## Example Usage
+        ```sh
+        $ pulumi import newrelic:index/apiAccessKey:ApiAccessKey foobar "131313133A331313130B5F13DF01313FDB13B13133EE5E133D13EAAB3A3C13D3:INGEST"
+        ```
-        > **WARNING:** Creating 'Ingest - License' and 'Ingest - Browser' keys using this resource is restricted to 'core' or 'full platform' New Relic user accounts. If you've signed up as a 'basic' user with New Relic, or have been added as a 'basic' user to your organization on New Relic, you would not be able to use your account to create 'Ingest' keys. If you see the message `"You do not have permission to create this key"` in the response of the API called by this resource, it could be owing to the aforementioned. For more insights into user account types on New Relic and associated privileges, please check out this [page](https://docs.newrelic.com/docs/accounts/accounts-billing/new-relic-one-user-management/user-type/#api-access).
+        For customers using Terraform v1.5 and above, it is recommended to use the `import {}` block in your Terraform configuration. This allows Terraform to generate the resource configuration automatically during the import process by running a `pulumi preview -generate-config-out=<filename>.tf`, reducing manual effort and ensuring accuracy.
-        ## Extended Usage
+        For example:
-        This module may be used to create a user or ingest key using the `create_access_keys_service` resource, and fetch the created key using `fetch_access_keys_service`, by performing a NerdGraph query under the hood, using the ID of the key created via the resource to fetch the created key.
-        Please refer\\
-        create access keys and fetch access keys for more info.
+        hcl
-        ## Import
+        import {
-        Existing API access keys can be imported using a composite ID of `<api_access_key_id>:<key_type>`. `<key_type>`
-        will be either `INGEST` or `USER`.
+          id = "131313133A331313130B5F13DF01313FDB13B13133EE5E133D13EAAB3A3C13D3:INGEST"
-        For example:
+          to = newrelic_api_access_key.foobar
-        ```sh
-        $ pulumi import newrelic:index/apiAccessKey:ApiAccessKey foobar "1234567:INGEST"
-        ```
+        }
+        This approach simplifies the import process and ensures that the resource configuration aligns with the imported state.
         :param str resource_name: The name of the resource.
         :param ApiAccessKeyArgs args: The arguments to use to populate this resource's properties.
@@ -352,12 +339,12 @@ class ApiAccessKey(pulumi.CustomResource):
     def _internal_init(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
-                 account_id: Optional[pulumi.Input[str]] = None,
-                 ingest_type: Optional[pulumi.Input[str]] = None,
-                 key_type: Optional[pulumi.Input[str]] = None,
-                 name: Optional[pulumi.Input[str]] = None,
-                 notes: Optional[pulumi.Input[str]] = None,
-                 user_id: Optional[pulumi.Input[str]] = None,
+                 account_id: Optional[pulumi.Input[_builtins.str]] = None,
+                 ingest_type: Optional[pulumi.Input[_builtins.str]] = None,
+                 key_type: Optional[pulumi.Input[_builtins.str]] = None,
+                 name: Optional[pulumi.Input[_builtins.str]] = None,
+                 notes: Optional[pulumi.Input[_builtins.str]] = None,
+                 user_id: Optional[pulumi.Input[_builtins.str]] = None,
                  __props__=None):
         opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
         if not isinstance(opts, pulumi.ResourceOptions):
@@ -367,8 +354,6 @@ class ApiAccessKey(pulumi.CustomResource):
                 raise TypeError('__props__ is only valid when passed in combination with a valid opts.id to get an existing resource')
             __props__ = ApiAccessKeyArgs.__new__(ApiAccessKeyArgs)
-            if account_id is None and not opts.urn:
-                raise TypeError("Missing required property 'account_id'")
             __props__.__dict__["account_id"] = account_id
             __props__.__dict__["ingest_type"] = ingest_type
             if key_type is None and not opts.urn:
@@ -378,8 +363,6 @@ class ApiAccessKey(pulumi.CustomResource):
             __props__.__dict__["notes"] = notes
             __props__.__dict__["user_id"] = user_id
             __props__.__dict__["key"] = None
-        secret_opts = pulumi.ResourceOptions(additional_secret_outputs=["key"])
-        opts = pulumi.ResourceOptions.merge(opts, secret_opts)
         super(ApiAccessKey, __self__).__init__(
             'newrelic:index/apiAccessKey:ApiAccessKey',
             resource_name,
@@ -390,13 +373,13 @@ class ApiAccessKey(pulumi.CustomResource):
     def get(resource_name: str,
             id: pulumi.Input[str],
             opts: Optional[pulumi.ResourceOptions] = None,
-            account_id: Optional[pulumi.Input[str]] = None,
-            ingest_type: Optional[pulumi.Input[str]] = None,
-            key: Optional[pulumi.Input[str]] = None,
-            key_type: Optional[pulumi.Input[str]] = None,
-            name: Optional[pulumi.Input[str]] = None,
-            notes: Optional[pulumi.Input[str]] = None,
-            user_id: Optional[pulumi.Input[str]] = None) -> 'ApiAccessKey':
+            account_id: Optional[pulumi.Input[_builtins.str]] = None,
+            ingest_type: Optional[pulumi.Input[_builtins.str]] = None,
+            key: Optional[pulumi.Input[_builtins.str]] = None,
+            key_type: Optional[pulumi.Input[_builtins.str]] = None,
+            name: Optional[pulumi.Input[_builtins.str]] = None,
+            notes: Optional[pulumi.Input[_builtins.str]] = None,
+            user_id: Optional[pulumi.Input[_builtins.str]] = None) -> 'ApiAccessKey':
         """
         Get an existing ApiAccessKey resource's state with the given name, id, and optional extra
         properties used to qualify the lookup.
@@ -404,13 +387,15 @@ class ApiAccessKey(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] account_id: The New Relic account ID of the account you wish to create the API access key.
-        :param pulumi.Input[str] ingest_type: Required if `key_type = INGEST`. Valid options are `BROWSER` or `LICENSE`, case-sensitive.
-        :param pulumi.Input[str] key: The actual API key. This attribute is masked and not be visible in your terminal, CI, etc.
-        :param pulumi.Input[str] key_type: What type of API key to create. Valid options are `INGEST` or `USER`, case-sensitive.
-        :param pulumi.Input[str] name: The name of the key.
-        :param pulumi.Input[str] notes: Any notes about this ingest key.
-        :param pulumi.Input[str] user_id: Required if `key_type = USER`. The New Relic user ID yous wish to create the API access key for in an account.
+        :param pulumi.Input[_builtins.str] account_id: The New Relic account ID where the API access key will be created.
+        :param pulumi.Input[_builtins.str] ingest_type: Required if `key_type` is `INGEST`. Valid options are `BROWSER` or `LICENSE` (case-sensitive).
+        :param pulumi.Input[_builtins.str] key: The actual API key.
+               - <span style="color:tomato;">It is important to exercise caution when exporting the value of `key`, as it is sensitive information</span>. Avoid logging or exposing it inappropriately.
+        :param pulumi.Input[_builtins.str] key_type: The type of API key to create. Valid options are `INGEST` or `USER` (case-sensitive).
+               - If `key_type` is `INGEST`, then `ingest_type` must be specified.
+               - If `key_type` is `USER`, then `user_id` must be specified.
+        :param pulumi.Input[_builtins.str] notes: Additional notes about the API access key.
+        :param pulumi.Input[_builtins.str] user_id: Required if `key_type` is `USER`. The New Relic user ID for which the API access key will be created.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
@@ -425,59 +410,59 @@ class ApiAccessKey(pulumi.CustomResource):
         __props__.__dict__["user_id"] = user_id
         return ApiAccessKey(resource_name, opts=opts, __props__=__props__)
-    @property
+    @_builtins.property
     @pulumi.getter(name="accountId")
-    def account_id(self) -> pulumi.Output[str]:
+    def account_id(self) -> pulumi.Output[Optional[_builtins.str]]:
         """
-        The New Relic account ID of the account you wish to create the API access key.
+        The New Relic account ID where the API access key will be created.
         """
         return pulumi.get(self, "account_id")
-    @property
+    @_builtins.property
     @pulumi.getter(name="ingestType")
-    def ingest_type(self) -> pulumi.Output[str]:
+    def ingest_type(self) -> pulumi.Output[_builtins.str]:
         """
-        Required if `key_type = INGEST`. Valid options are `BROWSER` or `LICENSE`, case-sensitive.
+        Required if `key_type` is `INGEST`. Valid options are `BROWSER` or `LICENSE` (case-sensitive).
         """
         return pulumi.get(self, "ingest_type")
-    @property
+    @_builtins.property
     @pulumi.getter
-    def key(self) -> pulumi.Output[str]:
+    def key(self) -> pulumi.Output[_builtins.str]:
         """
-        The actual API key. This attribute is masked and not be visible in your terminal, CI, etc.
+        The actual API key.
+        - <span style="color:tomato;">It is important to exercise caution when exporting the value of `key`, as it is sensitive information</span>. Avoid logging or exposing it inappropriately.
         """
         return pulumi.get(self, "key")
-    @property
+    @_builtins.property
     @pulumi.getter(name="keyType")
-    def key_type(self) -> pulumi.Output[str]:
+    def key_type(self) -> pulumi.Output[_builtins.str]:
         """
-        What type of API key to create. Valid options are `INGEST` or `USER`, case-sensitive.
+        The type of API key to create. Valid options are `INGEST` or `USER` (case-sensitive).
+        - If `key_type` is `INGEST`, then `ingest_type` must be specified.
+        - If `key_type` is `USER`, then `user_id` must be specified.
         """
         return pulumi.get(self, "key_type")
-    @property
+    @_builtins.property
     @pulumi.getter
-    def name(self) -> pulumi.Output[str]:
-        """
-        The name of the key.
-        """
+    def name(self) -> pulumi.Output[_builtins.str]:
         return pulumi.get(self, "name")
-    @property
+    @_builtins.property
     @pulumi.getter
-    def notes(self) -> pulumi.Output[str]:
+    def notes(self) -> pulumi.Output[_builtins.str]:
         """
-        Any notes about this ingest key.
+        Additional notes about the API access key.
         """
         return pulumi.get(self, "notes")
-    @property
+    @_builtins.property
     @pulumi.getter(name="userId")
-    def user_id(self) -> pulumi.Output[str]:
+    def user_id(self) -> pulumi.Output[_builtins.str]:
         """
-        Required if `key_type = USER`. The New Relic user ID yous wish to create the API access key for in an account.
+        Required if `key_type` is `USER`. The New Relic user ID for which the API access key will be created.
         """
         return pulumi.get(self, "user_id")

pulumi-newrelic 5.42.1__py3-none-any.whl → 5.58.0a1766556761__py3-none-any.whl

pulumi-newrelic 5.42.1py3-none-any.whl → 5.58.0a1766556761py3-none-any.whl