cloudstack-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ke4...@apache.org
Subject [42/51] [partial] Adding documents from 4.2
Date Wed, 02 Oct 2013 14:23:43 GMT
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/change-to-behavior-of-list-commands.xml
----------------------------------------------------------------------
diff --git a/en-US/change-to-behavior-of-list-commands.xml b/en-US/change-to-behavior-of-list-commands.xml
new file mode 100644
index 0000000..69b9e4d
--- /dev/null
+++ b/en-US/change-to-behavior-of-list-commands.xml
@@ -0,0 +1,108 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+  or more contributor license agreements.  See the NOTICE file
+  distributed with this work for additional information
+  regarding copyright ownership.  The ASF licenses this file
+  to you under the Apache License, Version 2.0 (the
+  "License"); you may not use this file except in compliance
+  with the License.  You may obtain a copy of the License at
+  http://www.apache.org/licenses/LICENSE-2.0
+  Unless required by applicable law or agreed to in writing,
+  software distributed under the License is distributed on an
+  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+  KIND, either express or implied.  See the License for the
+  specific language governing permissions and limitations
+  under the License.
+-->
+<section id="change-to-behavior-of-list-commands">
+  <title>Change to Behavior of List Commands</title>
+  <para>There was a major change in how our List* API commands work in CloudStack 3.0 compared to
+    2.2.x. The rules below apply only for managed resources – those that belong to an account,
+    domain, or project. They are irrelevant for the List* commands displaying unmanaged (system)
+    resources, such as hosts, clusters, and external network resources.</para>
+  <para>When no parameters are passed in to the call, the caller sees only resources owned by the
+    caller (even when the caller is the administrator). Previously, the administrator saw everyone
+    else's resources by default.</para>
+  <para>When accountName and domainId are passed in:</para>
+  <itemizedlist>
+    <listitem>
+      <para>The caller sees the resources dedicated to the account specified.</para>
+    </listitem>
+    <listitem>
+      <para>If the call is executed by a regular user, the user is authorized to specify only the
+        user's own account and domainId.</para>
+    </listitem>
+    <listitem>
+      <para>If the caller is a domain administrator, CloudStack performs an authorization check to
+        see whether the caller is permitted to view resources for the given account and
+        domainId.</para>
+    </listitem>
+  </itemizedlist>
+  <para>When projectId is passed in, only resources belonging to that project are listed.</para>
+  <para>When domainId is passed in, the call returns only resources belonging to the domain
+    specified. To see the resources of subdomains, use the parameter isRecursive=true. Again, the
+    regular user can see only resources owned by that user, the root administrator can list
+    anything, and a domain administrator is authorized to see only resources of the administrator's
+    own domain and subdomains.</para>
+  <para>To see all resources the caller is authorized to see, except for Project resources, use the
+    parameter listAll=true.</para>
+  <para>To see all Project resources the caller is authorized to see, use the parameter
+    projectId=-1.</para>
+  <para>There is one API command that doesn't fall under the rules above completely: the
+    listTemplates command. This command has its own flags defining the list rules:</para>
+  <informaltable frame="all">
+    <tgroup cols="2" align="left" colsep="1" rowsep="1">
+      <colspec colname="c1"/>
+      <colspec colname="c2"/>
+      <thead>
+        <row>
+          <entry><para>listTemplates Flag</para></entry>
+          <entry><para>Description</para></entry>
+        </row>
+      </thead>
+      <tbody>
+        <row>
+          <entry><para>featured</para></entry>
+          <entry><para>Returns templates that have been marked as featured and
+            public.</para></entry>
+        </row>
+        <row>
+          <entry><para>self</para></entry>
+          <entry><para>Returns templates that have been registered or created by the calling
+              user.</para></entry>
+        </row>
+        <row>
+          <entry><para>selfexecutable</para></entry>
+          <entry><para>Same as self, but only returns templates that are ready to be deployed
+              with.</para></entry>
+        </row>
+        <row>
+          <entry><para>sharedexecutable</para></entry>
+          <entry><para>Ready templates that have been granted to the calling user by another
+              user.</para></entry>
+        </row>
+        <row>
+          <entry><para>executable</para></entry>
+          <entry><para>Templates that are owned by the calling user, or public templates, that can
+              be used to deploy a new VM.</para></entry>
+        </row>
+        <row>
+          <entry><para>community</para></entry>
+          <entry><para>Returns templates that have been marked as public but not
+            featured.</para></entry>
+        </row>
+        <row>
+          <entry><para>all</para></entry>
+          <entry><para>Returns all templates (only usable by admins).</para></entry>
+        </row>
+      </tbody>
+    </tgroup>
+  </informaltable>
+  <para>The &PRODUCT; UI on a general view will display all resources that the logged-in user is
+    authorized to see, except for project resources. To see the project resources, select the
+    project view.</para>
+</section>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/changed-API-commands-4.2.xml
----------------------------------------------------------------------
diff --git a/en-US/changed-API-commands-4.2.xml b/en-US/changed-API-commands-4.2.xml
new file mode 100644
index 0000000..8fda9cc
--- /dev/null
+++ b/en-US/changed-API-commands-4.2.xml
@@ -0,0 +1,1129 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+  or more contributor license agreements.  See the NOTICE file
+  distributed with this work for additional information
+  regarding copyright ownership.  The ASF licenses this file
+  to you under the Apache License, Version 2.0 (the
+  "License"); you may not use this file except in compliance
+  with the License.  You may obtain a copy of the License at
+  http://www.apache.org/licenses/LICENSE-2.0
+  Unless required by applicable law or agreed to in writing,
+  software distributed under the License is distributed on an
+  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+  KIND, either express or implied.  See the License for the
+  specific language governing permissions and limitations
+  under the License.
+-->
+<section id="changed-api-commands-4.2">
+  <title>Changed API Commands in 4.2</title>
+  <informaltable>
+    <tgroup cols="2" align="left" colsep="1" rowsep="1">
+      <colspec colwidth="1.0*" colname="1" colnum="1"/>
+      <colspec colwidth="4.26*" colname="2" colnum="2"/>
+      <thead>
+        <row>
+          <entry><para>API Commands</para></entry>
+          <entry><para>Description</para></entry>
+        </row>
+      </thead>
+      <tbody>
+        <row>
+          <entry><para>listNetworkACLs</para></entry>
+          <entry><para>The following new request parameters are added: aclid (optional), action
+              (optional), protocol (optional)</para>
+            <para>The following new response parameters are added: aclid, action,
+            number</para></entry>
+        </row>
+        <row>
+          <entry><para>copyTemplate</para></entry>
+          <entry>
+            <para>The following new response parameters are added: isdynamicallyscalable,
+              sshkeyenabled </para></entry>
+        </row>
+        <row>
+          <entry><para>listRouters</para></entry>
+          <entry>
+            <para>The following new response parameters are added: ip6dns1, ip6dns2,
+            role</para></entry>
+        </row>
+        <row>
+          <entry><para>updateConfiguration</para></entry>
+          <entry><para>The following new request parameters are added: accountid (optional),
+              clusterid (optional), storageid (optional), zoneid (optional)</para>
+            <para>The following new response parameters are added: id, scope </para></entry>
+        </row>
+        <row>
+          <entry><para>listVolumes</para></entry>
+          <entry><para>The following request parameter is removed: details </para>
+            <para>The following new response parameter is added: displayvolume </para></entry>
+        </row>
+        <row>
+          <entry><para>suspendProject</para></entry>
+          <entry>
+            <para>The following new response parameters are added: cpuavailable, cpulimit, cputotal,
+              ipavailable, iplimit, iptotal, memoryavailable, memorylimit, memorytotal,
+              networkavailable, networklimit, networktotal, primarystorageavailable,
+              primarystoragelimit, primarystoragetotal, secondarystorageavailable,
+              secondarystoragelimit, secondarystoragetotal, snapshotavailable, snapshotlimit,
+              snapshottotal, templateavailable, templatelimit, templatetotal, vmavailable, vmlimit,
+              vmrunning, vmstopped, vmtotal, volumeavailable, volumelimit, volumetotal,
+              vpcavailable, vpclimit, vpctotal </para></entry>
+        </row>
+        <row>
+          <entry><para>listRemoteAccessVpns</para></entry>
+          <entry>
+            <para>The following new response parameters are added: id</para></entry>
+        </row>
+        <row>
+          <entry><para>registerTemplate</para></entry>
+          <entry><para>The following new request parameters are added: imagestoreuuid (optional),
+              isdynamicallyscalable (optional), isrouting (optional) </para>
+            <para>The following new response parameters are added: isdynamicallyscalable,
+              sshkeyenabled </para></entry>
+        </row>
+        <row>
+          <entry><para>addTrafficMonitor</para></entry>
+          <entry>
+            <para>The following response parameters are removed: privateinterface, privatezone,
+              publicinterface, publiczone, usageinterface, username </para></entry>
+        </row>
+        <row>
+          <entry><para>createTemplate</para></entry>
+          <entry><para>The following response parameters are removed: clusterid, clustername,
+              disksizeallocated, disksizetotal, disksizeused, ipaddress, path, podid, podname,
+              state, tags, type </para>
+            <para>The following new response parameters are added: account, accountid, bootable,
+              checksum, crossZones, details, displaytext, domain, domainid, format, hostid,
+              hostname, hypervisor, isdynamicallyscalable, isextractable, isfeatured, ispublic,
+              isready, ostypeid, ostypename, passwordenabled, project, projectid, removed, size,
+              sourcetemplateid, sshkeyenabled, status, templatetag, templatetype,
+            tags</para></entry>
+        </row>
+        <row>
+          <entry><para>listLoadBalancerRuleInstances</para></entry>
+          <entry>
+            <para>The following new response parameters are added: diskioread, diskiowrite,
+              diskkbsread, diskkbswrite, displayvm, isdynamicallyscalable,
+            affinitygroup</para></entry>
+        </row>
+        <row>
+          <entry><para>migrateVolume</para></entry>
+          <entry><para>The following new request parameters is added: livemigrate (optional) </para>
+            <para>The following new response parameters is added: displayvolume </para></entry>
+        </row>
+        <row>
+          <entry><para>createAccount</para></entry>
+          <entry><para>The following new request parameters are added: accountid (optional), userid
+              (optional)</para>
+            <para>The following new response parameters are added: accountdetails, cpuavailable,
+              cpulimit, cputotal, defaultzoneid, ipavailable, iplimit, iptotal, iscleanuprequired,
+              isdefault, memoryavailable, memorylimit, memorytotal, name, networkavailable,
+              networkdomain, networklimit, networktotal, primarystorageavailable,
+              primarystoragelimit, primarystoragetotal, projectavailable, projectlimit,
+              projecttotal, receivedbytes, secondarystorageavailable, secondarystoragelimit,
+              secondarystoragetotal, sentbytes, snapshotavailable, snapshotlimit, snapshottotal,
+              templateavailable, templatelimit, templatetotal, vmavailable, vmlimit, vmrunning,
+              vmstopped, vmtotal, volumeavailable, volumelimit, volumetotal, vpcavailable, vpclimit,
+              vpctotal, user</para>
+            <para>The following parameters are removed: account, accountid, apikey, created, email,
+              firstname, lastname, secretkey, timezone, username </para></entry>
+        </row>
+        <row>
+          <entry><para>updatePhysicalNetwork</para></entry>
+          <entry><para>The following new request parameters is added: removevlan (optional)
+            </para></entry>
+        </row>
+        <row>
+          <entry><para>listTrafficMonitors</para></entry>
+          <entry>
+            <para>The following response parameters are removed: privateinterface, privatezone,
+              publicinterface, publiczone, usageinterface, username </para></entry>
+        </row>
+        <row>
+          <entry><para>attachIso</para></entry>
+          <entry>
+            <para>The following new response parameters are added: diskioread, diskiowrite,
+              diskkbsread, diskkbswrite, displayvm, isdynamicallyscalable,
+            affinitygroup</para></entry>
+        </row>
+        <row>
+          <entry><para>listProjects</para></entry>
+          <entry><para>The following new request parameters are added: cpuavailable, cpulimit,
+              cputotal, ipavailable, iplimit, iptotal, memoryavailable, memorylimit, memorytotal,
+              networkavailable, networklimit, networktotal, primarystorageavailable,
+              primarystoragelimit, primarystoragetotal, secondarystorageavailable,
+              secondarystoragelimit, secondarystoragetotal, snapshotavailable, snapshotlimit,
+              snapshottotal, templateavailable, templatelimit, templatetotal, vmavailable, vmlimit,
+              vmrunning, vmstopped, vmtotal, volumeavailable, volumelimit, volumetotal,
+              vpcavailable, vpclimit, vpctotal </para></entry>
+        </row>
+        <row>
+          <entry><para>enableAccount</para></entry>
+          <entry>
+            <para>The following new response parameters are added: cpuavailable, cpulimit, cputotal,
+              isdefault, memoryavailable, memorylimit, memorytotal, primarystorageavailable,
+              primarystoragelimit, primarystoragetotal, secondarystorageavailable,
+              secondarystoragelimit, secondarystoragetotal </para></entry>
+        </row>
+        <row>
+          <entry><para>listPublicIpAddresses</para></entry>
+          <entry>
+            <para>The following new response parameters are added: isportable, vmipaddress
+            </para></entry>
+        </row>
+        <row>
+          <entry><para>enableStorageMaintenance</para></entry>
+          <entry>
+            <para>The following new response parameters are added: hypervisor, scope,
+              suitableformigration </para></entry>
+        </row>
+        <row>
+          <entry><para>listLoadBalancerRules</para></entry>
+          <entry><para>The following new request parameters is added: networkid (optional) </para>
+            <para>The following new response parameters is added: networkid</para></entry>
+        </row>
+        <row>
+          <entry><para>stopRouter</para></entry>
+          <entry>
+            <para>The following new response parameters are added: ip6dns1, ip6dns2, role
+            </para></entry>
+        </row>
+        <row>
+          <entry><para>listClusters</para></entry>
+          <entry>
+            <para>The following new response parameters are added: cpuovercommitratio,
+              memoryovercommitratio </para></entry>
+        </row>
+        <row>
+          <entry><para>attachVolume</para></entry>
+          <entry>
+            <para>The following new response parameter is added: displayvolume</para></entry>
+        </row>
+        <row>
+          <entry><para>updateVPCOffering</para></entry>
+          <entry><para>The following request parameters is made mandatory: id</para></entry>
+        </row>
+        <row>
+          <entry><para>resetSSHKeyForVirtualMachine</para></entry>
+          <entry><para>The following new request parameter is added: keypair (required)</para>
+            <para>The following parameter is removed: name</para>
+            <para>The following new response parameters are added: diskioread, diskiowrite,
+              diskkbsread, diskkbswrite, displayvm, isdynamicallyscalable,
+            affinitygroup</para></entry>
+        </row>
+        <row>
+          <entry><para>updateCluster</para></entry>
+          <entry><para>The following new request parameters are removed: cpuovercommitratio,
+              memoryovercommitratio</para>
+            <para>The following new response parameters are removed: cpuovercommitratio,
+              memoryovercommitratio </para></entry>
+        </row>
+        <row>
+          <entry><para>listPrivateGateways</para></entry>
+          <entry><para>The following new response parameters are added: aclid, sourcenatsupported
+            </para></entry>
+        </row>
+        <row>
+          <entry><para>ldapConfig</para></entry>
+          <entry><para>The following new request parameters are added: listall (optional) </para>
+            <para>The following parameters has been made optional: searchbase, hostname,
+              queryfilter</para>
+            <para>The following new response parameter is added: ssl</para></entry>
+        </row>
+        <row>
+          <entry><para>listTemplates</para></entry>
+          <entry>
+            <para>The following new response parameters are added: isdynamicallyscalable,
+              sshkeyenabled </para></entry>
+        </row>
+        <row>
+          <entry><para>listNetworks</para></entry>
+          <entry>
+            <para>The following new response parameters are added: aclid, displaynetwork, ip6cidr,
+              ip6gateway, ispersistent, networkcidr, reservediprange </para></entry>
+        </row>
+        <row>
+          <entry><para>restartNetwork</para></entry>
+          <entry>
+            <para>The following new response parameters are added: isportable, vmipaddress
+            </para></entry>
+        </row>
+        <row>
+          <entry><para>prepareTemplate</para></entry>
+          <entry>
+            <para>The following new response parameters are added: isdynamicallyscalable,
+              sshkeyenabled </para></entry>
+        </row>
+        <row>
+          <entry><para>rebootVirtualMachine</para></entry>
+          <entry>
+            <para>The following new response parameters are added: diskioread, diskiowrite,
+              diskkbsread, diskkbswrite, displayvm, isdynamicallyscalable,
+            affinitygroup</para></entry>
+        </row>
+        <row>
+          <entry><para>changeServiceForRouter</para></entry>
+          <entry><para>The following new request parameters are added: aclid (optional), action
+              (optional), protocol (optional)</para>
+            <para>The following new response parameters are added: id, scope</para></entry>
+        </row>
+        <row>
+          <entry><para>updateZone</para></entry>
+          <entry><para>The following new request parameters are added: ip6dns1 (optional), ip6dns2
+              (optional) </para>
+            <para>The following new response parameters are added: ip6dns1, ip6dns2 </para></entry>
+        </row>
+        <row>
+          <entry><para>ldapRemove</para></entry>
+          <entry>
+            <para>The following new response parameters are added: ssl</para></entry>
+        </row>
+        <row>
+          <entry><para>updateServiceOffering</para></entry>
+          <entry>
+            <para>The following new response parameters are added: deploymentplanner, isvolatile
+            </para></entry>
+        </row>
+        <row>
+          <entry><para>updateStoragePool</para></entry>
+          <entry>
+            <para>The following new response parameters are added: hypervisor, scope,
+              suitableformigration</para></entry>
+        </row>
+        <row>
+          <entry><para>listFirewallRules</para></entry>
+          <entry><para>The following request parameter is removed: traffictype</para>
+            <para>The following new response parameters are added: networkid</para></entry>
+        </row>
+        <row>
+          <entry><para>updateUser</para></entry>
+          <entry>
+            <para>The following new response parameters are added: iscallerchilddomain, isdefault
+            </para></entry>
+        </row>
+        <row>
+          <entry><para>updateProject</para></entry>
+          <entry>
+            <para>The following new response parameters are added: cpuavailable, cpulimit, cputotal,
+              ipavailable, iplimit, iptotal, memoryavailable, memorylimit, memorytotal,
+              networkavailable, networklimit, networktotal, primarystorageavailable,
+              primarystoragelimit, primarystoragetotal, secondarystorageavailable,
+              secondarystoragelimit, secondarystoragetotal, snapshotavailable, snapshotlimit,
+              snapshottotal, templateavailable, templatelimit, templatetotal, vmavailable, vmlimit,
+              vmrunning, vmstopped, vmtotal, volumeavailable, volumelimit, volumetotal,
+              vpcavailable, vpclimit, vpctotal </para></entry>
+        </row>
+        <row>
+          <entry><para>updateTemplate</para></entry>
+          <entry><para>The following new request parameters are added: isdynamicallyscalable
+              (optional), isrouting (optional) </para>
+            <para>The following new response parameters are added: isdynamicallyscalable,
+              sshkeyenabled </para></entry>
+        </row>
+        <row>
+          <entry><para>disableUser</para></entry>
+          <entry>
+            <para>The following new response parameters are added: iscallerchilddomain, isdefault
+            </para></entry>
+        </row>
+        <row>
+          <entry><para>activateProject</para></entry>
+          <entry>
+            <para>The following new response parameters are added: cpuavailable, cpulimit, cputotal,
+              ipavailable, iplimit, iptotal, memoryavailable, memorylimit, memorytotal,
+              networkavailable, networklimit, networktotal, primarystorageavailable,
+              primarystoragelimit, primarystoragetotal, secondarystorageavailable,
+              secondarystoragelimit, secondarystoragetotal, snapshotavailable, snapshotlimit,
+              snapshottotal, templateavailable, templatelimit, templatetotal, vmavailable, vmlimit,
+              vmrunning, vmstopped, vmtotal, volumeavailable, volumelimit, volumetotal,
+              vpcavailable, vpclimit, vpctotal </para></entry>
+        </row>
+        <row>
+          <entry><para>createNetworkACL</para></entry>
+          <entry><para>The following new request parameters are added: aclid (optional), action
+              (optional), number (optional) </para>
+            <para>The following request parameter is now optional: networkid</para>
+            <para>The following new response parameters are added: aclid, action, number
+            </para></entry>
+        </row>
+        <row>
+          <entry><para>enableStaticNat</para></entry>
+          <entry><para>The following new request parameters are added: vmguestip (optional)
+            </para></entry>
+        </row>
+        <row>
+          <entry><para>registerIso</para></entry>
+          <entry><para>The following new request parameters are added: imagestoreuuid (optional),
+              isdynamicallyscalable (optional)</para>
+            <para>The following new response parameters are added: isdynamicallyscalable,
+              sshkeyenabled </para></entry>
+        </row>
+        <row>
+          <entry><para>createIpForwardingRule</para></entry>
+          <entry>
+            <para>The following new response parameter is added: vmguestip </para></entry>
+        </row>
+        <row>
+          <entry><para>resetPasswordForVirtualMachine</para></entry>
+          <entry>
+            <para>The following new response parameters are added: diskioread, diskiowrite,
+              diskkbsread, diskkbswrite, displayvm, isdynamicallyscalable,
+            affinitygroup</para></entry>
+        </row>
+        <row>
+          <entry><para>createVolume</para></entry>
+          <entry><para>The following new request parameter is added: displayvolume (optional)</para>
+            <para>The following new response parameter is added: displayvolume</para></entry>
+        </row>
+        <row>
+          <entry><para>startRouter</para></entry>
+          <entry>
+            <para>The following new response parameters are added: ip6dns1, ip6dns2, role
+            </para></entry>
+        </row>
+        <row>
+          <entry><para>listCapabilities</para></entry>
+          <entry><para>The following new response parameters are added: apilimitinterval and
+              apilimitmax.</para></entry>
+        </row>
+        <row>
+          <entry><para>createServiceOffering</para></entry>
+          <entry><para>The following new request parameters are added: deploymentplanner (optional),
+              isvolatile (optional), serviceofferingdetails (optional). </para>
+            <para>isvolatie indicates whether the service offering includes Volatile VM capability,
+              which will discard the VM's root disk and create a new one on reboot.</para>
+            <para>The following new response parameters are added: deploymentplanner, isvolatile
+            </para></entry>
+        </row>
+        <row>
+          <entry><para>restoreVirtualMachine</para></entry>
+          <entry><para>The following request parameter is added: templateID (optional). This is used to point to the
+              new template ID when the base image is updated. The parameter templateID can be an ISO
+              ID in case of restore vm deployed using ISO.</para>
+            <para>The following response parameters are added: diskioread, diskiowrite, diskkbsread,
+              diskkbswrite, displayvm, isdynamicallyscalable, affinitygroup</para></entry>
+        </row>
+        <row>
+          <entry><para>createNetwork</para></entry>
+          <entry><para>The following new request parameters are added: aclid (optional),
+              displaynetwork (optional), endipv6 (optional), ip6cidr (optional), ip6gateway
+              (optional), isolatedpvlan (optional), startipv6 (optional)</para>
+            <para>The following new response parameters are added: aclid, displaynetwork, ip6cidr,
+              ip6gateway, ispersistent, networkcidr, reservediprange </para></entry>
+        </row>
+        <row>
+          <entry><para>createVlanIpRange</para></entry>
+          <entry><para>The following new request parameters are added: startipv6, endipv6,
+              ip6gateway, ip6cidr</para>
+            <para>Changed parameters: startip (is now optional)</para>
+            <para>The following new response parameters are added: startipv6, endipv6, ip6gateway,
+              ip6cidr</para></entry>
+        </row>
+        <row>
+          <entry><para>CreateZone</para></entry>
+          <entry><para>The following new request parameters are added: ip6dns1, ip6dns2</para>
+            <para>The following new response parameters are added: ip6dns1, ip6dns2 </para></entry>
+        </row>
+        <row>
+          <entry><para>deployVirtualMachine</para></entry>
+          <entry><para>The following request parameters are added: affinitygroupids (optional),
+              affinitygroupnames (optional), displayvm (optional), ip6address (optional) </para>
+            <para>The following request parameter is modified: iptonetworklist has a new possible
+              value, ipv6</para>
+            <para>The following new response parameters are added: diskioread, diskiowrite,
+              diskkbsread, diskkbswrite, displayvm, isdynamicallyscalable,
+            affinitygroup</para></entry>
+        </row>
+        <row>
+          <entry>
+            <para>createNetworkOffering</para>
+          </entry>
+          <entry>
+            <para>The following request parameters are added: details (optional),
+              egressdefaultpolicy (optional), ispersistent (optional) </para>
+            <para>ispersistent determines if the network or network offering created or listed by
+              using this offering are persistent or not.</para>
+            <para>The following response parameters are added: details, egressdefaultpolicy,
+              ispersistent </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listNetworks</para>
+          </entry>
+          <entry>
+            <para>The following request parameters is added: isPersistent.</para>
+            <para>This parameter determines if the network or network offering created or listed by
+              using this offering are persistent or not.</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listNetworkOfferings</para>
+          </entry>
+          <entry>
+            <para>The following request parameters is added: isPersistent.</para>
+            <para>This parameter determines if the network or network offering created or listed by
+              using this offering are persistent or not.</para>
+            <para>For listNetworkOfferings, the following response parameter has been added:
+              details, egressdefaultpolicy, ispersistent </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>addF5LoadBalancer</para>
+            <para>configureNetscalerLoadBalancer</para>
+            <para>addNetscalerLoadBalancer</para>
+            <para>listF5LoadBalancers</para>
+            <para>configureF5LoadBalancer</para>
+            <para>listNetscalerLoadBalancers</para>
+          </entry>
+          <entry>
+            <para>The following response parameter is removed: inline.</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listRouters</para>
+          </entry>
+          <entry>
+            <para>For nic responses, the following fields have been added.</para>
+            <itemizedlist>
+              <listitem>
+                <para>ip6address</para>
+              </listitem>
+              <listitem>
+                <para>ip6gateway</para>
+              </listitem>
+              <listitem>
+                <para>ip6cidr</para>
+              </listitem>
+            </itemizedlist>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listVirtualMachines</para>
+          </entry>
+          <entry>
+            <para>The following request parameters are added: affinitygroupid (optional), vpcid
+              (optional) </para>
+            <para>The following response parameters are added: diskioread, diskiowrite, diskkbsread,
+              diskkbswrite, displayvm, isdynamicallyscalable, affinitygroup</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listRouters</para>
+            <para>listZones</para>
+          </entry>
+          <entry>
+            <para>For DomainRouter and DataCenter response, the following fields have been
+              added.</para>
+            <itemizedlist>
+              <listitem>
+                <para>ip6dns1</para>
+              </listitem>
+              <listitem>
+                <para>ip6dns2</para>
+              </listitem>
+            </itemizedlist>
+            <para>For listZones, the following optional request parameters are added: name,
+              networktype</para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>listFirewallRules</para>
+            <para>createFirewallRule</para></entry>
+          <entry>
+            <para>The following request parameter is added: traffictype (optional).</para>
+            <para>The following response parameter is added: networkid </para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>listUsageRecords</para></entry>
+          <entry><para>The following response parameter is added: virtualsize.</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>deleteIso</para>
+          </entry>
+          <entry>
+            <para>The following request parameter is removed: forced</para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>addCluster</para></entry>
+          <entry><para>The following request parameters are added: guestvswitchtype (optional), guestvswitchtype
+              (optional), publicvswitchtype (optional), publicvswitchtype (optional)</para>
+            <para>The following request parameters are removed: cpuovercommitratio,
+              memoryovercommitratio </para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>updateCluster</para></entry>
+          <entry><para>The following request parameters are added: cpuovercommitratio,
+              ramovercommitratio</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>createStoragePool</para>
+          </entry>
+          <entry>
+            <para>The following request parameters are added: hypervisor (optional), provider
+              (optional), scope (optional) </para>
+            <para>The following request parameters have been made mandatory: podid, clusterid</para>
+            <para>The following response parameter has been added: hypervisor, scope,
+              suitableformigration </para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>listStoragePools</para></entry>
+          <entry><para>The following request parameter is added: scope (optional)</para>
+            <para>The following response parameters are added: hypervisor, scope,
+              suitableformigration </para></entry>
+        </row>
+        <row>
+          <entry>
+            <para>updateDiskOffering</para>
+          </entry>
+          <entry>
+            <para>The following response parameter is added: displayoffering </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>changeServiceForVirtualMachine</para>
+          </entry>
+          <entry>
+            <para>The following response parameter are added: diskioread, diskiowrite, diskkbsread,
+              diskkbswrite, displayvm, isdynamicallyscalable, affinitygroup</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>recoverVirtualMachine</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: diskioread, diskiowrite, diskkbsread,
+              diskkbswrite, displayvm, isdynamicallyscalable, affinitygroup</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listCapabilities</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: apilimitinterval, apilimitmax </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>createRemoteAccessVpn</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: id</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>startVirtualMachine</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: diskioread, diskiowrite, diskkbsread,
+              diskkbswrite, displayvm, isdynamicallyscalable, affinitygroup</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>detachIso</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: diskioread, diskiowrite, diskkbsread,
+              diskkbswrite, displayvm, isdynamicallyscalable, affinitygroup </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>updateVPC</para>
+          </entry>
+          <entry>
+            <para>The following request parameters has been made mandatory: id, name</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>associateIpAddress</para>
+          </entry>
+          <entry>
+            <para>The following request parameters are added: isportable (optional), regionid
+              (optional) </para>
+            <para>The following response parameters are added: isportable, vmipaddress </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listProjectAccounts</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: cpuavailable, cpulimit, cputotal,
+              ipavailable, iplimit, iptotal, memoryavailable, memorylimit, memorytotal,
+              networkavailable, networklimit, networktotal, primarystorageavailable,
+              primarystoragelimit, primarystoragetotal, secondarystorageavailable,
+              secondarystoragelimit, secondarystoragetotal, snapshotavailable, snapshotlimit,
+              snapshottotal, templateavailable, templatelimit, templatetotal, vmavailable, vmlimit,
+              vmrunning, vmstopped, vmtotal, volumeavailable, volumelimit, volumetotal,
+              vpcavailable, vpclimit, vpctotal </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>disableAccount</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: cpuavailable, cpulimit, cputotal,
+              isdefault, memoryavailable, memorylimit, memorytotal, primarystorageavailable,
+              primarystoragelimit, primarystoragetotal, secondarystorageavailable,
+              secondarystoragelimit, secondarystoragetotal </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listPortForwardingRules</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: vmguestip</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>migrateVirtualMachine</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: diskioread, diskiowrite, diskkbsread,
+              diskkbswrite, displayvm, isdynamicallyscalable, affinitygroup</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>cancelStorageMaintenance</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: hypervisor, scope,
+              suitableformigration </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>createPortForwardingRule</para>
+          </entry>
+          <entry><para>The following request parameter is added: vmguestip (optional) </para>The
+            following response parameter is added: vmguestip</entry>
+        </row>
+        <row>
+          <entry>
+            <para>addVpnUser</para>
+          </entry>
+          <entry>
+            <para>The following response parameter is added: state</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>createVPCOffering</para>
+          </entry>
+          <entry>
+            <para>The following request parameter is added: serviceproviderlist (optional) </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>assignVirtualMachine</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: diskioread, diskiowrite, diskkbsread,
+              diskkbswrite, displayvm, isdynamicallyscalable, affinitygroup</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listConditions</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: account, counter, domain, domainid,
+              project, projectid, relationaloperator, threshold</para>
+            <para>Removed response parameters: name, source, value </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>createPrivateGateway</para>
+          </entry>
+          <entry>
+            <para>The following request parameters are added: aclid (optional), sourcenatsupported
+              (optional) </para>
+            <para>The following response parameters are added: aclid, sourcenatsupported </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>updateVirtualMachine</para>
+          </entry>
+          <entry>
+            <para>The following request parameters are added: displayvm (optional),
+              isdynamicallyscalable (optional) </para>
+            <para>The following response parameters are added: diskioread, diskiowrite, diskkbsread,
+              diskkbswrite, displayvm, isdynamicallyscalable, affinitygroup</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>destroyRouter</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: ip6dns1, ip6dns2, role </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listServiceOfferings</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: deploymentplanner, isvolatile </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listUsageRecords</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are removed: virtualsize </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>createProject</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: cpuavailable, cpulimit, cputotal,
+              ipavailable, iplimit, iptotal, memoryavailable, memorylimit, memorytotal,
+              networkavailable, networklimit, networktotal, primarystorageavailable,
+              primarystoragelimit, primarystoragetotal, secondarystorageavailable,
+              secondarystoragelimit, secondarystoragetotal, snapshotavailable, snapshotlimit,
+              snapshottotal, templateavailable, templatelimit, templatetotal, vmavailable, vmlimit,
+              vmrunning, vmstopped, vmtotal, volumeavailable, volumelimit, volumetotal,
+              vpcavailable, vpclimit, vpctotal </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>enableUser</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: iscallerchilddomain, isdefault
+            </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>createLoadBalancerRule</para>
+          </entry>
+          <entry>
+            <para>The following response parameter is added: networkid </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>updateAccount</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: cpuavailable, cpulimit, cputotal,
+              isdefault, memoryavailable, memorylimit, memorytotal, primarystorageavailable,
+              primarystoragelimit, primarystoragetotal, secondarystorageavailable,
+              secondarystoragelimit, secondarystoragetotal </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>copyIso</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: isdynamicallyscalable, sshkeyenabled
+            </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>uploadVolume</para>
+          </entry>
+          <entry>
+            <para>The following request parameters are added: imagestoreuuid (optional), projectid
+              (optional</para>
+            <para>The following response parameters are added: displayvolume </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>createDomain</para>
+          </entry>
+          <entry>
+            <para>The following request parameter is added: domainid (optional) </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>stopVirtualMachine</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: diskioread, diskiowrite, diskkbsread,
+              diskkbswrite, displayvm, isdynamicallyscalable, affinitygroup</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listAccounts</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: cpuavailable, cpulimit, cputotal,
+              isdefault, memoryavailable, memorylimit, memorytotal, primarystorageavailable,
+              primarystoragelimit, primarystoragetotal, secondarystorageavailable,
+              secondarystoragelimit, secondarystoragetotal </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>createSnapshot</para>
+          </entry>
+          <entry>
+            <para>The following response parameter is added: zoneid </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>updateIso</para>
+          </entry>
+          <entry>
+            <para>The following request parameters are added: isdynamicallyscalable (optional),
+              isrouting (optional) </para>
+            <para>The following response parameters are added: isdynamicallyscalable,
+              sshkeyenabled</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listIpForwardingRules</para>
+          </entry>
+          <entry>
+            <para>The following response parameter is added: vmguestip </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>updateNetwork</para>
+          </entry>
+          <entry>
+            <para>The following request parameters are added: displaynetwork (optional), guestvmcidr
+              (optional) </para>
+            <para>The following response parameters are added: aclid, displaynetwork, ip6cidr,
+              ip6gateway, ispersistent, networkcidr, reservediprange </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>destroyVirtualMachine</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: diskioread, diskiowrite, diskkbsread,
+              diskkbswrite, displayvm, isdynamicallyscalable, affinitygroup</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>createDiskOffering</para>
+          </entry>
+          <entry>
+            <para>The following request parameter is added: displayoffering (optional)</para>
+            <para>The following response parameter is added: displayoffering </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>rebootRouter</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: ip6dns1, ip6dns2, role </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listConfigurations</para>
+          </entry>
+          <entry>
+            <para>The following request parameters are added: accountid (optional), clusterid
+              (optional), storageid (optional), zoneid (optional) </para>
+            <para>The following response parameters are added: id, scope</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>createUser</para>
+          </entry>
+          <entry>
+            <para>The following request parameter is added: userid (optional)</para>
+            <para>The following response parameters are added: iscallerchilddomain, isdefault</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listDiskOfferings</para>
+          </entry>
+          <entry>
+            <para>The following response parameter is added: displayoffering</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>detachVolume</para>
+          </entry>
+          <entry>
+            <para>The following response parameter is added: displayvolume </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>deleteUser</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: displaytext, success</para>
+            <para>Removed parameters: id, account, accountid, accounttype, apikey, created, domain,
+              domainid, email, firstname, lastname, secretkey, state, timezone, username </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listSnapshots</para>
+          </entry>
+          <entry>
+            <para>The following request parameter is added: zoneid (optional) </para>
+            <para>The following response parameter is added: zoneid</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>markDefaultZoneForAccount</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: cpuavailable, cpulimit, cputotal,
+              isdefault, memoryavailable, memorylimit, memorytotal, primarystorageavailable,
+              primarystoragelimit, primarystoragetotal, secondarystorageavailable,
+              secondarystoragelimit, secondarystoragetotal </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>restartVPC</para>
+          </entry>
+          <entry>
+            <para>The following request parameters are made mandatory: id</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>updateHypervisorCapabilities</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: hypervisor, hypervisorversion,
+              maxdatavolumeslimit, maxguestslimit, maxhostspercluster, securitygroupenabled,
+              storagemotionenabled </para>
+            <para>Removed parameters: cpunumber, cpuspeed, created, defaultuse, displaytext, domain,
+              domainid, hosttags, issystem, limitcpuuse, memory, name, networkrate, offerha,
+              storagetype, systemvmtype, tags </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>updateLoadBalancerRule</para>
+          </entry>
+          <entry>
+            <para>The following response parameter is added: networkid </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listVlanIpRanges</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: endipv6, ip6cidr, ip6gateway,
+              startipv6 </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listHypervisorCapabilities</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: maxdatavolumeslimit,
+              maxhostspercluster, storagemotionenabled </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>updateNetworkOffering</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: details, egressdefaultpolicy,
+              ispersistent </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>createVirtualRouterElement</para>
+          </entry>
+          <entry>
+            <para>The following request parameters are added: providertype (optional)</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listVpnUsers</para>
+          </entry>
+          <entry>
+            <para>The following response parameter is added: state</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listUsers</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: iscallerchilddomain, isdefault
+            </para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listSupportedNetworkServices</para>
+          </entry>
+          <entry>
+            <para>The following response parameter is added: provider</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listIsos</para>
+          </entry>
+          <entry>
+            <para>The following response parameters are added: isdynamicallyscalable, sshkeyenabled
+            </para>
+          </entry>
+        </row>
+      </tbody>
+    </tgroup>
+  </informaltable>
+</section>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/changed-apicommands-4-0.xml
----------------------------------------------------------------------
diff --git a/en-US/changed-apicommands-4-0.xml b/en-US/changed-apicommands-4-0.xml
new file mode 100644
index 0000000..042d5e2
--- /dev/null
+++ b/en-US/changed-apicommands-4-0.xml
@@ -0,0 +1,268 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+  or more contributor license agreements.  See the NOTICE file
+  distributed with this work for additional information
+  regarding copyright ownership.  The ASF licenses this file
+  to you under the Apache License, Version 2.0 (the
+  "License"); you may not use this file except in compliance
+  with the License.  You may obtain a copy of the License at
+  http://www.apache.org/licenses/LICENSE-2.0
+  Unless required by applicable law or agreed to in writing,
+  software distributed under the License is distributed on an
+  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+  KIND, either express or implied.  See the License for the
+  specific language governing permissions and limitations
+  under the License.
+-->
+<section id="changed-apicommands-4.0">
+  <title>Changed API Commands in 4.0.0-incubating</title>
+  <informaltable>
+    <tgroup cols="2" align="left" colsep="1" rowsep="1">
+      <colspec colwidth="1" colname="1" colnum="1"/>
+      <colspec colwidth="2*" colname="2" colnum="2"/>
+      <thead>
+        <row>
+          <entry><para>API Commands</para></entry>
+          <entry><para>Description</para></entry>
+        </row>
+      </thead>
+      <tbody>
+        <row>
+          <entry>
+            <para>copyTemplate</para>
+            <para>prepareTemplate</para>
+            <para>registerTemplate</para>
+            <para>updateTemplate</para>
+            <para>createProject</para>
+            <para>activateProject</para>
+            <para>suspendProject</para>
+            <para>updateProject</para>
+            <para>listProjectAccounts</para>
+            <para>createVolume</para>
+            <para>migrateVolume</para>
+            <para>attachVolume</para>
+            <para>detachVolume</para>
+            <para>uploadVolume</para>
+            <para>createSecurityGroup</para>
+            <para>registerIso</para>
+            <para>copyIso</para>
+            <para>updateIso</para>
+            <para>createIpForwardingRule</para>
+            <para>listIpForwardingRules</para>
+            <para>createLoadBalancerRule</para>
+            <para>updateLoadBalancerRule</para>
+            <para>createSnapshot</para>
+          </entry>
+          <entry>
+            <para>The commands in this list have a single new response parameter, and no other
+              changes.</para>
+            <para>New response parameter: tags(*)</para>
+            <note>
+              <para>Many other commands also have the new tags(*) parameter in addition to other
+                changes; those commands are listed separately.</para>
+            </note></entry>
+        </row>
+        <row>
+          <entry>
+            <para>rebootVirtualMachine</para>
+            <para>attachIso</para>
+            <para>detachIso</para>
+            <para>listLoadBalancerRuleInstances</para>
+            <para>resetPasswordForVirtualMachine</para>
+            <para>changeServiceForVirtualMachine</para>
+            <para>recoverVirtualMachine</para>
+            <para>startVirtualMachine</para>
+            <para>migrateVirtualMachine</para>
+            <para>deployVirtualMachine</para>
+            <para>assignVirtualMachine</para>
+            <para>updateVirtualMachine</para>
+            <para>restoreVirtualMachine</para>
+            <para>stopVirtualMachine</para>
+            <para>destroyVirtualMachine</para>
+          </entry>
+          <entry>
+            <para>The commands in this list have two new response parameters, and no other
+              changes.</para>
+            <para>New response parameters: keypair, tags(*)</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listSecurityGroups</para>
+            <para>listFirewallRules</para>
+            <para>listPortForwardingRules</para>
+            <para>listSnapshots</para>
+            <para>listIsos</para>
+            <para>listProjects</para>
+            <para>listTemplates</para>
+            <para>listLoadBalancerRules</para>
+          </entry>
+          <entry><para>The commands in this list have the following new parameters, and no other
+              changes.</para>
+            <para>New request parameter: tags (optional)</para>
+            <para>New response parameter: tags(*)</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listF5LoadBalancerNetworks</para>
+            <para>listNetscalerLoadBalancerNetworks</para>
+            <para>listSrxFirewallNetworks</para>
+            <para>updateNetwork</para>
+          </entry>
+          <entry>
+            <para>The commands in this list have three new response parameters, and no other
+              changes.</para>
+            <para>New response parameters: canusefordeploy, vpcid, tags(*)</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>createZone</para>
+            <para>updateZone</para>
+          </entry>
+          <entry><para>The commands in this list have the following new parameters, and no other
+              changes.</para>
+            <para>New request parameter: localstorageenabled (optional)</para>
+            <para>New response parameter: localstorageenabled</para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>listZones</para></entry>
+          <entry><para>New response parameter: localstorageenabled</para></entry>
+        </row>
+        <row>
+          <entry>
+            <para>rebootRouter</para>
+            <para>changeServiceForRouter</para>
+            <para>startRouter</para>
+            <para>destroyRouter</para>
+            <para>stopRouter</para>
+          </entry>
+          <entry><para>The commands in this list have two new response parameters, and no other
+              changes.</para>
+            <para>New response parameters: vpcid, nic(*)</para></entry>
+        </row>
+        <row>
+          <entry>
+            <para>updateAccount</para>
+            <para>disableAccount</para>
+            <para>listAccounts</para>
+            <para>markDefaultZoneForAccount</para>
+            <para>enableAccount</para>
+          </entry>
+          <entry><para>The commands in this list have three new response parameters, and no other
+              changes.</para>
+            <para>New response parameters: vpcavailable, vpclimit, vpctotal</para></entry>
+        </row>
+        <row>
+          <entry><para>listRouters</para></entry>
+          <entry>
+            <para>New request parameters: forvpc (optional), vpcid (optional)</para>
+            <para>New response parameters: vpcid, nic(*)</para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>listNetworkOfferings</para></entry>
+          <entry>
+            <para>New request parameters: forvpc (optional)</para>
+            <para>New response parameters: forvpc </para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>listVolumes</para></entry>
+          <entry>
+            <para>New request parameters: details (optional), tags (optional)</para>
+            <para>New response parameters: tags(*)</para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>addTrafficMonitor</para></entry>
+          <entry>
+            <para>New request parameters: excludezones (optional), includezones (optional)</para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>createNetwork</para></entry>
+          <entry>
+            <para>New request parameters: vpcid (optional)</para>
+            <para>New response parameters: canusefordeploy, vpcid, tags(*)</para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>listPublicIpAddresses</para></entry>
+          <entry>
+            <para>New request parameters: tags (optional), vpcid (optional)</para>
+            <para>New response parameters: vpcid, tags(*)</para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>listNetworks</para></entry>
+          <entry>
+            <para>New request parameters: canusefordeploy (optional), forvpc (optional), tags
+              (optional), vpcid (optional)</para>
+            <para>New response parameters: canusefordeploy, vpcid, tags(*)</para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>restartNetwork</para></entry>
+          <entry>
+            <para>New response parameters: vpcid, tags(*)</para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>enableStaticNat</para></entry>
+          <entry>
+            <para>New request parameter: networkid (optional)</para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>createDiskOffering</para></entry>
+          <entry>
+            <para>New request parameter: storagetype (optional)</para>
+            <para>New response parameter: storagetype</para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>listDiskOfferings</para></entry>
+          <entry>
+            <para>New response parameter: storagetype</para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>updateDiskOffering</para></entry>
+          <entry>
+            <para>New response parameter: storagetype</para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>createFirewallRule</para></entry>
+          <entry>
+            <para>Changed request parameters: ipaddressid (old version - optional, new version -
+              required)</para>
+            <para>New response parameter: tags(*)</para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>listVirtualMachines</para></entry>
+          <entry>
+            <para>New request parameters: isoid (optional), tags (optional), templateid
+              (optional)</para>
+            <para>New response parameters: keypair, tags(*)</para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>updateStorageNetworkIpRange</para></entry>
+          <entry>
+            <para>New response parameters: id, endip, gateway, netmask, networkid, podid, startip,
+              vlan, zoneid</para>
+          </entry>
+        </row>
+      </tbody>
+    </tgroup>
+  </informaltable>
+</section>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/changed-apicommands-4.1.xml
----------------------------------------------------------------------
diff --git a/en-US/changed-apicommands-4.1.xml b/en-US/changed-apicommands-4.1.xml
new file mode 100644
index 0000000..1667aaf
--- /dev/null
+++ b/en-US/changed-apicommands-4.1.xml
@@ -0,0 +1,253 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+  or more contributor license agreements.  See the NOTICE file
+  distributed with this work for additional information
+  regarding copyright ownership.  The ASF licenses this file
+  to you under the Apache License, Version 2.0 (the
+  "License"); you may not use this file except in compliance
+  with the License.  You may obtain a copy of the License at
+  http://www.apache.org/licenses/LICENSE-2.0
+  Unless required by applicable law or agreed to in writing,
+  software distributed under the License is distributed on an
+  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+  KIND, either express or implied.  See the License for the
+  specific language governing permissions and limitations
+  under the License.
+-->
+<section id="changed-apicommands-4.1">
+  <title>Changed API Commands in 4.1</title>
+  <informaltable>
+    <tgroup cols="2" align="left" colsep="1" rowsep="1">
+      <colspec colwidth="1.0*" colname="1" colnum="1"/>
+      <colspec colwidth="4.37*" colname="2" colnum="2"/>
+      <thead>
+        <row>
+          <entry><para>API Commands</para></entry>
+          <entry><para>Description</para></entry>
+        </row>
+      </thead>
+      <tbody>
+        <row>
+          <entry>
+            <para>createNetworkOffering</para>
+          </entry>
+          <entry>
+            <para>The following request parameters have been added:</para>
+            <itemizedlist>
+              <listitem>
+                <para>isPersistent</para>
+              </listitem>
+              <listitem>
+                <para>startipv6</para>
+              </listitem>
+              <listitem>
+                <para>endipv6</para>
+              </listitem>
+              <listitem>
+                <para>ip6gateway</para>
+              </listitem>
+              <listitem>
+                <para>ip6cidr</para>
+              </listitem>
+            </itemizedlist>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listNetworkOfferings</para>
+            <para>listNetworks</para>
+          </entry>
+          <entry>
+            <para>The following request parameters have been added:</para>
+            <itemizedlist>
+              <listitem>
+                <para>isPersistent</para>
+                <para>This parameter determines if the network or network offering listed are
+                  persistent or not.</para>
+              </listitem>
+              <listitem>
+                <para>ip6gateway</para>
+              </listitem>
+              <listitem>
+                <para>ip6cidr</para>
+              </listitem>
+            </itemizedlist>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>createVlanIpRange</para>
+          </entry>
+          <entry>
+            <para>The following request parameters have been added:</para>
+            <itemizedlist>
+              <listitem>
+                <para>startipv6</para>
+              </listitem>
+              <listitem>
+                <para>endipv6</para>
+              </listitem>
+              <listitem>
+                <para>ip6gateway</para>
+              </listitem>
+              <listitem>
+                <para>ip6cidr</para>
+              </listitem>
+            </itemizedlist>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>deployVirtualMachine</para>
+          </entry>
+          <entry>
+            <para>The following parameter has been added: ip6Address.</para>
+            <para>The following parameter is updated to accept the IPv6 address:
+              iptonetworklist.</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>CreateZoneCmd</para>
+          </entry>
+          <entry>
+            <para>The following parameter have been added: ip6dns1, ip6dns2.</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listRouters</para>
+            <para>listVirtualMachines</para>
+          </entry>
+          <entry>
+            <para>For nic responses, the following fields have been added.</para>
+            <itemizedlist>
+              <listitem>
+                <para>ip6address</para>
+              </listitem>
+              <listitem>
+                <para>ip6gateway</para>
+              </listitem>
+              <listitem>
+                <para>ip6cidr</para>
+              </listitem>
+            </itemizedlist>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listVlanIpRanges</para>
+          </entry>
+          <entry>
+            <para>For nic responses, the following fields have been added.</para>
+            <itemizedlist>
+              <listitem>
+                <para>startipv6</para>
+              </listitem>
+              <listitem>
+                <para>endipv6</para>
+              </listitem>
+              <listitem>
+                <para>ip6gateway</para>
+              </listitem>
+              <listitem>
+                <para>ip6cidr</para>
+              </listitem>
+            </itemizedlist>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listRouters</para>
+            <para>listZones</para>
+          </entry>
+          <entry>
+            <para>For DomainRouter and DataCenter response, the following fields have been
+              added.</para>
+            <itemizedlist>
+              <listitem>
+                <para>ip6dns1</para>
+              </listitem>
+              <listitem>
+                <para>ip6dns2</para>
+              </listitem>
+            </itemizedlist>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>addF5LoadBalancer</para>
+            <para>configureNetscalerLoadBalancer</para>
+            <para>addNetscalerLoadBalancer</para>
+            <para>listF5LoadBalancers</para>
+            <para>configureF5LoadBalancer</para>
+            <para>listNetscalerLoadBalancers</para>
+          </entry>
+          <entry>
+            <para>The following response parameter is removed: inline.</para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>listFirewallRules</para>
+            <para>createFirewallRule</para></entry>
+          <entry>
+            <para>The following request parameter is added: traffictype (optional).</para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>listUsageRecords</para></entry>
+          <entry><para>The following response parameter is added: virtualsize.</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>deleteIso</para>
+          </entry>
+          <entry>
+            <para>The following request parameter is added: forced (optional).</para>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>createStoragePool</para>
+          </entry>
+          <entry>
+            <para>The following request parameters are made mandatory:</para>
+            <itemizedlist>
+              <listitem>
+                <para>podid</para>
+              </listitem>
+              <listitem>
+                <para>clusterid</para>
+              </listitem>
+            </itemizedlist>
+          </entry>
+        </row>
+        <row>
+          <entry>
+            <para>listZones</para>
+          </entry>
+          <entry>
+            <para>The following request parameter is added: securitygroupenabled</para>
+          </entry>
+        </row>
+        <row>
+          <entry><para>createAccount</para></entry>
+          <entry><para>The following new request parameters are added: accountid, userid</para></entry>
+        </row>
+        <row>
+          <entry><para>createUser</para></entry>
+          <entry><para>The following new request parameter is added: userid</para></entry>
+        </row>
+        <row>
+          <entry><para>createDomain</para></entry>
+          <entry><para>The following new request parameter is added: domainid</para></entry>
+        </row>
+      </tbody>
+    </tgroup>
+  </informaltable>
+</section>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/changing-root-password.xml
----------------------------------------------------------------------
diff --git a/en-US/changing-root-password.xml b/en-US/changing-root-password.xml
new file mode 100644
index 0000000..880f50f
--- /dev/null
+++ b/en-US/changing-root-password.xml
@@ -0,0 +1,50 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+    
+    http://www.apache.org/licenses/LICENSE-2.0
+    
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+-->	
+<section id="changing-root-password">
+	<title>Changing the Root Password</title>
+    <para>During installation and ongoing cloud administration, you will need to log in to the UI as the root administrator.
+        The root administrator account manages the &PRODUCT; deployment, including physical infrastructure.
+        The root administrator can modify configuration settings to change basic functionality, create or delete user accounts, and take many actions that should be performed only by an authorized person.
+        When first installing &PRODUCT;, be sure to change the default password to a new, unique value.</para>
+    <orderedlist>
+        <listitem><para>Open your favorite Web browser and go to this URL. Substitute the IP address of your own Management Server:</para>
+            <programlisting>http://&lt;management-server-ip-address&gt;:8080/client</programlisting>
+        </listitem>
+        <listitem><para>Log in to the UI using the current root user ID and password. The default is admin, password.</para></listitem>
+        <listitem><para>Click Accounts.</para></listitem>
+        <listitem><para>Click the admin account name.</para></listitem>
+        <listitem><para>Click View Users.</para></listitem>
+        <listitem><para>Click the admin user name.</para></listitem>
+        <listitem>
+            <para>Click the Change Password button.
+                <inlinemediaobject>
+                    <imageobject>
+                        <imagedata fileref="./images/change-password.png" />
+                    </imageobject>
+                    <textobject><phrase>change-password.png: button to change a user's password</phrase></textobject>
+                </inlinemediaobject></para>
+        </listitem>
+        <listitem><para>Type the new password, and click OK.</para></listitem>
+    </orderedlist>
+</section>

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/changing-secondary-storage-ip.xml
----------------------------------------------------------------------
diff --git a/en-US/changing-secondary-storage-ip.xml b/en-US/changing-secondary-storage-ip.xml
new file mode 100644
index 0000000..34f93e3
--- /dev/null
+++ b/en-US/changing-secondary-storage-ip.xml
@@ -0,0 +1,44 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+	or more contributor license agreements.  See the NOTICE file
+	distributed with this work for additional information
+	regarding copyright ownership.  The ASF licenses this file
+	to you under the Apache License, Version 2.0 (the
+	"License"); you may not use this file except in compliance
+	with the License.  You may obtain a copy of the License at
+	
+	http://www.apache.org/licenses/LICENSE-2.0
+	
+	Unless required by applicable law or agreed to in writing,
+	software distributed under the License is distributed on an
+	"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+	KIND, either express or implied.  See the License for the
+	specific language governing permissions and limitations
+	under the License.
+-->	
+<section id="changing-secondary-storage-ip">
+		<title>Changing the Secondary Storage IP Address</title>
+		<para>You can change the secondary storage IP address after it has been provisioned.  After changing the IP address on the host, log in to your management server and execute the following commands. Replace HOSTID below with your own value, and change the URL to use the appropriate IP address and path for your server:</para>
+		<programlisting>
+		# mysql -p
+		mysql> use cloud;
+		mysql> select id from host where type = 'SecondaryStorage';
+		mysql> update host_details set value = 'nfs://192.168.160.20/export/mike-ss1'
+  		where host_id = HOSTID and name = 'orig.url';
+		mysql> update host set name = 'nfs://192.168.160.20/export/mike-ss1' where type
+  		= 'SecondaryStorage' and id = #;
+		mysql> update host set url = 'nfs://192.168.160.20/export/mike-ss1' where type
+ 		 = 'SecondaryStorage' and id = #;
+		mysql> update host set guid = 'nfs://192.168.160.20/export/mike-ss1' where type
+  		= 'SecondaryStorage' and id = #;
+		</programlisting>
+		<note><para>When copying and pasting a command, be sure the command has pasted as a single line before executing. Some document viewers may introduce unwanted line breaks in copied text.</para></note>
+	    <para>Then log in to the cloud console UI and stop and start (not reboot) the Secondary Storage VM for that Zone.</para>
+			
+	</section>
+

http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/b23872a5/en-US/changing-secondary-storage-servers.xml
----------------------------------------------------------------------
diff --git a/en-US/changing-secondary-storage-servers.xml b/en-US/changing-secondary-storage-servers.xml
new file mode 100644
index 0000000..a628eec
--- /dev/null
+++ b/en-US/changing-secondary-storage-servers.xml
@@ -0,0 +1,36 @@
+<?xml version='1.0' encoding='utf-8' ?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+<!ENTITY % BOOK_ENTITIES SYSTEM "cloudstack.ent">
+%BOOK_ENTITIES;
+]>
+
+<!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements.  See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership.  The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License.  You may obtain a copy of the License at
+ 
+   http://www.apache.org/licenses/LICENSE-2.0
+ 
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied.  See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+<section id="changing-secondary-storage-servers">
+    <title>Changing Secondary Storage Servers</title>
+    <para>You can change the secondary storage NFS mount.  Perform the following steps to do so:</para>
+        <orderedlist>
+            <listitem><para>Stop all running Management Servers.</para></listitem>
+            <listitem><para>Wait 30 minutes.  This allows any writes to secondary storage to complete.</para></listitem>
+            <listitem><para>Copy all files from the old secondary storage mount to the new.</para></listitem>
+            <listitem><para>Use the procedure above to change the IP address for secondary storage if required.</para></listitem>
+            <listitem><para>Start the Management Server.</para></listitem>
+        </orderedlist>
+    </section>
+


Mime
View raw message