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

pulumi_gcp/networksecurity/mirroring_deployment.py

@@ -23,23 +23,26 @@ class MirroringDeploymentArgs:
                  location: pulumi.Input[str],
                  mirroring_deployment_group: pulumi.Input[str],
                  mirroring_deployment_id: 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 MirroringDeployment resource.
-        :param pulumi.Input[str] forwarding_rule: Required. Immutable. The regional load balancer which the mirrored traffic should be forwarded
-               to. Format is:
-               projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
-        :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/MirroringDeployment`.
-        :param pulumi.Input[str] mirroring_deployment_group: Required. Immutable. The Mirroring Deployment Group that this resource is part of. Format is:
-               `projects/{project}/locations/global/mirroringDeploymentGroups/{mirroringDeploymentGroup}`
-        :param pulumi.Input[str] mirroring_deployment_id: Required. Id of the requesting object
-               If auto-generating Id server-side, remove this field and
-               mirroring_deployment_id from the method_signature of Create RPC
+        :param pulumi.Input[str] forwarding_rule: The regional forwarding rule that fronts the mirroring collectors, for
+               example: `projects/123456789/regions/us-central1/forwardingRules/my-rule`.
+               See https://google.aip.dev/124.
+        :param pulumi.Input[str] location: The cloud location of the deployment, e.g. `us-central1-a` or `asia-south1-b`.
+        :param pulumi.Input[str] mirroring_deployment_group: The deployment group that this deployment is a part of, for example:
+               `projects/123456789/locations/global/mirroringDeploymentGroups/my-dg`.
+               See https://google.aip.dev/124.
+        :param pulumi.Input[str] mirroring_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[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 MirroringDeploymentArgs:
         pulumi.set(__self__, "location", location)
         pulumi.set(__self__, "mirroring_deployment_group", mirroring_deployment_group)
         pulumi.set(__self__, "mirroring_deployment_id", mirroring_deployment_id)
+        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 MirroringDeploymentArgs:
     @pulumi.getter(name="forwardingRule")
     def forwarding_rule(self) -> pulumi.Input[str]:
         """
-        Required. Immutable. The regional load balancer which the mirrored traffic should be forwarded
-        to. Format is:
-        projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
+        The regional forwarding rule that fronts the mirroring collectors, for
+        example: `projects/123456789/regions/us-central1/forwardingRules/my-rule`.
+        See https://google.aip.dev/124.
         """
         return pulumi.get(self, "forwarding_rule")
 
@@ -72,7 +77,7 @@ class MirroringDeploymentArgs:
     @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/MirroringDeployment`.
+        The cloud location of the deployment, e.g. `us-central1-a` or `asia-south1-b`.
         """
         return pulumi.get(self, "location")
 
@@ -84,8 +89,9 @@ class MirroringDeploymentArgs:
     @pulumi.getter(name="mirroringDeploymentGroup")
     def mirroring_deployment_group(self) -> pulumi.Input[str]:
         """
-        Required. Immutable. The Mirroring Deployment Group that this resource is part of. Format is:
-        `projects/{project}/locations/global/mirroringDeploymentGroups/{mirroringDeploymentGroup}`
+        The deployment group that this deployment is a part of, for example:
+        `projects/123456789/locations/global/mirroringDeploymentGroups/my-dg`.
+        See https://google.aip.dev/124.
         """
         return pulumi.get(self, "mirroring_deployment_group")
 
@@ -97,9 +103,8 @@ class MirroringDeploymentArgs:
     @pulumi.getter(name="mirroringDeploymentId")
     def mirroring_deployment_id(self) -> pulumi.Input[str]:
         """
-        Required. Id of the requesting object
-        If auto-generating Id server-side, remove this field and
-        mirroring_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.
 
 
         - - -
