Add Shared File Systems API v1,v2 sections

Added the documentation of the core APIs of the
Shared File Systems [1] API v1 and v2.

[1] https://wiki.openstack.org/wiki/Manila

Change-Id: I438bcaf7baa0e8978a367c92aa35a8119b8978af
Partial-Bug: #1498053
This commit is contained in:
sslypushenko 2015-09-07 16:09:04 +03:00
parent 6b904ff45c
commit 881944cfe2
105 changed files with 7930 additions and 0 deletions

View File

@ -204,6 +204,28 @@
<pdfFilenameBase>api-ref-orchestration-v1</pdfFilenameBase>
</configuration>
</execution>
<execution>
<id>os-api-ref-share-v2</id>
<goals>
<goal>generate-pdf</goal>
</goals>
<phase>generate-sources</phase>
<configuration>
<includes> bk-api-ref-share-v2.xml </includes>
<pdfFilenameBase>api-ref-share-v2</pdfFilenameBase>
</configuration>
</execution>
<execution>
<id>os-api-ref-share-v1</id>
<goals>
<goal>generate-pdf</goal>
</goals>
<phase>generate-sources</phase>
<configuration>
<includes> bk-api-ref-share-v1.xml </includes>
<pdfFilenameBase>api-ref-share-v1</pdfFilenameBase>
</configuration>
</execution>
<execution>
<id>os-api-ref-telemetry-v2</id>
<goals>

View File

@ -0,0 +1,36 @@
<?xml version="1.0" encoding="UTF-8"?>
<book xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:linkend="http://www.w3.org/1999/linkend"
xmlns:xref="http://www.w3.org/1999/xref"
xmlns:wadl="http://wadl.dev.java.net/2009/02"
version="5.0-extension RackBook-2.0"
xml:id="api.openstack.org-share-v1-pdf">
<info>
<title>OpenStack Shared File Systems API v1 Reference</title>
<titleabbrev>API Reference</titleabbrev>
<author>
<personname>
<firstname/>
<surname/>
</personname>
<affiliation>
<orgname>OpenStack Foundation</orgname>
</affiliation>
</author>
<copyright>
<year>2015</year>
<holder>OpenStack Foundation</holder>
</copyright>
<productname>OpenStack Shared File Systems</productname>
<pubdate/>
<legalnotice role="apache2">
<annotation>
<remark>Copyright details are filled in by the
template.</remark>
</annotation>
</legalnotice>
</info>
<xi:include href="../../api-ref/src/docbkx/ch_share-v1.xml"/>
</book>

View File

@ -0,0 +1,36 @@
<?xml version="1.0" encoding="UTF-8"?>
<book xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:linkend="http://www.w3.org/1999/linkend"
xmlns:xref="http://www.w3.org/1999/xref"
xmlns:wadl="http://wadl.dev.java.net/2009/02"
version="5.0-extension RackBook-2.0"
xml:id="api.openstack.org-share-v2-pdf">
<info>
<title>OpenStack Shared File Systems API v2 Reference</title>
<titleabbrev>API Reference</titleabbrev>
<author>
<personname>
<firstname/>
<surname/>
</personname>
<affiliation>
<orgname>OpenStack Foundation</orgname>
</affiliation>
</author>
<copyright>
<year>2015</year>
<holder>OpenStack Foundation</holder>
</copyright>
<productname>OpenStack Shared File Systems</productname>
<pubdate/>
<legalnotice role="apache2">
<annotation>
<remark>Copyright details are filled in by the
template.</remark>
</annotation>
</legalnotice>
</info>
<xi:include href="../../api-ref/src/docbkx/ch_share-v2.xml"/>
</book>

View File

@ -51,5 +51,7 @@
<xi:include href="../../api-ref/src/docbkx/ch_netconn-v2-ext.xml"/>
<xi:include href="../../api-ref/src/docbkx/ch_objectstorage-v1.xml"/>
<xi:include href="../../api-ref/src/docbkx/ch_orchestration-v1.xml"/>
<xi:include href="../../api-ref/src/docbkx/ch_share-v2.xml"/>
<xi:include href="../../api-ref/src/docbkx/ch_share-v1.xml"/>
<xi:include href="../../api-ref/src/docbkx/ch_telemetry-v2.xml"/>
</book>

View File

@ -245,6 +245,28 @@
<pdfFilename>bk-api-ref-orchestration-v1</pdfFilename>
</configuration>
</execution>
<execution>
<id>os-api-ref-share-v2</id>
<goals>
<goal>generate-html</goal>
</goals>
<phase>generate-sources</phase>
<configuration>
<includes>api-ref-share-v2.xml</includes>
<pdfFilename>bk-api-ref-share-v2</pdfFilename>
</configuration>
</execution>
<execution>
<id>os-api-ref-share-v1</id>
<goals>
<goal>generate-html</goal>
</goals>
<phase>generate-sources</phase>
<configuration>
<includes>api-ref-share-v1.xml</includes>
<pdfFilename>bk-api-ref-share-v1</pdfFilename>
</configuration>
</execution>
<execution>
<id>os-api-ref-telemetry-v2</id>
<goals>

View File

@ -0,0 +1,23 @@
<?xml version="1.0" encoding="UTF-8"?>
<book xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:linkend="http://www.w3.org/1999/linkend"
xmlns:xref="http://www.w3.org/1999/xref"
xmlns:wadl="http://wadl.dev.java.net/2009/02"
version="5.0-extension RackBook-2.0"
xml:id="api.openstack.org-share-v1" status="CURRENT">
<info xreflabel="api-ref-share-v1.html">
<title>OpenStack Shared File Systems API v1 (CURRENT)</title>
<copyright>
<year>2015</year>
</copyright>
<legalnotice role="apache2">
<para/>
</legalnotice>
<annotation>
<xi:include href="itemizedlist-service-list.xml"/>
</annotation>
</info>
<xi:include href="ch_share-v1.xml"/>
</book>

View File

@ -0,0 +1,23 @@
<?xml version="1.0" encoding="UTF-8"?>
<book xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:linkend="http://www.w3.org/1999/linkend"
xmlns:xref="http://www.w3.org/1999/xref"
xmlns:wadl="http://wadl.dev.java.net/2009/02"
version="5.0-extension RackBook-2.0"
xml:id="api.openstack.org-share-v1" status="CURRENT">
<info xreflabel="api-ref-share-v2.html">
<title>OpenStack Shared File Systems API v2.0 (CURRENT)</title>
<copyright>
<year>2015</year>
</copyright>
<legalnotice role="apache2">
<para/>
</legalnotice>
<annotation>
<xi:include href="itemizedlist-service-list.xml"/>
</annotation>
</info>
<xi:include href="ch_share-v2.xml"/>
</book>

View File

@ -0,0 +1,27 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter [
<!ENTITY % common_project SYSTEM "../wadls/common_project.ent">
%common_project;
]>
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:linkend="http://www.w3.org/1999/linkend"
xmlns:xref="http://www.w3.org/1999/xref"
xmlns:wadl="http://wadl.dev.java.net/2009/02"
version="5.0-extension RackBook-2.0"
xml:id="share-api-v1">
<title>Shared File Systems API v1 (SUPPORTED)</title>
<para>
Provides coordinated access to shared or distributed file systems.
</para>
<para>
The Shared File Systems API v1 is functionally identical to the <link
xlink:type="simple" xlink:href="api-ref-share-v2.html">Shared File
Systems API v2.0</link>. Subsequent API v2 micro-versions, such as v2.1,
differ from API v1.0.
</para>
<para>
Starting with the API v2.0, the API uses Compute-style micro-versions.
</para>
</chapter>

View File

