LaunchInstance.go

// This is an automatically generated code sample.
// To make this code sample work in your Oracle Cloud tenancy,
// please replace the values for any parameters whose current values do not fit
// your use case (such as resource IDs, strings containing ‘EXAMPLE’ or ‘unique_id’, and
// boolean, number, and enum parameters with values not fitting your use case).

package main

import (
	"context"
	"fmt"

	"github.com/oracle/oci-go-sdk/v65/common"
	"github.com/oracle/oci-go-sdk/v65/core"
	"github.com/oracle/oci-go-sdk/v65/example/helpers"
)

func ExampleLaunchInstance() {
	// Create a default authentication provider that uses the DEFAULT
	// profile in the configuration file.
	// Refer to <see href="https://docs.cloud.oracle.com/en-us/iaas/Content/API/Concepts/sdkconfig.htm#SDK_and_CLI_Configuration_File>the public documentation</see> on how to prepare a configuration file.
	client, err := core.NewComputeClientWithConfigurationProvider(common.DefaultConfigProvider())
	helpers.FatalIfError(err)

	// Create a request and dependent object(s).

	req := core.LaunchInstanceRequest{LaunchInstanceDetails: core.LaunchInstanceDetails{ClusterPlacementGroupId: common.String("ocid1.test.oc1..<unique_ID>EXAMPLE-clusterPlacementGroupId-Value"),
		AgentConfig: &core.LaunchInstanceAgentConfigDetails{AreAllPluginsDisabled: common.Bool(true),
			IsManagementDisabled: common.Bool(false),
			IsMonitoringDisabled: common.Bool(true),
			PluginsConfig: []core.InstanceAgentPluginConfigDetails{core.InstanceAgentPluginConfigDetails{DesiredState: core.InstanceAgentPluginConfigDetailsDesiredStateDisabled,
				Name: common.String("EXAMPLE-name-Value")}}},
		DedicatedVmHostId: common.String("ocid1.test.oc1..<unique_ID>EXAMPLE-dedicatedVmHostId-Value"),
		PlatformConfig: core.IntelIcelakeBmLaunchInstancePlatformConfig{IsSymmetricMultiThreadingEnabled: common.Bool(false),
			IsSecureBootEnabled:                      common.Bool(true),
			IsTrustedPlatformModuleEnabled:           common.Bool(true),
			NumaNodesPerSocket:                       core.IntelIcelakeBmLaunchInstancePlatformConfigNumaNodesPerSocketNps2,
			PercentageOfCoresEnabled:                 common.Int(35),
			ConfigMap:                                map[string]string{"EXAMPLE_KEY_e46VQ": "EXAMPLE_VALUE_ycZs3lPNxxwpPzGCDNVZ"},
			IsInputOutputMemoryManagementUnitEnabled: common.Bool(false),
			IsMeasuredBootEnabled:                    common.Bool(true),
			IsMemoryEncryptionEnabled:                common.Bool(false)},
		SecurityAttributes: map[string]map[string]interface{}{"EXAMPLE_KEY_MzPbI": map[string]interface{}{"EXAMPLE_KEY_dFKjC": "EXAMPLE--Value"}},
		SourceDetails: core.InstanceSourceViaImageDetails{KmsKeyId: common.String("ocid1.test.oc1..<unique_ID>EXAMPLE-kmsKeyId-Value"),
			BootVolumeSizeInGBs: common.Int64(920),
			BootVolumeVpusPerGB: common.Int64(212),
			ImageId:             common.String("ocid1.test.oc1..<unique_ID>EXAMPLE-imageId-Value"),
			InstanceSourceImageFilterDetails: &core.InstanceSourceImageFilterDetails{CompartmentId: common.String("ocid1.test.oc1..<unique_ID>EXAMPLE-compartmentId-Value"),
				DefinedTagsFilter:      map[string]map[string]interface{}{"EXAMPLE_KEY_LaKen": map[string]interface{}{"EXAMPLE_KEY_r7S0I": "EXAMPLE--Value"}},
				OperatingSystem:        common.String("EXAMPLE-operatingSystem-Value"),
				OperatingSystemVersion: common.String("EXAMPLE-operatingSystemVersion-Value")}},
		AvailabilityDomain: common.String("EXAMPLE-availabilityDomain-Value"),
		LaunchOptions: &core.LaunchOptions{IsConsistentVolumeNamingEnabled: common.Bool(false),
			IsPvEncryptionInTransitEnabled: common.Bool(true),
			NetworkType:                    core.LaunchOptionsNetworkTypeVfio,
			RemoteDataVolumeType:           core.LaunchOptionsRemoteDataVolumeTypeVfio,
			BootVolumeType:                 core.LaunchOptionsBootVolumeTypeVfio,
			Firmware:                       core.LaunchOptionsFirmwareBios},
		SubnetId:              common.String("ocid1.test.oc1..<unique_ID>EXAMPLE-subnetId-Value"),
		CapacityReservationId: common.String("ocid1.test.oc1..<unique_ID>EXAMPLE-capacityReservationId-Value"),
		CompartmentId:         common.String("ocid1.test.oc1..<unique_ID>EXAMPLE-compartmentId-Value"),
		HostnameLabel:         common.String("EXAMPLE-hostnameLabel-Value"),
		ImageId:               common.String("ocid1.test.oc1..<unique_ID>EXAMPLE-imageId-Value"),
		LicensingConfigs:      []core.LaunchInstanceLicensingConfig{core.LaunchInstanceWindowsLicensingConfig{LicenseType: core.LaunchInstanceLicensingConfigLicenseTypeBringYourOwnLicense}},
		Metadata:              map[string]string{"EXAMPLE_KEY_aHqGd": "EXAMPLE_VALUE_45Rn2baBhbTAhc0dXBUq"},
		ShapeConfig: &core.LaunchInstanceShapeConfigDetails{BaselineOcpuUtilization: core.LaunchInstanceShapeConfigDetailsBaselineOcpuUtilization1,
			MemoryInGBs:        common.Float32(5565.037),
			Nvmes:              common.Int(5),
			Ocpus:              common.Float32(9124.342),
			ResourceManagement: core.LaunchInstanceShapeConfigDetailsResourceManagementStatic,
			Vcpus:              common.Int(290)},
		DefinedTags:               map[string]map[string]interface{}{"EXAMPLE_KEY_Yrg1m": map[string]interface{}{"EXAMPLE_KEY_3dIW1": "EXAMPLE--Value"}},
		FreeformTags:              map[string]string{"EXAMPLE_KEY_B7GJV": "EXAMPLE_VALUE_uziagAx3kf32o8lKn14C"},
		IsAIEnterpriseEnabled:     common.Bool(true),
		PreemptibleInstanceConfig: &core.PreemptibleInstanceConfigDetails{PreemptionAction: core.TerminatePreemptionAction{PreserveBootVolume: common.Bool(false)}},
		AvailabilityConfig: &core.LaunchInstanceAvailabilityConfigDetails{IsLiveMigrationPreferred: common.Bool(true),
			RecoveryAction: core.LaunchInstanceAvailabilityConfigDetailsRecoveryActionRestoreInstance},
		CreateVnicDetails: &core.CreateVnicDetails{DisplayName: common.String("EXAMPLE-displayName-Value"),
			SubnetCidr:     common.String("EXAMPLE-subnetCidr-Value"),
			DefinedTags:    map[string]map[string]interface{}{"EXAMPLE_KEY_t64jM": map[string]interface{}{"EXAMPLE_KEY_jD2PC": "EXAMPLE--Value"}},
			NsgIds:         []string{"EXAMPLE--Value"},
			PrivateIp:      common.String("EXAMPLE-privateIp-Value"),
			AssignPublicIp: common.Bool(false),
			FreeformTags:   map[string]string{"EXAMPLE_KEY_jX7tM": "EXAMPLE_VALUE_P7uxPz5hJZEBCvTsNoMv"},
			HostnameLabel:  common.String("EXAMPLE-hostnameLabel-Value"),
			Ipv6AddressIpv6SubnetCidrPairDetails: []core.Ipv6AddressIpv6SubnetCidrPairDetails{core.Ipv6AddressIpv6SubnetCidrPairDetails{Ipv6SubnetCidr: common.String("EXAMPLE-ipv6SubnetCidr-Value"),
				Ipv6Address: common.String("EXAMPLE-ipv6Address-Value")}},
			SkipSourceDestCheck:    common.Bool(true),
			SubnetId:               common.String("ocid1.test.oc1..<unique_ID>EXAMPLE-subnetId-Value"),
			AssignIpv6Ip:           common.Bool(true),
			AssignPrivateDnsRecord: common.Bool(false),
			SecurityAttributes:     map[string]map[string]interface{}{"EXAMPLE_KEY_qTNtT": map[string]interface{}{"EXAMPLE_KEY_6DRny": "EXAMPLE--Value"}},
			VlanId:                 common.String("ocid1.test.oc1..<unique_ID>EXAMPLE-vlanId-Value")},
		DisplayName: common.String("EXAMPLE-displayName-Value"),
		IpxeScript:  common.String("EXAMPLE-ipxeScript-Value"),
		LaunchVolumeAttachments: []core.LaunchAttachVolumeDetails{core.LaunchAttachParavirtualizedVolumeDetails{Device: common.String("EXAMPLE-device-Value"),
			DisplayName:                    common.String("EXAMPLE-displayName-Value"),
			IsPvEncryptionInTransitEnabled: common.Bool(false),
			IsReadOnly:                     common.Bool(false),
			IsShareable:                    common.Bool(true),
			LaunchCreateVolumeDetails: core.LaunchCreateVolumeFromAttributes{VpusPerGB: common.Int64(875),
				CompartmentId: common.String("ocid1.test.oc1..<unique_ID>EXAMPLE-compartmentId-Value"),
				DisplayName:   common.String("EXAMPLE-displayName-Value"),
				KmsKeyId:      common.String("ocid1.test.oc1..<unique_ID>EXAMPLE-kmsKeyId-Value"),
				SizeInGBs:     common.Int64(47)},
			VolumeId: common.String("ocid1.test.oc1..<unique_ID>EXAMPLE-volumeId-Value")}},
		ComputeClusterId:               common.String("ocid1.test.oc1..<unique_ID>EXAMPLE-computeClusterId-Value"),
		ExtendedMetadata:               map[string]interface{}{"EXAMPLE_KEY_HAIu7": "EXAMPLE--Value"},
		FaultDomain:                    common.String("EXAMPLE-faultDomain-Value"),
		InstanceConfigurationId:        common.String("ocid1.test.oc1..<unique_ID>EXAMPLE-instanceConfigurationId-Value"),
		InstanceOptions:                &core.InstanceOptions{AreLegacyImdsEndpointsDisabled: common.Bool(false)},
		IsPvEncryptionInTransitEnabled: common.Bool(false),
		PlacementConstraintDetails:     core.ComputeBareMetalHostPlacementConstraintDetails{ComputeBareMetalHostId: common.String("ocid1.test.oc1..<unique_ID>EXAMPLE-computeBareMetalHostId-Value")},
		Shape:                          common.String("EXAMPLE-shape-Value")},
		OpcRetryToken: common.String("EXAMPLE-opcRetryToken-Value")}

	// Send the request using the service client
	resp, err := client.LaunchInstance(context.Background(), req)
	helpers.FatalIfError(err)

	// Retrieve value from the response.
	fmt.Println(resp)
}
Oracle Cloud Infrastructure Documentation