@@ -110,11 +115,24 @@ class MirroringDeploymentArgs:
     def mirroring_deployment_id(self, value: pulumi.Input[str]):
         pulumi.set(self, "mirroring_deployment_id", 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 MirroringDeploymentArgs:
 class _MirroringDeploymentState:
     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,
                  labels: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
@@ -156,31 +175,39 @@ class _MirroringDeploymentState:
                  update_time: Optional[pulumi.Input[str]] = None):
         """
         Input properties used for looking up and filtering MirroringDeployment resources.
-        :param pulumi.Input[str] create_time: Output only. [Output only] 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: Required. Immutable. The regional load balancer which the mirrored traffic should be forwarded
-               to. Format is:
-               projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Optional. Labels as key value pairs
+        :param pulumi.Input[str] forwarding_rule: The regional forwarding rule that fronts the mirroring collectors, for
+               example: `projects/123456789/regions/us-central1/forwardingRules/my-rule`.
+               See https://google.aip.dev/124.
+        :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/MirroringDeployment`.
-        :param pulumi.Input[str] mirroring_deployment_group: Required. Immutable. The Mirroring Deployment Group that this resource is part of. Format is:
-               `projects/{project}/locations/global/mirroringDeploymentGroups/{mirroringDeploymentGroup}`
-        :param pulumi.Input[str] mirroring_deployment_id: Required. Id of the requesting object
-               If auto-generating Id server-side, remove this field and
-               mirroring_deployment_id from the method_signature of Create RPC
+        :param pulumi.Input[str] location: The cloud location of the deployment, e.g. `us-central1-a` or `asia-south1-b`.
+        :param pulumi.Input[str] mirroring_deployment_group: The deployment group that this deployment is a part of, for example:
+               `projects/123456789/locations/global/mirroringDeploymentGroups/my-dg`.
+               See https://google.aip.dev/124.
+        :param pulumi.Input[str] mirroring_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] name: Immutable. Identifier. The name of the MirroringDeployment.
+        :param pulumi.Input[str] name: The resource name of this deployment, for example:
+               `projects/123456789/locations/us-central1-a/mirroringDeployments/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: Output only. Whether reconciling is in progress, recommended per
-               https://google.aip.dev/128.
-        :param pulumi.Input[str] state: Output only. 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 _MirroringDeploymentState:
                DELETING
                OUT_OF_SYNC
                DELETE_FAILED
-        :param pulumi.Input[str] update_time: Output only. [Output only] 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 _MirroringDeploymentState:
     @pulumi.getter(name="createTime")
     def create_time(self) -> Optional[pulumi.Input[str]]:
         """
-        Output only. [Output only] 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 _MirroringDeploymentState:
     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 _MirroringDeploymentState:
     @pulumi.getter(name="forwardingRule")
     def forwarding_rule(self) -> Optional[pulumi.Input[str]]:
         """
-        Required. Immutable. The regional load balancer which the mirrored traffic should be forwarded
-        to. Format is:
-        projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
+        The regional forwarding rule that fronts the mirroring collectors, for
+        example: `projects/123456789/regions/us-central1/forwardingRules/my-rule`.
+        See https://google.aip.dev/124.
         """
         return pulumi.get(self, "forwarding_rule")
 
@@ -259,7 +303,7 @@ class _MirroringDeploymentState:
     @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.
         """
@@ -273,7 +317,7 @@ class _MirroringDeploymentState:
     @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/MirroringDeployment`.
+        The cloud location of the deployment, e.g. `us-central1-a` or `asia-south1-b`.
         """
         return pulumi.get(self, "location")
 
@@ -285,8 +329,9 @@ class _MirroringDeploymentState:
     @pulumi.getter(name="mirroringDeploymentGroup")
     def mirroring_deployment_group(self) -> Optional[pulumi.Input[str]]:
         """
-        Required. Immutable. The Mirroring Deployment Group that this resource is part of. Format is:
-        `projects/{project}/locations/global/mirroringDeploymentGroups/{mirroringDeploymentGroup}`
+        The deployment group that this deployment is a part of, for example:
+        `projects/123456789/locations/global/mirroringDeploymentGroups/my-dg`.
+        See https://google.aip.dev/124.
         """
         return pulumi.get(self, "mirroring_deployment_group")
 