@ -0,0 +1,874 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter [
<!ENTITY % common_project SYSTEM "../wadls/common_project.ent">
%common_project;
]>
<chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:linkend="http://www.w3.org/1999/linkend"
xmlns:xref="http://www.w3.org/1999/xref"
xmlns:wadl="http://wadl.dev.java.net/2009/02"
version="5.0-extension RackBook-2.0"
xml:id="share-api-v2"
role="api-reference">
<title>Shared File Systems API v2 (CURRENT)</title>
<para>
Provides coordinated access to shared or distributed file systems.
</para>
<para>
The Shared File Systems API uses Compute-style micro-versions. Use the
HTTP <code>X-Openstack-Manila-Api-Version</code> request header to specify a
valid micro-version. For example, <code>"X-Openstack-Manila-Api-Version:
2.6"</code>. If you omit this header, the default micro-version is 2.0.
</para>
<para>
Other than the switch to the micro-versions approach, the Shared File
Systems API v2.0 is functionally identical to the <link
xlink:type="simple" xlink:href="api-ref-share-v1.html">Shared File
Systems API v1.0</link>.
</para>
<para>
Subsequent API v2 micro-versions, such as v2.1, differ from API v1.0.
Look for notes that identify in which post-v2 micro-version a feature,
method, or parameter was introduced.
</para>
<section xml:id="share-versions">
<title>API versions</title>
<para>
Lists information for all Shared File Systems API versions.
</para>
<wadl:resources xmlns:wadl="http://wadl.dev.java.net/2009/02">
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#versions">
<wadl:method href="#share-listVersions" />
</wadl:resource>
</wadl:resources>
</section>
<section xml:id="share-extensions">
<title>API extensions</title>
<para>
Lists available Shared File Systems API extensions.
</para>
<wadl:resources xmlns:wadl="http://wadl.dev.java.net/2009/02">
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#extensions">
<wadl:method href="#getExtensions"/>
</wadl:resource>
</wadl:resources>
</section>
<section xml:id="share-limits">
<title>Limits</title>
<para>
Limits are the resource limitations that are allowed for each
tenant (project). An administrator can configure limits in
the <code>manila.conf</code> file.
</para>
<para>
Users can query their rate and absolute limits. The absolute
limits contain information about:
</para>
<itemizedlist>
<listitem>
<para>Total maximum share memory, in GBs.</para>
</listitem>
<listitem>
<para>Number of share-networks.</para>
</listitem>
<listitem>
<para>Number of share-snapshots.</para>
</listitem>
<listitem>
<para>Number of shares.</para>
</listitem>
<listitem>
<para>Shares and total used memory, in GBs.</para>
</listitem>
<listitem>
<para>Snapshots and total used memory, in GBs.</para>
</listitem>
</itemizedlist>
<para>
Rate limits control the frequency at which users can issue
specific API requests. Administrators use rate limiting to
configure limits on the type and number of API calls that can be
made in a specific time interval. For example, a rate limit can
control the number of &GET; requests that can be processed during
a one-minute period.
</para>
<wadl:resources xmlns:wadl="http://wadl.dev.java.net/2009/02">
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#limits">
<wadl:method href="#getLimits"/>
</wadl:resource>
</wadl:resources>
</section>
<section xml:id="share-shares">
<title>Shares</title>
<para>
A share is a remote, mountable file system. You can mount a share
to and access a share from several hosts by several users at a
time.
</para>
<para>
You can create a share and associate it with a network, list shares,
and show information for, update, and delete a specified share.
</para>
<para>
To create a share, specify one of these supported protocols:
</para>
<itemizedlist>
<listitem>
<para>
<code>NFS</code>. Network File System (NFS).
</para>
</listitem>
<listitem>
<para>
<code>CIFS</code>. Common Internet File System (CIFS).
</para>
</listitem>
<listitem>
<para>
<code>GLUSTERFS</code>. Gluster file system (GlusterFS).
</para>
</listitem>
<listitem>
<para>
<code>HDFS</code>. Hadoop Distributed File System (HDFS).
</para>
</listitem>
</itemizedlist>
<para>
You can also create snapshots of shares. To create a snapshot, you
specify the ID of the share that you want to snapshot.
</para>
<para>
A share has one of these status values:
</para>
<table rules="all" frame="border">
<caption>Share statuses</caption>
<col width="30%"/>
<col width="70%"/>
<thead>
<tr>
<th>Status</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>
<para><code>creating</code></para>
</td>
<td>
<para>The share is being created.</para>
</td>
</tr>
<tr>
<td>
<para><code>deleting</code></para>
</td>
<td>
<para>The share is being deleted.</para>
</td>
</tr>
<tr>
<td>
<para><code>error</code></para>
</td>
<td>
<para>An error occurred during share
creation.
</para>
</td>
</tr>
<tr>
<td>
<para><code>error_deleting</code></para>
</td>
<td>
<para>An error occurred during share
deletion.
</para>
</td>
</tr>
<tr>
<td>
<para><code>available</code></para>
</td>
<td>
<para>The share is ready to use.</para>
</td>
</tr>
<tr>
<td>
<para><code>manage_starting</code></para>
</td>
<td>
<para>Share manage started.</para>
</td>
</tr>
<tr>
<td>
<para><code>manage_error</code></para>
</td>
<td>
<para>Share manage failed.</para>
</td>
</tr>
<tr>
<td>
<para><code>unmanage_starting</code></para>
</td>
<td>
<para>Share unmanage started.</para>
</td>
</tr>
<tr>
<td>
<para><code>unmanage_error</code></para>
</td>
<td>
<para>Share cannot be unmanaged.</para>
</td>
</tr>
<tr>
<td>
<para><code>unmanaged</code></para>
</td>
<td>
<para>Share was unmanaged.</para>
</td>
</tr>
<tr>
<td>
<para><code>extending</code></para>
</td>
<td>
<para>
The extend, or increase, share size request was
issued successfully.
</para>
</td>
</tr>
<tr>
<td>
<para><code>extending_error</code></para>
</td>
<td>
<para>Extend share failed.</para>
</td>
</tr>
<tr>
<td>
<para><code>shrinking</code></para>
</td>
<td>
<para>Share is being shrunk.</para>
</td>
</tr>
<tr>
<td>
<para><code>shrinking_error</code></para>
</td>
<td>
<para>Failed to update quota on share shrinking.</para>
</td>
</tr>
<tr>
<td>
<para><code>shrinking_possible_data_loss_error</code></para>
</td>
<td>
<para>Shrink share failed due to possible data loss.</para>
</td>
</tr>
</tbody>
</table>
<para></para>
<wadl:resources xmlns:wadl="http://wadl.dev.java.net/2009/02">
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#shares">
<wadl:method href="#createShare"/>
<wadl:method href="#getShares"/>
</wadl:resource>
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#detail-share">
<wadl:method href="#getSharesDetails"/>
</wadl:resource>
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#share_id">
<wadl:method href="#getShare"/>
<wadl:method href="#updateShare"/>
<wadl:method href="#deleteShare"/>
</wadl:resource>
</wadl:resources>
</section>
<section xml:id="share-metadata">
<title>Share metadata</title>
<para>
Shows, sets, updates, and unsets share metadata.
</para>
<wadl:resources xmlns:wadl="http://wadl.dev.java.net/2009/02">
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#metadata-share">
<wadl:method href="#getShareMetadata"/>
<wadl:method href="#updateShareMetadata"/>
<wadl:method href="#setShareMetadata"/>
</wadl:resource>
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#metadata_key">
<wadl:method href="#unSetShareMetadata"/>
</wadl:resource>
</wadl:resources>
</section>
<section xml:id="share-actions">
<title>Share actions</title>
<para>
Use share actions to grant or deny access to a specified share,
list the permissions for a specified share, and explicitly update
the state of a share.
</para>
<para>
To grant or deny access to a share, specify one of these supported
share access levels:
</para>
<itemizedlist>
<listitem>
<para>
<code>rw</code>. Read and write (RW) access.
</para>
</listitem>
<listitem>
<para>
<code>ro</code>. Read-only (RO) access.
</para>
</listitem>
</itemizedlist>
<para>
You must also specify one of these supported authentication
methods:
</para>
<itemizedlist role="compact">
<listitem>
<para>
<code>ip</code>. Authenticates an instance through its IP
address. A valid format is <code>XX.XX.XX.XX</code> or
<code>XX.XX.XX.XX/XX</code>. For example <code>0.0.0.0/0</code>.
</para>
</listitem>
<listitem>
<para>
<code>cert</code>. Authenticates an instance through a TLS
certificate. Specify the TLS identity as the IDENTKEY. A
valid value is any string up to 64 characters long in the
common name (CN) of the certificate. The meaning of a
string depends on its interpretation.
</para>
</listitem>
<listitem>
<para>
<code>user</code>. Authenticates by a specified user or
group name. A valid value is an alphanumeric string that
can contain some special characters and is from 4 to 32
characters long.
</para>
</listitem>
</itemizedlist>
<para>
To verify that the access rules (ACL) were configured correctly
for a share, you list permissions for a share.
</para>
<para>
As administrator, you can reset the state of a share and
force-delete a specified share in any state. Use the
<code>policy.json</code> file to grant permissions for this
action to other roles.
</para>
<para>
You can set the state of a share to one of these supported states:
</para>
<itemizedlist>
<listitem>
<para><code>available</code></para>
</listitem>
<listitem>
<para><code>error</code></para>
</listitem>
<listitem>
<para><code>creating</code></para>
</listitem>
<listitem>
<para><code>deleting</code></para>
</listitem>
<listitem>
<para><code>error_deleting</code></para>
</listitem>
</itemizedlist>
<wadl:resources xmlns:wadl="http://wadl.dev.java.net/2009/02">
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#action">
<wadl:method href="#allowAccess"/>
<wadl:method href="#denyAccess"/>
<wadl:method href="#listAccessRules"/>
<wadl:method href="#resetShareState"/>
<wadl:method href="#force-deleteShare"/>
<wadl:method href="#extendShare"/>
<wadl:method href="#shrinkShare"/>
<wadl:method href="#migrateShare"/>
</wadl:resource>
</wadl:resources>
</section>
<section xml:id="share-snapshots">
<title>Share snapshots</title>
<para>
Use the shared file service to make snapshots of shares. A share
snapshot is a point-in-time, read-only copy of the data that is
contained in a share. You can create, update, and delete share
snapshots. After you create a share snapshot, you can create a
share from it.
</para>
<para>
You can update a share snapshot to rename it, change its
description, or update its state to one of these supported states:
</para>
<itemizedlist>
<listitem>
<para><code>available</code></para>
</listitem>
<listitem>
<para><code>error</code></para>
</listitem>
<listitem>
<para><code>creating</code></para>
</listitem>
<listitem>
<para><code>deleting</code></para>
</listitem>
<listitem>
<para><code>error_deleting</code></para>
</listitem>
</itemizedlist>
<para>
As administrator, you can also reset the state of a snapshot and
force-delete a specified share snapshot in any state.
Use the <code>policy.json</code> file to grant permissions for
these actions to other roles.
</para>
<wadl:resources xmlns:wadl="http://wadl.dev.java.net/2009/02">
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#snapshots">
<wadl:method href="#share-createSnapshot" />
<wadl:method href="#share-getSnapshots" />
</wadl:resource>
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#detail-snapshot">
<wadl:method href="#share-getSnapshotsDetails" />
</wadl:resource>
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#snapshot_id">
<wadl:method href="#share-getSnapshot" />
<wadl:method href="#share-updateSnapshot" />
<wadl:method href="#share-deleteSnapshot" />
</wadl:resource>
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#snapshot-action">
<wadl:method href="#resetSnapshotState" />
<wadl:method href="#forceshare-deleteSnapshot" />
</wadl:resource>
</wadl:resources>
</section>
<section xml:id="share-share-networks">
<title>Share networks</title>
<para>
A share network stores network information that share servers can
use where shares are hosted. You can associate a share with a
single share network. When you create a share, you can
optionally specify the ID of a share network through which
instances can access the share.
</para>
<para>
You can create, update, view, and delete a share network.
</para>
<para>
When you create a share network, you can specify only one type of network:
</para>
<itemizedlist>
<listitem>
<para>Neutron network. Specify a network ID and subnet ID.
</para>
</listitem>
<listitem>
<para>Nova network. Specify a network ID.
</para>
</listitem>
</itemizedlist>
<para>
For more information about supported plug-ins for share networks, see <link
xlink:type="simple" xlink:href="http://docs.openstack.org/developer/manila/adminref/network_plugins.html">Manila
Network Plugins</link>.
</para>
<para>
A share network has these attributes:
</para>
<itemizedlist role="compact">
<listitem>
<para>
The IP block in Classless Inter-Domain Routing (CIDR)
notation from which to allocate the network.
</para>
</listitem>
<listitem>
<para>
The IP version of the network.
</para>
</listitem>
<listitem>
<para>
The network type, which is <code>vlan</code>,
<code>vxlan</code>, <code>gre</code>,
<code>flat</code>, or <code>local</code>.
</para>
</listitem>
<listitem>
<para>
If the network uses segmentation, a segmentation
identifier. For example, VLAN, VXLAN, and GRE networks use
segmentation.
</para>
</listitem>
</itemizedlist>
<wadl:resources xmlns:wadl="http://wadl.dev.java.net/2009/02">
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#share-networks">
<wadl:method href="#createShareNetwork"/>
<wadl:method href="#getShareNetworks"/>
</wadl:resource>
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#detail-share-network">
<wadl:method href="#getShareNetworksDetails"/>
</wadl:resource>
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#share_network_id">
<wadl:method href="#getShareNetwork"/>
<wadl:method href="#updateShareNetwork"/>
<wadl:method href="#deleteShareNetwork"/>
</wadl:resource>
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#share-network-action">
<wadl:method href="#addSecurityService"/>
<wadl:method href="#removeSecurityService"/>
</wadl:resource>
</wadl:resources>
</section>
<section xml:id="share-security-services">
<title>Security services</title>
<para>
You can create, update, view, and delete a security service. A
security service stores configuration information for clients for
authentication and authorization (AuthN/AuthZ). For example, a
share server will be the client for an existing service such as
LDAP, Kerberos, or Microsoft Active Directory.
</para>
<para>
You can associate a share with from one to three security service
types:
</para>
<itemizedlist>
<listitem>
<para><code>ldap</code>. LDAP.
</para>
</listitem>
<listitem>
<para>
<code>kerberos</code>. Kerberos.
</para>
</listitem>
<listitem>
<para>
<code>active_directory</code>. Microsoft Active Directory.
</para>
</listitem>
</itemizedlist>
<para>
You can configure a security service with these options:
</para>
<itemizedlist>
<listitem>
<para>A DNS IP address.</para>
</listitem>
<listitem>
<para>An IP address or host name.</para>
</listitem>
<listitem>
<para>A domain.</para>
</listitem>
<listitem>
<para>A user or group name.
</para>
</listitem>
<listitem>
<para>The password for the user, if you specify a user name.</para>
</listitem>
</itemizedlist>
<wadl:resources xmlns:wadl="http://wadl.dev.java.net/2009/02">
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#security-services">
<wadl:method href="#createSecurityService"/>
<wadl:method href="#getSecurityServices"/>
</wadl:resource>
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#detail-security-service">
<wadl:method href="#getSecurityServicesDetails"/>
</wadl:resource>
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#security_service_id">
<wadl:method href="#getSecurityService"/>
<wadl:method href="#updateSecurityService"/>
<wadl:method href="#deleteSecurityService"/>
</wadl:resource>
</wadl:resources>
</section>
<section xml:id="share-share-servers">
<title>Share servers</title>
<para>
A share server is created by multi-tenant back-end drivers where
shares are hosted. For example, with the <code>generic</code>
driver, shares are hosted on Compute VMs. With the
<code>cluster_mode</code> driver from NetApp, shares are hosted on
virtual storage servers, also known as Vservers or SVMs.
</para>
<para>
Administrators can perform read and delete actions for share
servers. An administrator can delete an active share server only
if it contains no dependent shares.
</para>
<para>
An administrator can use the <code>policy.json</code> file to
grant permissions for share server actions to other roles.
</para>
<para>
The status of a share server indicates its current state. After
you successfully set up a share server, its status is
<code>active</code>. If errors occur during set up such as when
server data is not valid, its status is <code>error</code>.
</para>
<para>
The possible share servers statuses are:
</para>
<table rules="all" frame="border">
<caption>Share statuses</caption>
<col width="30%"/>
<col width="70%"/>
<thead>
<tr>
<th>Status</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>
<para><code>active</code></para>
</td>
<td>
<para>Share server was successfully set up.</para>
</td>
</tr>
<tr>
<td>
<para><code>error</code></para>
</td>
<td>
<para>The set up or deletion of the share server failed.
</para>
</td>
</tr>
<tr>
<td>
<para><code>deleting</code></para>
</td>
<td>
<para>The share server has no dependent shares and is being
deleted.</para>
</td>
</tr>
<tr>
<td>
<para><code>creating</code></para>
</td>
<td>
<para>The share server is being created on the back end with data
from the database.
</para>
</td>
</tr>
</tbody>
</table>
<para></para>
<wadl:resources xmlns:wadl="http://wadl.dev.java.net/2009/02">
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#share-servers">
<wadl:method href="#getShareServers"/>
</wadl:resource>
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#share_server_id">
<wadl:method href="#getShareServer"/>
</wadl:resource>
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#detail-share-server">
<wadl:method href="#getShareServerDetails"/>
</wadl:resource>
</wadl:resources>
</section>
<section xml:id="share-share-instances">
<title>Share instances (since API v2.3)</title>
<para>
Administrators can list, show information for, explicitly
set the state of, and force-delete share instances. Use the
<code>policy.json</code> file to grant permissions for these
actions to other roles.
</para>
<wadl:resources xmlns:wadl="http://wadl.dev.java.net/2009/02">
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#share-instances">
<wadl:method href="#getShareInstances"/>
</wadl:resource>
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#share_instance_id">
<wadl:method href="#getShareInstance"/>
</wadl:resource>
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#share-instances-action">
<wadl:method href="#resetShareInstanceState"/>
<wadl:method href="#force-deleteShareInstance"/>
</wadl:resource>
</wadl:resources>
</section>
<section xml:id="share-type">
<title>Share types</title>
<para>
A share type enables you to filter or choose back ends before you
create a share. A share type behaves in the same way as a Block
Storage volume type behaves.
</para>
<para>
You set a share type to private or public and manage the access to
the private share types.
</para>
<para>
When you issue a create a share type request, you can submit a
request body with either a <code>share_type</code> or
<code>volume_type</code> object. The use of the
<code>volume_type</code> object is deprecated but supported. It is
recommended that you use the <code>share_type</code> object when
you create a share type.
</para>
<para>
No matter which object type you include in the request, the API
creates both a <code>volume_type</code> object and a
<code>share_type</code> object. Both objects have the same ID.
When you issue a list share types request, the response shows both
<code>share_types</code> and <code>volume_types</code> objects.
</para>
<para>You can set share types as either public or private. By default
a share type is created as publicly accessible. Set
<code>os-share-type-access:is_public</code> to <code>False</code>
to make the share type private.
</para>
<para>
You can manage the access to the private share types for the
different projects. You can add access, remove access, and get
information about access for a specified private share type.
</para>
<para>
Administrators can create share types with these extra
specifications that are used to filter back ends:
</para>
<itemizedlist>
<listitem>
<para>
<code>driver_handles_share_servers</code>. Required.
Defines the driver mode for share server, or storage, life cycle management. The
Shared File Systems service creates a share server for the export of shares.
</para>
<para>
Set to <code>True</code> when the share driver manages, or handles,
the share server life cycle.
</para>
<para>
Set to <code>False</code> when an administrator rather than a
share driver manages the storage life cycle.
</para>
</listitem>
<listitem>
<para>
<code>snapshot_support</code>. Filters back ends by
whether they do or do not support share snapshots.
</para>
<para>
Set to <code>True</code> to find back ends that support share snapshots.
</para>
<para>
Set to <code>False</code> to find back ends that do not support share
snapshots.
</para>
</listitem>
</itemizedlist>
<para>
Administrators can also set additional extra specifications for a
share type for the following purposes:
</para>
<itemizedlist>
<listitem>
<para>
Filter back ends. Specify these unqualified extra
specifications in this format:
<code>extra_spec=value</code>. For example,
<code>netapp_raid_type=raid4</code>.
</para>
</listitem>
<listitem>
<para>
Set data for the driver. Except for the special
<code>capabilities</code> prefix, you specify these
qualified extra specifications with its prefix followed by
a colon: <code>vendor:extra_spec=value</code>. For
example, <code>netapp:thin_provisioned=true</code>.
</para>
</listitem>
</itemizedlist>
<para>
The scheduler uses the special <code>capabilities</code> prefix
for filtering. The scheduler can only create a share on a back end
that reports capabilities that match the un-scoped extra-spec keys
for the share type. For details, see <link
xlink:type="simple" xlink:href="http://docs.openstack.org/developer/manila/devref/capabilities_and_extra_specs.html">Capabilities and Extra-Specs</link>.
</para>
<para>
Each driver implementation determines which extra specification
keys it uses. For details, see the documentation for the driver.
</para>
<para>
An administrator can use the <code>policy.json</code> file to
grant permissions for share type creation with extra
specifications to other roles.
</para>
<wadl:resources xmlns:wadl="http://wadl.dev.java.net/2009/02">
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#share-type">
<wadl:method href="#share-createShareType"/>
<wadl:method href="#share-getShareTypes"/>
</wadl:resource>
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#default-share-type">
<wadl:method href="#getDefaultShareTypes"/>
</wadl:resource>
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#share_type_id">
<wadl:method href="#share-deleteShareType"/>
</wadl:resource>
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#share-type-action">
<wadl:method href="#addShareTypeAccess"/>
<wadl:method href="#removeShareTypeAccess"/>
</wadl:resource>
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#os-share-type-access">
<wadl:method href="#listShareTypeAccess"/>
</wadl:resource>
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#extra-specs-share-type">
<wadl:method href="#getExtraSpecsShareType"/>
<wadl:method href="#setExtraSpecShareType"/>
</wadl:resource>
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#extra-spec-key">
<wadl:method href="#unsetExtraSpecShareType"/>
</wadl:resource>
</wadl:resources>
</section>
<section xml:id="pools">
<title>Back-end storage pools</title>
<para>
An administrator can list all back-end storage pools that are
known to the scheduler service.
</para>
<wadl:resources xmlns:wadl="http://wadl.dev.java.net/2009/02">
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#pools">
<wadl:method href="#getPools"/>
</wadl:resource>
<wadl:resource href="../wadls/share-api/src/v2/os-share-v2.wadl#detail-pools">
<wadl:method href="#getPoolsDetails"/>
</wadl:resource>
</wadl:resources>
</section>
</chapter>

