pulumi-gcp 7.25.0a1717135845__py3-none-any.whl → 7.26.0__py3-none-any.whl

pulumi_gcp/compute/get_subnetworks.py

@@ -0,0 +1,157 @@
+# coding=utf-8
+# *** WARNING: this file was generated by the Pulumi Terraform Bridge (tfgen) Tool. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import copy
+import warnings
+import pulumi
+import pulumi.runtime
+from typing import Any, Mapping, Optional, Sequence, Union, overload
+from .. import _utilities
+from . import outputs
+
+__all__ = [
+    'GetSubnetworksResult',
+    'AwaitableGetSubnetworksResult',
+    'get_subnetworks',
+    'get_subnetworks_output',
+]
+
+@pulumi.output_type
+class GetSubnetworksResult:
+    """
+    A collection of values returned by getSubnetworks.
+    """
+    def __init__(__self__, filter=None, id=None, project=None, region=None, subnetworks=None):
+        if filter and not isinstance(filter, str):
+            raise TypeError("Expected argument 'filter' to be a str")
+        pulumi.set(__self__, "filter", filter)
+        if id and not isinstance(id, str):
+            raise TypeError("Expected argument 'id' to be a str")
+        pulumi.set(__self__, "id", id)
+        if project and not isinstance(project, str):
+            raise TypeError("Expected argument 'project' to be a str")
+        pulumi.set(__self__, "project", project)
+        if region and not isinstance(region, str):
+            raise TypeError("Expected argument 'region' to be a str")
+        pulumi.set(__self__, "region", region)
+        if subnetworks and not isinstance(subnetworks, list):
+            raise TypeError("Expected argument 'subnetworks' to be a list")
+        pulumi.set(__self__, "subnetworks", subnetworks)
+
+    @property
+    @pulumi.getter
+    def filter(self) -> Optional[str]:
+        return pulumi.get(self, "filter")
+
+    @property
+    @pulumi.getter
+    def id(self) -> str:
+        """
+        The provider-assigned unique ID for this managed resource.
+        """
+        return pulumi.get(self, "id")
+
+    @property
+    @pulumi.getter
+    def project(self) -> Optional[str]:
+        return pulumi.get(self, "project")
+
+    @property
+    @pulumi.getter
+    def region(self) -> Optional[str]:
+        return pulumi.get(self, "region")
+
+    @property
+    @pulumi.getter
+    def subnetworks(self) -> Sequence['outputs.GetSubnetworksSubnetworkResult']:
+        """
+        A list of all retrieved GCE subnetworks. Structure is defined below.
+        """
+        return pulumi.get(self, "subnetworks")
+
+
+class AwaitableGetSubnetworksResult(GetSubnetworksResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return GetSubnetworksResult(
+            filter=self.filter,
+            id=self.id,
+            project=self.project,
+            region=self.region,
+            subnetworks=self.subnetworks)
+
+
+def get_subnetworks(filter: Optional[str] = None,
+                    project: Optional[str] = None,
+                    region: Optional[str] = None,
+                    opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetSubnetworksResult:
+    """
+    Get subnetworks within GCE.
+    See [the official documentation](https://cloud.google.com/vpc/docs/subnets)
+    and [API](https://cloud.google.com/compute/docs/reference/rest/v1/subnetworks/list).
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_gcp as gcp
+
+    my_subnetworks = gcp.compute.get_subnetworks(filter="ipCidrRange eq 192.168.178.0/24",
+        project="my-project",
+        region="us-east1")
+    ```
+
+
+    :param str filter: A string filter as defined in the [REST API](https://cloud.google.com/compute/docs/reference/rest/v1/subnetworks/list#query-parameters).
+    :param str project: The ID of the project in which the resource belongs. If it
+           is not provided, the provider project is used.
+    :param str region: The region this subnetwork has been created in. If
+           unspecified, this defaults to the region configured in the provider.
+    """
+    __args__ = dict()
+    __args__['filter'] = filter
+    __args__['project'] = project
+    __args__['region'] = region
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('gcp:compute/getSubnetworks:getSubnetworks', __args__, opts=opts, typ=GetSubnetworksResult).value
+
+    return AwaitableGetSubnetworksResult(
+        filter=pulumi.get(__ret__, 'filter'),
+        id=pulumi.get(__ret__, 'id'),
+        project=pulumi.get(__ret__, 'project'),
+        region=pulumi.get(__ret__, 'region'),
+        subnetworks=pulumi.get(__ret__, 'subnetworks'))
+
+
+@_utilities.lift_output_func(get_subnetworks)
+def get_subnetworks_output(filter: Optional[pulumi.Input[Optional[str]]] = None,
+                           project: Optional[pulumi.Input[Optional[str]]] = None,
+                           region: Optional[pulumi.Input[Optional[str]]] = None,
+                           opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetSubnetworksResult]:
+    """
+    Get subnetworks within GCE.
+    See [the official documentation](https://cloud.google.com/vpc/docs/subnets)
+    and [API](https://cloud.google.com/compute/docs/reference/rest/v1/subnetworks/list).
+
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_gcp as gcp
+
+    my_subnetworks = gcp.compute.get_subnetworks(filter="ipCidrRange eq 192.168.178.0/24",
+        project="my-project",
+        region="us-east1")
+    ```
+
+
+    :param str filter: A string filter as defined in the [REST API](https://cloud.google.com/compute/docs/reference/rest/v1/subnetworks/list#query-parameters).
+    :param str project: The ID of the project in which the resource belongs. If it
+           is not provided, the provider project is used.
+    :param str region: The region this subnetwork has been created in. If
+           unspecified, this defaults to the region configured in the provider.
+    """
+    ...

pulumi_gcp/compute/instance_group_membership.py

@@ -189,7 +189,7 @@ class InstanceGroupMembership(pulumi.CustomResource):
         > **NOTE** This resource has been added to avoid a situation, where after
         Instance is recreated, it's removed from Instance Group and it's needed to
         perform `apply` twice. To avoid situations like this, please use this resource
-        with the lifecycle `update_triggered_by` method, with the passed Instance's ID.
+        with the lifecycle `replace_triggered_by` method, with the passed Instance's ID.
 
         To get more information about InstanceGroupMembership, see:
 
@@ -282,7 +282,7 @@ class InstanceGroupMembership(pulumi.CustomResource):
         > **NOTE** This resource has been added to avoid a situation, where after
         Instance is recreated, it's removed from Instance Group and it's needed to
         perform `apply` twice. To avoid situations like this, please use this resource
-        with the lifecycle `update_triggered_by` method, with the passed Instance's ID.
+        with the lifecycle `replace_triggered_by` method, with the passed Instance's ID.
 
         To get more information about InstanceGroupMembership, see:
 

pulumi_gcp/compute/interconnect_attachment.py

@@ -30,6 +30,7 @@ class InterconnectAttachmentArgs:
                  project: Optional[pulumi.Input[str]] = None,
                  region: Optional[pulumi.Input[str]] = None,
                  stack_type: Optional[pulumi.Input[str]] = None,
+                 subnet_length: Optional[pulumi.Input[int]] = None,
                  type: Optional[pulumi.Input[str]] = None,
                  vlan_tag8021q: Optional[pulumi.Input[int]] = None):
         """
@@ -110,6 +111,12 @@ class InterconnectAttachmentArgs:
                This field can be both set at interconnect attachments creation and update
                interconnect attachment operations.
                Possible values are: `IPV4_IPV6`, `IPV4_ONLY`.
+        :param pulumi.Input[int] subnet_length: Length of the IPv4 subnet mask. Allowed values: 29 (default), 30. The default value is 29,
+               except for Cross-Cloud Interconnect connections that use an InterconnectRemoteLocation with a
+               constraints.subnetLengthRange.min equal to 30. For example, connections that use an Azure
+               remote location fall into this category. In these cases, the default value is 30, and
+               requesting 29 returns an error. Where both 29 and 30 are allowed, 29 is preferred, because it
+               gives Google Cloud Support more debugging visibility.
         :param pulumi.Input[str] type: The type of InterconnectAttachment you wish to create. Defaults to
                DEDICATED.
                Possible values are: `DEDICATED`, `PARTNER`, `PARTNER_PROVIDER`.
@@ -143,6 +150,8 @@ class InterconnectAttachmentArgs:
             pulumi.set(__self__, "region", region)
         if stack_type is not None:
             pulumi.set(__self__, "stack_type", stack_type)
+        if subnet_length is not None:
+            pulumi.set(__self__, "subnet_length", subnet_length)
         if type is not None:
             pulumi.set(__self__, "type", type)
         if vlan_tag8021q is not None:
@@ -378,6 +387,23 @@ class InterconnectAttachmentArgs:
     def stack_type(self, value: Optional[pulumi.Input[str]]):
         pulumi.set(self, "stack_type", value)
 
+    @property
+    @pulumi.getter(name="subnetLength")
+    def subnet_length(self) -> Optional[pulumi.Input[int]]:
+        """
+        Length of the IPv4 subnet mask. Allowed values: 29 (default), 30. The default value is 29,
+        except for Cross-Cloud Interconnect connections that use an InterconnectRemoteLocation with a
+        constraints.subnetLengthRange.min equal to 30. For example, connections that use an Azure
+        remote location fall into this category. In these cases, the default value is 30, and
+        requesting 29 returns an error. Where both 29 and 30 are allowed, 29 is preferred, because it
+        gives Google Cloud Support more debugging visibility.
+        """
+        return pulumi.get(self, "subnet_length")
+
+    @subnet_length.setter
+    def subnet_length(self, value: Optional[pulumi.Input[int]]):
+        pulumi.set(self, "subnet_length", value)
+
     @property
     @pulumi.getter
     def type(self) -> Optional[pulumi.Input[str]]:
@@ -434,6 +460,7 @@ class _InterconnectAttachmentState:
                  self_link: Optional[pulumi.Input[str]] = None,
                  stack_type: Optional[pulumi.Input[str]] = None,
                  state: Optional[pulumi.Input[str]] = None,
+                 subnet_length: Optional[pulumi.Input[int]] = None,
                  type: Optional[pulumi.Input[str]] = None,
                  vlan_tag8021q: Optional[pulumi.Input[int]] = None):
         """
@@ -536,6 +563,12 @@ class _InterconnectAttachmentState:
                interconnect attachment operations.
                Possible values are: `IPV4_IPV6`, `IPV4_ONLY`.
         :param pulumi.Input[str] state: [Output Only] The current state of this attachment's functionality.
+        :param pulumi.Input[int] subnet_length: Length of the IPv4 subnet mask. Allowed values: 29 (default), 30. The default value is 29,
+               except for Cross-Cloud Interconnect connections that use an InterconnectRemoteLocation with a
+               constraints.subnetLengthRange.min equal to 30. For example, connections that use an Azure
+               remote location fall into this category. In these cases, the default value is 30, and
+               requesting 29 returns an error. Where both 29 and 30 are allowed, 29 is preferred, because it
+               gives Google Cloud Support more debugging visibility.
         :param pulumi.Input[str] type: The type of InterconnectAttachment you wish to create. Defaults to
                DEDICATED.
                Possible values are: `DEDICATED`, `PARTNER`, `PARTNER_PROVIDER`.
@@ -592,6 +625,8 @@ class _InterconnectAttachmentState:
             pulumi.set(__self__, "stack_type", stack_type)
         if state is not None:
             pulumi.set(__self__, "state", state)
+        if subnet_length is not None:
+            pulumi.set(__self__, "subnet_length", subnet_length)
         if type is not None:
             pulumi.set(__self__, "type", type)
         if vlan_tag8021q is not None:
@@ -970,6 +1005,23 @@ class _InterconnectAttachmentState:
     def state(self, value: Optional[pulumi.Input[str]]):
         pulumi.set(self, "state", value)
 
+    @property
+    @pulumi.getter(name="subnetLength")
+    def subnet_length(self) -> Optional[pulumi.Input[int]]:
+        """
+        Length of the IPv4 subnet mask. Allowed values: 29 (default), 30. The default value is 29,
+        except for Cross-Cloud Interconnect connections that use an InterconnectRemoteLocation with a
+        constraints.subnetLengthRange.min equal to 30. For example, connections that use an Azure
+        remote location fall into this category. In these cases, the default value is 30, and
+        requesting 29 returns an error. Where both 29 and 30 are allowed, 29 is preferred, because it
+        gives Google Cloud Support more debugging visibility.
+        """
+        return pulumi.get(self, "subnet_length")
+
+    @subnet_length.setter
+    def subnet_length(self, value: Optional[pulumi.Input[int]]):
+        pulumi.set(self, "subnet_length", value)
+
     @property
     @pulumi.getter
     def type(self) -> Optional[pulumi.Input[str]]:
@@ -1017,6 +1069,7 @@ class InterconnectAttachment(pulumi.CustomResource):
                  region: Optional[pulumi.Input[str]] = None,
                  router: Optional[pulumi.Input[str]] = None,
                  stack_type: Optional[pulumi.Input[str]] = None,
+                 subnet_length: Optional[pulumi.Input[int]] = None,
                  type: Optional[pulumi.Input[str]] = None,
                  vlan_tag8021q: Optional[pulumi.Input[int]] = None,
                  __props__=None):