@@ -298,9 +343,8 @@ class _MirroringDeploymentState:
     @pulumi.getter(name="mirroringDeploymentId")
     def mirroring_deployment_id(self) -> Optional[pulumi.Input[str]]:
         """
-        Required. Id of the requesting object
-        If auto-generating Id server-side, remove this field and
-        mirroring_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.
 
 
         - - -
@@ -315,7 +359,9 @@ class _MirroringDeploymentState:
     @pulumi.getter
     def name(self) -> Optional[pulumi.Input[str]]:
         """
-        Immutable. Identifier. The name of the MirroringDeployment.
+        The resource name of this deployment, for example:
+        `projects/123456789/locations/us-central1-a/mirroringDeployments/my-dep`.
+        See https://google.aip.dev/122 for more details.
         """
         return pulumi.get(self, "name")
 
@@ -353,8 +399,10 @@ class _MirroringDeploymentState:
     @pulumi.getter
     def reconciling(self) -> Optional[pulumi.Input[bool]]:
         """
-        Output only. 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 _MirroringDeploymentState:
     @pulumi.getter
     def state(self) -> Optional[pulumi.Input[str]]:
         """
-        Output only. 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 _MirroringDeploymentState:
     @pulumi.getter(name="updateTime")
     def update_time(self) -> Optional[pulumi.Input[str]]:
         """
-        Output only. [Output only] 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 MirroringDeployment(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,
                  labels: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
                  location: Optional[pulumi.Input[str]] = None,
@@ -407,6 +458,17 @@ class MirroringDeployment(pulumi.CustomResource):
                  project: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
+        A deployment represents a zonal mirroring backend ready to accept
+        GENEVE-encapsulated replica traffic, e.g. a zonal instance group fronted by
+        an internal passthrough load balancer. Deployments are always part of a
+        global deployment group which represents a global mirroring service.
+
+        To get more information about MirroringDeployment, see:
+
+        * [API documentation](https://cloud.google.com/network-security-integration/docs/reference/rest/v1/projects.locations.mirroringDeployments)
+        * How-to Guides
+            * [Mirroring deployment overview](https://cloud.google.com/network-security-integration/docs/out-of-band/deployments-overview)
+
         ## Example Usage
 
         ### Network Security Mirroring Deployment Basic
@@ -454,6 +516,7 @@ class MirroringDeployment(pulumi.CustomResource):
             location="us-central1-a",
             forwarding_rule=forwarding_rule.id,
             mirroring_deployment_group=deployment_group.id,
+            description="some description",
             labels={
                 "foo": "bar",
             })
@@ -485,18 +548,20 @@ class MirroringDeployment(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: Required. Immutable. The regional load balancer which the mirrored traffic should be forwarded
-               to. Format is:
-               projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Optional. Labels as key value pairs
+        :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 mirroring collectors, for
+               example: `projects/123456789/regions/us-central1/forwardingRules/my-rule`.
+               See https://google.aip.dev/124.
+        :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/MirroringDeployment`.
-        :param pulumi.Input[str] mirroring_deployment_group: Required. Immutable. The Mirroring Deployment Group that this resource is part of. Format is:
-               `projects/{project}/locations/global/mirroringDeploymentGroups/{mirroringDeploymentGroup}`
-        :param pulumi.Input[str] mirroring_deployment_id: Required. Id of the requesting object
-               If auto-generating Id server-side, remove this field and
-               mirroring_deployment_id from the method_signature of Create RPC
+        :param pulumi.Input[str] location: The cloud location of the deployment, e.g. `us-central1-a` or `asia-south1-b`.
+        :param pulumi.Input[str] mirroring_deployment_group: The deployment group that this deployment is a part of, for example:
+               `projects/123456789/locations/global/mirroringDeploymentGroups/my-dg`.
+               See https://google.aip.dev/124.
+        :param pulumi.Input[str] mirroring_deployment_id: The ID to use for the new deployment, which will become the final
+               component of the deployment's resource name.
                
                
                - - -
@@ -510,6 +575,17 @@ class MirroringDeployment(pulumi.CustomResource):
                  args: MirroringDeploymentArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
+        A deployment represents a zonal mirroring backend ready to accept
+        GENEVE-encapsulated replica traffic, e.g. a zonal instance group fronted by
+        an internal passthrough load balancer. Deployments are always part of a
+        global deployment group which represents a global mirroring service.
+
+        To get more information about MirroringDeployment, see:
+
+        * [API documentation](https://cloud.google.com/network-security-integration/docs/reference/rest/v1/projects.locations.mirroringDeployments)
+        * How-to Guides
+            * [Mirroring deployment overview](https://cloud.google.com/network-security-integration/docs/out-of-band/deployments-overview)
+
         ## Example Usage
 
         ### Network Security Mirroring Deployment Basic
@@ -557,6 +633,7 @@ class MirroringDeployment(pulumi.CustomResource):
             location="us-central1-a",
             forwarding_rule=forwarding_rule.id,
             mirroring_deployment_group=deployment_group.id,
+            description="some description",
             labels={
                 "foo": "bar",
             })
@@ -601,6 +678,7 @@ class MirroringDeployment(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,
                  labels: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
                  location: Optional[pulumi.Input[str]] = None,
@@ -616,6 +694,7 @@ class MirroringDeployment(pulumi.CustomResource):
                 raise TypeError('__props__ is only valid when passed in combination with a valid opts.id to get an existing resource')
             __props__ = MirroringDeploymentArgs.__new__(MirroringDeploymentArgs)
 
+            __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
@@ -650,6 +729,7 @@ class MirroringDeployment(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,
             labels: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
@@ -669,31 +749,39 @@ class MirroringDeployment(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: Output only. [Output only] 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: Required. Immutable. The regional load balancer which the mirrored traffic should be forwarded
-               to. Format is:
-               projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
-        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] labels: Optional. Labels as key value pairs
+        :param pulumi.Input[str] forwarding_rule: The regional forwarding rule that fronts the mirroring collectors, for
+               example: `projects/123456789/regions/us-central1/forwardingRules/my-rule`.
+               See https://google.aip.dev/124.
+        :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/MirroringDeployment`.
-        :param pulumi.Input[str] mirroring_deployment_group: Required. Immutable. The Mirroring Deployment Group that this resource is part of. Format is:
-               `projects/{project}/locations/global/mirroringDeploymentGroups/{mirroringDeploymentGroup}`
-        :param pulumi.Input[str] mirroring_deployment_id: Required. Id of the requesting object
-               If auto-generating Id server-side, remove this field and
-               mirroring_deployment_id from the method_signature of Create RPC
+        :param pulumi.Input[str] location: The cloud location of the deployment, e.g. `us-central1-a` or `asia-south1-b`.
+        :param pulumi.Input[str] mirroring_deployment_group: The deployment group that this deployment is a part of, for example:
+               `projects/123456789/locations/global/mirroringDeploymentGroups/my-dg`.
+               See https://google.aip.dev/124.
+        :param pulumi.Input[str] mirroring_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] name: Immutable. Identifier. The name of the MirroringDeployment.
+        :param pulumi.Input[str] name: The resource name of this deployment, for example:
+               `projects/123456789/locations/us-central1-a/mirroringDeployments/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: Output only. Whether reconciling is in progress, recommended per
-               https://google.aip.dev/128.
-        :param pulumi.Input[str] state: Output only. 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
@@ -701,13 +789,15 @@ class MirroringDeployment(pulumi.CustomResource):
                DELETING
                OUT_OF_SYNC
                DELETE_FAILED
-        :param pulumi.Input[str] update_time: Output only. [Output only] 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__ = _MirroringDeploymentState.__new__(_MirroringDeploymentState)
 
         __props__.__dict__["create_time"] = create_time
+        __props__.__dict__["description"] = description
         __props__.__dict__["effective_labels"] = effective_labels
         __props__.__dict__["forwarding_rule"] = forwarding_rule
         __props__.__dict__["labels"] = labels
@@ -726,10 +816,20 @@ class MirroringDeployment(pulumi.CustomResource):
     @pulumi.getter(name="createTime")
     def create_time(self) -> pulumi.Output[str]:
         """
-        Output only. [Output only] 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]]:
@@ -742,9 +842,9 @@ class MirroringDeployment(pulumi.CustomResource):
     @pulumi.getter(name="forwardingRule")
     def forwarding_rule(self) -> pulumi.Output[str]:
         """
-        Required. Immutable. The regional load balancer which the mirrored traffic should be forwarded
-        to. Format is:
-        projects/{project}/regions/{region}/forwardingRules/{forwardingRule}
+        The regional forwarding rule that fronts the mirroring collectors, for
+        example: `projects/123456789/regions/us-central1/forwardingRules/my-rule`.
+        See https://google.aip.dev/124.
         """
         return pulumi.get(self, "forwarding_rule")
 
@@ -752,7 +852,7 @@ class MirroringDeployment(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.
         """
@@ -762,7 +862,7 @@ class MirroringDeployment(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/MirroringDeployment`.
+        The cloud location of the deployment, e.g. `us-central1-a` or `asia-south1-b`.
         """
         return pulumi.get(self, "location")
 
@@ -770,8 +870,9 @@ class MirroringDeployment(pulumi.CustomResource):
     @pulumi.getter(name="mirroringDeploymentGroup")
     def mirroring_deployment_group(self) -> pulumi.Output[str]:
         """
-        Required. Immutable. The Mirroring Deployment Group that this resource is part of. Format is:
-        `projects/{project}/locations/global/mirroringDeploymentGroups/{mirroringDeploymentGroup}`
+        The deployment group that this deployment is a part of, for example:
+        `projects/123456789/locations/global/mirroringDeploymentGroups/my-dg`.
+        See https://google.aip.dev/124.
         """
         return pulumi.get(self, "mirroring_deployment_group")
 
@@ -779,9 +880,8 @@ class MirroringDeployment(pulumi.CustomResource):
     @pulumi.getter(name="mirroringDeploymentId")
     def mirroring_deployment_id(self) -> pulumi.Output[str]:
         """
-        Required. Id of the requesting object
-        If auto-generating Id server-side, remove this field and
-        mirroring_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.
 
 
         - - -
@@ -792,7 +892,9 @@ class MirroringDeployment(pulumi.CustomResource):
     @pulumi.getter
     def name(self) -> pulumi.Output[str]:
         """
-        Immutable. Identifier. The name of the MirroringDeployment.
+        The resource name of this deployment, for example:
+        `projects/123456789/locations/us-central1-a/mirroringDeployments/my-dep`.
+        See https://google.aip.dev/122 for more details.
         """
         return pulumi.get(self, "name")
 
@@ -818,8 +920,10 @@ class MirroringDeployment(pulumi.CustomResource):
     @pulumi.getter
     def reconciling(self) -> pulumi.Output[bool]:
         """
-        Output only. 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")
 
@@ -827,7 +931,8 @@ class MirroringDeployment(pulumi.CustomResource):
     @pulumi.getter
     def state(self) -> pulumi.Output[str]:
         """
-        Output only. Current state of the deployment.
+        The current state of the deployment.
+        See https://google.aip.dev/216.
         Possible values:
         STATE_UNSPECIFIED
         ACTIVE
@@ -842,7 +947,8 @@ class MirroringDeployment(pulumi.CustomResource):
     @pulumi.getter(name="updateTime")
     def update_time(self) -> pulumi.Output[str]:
         """
-        Output only. [Output only] 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")