View File

@ -92,6 +92,14 @@
<para><link xlink:type="simple" xlink:href="api-ref-orchestration-v1.html"
>Orchestration API v1 (CURRENT)</link></para>
</listitem>
<listitem>
<para><link xlink:type="simple" xlink:href="api-ref-share-v2.html"
>Shared File Systems API v2 (CURRENT)</link></para>
</listitem>
<listitem>
<para><link xlink:type="simple" xlink:href="api-ref-share-v1.html"
>Shared File Systems API v1 (SUPPORTED)</link></para>
</listitem>
<listitem>
<para><link xlink:type="simple" xlink:href="api-ref-telemetry-v2.html">Telemetry
API v2 (CURRENT)</link></para>

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,7 @@
{
"cgsnapshot": {
"consistency_group_id": "9397c191-8427-4661-a2e8-b23820dc01d4",
"name": "snapshot_cg1",
"description": "Snapshot of cg1"
}
}

View File

@ -0,0 +1,21 @@
{
"cgsnapshot": {
"status": "creating",
"name": "snapshot_cg1",
"links": [
{
"href": "http://172.18.198.54:8786/v2/16e1ab15c35a457e9c2b2aa189f544e1/cgsnapshot/b44c894d-4bec-47aa-b389-cc8c6f0044a5",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/cgsnapshot/b44c894d-4bec-47aa-b389-cc8c6f0044a5",
"rel": "bookmark"
}
],
"created_at": "2015-09-16T17:34:06.031997",
"consistency_group_id": "9397c191-8427-4661-a2e8-b23820dc01d4",
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"id": "b44c894d-4bec-47aa-b389-cc8c6f0044a5",
"description": "Snapshot of cg1"
}
}