@@ -1188,6 +1241,12 @@ class InterconnectAttachment(pulumi.CustomResource):
                This field can be both set at interconnect attachments creation and update
                interconnect attachment operations.
                Possible values are: `IPV4_IPV6`, `IPV4_ONLY`.
+        :param pulumi.Input[int] subnet_length: Length of the IPv4 subnet mask. Allowed values: 29 (default), 30. The default value is 29,
+               except for Cross-Cloud Interconnect connections that use an InterconnectRemoteLocation with a
+               constraints.subnetLengthRange.min equal to 30. For example, connections that use an Azure
+               remote location fall into this category. In these cases, the default value is 30, and
+               requesting 29 returns an error. Where both 29 and 30 are allowed, 29 is preferred, because it
+               gives Google Cloud Support more debugging visibility.
         :param pulumi.Input[str] type: The type of InterconnectAttachment you wish to create. Defaults to
                DEDICATED.
                Possible values are: `DEDICATED`, `PARTNER`, `PARTNER_PROVIDER`.
@@ -1319,6 +1378,7 @@ class InterconnectAttachment(pulumi.CustomResource):
                  region: Optional[pulumi.Input[str]] = None,
                  router: Optional[pulumi.Input[str]] = None,
                  stack_type: Optional[pulumi.Input[str]] = None,
