Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. Identity
  5. NetworkSource
Oracle Cloud Infrastructure v2.31.0 published on Thursday, Apr 17, 2025 by Pulumi
pulumi/pulumi-oci

oci.Identity.NetworkSource

Explore with Pulumi AI

Oracle Cloud Infrastructure v2.31.0 published on Thursday, Apr 17, 2025 by Pulumi
pulumi/pulumi-oci

This resource provides the Network Source resource in Oracle Cloud Infrastructure Identity service.

Creates a new network source in your tenancy.

You must specify your tenancy’s OCID as the compartment ID in the request object (remember that the tenancy is simply the root compartment). Notice that IAM resources (users, groups, compartments, and some policies) reside within the tenancy itself, unlike cloud resources such as compute instances, which typically reside within compartments inside the tenancy. For information about OCIDs, see Resource Identifiers.

You must also specify a name for the network source, which must be unique across all network sources in your tenancy, and cannot be changed. You can use this name or the OCID when writing policies that apply to the network source. For more information about policies, see How Policies Work.

You must also specify a description for the network source (although it can be an empty string). It does not have to be unique, and you can change it anytime with UpdateNetworkSource. After your network resource is created, you can use it in policy to restrict access to only requests made from an allowed IP address specified in your network source. For more information, see Managing Network Sources.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";

const testNetworkSource = new oci.identity.NetworkSource("test_network_source", {
    compartmentId: tenancyOcid,
    description: networkSourceDescription,
    name: networkSourceName,
    definedTags: {
        "Operations.CostCenter": "42",
    },
    freeformTags: {
        Department: "Finance",
    },
    publicSourceLists: networkSourcePublicSourceList,
    services: networkSourceServices,
    virtualSourceLists: networkSourceVirtualSourceList,
});
Copy
import pulumi
import pulumi_oci as oci

test_network_source = oci.identity.NetworkSource("test_network_source",
    compartment_id=tenancy_ocid,
    description=network_source_description,
    name=network_source_name,
    defined_tags={
        "Operations.CostCenter": "42",
    },
    freeform_tags={
        "Department": "Finance",
    },
    public_source_lists=network_source_public_source_list,
    services=network_source_services,
    virtual_source_lists=network_source_virtual_source_list)
Copy
package main

import (
	"github.com/pulumi/pulumi-oci/sdk/v2/go/oci/identity"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := identity.NewNetworkSource(ctx, "test_network_source", &identity.NetworkSourceArgs{
			CompartmentId: pulumi.Any(tenancyOcid),
			Description:   pulumi.Any(networkSourceDescription),
			Name:          pulumi.Any(networkSourceName),
			DefinedTags: pulumi.StringMap{
				"Operations.CostCenter": pulumi.String("42"),
			},
			FreeformTags: pulumi.StringMap{
				"Department": pulumi.String("Finance"),
			},
			PublicSourceLists:  pulumi.Any(networkSourcePublicSourceList),
			Services:           pulumi.Any(networkSourceServices),
			VirtualSourceLists: pulumi.Any(networkSourceVirtualSourceList),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Oci = Pulumi.Oci;

return await Deployment.RunAsync(() => 
{
    var testNetworkSource = new Oci.Identity.NetworkSource("test_network_source", new()
    {
        CompartmentId = tenancyOcid,
        Description = networkSourceDescription,
        Name = networkSourceName,
        DefinedTags = 
        {
            { "Operations.CostCenter", "42" },
        },
        FreeformTags = 
        {
            { "Department", "Finance" },
        },
        PublicSourceLists = networkSourcePublicSourceList,
        Services = networkSourceServices,
        VirtualSourceLists = networkSourceVirtualSourceList,
    });

});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.Identity.NetworkSource;
import com.pulumi.oci.Identity.NetworkSourceArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var testNetworkSource = new NetworkSource("testNetworkSource", NetworkSourceArgs.builder()
            .compartmentId(tenancyOcid)
            .description(networkSourceDescription)
            .name(networkSourceName)
            .definedTags(Map.of("Operations.CostCenter", "42"))
            .freeformTags(Map.of("Department", "Finance"))
            .publicSourceLists(networkSourcePublicSourceList)
            .services(networkSourceServices)
            .virtualSourceLists(networkSourceVirtualSourceList)
            .build());

    }
}
Copy
resources:
  testNetworkSource:
    type: oci:Identity:NetworkSource
    name: test_network_source
    properties:
      compartmentId: ${tenancyOcid}
      description: ${networkSourceDescription}
      name: ${networkSourceName}
      definedTags:
        Operations.CostCenter: '42'
      freeformTags:
        Department: Finance
      publicSourceLists: ${networkSourcePublicSourceList}
      services: ${networkSourceServices}
      virtualSourceLists: ${networkSourceVirtualSourceList}
Copy

Create NetworkSource Resource

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

Constructor syntax

new NetworkSource(name: string, args: NetworkSourceArgs, opts?: CustomResourceOptions);
@overload
def NetworkSource(resource_name: str,
                  args: NetworkSourceArgs,
                  opts: Optional[ResourceOptions] = None)

@overload
def NetworkSource(resource_name: str,
                  opts: Optional[ResourceOptions] = None,
                  compartment_id: Optional[str] = None,
                  description: Optional[str] = None,
                  defined_tags: Optional[Mapping[str, str]] = None,
                  freeform_tags: Optional[Mapping[str, str]] = None,
                  name: Optional[str] = None,
                  public_source_lists: Optional[Sequence[str]] = None,
                  services: Optional[Sequence[str]] = None,
                  virtual_source_lists: Optional[Sequence[_identity.NetworkSourceVirtualSourceListArgs]] = None)
func NewNetworkSource(ctx *Context, name string, args NetworkSourceArgs, opts ...ResourceOption) (*NetworkSource, error)
public NetworkSource(string name, NetworkSourceArgs args, CustomResourceOptions? opts = null)
public NetworkSource(String name, NetworkSourceArgs args)
public NetworkSource(String name, NetworkSourceArgs args, CustomResourceOptions options)

type: oci:Identity:NetworkSource
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

Parameters

name This property is required. string
The unique name of the resource.
args This property is required. NetworkSourceArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name This property is required. str
The unique name of the resource.
args This property is required. NetworkSourceArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name This property is required. string
The unique name of the resource.
args This property is required. NetworkSourceArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name This property is required. string
The unique name of the resource.
args This property is required. NetworkSourceArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name This property is required. String
The unique name of the resource.
args This property is required. NetworkSourceArgs
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 networkSourceResource = new Oci.Identity.NetworkSource("networkSourceResource", new()
{
    CompartmentId = "string",
    Description = "string",
    DefinedTags = 
    {
        { "string", "string" },
    },
    FreeformTags = 
    {
        { "string", "string" },
    },
    Name = "string",
    PublicSourceLists = new[]
    {
        "string",
    },
    Services = new[]
    {
        "string",
    },
    VirtualSourceLists = new[]
    {
        new Oci.Identity.Inputs.NetworkSourceVirtualSourceListArgs
        {
            IpRanges = new[]
            {
                "string",
            },
            VcnId = "string",
        },
    },
});
Copy
example, err := Identity.NewNetworkSource(ctx, "networkSourceResource", &Identity.NetworkSourceArgs{
	CompartmentId: pulumi.String("string"),
	Description:   pulumi.String("string"),
	DefinedTags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	FreeformTags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	Name: pulumi.String("string"),
	PublicSourceLists: pulumi.StringArray{
		pulumi.String("string"),
	},
	Services: pulumi.StringArray{
		pulumi.String("string"),
	},
	VirtualSourceLists: identity.NetworkSourceVirtualSourceListArray{
		&identity.NetworkSourceVirtualSourceListArgs{
			IpRanges: pulumi.StringArray{
				pulumi.String("string"),
			},
			VcnId: pulumi.String("string"),
		},
	},
})
Copy
var networkSourceResource = new NetworkSource("networkSourceResource", NetworkSourceArgs.builder()
    .compartmentId("string")
    .description("string")
    .definedTags(Map.of("string", "string"))
    .freeformTags(Map.of("string", "string"))
    .name("string")
    .publicSourceLists("string")
    .services("string")
    .virtualSourceLists(NetworkSourceVirtualSourceListArgs.builder()
        .ipRanges("string")
        .vcnId("string")
        .build())
    .build());
Copy
network_source_resource = oci.identity.NetworkSource("networkSourceResource",
    compartment_id="string",
    description="string",
    defined_tags={
        "string": "string",
    },
    freeform_tags={
        "string": "string",
    },
    name="string",
    public_source_lists=["string"],
    services=["string"],
    virtual_source_lists=[{
        "ip_ranges": ["string"],
        "vcn_id": "string",
    }])
Copy
const networkSourceResource = new oci.identity.NetworkSource("networkSourceResource", {
    compartmentId: "string",
    description: "string",
    definedTags: {
        string: "string",
    },
    freeformTags: {
        string: "string",
    },
    name: "string",
    publicSourceLists: ["string"],
    services: ["string"],
    virtualSourceLists: [{
        ipRanges: ["string"],
        vcnId: "string",
    }],
});
Copy
type: oci:Identity:NetworkSource
properties:
    compartmentId: string
    definedTags:
        string: string
    description: string
    freeformTags:
        string: string
    name: string
    publicSourceLists:
        - string
    services:
        - string
    virtualSourceLists:
        - ipRanges:
            - string
          vcnId: string
Copy

NetworkSource Resource Properties

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

Inputs

In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

The NetworkSource resource accepts the following input properties:

CompartmentId
This property is required.
Changes to this property will trigger replacement.
string
The OCID of the tenancy (root compartment) containing the network source object.
Description This property is required. string
(Updatable) The description you assign to the network source during creation. Does not have to be unique, and it's changeable.
DefinedTags Dictionary<string, string>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
FreeformTags Dictionary<string, string>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
Name Changes to this property will trigger replacement. string
The name you assign to the network source during creation. The name must be unique across all groups in the tenancy and cannot be changed.
PublicSourceLists List<string>
(Updatable) A list of allowed public IP addresses and CIDR ranges.
Services List<string>
(Updatable) A list of services allowed to make on-behalf-of requests. These requests can have different source IP addresses than those listed in the network source. Currently, only all and none are supported. The default is all.
VirtualSourceLists List<NetworkSourceVirtualSourceList>

(Updatable) A list of allowed VCN OCID and IP range pairs. Example:"vcnId": "ocid1.vcn.oc1.iad.aaaaaaaaexampleuniqueID", "ipRanges": [ "129.213.39.0/24" ]

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

CompartmentId
This property is required.
Changes to this property will trigger replacement.
string
The OCID of the tenancy (root compartment) containing the network source object.
Description This property is required. string
(Updatable) The description you assign to the network source during creation. Does not have to be unique, and it's changeable.
DefinedTags map[string]string
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
FreeformTags map[string]string
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
Name Changes to this property will trigger replacement. string
The name you assign to the network source during creation. The name must be unique across all groups in the tenancy and cannot be changed.
PublicSourceLists []string
(Updatable) A list of allowed public IP addresses and CIDR ranges.
Services []string
(Updatable) A list of services allowed to make on-behalf-of requests. These requests can have different source IP addresses than those listed in the network source. Currently, only all and none are supported. The default is all.
VirtualSourceLists []NetworkSourceVirtualSourceListArgs

(Updatable) A list of allowed VCN OCID and IP range pairs. Example:"vcnId": "ocid1.vcn.oc1.iad.aaaaaaaaexampleuniqueID", "ipRanges": [ "129.213.39.0/24" ]

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

compartmentId
This property is required.
Changes to this property will trigger replacement.
String
The OCID of the tenancy (root compartment) containing the network source object.
description This property is required. String
(Updatable) The description you assign to the network source during creation. Does not have to be unique, and it's changeable.
definedTags Map<String,String>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
freeformTags Map<String,String>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
name Changes to this property will trigger replacement. String
The name you assign to the network source during creation. The name must be unique across all groups in the tenancy and cannot be changed.
publicSourceLists List<String>
(Updatable) A list of allowed public IP addresses and CIDR ranges.
services List<String>
(Updatable) A list of services allowed to make on-behalf-of requests. These requests can have different source IP addresses than those listed in the network source. Currently, only all and none are supported. The default is all.
virtualSourceLists List<NetworkSourceVirtualSourceList>

(Updatable) A list of allowed VCN OCID and IP range pairs. Example:"vcnId": "ocid1.vcn.oc1.iad.aaaaaaaaexampleuniqueID", "ipRanges": [ "129.213.39.0/24" ]

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

compartmentId
This property is required.
Changes to this property will trigger replacement.
string
The OCID of the tenancy (root compartment) containing the network source object.
description This property is required. string
(Updatable) The description you assign to the network source during creation. Does not have to be unique, and it's changeable.
definedTags {[key: string]: string}
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
freeformTags {[key: string]: string}
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
name Changes to this property will trigger replacement. string
The name you assign to the network source during creation. The name must be unique across all groups in the tenancy and cannot be changed.
publicSourceLists string[]
(Updatable) A list of allowed public IP addresses and CIDR ranges.
services string[]
(Updatable) A list of services allowed to make on-behalf-of requests. These requests can have different source IP addresses than those listed in the network source. Currently, only all and none are supported. The default is all.
virtualSourceLists NetworkSourceVirtualSourceList[]

(Updatable) A list of allowed VCN OCID and IP range pairs. Example:"vcnId": "ocid1.vcn.oc1.iad.aaaaaaaaexampleuniqueID", "ipRanges": [ "129.213.39.0/24" ]

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

compartment_id
This property is required.
Changes to this property will trigger replacement.
str
The OCID of the tenancy (root compartment) containing the network source object.
description This property is required. str
(Updatable) The description you assign to the network source during creation. Does not have to be unique, and it's changeable.
defined_tags Mapping[str, str]
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
freeform_tags Mapping[str, str]
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
name Changes to this property will trigger replacement. str
The name you assign to the network source during creation. The name must be unique across all groups in the tenancy and cannot be changed.
public_source_lists Sequence[str]
(Updatable) A list of allowed public IP addresses and CIDR ranges.
services Sequence[str]
(Updatable) A list of services allowed to make on-behalf-of requests. These requests can have different source IP addresses than those listed in the network source. Currently, only all and none are supported. The default is all.
virtual_source_lists Sequence[identity.NetworkSourceVirtualSourceListArgs]

(Updatable) A list of allowed VCN OCID and IP range pairs. Example:"vcnId": "ocid1.vcn.oc1.iad.aaaaaaaaexampleuniqueID", "ipRanges": [ "129.213.39.0/24" ]

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

compartmentId
This property is required.
Changes to this property will trigger replacement.
String
The OCID of the tenancy (root compartment) containing the network source object.
description This property is required. String
(Updatable) The description you assign to the network source during creation. Does not have to be unique, and it's changeable.
definedTags Map<String>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
freeformTags Map<String>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
name Changes to this property will trigger replacement. String
The name you assign to the network source during creation. The name must be unique across all groups in the tenancy and cannot be changed.
publicSourceLists List<String>
(Updatable) A list of allowed public IP addresses and CIDR ranges.
services List<String>
(Updatable) A list of services allowed to make on-behalf-of requests. These requests can have different source IP addresses than those listed in the network source. Currently, only all and none are supported. The default is all.
virtualSourceLists List<Property Map>

(Updatable) A list of allowed VCN OCID and IP range pairs. Example:"vcnId": "ocid1.vcn.oc1.iad.aaaaaaaaexampleuniqueID", "ipRanges": [ "129.213.39.0/24" ]

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

Outputs

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

Id string
The provider-assigned unique ID for this managed resource.
InactiveState string
The detailed status of INACTIVE lifecycleState.
State string
The network source object's current state. After creating a network source, make sure its lifecycleState changes from CREATING to ACTIVE before using it.
TimeCreated string
Date and time the group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
Id string
The provider-assigned unique ID for this managed resource.
InactiveState string
The detailed status of INACTIVE lifecycleState.
State string
The network source object's current state. After creating a network source, make sure its lifecycleState changes from CREATING to ACTIVE before using it.
TimeCreated string
Date and time the group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
id String
The provider-assigned unique ID for this managed resource.
inactiveState String
The detailed status of INACTIVE lifecycleState.
state String
The network source object's current state. After creating a network source, make sure its lifecycleState changes from CREATING to ACTIVE before using it.
timeCreated String
Date and time the group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
id string
The provider-assigned unique ID for this managed resource.
inactiveState string
The detailed status of INACTIVE lifecycleState.
state string
The network source object's current state. After creating a network source, make sure its lifecycleState changes from CREATING to ACTIVE before using it.
timeCreated string
Date and time the group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
id str
The provider-assigned unique ID for this managed resource.
inactive_state str
The detailed status of INACTIVE lifecycleState.
state str
The network source object's current state. After creating a network source, make sure its lifecycleState changes from CREATING to ACTIVE before using it.
time_created str
Date and time the group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
id String
The provider-assigned unique ID for this managed resource.
inactiveState String
The detailed status of INACTIVE lifecycleState.
state String
The network source object's current state. After creating a network source, make sure its lifecycleState changes from CREATING to ACTIVE before using it.
timeCreated String
Date and time the group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

Look up Existing NetworkSource Resource

Get an existing NetworkSource resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

public static get(name: string, id: Input<ID>, state?: NetworkSourceState, opts?: CustomResourceOptions): NetworkSource
@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        compartment_id: Optional[str] = None,
        defined_tags: Optional[Mapping[str, str]] = None,
        description: Optional[str] = None,
        freeform_tags: Optional[Mapping[str, str]] = None,
        inactive_state: Optional[str] = None,
        name: Optional[str] = None,
        public_source_lists: Optional[Sequence[str]] = None,
        services: Optional[Sequence[str]] = None,
        state: Optional[str] = None,
        time_created: Optional[str] = None,
        virtual_source_lists: Optional[Sequence[_identity.NetworkSourceVirtualSourceListArgs]] = None) -> NetworkSource
func GetNetworkSource(ctx *Context, name string, id IDInput, state *NetworkSourceState, opts ...ResourceOption) (*NetworkSource, error)
public static NetworkSource Get(string name, Input<string> id, NetworkSourceState? state, CustomResourceOptions? opts = null)
public static NetworkSource get(String name, Output<String> id, NetworkSourceState state, CustomResourceOptions options)
resources:  _:    type: oci:Identity:NetworkSource    get:      id: ${id}
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
resource_name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
name This property is required.
The unique name of the resulting resource.
id This property is required.
The unique provider ID of the resource to lookup.
state
Any extra arguments used during the lookup.
opts
A bag of options that control this resource's behavior.
The following state arguments are supported:
CompartmentId Changes to this property will trigger replacement. string
The OCID of the tenancy (root compartment) containing the network source object.
DefinedTags Dictionary<string, string>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
Description string
(Updatable) The description you assign to the network source during creation. Does not have to be unique, and it's changeable.
FreeformTags Dictionary<string, string>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
InactiveState string
The detailed status of INACTIVE lifecycleState.
Name Changes to this property will trigger replacement. string
The name you assign to the network source during creation. The name must be unique across all groups in the tenancy and cannot be changed.
PublicSourceLists List<string>
(Updatable) A list of allowed public IP addresses and CIDR ranges.
Services List<string>
(Updatable) A list of services allowed to make on-behalf-of requests. These requests can have different source IP addresses than those listed in the network source. Currently, only all and none are supported. The default is all.
State string
The network source object's current state. After creating a network source, make sure its lifecycleState changes from CREATING to ACTIVE before using it.
TimeCreated string
Date and time the group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
VirtualSourceLists List<NetworkSourceVirtualSourceList>