View File

@ -0,0 +1,3 @@
{
"os-force_delete": null
}

View File

@ -0,0 +1,42 @@
{
"cgsnapshots": [
{
"status": "available",
"name": "snapshot_CG2",
"links": [
{
"href": "http://172.18.198.54:8786/v2/16e1ab15c35a457e9c2b2aa189f544e1/cgsnapshot/7e5c3ca7-d54b-438d-9a9c-c65ece6bc6c6",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/cgsnapshot/7e5c3ca7-d54b-438d-9a9c-c65ece6bc6c6",
"rel": "bookmark"
}
],
"created_at": "2015-09-16T17:37:40.000000",
"consistency_group_id": "2d5c2600-ae67-4dff-b13c-a1c20b335e8e",
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"id": "7e5c3ca7-d54b-438d-9a9c-c65ece6bc6c6",
"description": "Snapshot of CG2"
},
{
"status": "available",
"name": "snapshot_cg1",
"links": [
{
"href": "http://172.18.198.54:8786/v2/16e1ab15c35a457e9c2b2aa189f544e1/cgsnapshot/b44c894d-4bec-47aa-b389-cc8c6f0044a5",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/cgsnapshot/b44c894d-4bec-47aa-b389-cc8c6f0044a5",
"rel": "bookmark"
}
],
"created_at": "2015-09-16T17:34:15.000000",
"consistency_group_id": "9397c191-8427-4661-a2e8-b23820dc01d4",
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"id": "b44c894d-4bec-47aa-b389-cc8c6f0044a5",
"description": "Snapshot of cg1"
}
]
}

View File

@ -0,0 +1,24 @@
{
"cgsnapshot_members": [
{
"share_type_id": "be27425c-f807-4500-a056-d00721db45cf",
"share_id": "609e4924-f062-45e0-928d-7b739348c4d6",
"created_at": "2015-09-16T17:34:15.000000",
"cgsnapshot_id": "b44c894d-4bec-47aa-b389-cc8c6f0044a5",
"share_protocol": "NFS",
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"id": "84098fde-40ec-4c96-a908-bc532c52b3af",
"size": 1
},
{
"share_type_id": "be27425c-f807-4500-a056-d00721db45cf",
"share_id": "c4a2ced4-2c9f-4ae1-adaa-6171833e64df",
"created_at": "2015-09-16T17:34:15.000000",
"cgsnapshot_id": "b44c894d-4bec-47aa-b389-cc8c6f0044a5",
"share_protocol": "NFS",
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"id": "db492d38-dd3a-4d6b-a3b6-e65377990892",
"size": 1
}
]
}

View File

@ -0,0 +1,32 @@
{
"cgsnapshots": [
{
"id": "7e5c3ca7-d54b-438d-9a9c-c65ece6bc6c6",
"links": [
{
"href": "http://172.18.198.54:8786/v2/16e1ab15c35a457e9c2b2aa189f544e1/cgsnapshot/7e5c3ca7-d54b-438d-9a9c-c65ece6bc6c6",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/cgsnapshot/7e5c3ca7-d54b-438d-9a9c-c65ece6bc6c6",
"rel": "bookmark"
}
],
"name": "snapshot_CG2"
},
{
"id": "b44c894d-4bec-47aa-b389-cc8c6f0044a5",
"links": [
{
"href": "http://172.18.198.54:8786/v2/16e1ab15c35a457e9c2b2aa189f544e1/cgsnapshot/b44c894d-4bec-47aa-b389-cc8c6f0044a5",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/cgsnapshot/b44c894d-4bec-47aa-b389-cc8c6f0044a5",
"rel": "bookmark"
}
],
"name": "snapshot_cg1"
}
]
}

View File

@ -0,0 +1,5 @@
{
"os-reset_status": {
"status": "error"
}
}

View File

@ -0,0 +1,21 @@
{
"cgsnapshot": {
"status": "available",
"name": "snapshot_cg1",
"links": [
{
"href": "http://172.18.198.54:8786/v2/16e1ab15c35a457e9c2b2aa189f544e1/cgsnapshot/b44c894d-4bec-47aa-b389-cc8c6f0044a5",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/cgsnapshot/b44c894d-4bec-47aa-b389-cc8c6f0044a5",
"rel": "bookmark"
}
],
"created_at": "2015-09-16T17:34:15.000000",
"consistency_group_id": "9397c191-8427-4661-a2e8-b23820dc01d4",
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"id": "b44c894d-4bec-47aa-b389-cc8c6f0044a5",
"description": "Snapshot of cg1"
}
}

View File

@ -0,0 +1,5 @@
{
"cgsnapshot": {
"description": "Changed description: there is a snapshot of CG2"
}
}

View File

@ -0,0 +1,21 @@
{
"cgsnapshot": {
"status": "available",
"name": "snapshot_CG2",
"links": [
{
"href": "http://172.18.198.54:8786/v2/16e1ab15c35a457e9c2b2aa189f544e1/cgsnapshot/7e5c3ca7-d54b-438d-9a9c-c65ece6bc6c6",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/cgsnapshot/7e5c3ca7-d54b-438d-9a9c-c65ece6bc6c6",
"rel": "bookmark"
}
],
"created_at": "2015-09-16T17:37:40.000000",
"consistency_group_id": "2d5c2600-ae67-4dff-b13c-a1c20b335e8e",
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"id": "7e5c3ca7-d54b-438d-9a9c-c65ece6bc6c6",
"description": "Changed description: there is a snapshot of CG2"
}
}

View File

@ -0,0 +1,10 @@
{
"consistency_group": {
"share_types": [
"d2ad4f9d-cae3-4660-b0b6-58c06b385203"
],
"name": "my-cg1",
"share_network_id": "d8ae6799-2567-4a89-aafb-fa4424350d2b",
"description": "my first consistency group"
}
}

View File

@ -0,0 +1,26 @@
{
"consistency_group": {
"status": "creating",
"description": "my first consistency group",
"links": [
{
"href": "http://172.18.198.54:8786/v2/16e1ab15c35a457e9c2b2aa189f544e1/consistency_groups/6f519a48-3183-46cf-a32f-41815f813986",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/consistency_groups/6f519a48-3183-46cf-a32f-41815f813986",
"rel": "bookmark"
}
],
"source_cgsnapshot_id": null,
"created_at": "2015-09-16T09:28:52.880949",
"share_network_id": "d8ae6799-2567-4a89-aafb-fa4424350d2b",
"host": null,
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"share_types": [
"d2ad4f9d-cae3-4660-b0b6-58c06b385203"
],
"id": "6f519a48-3183-46cf-a32f-41815f813986",
"name": "my-cg1"
}
}

View File

@ -0,0 +1,3 @@
{
"os-force_delete": null
}

View File

@ -0,0 +1,52 @@
{
"consistency_groups": [
{
"status": "available",
"description": "my first consistency group",
"links": [
{
"href": "http://172.18.198.54:8786/v2/16e1ab15c35a457e9c2b2aa189f544e1/consistency_groups/6f519a48-3183-46cf-a32f-41815f813986",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/consistency_groups/6f519a48-3183-46cf-a32f-41815f813986",
"rel": "bookmark"
}
],
"source_cgsnapshot_id": null,
"created_at": "2015-09-16T09:28:52.000000",
"share_network_id": "d8ae6799-2567-4a89-aafb-fa4424350d2b",
"host": null,
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"share_types": [
"d2ad4f9d-cae3-4660-b0b6-58c06b385203"
],
"id": "6f519a48-3183-46cf-a32f-41815f813986",
"name": "my-cg1"
},
{
"status": "error",
"description": "Edited description",
"links": [
{
"href": "http://172.18.198.54:8786/v2/16e1ab15c35a457e9c2b2aa189f544e1/consistency_groups/aed36625-a6d7-4681-ba59-c7ba3d18c148",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/consistency_groups/aed36625-a6d7-4681-ba59-c7ba3d18c148",
"rel": "bookmark"
}
],
"source_cgsnapshot_id": null,
"created_at": "2015-09-16T09:31:15.000000",
"share_network_id": "713df749-aac0-4a54-af52-10f6c991e80c",
"host": null,
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"share_types": [
"be27425c-f807-4500-a056-d00721db45cf"
],
"id": "aed36625-a6d7-4681-ba59-c7ba3d18c148",
"name": "my-cg2"
}
]
}

