Create Zone With Custom Settings operation
The Create Zone With Custom Settings operation creates a new Zone with advanced configuration options. This operation enables you to add virtual devices, such as a hard disk or an ethernet card, to a newly created Zone.
The following figure shows the <items> XML template for the Create Zone With Custom Settings operation:
The following table describes the elements for the adapter request.
Adapter request elements for the Create Zone With Custom Settings operation
Element | Definition | Required |
|---|---|---|
<operation-type> | Specifies the type of operation: Configure_Zone | Yes |
<operation-name> | Specifies the operation: Create_Zone_With_Custom_Settings | Yes |
<zone-name> | Specifies the name for the Zone that you want to create | Yes |
<host> | Specifies the name of the computer hosting Solaris Zones | No |
<port> | Specifies the port on which the SSH service is running on the host computer | No |
<operation-timeout-secs> | Specifies the time, in seconds, to wait for the operation to finish on the target server | No |
<zone-path> | Specifies the path in which the Zone files are installed | Yes |
<autoboot> | Specifies whether the Zone is booted when the associated Global Zone is booted
| No |
<pool> | Specifies the configured pool name for the new Zone to bind | No |
<boot-arguments> | Specifies persistent boot arguments for the Zone | No |
<dedicated-cpu> | Specifies the number of dedicated CPUs for the Zone | No |
<no-of-cpu> | Sets the number of CPUs for the Zone | Conditional |
<cpu-importance> | Sets the importance for the CPU | No |
<cpu-shares> | Specifies the number of Fair Share Scheduler (FSS) shares to allocate to this Zone | No |
<privileges> | Specifies the privileges to revise the default set of privileges | No |
<scheduling-class> | Provides different CPU access characteristics to threads, based on algorithmic logic
| No |
<capped-memory> | Sets the memory capacity for the Zone; enables you to place a soft restriction on the amount of memory that the Zone can use | No |
<physical> | Sets the physical memory capacity for the Zone; enables you to restrict the amount of physical memory that the Zone can use | Conditional |
<swap> | Sets the swap memory capacity for the Zone; enables you to restrict the amount of virtual memory that the Zone can use | Conditional |
<locked> | Sets the locked memory capacity for the Zone; enables you to place a locked memory cap on the amount of physical memory that the Zone can use | Conditional |
<file-systems> | Contains file systems to add to the Zone | No |
<file-system> | Specifies a file system to add to the Zone | Conditional |
<dir> | Sets the mount point for the file system | Conditional |
<special> | Sets the special file system for the Zone | Conditional |
<type> | Specifies the type of file system for <file-system> | Conditional |
<datasets> | Contains Zettabyte File System (ZFS) datasets in the storage pool | No |
<dataset> | Specifies a ZFS dataset to add to the Zone | Conditional |
<name> | Specifies path for the ZFS dataset | Conditional |
<inherit-packages> | Contains file systems that are loopback mounted from the Global Zone | No |
<inherit-pkg> | Adds a shared file system that is loopback mounted from the Global Zone | Conditional |
<dir> | Specifies the directory on the Global Zone to mount in the read-only mode | Conditional |
<ip-type> | Sets the Internet protocol type for the Zone to Exclusive-IP | No |
<network-interfaces> | Contains network interfaces | No |
<network-interface> | Specifies a network interface to add to the Zone | Conditional |
<address> | Sets the IP address for the network interface | Conditional |
<physical> | Sets the physical device type for the network interface | Conditional |
<default-router> | Sets the default router for the network interface | No |
<devices> | Contains network devices | No |
<device> | Specifies a device to add to the Zone | Conditional |
<match> | Sets the device match | Conditional |
<max-sem-ids> | Sets the maximum number of semaphore IDs for the Zone | No |
<attributes> | Contains properties for the Zone | No |
<attribute> | Specifies an attribute to add for the Zone | Conditional |
<name> | Specifies the name for the attribute | Conditional |
<type> | Specifies the type of the attribute | Conditional |
<value> | Contains the value for the attribute | Conditional |
<user-name> | Specifies the user name for the Solaris computer | No |
<password> | Specifies the password corresponding to the user name | Conditional |
The following figure shows a sample adapter request for the Create Zone With Custom Settings operation with the optional elements:
The following figure shows the response for the sample Create Zone With Custom Settings operation: