Network Connectivity v1 API - Class InternalRange (2.11.0)

public sealed class InternalRange : IMessage<InternalRange>, IEquatable<InternalRange>, IDeepCloneable<InternalRange>, IBufferMessage, IMessage

Reference documentation and code samples for the Network Connectivity v1 API class InternalRange.

The internal range resource for IPAM operations within a VPC network. Used to represent a private address range along with behavioral characteristics of that range (its usage and peering behavior). Networking resources can link to this range if they are created as belonging to it.

Inheritance

object > InternalRange

Namespace

Google.Cloud.NetworkConnectivity.V1

Assembly

Google.Cloud.NetworkConnectivity.V1.dll

Constructors

InternalRange()

public InternalRange()

InternalRange(InternalRange)

public InternalRange(InternalRange other)
Parameter
Name Description
other InternalRange

Properties

AllocationOptions

public InternalRange.Types.AllocationOptions AllocationOptions { get; set; }

Optional. Range auto-allocation options, may be set only when auto-allocation is selected by not setting ip_cidr_range (and setting prefix_length).

Property Value
Type Description
InternalRangeTypesAllocationOptions

CreateTime

public Timestamp CreateTime { get; set; }

Time when the internal range was created.

Property Value
Type Description
Timestamp

Description

public string Description { get; set; }

Optional. A description of this resource.

Property Value
Type Description
string

ExcludeCidrRanges

public RepeatedField<string> ExcludeCidrRanges { get; }

Optional. ExcludeCidrRanges flag. Specifies a set of CIDR blocks that allows exclusion of particular CIDR ranges from the auto-allocation process, without having to reserve these blocks

Property Value
Type Description
RepeatedFieldstring

Immutable

public bool Immutable { get; set; }

Optional. Immutable ranges cannot have their fields modified, except for labels and description.

Property Value
Type Description
bool

InternalRangeName

public InternalRangeName InternalRangeName { get; set; }

InternalRangeName-typed view over the Name resource name property.

Property Value
Type Description
InternalRangeName

IpCidrRange

public string IpCidrRange { get; set; }

Optional. The IP range that this internal range defines. NOTE: IPv6 ranges are limited to usage=EXTERNAL_TO_VPC and peering=FOR_SELF. NOTE: For IPv6 Ranges this field is compulsory, i.e. the address range must be specified explicitly.

Property Value
Type Description
string

Labels

public MapField<string, string> Labels { get; }

User-defined labels.

Property Value
Type Description
MapFieldstringstring

Migration

public InternalRange.Types.Migration Migration { get; set; }

Optional. Must be present if usage is set to FOR_MIGRATION.

Property Value
Type Description
InternalRangeTypesMigration

Name

public string Name { get; set; }

Identifier. The name of an internal range. Format: projects/{project}/locations/{location}/internalRanges/{internal_range} See: https://google.aip.dev/122#fields-representing-resource-names

Property Value
Type Description
string

Network

public string Network { get; set; }

Immutable. 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. For example: https://www.googleapis.com/compute/v1/projects/{project}/locations/global/networks/{network} projects/{project}/locations/global/networks/{network} {network}

Property Value
Type Description
string

Overlaps

public RepeatedField<InternalRange.Types.Overlap> Overlaps { get; }

Optional. Types of resources that are allowed to overlap with the current internal range.

Property Value
Type Description
RepeatedFieldInternalRangeTypesOverlap

Peering

public InternalRange.Types.Peering Peering { get; set; }

Optional. The type of peering set for this internal range.

Property Value
Type Description
InternalRangeTypesPeering

PrefixLength

public int PrefixLength { get; set; }

Optional. An alternate to ip_cidr_range. Can be set when trying to create an IPv4 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. NOTE: For IPv6 this field only works if ip_cidr_range is set as well, and both fields must match. In other words, with IPv6 this field only works as a redundant parameter.

Property Value
Type Description
int

TargetCidrRange

public RepeatedField<string> TargetCidrRange { get; }

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.

Property Value
Type Description
RepeatedFieldstring

UpdateTime

public Timestamp UpdateTime { get; set; }

Time when the internal range was updated.

Property Value
Type Description
Timestamp

Usage

public InternalRange.Types.Usage Usage { get; set; }

Optional. The type of usage set for this InternalRange.

Property Value
Type Description
InternalRangeTypesUsage

Users

public RepeatedField<string> Users { get; }

Output only. 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.

Property Value
Type Description
RepeatedFieldstring