View File

@ -0,0 +1,32 @@
{
"consistency_groups": [
{
"id": "6f519a48-3183-46cf-a32f-41815f813986",
"links": [
{
"href": "http://172.18.198.54:8786/v2/16e1ab15c35a457e9c2b2aa189f544e1/consistency_groups/6f519a48-3183-46cf-a32f-41815f813986",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/consistency_groups/6f519a48-3183-46cf-a32f-41815f813986",
"rel": "bookmark"
}
],
"name": "my-cg1"
},
{
"id": "aed36625-a6d7-4681-ba59-c7ba3d18c148",
"links": [
{
"href": "http://172.18.198.54:8786/v2/16e1ab15c35a457e9c2b2aa189f544e1/consistency_groups/aed36625-a6d7-4681-ba59-c7ba3d18c148",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/consistency_groups/aed36625-a6d7-4681-ba59-c7ba3d18c148",
"rel": "bookmark"
}
],
"name": "my-cg2"
}
]
}

View File

@ -0,0 +1,5 @@
{
"os-reset_status": {
"status": "available"
}
}

View File

@ -0,0 +1,27 @@
{
"consistency_group": {
"status": "available",
"description": "My first CG.",
"links": [
{
"href": "http://172.18.198.54:8786/v2/16e1ab15c35a457e9c2b2aa189f544e1/consistency_groups/9397c191-8427-4661-a2e8-b23820dc01d4",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/consistency_groups/9397c191-8427-4661-a2e8-b23820dc01d4",
"rel": "bookmark"
}
],
"source_cgsnapshot_id": null,
"created_at": "2015-09-16T16:50:31.000000",
"share_network_id": "f9b2e754-ac01-4466-86e1-5c569424754e",
"share_server_id": null,
"host": "manila2@generic1#GENERIC1",
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"share_types": [
"be27425c-f807-4500-a056-d00721db45cf"
],
"id": "9397c191-8427-4661-a2e8-b23820dc01d4",
"name": "cg1"
}
}

View File

@ -0,0 +1,5 @@
{
"consistency_group": {
"description": "Edited description"
}
}

View File

@ -0,0 +1,26 @@
{
"consistency_group": {
"status": "error",
"description": "Edited description",
"links": [
{
"href": "http://172.18.198.54:8786/v2/16e1ab15c35a457e9c2b2aa189f544e1/consistency_groups/aed36625-a6d7-4681-ba59-c7ba3d18c148",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/consistency_groups/aed36625-a6d7-4681-ba59-c7ba3d18c148",
"rel": "bookmark"
}
],
"source_cgsnapshot_id": null,
"created_at": "2015-09-16T09:31:15.000000",
"share_network_id": "713df749-aac0-4a54-af52-10f6c991e80c",
"host": null,
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"share_types": [
"be27425c-f807-4500-a056-d00721db45cf"
],
"id": "aed36625-a6d7-4681-ba59-c7ba3d18c148",
"name": "my-cg2"
}
}

View File

@ -0,0 +1,102 @@
{
"extensions": [
{
"alias": "os-extended-quotas",
"updated": "2013-06-09T00:00:00+00:00",
"name": "ExtendedQuotas",
"links": [],
"description": "Extend quotas. Adds ability for admins to delete quota and optionally force the update Quota command."
},
{
"alias": "os-quota-sets",
"updated": "2011-08-08T00:00:00+00:00",
"name": "Quotas",
"links": [],
"description": "Quotas management support."
},
{
"alias": "os-quota-class-sets",
"updated": "2012-03-12T00:00:00+00:00",
"name": "QuotaClasses",
"links": [],
"description": "Quota classes management support."
},
{
"alias": "os-share-unmanage",
"updated": "2015-02-17T00:00:00+00:00",
"name": "ShareUnmanage",
"links": [],
"description": "Enable share unmanage operation."
},
{
"alias": "os-types-manage",
"updated": "2011-08-24T00:00:00+00:00",
"name": "TypesManage",
"links": [],
"description": "Types manage support."
},
{
"alias": "share-actions",
"updated": "2012-08-14T00:00:00+00:00",
"name": "ShareActions",
"links": [],
"description": "Enable share actions."
},
{
"alias": "os-availability-zone",
"updated": "2015-07-28T00:00:00+00:00",
"name": "AvailabilityZones",
"links": [],
"description": "Describe Availability Zones."
},
{
"alias": "os-user-quotas",
"updated": "2013-07-18T00:00:00+00:00",
"name": "UserQuotas",
"links": [],
"description": "Project user quota support."
},
{
"alias": "os-share-type-access",
"updated": "2015-03-02T00:00:00Z",
"name": "ShareTypeAccess",
"links": [],
"description": "share type access support."
},
{
"alias": "os-types-extra-specs",
"updated": "2011-08-24T00:00:00+00:00",
"name": "TypesExtraSpecs",
"links": [],
"description": "Type extra specs support."
},
{
"alias": "os-admin-actions",
"updated": "2015-08-03T00:00:00+00:00",
"name": "AdminActions",
"links": [],
"description": "Enable admin actions."
},
{
"alias": "os-used-limits",
"updated": "2014-03-27T00:00:00+00:00",
"name": "UsedLimits",
"links": [],
"description": "Provide data on limited resources that are being used."
},
{
"alias": "os-services",
"updated": "2012-10-28T00:00:00-00:00",
"name": "Services",
"links": [],
"description": "Services support."
},
{
"alias": "os-share-manage",
"updated": "2015-02-17T00:00:00+00:00",
"name": "ShareManage",
"links": [],
"description": "Allows existing share to be 'managed' by Manila."
}
]
}

View File

@ -0,0 +1,17 @@
{
"limits": {
"rate": [],
"absolute": {
"totalShareNetworksUsed": 0,
"maxTotalShareGigabytes": 1000,
"maxTotalShareNetworks": 10,
"totalSharesUsed": 0,
"totalShareGigabytesUsed": 0,
"totalShareSnapshotsUsed": 0,
"maxTotalShares": 50,
"totalSnapshotGigabytesUsed": 0,
"maxTotalSnapshotGigabytes": 1000,
"maxTotalShareSnapshots": 50
}
}
}

View File

@ -0,0 +1,29 @@
{
"pools": [
{
"pool": "LONDON",
"host": "nosb-devstack",
"name": "nosb-devstack@london#LONDON",
"capabilities": {
"QoS_support": false,
"consistency_group_support": "pool",
"timestamp": "2015-09-21T08:58:56.190856",
"share_backend_name": "LONDON",
"server_pools_mapping": {
"1320689d-80f4-49f6-8a70-0e2c1ed8ad90": [],
"3a4caac5-0880-4629-a334-6cdda88a0c0e": []
},
"driver_handles_share_servers": true,
"driver_version": "1.0",
"total_capacity_gb": "unknown",
"reserved_percentage": 0,
"pools": null,
"vendor_name": "Open Source",
"snapshot_support": true,
"free_capacity_gb": "unknown",
"storage_protocol": "NFS_CIFS"
},
"backend": "london"
}
]
}

View File

@ -0,0 +1,22 @@
{
"pools": [
{
"host": "manila2",
"name": "manila2@generic1#GENERIC1",
"pool": "GENERIC1",
"backend": "generic1"
},
{
"host": "manila2",
"name": "manila2@unmanage1#UNMANAGE1",
"pool": "UNMANAGE1",
"backend": "unmanage1"
},
{
"host": "manila2",
"name": "manila2@ams_backend#AMS_BACKEND",
"pool": "AMS_BACKEND",
"backend": "ams_backend"
}
]
}

View File

@ -0,0 +1,10 @@
{
"security_service": {
"description": "Creating my first Security Service",
"dns_ip": "10.0.0.0/24",
"user": "demo",
"password": "***",
"type": "kerberos",
"name": "SecServ1"
}
}

View File

@ -0,0 +1,17 @@
{
"security_service": {
"status": "new",
"domain": null,
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"name": "SecServ1",
"created_at": "2015-09-07T12:19:10.695211",
"updated_at": null,
"server": null,
"dns_ip": "10.0.0.0/24",
"user": "demo",
"password": "supersecret",
"type": "kerberos",
"id": "3c829734-0679-4c17-9637-801da48c0d5f",
"description": "Creating my first Security Service"
}
}

View File

@ -0,0 +1,36 @@
{
"security_services": [
{
"status": "new",
"domain": null,
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"name": "SecServ1",
"created_at": "2015-09-07T12:19:10.000000",
"description": "Creating my first Security Service",
"updated_at": null,
"server": null,
"dns_ip": "10.0.0.0/24",
"user": "demo",
"password": "supersecret",
"type": "kerberos",
"id": "3c829734-0679-4c17-9637-801da48c0d5f",
"share_networks": []
},
{
"status": "new",
"domain": null,
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"name": "SecServ2",
"created_at": "2015-09-07T12:25:03.000000",
"description": "Creating my second Security Service",
"updated_at": null,
"server": null,
"dns_ip": "10.0.0.0/24",
"user": null,
"password": null,
"type": "ldap",
"id": "5a1d3a12-34a7-4087-8983-50e9ed03509a",
"share_networks": []
}
]
}

View File

@ -0,0 +1,40 @@
{
"security_services": [
{
"status": "new",
"domain": null,
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"name": "SecServ1",
"created_at": "2015-09-07T12:19:10.000000",
"description": "Creating my first Security Service",
"updated_at": null,
"server": null,
"dns_ip": "10.0.0.0/24",
"user": "demo",
"password": "supersecret",
"type": "kerberos",
"id": "3c829734-0679-4c17-9637-801da48c0d5f",
"share_networks": [
"d8ae6799-2567-4a89-aafb-fa4424350d2b"
]
},
{
"status": "new",
"domain": null,
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"name": "SecServ2",
"created_at": "2015-09-07T12:25:03.000000",
"description": "Creating my second Security Service",
"updated_at": null,
"server": null,
"dns_ip": "10.0.0.0/24",
"user": null,
"password": null,
"type": "ldap",
"id": "5a1d3a12-34a7-4087-8983-50e9ed03509a",
"share_networks": [
"d8ae6799-2567-4a89-aafb-fa4424350d2b"
]
}
]
}

