pulumi-gcp 8.22.0a1741790977__py3-none-any.whl → 8.23.0__py3-none-any.whl

pulumi_gcp/networksecurity/intercept_deployment.py

@@ -23,23 +23,26 @@ class InterceptDeploymentArgs:
                  intercept_deployment_group: pulumi.Input[str],
                  intercept_deployment_id: pulumi.Input[str],
                  location: pulumi.Input[str],
+                 description: Optional[pulumi.Input[str]] = None,
                  labels: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
                  project: Optional[pulumi.Input[str]] = None):
         """
         The set of arguments for constructing a InterceptDeployment resource.
-        :param pulumi.Input[str] forwarding_rule: Immutable. The regional load balancer which the intercepted traffic should be forwarded
-               to. Format is:
-               projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
-        :param pulumi.Input[str] intercept_deployment_group: Immutable. The Intercept Deployment Group that this resource is part of. Format is:
-               `projects/{project}/locations/global/interceptDeploymentGroups/{interceptDeploymentGroup}`
-        :param pulumi.Input[str] intercept_deployment_id: Id of the requesting object
-               If auto-generating Id server-side, remove this field and
-               intercept_deployment_id from the method_signature of Create RPC
+        :param pulumi.Input[str] forwarding_rule: The regional forwarding rule that fronts the interceptors, for example:
+               `projects/123456789/regions/us-central1/forwardingRules/my-rule`.
+               See https://google.aip.dev/124.
+        :param pulumi.Input[str] intercept_deployment_group: The deployment group that this deployment is a part of, for example:
+               `projects/123456789/locations/global/interceptDeploymentGroups/my-dg`.
+               See https://google.aip.dev/124.
+        :param pulumi.Input[str] intercept_deployment_id: The ID to use for the new deployment, which will become the final
+               component of the deployment's resource name.
                
                
                - - -
-        :param pulumi.Input[str] location: Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122. See documentation for resource type `networksecurity.googleapis.com/InterceptDeployment`.
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Optional. Labels as key value pairs
+        :param pulumi.Input[str] location: The cloud location of the deployment, e.g. `us-central1-a` or `asia-south1-b`.
+        :param pulumi.Input[str] description: User-provided description of the deployment.
+               Used as additional context for the deployment.
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Labels are key/value pairs that help to organize and filter resources.
                **Note**: This field is non-authoritative, and will only manage the labels present in your configuration.
                Please refer to the field `effective_labels` for all of the labels present on the resource.
         :param pulumi.Input[str] project: The ID of the project in which the resource belongs.
@@ -49,6 +52,8 @@ class InterceptDeploymentArgs:
         pulumi.set(__self__, "intercept_deployment_group", intercept_deployment_group)
         pulumi.set(__self__, "intercept_deployment_id", intercept_deployment_id)
         pulumi.set(__self__, "location", location)
+        if description is not None:
+            pulumi.set(__self__, "description", description)
         if labels is not None:
             pulumi.set(__self__, "labels", labels)
         if project is not None:
@@ -58,9 +63,9 @@ class InterceptDeploymentArgs:
     @pulumi.getter(name="forwardingRule")
     def forwarding_rule(self) -> pulumi.Input[str]:
         """
-        Immutable. The regional load balancer which the intercepted traffic should be forwarded
-        to. Format is:
-        projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
+        The regional forwarding rule that fronts the interceptors, for example:
+        `projects/123456789/regions/us-central1/forwardingRules/my-rule`.
+        See https://google.aip.dev/124.
         """
         return pulumi.get(self, "forwarding_rule")
 
@@ -72,8 +77,9 @@ class InterceptDeploymentArgs:
     @pulumi.getter(name="interceptDeploymentGroup")
     def intercept_deployment_group(self) -> pulumi.Input[str]:
         """
-        Immutable. The Intercept Deployment Group that this resource is part of. Format is:
-        `projects/{project}/locations/global/interceptDeploymentGroups/{interceptDeploymentGroup}`
+        The deployment group that this deployment is a part of, for example:
+        `projects/123456789/locations/global/interceptDeploymentGroups/my-dg`.
+        See https://google.aip.dev/124.
         """
         return pulumi.get(self, "intercept_deployment_group")
 
@@ -85,9 +91,8 @@ class InterceptDeploymentArgs:
     @pulumi.getter(name="interceptDeploymentId")
     def intercept_deployment_id(self) -> pulumi.Input[str]:
         """