(Updatable) A list of allowed VCN OCID and IP range pairs. Example:"vcnId": "ocid1.vcn.oc1.iad.aaaaaaaaexampleuniqueID", "ipRanges": [ "129.213.39.0/24" ]

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

CompartmentId Changes to this property will trigger replacement. string
The OCID of the tenancy (root compartment) containing the network source object.
DefinedTags map[string]string
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
Description string
(Updatable) The description you assign to the network source during creation. Does not have to be unique, and it's changeable.
FreeformTags map[string]string
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
InactiveState string
The detailed status of INACTIVE lifecycleState.
Name Changes to this property will trigger replacement. string
The name you assign to the network source during creation. The name must be unique across all groups in the tenancy and cannot be changed.
PublicSourceLists []string
(Updatable) A list of allowed public IP addresses and CIDR ranges.
Services []string
(Updatable) A list of services allowed to make on-behalf-of requests. These requests can have different source IP addresses than those listed in the network source. Currently, only all and none are supported. The default is all.
State string
The network source object's current state. After creating a network source, make sure its lifecycleState changes from CREATING to ACTIVE before using it.
TimeCreated string
Date and time the group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
VirtualSourceLists []NetworkSourceVirtualSourceListArgs

(Updatable) A list of allowed VCN OCID and IP range pairs. Example:"vcnId": "ocid1.vcn.oc1.iad.aaaaaaaaexampleuniqueID", "ipRanges": [ "129.213.39.0/24" ]

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

compartmentId Changes to this property will trigger replacement. String
The OCID of the tenancy (root compartment) containing the network source object.
definedTags Map<String,String>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
description String
(Updatable) The description you assign to the network source during creation. Does not have to be unique, and it's changeable.
freeformTags Map<String,String>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
inactiveState String
The detailed status of INACTIVE lifecycleState.
name Changes to this property will trigger replacement. String
The name you assign to the network source during creation. The name must be unique across all groups in the tenancy and cannot be changed.
publicSourceLists List<String>
(Updatable) A list of allowed public IP addresses and CIDR ranges.
services List<String>
(Updatable) A list of services allowed to make on-behalf-of requests. These requests can have different source IP addresses than those listed in the network source. Currently, only all and none are supported. The default is all.
state String
The network source object's current state. After creating a network source, make sure its lifecycleState changes from CREATING to ACTIVE before using it.
timeCreated String
Date and time the group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
virtualSourceLists List<NetworkSourceVirtualSourceList>

(Updatable) A list of allowed VCN OCID and IP range pairs. Example:"vcnId": "ocid1.vcn.oc1.iad.aaaaaaaaexampleuniqueID", "ipRanges": [ "129.213.39.0/24" ]

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

compartmentId Changes to this property will trigger replacement. string
The OCID of the tenancy (root compartment) containing the network source object.
definedTags {[key: string]: string}
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
description string
(Updatable) The description you assign to the network source during creation. Does not have to be unique, and it's changeable.
freeformTags {[key: string]: string}
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
inactiveState string
The detailed status of INACTIVE lifecycleState.
name Changes to this property will trigger replacement. string
The name you assign to the network source during creation. The name must be unique across all groups in the tenancy and cannot be changed.
publicSourceLists string[]
(Updatable) A list of allowed public IP addresses and CIDR ranges.
services string[]
(Updatable) A list of services allowed to make on-behalf-of requests. These requests can have different source IP addresses than those listed in the network source. Currently, only all and none are supported. The default is all.
state string
The network source object's current state. After creating a network source, make sure its lifecycleState changes from CREATING to ACTIVE before using it.
timeCreated string
Date and time the group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
virtualSourceLists NetworkSourceVirtualSourceList[]