View File

@ -0,0 +1,16 @@
{
"security_services": [
{
"status": "new",
"type": "kerberos",
"id": "3c829734-0679-4c17-9637-801da48c0d5f",
"name": "SecServ1"
},
{
"status": "new",
"type": "ldap",
"id": "5a1d3a12-34a7-4087-8983-50e9ed03509a",
"name": "SecServ2"
}
]
}

View File

@ -0,0 +1,17 @@
{
"security_service": {
"status": "new",
"domain": null,
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"name": "SecServ1",
"created_at": "2015-09-07T12:19:10.000000",
"updated_at": null,
"server": null,
"dns_ip": "10.0.0.0/24",
"user": "demo",
"password": "supersecret",
"type": "kerberos",
"id": "3c829734-0679-4c17-9637-801da48c0d5f",
"description": "Creating my first Security Service"
}
}

View File

@ -0,0 +1,8 @@
{
"security_service": {
"domain": "my_domain",
"password": "***",
"user": "new_user",
"description": "Adding a description"
}
}

View File

@ -0,0 +1,17 @@
{
"security_service": {
"status": "new",
"domain": "my_domain",
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"name": "SecServ1",
"created_at": "2015-09-07T12:19:10.000000",
"updated_at": "2015-09-07T12:47:21.858737",
"server": null,
"dns_ip": "10.0.0.0/24",
"user": "new_user",
"password": "pass",
"type": "kerberos",
"id": "3c829734-0679-4c17-9637-801da48c0d5f",
"description": "Adding a description"
}
}

View File

@ -0,0 +1,22 @@
{
"services": [
{
"status": "enabled",
"binary": "manila-share",
"zone": "nova",
"host": "manila2@generic1",
"updated_at": "2015-09-07T13:03:57.000000",
"state": "up",
"id": 1
},
{
"status": "enabled",
"binary": "manila-scheduler",
"zone": "nova",
"host": "manila2",
"updated_at": "2015-09-07T13:03:57.000000",
"state": "up",
"id": 2
}
]
}

View File

@ -0,0 +1,13 @@
{
"services": [
{
"status": "enabled",
"binary": "manila-share",
"zone": "nova",
"host": "manila2@generic1",
"updated_at": "2015-09-07T13:14:27.000000",
"state": "up",
"id": 1
}
]
}

View File

@ -0,0 +1,7 @@
{
"os-allow_access": {
"access_level": "rw",
"access_type": "ip",
"access_to": "0.0.0.0/0"
}
}

View File

@ -0,0 +1,11 @@
{
"access": {
"share_id": "406ea93b-32e9-4907-a117-148b3945749f",
"created_at": "2015-09-07T09:14:48.000000",
"updated_at": null,
"access_type": "ip",
"access_to": "0.0.0.0/0",
"access_level": "rw",
"id": "a25b2df3-90bd-4add-afa6-5f0dbbd50452"
}
}

View File

@ -0,0 +1,5 @@
{
"os-deny_access": {
"access_id": "a25b2df3-90bd-4add-afa6-5f0dbbd50452"
}
}

View File

@ -0,0 +1,5 @@
{
"os-extend": {
"new_size": 2
}
}

View File

@ -0,0 +1,3 @@
{
"os-force_delete": null
}

View File

@ -0,0 +1,3 @@
{
"os-access_list": null
}

View File

@ -0,0 +1,18 @@
{
"access_list": [
{
"access_level": "rw",
"state": "error",
"id": "507bf114-36f2-4f56-8cf4-857985ca87c1",
"access_type": "cert",
"access_to": "example.com"
},
{
"access_level": "rw",
"state": "active",
"id": "a25b2df3-90bd-4add-afa6-5f0dbbd50452",
"access_type": "ip",
"access_to": "0.0.0.0/0"
}
]
}

View File

@ -0,0 +1,6 @@
{
"os-migrate_share": {
"force_host_copy": false,
"host": "manila2@ams_backend#AMS_BACKEND"
}
}

View File

@ -0,0 +1,5 @@
{
"os-reset_status": {
"status": "error"
}
}

View File

@ -0,0 +1,5 @@
{
"os-shrink": {
"new_size": 1
}
}

View File

@ -0,0 +1,17 @@
{
"share": {
"description": "My custom share London",
"share_type": null,
"share_proto": "nfs",
"share_network_id": "713df749-aac0-4a54-af52-10f6c991e80c",
"name": "share_London",
"consistency_group_id": "9397c191-8427-4661-a2e8-b23820dc01d4",
"snapshot_id": null,
"is_public": true,
"size": 1,
"metadata": {
"project": "my_app",
"aim": "doc"
}
}
}

View File

@ -0,0 +1,41 @@
{
"share": {
"status": null,
"share_server_id": null,
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"name": "share_London",
"share_type": "25747776-08e5-494f-ab40-a64b9d20d8f7",
"share_type_name": "default",
"availability_zone": null,
"created_at": "2015-09-18T10:25:24.533287",
"export_location": null,
"links": [
{
"href": "http://172.18.198.54:8786/v1/16e1ab15c35a457e9c2b2aa189f544e1/shares/011d21e2-fbc3-4e4a-9993-9ea223f73264",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/shares/011d21e2-fbc3-4e4a-9993-9ea223f73264",
"rel": "bookmark"
}
],
"share_network_id": null,
"export_locations": [],
"share_proto": "NFS",
"host": null,
"task_state": null,
"snapshot_support": true,
"consistency_group_id": "9397c191-8427-4661-a2e8-b23820dc01d4",
"source_cgsnapshot_member_id": null,
"volume_type": "default",
"snapshot_id": null,
"is_public": true,
"metadata": {
"project": "my_app",
"aim": "doc"
},
"id": "011d21e2-fbc3-4e4a-9993-9ea223f73264",
"size": 1,
"description": "My custom share London"
}
}

View File

@ -0,0 +1,3 @@
{
"os-force_delete": null
}

View File

@ -0,0 +1,5 @@
{
"os-reset_status": {
"status": "available"
}
}

View File

@ -0,0 +1,32 @@
{
"share_instances": [
{
"status": "error",
"share_id": "406ea93b-32e9-4907-a117-148b3945749f",
"availability_zone": "nova",
"created_at": "2015-09-07T08:41:20.000000",
"export_location": "10.254.0.3:/shares/share-081f7030-c54f-42f5-98ee-93a37393e0f2",
"share_network_id": "713df749-aac0-4a54-af52-10f6c991e80c",
"export_locations": [
"10.254.0.3:/shares/share-081f7030-c54f-42f5-98ee-93a37393e0f2"
],
"share_server_id": "ba11930a-bf1a-4aa7-bae4-a8dfbaa3cc73",
"host": "manila2@generic1#GENERIC1",
"id": "081f7030-c54f-42f5-98ee-93a37393e0f2"
},
{
"status": "available",
"share_id": "d94a8548-2079-4be0-b21c-0a887acd31ca",
"availability_zone": "nova",
"created_at": "2015-09-07T08:51:34.000000",
"export_location": "10.254.0.3:/shares/share-75559a8b-c90c-42a7-bda2-edbe86acfb7b",
"share_network_id": "713df749-aac0-4a54-af52-10f6c991e80c",
"export_locations": [
"10.254.0.3:/shares/share-75559a8b-c90c-42a7-bda2-edbe86acfb7b"
],
"share_server_id": "ba11930a-bf1a-4aa7-bae4-a8dfbaa3cc73",
"host": "manila2@generic1#GENERIC1",
"id": "75559a8b-c90c-42a7-bda2-edbe86acfb7b"
}
]
}

View File

@ -0,0 +1,78 @@
{
"shares": [
{
"links": [
{
"href": "http://172.18.198.54:8786/v2/16e1ab15c35a457e9c2b2aa189f544e1/shares/f45cc5b2-d1bb-4a3e-ba5b-5c4125613adc",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/shares/f45cc5b2-d1bb-4a3e-ba5b-5c4125613adc",
"rel": "bookmark"
}
],
"availability_zone": "nova",
"share_network_id": "f9b2e754-ac01-4466-86e1-5c569424754e",
"export_locations": [],
"share_server_id": "87d8943a-f5da-47a4-b2f2-ddfa6794aa82",
"snapshot_id": null,
"id": "f45cc5b2-d1bb-4a3e-ba5b-5c4125613adc",
"size": 1,
"share_type": "25747776-08e5-494f-ab40-a64b9d20d8f7",
"share_type_name": "default",
"export_location": null,
"consistency_group_id": "9397c191-8427-4661-a2e8-b23820dc01d4",
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"metadata": {},
"status": "error",
"description": "There is a share description.",
"host": "manila2@generic1#GENERIC1",
"task_state": null,
"is_public": true,
"snapshot_support": true,
"name": "my_share4",
"created_at": "2015-09-16T18:19:50.000000",
"share_proto": "NFS",
"volume_type": "default",
"source_cgsnapshot_member_id": null
},
{
"links": [
{
"href": "http://172.18.198.54:8786/v2/16e1ab15c35a457e9c2b2aa189f544e1/shares/c4a2ced4-2c9f-4ae1-adaa-6171833e64df",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/shares/c4a2ced4-2c9f-4ae1-adaa-6171833e64df",
"rel": "bookmark"
}
],
"availability_zone": "nova",
"share_network_id": "f9b2e754-ac01-4466-86e1-5c569424754e",
"export_locations": [
"10.254.0.5:/shares/share-50ad5e7b-f6f1-4b78-a651-0812cef2bb67"
],
"share_server_id": "87d8943a-f5da-47a4-b2f2-ddfa6794aa82",
"snapshot_id": null,
"id": "c4a2ced4-2c9f-4ae1-adaa-6171833e64df",
"size": 1,
"share_type": "25747776-08e5-494f-ab40-a64b9d20d8f7",
"share_type_name": "default",
"export_location": "10.254.0.5:/shares/share-50ad5e7b-f6f1-4b78-a651-0812cef2bb67",
"consistency_group_id": "9397c191-8427-4661-a2e8-b23820dc01d4",
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"metadata": {},
"status": "available",
"description": "Changed description.",
"host": "manila2@generic1#GENERIC1",
"task_state": null,
"is_public": true,
"snapshot_support": true,
"name": "my_share4",
"created_at": "2015-09-16T17:26:28.000000",
"share_proto": "NFS",
"volume_type": "default",
"source_cgsnapshot_member_id": null
}
]
}

