1. Packages
  2. Google Cloud Native
  3. API Docs
  4. networkconnectivity
  5. networkconnectivity/v1
  6. InternalRange

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi

google-native.networkconnectivity/v1.InternalRange

Explore with Pulumi AI

google-native logo

Google Cloud Native is in preview. Google Cloud Classic is fully supported.

Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi

    Creates a new internal range in a given project and location.

    Create InternalRange Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new InternalRange(name: string, args?: InternalRangeArgs, opts?: CustomResourceOptions);
    @overload
    def InternalRange(resource_name: str,
                      args: Optional[InternalRangeArgs] = None,
                      opts: Optional[ResourceOptions] = None)
    
    @overload
    def InternalRange(resource_name: str,
                      opts: Optional[ResourceOptions] = None,
                      create_time: Optional[str] = None,
                      description: Optional[str] = None,
                      internal_range_id: Optional[str] = None,
                      ip_cidr_range: Optional[str] = None,
                      labels: Optional[Mapping[str, str]] = None,
                      location: Optional[str] = None,
                      name: Optional[str] = None,
                      network: Optional[str] = None,
                      overlaps: Optional[Sequence[InternalRangeOverlapsItem]] = None,
                      peering: Optional[InternalRangePeering] = None,
                      prefix_length: Optional[int] = None,
                      project: Optional[str] = None,
                      request_id: Optional[str] = None,
                      target_cidr_range: Optional[Sequence[str]] = None,
                      update_time: Optional[str] = None,
                      usage: Optional[InternalRangeUsage] = None)
    func NewInternalRange(ctx *Context, name string, args *InternalRangeArgs, opts ...ResourceOption) (*InternalRange, error)
    public InternalRange(string name, InternalRangeArgs? args = null, CustomResourceOptions? opts = null)
    public InternalRange(String name, InternalRangeArgs args)
    public InternalRange(String name, InternalRangeArgs args, CustomResourceOptions options)
    
    type: google-native:networkconnectivity/v1:InternalRange
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args InternalRangeArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args InternalRangeArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args InternalRangeArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args InternalRangeArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args InternalRangeArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var internalRangeResource = new GoogleNative.NetworkConnectivity.V1.InternalRange("internalRangeResource", new()
    {
        CreateTime = "string",
        Description = "string",
        InternalRangeId = "string",
        IpCidrRange = "string",
        Labels = 
        {
            { "string", "string" },
        },
        Location = "string",
        Name = "string",
        Network = "string",
        Overlaps = new[]
        {
            GoogleNative.NetworkConnectivity.V1.InternalRangeOverlapsItem.OverlapUnspecified,
        },
        Peering = GoogleNative.NetworkConnectivity.V1.InternalRangePeering.PeeringUnspecified,
        PrefixLength = 0,
        Project = "string",
        RequestId = "string",
        TargetCidrRange = new[]
        {
            "string",
        },
        UpdateTime = "string",
        Usage = GoogleNative.NetworkConnectivity.V1.InternalRangeUsage.UsageUnspecified,
    });
    
    example, err := networkconnectivity.NewInternalRange(ctx, "internalRangeResource", &networkconnectivity.InternalRangeArgs{
    CreateTime: pulumi.String("string"),
    Description: pulumi.String("string"),
    InternalRangeId: pulumi.String("string"),
    IpCidrRange: pulumi.String("string"),
    Labels: pulumi.StringMap{
    "string": pulumi.String("string"),
    },
    Location: pulumi.String("string"),
    Name: pulumi.String("string"),
    Network: pulumi.String("string"),
    Overlaps: networkconnectivity.InternalRangeOverlapsItemArray{
    networkconnectivity.InternalRangeOverlapsItemOverlapUnspecified,
    },
    Peering: networkconnectivity.InternalRangePeeringPeeringUnspecified,
    PrefixLength: pulumi.Int(0),
    Project: pulumi.String("string"),
    RequestId: pulumi.String("string"),
    TargetCidrRange: pulumi.StringArray{
    pulumi.String("string"),
    },
    UpdateTime: pulumi.String("string"),
    Usage: networkconnectivity.InternalRangeUsageUsageUnspecified,
    })
    
    var internalRangeResource = new InternalRange("internalRangeResource", InternalRangeArgs.builder()
        .createTime("string")
        .description("string")
        .internalRangeId("string")
        .ipCidrRange("string")
        .labels(Map.of("string", "string"))
        .location("string")
        .name("string")
        .network("string")
        .overlaps("OVERLAP_UNSPECIFIED")
        .peering("PEERING_UNSPECIFIED")
        .prefixLength(0)
        .project("string")
        .requestId("string")
        .targetCidrRange("string")
        .updateTime("string")
        .usage("USAGE_UNSPECIFIED")
        .build());
    
    internal_range_resource = google_native.networkconnectivity.v1.InternalRange("internalRangeResource",
        create_time="string",
        description="string",
        internal_range_id="string",
        ip_cidr_range="string",
        labels={
            "string": "string",
        },
        location="string",
        name="string",
        network="string",
        overlaps=[google_native.networkconnectivity.v1.InternalRangeOverlapsItem.OVERLAP_UNSPECIFIED],
        peering=google_native.networkconnectivity.v1.InternalRangePeering.PEERING_UNSPECIFIED,
        prefix_length=0,
        project="string",
        request_id="string",
        target_cidr_range=["string"],
        update_time="string",
        usage=google_native.networkconnectivity.v1.InternalRangeUsage.USAGE_UNSPECIFIED)
    
    const internalRangeResource = new google_native.networkconnectivity.v1.InternalRange("internalRangeResource", {
        createTime: "string",
        description: "string",
        internalRangeId: "string",
        ipCidrRange: "string",
        labels: {
            string: "string",
        },
        location: "string",
        name: "string",
        network: "string",
        overlaps: [google_native.networkconnectivity.v1.InternalRangeOverlapsItem.OverlapUnspecified],
        peering: google_native.networkconnectivity.v1.InternalRangePeering.PeeringUnspecified,
        prefixLength: 0,
        project: "string",
        requestId: "string",
        targetCidrRange: ["string"],
        updateTime: "string",
        usage: google_native.networkconnectivity.v1.InternalRangeUsage.UsageUnspecified,
    });
    
    type: google-native:networkconnectivity/v1:InternalRange
    properties:
        createTime: string
        description: string
        internalRangeId: string
        ipCidrRange: string
        labels:
            string: string
        location: string
        name: string
        network: string
        overlaps:
            - OVERLAP_UNSPECIFIED
        peering: PEERING_UNSPECIFIED
        prefixLength: 0
        project: string
        requestId: string
        targetCidrRange:
            - string
        updateTime: string
        usage: USAGE_UNSPECIFIED
    

    InternalRange Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    The InternalRange resource accepts the following input properties:

    CreateTime string
    Time when the internal range was created.
    Description string
    A description of this resource.
    InternalRangeId string
    Optional. Resource ID (i.e. 'foo' in '[...]/projects/p/locations/l/internalRanges/foo') See https://google.aip.dev/122#resource-id-segments Unique per location.
    IpCidrRange string
    The IP range that this internal range defines.
    Labels Dictionary<string, string>
    User-defined labels.
    Location string
    Name string
    Immutable. The name of an internal range. Format: projects/{project}/locations/{location}/internalRanges/{internal_range} See: https://google.aip.dev/122#fields-representing-resource-names
    Network string
    The URL or resource ID of the network in which to reserve the internal range. The network cannot be deleted if there are any reserved internal ranges referring to it. Legacy networks are not supported. This can only be specified for a global internal address. Example: - URL: /compute/v1/projects/{project}/global/networks/{resourceId} - ID: network123
    Overlaps List<Pulumi.GoogleNative.NetworkConnectivity.V1.InternalRangeOverlapsItem>
    Optional. Types of resources that are allowed to overlap with the current internal range.
    Peering Pulumi.GoogleNative.NetworkConnectivity.V1.InternalRangePeering
    The type of peering set for this internal range.
    PrefixLength int
    An alternate to ip_cidr_range. Can be set when trying to create a reservation that automatically finds a free range of the given size. If both ip_cidr_range and prefix_length are set, there is an error if the range sizes do not match. Can also be used during updates to change the range size.
    Project string
    RequestId string
    Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
    TargetCidrRange List<string>
    Optional. Can be set to narrow down or pick a different address space while searching for a free range. If not set, defaults to the "10.0.0.0/8" address space. This can be used to search in other rfc-1918 address spaces like "172.16.0.0/12" and "192.168.0.0/16" or non-rfc-1918 address spaces used in the VPC.
    UpdateTime string
    Time when the internal range was updated.
    Usage Pulumi.GoogleNative.NetworkConnectivity.V1.InternalRangeUsage
    The type of usage set for this InternalRange.
    CreateTime string
    Time when the internal range was created.
    Description string
    A description of this resource.
    InternalRangeId string
    Optional. Resource ID (i.e. 'foo' in '[...]/projects/p/locations/l/internalRanges/foo') See https://google.aip.dev/122#resource-id-segments Unique per location.
    IpCidrRange string
    The IP range that this internal range defines.
    Labels map[string]string
    User-defined labels.
    Location string
    Name string
    Immutable. The name of an internal range. Format: projects/{project}/locations/{location}/internalRanges/{internal_range} See: https://google.aip.dev/122#fields-representing-resource-names
    Network string
    The URL or resource ID of the network in which to reserve the internal range. The network cannot be deleted if there are any reserved internal ranges referring to it. Legacy networks are not supported. This can only be specified for a global internal address. Example: - URL: /compute/v1/projects/{project}/global/networks/{resourceId} - ID: network123
    Overlaps []InternalRangeOverlapsItem
    Optional. Types of resources that are allowed to overlap with the current internal range.
    Peering InternalRangePeering
    The type of peering set for this internal range.
    PrefixLength int
    An alternate to ip_cidr_range. Can be set when trying to create a reservation that automatically finds a free range of the given size. If both ip_cidr_range and prefix_length are set, there is an error if the range sizes do not match. Can also be used during updates to change the range size.
    Project string
    RequestId string
    Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
    TargetCidrRange []string
    Optional. Can be set to narrow down or pick a different address space while searching for a free range. If not set, defaults to the "10.0.0.0/8" address space. This can be used to search in other rfc-1918 address spaces like "172.16.0.0/12" and "192.168.0.0/16" or non-rfc-1918 address spaces used in the VPC.
    UpdateTime string
    Time when the internal range was updated.
    Usage InternalRangeUsage
    The type of usage set for this InternalRange.
    createTime String
    Time when the internal range was created.
    description String
    A description of this resource.
    internalRangeId String
    Optional. Resource ID (i.e. 'foo' in '[...]/projects/p/locations/l/internalRanges/foo') See https://google.aip.dev/122#resource-id-segments Unique per location.
    ipCidrRange String
    The IP range that this internal range defines.
    labels Map<String,String>
    User-defined labels.
    location String
    name String
    Immutable. The name of an internal range. Format: projects/{project}/locations/{location}/internalRanges/{internal_range} See: https://google.aip.dev/122#fields-representing-resource-names
    network String
    The URL or resource ID of the network in which to reserve the internal range. The network cannot be deleted if there are any reserved internal ranges referring to it. Legacy networks are not supported. This can only be specified for a global internal address. Example: - URL: /compute/v1/projects/{project}/global/networks/{resourceId} - ID: network123
    overlaps List<InternalRangeOverlapsItem>
    Optional. Types of resources that are allowed to overlap with the current internal range.
    peering InternalRangePeering
    The type of peering set for this internal range.
    prefixLength Integer
    An alternate to ip_cidr_range. Can be set when trying to create a reservation that automatically finds a free range of the given size. If both ip_cidr_range and prefix_length are set, there is an error if the range sizes do not match. Can also be used during updates to change the range size.
    project String
    requestId String
    Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
    targetCidrRange List<String>
    Optional. Can be set to narrow down or pick a different address space while searching for a free range. If not set, defaults to the "10.0.0.0/8" address space. This can be used to search in other rfc-1918 address spaces like "172.16.0.0/12" and "192.168.0.0/16" or non-rfc-1918 address spaces used in the VPC.
    updateTime String
    Time when the internal range was updated.
    usage InternalRangeUsage
    The type of usage set for this InternalRange.
    createTime string
    Time when the internal range was created.
    description string
    A description of this resource.
    internalRangeId string
    Optional. Resource ID (i.e. 'foo' in '[...]/projects/p/locations/l/internalRanges/foo') See https://google.aip.dev/122#resource-id-segments Unique per location.
    ipCidrRange string
    The IP range that this internal range defines.
    labels {[key: string]: string}
    User-defined labels.
    location string
    name string
    Immutable. The name of an internal range. Format: projects/{project}/locations/{location}/internalRanges/{internal_range} See: https://google.aip.dev/122#fields-representing-resource-names
    network string
    The URL or resource ID of the network in which to reserve the internal range. The network cannot be deleted if there are any reserved internal ranges referring to it. Legacy networks are not supported. This can only be specified for a global internal address. Example: - URL: /compute/v1/projects/{project}/global/networks/{resourceId} - ID: network123
    overlaps InternalRangeOverlapsItem[]
    Optional. Types of resources that are allowed to overlap with the current internal range.
    peering InternalRangePeering
    The type of peering set for this internal range.
    prefixLength number
    An alternate to ip_cidr_range. Can be set when trying to create a reservation that automatically finds a free range of the given size. If both ip_cidr_range and prefix_length are set, there is an error if the range sizes do not match. Can also be used during updates to change the range size.
    project string
    requestId string
    Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
    targetCidrRange string[]
    Optional. Can be set to narrow down or pick a different address space while searching for a free range. If not set, defaults to the "10.0.0.0/8" address space. This can be used to search in other rfc-1918 address spaces like "172.16.0.0/12" and "192.168.0.0/16" or non-rfc-1918 address spaces used in the VPC.
    updateTime string
    Time when the internal range was updated.
    usage InternalRangeUsage
    The type of usage set for this InternalRange.
    create_time str
    Time when the internal range was created.
    description str
    A description of this resource.
    internal_range_id str
    Optional. Resource ID (i.e. 'foo' in '[...]/projects/p/locations/l/internalRanges/foo') See https://google.aip.dev/122#resource-id-segments Unique per location.
    ip_cidr_range str
    The IP range that this internal range defines.
    labels Mapping[str, str]
    User-defined labels.
    location str
    name str
    Immutable. The name of an internal range. Format: projects/{project}/locations/{location}/internalRanges/{internal_range} See: https://google.aip.dev/122#fields-representing-resource-names
    network str
    The URL or resource ID of the network in which to reserve the internal range. The network cannot be deleted if there are any reserved internal ranges referring to it. Legacy networks are not supported. This can only be specified for a global internal address. Example: - URL: /compute/v1/projects/{project}/global/networks/{resourceId} - ID: network123
    overlaps Sequence[InternalRangeOverlapsItem]
    Optional. Types of resources that are allowed to overlap with the current internal range.
    peering InternalRangePeering
    The type of peering set for this internal range.
    prefix_length int
    An alternate to ip_cidr_range. Can be set when trying to create a reservation that automatically finds a free range of the given size. If both ip_cidr_range and prefix_length are set, there is an error if the range sizes do not match. Can also be used during updates to change the range size.
    project str
    request_id str
    Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
    target_cidr_range Sequence[str]
    Optional. Can be set to narrow down or pick a different address space while searching for a free range. If not set, defaults to the "10.0.0.0/8" address space. This can be used to search in other rfc-1918 address spaces like "172.16.0.0/12" and "192.168.0.0/16" or non-rfc-1918 address spaces used in the VPC.
    update_time str
    Time when the internal range was updated.
    usage InternalRangeUsage
    The type of usage set for this InternalRange.
    createTime String
    Time when the internal range was created.
    description String
    A description of this resource.
    internalRangeId String
    Optional. Resource ID (i.e. 'foo' in '[...]/projects/p/locations/l/internalRanges/foo') See https://google.aip.dev/122#resource-id-segments Unique per location.
    ipCidrRange String
    The IP range that this internal range defines.
    labels Map<String>
    User-defined labels.
    location String
    name String
    Immutable. The name of an internal range. Format: projects/{project}/locations/{location}/internalRanges/{internal_range} See: https://google.aip.dev/122#fields-representing-resource-names
    network String
    The URL or resource ID of the network in which to reserve the internal range. The network cannot be deleted if there are any reserved internal ranges referring to it. Legacy networks are not supported. This can only be specified for a global internal address. Example: - URL: /compute/v1/projects/{project}/global/networks/{resourceId} - ID: network123
    overlaps List<"OVERLAP_UNSPECIFIED" | "OVERLAP_ROUTE_RANGE" | "OVERLAP_EXISTING_SUBNET_RANGE">
    Optional. Types of resources that are allowed to overlap with the current internal range.
    peering "PEERING_UNSPECIFIED" | "FOR_SELF" | "FOR_PEER" | "NOT_SHARED"
    The type of peering set for this internal range.
    prefixLength Number
    An alternate to ip_cidr_range. Can be set when trying to create a reservation that automatically finds a free range of the given size. If both ip_cidr_range and prefix_length are set, there is an error if the range sizes do not match. Can also be used during updates to change the range size.
    project String
    requestId String
    Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
    targetCidrRange List<String>
    Optional. Can be set to narrow down or pick a different address space while searching for a free range. If not set, defaults to the "10.0.0.0/8" address space. This can be used to search in other rfc-1918 address spaces like "172.16.0.0/12" and "192.168.0.0/16" or non-rfc-1918 address spaces used in the VPC.
    updateTime String
    Time when the internal range was updated.
    usage "USAGE_UNSPECIFIED" | "FOR_VPC" | "EXTERNAL_TO_VPC"
    The type of usage set for this InternalRange.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the InternalRange resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Users List<string>
    The list of resources that refer to this internal range. Resources that use the internal range for their range allocation are referred to as users of the range. Other resources mark themselves as users while doing so by creating a reference to this internal range. Having a user, based on this reference, prevents deletion of the internal range referred to. Can be empty.
    Id string
    The provider-assigned unique ID for this managed resource.
    Users []string
    The list of resources that refer to this internal range. Resources that use the internal range for their range allocation are referred to as users of the range. Other resources mark themselves as users while doing so by creating a reference to this internal range. Having a user, based on this reference, prevents deletion of the internal range referred to. Can be empty.
    id String
    The provider-assigned unique ID for this managed resource.
    users List<String>
    The list of resources that refer to this internal range. Resources that use the internal range for their range allocation are referred to as users of the range. Other resources mark themselves as users while doing so by creating a reference to this internal range. Having a user, based on this reference, prevents deletion of the internal range referred to. Can be empty.
    id string
    The provider-assigned unique ID for this managed resource.
    users string[]
    The list of resources that refer to this internal range. Resources that use the internal range for their range allocation are referred to as users of the range. Other resources mark themselves as users while doing so by creating a reference to this internal range. Having a user, based on this reference, prevents deletion of the internal range referred to. Can be empty.
    id str
    The provider-assigned unique ID for this managed resource.
    users Sequence[str]
    The list of resources that refer to this internal range. Resources that use the internal range for their range allocation are referred to as users of the range. Other resources mark themselves as users while doing so by creating a reference to this internal range. Having a user, based on this reference, prevents deletion of the internal range referred to. Can be empty.
    id String
    The provider-assigned unique ID for this managed resource.
    users List<String>
    The list of resources that refer to this internal range. Resources that use the internal range for their range allocation are referred to as users of the range. Other resources mark themselves as users while doing so by creating a reference to this internal range. Having a user, based on this reference, prevents deletion of the internal range referred to. Can be empty.

    Supporting Types

    InternalRangeOverlapsItem, InternalRangeOverlapsItemArgs

    OverlapUnspecified
    OVERLAP_UNSPECIFIEDNo overlap overrides.
    OverlapRouteRange
    OVERLAP_ROUTE_RANGEAllow creation of static routes more specific that the current internal range.
    OverlapExistingSubnetRange
    OVERLAP_EXISTING_SUBNET_RANGEAllow creation of internal ranges that overlap with existing subnets.
    InternalRangeOverlapsItemOverlapUnspecified
    OVERLAP_UNSPECIFIEDNo overlap overrides.
    InternalRangeOverlapsItemOverlapRouteRange
    OVERLAP_ROUTE_RANGEAllow creation of static routes more specific that the current internal range.
    InternalRangeOverlapsItemOverlapExistingSubnetRange
    OVERLAP_EXISTING_SUBNET_RANGEAllow creation of internal ranges that overlap with existing subnets.
    OverlapUnspecified
    OVERLAP_UNSPECIFIEDNo overlap overrides.
    OverlapRouteRange
    OVERLAP_ROUTE_RANGEAllow creation of static routes more specific that the current internal range.
    OverlapExistingSubnetRange
    OVERLAP_EXISTING_SUBNET_RANGEAllow creation of internal ranges that overlap with existing subnets.
    OverlapUnspecified
    OVERLAP_UNSPECIFIEDNo overlap overrides.
    OverlapRouteRange
    OVERLAP_ROUTE_RANGEAllow creation of static routes more specific that the current internal range.
    OverlapExistingSubnetRange
    OVERLAP_EXISTING_SUBNET_RANGEAllow creation of internal ranges that overlap with existing subnets.
    OVERLAP_UNSPECIFIED
    OVERLAP_UNSPECIFIEDNo overlap overrides.
    OVERLAP_ROUTE_RANGE
    OVERLAP_ROUTE_RANGEAllow creation of static routes more specific that the current internal range.
    OVERLAP_EXISTING_SUBNET_RANGE
    OVERLAP_EXISTING_SUBNET_RANGEAllow creation of internal ranges that overlap with existing subnets.
    "OVERLAP_UNSPECIFIED"
    OVERLAP_UNSPECIFIEDNo overlap overrides.
    "OVERLAP_ROUTE_RANGE"
    OVERLAP_ROUTE_RANGEAllow creation of static routes more specific that the current internal range.
    "OVERLAP_EXISTING_SUBNET_RANGE"
    OVERLAP_EXISTING_SUBNET_RANGEAllow creation of internal ranges that overlap with existing subnets.

    InternalRangePeering, InternalRangePeeringArgs

    PeeringUnspecified
    PEERING_UNSPECIFIEDIf Peering is left unspecified in CreateInternalRange or UpdateInternalRange, it will be defaulted to FOR_SELF.
    ForSelf
    FOR_SELFThis is the default behavior and represents the case that this internal range is intended to be used in the VPC in which it is created and is accessible from its peers. This implies that peers or peers-of-peers cannot use this range.
    ForPeer
    FOR_PEERThis behavior can be set when the internal range is being reserved for usage by peers. This means that no resource within the VPC in which it is being created can use this to associate with a VPC resource, but one of the peers can. This represents donating a range for peers to use.
    NotShared
    NOT_SHAREDThis behavior can be set when the internal range is being reserved for usage by the VPC in which it is created, but not shared with peers. In a sense, it is local to the VPC. This can be used to create internal ranges for various purposes like HTTP_INTERNAL_LOAD_BALANCER or for Interconnect routes that are not shared with peers. This also implies that peers cannot use this range in a way that is visible to this VPC, but can re-use this range as long as it is NOT_SHARED from the peer VPC, too.
    InternalRangePeeringPeeringUnspecified
    PEERING_UNSPECIFIEDIf Peering is left unspecified in CreateInternalRange or UpdateInternalRange, it will be defaulted to FOR_SELF.
    InternalRangePeeringForSelf
    FOR_SELFThis is the default behavior and represents the case that this internal range is intended to be used in the VPC in which it is created and is accessible from its peers. This implies that peers or peers-of-peers cannot use this range.
    InternalRangePeeringForPeer
    FOR_PEERThis behavior can be set when the internal range is being reserved for usage by peers. This means that no resource within the VPC in which it is being created can use this to associate with a VPC resource, but one of the peers can. This represents donating a range for peers to use.
    InternalRangePeeringNotShared
    NOT_SHAREDThis behavior can be set when the internal range is being reserved for usage by the VPC in which it is created, but not shared with peers. In a sense, it is local to the VPC. This can be used to create internal ranges for various purposes like HTTP_INTERNAL_LOAD_BALANCER or for Interconnect routes that are not shared with peers. This also implies that peers cannot use this range in a way that is visible to this VPC, but can re-use this range as long as it is NOT_SHARED from the peer VPC, too.
    PeeringUnspecified
    PEERING_UNSPECIFIEDIf Peering is left unspecified in CreateInternalRange or UpdateInternalRange, it will be defaulted to FOR_SELF.
    ForSelf
    FOR_SELFThis is the default behavior and represents the case that this internal range is intended to be used in the VPC in which it is created and is accessible from its peers. This implies that peers or peers-of-peers cannot use this range.
    ForPeer
    FOR_PEERThis behavior can be set when the internal range is being reserved for usage by peers. This means that no resource within the VPC in which it is being created can use this to associate with a VPC resource, but one of the peers can. This represents donating a range for peers to use.
    NotShared
    NOT_SHAREDThis behavior can be set when the internal range is being reserved for usage by the VPC in which it is created, but not shared with peers. In a sense, it is local to the VPC. This can be used to create internal ranges for various purposes like HTTP_INTERNAL_LOAD_BALANCER or for Interconnect routes that are not shared with peers. This also implies that peers cannot use this range in a way that is visible to this VPC, but can re-use this range as long as it is NOT_SHARED from the peer VPC, too.
    PeeringUnspecified
    PEERING_UNSPECIFIEDIf Peering is left unspecified in CreateInternalRange or UpdateInternalRange, it will be defaulted to FOR_SELF.
    ForSelf
    FOR_SELFThis is the default behavior and represents the case that this internal range is intended to be used in the VPC in which it is created and is accessible from its peers. This implies that peers or peers-of-peers cannot use this range.
    ForPeer
    FOR_PEERThis behavior can be set when the internal range is being reserved for usage by peers. This means that no resource within the VPC in which it is being created can use this to associate with a VPC resource, but one of the peers can. This represents donating a range for peers to use.
    NotShared
    NOT_SHAREDThis behavior can be set when the internal range is being reserved for usage by the VPC in which it is created, but not shared with peers. In a sense, it is local to the VPC. This can be used to create internal ranges for various purposes like HTTP_INTERNAL_LOAD_BALANCER or for Interconnect routes that are not shared with peers. This also implies that peers cannot use this range in a way that is visible to this VPC, but can re-use this range as long as it is NOT_SHARED from the peer VPC, too.
    PEERING_UNSPECIFIED
    PEERING_UNSPECIFIEDIf Peering is left unspecified in CreateInternalRange or UpdateInternalRange, it will be defaulted to FOR_SELF.
    FOR_SELF
    FOR_SELFThis is the default behavior and represents the case that this internal range is intended to be used in the VPC in which it is created and is accessible from its peers. This implies that peers or peers-of-peers cannot use this range.
    FOR_PEER
    FOR_PEERThis behavior can be set when the internal range is being reserved for usage by peers. This means that no resource within the VPC in which it is being created can use this to associate with a VPC resource, but one of the peers can. This represents donating a range for peers to use.
    NOT_SHARED
    NOT_SHAREDThis behavior can be set when the internal range is being reserved for usage by the VPC in which it is created, but not shared with peers. In a sense, it is local to the VPC. This can be used to create internal ranges for various purposes like HTTP_INTERNAL_LOAD_BALANCER or for Interconnect routes that are not shared with peers. This also implies that peers cannot use this range in a way that is visible to this VPC, but can re-use this range as long as it is NOT_SHARED from the peer VPC, too.
    "PEERING_UNSPECIFIED"
    PEERING_UNSPECIFIEDIf Peering is left unspecified in CreateInternalRange or UpdateInternalRange, it will be defaulted to FOR_SELF.
    "FOR_SELF"
    FOR_SELFThis is the default behavior and represents the case that this internal range is intended to be used in the VPC in which it is created and is accessible from its peers. This implies that peers or peers-of-peers cannot use this range.
    "FOR_PEER"
    FOR_PEERThis behavior can be set when the internal range is being reserved for usage by peers. This means that no resource within the VPC in which it is being created can use this to associate with a VPC resource, but one of the peers can. This represents donating a range for peers to use.
    "NOT_SHARED"
    NOT_SHAREDThis behavior can be set when the internal range is being reserved for usage by the VPC in which it is created, but not shared with peers. In a sense, it is local to the VPC. This can be used to create internal ranges for various purposes like HTTP_INTERNAL_LOAD_BALANCER or for Interconnect routes that are not shared with peers. This also implies that peers cannot use this range in a way that is visible to this VPC, but can re-use this range as long as it is NOT_SHARED from the peer VPC, too.

    InternalRangeUsage, InternalRangeUsageArgs

    UsageUnspecified
    USAGE_UNSPECIFIEDUnspecified usage is allowed in calls which identify the resource by other fields and do not need Usage set to complete. These are, i.e.: GetInternalRange and DeleteInternalRange. Usage needs to be specified explicitly in CreateInternalRange or UpdateInternalRange calls.
    ForVpc
    FOR_VPCA VPC resource can use the reserved CIDR block by associating it with the internal range resource if usage is set to FOR_VPC.
    ExternalToVpc
    EXTERNAL_TO_VPCRanges created with EXTERNAL_TO_VPC cannot be associated with VPC resources and are meant to block out address ranges for various use cases, like for example, usage on-prem, with dynamic route announcements via interconnect.
    InternalRangeUsageUsageUnspecified
    USAGE_UNSPECIFIEDUnspecified usage is allowed in calls which identify the resource by other fields and do not need Usage set to complete. These are, i.e.: GetInternalRange and DeleteInternalRange. Usage needs to be specified explicitly in CreateInternalRange or UpdateInternalRange calls.
    InternalRangeUsageForVpc
    FOR_VPCA VPC resource can use the reserved CIDR block by associating it with the internal range resource if usage is set to FOR_VPC.
    InternalRangeUsageExternalToVpc
    EXTERNAL_TO_VPCRanges created with EXTERNAL_TO_VPC cannot be associated with VPC resources and are meant to block out address ranges for various use cases, like for example, usage on-prem, with dynamic route announcements via interconnect.
    UsageUnspecified
    USAGE_UNSPECIFIEDUnspecified usage is allowed in calls which identify the resource by other fields and do not need Usage set to complete. These are, i.e.: GetInternalRange and DeleteInternalRange. Usage needs to be specified explicitly in CreateInternalRange or UpdateInternalRange calls.
    ForVpc
    FOR_VPCA VPC resource can use the reserved CIDR block by associating it with the internal range resource if usage is set to FOR_VPC.
    ExternalToVpc
    EXTERNAL_TO_VPCRanges created with EXTERNAL_TO_VPC cannot be associated with VPC resources and are meant to block out address ranges for various use cases, like for example, usage on-prem, with dynamic route announcements via interconnect.
    UsageUnspecified
    USAGE_UNSPECIFIEDUnspecified usage is allowed in calls which identify the resource by other fields and do not need Usage set to complete. These are, i.e.: GetInternalRange and DeleteInternalRange. Usage needs to be specified explicitly in CreateInternalRange or UpdateInternalRange calls.
    ForVpc
    FOR_VPCA VPC resource can use the reserved CIDR block by associating it with the internal range resource if usage is set to FOR_VPC.
    ExternalToVpc
    EXTERNAL_TO_VPCRanges created with EXTERNAL_TO_VPC cannot be associated with VPC resources and are meant to block out address ranges for various use cases, like for example, usage on-prem, with dynamic route announcements via interconnect.
    USAGE_UNSPECIFIED
    USAGE_UNSPECIFIEDUnspecified usage is allowed in calls which identify the resource by other fields and do not need Usage set to complete. These are, i.e.: GetInternalRange and DeleteInternalRange. Usage needs to be specified explicitly in CreateInternalRange or UpdateInternalRange calls.
    FOR_VPC
    FOR_VPCA VPC resource can use the reserved CIDR block by associating it with the internal range resource if usage is set to FOR_VPC.
    EXTERNAL_TO_VPC
    EXTERNAL_TO_VPCRanges created with EXTERNAL_TO_VPC cannot be associated with VPC resources and are meant to block out address ranges for various use cases, like for example, usage on-prem, with dynamic route announcements via interconnect.
    "USAGE_UNSPECIFIED"
    USAGE_UNSPECIFIEDUnspecified usage is allowed in calls which identify the resource by other fields and do not need Usage set to complete. These are, i.e.: GetInternalRange and DeleteInternalRange. Usage needs to be specified explicitly in CreateInternalRange or UpdateInternalRange calls.
    "FOR_VPC"
    FOR_VPCA VPC resource can use the reserved CIDR block by associating it with the internal range resource if usage is set to FOR_VPC.
    "EXTERNAL_TO_VPC"
    EXTERNAL_TO_VPCRanges created with EXTERNAL_TO_VPC cannot be associated with VPC resources and are meant to block out address ranges for various use cases, like for example, usage on-prem, with dynamic route announcements via interconnect.

    Package Details

    Repository
    Google Cloud Native pulumi/pulumi-google-native
    License
    Apache-2.0
    google-native logo

    Google Cloud Native is in preview. Google Cloud Classic is fully supported.

    Google Cloud Native v0.32.0 published on Wednesday, Nov 29, 2023 by Pulumi