http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/castor-with-cs.xml ---------------------------------------------------------------------- diff --git a/en-US/castor-with-cs.xml b/en-US/castor-with-cs.xml deleted file mode 100644 index 7bf676b..0000000 --- a/en-US/castor-with-cs.xml +++ /dev/null @@ -1,86 +0,0 @@ -<?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="castor-with-cs"> - <title>Using the CAStor Back-end Storage with &PRODUCT;</title> - <para>This section describes how to use a CAStor cluster as the back-end storage system for a - &PRODUCT; S3 front-end. The CAStor back-end storage for &PRODUCT; extends the existing storage - classes and allows the storage configuration attribute to point to a CAStor cluster.</para> - <para>This feature makes use of the &PRODUCT; server's local disk to spool files before writing - them to CAStor when handling the PUT operations. However, a file must be successfully written - into the CAStor cluster prior to the return of a success code to the S3 client to ensure that - the transaction outcome is correctly reported.</para> - <note> - <para>The S3 multipart file upload is not supported in this release. You are prompted with - proper error message if a multipart upload is attempted.</para> - </note> - <para>To configure CAStor:</para> - <orderedlist> - <listitem> - <para>Install &PRODUCT; by following the instructions given in the INSTALL.txt file.</para> - <note> - <para>You can use the S3 storage system in &PRODUCT; without setting up and installing the - compute components.</para> - </note> - </listitem> - <listitem> - <para>Enable the S3 API by setting "enable.s3.api = true" in the Global parameter section in - the UI and register a user.</para> - <para>For more information, see <ulink - url="https://cwiki.apache.org/CLOUDSTACK/s3-api-in-cloudstack.html";>S3 API in - &PRODUCT;</ulink>.</para> - </listitem> - <listitem> - <para>Edit the cloud-bridge.properties file and modify the "storage.root" parameter.</para> - <orderedlist numeration="loweralpha"> - <listitem> - <para>Set "storage.root" to the key word "castor".</para> - </listitem> - <listitem> - <para>Specify a CAStor tenant domain to which content is written. If the domain is not - specified, the CAStor default domain, specified by the "cluster" parameter in CAStor's - node.cfg file, will be used.</para> - </listitem> - <listitem> - <para condition="">Specify a list of node IP addresses, or set "zeroconf" and the cluster - name. When using a static IP list with a large cluster, it is not necessary to include - every node, only a few is required to initialize the client software.</para> - <para>For example:</para> - <programlisting>storage.root=castor domain=cloudstack 10.1.1.51 10.1.1.52 10.1.1.53</programlisting> - <para>In this example, the configuration file directs &PRODUCT; to write the S3 files to - CAStor instead of to a file system, where the CAStor domain name is cloudstack, and the - CAStor node IP addresses are those listed.</para> - </listitem> - <listitem> - <para>(Optional) The last value is a port number on which to communicate with the CAStor - cluster. If not specified, the default is 80.</para> - <programlisting>#Static IP list with optional port -storage.root=castor domain=cloudstack 10.1.1.51 10.1.1.52 10.1.1.53 80 -#Zeroconf locator for cluster named "castor.example.com" -storage.root=castor domain=cloudstack zeroconf=castor.example.com</programlisting> - </listitem> - </orderedlist> - </listitem> - <listitem> - <para>Create the tenant domain within the CAStor storage cluster. If you omit this step before - attempting to store content, you will get HTTP 412 errors in the awsapi.log.</para> - </listitem> - </orderedlist> -</section>
http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/change-console-proxy-ssl-certificate-domain.xml ---------------------------------------------------------------------- diff --git a/en-US/change-console-proxy-ssl-certificate-domain.xml b/en-US/change-console-proxy-ssl-certificate-domain.xml deleted file mode 100644 index 3fd0501..0000000 --- a/en-US/change-console-proxy-ssl-certificate-domain.xml +++ /dev/null @@ -1,49 +0,0 @@ -<?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-console-proxy-ssl-certificate-domain"> - <title>Changing the Console Proxy SSL Certificate and Domain</title> - <para>If the administrator prefers, it is possible for the URL of the customer's console session to show a domain other than realhostip.com. The administrator can customize the displayed domain by selecting a different domain and uploading a new SSL certificate and private key. The domain must run a DNS service that is capable of resolving queries for addresses of the form aaa-bbb-ccc-ddd.your.domain to an IPv4 IP address in the form aaa.bbb.ccc.ddd, for example, 202.8.44.1. To change the console proxy domain, SSL certificate, and private key:</para> - <orderedlist> - <listitem><para>Set up dynamic name resolution or populate all possible DNS names in your public IP range into your existing DNS server with the format aaa-bbb-ccc-ddd.company.com -> aaa.bbb.ccc.ddd.</para></listitem> - <listitem><para>Generate the private key and certificate signing request (CSR). When you are using openssl to generate private/public key pairs and CSRs, for the private key that you are going to paste into the &PRODUCT; UI, be sure to convert it into PKCS#8 format.</para> - <orderedlist numeration="loweralpha"> - <listitem><para>Generate a new 2048-bit private key</para><programlisting>openssl genrsa -des3 -out yourprivate.key 2048</programlisting></listitem> - <listitem><para>Generate a new certificate CSR</para><programlisting>openssl req -new -key yourprivate.key -out yourcertificate.csr</programlisting></listitem> - <listitem><para>Head to the website of your favorite trusted Certificate Authority, purchase an SSL certificate, and submit the CSR. You should receive a valid certificate in return</para></listitem> - <listitem><para>Convert your private key format into PKCS#8 encrypted format.</para><programlisting>openssl pkcs8 -topk8 -in yourprivate.key -out yourprivate.pkcs8.encrypted.key</programlisting></listitem> - <listitem><para>Convert your PKCS#8 encrypted private key into the PKCS#8 format that is compliant with &PRODUCT;</para><programlisting>openssl pkcs8 -in yourprivate.pkcs8.encrypted.key -out yourprivate.pkcs8.key</programlisting></listitem> - </orderedlist> - </listitem> - <listitem><para>In the Update SSL Certificate screen of the &PRODUCT; UI, paste the following</para> - <itemizedlist> - <listitem><para>The Certificate you generated in the previous steps.</para></listitem> - <listitem><para>The Private key you generated in the previous steps.</para></listitem> - <listitem><para>The desired new domain name; for example, company.com</para></listitem> - </itemizedlist> - </listitem> - <listitem><para>The desired new domain name; for example, company.com</para><para>This stops all currently running console proxy VMs, then restarts them with the new certificate and key. Users might notice a brief interruption in console availability</para></listitem> - </orderedlist> - <para>The Management Server will generate URLs of the form "aaa-bbb-ccc-ddd.company.com" after this change is made. New console requests will be served with the new DNS domain name, certificate, and key</para> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/change-database-config.xml ---------------------------------------------------------------------- diff --git a/en-US/change-database-config.xml b/en-US/change-database-config.xml deleted file mode 100644 index 567b9e4..0000000 --- a/en-US/change-database-config.xml +++ /dev/null @@ -1,28 +0,0 @@ -<?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-database-config"> - <title>Changing the Database Configuration</title> - <para>The &PRODUCT; Management Server stores database configuration information (e.g., hostname, port, credentials) in the file <filename>/etc/cloudstack/management/db.properties</filename>. To effect a change, edit this file on each Management Server, then restart the Management Server.</para> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/change-database-password.xml ---------------------------------------------------------------------- diff --git a/en-US/change-database-password.xml b/en-US/change-database-password.xml deleted file mode 100644 index 863984e..0000000 --- a/en-US/change-database-password.xml +++ /dev/null @@ -1,76 +0,0 @@ -<?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-database-password"> - <title>Changing the Database Password</title> - <para>You may need to change the password for the MySQL account used by CloudStack. If so, you'll need to change the password in MySQL, and then add the encrypted password to <filename>/etc/cloudstack/management/db.properties</filename>.</para> - <orderedlist> - <listitem> - <para>Before changing the password, you'll need to stop CloudStack's management server and the usage engine if you've deployed that component.</para> -<screen> -<command># service cloudstack-management stop</command> -<command># service cloudstack-usage stop</command> -</screen> - </listitem> - <listitem> - <para>Next, you'll update the password for the CloudStack user on the MySQL server.</para> -<screen> -<command># mysql -u root -p</command> -</screen> - <para>At the MySQL shell, you'll change the password and flush privileges:</para> -<screen> -<command>update mysql.user set password=PASSWORD("newpassword123") where User='cloud';</command> -<command>flush privileges;</command> -<command>quit;</command> -</screen> - </listitem> - <listitem> - <para>The next step is to encrypt the password and copy the encrypted password to CloudStack's database configuration (<filename>/etc/cloudstack/management/db.properties</filename>).</para> -<screen> - <command># java -classpath /usr/share/cloudstack-common/lib/jasypt-1.9.0.jar \ -org.jasypt.intf.cli.JasyptPBEStringEncryptionCLI encrypt.sh \ -input="newpassword123" password="`cat /etc/cloudstack/management/key`" \ -verbose=false -</command> -</screen> -<note><title>File encryption type</title> - <para>Note that this is for the file encryption type. If you're using the web encryption type then you'll use password="management_server_secret_key"</para> -</note> -</listitem> -<listitem> - <para>Now, you'll update <filename>/etc/cloudstack/management/db.properties</filename> with the new ciphertext. Open <filename>/etc/cloudstack/management/db.properties</filename> in a text editor, and update these parameters: </para> - <programlisting> -db.cloud.password=ENC(encrypted_password_from_above) -db.usage.password=ENC(encrypted_password_from_above) -</programlisting> -</listitem> -<listitem> - <para>After copying the new password over, you can now start CloudStack (and the usage engine, if necessary).</para> - <screen> - <command># service cloudstack-management start</command> - <command># service cloud-usage start</command> - </screen> -</listitem> -</orderedlist> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/change-host-password.xml ---------------------------------------------------------------------- diff --git a/en-US/change-host-password.xml b/en-US/change-host-password.xml deleted file mode 100644 index 7221fe6..0000000 --- a/en-US/change-host-password.xml +++ /dev/null @@ -1,39 +0,0 @@ -<?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-host-password"> - <title>Changing Host Password</title> - <para>The password for a XenServer Node, KVM Node, or vSphere Node may be changed in the database. Note that all Nodes in a Cluster must have the same password.</para> - <para> To change a Node's password:</para> - <orderedlist> - <listitem><para>Identify all hosts in the cluster.</para></listitem> - <listitem><para>Change the password on all hosts in the cluster. Now the password for the host and the password known to &PRODUCT; will not match. Operations on the cluster will fail until the two passwords match.</para> - </listitem> - <listitem><para>Get the list of host IDs for the host in the cluster where you are changing the password. You will need to access the database to determine these host IDs. For each hostname "h" (or vSphere cluster) that you are changing the password for, execute:</para> - <programlisting>mysql> select id from cloud.host where name like '%h%';</programlisting> </listitem> - <listitem><para>This should return a single ID. Record the set of such IDs for these hosts.</para></listitem> - <listitem><para>Update the passwords for the host in the database. In this example, we change the passwords for hosts with IDs 5, 10, and 12 to "password".</para> - <programlisting>mysql> update cloud.host set password='password' where id=5 or id=10 or id=12;</programlisting></listitem> - </orderedlist> - </section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/change-network-offering-on-guest-network.xml ---------------------------------------------------------------------- diff --git a/en-US/change-network-offering-on-guest-network.xml b/en-US/change-network-offering-on-guest-network.xml deleted file mode 100644 index de3a80e..0000000 --- a/en-US/change-network-offering-on-guest-network.xml +++ /dev/null @@ -1,68 +0,0 @@ -<?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-network-offering-on-guest-network"> - <title>Changing the Network Offering on a Guest Network</title> - <para>A user or administrator can change the network offering that is associated with an existing - guest network.</para> - <orderedlist> - <listitem> - <para>Log in to the &PRODUCT; UI as an administrator or end user. </para> - </listitem> - <listitem> - <para>If you are changing from a network offering that uses the &PRODUCT; virtual router to - one that uses external devices as network service providers, you must first stop all the VMs - on the network.</para> - </listitem> - <listitem> - <para>In the left navigation, choose Network.</para> - </listitem> - <listitem> - <para>Click the name of the network you want to modify.</para> - </listitem> - <listitem> - <para>In the Details tab, click Edit.<inlinemediaobject> - <imageobject> - <imagedata fileref="./images/edit-icon.png"/> - </imageobject> - <textobject> - <phrase>EditButton.png: button to edit a network</phrase> - </textobject> - </inlinemediaobject></para> - </listitem> - <listitem> - <para>In Network Offering, choose the new network offering, then click Apply.</para> - <para>A prompt is displayed asking whether you want to keep the existing CIDR. This is to let - you know that if you change the network offering, the CIDR will be affected.</para> - <para>If you upgrade between virtual router as a provider and an external network device as - provider, acknowledge the change of CIDR to continue, so choose Yes.</para> - </listitem> - <listitem> - <para>Wait for the update to complete. Donât try to restart VMs until the network change is - complete.</para> - </listitem> - <listitem> - <para>If you stopped any VMs, restart them.</para> - </listitem> - </orderedlist> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/en-US/change-sysmvmtemplate.xml ---------------------------------------------------------------------- diff --git a/en-US/change-sysmvmtemplate.xml b/en-US/change-sysmvmtemplate.xml deleted file mode 100644 index b41460c..0000000 --- a/en-US/change-sysmvmtemplate.xml +++ /dev/null @@ -1,82 +0,0 @@ -<?xml version='1.0' encoding='utf-8' ?> -<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "file:///C:/Program%20Files%20(x86)/Publican/DocBook_DTD/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-sysmvmtemplate"> - <title>Changing the Default System VM Template</title> - <para>&PRODUCT; allows you to change the default 32-bit System VM template to 64-bit one. Using - the 64-bit template, upgrade the virtual router to manage larger number of connection in your - network.</para> - <orderedlist> - <listitem> - <para>Based on the hypervisor you use, download the 64-bit template from the following - location:</para> - <informaltable> - <tgroup cols="2" align="left" colsep="1" rowsep="1"> - <colspec colwidth="1.0*" colname="1" colnum="1"/> - <colspec colwidth="7.33*" colname="2" colnum="2"/> - <thead> - <row> - <entry><para>Hypervisor</para></entry> - <entry><para>Download Location</para></entry> - </row> - </thead> - <tbody> - <row> - <entry><para>XenServer</para></entry> - <entry> - <para>http://download.cloud.com/templates/4.2/64bit/systemvmtemplate64-2013-07-15-master-xen.vhd.bz2</para></entry> - </row> - <row> - <entry><para>KVM</para></entry> - <entry> - <para>http://download.cloud.com/templates/4.2/64bit/systemvmtemplate64-2013-07-15-master-kvm.qcow2.bz2 - </para></entry> - </row> - </tbody> - </tgroup> - </informaltable> - </listitem> - <listitem> - <para>As an administrator, log in to the &PRODUCT; UI</para> - </listitem> - <listitem> - <para>Register the 64 bit template. </para> - <para>For example: KVM64bitTemplate</para> - </listitem> - <listitem> - <para>While registering the template, select Routing.</para> - </listitem> - <listitem> - <para>Navigate to Infrastructure > Zone > Settings. </para> - </listitem> - <listitem> - <para>Set the name of the 64-bit template, KVM64bitTemplate, in the - <parameter>router.template.kvm</parameter> global parameter.</para> - <para>If you are using a XenServer 64-bit template, set the name in the - <parameter>router.template.xen</parameter> global parameter.</para> - <para>Any new virtual router created in this Zone automatically picks up this template.</para> - </listitem> - <listitem> - <para>Restart the Management Server.</para> - </listitem> - </orderedlist> -</section> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/blob/f42520a5/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 deleted file mode 100644 index 69b9e4d..0000000 --- a/en-US/change-to-behavior-of-list-commands.xml +++ /dev/null @@ -1,108 +0,0 @@ -<?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/f42520a5/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 deleted file mode 100644 index 8fda9cc..0000000 --- a/en-US/changed-API-commands-4.2.xml +++ /dev/null @@ -1,1129 +0,0 @@ -<?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>