-        Id of the requesting object
-        If auto-generating Id server-side, remove this field and
-        intercept_deployment_id from the method_signature of Create RPC
+        The ID to use for the new deployment, which will become the final
+        component of the deployment's resource name.
 
 
         - - -
@@ -102,7 +107,7 @@ class InterceptDeploymentArgs:
     @pulumi.getter
     def location(self) -> pulumi.Input[str]:
         """
-        Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122. See documentation for resource type `networksecurity.googleapis.com/InterceptDeployment`.
+        The cloud location of the deployment, e.g. `us-central1-a` or `asia-south1-b`.
         """
         return pulumi.get(self, "location")
 
@@ -110,11 +115,24 @@ class InterceptDeploymentArgs:
     def location(self, value: pulumi.Input[str]):
         pulumi.set(self, "location", value)
 
+    @property
+    @pulumi.getter
+    def description(self) -> Optional[pulumi.Input[str]]:
+        """
+        User-provided description of the deployment.
+        Used as additional context for the deployment.
+        """
+        return pulumi.get(self, "description")
+
+    @description.setter
+    def description(self, value: Optional[pulumi.Input[str]]):
+        pulumi.set(self, "description", value)
+
     @property
     @pulumi.getter
     def labels(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
         """
-        Optional. Labels as key value pairs
+        Labels are key/value pairs that help to organize and filter resources.
         **Note**: This field is non-authoritative, and will only manage the labels present in your configuration.
         Please refer to the field `effective_labels` for all of the labels present on the resource.
         """
@@ -142,6 +160,7 @@ class InterceptDeploymentArgs:
 class _InterceptDeploymentState:
     def __init__(__self__, *,
                  create_time: Optional[pulumi.Input[str]] = None,
+                 description: Optional[pulumi.Input[str]] = None,
                  effective_labels: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
                  forwarding_rule: Optional[pulumi.Input[str]] = None,
                  intercept_deployment_group: Optional[pulumi.Input[str]] = None,
@@ -156,31 +175,39 @@ class _InterceptDeploymentState:
                  update_time: Optional[pulumi.Input[str]] = None):
         """
         Input properties used for looking up and filtering InterceptDeployment resources.
-        :param pulumi.Input[str] create_time: Create time stamp
+        :param pulumi.Input[str] create_time: The timestamp when the resource was created.
+               See https://google.aip.dev/148#timestamps.
+        :param pulumi.Input[str] description: User-provided description of the deployment.
+               Used as additional context for the deployment.
         :param pulumi.Input[Mapping[str, pulumi.Input[str]]] effective_labels: All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
-        :param pulumi.Input[str] forwarding_rule: Immutable. The regional load balancer which the intercepted traffic should be forwarded
-               to. Format is:
-               projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
-        :param pulumi.Input[str] intercept_deployment_group: Immutable. The Intercept Deployment Group that this resource is part of. Format is:
-               `projects/{project}/locations/global/interceptDeploymentGroups/{interceptDeploymentGroup}`
-        :param pulumi.Input[str] intercept_deployment_id: Id of the requesting object
-               If auto-generating Id server-side, remove this field and
-               intercept_deployment_id from the method_signature of Create RPC
+        :param pulumi.Input[str] forwarding_rule: The regional forwarding rule that fronts the interceptors, for example:
+               `projects/123456789/regions/us-central1/forwardingRules/my-rule`.
+               See https://google.aip.dev/124.
+        :param pulumi.Input[str] intercept_deployment_group: The deployment group that this deployment is a part of, for example:
+               `projects/123456789/locations/global/interceptDeploymentGroups/my-dg`.
+               See https://google.aip.dev/124.
+        :param pulumi.Input[str] intercept_deployment_id: The ID to use for the new deployment, which will become the final
+               component of the deployment's resource name.
                
                
                - - -
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Optional. Labels as key value pairs
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Labels are key/value pairs that help to organize and filter resources.
                **Note**: This field is non-authoritative, and will only manage the labels present in your configuration.
                Please refer to the field `effective_labels` for all of the labels present on the resource.
-        :param pulumi.Input[str] location: Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122. See documentation for resource type `networksecurity.googleapis.com/InterceptDeployment`.
-        :param pulumi.Input[str] name: Identifier. The name of the InterceptDeployment.
+        :param pulumi.Input[str] location: The cloud location of the deployment, e.g. `us-central1-a` or `asia-south1-b`.
+        :param pulumi.Input[str] name: The resource name of this deployment, for example:
+               `projects/123456789/locations/us-central1-a/interceptDeployments/my-dep`.
+               See https://google.aip.dev/122 for more details.
         :param pulumi.Input[str] project: The ID of the project in which the resource belongs.
                If it is not provided, the provider project is used.
         :param pulumi.Input[Mapping[str, pulumi.Input[str]]] pulumi_labels: The combination of labels configured directly on the resource
                and default labels configured on the provider.
-        :param pulumi.Input[bool] reconciling: Whether reconciling is in progress, recommended per
-               https://google.aip.dev/128.
-        :param pulumi.Input[str] state: Current state of the deployment.
+        :param pulumi.Input[bool] reconciling: The current state of the resource does not match the user's intended state,
+               and the system is working to reconcile them. This part of the normal
+               operation (e.g. linking a new association to the parent group).
+               See https://google.aip.dev/128.
+        :param pulumi.Input[str] state: The current state of the deployment.
+               See https://google.aip.dev/216.
                Possible values:
                STATE_UNSPECIFIED
                ACTIVE
@@ -188,10 +215,13 @@ class _InterceptDeploymentState:
                DELETING
                OUT_OF_SYNC
                DELETE_FAILED
-        :param pulumi.Input[str] update_time: Update time stamp
+        :param pulumi.Input[str] update_time: The timestamp when the resource was most recently updated.
+               See https://google.aip.dev/148#timestamps.
         """
         if create_time is not None:
             pulumi.set(__self__, "create_time", create_time)
+        if description is not None:
+            pulumi.set(__self__, "description", description)
         if effective_labels is not None:
             pulumi.set(__self__, "effective_labels", effective_labels)
         if forwarding_rule is not None:
@@ -221,7 +251,8 @@ class _InterceptDeploymentState:
     @pulumi.getter(name="createTime")
     def create_time(self) -> Optional[pulumi.Input[str]]:
         """
-        Create time stamp
+        The timestamp when the resource was created.
+        See https://google.aip.dev/148#timestamps.
         """
         return pulumi.get(self, "create_time")
 
@@ -229,6 +260,19 @@ class _InterceptDeploymentState:
     def create_time(self, value: Optional[pulumi.Input[str]]):
         pulumi.set(self, "create_time", value)
 
+    @property
+    @pulumi.getter
+    def description(self) -> Optional[pulumi.Input[str]]:
+        """
+        User-provided description of the deployment.
+        Used as additional context for the deployment.
+        """
+        return pulumi.get(self, "description")
+
+    @description.setter
+    def description(self, value: Optional[pulumi.Input[str]]):
+        pulumi.set(self, "description", value)
+
     @property
     @pulumi.getter(name="effectiveLabels")
     def effective_labels(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
@@ -245,9 +289,9 @@ class _InterceptDeploymentState:
     @pulumi.getter(name="forwardingRule")
     def forwarding_rule(self) -> Optional[pulumi.Input[str]]:
         """
-        Immutable. The regional load balancer which the intercepted traffic should be forwarded
-        to. Format is:
-        projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
+        The regional forwarding rule that fronts the interceptors, for example:
+        `projects/123456789/regions/us-central1/forwardingRules/my-rule`.
+        See https://google.aip.dev/124.
         """
         return pulumi.get(self, "forwarding_rule")
 
@@ -259,8 +303,9 @@ class _InterceptDeploymentState:
     @pulumi.getter(name="interceptDeploymentGroup")
     def intercept_deployment_group(self) -> Optional[pulumi.Input[str]]:
         """
-        Immutable. The Intercept Deployment Group that this resource is part of. Format is:
-        `projects/{project}/locations/global/interceptDeploymentGroups/{interceptDeploymentGroup}`
+        The deployment group that this deployment is a part of, for example:
+        `projects/123456789/locations/global/interceptDeploymentGroups/my-dg`.
+        See https://google.aip.dev/124.
         """
         return pulumi.get(self, "intercept_deployment_group")
 
@@ -272,9 +317,8 @@ class _InterceptDeploymentState:
     @pulumi.getter(name="interceptDeploymentId")
     def intercept_deployment_id(self) -> Optional[pulumi.Input[str]]:
         """
-        Id of the requesting object
-        If auto-generating Id server-side, remove this field and
-        intercept_deployment_id from the method_signature of Create RPC
+        The ID to use for the new deployment, which will become the final
+        component of the deployment's resource name.
 
 
         - - -
@@ -289,7 +333,7 @@ class _InterceptDeploymentState:
     @pulumi.getter
     def labels(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
         """
-        Optional. Labels as key value pairs
+        Labels are key/value pairs that help to organize and filter resources.
         **Note**: This field is non-authoritative, and will only manage the labels present in your configuration.
         Please refer to the field `effective_labels` for all of the labels present on the resource.
         """
@@ -303,7 +347,7 @@ class _InterceptDeploymentState:
     @pulumi.getter
     def location(self) -> Optional[pulumi.Input[str]]:
         """
-        Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122. See documentation for resource type `networksecurity.googleapis.com/InterceptDeployment`.
+        The cloud location of the deployment, e.g. `us-central1-a` or `asia-south1-b`.
         """
         return pulumi.get(self, "location")
 
@@ -315,7 +359,9 @@ class _InterceptDeploymentState:
     @pulumi.getter
     def name(self) -> Optional[pulumi.Input[str]]:
         """
-        Identifier. The name of the InterceptDeployment.
+        The resource name of this deployment, for example:
+        `projects/123456789/locations/us-central1-a/interceptDeployments/my-dep`.
+        See https://google.aip.dev/122 for more details.
         """
         return pulumi.get(self, "name")
 
@@ -353,8 +399,10 @@ class _InterceptDeploymentState:
     @pulumi.getter
     def reconciling(self) -> Optional[pulumi.Input[bool]]:
         """
-        Whether reconciling is in progress, recommended per
-        https://google.aip.dev/128.
+        The current state of the resource does not match the user's intended state,
+        and the system is working to reconcile them. This part of the normal
+        operation (e.g. linking a new association to the parent group).
+        See https://google.aip.dev/128.
         """
         return pulumi.get(self, "reconciling")
 
@@ -366,7 +414,8 @@ class _InterceptDeploymentState:
     @pulumi.getter
     def state(self) -> Optional[pulumi.Input[str]]:
         """
-        Current state of the deployment.
+        The current state of the deployment.
+        See https://google.aip.dev/216.
         Possible values:
         STATE_UNSPECIFIED
         ACTIVE
@@ -385,7 +434,8 @@ class _InterceptDeploymentState:
     @pulumi.getter(name="updateTime")
     def update_time(self) -> Optional[pulumi.Input[str]]:
         """
-        Update time stamp
+        The timestamp when the resource was most recently updated.
+        See https://google.aip.dev/148#timestamps.
         """
         return pulumi.get(self, "update_time")
 
@@ -399,6 +449,7 @@ class InterceptDeployment(pulumi.CustomResource):
     def __init__(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
+                 description: Optional[pulumi.Input[str]] = None,
                  forwarding_rule: Optional[pulumi.Input[str]] = None,
                  intercept_deployment_group: Optional[pulumi.Input[str]] = None,
                  intercept_deployment_id: Optional[pulumi.Input[str]] = None,
@@ -453,6 +504,7 @@ class InterceptDeployment(pulumi.CustomResource):
             location="us-central1-a",
             forwarding_rule=forwarding_rule.id,
             intercept_deployment_group=deployment_group.id,
+            description="some description",
             labels={
                 "foo": "bar",
             })
@@ -484,21 +536,23 @@ class InterceptDeployment(pulumi.CustomResource):
 
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[str] forwarding_rule: Immutable. The regional load balancer which the intercepted traffic should be forwarded
-               to. Format is:
-               projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
-        :param pulumi.Input[str] intercept_deployment_group: Immutable. The Intercept Deployment Group that this resource is part of. Format is:
-               `projects/{project}/locations/global/interceptDeploymentGroups/{interceptDeploymentGroup}`
-        :param pulumi.Input[str] intercept_deployment_id: Id of the requesting object
-               If auto-generating Id server-side, remove this field and
-               intercept_deployment_id from the method_signature of Create RPC
+        :param pulumi.Input[str] description: User-provided description of the deployment.
+               Used as additional context for the deployment.
+        :param pulumi.Input[str] forwarding_rule: The regional forwarding rule that fronts the interceptors, for example:
+               `projects/123456789/regions/us-central1/forwardingRules/my-rule`.
+               See https://google.aip.dev/124.
+        :param pulumi.Input[str] intercept_deployment_group: The deployment group that this deployment is a part of, for example:
+               `projects/123456789/locations/global/interceptDeploymentGroups/my-dg`.
+               See https://google.aip.dev/124.
+        :param pulumi.Input[str] intercept_deployment_id: The ID to use for the new deployment, which will become the final
+               component of the deployment's resource name.
                
                
                - - -
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Optional. Labels as key value pairs
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Labels are key/value pairs that help to organize and filter resources.
                **Note**: This field is non-authoritative, and will only manage the labels present in your configuration.
                Please refer to the field `effective_labels` for all of the labels present on the resource.
-        :param pulumi.Input[str] location: Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122. See documentation for resource type `networksecurity.googleapis.com/InterceptDeployment`.
+        :param pulumi.Input[str] location: The cloud location of the deployment, e.g. `us-central1-a` or `asia-south1-b`.
         :param pulumi.Input[str] project: The ID of the project in which the resource belongs.
                If it is not provided, the provider project is used.
         """
@@ -555,6 +609,7 @@ class InterceptDeployment(pulumi.CustomResource):
             location="us-central1-a",
             forwarding_rule=forwarding_rule.id,
             intercept_deployment_group=deployment_group.id,
+            description="some description",
             labels={
                 "foo": "bar",
             })
@@ -599,6 +654,7 @@ class InterceptDeployment(pulumi.CustomResource):
     def _internal_init(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
+                 description: Optional[pulumi.Input[str]] = None,
                  forwarding_rule: Optional[pulumi.Input[str]] = None,
                  intercept_deployment_group: Optional[pulumi.Input[str]] = None,
                  intercept_deployment_id: Optional[pulumi.Input[str]] = None,
@@ -614,6 +670,7 @@ class InterceptDeployment(pulumi.CustomResource):
                 raise TypeError('__props__ is only valid when passed in combination with a valid opts.id to get an existing resource')
             __props__ = InterceptDeploymentArgs.__new__(InterceptDeploymentArgs)
 
+            __props__.__dict__["description"] = description
             if forwarding_rule is None and not opts.urn:
                 raise TypeError("Missing required property 'forwarding_rule'")
             __props__.__dict__["forwarding_rule"] = forwarding_rule
@@ -648,6 +705,7 @@ class InterceptDeployment(pulumi.CustomResource):
             id: pulumi.Input[str],
             opts: Optional[pulumi.ResourceOptions] = None,
             create_time: Optional[pulumi.Input[str]] = None,
+            description: Optional[pulumi.Input[str]] = None,
             effective_labels: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
             forwarding_rule: Optional[pulumi.Input[str]] = None,
             intercept_deployment_group: Optional[pulumi.Input[str]] = None,
@@ -667,31 +725,39 @@ class InterceptDeployment(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] create_time: Create time stamp
+        :param pulumi.Input[str] create_time: The timestamp when the resource was created.
+               See https://google.aip.dev/148#timestamps.
+        :param pulumi.Input[str] description: User-provided description of the deployment.
+               Used as additional context for the deployment.
         :param pulumi.Input[Mapping[str, pulumi.Input[str]]] effective_labels: All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Pulumi, other clients and services.
-        :param pulumi.Input[str] forwarding_rule: Immutable. The regional load balancer which the intercepted traffic should be forwarded
-               to. Format is:
-               projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
-        :param pulumi.Input[str] intercept_deployment_group: Immutable. The Intercept Deployment Group that this resource is part of. Format is:
-               `projects/{project}/locations/global/interceptDeploymentGroups/{interceptDeploymentGroup}`
-        :param pulumi.Input[str] intercept_deployment_id: Id of the requesting object
-               If auto-generating Id server-side, remove this field and
-               intercept_deployment_id from the method_signature of Create RPC
+        :param pulumi.Input[str] forwarding_rule: The regional forwarding rule that fronts the interceptors, for example:
+               `projects/123456789/regions/us-central1/forwardingRules/my-rule`.
+               See https://google.aip.dev/124.
+        :param pulumi.Input[str] intercept_deployment_group: The deployment group that this deployment is a part of, for example:
+               `projects/123456789/locations/global/interceptDeploymentGroups/my-dg`.
+               See https://google.aip.dev/124.
+        :param pulumi.Input[str] intercept_deployment_id: The ID to use for the new deployment, which will become the final
+               component of the deployment's resource name.
                
                
                - - -
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Optional. Labels as key value pairs
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Labels are key/value pairs that help to organize and filter resources.
                **Note**: This field is non-authoritative, and will only manage the labels present in your configuration.
                Please refer to the field `effective_labels` for all of the labels present on the resource.
-        :param pulumi.Input[str] location: Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122. See documentation for resource type `networksecurity.googleapis.com/InterceptDeployment`.
-        :param pulumi.Input[str] name: Identifier. The name of the InterceptDeployment.
+        :param pulumi.Input[str] location: The cloud location of the deployment, e.g. `us-central1-a` or `asia-south1-b`.
+        :param pulumi.Input[str] name: The resource name of this deployment, for example:
+               `projects/123456789/locations/us-central1-a/interceptDeployments/my-dep`.
+               See https://google.aip.dev/122 for more details.
         :param pulumi.Input[str] project: The ID of the project in which the resource belongs.
                If it is not provided, the provider project is used.
         :param pulumi.Input[Mapping[str, pulumi.Input[str]]] pulumi_labels: The combination of labels configured directly on the resource
                and default labels configured on the provider.
-        :param pulumi.Input[bool] reconciling: Whether reconciling is in progress, recommended per
-               https://google.aip.dev/128.
-        :param pulumi.Input[str] state: Current state of the deployment.
+        :param pulumi.Input[bool] reconciling: The current state of the resource does not match the user's intended state,
+               and the system is working to reconcile them. This part of the normal
+               operation (e.g. linking a new association to the parent group).
+               See https://google.aip.dev/128.
+        :param pulumi.Input[str] state: The current state of the deployment.
+               See https://google.aip.dev/216.
                Possible values:
                STATE_UNSPECIFIED
                ACTIVE
@@ -699,13 +765,15 @@ class InterceptDeployment(pulumi.CustomResource):
                DELETING
                OUT_OF_SYNC
                DELETE_FAILED
-        :param pulumi.Input[str] update_time: Update time stamp
+        :param pulumi.Input[str] update_time: The timestamp when the resource was most recently updated.
+               See https://google.aip.dev/148#timestamps.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
 
         __props__ = _InterceptDeploymentState.__new__(_InterceptDeploymentState)
 
         __props__.__dict__["create_time"] = create_time
+        __props__.__dict__["description"] = description
         __props__.__dict__["effective_labels"] = effective_labels
         __props__.__dict__["forwarding_rule"] = forwarding_rule
         __props__.__dict__["intercept_deployment_group"] = intercept_deployment_group
@@ -724,10 +792,20 @@ class InterceptDeployment(pulumi.CustomResource):
     @pulumi.getter(name="createTime")
     def create_time(self) -> pulumi.Output[str]:
         """
-        Create time stamp
+        The timestamp when the resource was created.
+        See https://google.aip.dev/148#timestamps.
         """
         return pulumi.get(self, "create_time")
 
+    @property
+    @pulumi.getter
+    def description(self) -> pulumi.Output[Optional[str]]:
+        """
+        User-provided description of the deployment.
+        Used as additional context for the deployment.
+        """
+        return pulumi.get(self, "description")
+
     @property
     @pulumi.getter(name="effectiveLabels")
     def effective_labels(self) -> pulumi.Output[Mapping[str, str]]:
@@ -740,9 +818,9 @@ class InterceptDeployment(pulumi.CustomResource):
     @pulumi.getter(name="forwardingRule")
     def forwarding_rule(self) -> pulumi.Output[str]:
         """
-        Immutable. The regional load balancer which the intercepted traffic should be forwarded
-        to. Format is:
-        projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
+        The regional forwarding rule that fronts the interceptors, for example:
+        `projects/123456789/regions/us-central1/forwardingRules/my-rule`.
+        See https://google.aip.dev/124.
         """
         return pulumi.get(self, "forwarding_rule")
 
@@ -750,8 +828,9 @@ class InterceptDeployment(pulumi.CustomResource):
     @pulumi.getter(name="interceptDeploymentGroup")
     def intercept_deployment_group(self) -> pulumi.Output[str]:
         """
-        Immutable. The Intercept Deployment Group that this resource is part of. Format is:
-        `projects/{project}/locations/global/interceptDeploymentGroups/{interceptDeploymentGroup}`
+        The deployment group that this deployment is a part of, for example:
+        `projects/123456789/locations/global/interceptDeploymentGroups/my-dg`.
+        See https://google.aip.dev/124.
         """
         return pulumi.get(self, "intercept_deployment_group")
 
@@ -759,9 +838,8 @@ class InterceptDeployment(pulumi.CustomResource):
     @pulumi.getter(name="interceptDeploymentId")
     def intercept_deployment_id(self) -> pulumi.Output[str]:
         """
-        Id of the requesting object
-        If auto-generating Id server-side, remove this field and
-        intercept_deployment_id from the method_signature of Create RPC
+        The ID to use for the new deployment, which will become the final
+        component of the deployment's resource name.
 
 
         - - -
@@ -772,7 +850,7 @@ class InterceptDeployment(pulumi.CustomResource):
     @pulumi.getter
     def labels(self) -> pulumi.Output[Optional[Mapping[str, str]]]:
         """
-        Optional. Labels as key value pairs
+        Labels are key/value pairs that help to organize and filter resources.
         **Note**: This field is non-authoritative, and will only manage the labels present in your configuration.
         Please refer to the field `effective_labels` for all of the labels present on the resource.
         """
@@ -782,7 +860,7 @@ class InterceptDeployment(pulumi.CustomResource):
     @pulumi.getter
     def location(self) -> pulumi.Output[str]:
         """
-        Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122. See documentation for resource type `networksecurity.googleapis.com/InterceptDeployment`.
+        The cloud location of the deployment, e.g. `us-central1-a` or `asia-south1-b`.
         """
         return pulumi.get(self, "location")
 
@@ -790,7 +868,9 @@ class InterceptDeployment(pulumi.CustomResource):
     @pulumi.getter
     def name(self) -> pulumi.Output[str]:
         """
-        Identifier. The name of the InterceptDeployment.
+        The resource name of this deployment, for example:
+        `projects/123456789/locations/us-central1-a/interceptDeployments/my-dep`.
+        See https://google.aip.dev/122 for more details.
         """
         return pulumi.get(self, "name")
 
@@ -816,8 +896,10 @@ class InterceptDeployment(pulumi.CustomResource):
     @pulumi.getter
     def reconciling(self) -> pulumi.Output[bool]:
         """
-        Whether reconciling is in progress, recommended per
-        https://google.aip.dev/128.
+        The current state of the resource does not match the user's intended state,
+        and the system is working to reconcile them. This part of the normal
+        operation (e.g. linking a new association to the parent group).
+        See https://google.aip.dev/128.
         """
         return pulumi.get(self, "reconciling")
 
@@ -825,7 +907,8 @@ class InterceptDeployment(pulumi.CustomResource):
     @pulumi.getter
     def state(self) -> pulumi.Output[str]:
         """
-        Current state of the deployment.
+        The current state of the deployment.
+        See https://google.aip.dev/216.
         Possible values:
         STATE_UNSPECIFIED
         ACTIVE
@@ -840,7 +923,8 @@ class InterceptDeployment(pulumi.CustomResource):
     @pulumi.getter(name="updateTime")
     def update_time(self) -> pulumi.Output[str]:
         """
-        Update time stamp
+        The timestamp when the resource was most recently updated.
+        See https://google.aip.dev/148#timestamps.
         """
         return pulumi.get(self, "update_time")