+                 subnet_length: Optional[pulumi.Input[int]] = None,
                  type: Optional[pulumi.Input[str]] = None,
                  vlan_tag8021q: Optional[pulumi.Input[int]] = None,
                  __props__=None):
@@ -1346,6 +1406,7 @@ class InterconnectAttachment(pulumi.CustomResource):
                 raise TypeError("Missing required property 'router'")
             __props__.__dict__["router"] = router
             __props__.__dict__["stack_type"] = stack_type
+            __props__.__dict__["subnet_length"] = subnet_length
             __props__.__dict__["type"] = type
             __props__.__dict__["vlan_tag8021q"] = vlan_tag8021q
             __props__.__dict__["cloud_router_ip_address"] = None
@@ -1394,6 +1455,7 @@ class InterconnectAttachment(pulumi.CustomResource):
             self_link: Optional[pulumi.Input[str]] = None,
             stack_type: Optional[pulumi.Input[str]] = None,
             state: Optional[pulumi.Input[str]] = None,
+            subnet_length: Optional[pulumi.Input[int]] = None,
             type: Optional[pulumi.Input[str]] = None,
             vlan_tag8021q: Optional[pulumi.Input[int]] = None) -> 'InterconnectAttachment':
         """
@@ -1501,6 +1563,12 @@ class InterconnectAttachment(pulumi.CustomResource):
                interconnect attachment operations.
                Possible values are: `IPV4_IPV6`, `IPV4_ONLY`.
         :param pulumi.Input[str] state: [Output Only] The current state of this attachment's functionality.
+        :param pulumi.Input[int] subnet_length: Length of the IPv4 subnet mask. Allowed values: 29 (default), 30. The default value is 29,
+               except for Cross-Cloud Interconnect connections that use an InterconnectRemoteLocation with a
+               constraints.subnetLengthRange.min equal to 30. For example, connections that use an Azure
+               remote location fall into this category. In these cases, the default value is 30, and
+               requesting 29 returns an error. Where both 29 and 30 are allowed, 29 is preferred, because it
+               gives Google Cloud Support more debugging visibility.
         :param pulumi.Input[str] type: The type of InterconnectAttachment you wish to create. Defaults to
                DEDICATED.
                Possible values are: `DEDICATED`, `PARTNER`, `PARTNER_PROVIDER`.
@@ -1536,6 +1604,7 @@ class InterconnectAttachment(pulumi.CustomResource):
         __props__.__dict__["self_link"] = self_link
         __props__.__dict__["stack_type"] = stack_type
         __props__.__dict__["state"] = state
+        __props__.__dict__["subnet_length"] = subnet_length
         __props__.__dict__["type"] = type
         __props__.__dict__["vlan_tag8021q"] = vlan_tag8021q
         return InterconnectAttachment(resource_name, opts=opts, __props__=__props__)
@@ -1813,6 +1882,19 @@ class InterconnectAttachment(pulumi.CustomResource):
         """
         return pulumi.get(self, "state")
 
