import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as outputs from "../types/output"; /** * This resource provides the Vnic Attachment resource in Oracle Cloud Infrastructure Core service. * Api doc link for the resource: https://docs.oracle.com/iaas/api/#/en/iaas/latest/VnicAttachment * * Example terraform configs related to the resource : https://github.com/oracle/terraform-provider-oci/tree/master/examples/ * * Creates a secondary VNIC and attaches it to the specified instance. * For more information about secondary VNICs, see * [Virtual Network Interface Cards (VNICs)](https://docs.cloud.oracle.com/iaas/Content/Network/Tasks/managingVNICs.htm). * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as oci from "@pulumi/oci"; * * const testVnicAttachment = new oci.core.VnicAttachment("test_vnic_attachment", { * createVnicDetails: { * assignIpv6ip: vnicAttachmentCreateVnicDetailsAssignIpv6ip === "true", * assignPrivateDnsRecord: vnicAttachmentCreateVnicDetailsAssignPrivateDnsRecord === "true", * assignPublicIp: vnicAttachmentCreateVnicDetailsAssignPublicIp, * definedTags: vnicAttachmentCreateVnicDetailsDefinedTags, * displayName: vnicAttachmentCreateVnicDetailsDisplayName, * freeformTags: vnicAttachmentCreateVnicDetailsFreeformTags, * hostnameLabel: vnicAttachmentCreateVnicDetailsHostnameLabel, * ipv6addressIpv6subnetCidrPairDetails: [{ * ipv6address: vnicAttachmentCreateVnicDetailsIpv6addressIpv6subnetCidrPairDetailsIpv6address, * ipv6id: testIpv6.id, * ipv6subnetCidr: vnicAttachmentCreateVnicDetailsIpv6addressIpv6subnetCidrPairDetailsIpv6subnetCidr, * }], * nsgIds: vnicAttachmentCreateVnicDetailsNsgIds, * privateIp: vnicAttachmentCreateVnicDetailsPrivateIp, * privateIpId: testPrivateIp.id, * securityAttributes: vnicAttachmentCreateVnicDetailsSecurityAttributes, * skipSourceDestCheck: vnicAttachmentCreateVnicDetailsSkipSourceDestCheck === "true", * subnetCidr: vnicAttachmentCreateVnicDetailsSubnetCidr, * subnetId: testSubnet.id, * vlanId: testVlan.id, * }, * instanceId: testInstance.id, * displayName: vnicAttachmentDisplayName, * nicIndex: Number(vnicAttachmentNicIndex), * }); * ``` * * ## Import * * VnicAttachments can be imported using the `id`, e.g. * * ```sh * $ pulumi import oci:Core/vnicAttachment:VnicAttachment test_vnic_attachment "id" * ``` */ export declare class VnicAttachment extends pulumi.CustomResource { /** * Get an existing VnicAttachment 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?: VnicAttachmentState, opts?: pulumi.CustomResourceOptions): VnicAttachment; /** * Returns true if the given object is an instance of VnicAttachment. 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 VnicAttachment; /** * The availability domain of the instance. Example: `Uocm:PHX-AD-1` */ readonly availabilityDomain: pulumi.Output; /** * The OCID of the compartment the VNIC attachment is in, which is the same compartment the instance is in. */ readonly compartmentId: pulumi.Output; /** * (Updatable) Contains properties for a VNIC. You use this object when creating the primary VNIC during instance launch or when creating a secondary VNIC. For more information about VNICs, see [Virtual Network Interface Cards (VNICs)](https://docs.cloud.oracle.com/iaas/Content/Network/Tasks/managingVNICs.htm). */ readonly createVnicDetails: pulumi.Output; /** * A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. */ readonly displayName: pulumi.Output; /** * The OCID of the instance. */ readonly instanceId: pulumi.Output; /** * Which physical network interface card (NIC) the VNIC will use. Defaults to 0. Certain bare metal instance shapes have two active physical NICs (0 and 1). If you add a secondary VNIC to one of these instances, you can specify which NIC the VNIC will use. For more information, see [Virtual Network Interface Cards (VNICs)](https://docs.cloud.oracle.com/iaas/Content/Network/Tasks/managingVNICs.htm). * * ** 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 nicIndex: pulumi.Output; /** * The current state of the VNIC attachment. */ readonly state: pulumi.Output; /** * The OCID of the subnet to create the VNIC in. */ readonly subnetId: pulumi.Output; /** * The date and time the VNIC attachment was created, in the format defined by [RFC3339](https://tools.ietf.org/html/rfc3339). Example: `2016-08-25T21:10:29.600Z` */ readonly timeCreated: pulumi.Output; /** * The OCID of the VLAN to create the VNIC in. Creating the VNIC in a VLAN (instead of a subnet) is possible only if you are an Oracle Cloud VMware Solution customer. See [Vlan](https://docs.cloud.oracle.com/iaas/api/#/en/iaas/latest/Vlan). */ readonly vlanId: pulumi.Output; /** * The Oracle-assigned VLAN tag of the attached VNIC. Available after the attachment process is complete. */ readonly vlanTag: pulumi.Output; /** * The OCID of the VNIC. Available after the attachment process is complete. */ readonly vnicId: pulumi.Output; /** * Create a VnicAttachment 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: VnicAttachmentArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering VnicAttachment resources. */ export interface VnicAttachmentState { /** * The availability domain of the instance. Example: `Uocm:PHX-AD-1` */ availabilityDomain?: pulumi.Input; /** * The OCID of the compartment the VNIC attachment is in, which is the same compartment the instance is in. */ compartmentId?: pulumi.Input; /** * (Updatable) Contains properties for a VNIC. You use this object when creating the primary VNIC during instance launch or when creating a secondary VNIC. For more information about VNICs, see [Virtual Network Interface Cards (VNICs)](https://docs.cloud.oracle.com/iaas/Content/Network/Tasks/managingVNICs.htm). */ createVnicDetails?: pulumi.Input; /** * A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. */ displayName?: pulumi.Input; /** * The OCID of the instance. */ instanceId?: pulumi.Input; /** * Which physical network interface card (NIC) the VNIC will use. Defaults to 0. Certain bare metal instance shapes have two active physical NICs (0 and 1). If you add a secondary VNIC to one of these instances, you can specify which NIC the VNIC will use. For more information, see [Virtual Network Interface Cards (VNICs)](https://docs.cloud.oracle.com/iaas/Content/Network/Tasks/managingVNICs.htm). * * ** 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 */ nicIndex?: pulumi.Input; /** * The current state of the VNIC attachment. */ state?: pulumi.Input; /** * The OCID of the subnet to create the VNIC in. */ subnetId?: pulumi.Input; /** * The date and time the VNIC attachment was created, in the format defined by [RFC3339](https://tools.ietf.org/html/rfc3339). Example: `2016-08-25T21:10:29.600Z` */ timeCreated?: pulumi.Input; /** * The OCID of the VLAN to create the VNIC in. Creating the VNIC in a VLAN (instead of a subnet) is possible only if you are an Oracle Cloud VMware Solution customer. See [Vlan](https://docs.cloud.oracle.com/iaas/api/#/en/iaas/latest/Vlan). */ vlanId?: pulumi.Input; /** * The Oracle-assigned VLAN tag of the attached VNIC. Available after the attachment process is complete. */ vlanTag?: pulumi.Input; /** * The OCID of the VNIC. Available after the attachment process is complete. */ vnicId?: pulumi.Input; } /** * The set of arguments for constructing a VnicAttachment resource. */ export interface VnicAttachmentArgs { /** * (Updatable) Contains properties for a VNIC. You use this object when creating the primary VNIC during instance launch or when creating a secondary VNIC. For more information about VNICs, see [Virtual Network Interface Cards (VNICs)](https://docs.cloud.oracle.com/iaas/Content/Network/Tasks/managingVNICs.htm). */ createVnicDetails: pulumi.Input; /** * A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. */ displayName?: pulumi.Input; /** * The OCID of the instance. */ instanceId: pulumi.Input; /** * Which physical network interface card (NIC) the VNIC will use. Defaults to 0. Certain bare metal instance shapes have two active physical NICs (0 and 1). If you add a secondary VNIC to one of these instances, you can specify which NIC the VNIC will use. For more information, see [Virtual Network Interface Cards (VNICs)](https://docs.cloud.oracle.com/iaas/Content/Network/Tasks/managingVNICs.htm). * * ** 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 */ nicIndex?: pulumi.Input; } //# sourceMappingURL=vnicAttachment.d.ts.map