Views:
Post and import an exported profile package to the SMS. Profiles include shared settings such as action sets, notification contacts, and services.
  • If the imported profile includes policies or category settings that use a particular action set, the action set is added to the SMS. The SMS does not overwrite an existing action set with the same name. Instead, the SMS renames the new action set by appending a number to the end of the file name, for example, “My Quarantine_2”.
  • A notification contact that is used by an action set is also imported and renamed, if necessary.
  • Existing port definitions for services on the SMS remain the same. If an imported profile includes a service with a port definition that differs from the existing service on the SMS, the service is added to the SMS service list. Review services any time a profile is imported from a different user or from a different environment.

Definition

ipsProfileMgmt/importProfile

Parameters

Parameter Type Description
importAction string Required.
  • add: Adds a completely new profile; must have an unused name or import fails.
  • combine_add: Adds new settings and merges non-conflicting changes into an existing profile.
  • combine_change: Adds new settings to and overwrites existing settings of an existing profile with settings of the new profile.
  • replace: Overwrites contents of SMS profile with those of the profile being imported; name and UUID remain the same; snapshot of replaced profile occurs and updated profile gets new version.
targetProfileName string Name of the existing profile on the SMS. Required for all replace and combine actions.
  • The profile must exist on the SMS.
  • If the specified profile does not exist or is not specified in the request, the operation fails and updates the audit log.
replacedProfileName string Name of the imported profile that will have its contents applied to the existing profile on the SMS.
  • Required for all replace and combine actions.
  • The profile must be specified in the request.
  • If the specified profile does not exist or is not specified in the request, the operation fails and updates the audit log.

Example

curl -k --header "X-SMS-API-KEY: <string>"-F "file=@</path/to/import.pkg>" 
"https://<sms_server>/ipsProfileMgmt/importProfile?importAction=replace&
targetProfileName=<name>&replacedProfileName=<name>"