openstack/openstack-manuals
Code Issues Proposed changes

Updated the 'Create and manage containers' section

Browse Source 
Included the following changes:
- Option to make container Public or Private
- New section 'Manage an object' with procedures to:
  * Edit an object
  * Copy an object from one container to another
  * Create a metadata-only object without a file
  * Create a pseudo-folder
Partial-Bug: #1307860

Change-Id: I3651abae223b4891f890ecf036c699add3ef3687
This commit is contained in:
Deepti Navale 2014-04-17 15:33:59 +10:00
parent 2ef9797a58
commit bb4d31caed
1 changed files with 154 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

164
doc/user-guide/section_dashboard_manage_containers.xml
View File

@ -26,9 +26,12 @@ xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
<para>Click <guibutton>Create Container</guibutton>.</para>
</step>
<step>
<para>In the Create Container dialog box, enter a name for
the container, and then click<guibutton>Create
Container</guibutton>.</para>
<para>In the <guilabel>Create Container</guilabel> dialog box, enter a
name for the container, choose if you want the access to be
<guilabel>Private</guilabel> or <guilabel>Public</guilabel>.</para>
</step>
<step>
<para>Click <guibutton>Create Container</guibutton>.</para>
</step>
</procedure>
<para>You have successfully created a container.</para>
@ -41,16 +44,17 @@ xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
<title>Upload an object</title>
<procedure>
<step>
<para>Log in to the dashboard, choose a projecet, and click
<guilabel>Containers</guilabel>.</para>
<para>Log in to the dashboard, choose a project, and click
<guilabel>Containers</guilabel> in the <guilabel>Object Store</guilabel>
tab.</para>
</step>
<step>
<para>Select the container in which you want to store your object.</para>
</step>
<step>
<para>Click <guibutton>Upload Object</guibutton>.</para>
<para>The Upload Object To Container:
<replaceable>&lt;name></replaceable> dialog box is
<para>The <guilabel>Upload Object To Container:
<replaceable>&lt;name></replaceable></guilabel> dialog box is
displayed. <replaceable>&lt;name></replaceable> is the name
of the container to which you are uploading the
object.</para>
@ -64,11 +68,151 @@ xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0"
</step>
<step>
<para>Click <guibutton>Upload Object</guibutton>.</para>
<para>You have successfully uploaded an object to the container.</para>
</step>
</procedure>
<para>You have successfully uploaded an object to the container.</para>
<note><para>To delete an object, click the <guibutton>More</guibutton>
button and select <guilabel>Delete Object</guilabel>.</para>
</section>
<section xml:id="manage_object">
<title>Manage an object</title>
<procedure xml:id="edit_object">
<title>Edit an object</title>
<step>
<para>Log in to the dashboard, choose a project, and click
<guilabel>Containers</guilabel> in the <guilabel>Object Store</guilabel>
tab.</para>
</step>
<step>
<para>Select the container in which you want to store your object.</para>
</step>
<step>
<para>Click <guibutton>More</guibutton> and choose <guilabel>Edit
</guilabel> from the dropdown list.</para>
<para>The <guilabel>Edit Object</guilabel> dialog box is
displayed.</para>
</step>
<step>
<para>Browse to and select the file that you want to
upload.</para>
</step>
<step>
<para>Click <guibutton>Update Object</guibutton>.</para>
</step>
</procedure>
<note>
<para>To delete an object, click the <guibutton>More</guibutton>
button and select <guilabel>Delete Object</guilabel>.</para>
</note>
<procedure xml:id="copy_object">
<title>Copy an object from one container to another</title>
<step>
<para>Log in to the dashboard, choose a project, and click
<guilabel>Containers</guilabel> in the <guilabel>Object Store</guilabel>
tab.</para>
</step>
<step>
<para>Select the container in which you want to store your object.</para>
</step>
<step>
<para>Click <guibutton>More</guibutton> and choose <guilabel>Copy
</guilabel> from the dropdown list.</para>
</step>
<step>
<para>In the <guilabel>Copy Object: launch</guilabel> dialog box,
enter or select the following values:</para>
<informaltable rules="all" width="75%">
<col width="25%"/>
<col width="75%"/>
<tbody>
<tr>
<td>
<para><guilabel>Destination Container</guilabel></para>
</td>
<td>
<para>Choose the destination container from the dropdown
list.</para>
</td>
</tr>
<tr>
<td>
<para><guilabel>Path</guilabel></para>
</td>
<td>
<para>Specify a path at which the new copy should be
stored inside of the selected container.</para>
</td>
</tr>
<tr>
<td>
<para><guilabel>Destination object name</guilabel></para>
</td>
<td>
<para>Enter a name for the object in the new container.</para>
</td>
</tr>
</tbody>
</informaltable>
</step>
<step>
<para>Click <guibutton>Copy Object</guibutton>.</para>
</step>
</procedure>
<procedure xml:id="create_empty_object">
<title>Create a metadata only object without a file</title>
<step>
<para>Log in to the dashboard, choose a project, and click
<guilabel>Containers</guilabel> in the <guilabel>Object Store</guilabel>
tab.</para>
</step>
<step>
<para>Select the container in which you want to store your object.</para>
</step>
<step>
<para>Click <guibutton>Upload Object</guibutton>.</para>
<para>The <guilabel>Upload Object To Container:
<replaceable>&lt;name></replaceable></guilabel> dialog box is
displayed. <replaceable>&lt;name></replaceable> is the name
of the container to which you are uploading the
object.</para>
<para>You can create a new object in container without a file
available and can upload the file later when it is ready.
This works like a place-holder for a new object to allow user to
flexibly share object metadata and URL info in advance.</para>
</step>
<step>
<para>Enter a name for the object.</para>
</step>
<step>
<para>Click <guibutton>Update Object</guibutton>.</para>
</step>
</procedure>
<procedure xml:id="create_pseudo_folder">
<title>Create a pseudo-folder</title>
<step>
<para>Log in to the dashboard, choose a project, and click
<guilabel>Containers</guilabel> in the <guilabel>Object Store</guilabel>
tab.</para>
</step>
<step>
<para>Select the container in which you want to store your object.</para>
</step>
<step>
<para>Click <guibutton>Create Pseudo-folder</guibutton>.</para>
<para>The <guilabel>Create pseudo-folder in container <replaceable>&lt;name>
</replaceable></guilabel> dialog box is displayed. <replaceable>&lt;name>
</replaceable> is the name of the container to which you are uploading
the object.</para>
</step>
<step>
<para>Enter a name for the pseudo-folder.</para>
<para>Pseudo-folders behave similarly to folders in your desktop
operating system, with the exception that they are virtual
collections defined by a common prefix on the object's name.</para>
<para>A slash (/) character is used as the delimiter for pseudo-folders
in the Object Store.</para>
</step>
<step>
<para>Click <guibutton>Create</guibutton>.</para>
</step>
</procedure>
</section>
</section>