+    @property
+    @pulumi.getter(name="subnetLength")
+    def subnet_length(self) -> pulumi.Output[Optional[int]]:
+        """
+        Length of the IPv4 subnet mask. Allowed values: 29 (default), 30. The default value is 29,
+        except for Cross-Cloud Interconnect connections that use an InterconnectRemoteLocation with a
+        constraints.subnetLengthRange.min equal to 30. For example, connections that use an Azure
+        remote location fall into this category. In these cases, the default value is 30, and
+        requesting 29 returns an error. Where both 29 and 30 are allowed, 29 is preferred, because it
+        gives Google Cloud Support more debugging visibility.
+        """
+        return pulumi.get(self, "subnet_length")
+
     @property
     @pulumi.getter
     def type(self) -> pulumi.Output[str]:

pulumi_gcp/compute/network_endpoint.py

@@ -278,7 +278,7 @@ class NetworkEndpoint(pulumi.CustomResource):
 
         > **NOTE** In case the Endpoint's Instance is recreated, it's needed to
         perform `apply` twice. To avoid situations like this, please use this resource
-        with the lifecycle `update_triggered_by` method, with the passed Instance's ID.
+        with the lifecycle `replace_triggered_by` method, with the passed Instance's ID.
 
         To get more information about NetworkEndpoint, see:
 
