import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as outputs from "../types/output"; /** * This resource provides the Network Source resource in Oracle Cloud Infrastructure Identity service. * Api doc link for the resource: https://docs.oracle.com/iaas/api/#/en/identity/latest/NetworkSource * * Example terraform configs related to the resource : https://github.com/oracle/terraform-provider-oci/tree/master/examples/identity * * 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](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm). * * 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](https://docs.cloud.oracle.com/iaas/Content/Identity/Concepts/policies.htm). * * 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](https://docs.cloud.oracle.com/iaas/api/#/en/identity/20160918/NetworkSource/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](https://docs.cloud.oracle.com/iaas/Content/Identity/Tasks/managingnetworksources.htm). * * ## Example Usage * * ```typescript * 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, * }); * ``` * * ## Import * * NetworkSources can be imported using the `id`, e.g. * * ```sh * $ pulumi import oci:Identity/networkSource:NetworkSource test_network_source "id" * ``` */ export declare class NetworkSource extends pulumi.CustomResource { /** * Get an existing NetworkSource resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, state?: NetworkSourceState, opts?: pulumi.CustomResourceOptions): NetworkSource; /** * Returns true if the given object is an instance of NetworkSource. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj: any): obj is NetworkSource; /** * The OCID of the tenancy (root compartment) containing the network source object. */ readonly compartmentId: pulumi.Output; /** * (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations.CostCenter": "42"}` */ readonly definedTags: pulumi.Output<{ [key: string]: string; }>; /** * (Updatable) The description you assign to the network source during creation. Does not have to be unique, and it's changeable. */ readonly description: pulumi.Output; /** * (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](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` */ readonly freeformTags: pulumi.Output<{ [key: string]: string; }>; /** * The detailed status of INACTIVE lifecycleState. */ readonly inactiveState: pulumi.Output; /** * 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. */ readonly name: pulumi.Output; /** * (Updatable) A list of allowed public IP addresses and CIDR ranges. */ readonly publicSourceLists: pulumi.Output; /** * (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`. */ readonly services: pulumi.Output; /** * The network source object's current state. After creating a network source, make sure its `lifecycleState` changes from CREATING to ACTIVE before using it. */ readonly state: pulumi.Output; /** * Date and time the group was created, in the format defined by RFC3339. Example: `2016-08-25T21:10:29.600Z` */ readonly timeCreated: pulumi.Output; /** * (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 */ readonly virtualSourceLists: pulumi.Output; /** * Create a NetworkSource resource with the given unique name, arguments, and options. * * @param name The _unique_ name of the resource. * @param args The arguments to use to populate this resource's properties. * @param opts A bag of options that control this resource's behavior. */ constructor(name: string, args: NetworkSourceArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering NetworkSource resources. */ export interface NetworkSourceState { /** * The OCID of the tenancy (root compartment) containing the network source object. */ compartmentId?: pulumi.Input; /** * (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations.CostCenter": "42"}` */ definedTags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * (Updatable) The description you assign to the network source during creation. Does not have to be unique, and it's changeable. */ description?: pulumi.Input; /** * (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](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` */ freeformTags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * The detailed status of INACTIVE lifecycleState. */ inactiveState?: pulumi.Input; /** * 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. */ name?: pulumi.Input; /** * (Updatable) A list of allowed public IP addresses and CIDR ranges. */ publicSourceLists?: pulumi.Input[] | undefined>; /** * (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`. */ services?: pulumi.Input[] | undefined>; /** * The network source object's current state. After creating a network source, make sure its `lifecycleState` changes from CREATING to ACTIVE before using it. */ state?: pulumi.Input; /** * Date and time the group was created, in the format defined by RFC3339. Example: `2016-08-25T21:10:29.600Z` */ timeCreated?: pulumi.Input; /** * (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 */ virtualSourceLists?: pulumi.Input[] | undefined>; } /** * The set of arguments for constructing a NetworkSource resource. */ export interface NetworkSourceArgs { /** * The OCID of the tenancy (root compartment) containing the network source object. */ compartmentId: pulumi.Input; /** * (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations.CostCenter": "42"}` */ definedTags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * (Updatable) The description you assign to the network source during creation. Does not have to be unique, and it's changeable. */ description: pulumi.Input; /** * (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](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` */ freeformTags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * 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. */ name?: pulumi.Input; /** * (Updatable) A list of allowed public IP addresses and CIDR ranges. */ publicSourceLists?: pulumi.Input[] | undefined>; /** * (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`. */ services?: pulumi.Input[] | undefined>; /** * (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 */ virtualSourceLists?: pulumi.Input[] | undefined>; } //# sourceMappingURL=networkSource.d.ts.map