(Updatable) A list of allowed VCN OCID and IP range pairs. Example:"vcnId": "ocid1.vcn.oc1.iad.aaaaaaaaexampleuniqueID", "ipRanges": [ "129.213.39.0/24" ]

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

compartment_id Changes to this property will trigger replacement. str
The OCID of the tenancy (root compartment) containing the network source object.
defined_tags Mapping[str, str]
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
description str
(Updatable) The description you assign to the network source during creation. Does not have to be unique, and it's changeable.
freeform_tags Mapping[str, str]
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
inactive_state str
The detailed status of INACTIVE lifecycleState.
name Changes to this property will trigger replacement. str
The name you assign to the network source during creation. The name must be unique across all groups in the tenancy and cannot be changed.
public_source_lists Sequence[str]
(Updatable) A list of allowed public IP addresses and CIDR ranges.
services Sequence[str]
(Updatable) A list of services allowed to make on-behalf-of requests. These requests can have different source IP addresses than those listed in the network source. Currently, only all and none are supported. The default is all.
state str
The network source object's current state. After creating a network source, make sure its lifecycleState changes from CREATING to ACTIVE before using it.
time_created str
Date and time the group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
virtual_source_lists Sequence[identity.NetworkSourceVirtualSourceListArgs]

(Updatable) A list of allowed VCN OCID and IP range pairs. Example:"vcnId": "ocid1.vcn.oc1.iad.aaaaaaaaexampleuniqueID", "ipRanges": [ "129.213.39.0/24" ]

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