@@ -393,7 +393,7 @@ class NetworkEndpoint(pulumi.CustomResource):
 
         > **NOTE** In case the Endpoint's Instance is recreated, it's needed to
         perform `apply` twice. To avoid situations like this, please use this resource
-        with the lifecycle `update_triggered_by` method, with the passed Instance's ID.
+        with the lifecycle `replace_triggered_by` method, with the passed Instance's ID.
 
         To get more information about NetworkEndpoint, see:
 

pulumi_gcp/compute/network_endpoint_list.py

@@ -206,7 +206,7 @@ class NetworkEndpointList(pulumi.CustomResource):
 
         > **NOTE** In case the Endpoint's Instance is recreated, it's needed to
         perform `apply` twice. To avoid situations like this, please use this resource
-        with the lifecycle `update_triggered_by` method, with the passed Instance's ID.
+        with the lifecycle `replace_triggered_by` method, with the passed Instance's ID.
 
         To get more information about NetworkEndpoints, see:
 
@@ -340,7 +340,7 @@ class NetworkEndpointList(pulumi.CustomResource):
 
         > **NOTE** In case the Endpoint's Instance is recreated, it's needed to
         perform `apply` twice. To avoid situations like this, please use this resource
-        with the lifecycle `update_triggered_by` method, with the passed Instance's ID.
+        with the lifecycle `replace_triggered_by` method, with the passed Instance's ID.
 
         To get more information about NetworkEndpoints, see: