ServiceOfferingInstance refresh request

Description

This API refreshes the ServiceOfferingInstance object specified by the identifier in the URI. It supports the refresh of single and multi-tier service offering instances on the Microsoft Windows and Linux operating systems. The following properties are refreshed:

• CPU
• Memory
• Power state
• Operating system information
  
  The following constraints apply to this API:
• The virtual machine (VM) can be in any power state.
• The name of the VM should match the name used for the VM in BMC Service Automation and VMware vCenter Server.
• The network labels defined in the network resources section of the resource set in the service blueprint must match the labels for the network container and pod.
  
  The service offering instance refresh request has the following limitations:
• The request updates only attributes and does not update associations. It does not refresh VMs that have been moved to a different network container or VMware vCenter Server.
• The request does not refresh changes made to IP addresses or host names.
• The request does not update option choices.

• The request does not generate new contract lines.
  
  After a service offering instance refresh request finishes, you can obtain updated data for the refreshed properties. To obtain refreshed data for CPU, memory, and power state, send the following request:

  GET /csm/serviceofferinginstance/guid/functionalComponents/resourceSet/compute

  The response contains the URI of the associated operating system in the operatingSystem object. To obtain data for the operating system, use that URI in the following request:

  GET /csm/operatingsystem/guid

  API stability classification

  API overview

  HTTP request message

  Query string parameters

  This API does not use query string parameters.

  Request message headers

  This API uses only common headers listed in HTTP-request-and-response-headers.

  Request message body

  This API uses the following objects in the request message body JSON.
  
  Top-level objects

  The [confluence_table-plus] macro is a standalone macro and it cannot be used inline. Click on this message for details.
  This macro generates standalone content. As a consequence you need to make sure to use a syntax that separates your macro from the content before and after it so that it's on a line by itself. For example in XWiki Syntax 2.0+ this means having 2 newline characters (a.k.a line breaks) separating your macro from the content before and after it.
  Input parameters to include in operationParams

  HTTP response message

  Response message headers

  This API uses only common headers listed in HTTP-request-and-response-headers.

  Response message body

  The response message body contains a Task object.

  Unknown macro: confluence_report-block. Click on this message for details.

  The [confluence_report-block] macro is not in the list of registered macros. Verify the spelling or contact your administrator.