View File

@ -0,0 +1,32 @@
{
"shares": [
{
"id": "d94a8548-2079-4be0-b21c-0a887acd31ca",
"links": [
{
"href": "http://172.18.198.54:8786/v1/16e1ab15c35a457e9c2b2aa189f544e1/shares/d94a8548-2079-4be0-b21c-0a887acd31ca",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/shares/d94a8548-2079-4be0-b21c-0a887acd31ca",
"rel": "bookmark"
}
],
"name": "My_share"
},
{
"id": "406ea93b-32e9-4907-a117-148b3945749f",
"links": [
{
"href": "http://172.18.198.54:8786/v1/16e1ab15c35a457e9c2b2aa189f544e1/shares/406ea93b-32e9-4907-a117-148b3945749f",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/shares/406ea93b-32e9-4907-a117-148b3945749f",
"rel": "bookmark"
}
],
"name": "Share1"
}
]
}

View File

@ -0,0 +1,5 @@
{
"add_security_service": {
"security_service_id": "3c829734-0679-4c17-9637-801da48c0d5f"
}
}

View File

@ -0,0 +1,17 @@
{
"share_network": {
"name": "net2",
"segmentation_id": null,
"created_at": "2015-09-07T12:31:12.000000",
"neutron_subnet_id": null,
"updated_at": null,
"id": "d8ae6799-2567-4a89-aafb-fa4424350d2b",
"neutron_net_id": null,
"ip_version": null,
"nova_net_id": "998b42ee-2cee-4d36-8b95-67b5ca1f2109",
"cidr": null,
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"network_type": null,
"description": null
}
}

View File

@ -0,0 +1,8 @@
{
"share_network": {
"neutron_net_id": "998b42ee-2cee-4d36-8b95-67b5ca1f2109",
"neutron_subnet_id": "53482b62-2c84-4a53-b6ab-30d9d9800d06",
"name": "my_network",
"description": "This is my share network"
}
}

View File

@ -0,0 +1,17 @@
{
"share_network": {
"name": "my_network",
"segmentation_id": null,
"created_at": "2015-09-07T14:37:00.583656",
"neutron_subnet_id": "53482b62-2c84-4a53-b6ab-30d9d9800d06",
"updated_at": null,
"id": "77eb3421-4549-4789-ac39-0d5185d68c29",
"neutron_net_id": "998b42ee-2cee-4d36-8b95-67b5ca1f2109",
"ip_version": null,
"nova_net_id": null,
"cidr": null,
"project_id": "e10a683c20da41248cfd5e1ab3d88c62",
"network_type": null,
"description": "This is my share network"
}
}

View File

@ -0,0 +1,49 @@
{
"share_networks": [
{
"name": "net_my1",
"segmentation_id": null,
"created_at": "2015-09-04T14:57:13.000000",
"neutron_subnet_id": "53482b62-2c84-4a53-b6ab-30d9d9800d06",
"updated_at": null,
"id": "32763294-e3d4-456a-998d-60047677c2fb",
"neutron_net_id": "998b42ee-2cee-4d36-8b95-67b5ca1f2109",
"ip_version": null,
"nova_net_id": null,
"cidr": null,
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"network_type": null,
"description": "descr"
},
{
"name": "net_my",
"segmentation_id": null,
"created_at": "2015-09-04T14:54:25.000000",
"neutron_subnet_id": "53482b62-2c84-4a53-b6ab-30d9d9800d06",
"updated_at": null,
"id": "713df749-aac0-4a54-af52-10f6c991e80c",
"neutron_net_id": "998b42ee-2cee-4d36-8b95-67b5ca1f2109",
"ip_version": null,
"nova_net_id": null,
"cidr": null,
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"network_type": null,
"description": "desecr"
},
{
"name": null,
"segmentation_id": null,
"created_at": "2015-09-04T14:51:41.000000",
"neutron_subnet_id": null,
"updated_at": null,
"id": "fa158a3d-6d9f-4187-9ca5-abbb82646eb2",
"neutron_net_id": null,
"ip_version": null,
"nova_net_id": null,
"cidr": null,
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"network_type": null,
"description": null
}
]
}

View File

@ -0,0 +1,16 @@
{
"share_networks": [
{
"id": "32763294-e3d4-456a-998d-60047677c2fb",
"name": "net_my1"
},
{
"id": "713df749-aac0-4a54-af52-10f6c991e80c",
"name": "net_my"
},
{
"id": "fa158a3d-6d9f-4187-9ca5-abbb82646eb2",
"name": null
}
]
}

View File

@ -0,0 +1,5 @@
{
"remove_security_service": {
"security_service_id": "3c829734-0679-4c17-9637-801da48c0d5f"
}
}

View File

@ -0,0 +1,17 @@
{
"share_network": {
"name": "net2",
"segmentation_id": null,
"created_at": "2015-09-07T12:31:12.000000",
"neutron_subnet_id": null,
"updated_at": null,
"id": "d8ae6799-2567-4a89-aafb-fa4424350d2b",
"neutron_net_id": null,
"ip_version": null,
"nova_net_id": "998b42ee-2cee-4d36-8b95-67b5ca1f2109",
"cidr": null,
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"network_type": null,
"description": null
}
}

View File

@ -0,0 +1,17 @@
{
"share_network": {
"name": "net_my1",
"segmentation_id": null,
"created_at": "2015-09-04T14:56:45.000000",
"neutron_subnet_id": "53482b62-2c84-4a53-b6ab-30d9d9800d06",
"updated_at": null,
"id": "7f950b52-6141-4a08-bbb5-bb7ffa3ea5fd",
"neutron_net_id": "998b42ee-2cee-4d36-8b95-67b5ca1f2109",
"ip_version": null,
"nova_net_id": null,
"cidr": null,
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"network_type": null,
"description": "descr"
}
}

View File

@ -0,0 +1,5 @@
{
"share_network": {
"description": "i'm adding a description"
}
}

View File

@ -0,0 +1,17 @@
{
"share_network": {
"name": "net_my",
"segmentation_id": null,
"created_at": "2015-09-04T14:54:25.000000",
"neutron_subnet_id": "53482b62-2c84-4a53-b6ab-30d9d9800d06",
"updated_at": "2015-09-07T08:02:53.512184",
"id": "713df749-aac0-4a54-af52-10f6c991e80c",
"neutron_net_id": "998b42ee-2cee-4d36-8b95-67b5ca1f2109",
"ip_version": "4",
"nova_net_id": null,
"cidr": null,
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"network_type": null,
"description": "i'm adding a description"
}
}

View File

@ -0,0 +1,13 @@
{
"share_servers": [
{
"status": "active",
"updated_at": "2015-09-07T08:52:15.000000",
"share_network_id": "713df749-aac0-4a54-af52-10f6c991e80c",
"host": "manila2@generic1",
"share_network_name": "net_my",
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"id": "ba11930a-bf1a-4aa7-bae4-a8dfbaa3cc73"
}
]
}

View File

@ -0,0 +1,12 @@
{
"details": {
"username": "manila",
"router_id": "4b62ce91-56c5-45c1-b0ef-8cbbe5dd34f4",
"pk_path": "/opt/stack/.ssh/id_rsa",
"subnet_id": "16e99ad6-5191-461c-9f34-ac84a39c3adb",
"ip": "10.254.0.3",
"instance_id": "75f2f282-af65-49ba-a7b1-525705b1bf1a",
"public_address": "10.254.0.3",
"service_port_id": "8ff21760-961e-4b83-a032-03fd559bb1d3"
}
}

View File

@ -0,0 +1,22 @@
{
"share_server": {
"status": "active",
"backend_details": {
"username": "manila",
"router_id": "4b62ce91-56c5-45c1-b0ef-8cbbe5dd34f4",
"pk_path": "/opt/stack/.ssh/id_rsa",
"subnet_id": "16e99ad6-5191-461c-9f34-ac84a39c3adb",
"ip": "10.254.0.3",
"instance_id": "75f2f282-af65-49ba-a7b1-525705b1bf1a",
"public_address": "10.254.0.3",
"service_port_id": "8ff21760-961e-4b83-a032-03fd559bb1d3"
},
"created_at": "2015-09-07T08:37:19.000000",
"updated_at": "2015-09-07T08:52:15.000000",
"share_network_name": "net_my",
"host": "manila2@generic1",
"share_network_id": "713df749-aac0-4a54-af52-10f6c991e80c",
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"id": "ba11930a-bf1a-4aa7-bae4-a8dfbaa3cc73"
}
}

View File

@ -0,0 +1,5 @@
{
"metadata": {
"key1": "value1"
}
}

View File

@ -0,0 +1,9 @@
{
"metadata": {
"aim": "changed_doc",
"project": "my_app",
"key1": "value1",
"new_metadata_key": "new_information",
"key": "value"
}
}

View File

@ -0,0 +1,16 @@
{
"share_instance": {
"status": "available",
"share_id": "d94a8548-2079-4be0-b21c-0a887acd31ca",
"availability_zone": "nova",
"created_at": "2015-09-07T08:51:34.000000",
"export_location": "10.254.0.3:/shares/share-75559a8b-c90c-42a7-bda2-edbe86acfb7b",
"share_network_id": "713df749-aac0-4a54-af52-10f6c991e80c",
"export_locations": [
"10.254.0.3:/shares/share-75559a8b-c90c-42a7-bda2-edbe86acfb7b"
],
"share_server_id": "ba11930a-bf1a-4aa7-bae4-a8dfbaa3cc73",
"host": "manila2@generic1#GENERIC1",
"id": "75559a8b-c90c-42a7-bda2-edbe86acfb7b"
}
}

View File

