UpdateInstance
PUT {{baseUrl}}/instances/:instanceId
Updates certain fields on the specified instance. Fields that are not provided in the request will not be updated. Avoid entering confidential information.
Changes to metadata fields will be reflected in the instance metadata service (this may take up to a minute).
The OCID of the instance remains the same.
Request Body
{"agentConfig"=>{"areAllPluginsDisabled"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "isManagementDisabled"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "isMonitoringDisabled"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "pluginsConfig"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}}, "availabilityConfig"=>{"isLiveMigrationPreferred"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "recoveryAction"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}}, "capacityReservationId"=>"irure magna", "displayName"=>"Ut do dolor", "faultDomain"=>"nostrud laborum pariatur do", "instanceOptions"=>{"areLegacyImdsEndpointsDisabled"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}}, "launchOptions"=>{"bootVolumeType"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "isPvEncryptionInTransitEnabled"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "networkType"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}}, "shape"=>"consequat", "shapeConfig"=>{"baselineOcpuUtilization"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "memoryInGBs"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "ocpus"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}}}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
opc-retry-token | string | A token that uniquely identifies a request so it can be retried in case of a timeout or | |
server error without risk of executing that same action again. Retry tokens expire after 24 | |||
hours, but can be invalidated before then due to conflicting operations (for example, if a resource | |||
has been deleted and purged from the system, then a retry of the original creation request | |||
may be rejected). | |||
if-match | string | For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match | |
parameter to the value of the etag from a previous GET or POST response for that resource. The resource | |||
will be updated or deleted only if the etag you provide matches the resource's current etag value. | |||
Content-Type | string | ||
Date | string | (Required) Current Date | |
Authorization | string | (Required) Signature Authentication on Authorization header | |
x-content-sha256 | string | (Required) Content sha256 for POST, PUT and PATCH operations |
RESPONSES
status: OK
{"id":"sit dolor","compartmentId":"et esse","shape":"sunt veniam","region":"laboris","availabilityDomain":"dolor","lifecycleState":"TERMINATED","timeCreated":"2006-02-03T20:50:31.716Z","agentConfig":{"areAllPluginsDisabled":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"isManagementDisabled":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"isMonitoringDisabled":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"pluginsConfig":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"availabilityConfig":{"isLiveMigrationPreferred":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"recoveryAction":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"capacityReservationId":"occaecat sint id","dedicatedVmHostId":"ipsum dolor incididunt sit ex","definedTags":{},"displayName":"consequat aliquip magna ullamco","extendedMetadata":{},"faultDomain":"incididunt esse","freeformTags":{},"imageId":"dolor nulla consequat ipsum","instanceOptions":{"areLegacyImdsEndpointsDisabled":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"ipxeScript":"anim magna","launchMode":"CUSTOM","launchOptions":{"bootVolumeType":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"firmware":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"isConsistentVolumeNamingEnabled":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"isPvEncryptionInTransitEnabled":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"networkType":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"remoteDataVolumeType":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"metadata":{},"platformConfig":{"type":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"isMeasuredBootEnabled":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"isSecureBootEnabled":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"isTrustedPlatformModuleEnabled":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"preemptibleInstanceConfig":{"preemptionAction":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"shapeConfig":{"baselineOcpuUtilization":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"gpuDescription":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"gpus":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"localDiskDescription":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"localDisks":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"localDisksTotalSizeInGBs":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"maxVnicAttachments":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"memoryInGBs":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"networkingBandwidthInGbps":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"ocpus":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"processorDescription":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"sourceDetails":{"sourceType":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"timeMaintenanceRebootDue":"1973-07-06T14:36:00.263Z"}