UpdateInstanceDetails

class oci.core.models.UpdateInstanceDetails(**kwargs)

Bases: object

UpdateInstanceDetails model.

Methods

__init__(**kwargs) Initializes a new UpdateInstanceDetails object with values from keyword arguments.

Attributes

agent_config Gets the agent_config of this UpdateInstanceDetails.
availability_config Gets the availability_config of this UpdateInstanceDetails.
defined_tags Gets the defined_tags of this UpdateInstanceDetails.
display_name Gets the display_name of this UpdateInstanceDetails.
extended_metadata Gets the extended_metadata of this UpdateInstanceDetails.
fault_domain Gets the fault_domain of this UpdateInstanceDetails.
freeform_tags Gets the freeform_tags of this UpdateInstanceDetails.
instance_options Gets the instance_options of this UpdateInstanceDetails.
launch_options Gets the launch_options of this UpdateInstanceDetails.
metadata Gets the metadata of this UpdateInstanceDetails.
shape Gets the shape of this UpdateInstanceDetails.
shape_config Gets the shape_config of this UpdateInstanceDetails.
__init__(**kwargs)

Initializes a new UpdateInstanceDetails object with values from keyword arguments. The following keyword arguments are supported (corresponding to the getters/setters of this class):

Parameters:
  • defined_tags (dict(str, dict(str, object))) – The value to assign to the defined_tags property of this UpdateInstanceDetails.
  • display_name (str) – The value to assign to the display_name property of this UpdateInstanceDetails.
  • freeform_tags (dict(str, str)) – The value to assign to the freeform_tags property of this UpdateInstanceDetails.
  • agent_config (UpdateInstanceAgentConfigDetails) – The value to assign to the agent_config property of this UpdateInstanceDetails.
  • metadata (dict(str, str)) – The value to assign to the metadata property of this UpdateInstanceDetails.
  • extended_metadata (dict(str, object)) – The value to assign to the extended_metadata property of this UpdateInstanceDetails.
  • shape (str) – The value to assign to the shape property of this UpdateInstanceDetails.
  • shape_config (UpdateInstanceShapeConfigDetails) – The value to assign to the shape_config property of this UpdateInstanceDetails.
  • instance_options (InstanceOptions) – The value to assign to the instance_options property of this UpdateInstanceDetails.
  • fault_domain (str) – The value to assign to the fault_domain property of this UpdateInstanceDetails.
  • launch_options (UpdateLaunchOptions) – The value to assign to the launch_options property of this UpdateInstanceDetails.
  • availability_config (UpdateInstanceAvailabilityConfigDetails) – The value to assign to the availability_config property of this UpdateInstanceDetails.
agent_config

Gets the agent_config of this UpdateInstanceDetails. Instance agent configuration options to choose for updating the instance

Returns:The agent_config of this UpdateInstanceDetails.
Return type:UpdateInstanceAgentConfigDetails
availability_config

Gets the availability_config of this UpdateInstanceDetails. Options for defining the availability of a VM instance after a maintenance event that impacts the underlying hardware.

Returns:The availability_config of this UpdateInstanceDetails.
Return type:UpdateInstanceAvailabilityConfigDetails
defined_tags

Gets the defined_tags of this UpdateInstanceDetails. Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.

Example: {“Operations”: {“CostCenter”: “42”}}

Returns:The defined_tags of this UpdateInstanceDetails.
Return type:dict(str, dict(str, object))
display_name

Gets the display_name of this UpdateInstanceDetails. A user-friendly name. Does not have to be unique, and it’s changeable. Avoid entering confidential information.

Example: My bare metal instance

Returns:The display_name of this UpdateInstanceDetails.
Return type:str
extended_metadata

Gets the extended_metadata of this UpdateInstanceDetails. Additional metadata key/value pairs that you provide. They serve the same purpose and functionality as fields in the metadata object.

They are distinguished from metadata fields in that these can be nested JSON objects (whereas metadata fields are string/string maps only).

The “user_data” field and the “ssh_authorized_keys” field cannot be changed after an instance has launched. Any request that updates, removes, or adds either of these fields will be rejected. You must provide the same values for “user_data” and “ssh_authorized_keys” that already exist on the instance.

The combined size of the metadata and extendedMetadata objects can be a maximum of 32,000 bytes.

Returns:The extended_metadata of this UpdateInstanceDetails.
Return type:dict(str, object)
fault_domain

Gets the fault_domain of this UpdateInstanceDetails. A fault domain is a grouping of hardware and infrastructure within an availability domain. Each availability domain contains three fault domains. Fault domains let you distribute your instances so that they are not on the same physical hardware within a single availability domain. A hardware failure or Compute hardware maintenance that affects one fault domain does not affect instances in other fault domains.

To get a list of fault domains, use the list_fault_domains() operation in the Identity and Access Management Service API.

Example: FAULT-DOMAIN-1

Returns:The fault_domain of this UpdateInstanceDetails.
Return type:str
freeform_tags

Gets the freeform_tags of this UpdateInstanceDetails. 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”}

Returns:The freeform_tags of this UpdateInstanceDetails.
Return type:dict(str, str)
instance_options

Gets the instance_options of this UpdateInstanceDetails.

Returns:The instance_options of this UpdateInstanceDetails.
Return type:InstanceOptions
launch_options

Gets the launch_options of this UpdateInstanceDetails. Options for tuning the compatibility and performance of VM shapes.

Returns:The launch_options of this UpdateInstanceDetails.
Return type:UpdateLaunchOptions
metadata

Gets the metadata of this UpdateInstanceDetails. Custom metadata key/value string pairs that you provide. Any set of key/value pairs provided here will completely replace the current set of key/value pairs in the metadata field on the instance.

The “user_data” field and the “ssh_authorized_keys” field cannot be changed after an instance has launched. Any request that updates, removes, or adds either of these fields will be rejected. You must provide the same values for “user_data” and “ssh_authorized_keys” that already exist on the instance.

The combined size of the metadata and extendedMetadata objects can be a maximum of 32,000 bytes.

Returns:The metadata of this UpdateInstanceDetails.
Return type:dict(str, str)
shape

Gets the shape of this UpdateInstanceDetails. The shape of the instance. The shape determines the number of CPUs and the amount of memory allocated to the instance. For more information about how to change shapes, and a list of shapes that are supported, see Editing an Instance.

For details about the CPUs, memory, and other properties of each shape, see Compute Shapes.

The new shape must be compatible with the image that was used to launch the instance. You can enumerate all available shapes and determine image compatibility by calling list_shapes().

If the instance is running when you change the shape, the instance is rebooted.

Example: VM.Standard2.1

Returns:The shape of this UpdateInstanceDetails.
Return type:str
shape_config

Gets the shape_config of this UpdateInstanceDetails.

Returns:The shape_config of this UpdateInstanceDetails.
Return type:UpdateInstanceShapeConfigDetails