@ -0,0 +1,6 @@
{
"metadata": {
"project": "my_app",
"aim": "doc"
}
}

View File

@ -0,0 +1,41 @@
{
"share": {
"links": [
{
"href": "http://172.18.198.54:8786/v2/16e1ab15c35a457e9c2b2aa189f544e1/shares/011d21e2-fbc3-4e4a-9993-9ea223f73264",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/shares/011d21e2-fbc3-4e4a-9993-9ea223f73264",
"rel": "bookmark"
}
],
"availability_zone": "nova",
"share_network_id": "713df749-aac0-4a54-af52-10f6c991e80c",
"export_locations": [],
"share_server_id": "e268f4aa-d571-43dd-9ab3-f49ad06ffaef",
"snapshot_id": null,
"id": "011d21e2-fbc3-4e4a-9993-9ea223f73264",
"size": 1,
"share_type": "25747776-08e5-494f-ab40-a64b9d20d8f7",
"share_type_name": "default",
"export_location": null,
"consistency_group_id": "9397c191-8427-4661-a2e8-b23820dc01d4",
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"metadata": {
"project": "my_app",
"aim": "doc"
},
"status": "available",
"description": "My custom share London",
"host": "manila2@generic1#GENERIC1",
"task_state": null,
"is_public": true,
"snapshot_support": true,
"name": "share_London",
"created_at": "2015-09-18T10:25:24.000000",
"share_proto": "NFS",
"volume_type": "default",
"source_cgsnapshot_member_id": null
}
}

View File

@ -0,0 +1,5 @@
{
"addProjectAccess": {
"project": "e1284adea3ee4d2482af5ed214f3ad90"
}
}

View File

@ -0,0 +1,12 @@
{
"share_type_access": [
{
"share_type_id": "1732f284-401d-41d9-a494-425451e8b4b8",
"project_id": "818a3f48dcd644909b3fa2e45a399a27"
},
{
"share_type_id": "1732f284-401d-41d9-a494-425451e8b4b8",
"project_id": "e1284adea3ee4d2482af5ed214f3ad90"
}
]
}

View File

@ -0,0 +1,5 @@
{
"removeProjectAccess": {
"project": "818a3f48dcd644909b3fa2e45a399a27"
}
}

View File

@ -0,0 +1,10 @@
{
"volume_type": {
"os-share-type-access:is_public": true,
"extra_specs": {
"driver_handles_share_servers": true,
"snapshot_support": true
},
"name": "my_new_volume_type"
}
}

View File

@ -0,0 +1,26 @@
{
"volume_type": {
"os-share-type-access:is_public": true,
"required_extra_specs": {
"driver_handles_share_servers": true
},
"extra_specs": {
"snapshot_support": "True",
"driver_handles_share_servers": "True"
},
"name": "my_new_volume_type",
"id": "1d600d02-26a7-4b23-af3d-7d51860fe858"
},
"share_type": {
"os-share-type-access:is_public": true,
"required_extra_specs": {
"driver_handles_share_servers": true
},
"extra_specs": {
"snapshot_support": "True",
"driver_handles_share_servers": "True"
},
"name": "my_new_volume_type",
"id": "1d600d02-26a7-4b23-af3d-7d51860fe858"
}
}

View File

@ -0,0 +1,20 @@
{
"volume_type": {
"required_extra_specs": null,
"extra_specs": {
"snapshot_support": "True",
"driver_handles_share_servers": "True"
},
"name": "default",
"id": "be27425c-f807-4500-a056-d00721db45cf"
},
"share_type": {
"required_extra_specs": null,
"extra_specs": {
"snapshot_support": "True",
"driver_handles_share_servers": "True"
},
"name": "default",
"id": "be27425c-f807-4500-a056-d00721db45cf"
}
}

View File

@ -0,0 +1,6 @@
{
"extra_specs": {
"snapshot_support": "True",
"driver_handles_share_servers": "True"
}
}

View File

@ -0,0 +1,54 @@
{
"volume_types": [
{
"os-share-type-access:is_public": true,
"required_extra_specs": {
"driver_handles_share_servers": "True"
},
"extra_specs": {
"snapshot_support": "True",
"driver_handles_share_servers": "True"
},
"name": "default",
"id": "be27425c-f807-4500-a056-d00721db45cf"
},
{
"os-share-type-access:is_public": true,
"required_extra_specs": {
"driver_handles_share_servers": "false"
},
"extra_specs": {
"snapshot_support": "True",
"driver_handles_share_servers": "false"
},
"name": "d",
"id": "f015bebe-c38b-4c49-8832-00143b10253b"
}
],
"share_types": [
{
"os-share-type-access:is_public": true,
"required_extra_specs": {
"driver_handles_share_servers": "True"
},
"extra_specs": {
"snapshot_support": "True",
"driver_handles_share_servers": "True"
},
"name": "default",
"id": "be27425c-f807-4500-a056-d00721db45cf"
},
{
"os-share-type-access:is_public": true,
"required_extra_specs": {
"driver_handles_share_servers": "false"
},
"extra_specs": {
"snapshot_support": "True",
"driver_handles_share_servers": "false"
},
"name": "d",
"id": "f015bebe-c38b-4c49-8832-00143b10253b"
}
]
}

View File

@ -0,0 +1,5 @@
{
"extra_specs": {
"my_key": "my_value"
}
}

View File

@ -0,0 +1,5 @@
{
"extra_specs": {
"my_key": "my_value"
}
}

View File

@ -0,0 +1,7 @@
{
"metadata": {
"aim": "changed_doc",
"project": "my_app",
"new_metadata_key": "new_information"
}
}

View File

@ -0,0 +1,7 @@
{
"metadata": {
"aim": "changed_doc",
"project": "my_app",
"new_metadata_key": "new_information"
}
}

View File

@ -0,0 +1,6 @@
{
"share": {
"is_public": true,
"display_description": "Changing the share description."
}
}

View File

@ -0,0 +1,41 @@
{
"share": {
"links": [
{
"href": "http://172.18.198.54:8786/v2/16e1ab15c35a457e9c2b2aa189f544e1/shares/011d21e2-fbc3-4e4a-9993-9ea223f73264",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/shares/011d21e2-fbc3-4e4a-9993-9ea223f73264",
"rel": "bookmark"
}
],
"availability_zone": "nova",
"share_network_id": "713df749-aac0-4a54-af52-10f6c991e80c",
"export_locations": [],
"share_server_id": "e268f4aa-d571-43dd-9ab3-f49ad06ffaef",
"snapshot_id": null,
"id": "011d21e2-fbc3-4e4a-9993-9ea223f73264",
"size": 1,
"share_type": "25747776-08e5-494f-ab40-a64b9d20d8f7",
"share_type_name": "default",
"export_location": null,
"consistency_group_id": "9397c191-8427-4661-a2e8-b23820dc01d4",
"project_id": "16e1ab15c35a457e9c2b2aa189f544e1",
"metadata": {
"project": "my_app",
"aim": "doc"
},
"status": "error",
"description": "Changing the share description.",
"host": "manila2@generic1#GENERIC1",
"task_state": null,
"is_public": true,
"snapshot_support": true,
"name": "share_London",
"created_at": "2015-09-18T10:25:24.000000",
"share_proto": "NFS",
"volume_type": "default",
"source_cgsnapshot_member_id": null
}
}

View File

@ -0,0 +1,3 @@
{
"os-force_delete": null
}

View File

@ -0,0 +1,5 @@
{
"os-reset_status": {
"status": "error"
}
}

View File

@ -0,0 +1,8 @@
{
"snapshot": {
"share_id": "406ea93b-32e9-4907-a117-148b3945749f",
"force": "True",
"name": "snapshot_share1",
"description": "Here is a snapshot of share Share1"
}
}

View File

@ -0,0 +1,23 @@
{
"snapshot": {
"status": "creating",
"share_id": "406ea93b-32e9-4907-a117-148b3945749f",
"name": "snapshot_share1",
"links": [
{
"href": "http://172.18.198.54:8786/v1/16e1ab15c35a457e9c2b2aa189f544e1/snapshots/6d221c1d-0200-461e-8d20-24b4776b9ddb",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/snapshots/6d221c1d-0200-461e-8d20-24b4776b9ddb",
"rel": "bookmark"
}
],
"created_at": "2015-09-07T11:50:39.756808",
"description": "Here is a snapshot of share Share1",
"share_proto": "NFS",
"share_size": 1,
"id": "6d221c1d-0200-461e-8d20-24b4776b9ddb",
"size": 1
}
}

View File

@ -0,0 +1,46 @@
{
"snapshots": [
{
"status": "creating",
"share_id": "d94a8548-2079-4be0-b21c-0a887acd31ca",
"name": "snapshot_My_share",
"links": [
{
"href": "http://172.18.198.54:8786/v1/16e1ab15c35a457e9c2b2aa189f544e1/snapshots/086a1aa6-c425-4ecd-9612-391a3b1b9375",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/snapshots/086a1aa6-c425-4ecd-9612-391a3b1b9375",
"rel": "bookmark"
}
],
"created_at": "2015-09-07T11:55:09.000000",
"description": "Here is a snapshot of share My_share",
"share_proto": "NFS",
"share_size": 1,
"id": "086a1aa6-c425-4ecd-9612-391a3b1b9375",
"size": 1
},
{
"status": "available",
"share_id": "406ea93b-32e9-4907-a117-148b3945749f",
"name": "snapshot_share1",
"links": [
{
"href": "http://172.18.198.54:8786/v1/16e1ab15c35a457e9c2b2aa189f544e1/snapshots/6d221c1d-0200-461e-8d20-24b4776b9ddb",
"rel": "self"
},
{
"href": "http://172.18.198.54:8786/16e1ab15c35a457e9c2b2aa189f544e1/snapshots/6d221c1d-0200-461e-8d20-24b4776b9ddb",
"rel": "bookmark"
}
],
"created_at": "2015-09-07T11:50:39.000000",
"description": "Here is a snapshot of share Share1",
"share_proto": "NFS",
"share_size": 1,
"id": "6d221c1d-0200-461e-8d20-24b4776b9ddb",
"size": 1
}
]
}

Some files were not shown because too many files have changed in this diff Show More