Localization Manager APIs

LocalizationManager provides access to descriptions of the message catalogs that are available for client-side message localization.

Clients of the VIM API may use SessionManager.SetLocale to cause the server to emit localized messages, or may perform client-side localization based on message catalogs provided by the LocalizationManager.

A message catalog is a file that contains a set of key-value pairs.

• The key is an ASCII string that identifies the message.
• The value is a UTF-8 string that contains the text of the message, sometimes containing substitution variables.

The server will localize fields tagged with 'localizable' based on the value of the UserSession.locale and messageLocale properties which are set via SessionManager.SetLocale.

The following list shows some of the ways that vSphere uses localized messages.

• Current task status (TaskInfo.description)
• Events (VirtualMachineMessage.text and Questions (VirtualMachineQuestionInfo.text)
• Faults (MethodFault.faultMessage)
• HostProfile and ClusterProfile descriptions (Profile.ProfileDescription. description returned by the Profile.RetrieveDescription method)

Operations

GET

Localization Manager Get Catalog

Fetches the descriptions of all the client-side localization message catalogs available for the current session locale.