1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. RecoveryMod
  5. RecoveryServiceSubnet
Oracle Cloud Infrastructure v2.17.0 published on Friday, Nov 15, 2024 by Pulumi

oci.RecoveryMod.RecoveryServiceSubnet

Explore with Pulumi AI

oci logo
Oracle Cloud Infrastructure v2.17.0 published on Friday, Nov 15, 2024 by Pulumi

    This resource provides the Recovery Service Subnet resource in Oracle Cloud Infrastructure Recovery service.

    Creates a new Recovery Service Subnet.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as oci from "@pulumi/oci";
    
    const testRecoveryServiceSubnet = new oci.recoverymod.RecoveryServiceSubnet("test_recovery_service_subnet", {
        compartmentId: compartmentId,
        displayName: recoveryServiceSubnetDisplayName,
        vcnId: testVcn.id,
        definedTags: {
            "foo-namespace.bar-key": "value",
        },
        freeformTags: {
            "bar-key": "value",
        },
        nsgIds: recoveryServiceSubnetNsgIds,
        subnetId: testSubnet.id,
        subnets: recoveryServiceSubnetSubnets,
    });
    
    import pulumi
    import pulumi_oci as oci
    
    test_recovery_service_subnet = oci.recovery_mod.RecoveryServiceSubnet("test_recovery_service_subnet",
        compartment_id=compartment_id,
        display_name=recovery_service_subnet_display_name,
        vcn_id=test_vcn["id"],
        defined_tags={
            "foo-namespace.bar-key": "value",
        },
        freeform_tags={
            "bar-key": "value",
        },
        nsg_ids=recovery_service_subnet_nsg_ids,
        subnet_id=test_subnet["id"],
        subnets=recovery_service_subnet_subnets)
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-oci/sdk/v2/go/oci/RecoveryMod"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := RecoveryMod.NewRecoveryServiceSubnet(ctx, "test_recovery_service_subnet", &RecoveryMod.RecoveryServiceSubnetArgs{
    			CompartmentId: pulumi.Any(compartmentId),
    			DisplayName:   pulumi.Any(recoveryServiceSubnetDisplayName),
    			VcnId:         pulumi.Any(testVcn.Id),
    			DefinedTags: pulumi.StringMap{
    				"foo-namespace.bar-key": pulumi.String("value"),
    			},
    			FreeformTags: pulumi.StringMap{
    				"bar-key": pulumi.String("value"),
    			},
    			NsgIds:   pulumi.Any(recoveryServiceSubnetNsgIds),
    			SubnetId: pulumi.Any(testSubnet.Id),
    			Subnets:  pulumi.Any(recoveryServiceSubnetSubnets),
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Oci = Pulumi.Oci;
    
    return await Deployment.RunAsync(() => 
    {
        var testRecoveryServiceSubnet = new Oci.RecoveryMod.RecoveryServiceSubnet("test_recovery_service_subnet", new()
        {
            CompartmentId = compartmentId,
            DisplayName = recoveryServiceSubnetDisplayName,
            VcnId = testVcn.Id,
            DefinedTags = 
            {
                { "foo-namespace.bar-key", "value" },
            },
            FreeformTags = 
            {
                { "bar-key", "value" },
            },
            NsgIds = recoveryServiceSubnetNsgIds,
            SubnetId = testSubnet.Id,
            Subnets = recoveryServiceSubnetSubnets,
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.oci.RecoveryMod.RecoveryServiceSubnet;
    import com.pulumi.oci.RecoveryMod.RecoveryServiceSubnetArgs;
    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 testRecoveryServiceSubnet = new RecoveryServiceSubnet("testRecoveryServiceSubnet", RecoveryServiceSubnetArgs.builder()
                .compartmentId(compartmentId)
                .displayName(recoveryServiceSubnetDisplayName)
                .vcnId(testVcn.id())
                .definedTags(Map.of("foo-namespace.bar-key", "value"))
                .freeformTags(Map.of("bar-key", "value"))
                .nsgIds(recoveryServiceSubnetNsgIds)
                .subnetId(testSubnet.id())
                .subnets(recoveryServiceSubnetSubnets)
                .build());
    
        }
    }
    
    resources:
      testRecoveryServiceSubnet:
        type: oci:RecoveryMod:RecoveryServiceSubnet
        name: test_recovery_service_subnet
        properties:
          compartmentId: ${compartmentId}
          displayName: ${recoveryServiceSubnetDisplayName}
          vcnId: ${testVcn.id}
          definedTags:
            foo-namespace.bar-key: value
          freeformTags:
            bar-key: value
          nsgIds: ${recoveryServiceSubnetNsgIds}
          subnetId: ${testSubnet.id}
          subnets: ${recoveryServiceSubnetSubnets}
    

    Create RecoveryServiceSubnet Resource

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

    Constructor syntax

    new RecoveryServiceSubnet(name: string, args: RecoveryServiceSubnetArgs, opts?: CustomResourceOptions);
    @overload
    def RecoveryServiceSubnet(resource_name: str,
                              args: RecoveryServiceSubnetArgs,
                              opts: Optional[ResourceOptions] = None)
    
    @overload
    def RecoveryServiceSubnet(resource_name: str,
                              opts: Optional[ResourceOptions] = None,
                              compartment_id: Optional[str] = None,
                              display_name: Optional[str] = None,
                              vcn_id: Optional[str] = None,
                              defined_tags: Optional[Mapping[str, str]] = None,
                              freeform_tags: Optional[Mapping[str, str]] = None,
                              nsg_ids: Optional[Sequence[str]] = None,
                              subnet_id: Optional[str] = None,
                              subnets: Optional[Sequence[str]] = None)
    func NewRecoveryServiceSubnet(ctx *Context, name string, args RecoveryServiceSubnetArgs, opts ...ResourceOption) (*RecoveryServiceSubnet, error)
    public RecoveryServiceSubnet(string name, RecoveryServiceSubnetArgs args, CustomResourceOptions? opts = null)
    public RecoveryServiceSubnet(String name, RecoveryServiceSubnetArgs args)
    public RecoveryServiceSubnet(String name, RecoveryServiceSubnetArgs args, CustomResourceOptions options)
    
    type: oci:RecoveryMod:RecoveryServiceSubnet
    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 RecoveryServiceSubnetArgs
    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 RecoveryServiceSubnetArgs
    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 RecoveryServiceSubnetArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args RecoveryServiceSubnetArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args RecoveryServiceSubnetArgs
    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 recoveryServiceSubnetResource = new Oci.RecoveryMod.RecoveryServiceSubnet("recoveryServiceSubnetResource", new()
    {
        CompartmentId = "string",
        DisplayName = "string",
        VcnId = "string",
        DefinedTags = 
        {
            { "string", "string" },
        },
        FreeformTags = 
        {
            { "string", "string" },
        },
        NsgIds = new[]
        {
            "string",
        },
        Subnets = new[]
        {
            "string",
        },
    });
    
    example, err := RecoveryMod.NewRecoveryServiceSubnet(ctx, "recoveryServiceSubnetResource", &RecoveryMod.RecoveryServiceSubnetArgs{
    	CompartmentId: pulumi.String("string"),
    	DisplayName:   pulumi.String("string"),
    	VcnId:         pulumi.String("string"),
    	DefinedTags: pulumi.StringMap{
    		"string": pulumi.String("string"),
    	},
    	FreeformTags: pulumi.StringMap{
    		"string": pulumi.String("string"),
    	},
    	NsgIds: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	Subnets: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    })
    
    var recoveryServiceSubnetResource = new RecoveryServiceSubnet("recoveryServiceSubnetResource", RecoveryServiceSubnetArgs.builder()
        .compartmentId("string")
        .displayName("string")
        .vcnId("string")
        .definedTags(Map.of("string", "string"))
        .freeformTags(Map.of("string", "string"))
        .nsgIds("string")
        .subnets("string")
        .build());
    
    recovery_service_subnet_resource = oci.recovery_mod.RecoveryServiceSubnet("recoveryServiceSubnetResource",
        compartment_id="string",
        display_name="string",
        vcn_id="string",
        defined_tags={
            "string": "string",
        },
        freeform_tags={
            "string": "string",
        },
        nsg_ids=["string"],
        subnets=["string"])
    
    const recoveryServiceSubnetResource = new oci.recoverymod.RecoveryServiceSubnet("recoveryServiceSubnetResource", {
        compartmentId: "string",
        displayName: "string",
        vcnId: "string",
        definedTags: {
            string: "string",
        },
        freeformTags: {
            string: "string",
        },
        nsgIds: ["string"],
        subnets: ["string"],
    });
    
    type: oci:RecoveryMod:RecoveryServiceSubnet
    properties:
        compartmentId: string
        definedTags:
            string: string
        displayName: string
        freeformTags:
            string: string
        nsgIds:
            - string
        subnets:
            - string
        vcnId: string
    

    RecoveryServiceSubnet 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 RecoveryServiceSubnet resource accepts the following input properties:

    CompartmentId string
    (Updatable) The compartment OCID.
    DisplayName string
    (Updatable) A user-provided name for the recovery service subnet. The 'displayName' does not have to be unique, and it can be modified. Avoid entering confidential information.
    VcnId string

    The OCID of the virtual cloud network (VCN) that contains the recovery service subnet. You can create a single recovery service subnet per VCN.

    ** 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

    DefinedTags Dictionary<string, string>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}. For more information, see Resource Tags
    FreeformTags Dictionary<string, string>
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    NsgIds List<string>
    (Updatable) A list of network security group (NSG) OCIDs that are associated with the Recovery Service subnet. You can specify a maximum of 5 unique OCIDs, which implies that you can associate a maximum of 5 NSGs to each Recovery Service subnet. Specify an empty array if you want to remove all the associated NSGs from a Recovery Service subnet. See Network Security Groups for more information.
    SubnetId string
    Deprecated. One of the subnets associated with the Recovery Service subnet.

    Deprecated: The 'subnet_id' field has been deprecated. Please use 'subnets' instead.

    Subnets List<string>
    (Updatable) A list of OCIDs of the subnets associated with the Recovery Service subnet.
    CompartmentId string
    (Updatable) The compartment OCID.
    DisplayName string
    (Updatable) A user-provided name for the recovery service subnet. The 'displayName' does not have to be unique, and it can be modified. Avoid entering confidential information.
    VcnId string

    The OCID of the virtual cloud network (VCN) that contains the recovery service subnet. You can create a single recovery service subnet per VCN.

    ** 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

    DefinedTags map[string]string
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}. For more information, see Resource Tags
    FreeformTags map[string]string
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    NsgIds []string
    (Updatable) A list of network security group (NSG) OCIDs that are associated with the Recovery Service subnet. You can specify a maximum of 5 unique OCIDs, which implies that you can associate a maximum of 5 NSGs to each Recovery Service subnet. Specify an empty array if you want to remove all the associated NSGs from a Recovery Service subnet. See Network Security Groups for more information.
    SubnetId string
    Deprecated. One of the subnets associated with the Recovery Service subnet.

    Deprecated: The 'subnet_id' field has been deprecated. Please use 'subnets' instead.

    Subnets []string
    (Updatable) A list of OCIDs of the subnets associated with the Recovery Service subnet.
    compartmentId String
    (Updatable) The compartment OCID.
    displayName String
    (Updatable) A user-provided name for the recovery service subnet. The 'displayName' does not have to be unique, and it can be modified. Avoid entering confidential information.
    vcnId String

    The OCID of the virtual cloud network (VCN) that contains the recovery service subnet. You can create a single recovery service subnet per VCN.

    ** 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

    definedTags Map<String,String>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}. For more information, see Resource Tags
    freeformTags Map<String,String>
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    nsgIds List<String>
    (Updatable) A list of network security group (NSG) OCIDs that are associated with the Recovery Service subnet. You can specify a maximum of 5 unique OCIDs, which implies that you can associate a maximum of 5 NSGs to each Recovery Service subnet. Specify an empty array if you want to remove all the associated NSGs from a Recovery Service subnet. See Network Security Groups for more information.
    subnetId String
    Deprecated. One of the subnets associated with the Recovery Service subnet.

    Deprecated: The 'subnet_id' field has been deprecated. Please use 'subnets' instead.

    subnets List<String>
    (Updatable) A list of OCIDs of the subnets associated with the Recovery Service subnet.
    compartmentId string
    (Updatable) The compartment OCID.
    displayName string
    (Updatable) A user-provided name for the recovery service subnet. The 'displayName' does not have to be unique, and it can be modified. Avoid entering confidential information.
    vcnId string

    The OCID of the virtual cloud network (VCN) that contains the recovery service subnet. You can create a single recovery service subnet per VCN.

    ** 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

    definedTags {[key: string]: string}
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}. For more information, see Resource Tags
    freeformTags {[key: string]: string}
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    nsgIds string[]
    (Updatable) A list of network security group (NSG) OCIDs that are associated with the Recovery Service subnet. You can specify a maximum of 5 unique OCIDs, which implies that you can associate a maximum of 5 NSGs to each Recovery Service subnet. Specify an empty array if you want to remove all the associated NSGs from a Recovery Service subnet. See Network Security Groups for more information.
    subnetId string
    Deprecated. One of the subnets associated with the Recovery Service subnet.

    Deprecated: The 'subnet_id' field has been deprecated. Please use 'subnets' instead.

    subnets string[]
    (Updatable) A list of OCIDs of the subnets associated with the Recovery Service subnet.
    compartment_id str
    (Updatable) The compartment OCID.
    display_name str
    (Updatable) A user-provided name for the recovery service subnet. The 'displayName' does not have to be unique, and it can be modified. Avoid entering confidential information.
    vcn_id str

    The OCID of the virtual cloud network (VCN) that contains the recovery service subnet. You can create a single recovery service subnet per VCN.

    ** 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

    defined_tags Mapping[str, str]
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}. For more information, see Resource Tags
    freeform_tags Mapping[str, str]
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    nsg_ids Sequence[str]
    (Updatable) A list of network security group (NSG) OCIDs that are associated with the Recovery Service subnet. You can specify a maximum of 5 unique OCIDs, which implies that you can associate a maximum of 5 NSGs to each Recovery Service subnet. Specify an empty array if you want to remove all the associated NSGs from a Recovery Service subnet. See Network Security Groups for more information.
    subnet_id str
    Deprecated. One of the subnets associated with the Recovery Service subnet.

    Deprecated: The 'subnet_id' field has been deprecated. Please use 'subnets' instead.

    subnets Sequence[str]
    (Updatable) A list of OCIDs of the subnets associated with the Recovery Service subnet.
    compartmentId String
    (Updatable) The compartment OCID.
    displayName String
    (Updatable) A user-provided name for the recovery service subnet. The 'displayName' does not have to be unique, and it can be modified. Avoid entering confidential information.
    vcnId String

    The OCID of the virtual cloud network (VCN) that contains the recovery service subnet. You can create a single recovery service subnet per VCN.

    ** 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

    definedTags Map<String>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}. For more information, see Resource Tags
    freeformTags Map<String>
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    nsgIds List<String>
    (Updatable) A list of network security group (NSG) OCIDs that are associated with the Recovery Service subnet. You can specify a maximum of 5 unique OCIDs, which implies that you can associate a maximum of 5 NSGs to each Recovery Service subnet. Specify an empty array if you want to remove all the associated NSGs from a Recovery Service subnet. See Network Security Groups for more information.
    subnetId String
    Deprecated. One of the subnets associated with the Recovery Service subnet.

    Deprecated: The 'subnet_id' field has been deprecated. Please use 'subnets' instead.

    subnets List<String>
    (Updatable) A list of OCIDs of the subnets associated with the Recovery Service subnet.

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    LifecycleDetails string
    Detailed description about the current lifecycle state of the recovery service subnet. For example, it can be used to provide actionable information for a resource in a Failed state
    State string
    The current state of the recovery service subnet.
    SystemTags Dictionary<string, string>
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}. For more information, see Resource Tags
    TimeCreated string
    An RFC3339 formatted datetime string that indicates the last created time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    TimeUpdated string
    An RFC3339 formatted datetime string that indicates the last updated time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    Id string
    The provider-assigned unique ID for this managed resource.
    LifecycleDetails string
    Detailed description about the current lifecycle state of the recovery service subnet. For example, it can be used to provide actionable information for a resource in a Failed state
    State string
    The current state of the recovery service subnet.
    SystemTags map[string]string
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}. For more information, see Resource Tags
    TimeCreated string
    An RFC3339 formatted datetime string that indicates the last created time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    TimeUpdated string
    An RFC3339 formatted datetime string that indicates the last updated time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    id String
    The provider-assigned unique ID for this managed resource.
    lifecycleDetails String
    Detailed description about the current lifecycle state of the recovery service subnet. For example, it can be used to provide actionable information for a resource in a Failed state
    state String
    The current state of the recovery service subnet.
    systemTags Map<String,String>
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}. For more information, see Resource Tags
    timeCreated String
    An RFC3339 formatted datetime string that indicates the last created time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    timeUpdated String
    An RFC3339 formatted datetime string that indicates the last updated time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    id string
    The provider-assigned unique ID for this managed resource.
    lifecycleDetails string
    Detailed description about the current lifecycle state of the recovery service subnet. For example, it can be used to provide actionable information for a resource in a Failed state
    state string
    The current state of the recovery service subnet.
    systemTags {[key: string]: string}
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}. For more information, see Resource Tags
    timeCreated string
    An RFC3339 formatted datetime string that indicates the last created time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    timeUpdated string
    An RFC3339 formatted datetime string that indicates the last updated time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    id str
    The provider-assigned unique ID for this managed resource.
    lifecycle_details str
    Detailed description about the current lifecycle state of the recovery service subnet. For example, it can be used to provide actionable information for a resource in a Failed state
    state str
    The current state of the recovery service subnet.
    system_tags Mapping[str, str]
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}. For more information, see Resource Tags
    time_created str
    An RFC3339 formatted datetime string that indicates the last created time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    time_updated str
    An RFC3339 formatted datetime string that indicates the last updated time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    id String
    The provider-assigned unique ID for this managed resource.
    lifecycleDetails String
    Detailed description about the current lifecycle state of the recovery service subnet. For example, it can be used to provide actionable information for a resource in a Failed state
    state String
    The current state of the recovery service subnet.
    systemTags Map<String>
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}. For more information, see Resource Tags
    timeCreated String
    An RFC3339 formatted datetime string that indicates the last created time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    timeUpdated String
    An RFC3339 formatted datetime string that indicates the last updated time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.

    Look up Existing RecoveryServiceSubnet Resource

    Get an existing RecoveryServiceSubnet 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?: RecoveryServiceSubnetState, opts?: CustomResourceOptions): RecoveryServiceSubnet
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            compartment_id: Optional[str] = None,
            defined_tags: Optional[Mapping[str, str]] = None,
            display_name: Optional[str] = None,
            freeform_tags: Optional[Mapping[str, str]] = None,
            lifecycle_details: Optional[str] = None,
            nsg_ids: Optional[Sequence[str]] = None,
            state: Optional[str] = None,
            subnet_id: Optional[str] = None,
            subnets: Optional[Sequence[str]] = None,
            system_tags: Optional[Mapping[str, str]] = None,
            time_created: Optional[str] = None,
            time_updated: Optional[str] = None,
            vcn_id: Optional[str] = None) -> RecoveryServiceSubnet
    func GetRecoveryServiceSubnet(ctx *Context, name string, id IDInput, state *RecoveryServiceSubnetState, opts ...ResourceOption) (*RecoveryServiceSubnet, error)
    public static RecoveryServiceSubnet Get(string name, Input<string> id, RecoveryServiceSubnetState? state, CustomResourceOptions? opts = null)
    public static RecoveryServiceSubnet get(String name, Output<String> id, RecoveryServiceSubnetState state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    name
    The unique name of the resulting resource.
    id
    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
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    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
    The unique name of the resulting resource.
    id
    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
    The unique name of the resulting resource.
    id
    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 string
    (Updatable) The compartment OCID.
    DefinedTags Dictionary<string, string>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}. For more information, see Resource Tags
    DisplayName string
    (Updatable) A user-provided name for the recovery service subnet. The 'displayName' does not have to be unique, and it can be modified. Avoid entering confidential information.
    FreeformTags Dictionary<string, string>
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    LifecycleDetails string
    Detailed description about the current lifecycle state of the recovery service subnet. For example, it can be used to provide actionable information for a resource in a Failed state
    NsgIds List<string>
    (Updatable) A list of network security group (NSG) OCIDs that are associated with the Recovery Service subnet. You can specify a maximum of 5 unique OCIDs, which implies that you can associate a maximum of 5 NSGs to each Recovery Service subnet. Specify an empty array if you want to remove all the associated NSGs from a Recovery Service subnet. See Network Security Groups for more information.
    State string
    The current state of the recovery service subnet.
    SubnetId string
    Deprecated. One of the subnets associated with the Recovery Service subnet.

    Deprecated: The 'subnet_id' field has been deprecated. Please use 'subnets' instead.

    Subnets List<string>
    (Updatable) A list of OCIDs of the subnets associated with the Recovery Service subnet.
    SystemTags Dictionary<string, string>
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}. For more information, see Resource Tags
    TimeCreated string
    An RFC3339 formatted datetime string that indicates the last created time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    TimeUpdated string
    An RFC3339 formatted datetime string that indicates the last updated time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    VcnId string

    The OCID of the virtual cloud network (VCN) that contains the recovery service subnet. You can create a single recovery service subnet per VCN.

    ** 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 string
    (Updatable) The compartment OCID.
    DefinedTags map[string]string
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}. For more information, see Resource Tags
    DisplayName string
    (Updatable) A user-provided name for the recovery service subnet. The 'displayName' does not have to be unique, and it can be modified. Avoid entering confidential information.
    FreeformTags map[string]string
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    LifecycleDetails string
    Detailed description about the current lifecycle state of the recovery service subnet. For example, it can be used to provide actionable information for a resource in a Failed state
    NsgIds []string
    (Updatable) A list of network security group (NSG) OCIDs that are associated with the Recovery Service subnet. You can specify a maximum of 5 unique OCIDs, which implies that you can associate a maximum of 5 NSGs to each Recovery Service subnet. Specify an empty array if you want to remove all the associated NSGs from a Recovery Service subnet. See Network Security Groups for more information.
    State string
    The current state of the recovery service subnet.
    SubnetId string
    Deprecated. One of the subnets associated with the Recovery Service subnet.

    Deprecated: The 'subnet_id' field has been deprecated. Please use 'subnets' instead.

    Subnets []string
    (Updatable) A list of OCIDs of the subnets associated with the Recovery Service subnet.
    SystemTags map[string]string
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}. For more information, see Resource Tags
    TimeCreated string
    An RFC3339 formatted datetime string that indicates the last created time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    TimeUpdated string
    An RFC3339 formatted datetime string that indicates the last updated time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    VcnId string

    The OCID of the virtual cloud network (VCN) that contains the recovery service subnet. You can create a single recovery service subnet per VCN.

    ** 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 String
    (Updatable) The compartment OCID.
    definedTags Map<String,String>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}. For more information, see Resource Tags
    displayName String
    (Updatable) A user-provided name for the recovery service subnet. The 'displayName' does not have to be unique, and it can be modified. Avoid entering confidential information.
    freeformTags Map<String,String>
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    lifecycleDetails String
    Detailed description about the current lifecycle state of the recovery service subnet. For example, it can be used to provide actionable information for a resource in a Failed state
    nsgIds List<String>
    (Updatable) A list of network security group (NSG) OCIDs that are associated with the Recovery Service subnet. You can specify a maximum of 5 unique OCIDs, which implies that you can associate a maximum of 5 NSGs to each Recovery Service subnet. Specify an empty array if you want to remove all the associated NSGs from a Recovery Service subnet. See Network Security Groups for more information.
    state String
    The current state of the recovery service subnet.
    subnetId String
    Deprecated. One of the subnets associated with the Recovery Service subnet.

    Deprecated: The 'subnet_id' field has been deprecated. Please use 'subnets' instead.

    subnets List<String>
    (Updatable) A list of OCIDs of the subnets associated with the Recovery Service subnet.
    systemTags Map<String,String>
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}. For more information, see Resource Tags
    timeCreated String
    An RFC3339 formatted datetime string that indicates the last created time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    timeUpdated String
    An RFC3339 formatted datetime string that indicates the last updated time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    vcnId String

    The OCID of the virtual cloud network (VCN) that contains the recovery service subnet. You can create a single recovery service subnet per VCN.

    ** 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 string
    (Updatable) The compartment OCID.
    definedTags {[key: string]: string}
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}. For more information, see Resource Tags
    displayName string
    (Updatable) A user-provided name for the recovery service subnet. The 'displayName' does not have to be unique, and it can be modified. Avoid entering confidential information.
    freeformTags {[key: string]: string}
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    lifecycleDetails string
    Detailed description about the current lifecycle state of the recovery service subnet. For example, it can be used to provide actionable information for a resource in a Failed state
    nsgIds string[]
    (Updatable) A list of network security group (NSG) OCIDs that are associated with the Recovery Service subnet. You can specify a maximum of 5 unique OCIDs, which implies that you can associate a maximum of 5 NSGs to each Recovery Service subnet. Specify an empty array if you want to remove all the associated NSGs from a Recovery Service subnet. See Network Security Groups for more information.
    state string
    The current state of the recovery service subnet.
    subnetId string
    Deprecated. One of the subnets associated with the Recovery Service subnet.

    Deprecated: The 'subnet_id' field has been deprecated. Please use 'subnets' instead.

    subnets string[]
    (Updatable) A list of OCIDs of the subnets associated with the Recovery Service subnet.
    systemTags {[key: string]: string}
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}. For more information, see Resource Tags
    timeCreated string
    An RFC3339 formatted datetime string that indicates the last created time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    timeUpdated string
    An RFC3339 formatted datetime string that indicates the last updated time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    vcnId string

    The OCID of the virtual cloud network (VCN) that contains the recovery service subnet. You can create a single recovery service subnet per VCN.

    ** 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 str
    (Updatable) The compartment OCID.
    defined_tags Mapping[str, str]
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}. For more information, see Resource Tags
    display_name str
    (Updatable) A user-provided name for the recovery service subnet. The 'displayName' does not have to be unique, and it can be modified. Avoid entering confidential information.
    freeform_tags Mapping[str, str]
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    lifecycle_details str
    Detailed description about the current lifecycle state of the recovery service subnet. For example, it can be used to provide actionable information for a resource in a Failed state
    nsg_ids Sequence[str]
    (Updatable) A list of network security group (NSG) OCIDs that are associated with the Recovery Service subnet. You can specify a maximum of 5 unique OCIDs, which implies that you can associate a maximum of 5 NSGs to each Recovery Service subnet. Specify an empty array if you want to remove all the associated NSGs from a Recovery Service subnet. See Network Security Groups for more information.
    state str
    The current state of the recovery service subnet.
    subnet_id str
    Deprecated. One of the subnets associated with the Recovery Service subnet.

    Deprecated: The 'subnet_id' field has been deprecated. Please use 'subnets' instead.

    subnets Sequence[str]
    (Updatable) A list of OCIDs of the subnets associated with the Recovery Service subnet.
    system_tags Mapping[str, str]
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}. For more information, see Resource Tags
    time_created str
    An RFC3339 formatted datetime string that indicates the last created time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    time_updated str
    An RFC3339 formatted datetime string that indicates the last updated time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    vcn_id str

    The OCID of the virtual cloud network (VCN) that contains the recovery service subnet. You can create a single recovery service subnet per VCN.

    ** 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 String
    (Updatable) The compartment OCID.
    definedTags Map<String>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"foo-namespace.bar-key": "value"}. For more information, see Resource Tags
    displayName String
    (Updatable) A user-provided name for the recovery service subnet. The 'displayName' does not have to be unique, and it can be modified. Avoid entering confidential information.
    freeformTags Map<String>
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
    lifecycleDetails String
    Detailed description about the current lifecycle state of the recovery service subnet. For example, it can be used to provide actionable information for a resource in a Failed state
    nsgIds List<String>
    (Updatable) A list of network security group (NSG) OCIDs that are associated with the Recovery Service subnet. You can specify a maximum of 5 unique OCIDs, which implies that you can associate a maximum of 5 NSGs to each Recovery Service subnet. Specify an empty array if you want to remove all the associated NSGs from a Recovery Service subnet. See Network Security Groups for more information.
    state String
    The current state of the recovery service subnet.
    subnetId String
    Deprecated. One of the subnets associated with the Recovery Service subnet.

    Deprecated: The 'subnet_id' field has been deprecated. Please use 'subnets' instead.

    subnets List<String>
    (Updatable) A list of OCIDs of the subnets associated with the Recovery Service subnet.
    systemTags Map<String>
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}. For more information, see Resource Tags
    timeCreated String
    An RFC3339 formatted datetime string that indicates the last created time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    timeUpdated String
    An RFC3339 formatted datetime string that indicates the last updated time for a recovery service subnet. For example: '2020-05-22T21:10:29.600Z'.
    vcnId String

    The OCID of the virtual cloud network (VCN) that contains the recovery service subnet. You can create a single recovery service subnet per VCN.

    ** 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

    Import

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

    $ pulumi import oci:RecoveryMod/recoveryServiceSubnet:RecoveryServiceSubnet test_recovery_service_subnet "id"
    

    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.
    oci logo
    Oracle Cloud Infrastructure v2.17.0 published on Friday, Nov 15, 2024 by Pulumi