compartmentId Changes to this property will trigger replacement. String
The OCID of the tenancy (root compartment) containing the network source object.
definedTags Map<String>
(Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
description String
(Updatable) The description you assign to the network source during creation. Does not have to be unique, and it's changeable.
freeformTags Map<String>
(Updatable) Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
inactiveState String
The detailed status of INACTIVE lifecycleState.
name Changes to this property will trigger replacement. String
The name you assign to the network source during creation. The name must be unique across all groups in the tenancy and cannot be changed.
publicSourceLists List<String>
(Updatable) A list of allowed public IP addresses and CIDR ranges.
services List<String>
(Updatable) A list of services allowed to make on-behalf-of requests. These requests can have different source IP addresses than those listed in the network source. Currently, only all and none are supported. The default is all.
state String
The network source object's current state. After creating a network source, make sure its lifecycleState changes from CREATING to ACTIVE before using it.
timeCreated String
Date and time the group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
virtualSourceLists List<Property Map>

(Updatable) A list of allowed VCN OCID and IP range pairs. Example:"vcnId": "ocid1.vcn.oc1.iad.aaaaaaaaexampleuniqueID", "ipRanges": [ "129.213.39.0/24" ]

** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

Supporting Types

NetworkSourceVirtualSourceList
, NetworkSourceVirtualSourceListArgs

IpRanges This property is required. List<string>
VcnId This property is required. string
IpRanges This property is required. []string
VcnId This property is required. string
ipRanges This property is required. List<String>
vcnId This property is required. String
ipRanges This property is required. string[]
vcnId This property is required. string
ip_ranges This property is required. Sequence[str]
vcn_id This property is required. str
ipRanges This property is required. List<String>
vcnId This property is required. String

Import

NetworkSources can be imported using the id, e.g.

$ pulumi import oci:Identity/networkSource:NetworkSource test_network_source "id"
Copy

To learn more about importing existing cloud resources, see Importing resources.

Package Details

Repository
oci pulumi/pulumi-oci
License
Apache-2.0
Notes
This Pulumi package is based on the oci Terraform Provider.
Oracle Cloud Infrastructure v2.31.0 published on Thursday, Apr 17, 2025 by Pulumi
pulumi/pulumi-oci