api-site/api-ref/locale/api-ref.pot
OpenStack Proposal Bot 9292b83b04 Imported Translations from Zanata
For more information about this automatic import see:
https://wiki.openstack.org/wiki/Translations/Infrastructure

Change-Id: I17db77c55c5af7fcef133bdada6cf5e11901e08d
2015-10-16 06:14:05 +00:00

3049 lines
128 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2015-10-16 06:13+0000\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
#: ./api-ref/src/docbkx/api-ref-database-v1.xml:11(title)
msgid "OpenStack Database Service API v1.0 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/api-ref-database-v1.xml:13(year) ./api-ref/src/docbkx/api-ref-identity-v2.xml:13(year) ./api-ref/src/docbkx/api-ref-telemetry-v2.xml:13(year) ./api-ref/src/docbkx/api-ref-blockstorage-v1.xml:13(year) ./api-ref/src/docbkx/api-ref-identity-v3.xml:13(year) ./api-ref/src/docbkx/api-ref-identity-admin-v2.xml:13(year) ./api-ref/src/docbkx/api-ref-data-processing-v1.1.xml:12(year) ./api-ref/src/docbkx/api-ref-networking-v2-ext.xml:13(year) ./api-ref/src/docbkx/api-ref-orchestration-v1.xml:13(year) ./api-ref/src/docbkx/api-ref.xml:13(year) ./api-ref/src/docbkx/api-ref-objectstorage-v1.xml:13(year) ./api-ref/src/docbkx/api-ref-image-v1.xml:13(year) ./api-ref/src/docbkx/api-ref-compute-v2.1.xml:13(year) ./api-ref/src/docbkx/api-ref-identity-v3-ext.xml:13(year) ./api-ref/src/docbkx/api-ref-image-v2.xml:13(year) ./api-ref/src/docbkx/api-ref-identity-v2-ext.xml:13(year) ./api-ref/src/docbkx/api-ref-networking-v2.xml:13(year) ./api-ref/src/docbkx/api-ref-blockstorage-v2.xml:13(year)
msgid "2010-2015"
msgstr ""
#: ./api-ref/src/docbkx/api-ref-identity-v2.xml:11(title)
msgid "OpenStack Identity API v2 (SUPPORTED)"
msgstr ""
#: ./api-ref/src/docbkx/api-ref-share-v2.xml:11(title)
msgid "OpenStack Shared File Systems API v2.0 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/api-ref-share-v2.xml:13(year) ./api-ref/src/docbkx/api-ref-share-v1.xml:13(year)
msgid "2015"
msgstr ""
#: ./api-ref/src/docbkx/api-ref-telemetry-v2.xml:11(title)
msgid "OpenStack Telemetry API v2 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/api-ref-blockstorage-v1.xml:11(title)
msgid "OpenStack Block Storage API v1 (SUPPORTED)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-admin-v2.xml:10(title)
msgid "Identity Admin API v2.0 (SUPPORTED)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-admin-v2.xml:11(para)
msgid "Gets an authentication token that permits access to the Compute API."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-admin-v2.xml:13(title) ./api-ref/src/docbkx/ch_compute-v2.1.xml:40(link)
msgid "Versions"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-admin-v2.xml:32(title) ./api-ref/src/docbkx/ch_identity-v3.xml:47(title) ./api-ref/src/docbkx/ch_identity-v2.xml:40(title)
msgid "Tokens"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-admin-v2.xml:44(title) ./api-ref/src/docbkx/ch_identity-v3.xml:193(title)
msgid "Users"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-admin-v2.xml:63(title)
msgid "Tenants"
msgstr ""
#: ./api-ref/src/docbkx/api-ref-identity-v3.xml:11(title)
msgid "OpenStack Identity API v3 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:10(title) ./api-ref/src/docbkx/itemizedlist-service-list.xml:60(link)
msgid "Image service API v2 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:11(para)
msgid "Image service API v2.0, API v2.1, and API v2.2."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:12(para) ./api-ref/src/docbkx/ch_images-v1.xml:15(para)
msgid "Cloud providers can configure property protections that prevent non-administrative users from updating and deleting protected properties. For more information, see <link xlink:href=\"http://docs.openstack.org/admin-guide-cloud/compute-images-instances.html#image-properties-and-property-protection\">Image property protection</link> in the <citetitle>OpenStack Cloud Administrator Guide</citetitle>."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:21(title) ./api-ref/src/docbkx/ch_database-v1.xml:12(title) ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:37(title) ./api-ref/src/docbkx/ch_identity-v3.xml:34(title) ./api-ref/src/docbkx/ch_identity-v2.xml:14(title) ./api-ref/src/docbkx/ch_netconn-v2.xml:24(title) ./api-ref/src/docbkx/ch_images-v1.xml:23(title) ./api-ref/src/docbkx/ch_share-v2.xml:37(title) ./api-ref/src/docbkx/ch_compute-v2.1.xml:74(title) ./api-ref/src/docbkx/ch_orchestration-v1.xml:23(title) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:16(title)
msgid "API versions"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:30(title) ./api-ref/src/docbkx/ch_images-v1.xml:37(title) ./api-ref/src/docbkx/ch_compute-v2.1.xml:505(title)
msgid "Images"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:31(para)
msgid "Creates, lists, updates, and deletes images."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:32(para)
msgid "Image operations show all fields in the response body. Any field with no value is set to <code>null</code> value (JSON null data type)."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:37(para)
msgid "The possible status values for images are:"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:41(caption)
msgid "Image status"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:46(th) ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:204(th) ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:267(th) ./api-ref/src/docbkx/ch_share-v2.xml:152(th) ./api-ref/src/docbkx/ch_share-v2.xml:647(th) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:64(th) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:196(th) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:364(th)
msgid "Status"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:47(th) ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:205(th) ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:268(th) ./api-ref/src/docbkx/ch_share-v2.xml:153(th) ./api-ref/src/docbkx/ch_share-v2.xml:648(th) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:65(th) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:197(th) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:365(th)
msgid "Description"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:52(para)
msgid "queued"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:54(para)
msgid "The Image service reserved an image ID for the image in the registry but has not uploaded any image data."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:62(para)
msgid "saving"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:64(para)
msgid "The Image service is currently uploading the raw data for the image."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:71(para) ./api-ref/src/docbkx/ch_share-v2.xml:654(code)
msgid "active"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:73(para)
msgid "The image is active and fully available in the Image service."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:80(para)
msgid "killed"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:82(para)
msgid "An error occurred during the upload of image data."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:88(para)
msgid "deleted"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:90(para)
msgid "The Image service retains information about the image but the image is no longer available for use."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:98(para)
msgid "pending_delete"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:100(para)
msgid "Similar to the <code>deleted</code> status. An image in this state is not recoverable."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:132(title)
msgid "Image data"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:133(para)
msgid "Uploads and downloads raw image data."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:143(title)
msgid "Image tags"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:144(para)
msgid "Adds and deletes image tags."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:154(title) ./api-ref/src/docbkx/ch_images-v1.xml:58(title)
msgid "Members"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:170(title)
msgid "Image schemas"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:171(para)
msgid "Gets a JSON-schema document that represents an images or image entity."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:193(title)
msgid "Metadata definition resource types"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:194(para)
msgid "Lists resource types. Also, creates, lists, and removes resource type associations in a specified namespace. (Since API v2.0.)"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:215(title)
msgid "Metadata definition namespaces"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:216(para)
msgid "Creates, lists, gets details for, updates, and deletes metadata definition namespaces. Defines namespaces that can contain property definitions, object definitions, and resource type associations. (Since API v2.0.)"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:237(title)
msgid "Metadata definition properties"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:238(para)
msgid "Creates, lists, gets details for, updates, and deletes metadata definition properties. (Since API v2.0.)"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:256(title)
msgid "Metadata definition objects"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:257(para)
msgid "Creates, lists, gets details for, updates, and deletes metadata definition objects. (Since API v2.0.)"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:274(title)
msgid "Metadata definition tags"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:275(para)
msgid "Creates, lists, gets details for, updates, and deletes metadata definition tags. (Since API v2.0.)"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:294(title)
msgid "Metadata definition schemas"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:295(para)
msgid "Gets a JSON-schema document that represents a metadata definition entity."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:343(title)
msgid "Tasks"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:344(para)
msgid "Creates, lists, and gets details for tasks. (Since API v2.2.)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v2-ext.xml:14(title) ./api-ref/src/docbkx/itemizedlist-service-list.xml:55(link)
msgid "Identity API v2.0 extensions (SUPPORTED)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v2-ext.xml:15(para)
msgid "To list available Identity API v2.0 extensions, issue a request to v2.0/extensions."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v2-ext.xml:20(title)
msgid "OS-KSADM admin extension"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v2-ext.xml:25(title)
msgid "OS-KSCATALOG admin extension"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v2-ext.xml:31(title)
msgid "OS-KSEC2 admin extension"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v2-ext.xml:37(title)
msgid "OS-KSS3 admin extension"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v2-ext.xml:43(title)
msgid "OS-KSVALIDATE admin extension"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:14(title) ./api-ref/src/docbkx/itemizedlist-service-list.xml:40(link)
msgid "Identity API v3 extensions (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:15(para)
msgid "This page describes these Identity API v3 extensions:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:21(link) ./api-ref/src/docbkx/ch_identity-v3-ext.xml:49(title)
msgid "OS-INHERIT extension (OS-INHERIT)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:28(link) ./api-ref/src/docbkx/ch_identity-v3-ext.xml:64(title)
msgid "Key Distribution Server (KDS) extension (OS-KDS)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:35(link) ./api-ref/src/docbkx/ch_identity-v3-ext.xml:283(title)
msgid "OAuth extension (OS-OAUTH1)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:42(link) ./api-ref/src/docbkx/ch_identity-v3-ext.xml:338(title)
msgid "Trust extension (OS-TRUST)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:50(para)
msgid "Enables projects to inherit role assignments from either their owning domain or projects that are higher in the hierarchy."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:54(para)
msgid "The OS-INHERIT extension was extended in API v3.4 to allow inheritance from projects in addition to inheritance from domains. To access project inheritance, the Identity service server must run at least API v3.4."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:65(para)
msgid "The Key Distribution Server (KDS) is a trusted third party that generates and securely distributes signing and encryption keys to communicating parties. These shared keys enable parties to exchange authenticated, confidential messages. KDS is an integral part of the RPC message security implementation. To establish a trusted relationship between the party and the KDS, a properly authorized user, such as a cloud administrator, must assign a long-term shared key to the communicating party. Assigning a key to a party requires assigning an identity to that party in the KDS. An identity includes a unique party name and the associated long-term shared key. This party name is used to identify a party when it communicates with KDS or another party."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:79(para)
msgid "The KDS enables two individual parties or one individual party and a group party to exchange secure messages. To get keys so that it can communicate with another party, a party makes an authenticated request to KDS for a ticket. The KDS returns an encrypted ticket to the requesting party. The KDS encrypts the ticket with the long-term shared key that is associated with that party. Only the associated party or the KDS itself can decrypt the ticket."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:88(para)
msgid "The KDS issues a ticket that contains a copy of the shared encryption and signing keys. These keys are for the source party, which is the party that requests the ticket. The ticket also contains a payload that is intended for the destination party, which is the party with whom the source party wants to communicate. This payload contains the information that the destination party can use to derive the shared encryption and signing keys. When the destination party is:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:100(para)
msgid "An individual. The payload is encrypted with the long-term shared key that is associated with the destination party."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:106(para)
msgid "A group. The payload is encrypted with a shared group key that the KDS makes available to all members of the group. This encryption enables the destination party to trust that the information in the payload was supplied by the KDS."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:115(para)
msgid "When the source party is ready to communicate with the destination party, it sends this encrypted payload to the destination party along with whatever data it has protected with the shared signing and encryption keys. The destination party can decrypt the payload and derive the shared encryption and signing keys by using the payload information. Both parties have a copy of the shared signing and encryption keys that are trusted as being issued by the KDS. The destination party uses these shared keys to authenticate and decrypt the data sent by the source party."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:126(para)
msgid "Other guidelines:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:129(para)
msgid "When a source party must send secure messages to multiple recipients, an authorized user can define a KDS group for the recipients. Membership in a group is determined by comparing a party name with the group name. The party is considered to be a member if the party name matches <code>&lt;group name&gt;.*</code>. For example, a party named <code>scheduler.host.example.com</code> is considered a member of the <code>scheduler</code> group. This method is the same method that is used to name message queues in OpenStack."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:142(para)
msgid "When a source party requests a ticket for a destination party that is a group, KDS generates a short-lived group key and assigns it to the group. This group key is used to encrypt the payload in the ticket, which contains the information that the destination party uses to derive the shared signing and encryption keys."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:151(para)
msgid "When an individual destination party must decrypt the payload that it receives from the source party as a part of a group message, it makes an authenticated request to KDS to get the short-lived group key. If the requester is a member of the target group, KDS provides the short-lived group key encrypted with the long-term shared key associated with the individual destination party. The individual destination party can then decrypt the group key, which enables it to decrypt the payload and derive the shared signing and encryption keys to use to authenticate and decrypt the data sent by the source party."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:165(para)
msgid "When a sender gets keys to send a message to a group, all group members and the sender share the signing and encryption keys, which makes it impossible for an individual destination party to determine whether a message was sent by the source party or by another destination party who is a group member. The destination party can confirm only that the message was sent by a party who has the shared signing and encryption keys. When a sender uses keys to send a message to a group, all group members must trust other members to operate in good faith."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:179(para)
msgid "The signing and encryption keys that communicating parties share are short-lived. The life span of these keys is defined by a validity period that is set by the KDS when it issues the ticket. A suggested reasonable default validity period is 15 minutes, though the implementation determines the appropriate validity period."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:187(para)
msgid "After the validity period for the keys expires, a party should refuse to use those keys to prevent the use of compromised keys. This requires the source party to request a new ticket from the KDS to get a new set of keys. An implementation can implement a grace period to account for clock skew between parties. This grace period enables a destination party to accept messages that use recently expired keys. If you use a grace period, its duration should be five or fewer minutes."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:197(para)
msgid "A key server, unlike a pure public key-based system, can regulate the encryption and signing key exchange. When keys are requested, the key server actively distributes keys to communicating parties, applies access control, and denies communication between arbitrary peers in the system. This enables centralized access control, prevents unauthorized communication, and eliminates the need to perform post-authentication access control and policy lookups on the receiving side."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:207(para)
msgid "The KDS requires that all ticket requests are authenticated and, where appropriate, data is encrypted. You must pass any time stamp value to the API as a <link xlink:href=\"https://en.wikipedia.org/wiki/ISO_8601#UTC\">UTC</link><link xlink:href=\"https://en.wikipedia.org/wiki/ISO_8601\">ISO 8601</link> date and time string that includes microseconds. For example, <code>2012-03-26T10:01:01.720000</code>."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:216(para)
msgid "The default algorithms for message authentication and encryption are, respectively, HMAC-SHA-256 and AES-128-CBC. Therefore, the default block size is 128 bit."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:221(para)
msgid "The source party that requests a ticket must send the encrypted <code>esek</code> payload to the destination party. The source and destination strings used when requesting the ticket also must be sent to the destination party to enable it to derive the shared signing end encryption keys. The messaging implementation is responsible for transferring this data to the destination party."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:229(para)
msgid "The key derivation used to generate the shared signing and encryption keys uses the Hashed Message Authentication Code (HMAC)-based key derivation function (HKDF) standard, as described in RFC 5869. The destination party must use the HKDF <code>expand</code> function by using the information that it receives from the source party to complete derivation of the shared signing and encryption keys. The inputs to the HKDF <code>expand</code> function are:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:240(para)
msgid "The <code>info</code> input for the HKDF <code>expand</code> function is a string that concatenates the source, destination, and <code>esek.timestamp</code> strings by using a comma (<code>,</code>) separator between each element. The following example shows a valid <code>info</code> string where <code>scheduler.host.example.com</code> is the source, <code>compute.host.example.com</code> is the destination, and <code>2012-03-26T10:01:01.720000</code> is the <code>esek.timestamp</code>:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:252(para)
msgid "The output of the HKDF expand function is an array of bytes of 256 bit length. The first half is the signing key, and the second half is the encryption key."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:257(para)
msgid "Create and delete requests for long-term keys are restricted to authorized users, such as cloud administrators. The authentication and authorization for these requests is left up to the implementation, though the implementation should leverage the Identity API for these purposes."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:284(para)
msgid "Enables users to delegate roles to third-party consumers through the <link xlink:href=\"http://tools.ietf.org/html/rfc5849\">The OAuth 1.0 Protocol</link>."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:287(para)
msgid "A user is an Identity API user who delegates its roles and who authorizes request tokens. A consumer is a third-party application that uses OAuth to access a protected resource. An OAuth-derived token enables admin users to act on behalf of the authorizing user. A request token is a token that the consumer uses to get authorization from the user and exchanges with an OAuth verifier for an access token. The OAuth verifier is a required string that is provided with the corresponding request token in exchange for an access token. An access token is a token that the consumer uses to request Identity API tokens on behalf of the authorizing user instead of using the credentials for the user."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:300(para)
msgid "Request and access tokens use token keys to identify themselves. For OpenStack purposes, the token key is the token ID. The consumer uses a token secret to establish ownership of a specified token. Both request and access tokens have token secrets."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:306(para)
msgid "Delegated authentication through OAuth occurs as follows:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:311(para)
msgid "A user creates a consumer."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:314(para)
msgid "The consumer gets an unauthorized request token. Then, the consumer uses the request token to initiate user authorization."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:319(para)
msgid "The user authorizes the request token."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:322(para)
msgid "The consumer exchanges the authorized request token and the OAuth verifier for an access token."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:325(para)
msgid "The authorizing user receives the request token key from the consumer out-of-band."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:329(para)
msgid "The consumer uses the access token to request an Identity API token."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:339(para)
msgid "Creates a trust."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:340(para)
msgid "A trust is an OpenStack Identity extension that enables delegation and, optionally, impersonation through <code>keystone</code>. A trust extension defines a relationship between a trustor and trustee. A trustor is the user who delegates a limited set of their own rights to another user. A trustee is the user whose trust is being delegated to, for a limited time."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:348(para)
msgid "The trust can eventually enable the trustee to impersonate the trustor. For security reasons, some safety measures are added. For example, if a trustor loses a given role, any trusts and the related tokens that the user issued with that role are automatically revoked."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:355(para)
msgid "For more information, see <link xlink:href=\"http://docs.openstack.org/admin-guide-cloud/keystone_use_trusts.html\">Use trusts</link>."
msgstr ""
#: ./api-ref/src/docbkx/api-ref-identity-admin-v2.xml:11(title)
msgid "OpenStack Identity Admin API v2 (SUPPORTED)"
msgstr ""
#: ./api-ref/src/docbkx/api-ref-data-processing-v1.1.xml:10(title)
msgid "OpenStack Data Processing API v1.1 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:10(title) ./api-ref/src/docbkx/itemizedlist-service-list.xml:80(link)
msgid "Object Storage API v1 (SUPPORTED)"
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:11(para)
msgid "Manages the accounts, containers, and objects in the Object Storage system."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:15(para)
msgid "To run the cURL command examples for these requests, set these environment variables:"
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:21(para)
msgid "<code>publicURL</code>. The public URL that is the HTTP endpoint from where you can access Object Storage. It includes the Object Storage API version number and your account name. For example, <code>https://23.253.72.207/v1/my_account</code>."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:29(para)
msgid "<code>token</code>. The authentication token for Object Storage."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:35(para)
msgid "To obtain these values, run the <placeholder-1/> command."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:39(para)
msgid "As shown in this example, the public URL appears in the <code>StorageURL</code> field, and the token appears in the <code>Auth Token</code> field:"
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:55(para)
msgid "For a complete description of HTTP 1.1 header definitions, see <link xlink:href=\"http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14\">Header Field Definitions</link>."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:61(title)
msgid "Discoverability"
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:62(para)
msgid "If configured, lists the activated capabilities for this version of the OpenStack Object Storage API."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:73(title) ./api-ref/src/docbkx/ch_identity-v3.xml:79(title)
msgid "Endpoints"
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:74(para)
msgid "If configured, lists endpoints for a specified account."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:85(title)
msgid "Accounts"
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:86(para)
msgid "Lists containers for a specified account. Creates, updates, shows, and deletes account metadata."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:100(title)
msgid "Containers"
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:101(para)
msgid "Lists objects in a specified container. Creates, shows details for, and deletes containers. Creates, updates, shows, and deletes container metadata."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:118(title)
msgid "Objects"
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:119(para)
msgid "Creates, replaces, shows details for, and deletes objects. Copies objects from another object with a new or different name. Updates object metadata."
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:10(title) ./api-ref/src/docbkx/itemizedlist-service-list.xml:30(link)
msgid "Database Service API v1.0 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:26(title)
msgid "Database instances (instances)"
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:49(title)
msgid "Database instance actions (action)"
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:60(title)
msgid "Databases (databases)"
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:74(title)
msgid "Users (users)"
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:88(title)
msgid "Flavors (flavors)"
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:101(title)
msgid "Datastores (datastores)"
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:117(title)
msgid "Configuration groups (configurations)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:10(title) ./api-ref/src/docbkx/itemizedlist-service-list.xml:15(link)
msgid "Block Storage API v1 (DEPRECATED)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:11(para)
msgid "Block Storage API v1 is deprecated in Kilo."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:14(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:11(para)
msgid "Manages volumes and snapshots for use with the Block Storage API, also known as cinder services."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:18(para)
msgid "When you create, list, or delete volumes, the following status values are possible:"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:23(para)
msgid "CREATING. The volume is being created."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:24(para)
msgid "AVAILABLE. The volume is ready to be attached to an instance."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:26(para)
msgid "ATTACHING. The volume is attaching to an instance."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:28(para)
msgid "IN-USE. The volume is attached to an instance."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:30(para)
msgid "DELETING. The volume is being deleted."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:31(para)
msgid "ERROR. An error has occurred with the volume."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:33(para)
msgid "ERROR_DELETING. There was an error deleting the volume."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:50(title)
msgid "Volumes"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:51(para)
msgid "The <code>snapshot_id</code> and <code>source_volid</code> parameters specify the ID of the snapshot or volume from which the volume originates. If the volume was not created from a snapshot or source volume, these values are null."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:76(title)
msgid "Volume types"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:97(title)
msgid "Snapshots"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:121(title) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:281(title)
msgid "Quota sets extension (os-quota-sets)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:122(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:282(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:308(para)
msgid "Administrators only, depending on policy settings."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:124(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:284(para)
msgid "Shows, updates, and deletes quotas for a tenant."
msgstr ""
#: ./api-ref/src/docbkx/preface.xml:9(title)
msgid "OpenStack API Complete Reference"
msgstr ""
#: ./api-ref/src/docbkx/preface.xml:10(para)
msgid "Use the OpenStack APIs and extensions to launch server instances, create images, assign metadata to instances and images, create containers and objects, and complete other actions in your OpenStack cloud."
msgstr ""
#: ./api-ref/src/docbkx/preface.xml:16(para)
msgid "The API <emphasis role=\"bold\">status</emphasis> reflects the state of the endpoint on the service. <emphasis role=\"bold\">CURRENT</emphasis> is a stable version that is up-to-date, recent, and might receive future versions. This endpoint should be prioritized over all others. <emphasis role=\"bold\">SUPPORTED</emphasis> is a stable version that is available on the server. However, it is not likely the most recent available and might not be updated or might be deprecated at some time in the future. <emphasis role=\"bold\">DEPRECATED</emphasis> is a stable version that is still available but is being deprecated and might be removed in the future. <emphasis role=\"bold\">EXPERIMENTAL</emphasis> is not a stable version. This version is under development or contains features that are otherwise subject to change. For more information about API <emphasis role=\"bold\">status</emphasis> values and version information, see <link xlink:href=\"https://wiki.openstack.org/wiki/VersionDiscovery\">Version Discovery</link>."
msgstr ""
#: ./api-ref/src/docbkx/preface.xml:35(para)
msgid "You must install the packages for each API separately. You can use the APIs and extensions after you authenticate through the Identity API:"
msgstr ""
#: ./api-ref/src/docbkx/preface.xml:44(para)
msgid "To get started with the APIs, see the <link xlink:href=\"http://docs.openstack.org/api/quick-start/content/\">OpenStack API Quick Start</link>."
msgstr ""
#: ./api-ref/src/docbkx/api-ref-networking-v2-ext.xml:11(title)
msgid "OpenStack Networking API v2.0 extensions (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/api-ref-orchestration-v1.xml:11(title)
msgid "OpenStack Orchestration API v1 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:10(title) ./api-ref/src/docbkx/itemizedlist-service-list.xml:100(link)
msgid "Telemetry API v2 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:11(para)
msgid "Manages Telemetry operations."
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:13(title)
msgid "Alarms"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:14(para)
msgid "Lists, creates, gets details for, updates, and deletes alarms."
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:40(title)
msgid "Meters"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:41(para)
msgid "Lists all meters, adds samples to meters, and lists samples for meters. For list operations, if you do not explicitly set the <code>limit</code> query parameter, a default limit is applied. The default limit is the <code>default_api_return_limit</code> configuration option value."
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:48(para)
msgid "Also, computes and lists statistics for samples in a specified time range. You can use the <code>aggregate</code> query parameter in the <code>statistics</code> URI to explicitly select the <code>stddev</code>, <code>cardinality</code>, or any other standard function. For example:"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:56(para)
msgid "The <code>aggregate.param</code> parameter value is optional for all functions except the <code>cardinality</code> function."
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:60(para)
msgid "The API silently ignores any duplicate aggregate function and parameter pairs."
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:64(para)
msgid "The API accepts and storage drivers support duplicate functions with different parameter values. In this example, the <code>cardinality</code> function is accepted twice with two different parameter values:"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:72(emphasis)
msgid "Examples:"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:73(para)
msgid "Use the <code>stddev</code> function to request the standard deviation of CPU utilization:"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:78(para) ./api-ref/src/docbkx/ch_telemetry-v2.xml:120(para)
msgid "The response looks like this:"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:96(para)
msgid "Use the <code>cardinality</code> function with the project ID to return the number of distinct tenants with images:"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:101(para)
msgid "The following, more complex, example determines:"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:106(para)
msgid "The number of distinct instances (<code>cardinality</code>)"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:111(para)
msgid "The total number of instance samples (<code>count</code>) for a specified tenant in 15-minute intervals (<code>period</code> and <code>groupby</code> options)"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:193(title)
msgid "Samples"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:194(para)
msgid "Lists all samples and gets information for a specified sample."
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:197(para)
msgid "For list operations, if you do not explicitly set the <code>limit</code> query parameter, a default limit is applied. The default limit is the <code>default_api_return_limit</code> configuration option value."
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:215(title)
msgid "Resources"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:216(para)
msgid "Lists all and gets information for resources."
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:229(title)
msgid "Capabilities"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:230(para)
msgid "Gets information for API and storage capabilities."
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:231(para)
msgid "The Telemetry service enables you to store samples, events, and alarm definitions in supported database back ends. The <code>capabilities</code> resource enables you to list the capabilities that a database supports."
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:237(para)
msgid "The <code>capabilities</code> resource returns a flattened dictionary of capability properties, each with an associated boolean value. A value of <code>true</code> indicates that the corresponding capability is available in the back end."
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:243(para)
msgid "Optionally, you can configure separate database back ends for samples, events, and alarm definitions. The <code>capabilities</code> response body shows a value of <code>true</code> to indicate that the samples, events, or alarm definitions database is ready to use in a production environment."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:10(title) ./api-ref/src/docbkx/itemizedlist-service-list.xml:35(link)
msgid "Identity API v3 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:11(para) ./api-ref/src/docbkx/ch_identity-v2.xml:11(para)
msgid "Gets an authentication token that permits access to the OpenStack services REST API."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:15(para)
msgid "Like most OpenStack projects, OpenStack Identity protects its APIs by defining policy rules based on a role-based access control (RBAC) approach."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:21(para)
msgid "The Identity service <link xlink:href=\"http://docs.openstack.org/liberty/config-reference/content/keystone-configuration-file.html\"><code>keystone.conf</code></link> configuration file sets the name and location of a JSON policy file that stores these rules."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:27(para)
msgid "For information about Identity API protection, see <link xlink:href=\"http://docs.openstack.org/admin-guide-cloud/identity_service_api_protection.html\">Identity API protection with role-based access control (RBAC)</link> in the <citetitle>OpenStack Cloud Administrator Guide</citetitle>."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:48(para)
msgid "Manages tokens."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:61(title)
msgid "Service catalog"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:62(para)
msgid "Manages the catalog of services."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:80(para)
msgid "Manages endpoints."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:90(title)
msgid "Domains"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:91(para)
msgid "Manages domains."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:92(para)
msgid "Domains represent collections of users, groups, and projects. Each is owned by exactly one domain. Users, however, can be associated with multiple projects by granting roles to the user on a project, including projects owned by other domains."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:95(para)
msgid "Each domain defines a namespace where certain API-visible name attributes exist, which affects whether those names must be globally unique or unique within that domain. In the Identity API, the uniqueness of the following attributes is as follows:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:100(para)
msgid "<emphasis role=\"italic\">Domain name</emphasis>. Globally unique across all domains."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:104(para)
msgid "<emphasis role=\"italic\">Role name</emphasis>. Globally unique across all domains."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:108(para)
msgid "<emphasis role=\"italic\">User name</emphasis>. Unique within the owning domain."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:112(para)
msgid "<emphasis role=\"italic\">Project name</emphasis>. Unique within the owning domain."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:116(para)
msgid "<emphasis role=\"italic\">Group name</emphasis>. Unique within the owning domain."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:155(title)
msgid "Projects"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:156(para)
msgid "Manages projects."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:194(para)
msgid "Manages users."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:218(title)
msgid "Groups"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:219(para)
msgid "Manages groups."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:247(title)
msgid "Credentials"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:248(para)
msgid "Manages credentials."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:266(title)
msgid "Roles"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:267(para)
msgid "Manages roles."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:287(title)
msgid "Policies"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:288(para)
msgid "Manages policies."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:289(para)
msgid "You can encode policy rule sets into a blob to be consumed by remote services. To do so, set <code>type</code> to <code>application/json</code> and specify policy rules as JSON strings in a <code>blob</code>. For example:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:298(para)
msgid "Or:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:320(title)
msgid "Regions"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:321(para)
msgid "Manages regions."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:322(para)
msgid "A region is a general division of an OpenStack deployment. You can associate zero or more sub-regions with a region to create a tree-like structured hierarchy."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:327(para)
msgid "Although a region does not have a geographical connotation, a deployment can use a geographical name for a region, such as <code>us-east</code>."
msgstr ""
#: ./api-ref/src/docbkx/api-ref.xml:11(title)
msgid "OpenStack API Reference"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v2.xml:10(title) ./api-ref/src/docbkx/itemizedlist-service-list.xml:45(link)
msgid "Identity API v2.0 (SUPPORTED)"
msgstr ""
#: ./api-ref/src/docbkx/api-ref-objectstorage-v1.xml:11(title)
msgid "OpenStack Object Storage API v1 (SUPPORTED)"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2.xml:10(title) ./api-ref/src/docbkx/itemizedlist-service-list.xml:70(link)
msgid "Networking API v2.0 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2.xml:11(para)
msgid "Use virtual networking services among devices that are managed by the OpenStack Compute service. The Networking (neutron) API v2.0 combines the API v1.1 functionality with some essential Internet Protocol Address Management (IPAM) functionality. The API enables users to associate IP address blocks and other network configuration settings with an OpenStack Networking network. You can choose a specific IP address from the block or let OpenStack Networking choose the first available IP address."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2.xml:21(para)
msgid "Effective in the OpenStack Liberty release, XML support in requests and responses was removed for the Networking API v2.0."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2.xml:25(para)
msgid "Lists information for all Networking API versions and shows details about API v2.0."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2.xml:39(title)
msgid "Networks"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2.xml:40(para)
msgid "Lists, shows information for, creates, updates, and deletes networks."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2.xml:58(title)
msgid "Subnets"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2.xml:59(para)
msgid "Lists, shows information for, creates, updates, and deletes subnet resources."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2.xml:67(title)
msgid "Ports"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2.xml:68(para)
msgid "Lists, shows information for, creates, updates, and deletes ports."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2.xml:74(title)
msgid "Service providers"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2.xml:75(para)
msgid "Lists service providers."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v1.xml:10(title) ./api-ref/src/docbkx/itemizedlist-service-list.xml:65(link)
msgid "Image service API v1 (SUPPORTED)"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v1.xml:11(para)
msgid "Loads images for use at launch time by the Compute API. Also, assigns metadata to images."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v1.xml:13(para)
msgid "Some cloud implementations do not expose this API and offer pretested images only."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v1.xml:72(title)
msgid "Shared images"
msgstr ""
#: ./api-ref/src/docbkx/api-ref-image-v1.xml:11(title)
msgid "OpenStack Image Service API v1 (SUPPORTED)"
msgstr ""
#: ./api-ref/src/docbkx/api-ref-compute-v2.1.xml:11(title)
msgid "OpenStack Compute API (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/itemizedlist-service-list.xml:10(link) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:10(title)
msgid "Block Storage API v2 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/itemizedlist-service-list.xml:20(link) ./api-ref/src/docbkx/ch_compute-v2.1.xml:15(title)
msgid "Compute API (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/itemizedlist-service-list.xml:25(link)
msgid "Data Processing v1.1 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/itemizedlist-service-list.xml:50(link)
msgid "Identity admin API v2.0 (SUPPORTED)"
msgstr ""
#: ./api-ref/src/docbkx/itemizedlist-service-list.xml:75(link) ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:14(title)
msgid "Networking API v2.0 extensions (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/itemizedlist-service-list.xml:85(link) ./api-ref/src/docbkx/ch_orchestration-v1.xml:10(title)
msgid "Orchestration API v1 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/itemizedlist-service-list.xml:90(link) ./api-ref/src/docbkx/ch_share-v2.xml:15(title)
msgid "Shared File Systems API v2 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/itemizedlist-service-list.xml:95(link) ./api-ref/src/docbkx/ch_share-v1.xml:14(title)
msgid "Shared File Systems API v1 (SUPPORTED)"
msgstr ""
#: ./api-ref/src/docbkx/api-ref-identity-v3-ext.xml:11(title)
msgid "OpenStack Identity API v3 extensions (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/api-ref-image-v2.xml:11(title)
msgid "OpenStack Image service API v2 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:16(title)
msgid "Extensions"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:17(para)
msgid "Lists available Networking API v2.0 extensions and shows details for a specified extension."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:29(title)
msgid "Quotas extension (quotas)"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:30(para)
msgid "Lists, shows information for, updates, and resets quotas."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:43(title)
msgid "Networks provider extended attributes (networks)"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:44(para)
msgid "Lists, creates, shows information for, updates, and deletes networks."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:58(title)
msgid "Networks multiple provider extension (networks)"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:59(para)
msgid "Enables administrative users to define multiple physical bindings for an OpenStack Networking network and list or show details for networks with multiple physical bindings."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:62(para)
msgid "You cannot update any <code>provider</code> attributes. If you try to do so, an error occurs."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:64(para)
msgid "To delete a network with multiple physical bindings, issue a normal delete network request."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:66(para)
msgid "To define multiple physical bindings for a network, include a <code>segments</code> list in the request body of a <code>POST /v2.0/networks</code> request. Each element in the <code>segments</code> list has the same structure as the provider network attributes. These attributes are <code>provider:network_type</code>, <code>provider:physical_network</code>, and <code>provider:segmentation_id</code>. The validation rules for these attributes are the same as for the <link xlink:href=\"http://developer.openstack.org/api-ref-networking-v2.html#network_provider-ext\">Networks provider extended attributes</link>. You cannot use both extensions at the same time."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:77(para)
msgid "The NSX and ML2 plug-ins support this extension. With the ML2 plug-in, you can specify multiple VLANs for a specified network, a VXLAN tunnel ID, and a VLAN."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:83(title)
msgid "VLAN transparency extension (networks)"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:84(para)
msgid "Enables plug-ins that support VLAN transparency to deliver VLAN-transparent trunk networks. If the service does not support VLAN transparency and a user requests a VLAN-transparent network, the plug-in refuses to create one and returns an appropriate error to the user."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:91(para)
msgid "You cannot update the <code>vlan-transparent</code> attribute. If you try to do so, an error occurs."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:95(para)
msgid "To delete a VLAN-transparent network, issue a normal delete network request."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:99(para)
msgid "The ML2 plug-in currently supports this extension. With the ML2 plug-in, you can set the <code>vlan-transparent</code> attribute to either <code>true</code> or <code>false</code>."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:108(title)
msgid "Ports binding extended attributes (ports)"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:109(para)
msgid "Lists, creates, shows information for, and updates ports."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:123(title)
msgid "Security groups (security-groups)"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:124(para)
msgid "Lists, creates, shows information for, updates, and deletes security groups."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:141(title)
msgid "Security group rules (security-group-rules)"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:142(para)
msgid "Lists, creates, shows information for, and deletes security group rules."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:160(title)
msgid "Layer-3 networking"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:161(para)
msgid "Routes packets between subnets, forwards packets from internal networks to external ones, and accesses instances from external networks through floating IPs."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:163(para) ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:356(para)
msgid "This extension introduces these resources:"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:166(para)
msgid "<emphasis role=\"bold\">router</emphasis>. A logical entity for forwarding packets across internal subnets and NATting them on external networks through an appropriate external gateway."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:171(para)
msgid "<emphasis role=\"bold\">floatingip</emphasis>. An external IP address that is mapped to a port that is attached to an internal network."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:179(title)
msgid "Metering labels and rules"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:180(para)
msgid "Creates, modifies, and deletes OpenStack Layer3 metering labels and rules."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:185(title)
msgid "Load-Balancer-as-a-Service (LBaaS) 1.0 (STABLE)"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:186(para)
msgid "The LBaaS version 1.0 extension pairs with the Networking 2.0 API to enable OpenStack tenants to manage load balancers for their VMs. With this extension, you can load-balance client traffic from one network to application services, such as VMs, on the same network."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:193(para)
msgid "Use this extension to create and manage virtual IP addresses (VIPs), pools, members of a pool, health monitors associated with a pool, and view status of a resource."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:199(caption) ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:262(caption)
msgid "Load balancer statuses"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:210(para) ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:273(para)
msgid "ACTIVE"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:211(para) ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:274(para)
msgid "Resource is ready and active."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:214(para) ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:277(para)
msgid "PENDING_CREATE"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:215(para) ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:278(para)
msgid "Resource is being created."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:218(para) ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:281(para)
msgid "PENDING_UPDATE"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:219(para) ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:282(para)
msgid "Resource is being updated."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:222(para) ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:285(para)
msgid "PENDING_DELETE"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:223(para) ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:286(para)
msgid "Resource is pending deletion."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:226(para) ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:289(para)
msgid "INACTIVE"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:227(para) ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:290(para)
msgid "Resource was created but is not active."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:230(para) ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:293(para)
msgid "ERROR"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:232(para) ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:294(para)
msgid "Object within the service is not working. The <code>error_details</code> attribute provides an explanation for the error, its cause, and possibly a solution."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:248(title)
msgid "Load-Balancer-as-a-Service (LBaaS) 2.0 (EXPERIMENTAL)"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:249(para)
msgid "The LBaaS version 2.0 extension pairs with the Networking 2.0 API to enable OpenStack tenants to manage load balancers for their VMs. With this extension you can load-balance client traffic from one network to application services, such as VMs, on the same network."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:256(para)
msgid "Use this extension to create and manage load balancers, listeners, pools, members of a pool, and health monitors associated with a pool and view status of a resource."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:308(title)
msgid "Subnet pools extension (subnetpools)"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:309(para)
msgid "Manages subnet pools"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:323(title)
msgid "Virtual-Private-Network-as-a-Service (VPNaaS) 2.0 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:324(para)
msgid "The VPNaaS extension enables OpenStack tenants to extend private networks across the public telecommunication infrastructure."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:328(para)
msgid "This initial implementation of the VPNaaS extension provides:"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:333(para)
msgid "Site-to-site VPN that connects two private networks."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:337(para)
msgid "Multiple VPN connections per tenant."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:340(para)
msgid "IKEv1 policy support with 3des, aes-128, aes-256, or aes-192 encryption."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:344(para)
msgid "IPSec policy support with 3des, aes-128, aes-192, or aes-256 encryption, sha1 authentication, ESP, AH, or AH-ESP transform protocol, and tunnel or transport mode encapsulation."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:352(para)
msgid "Dead Peer Detection (DPD) with hold, clear, restart, disabled, or restart-by-peer actions."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:359(para)
msgid "<code>service</code>. A parent object that associates VPN with a specific subnet and router."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:363(para)
msgid "<code>ikepolicy</code>. The Internet Key Exchange (IKE) policy that identifies the authentication and encryption algorithm to use during phase one and two negotiation of a VPN connection."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:371(para)
msgid "<code>ipsecpolicy</code>. The IP security policy that specifies the authentication and encryption algorithm and encapsulation mode to use for the established VPN connection."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:379(para)
msgid "<code>ipsec-site-connection</code>. Details for the site-to-site IPsec connection, including the peer CIDRs, MTU, authentication mode, peer address, DPD settings, and status."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:390(title)
msgid "Extra routes"
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:391(para)
msgid "Adds extra routes to the <code>router</code> resource."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:393(para)
msgid "You can update a router to add a set of next hop IPs and destination CIDRs."
msgstr ""
#: ./api-ref/src/docbkx/ch_netconn-v2-ext.xml:396(para)
msgid "The next hop IP must be part of a subnet to which the router interfaces are connected. You can configure the <code>routes</code> attribute on only update operations."
msgstr ""
#: ./api-ref/src/docbkx/api-ref-identity-v2-ext.xml:11(title)
msgid "OpenStack Identity API v2 extensions (SUPPORTED)"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:16(para) ./api-ref/src/docbkx/ch_share-v1.xml:15(para)
msgid "Provides coordinated access to shared or distributed file systems."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:19(para)
msgid "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."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:25(para)
msgid "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>."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:31(para)
msgid "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."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:38(para)
msgid "Lists information for all Shared File Systems API versions."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:48(title)
msgid "API extensions"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:49(para)
msgid "Lists available Shared File Systems API extensions."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:59(title) ./api-ref/src/docbkx/ch_compute-v2.1.xml:64(link)
msgid "Limits"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:60(para)
msgid "Limits are the resource limitations that are allowed for each tenant (project). An administrator can configure limits in the <code>manila.conf</code> file."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:65(para)
msgid "Users can query their rate and absolute limits. The absolute limits contain information about:"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:71(para)
msgid "Total maximum share memory, in GBs."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:74(para)
msgid "Number of share-networks."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:77(para)
msgid "Number of share-snapshots."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:80(para)
msgid "Number of shares."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:83(para)
msgid "Shares and total used memory, in GBs."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:86(para)
msgid "Snapshots and total used memory, in GBs."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:89(para)
msgid "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 requests that can be processed during a one-minute period."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:104(title)
msgid "Shares"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:105(para)
msgid "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."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:110(para)
msgid "You can create a share and associate it with a network, list shares, and show information for, update, and delete a specified share."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:114(para)
msgid "To create a share, specify one of these supported protocols:"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:119(para)
msgid "<code>NFS</code>. Network File System (NFS)."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:124(para)
msgid "<code>CIFS</code>. Common Internet File System (CIFS)."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:129(para)
msgid "<code>GLUSTERFS</code>. Gluster file system (GlusterFS)."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:134(para)
msgid "<code>HDFS</code>. Hadoop Distributed File System (HDFS)."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:139(para)
msgid "You can also create snapshots of shares. To create a snapshot, you specify the ID of the share that you want to snapshot."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:143(para)
msgid "A share has one of these status values:"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:147(caption)
msgid "Share statuses"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:159(code) ./api-ref/src/docbkx/ch_share-v2.xml:391(code) ./api-ref/src/docbkx/ch_share-v2.xml:433(code) ./api-ref/src/docbkx/ch_share-v2.xml:680(code) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:70(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:203(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:371(para)
msgid "creating"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:162(para)
msgid "The share is being created."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:167(code) ./api-ref/src/docbkx/ch_share-v2.xml:394(code) ./api-ref/src/docbkx/ch_share-v2.xml:436(code) ./api-ref/src/docbkx/ch_share-v2.xml:671(code) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:89(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:214(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:381(para)
msgid "deleting"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:170(para)
msgid "The share is being deleted."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:175(code) ./api-ref/src/docbkx/ch_share-v2.xml:388(code) ./api-ref/src/docbkx/ch_share-v2.xml:430(code) ./api-ref/src/docbkx/ch_share-v2.xml:662(code) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:93(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:219(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:386(para)
msgid "error"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:178(para)
msgid "An error occurred during share creation."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:185(code) ./api-ref/src/docbkx/ch_share-v2.xml:397(code) ./api-ref/src/docbkx/ch_share-v2.xml:439(code) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:98(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:392(para)
msgid "error_deleting"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:188(para)
msgid "An error occurred during share deletion."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:195(code) ./api-ref/src/docbkx/ch_share-v2.xml:385(code) ./api-ref/src/docbkx/ch_share-v2.xml:427(code) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:74(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:208(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:376(para)
msgid "available"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:198(para)
msgid "The share is ready to use."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:203(code)
msgid "manage_starting"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:206(para)
msgid "Share manage started."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:211(code)
msgid "manage_error"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:214(para)
msgid "Share manage failed."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:219(code)
msgid "unmanage_starting"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:222(para)
msgid "Share unmanage started."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:227(code)
msgid "unmanage_error"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:230(para)
msgid "Share cannot be unmanaged."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:235(code)
msgid "unmanaged"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:238(para)
msgid "Share was unmanaged."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:243(code)
msgid "extending"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:246(para)
msgid "The extend, or increase, share size request was issued successfully."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:254(code)
msgid "extending_error"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:257(para)
msgid "Extend share failed."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:262(code)
msgid "shrinking"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:265(para)
msgid "Share is being shrunk."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:270(code)
msgid "shrinking_error"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:273(para)
msgid "Failed to update quota on share shrinking."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:278(code)
msgid "shrinking_possible_data_loss_error"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:281(para)
msgid "Shrink share failed due to possible data loss."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:303(title)
msgid "Share metadata"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:304(para)
msgid "Shows, sets, updates, and unsets share metadata."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:319(title)
msgid "Share actions"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:320(para)
msgid "Grants or revokes share access, lists the permissions for a specified share, and explicitly updates the state of a share."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:324(para)
msgid "To grant or revoke share access, specify one of these supported share access levels:"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:330(para)
msgid "<code>rw</code>. Read and write (RW) access."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:335(para)
msgid "<code>ro</code>. Read-only (RO) access."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:340(para)
msgid "You must also specify one of these supported authentication methods:"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:346(para)
msgid "<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>."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:353(para)
msgid "<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."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:362(para)
msgid "<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."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:370(para)
msgid "To verify that the access rules (ACL) were configured correctly for a share, you list permissions for a share."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:374(para)
msgid "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."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:380(para)
msgid "You can set the state of a share to one of these supported states:"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:413(title)
msgid "Share snapshots"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:414(para)
msgid "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."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:421(para)
msgid "You can update a share snapshot to rename it, change its description, or update its state to one of these supported states:"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:442(para)
msgid "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."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:468(title)
msgid "Share networks"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:469(para)
msgid "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."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:476(para)
msgid "You can create, update, view, and delete a share network."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:479(para)
msgid "When you create a share network, you can specify only one type of network:"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:484(para)
msgid "Neutron network. Specify a network ID and subnet ID."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:488(para)
msgid "Nova network. Specify a network ID."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:492(para)
msgid "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>."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:498(para)
msgid "A share network has these attributes:"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:503(para)
msgid "The IP block in Classless Inter-Domain Routing (CIDR) notation from which to allocate the network."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:509(para)
msgid "The IP version of the network."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:514(para)
msgid "The network type, which is <code>vlan</code>, <code>vxlan</code>, <code>gre</code>, <code>flat</code>, or <code>local</code>."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:521(para)
msgid "If the network uses segmentation, a segmentation identifier. For example, VLAN, VXLAN, and GRE networks use segmentation."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:548(title)
msgid "Security services"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:549(para)
msgid "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."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:556(para)
msgid "You can associate a share with from one to three security service types:"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:562(para)
msgid "<code>ldap</code>. LDAP."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:566(para)
msgid "<code>kerberos</code>. Kerberos."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:571(para)
msgid "<code>active_directory</code>. Microsoft Active Directory."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:576(para)
msgid "You can configure a security service with these options:"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:581(para)
msgid "A DNS IP address."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:584(para)
msgid "An IP address or host name."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:587(para)
msgid "A domain."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:590(para)
msgid "A user or group name."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:594(para)
msgid "The password for the user, if you specify a user name."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:613(title)
msgid "Share servers"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:614(para)
msgid "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."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:621(para)
msgid "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. If an administrator deletes the share server, the Shared File Systems service creates a share server in response to a subsequent create share request."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:628(para)
msgid "An administrator can use the <code>policy.json</code> file to grant permissions for share server actions to other roles."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:632(para)
msgid "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>."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:638(para)
msgid "The possible share servers statuses are:"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:642(caption)
msgid "Share server statuses"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:657(para)
msgid "Share server was successfully set up."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:665(para)
msgid "The set up or deletion of the share server failed."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:674(para)
msgid "The share server has no dependent shares and is being deleted."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:683(para)
msgid "The share server is being created on the back end with data from the database."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:705(title)
msgid "Share instances (since API v2.3)"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:706(para)
msgid "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."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:726(title)
msgid "Share types"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:727(para)
msgid "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."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:732(para)
msgid "You set a share type to private or public and manage the access to the private share types."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:736(para)
msgid "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."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:744(para)
msgid "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."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:751(para)
msgid "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."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:756(para)
msgid "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."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:761(para)
msgid "Administrators can create share types with these extra specifications that are used to filter back ends:"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:767(para)
msgid "<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."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:772(para)
msgid "Set to <code>True</code> when the share driver manages, or handles, the share server life cycle."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:776(para)
msgid "Set to <code>False</code> when an administrator rather than a share driver manages the storage life cycle."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:782(para)
msgid "<code>snapshot_support</code>. Filters back ends by whether they do or do not support share snapshots."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:786(para)
msgid "Set to <code>True</code> to find back ends that support share snapshots."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:789(para)
msgid "Set to <code>False</code> to find back ends that do not support share snapshots."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:795(para)
msgid "Administrators can also set additional extra specifications for a share type for the following purposes:"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:801(para)
msgid "Filter back ends. Specify these unqualified extra specifications in this format: <code>extra_spec=value</code>. For example, <code>netapp_raid_type=raid4</code>."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:809(para)
msgid "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>."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:818(para)
msgid "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 unscoped 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>."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:825(para)
msgid "Each driver implementation determines which extra specification keys it uses. For details, see the documentation for the driver."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:829(para)
msgid "An administrator can use the <code>policy.json</code> file to grant permissions for share type creation with extra specifications to other roles."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:862(title)
msgid "Back-end storage pools"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:863(para)
msgid "An administrator can list all back-end storage pools that are known to the scheduler service."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:877(title)
msgid "Services"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:878(para)
msgid "Lists services. Services include <code>manila-share</code> and <code>manila-scheduler</code> and their binaries, hosts, availability zones, current statuses, and states (<code>up</code> or <code>down</code>)."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:884(para)
msgid "Administrators can also enable or disable a specified service."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:900(title)
msgid "Availability zones"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:901(para)
msgid "Describes availability zones."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:911(title)
msgid "Manage share"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:912(para)
msgid "Configures Shared File Systems to manage a specified share."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:922(title)
msgid "Unmanage share"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:923(para)
msgid "Configures Shared File Systems to unmanage a specified share."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:926(para)
msgid "The share unmanage operation is not supported for shares that are created on top of share servers (created with share networks)."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:930(para)
msgid "You can unmanage a share that has no dependent snapshots."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:940(title)
msgid "Quota sets"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:941(para)
msgid "Provides quotas management support."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:956(title)
msgid "Quota classes"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:957(para) ./api-ref/src/docbkx/ch_compute-v2.1.xml:780(para)
msgid "Provides quota classes management support."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:17(para)
msgid "Effective in the OpenStack Kilo release, XML support in requests and responses was removed for the Compute API."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:22(para)
msgid "This documentation supports the API v2.1 base version. If all extensions are enabled, the Compute API v1.1 and v2.0 requests and responses match the API v2.1 requests and responses."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:27(para)
msgid "Each API version lists its required extensions for the full request and responses to be available. API v2.1 must enable all extensions all the time. It uses micro-version headers to expose any additional functionality."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:34(para)
msgid "This page lists the Compute API operations in the following order:"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:46(link) ./api-ref/src/docbkx/ch_compute-v2.1.xml:86(title)
msgid "Servers"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:52(link)
msgid "Flavors"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:58(link)
msgid "Keypairs"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:68(para)
msgid "<link xlink:href=\"http://developer.openstack.org/api-ref-compute-v2.1.html#extensions-v2.1\">Extensions</link> in alphabetical order by resource"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:75(para)
msgid "Lists information for all API versions."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:87(para)
msgid "Lists, creates, gets details for, updates, and deletes servers."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:88(emphasis)
msgid "Passwords"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:89(para)
msgid "When you create a server, you can specify a password through the optional <property>adminPass</property> attribute. The specified password must meet the complexity requirements set by your OpenStack Compute provider. The server might enter an <code>ERROR</code> state if the complexity requirements are not met. In this case, a client might issue a change password action to reset the server password."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:97(para)
msgid "If you do not specify a password, the API generates and assigns a random password that it returns in the response object. This password is guaranteed to meet the security requirements set by the compute provider. For security reasons, the password is not returned in subsequent calls."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:104(emphasis)
msgid "Server metadata"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:105(para)
msgid "You can specify custom server metadata at server launch time. The maximum size for each metadata key-value pair is 255 bytes. The compute provider determines the maximum number of key-value pairs that can be supplied for each server. You can query this value through the <code>maxServerMeta</code> absolute limit."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:112(emphasis)
msgid "Server networks"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:113(para)
msgid "You can specify one or more networks to which the server connects at launch time. Users can also specify a specific port on the network or the fixed IP address to assign to the server interface."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:119(para)
msgid "You can use both IPv4 and IPv6 addresses as access addresses and you can assign both addresses simultaneously. You can update access addresses after you create a server."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:125(emphasis)
msgid "Server personality"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:126(para)
msgid "To customize the personality of a server instance, you can inject data into its file system. For example, you might insert ssh keys, set configuration files, or store data that you want to retrieve from inside the instance. This customization method provides minimal launch-time personalization. If you require significant customization, create a custom image."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:135(para)
msgid "Follow these guidelines when you inject files:"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:140(para)
msgid "The maximum size of the file path data is 255 bytes."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:145(para)
msgid "Encode the file contents as a Base64 string. The compute provider determines the maximum size of the file contents. This value can vary based on the image that is used to create the server."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:152(para)
msgid "The maximum limit refers to the number of bytes in the decoded data and not to the number of characters in the encoded data."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:160(para)
msgid "You can inject only text files. You cannot inject binary or ZIP files into a new build."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:166(para)
msgid "The <code>maxPersonality</code> absolute limit defines the maximum number of file path and content pairs that you can supply. The compute provider determines this value."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:174(para)
msgid "The <code>maxPersonalitySize</code> absolute limit is a byte limit that is guaranteed to apply to all images in the deployment. Providers can set additional per-image personality limits."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:182(para)
msgid "The file injection might not occur until after the server is built and booted."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:186(para)
msgid "During file injection, any existing files that match specified files are renamed to include the BAK extension appended with a time stamp. For example, if the <code>/etc/passwd</code> file exists, it is backed up as <code>/etc/passwd.bak.1246036261.5785</code>."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:192(para)
msgid "After file injection, only system administrators can access personality files. For example, on Linux, all files have root as the owner and the root group as the group owner, and allow only user and group read access (chmod 440)."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:199(emphasis)
msgid "Server access addresses"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:200(para)
msgid "In a hybrid environment, the underlying implementation might not control the IP address of a server. Instead, the access IP address might be part of the dedicated hardware; for example, a router/NAT device. In this case, the addresses provided by the implementation cannot actually be used to access the server (from outside the local LAN). Here, a separate <firstterm>access address</firstterm> might be assigned at creation time to provide access to the server. This address might not be directly bound to a network interface on the server and might not necessarily appear when you query the server addresses. Nonetheless, clients that must access the server directly are encouraged to do so through an access address."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:217(title)
msgid "Servers multiple create (servers)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:218(para)
msgid "Creates one or more servers with an optional reservation ID. The request and response examples show how to create multiple servers with or without a reservation ID."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:228(title)
msgid "Servers actions (servers, action)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:229(para)
msgid "Performs actions on a server. Specify the action in the request body."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:237(title)
msgid "Servers action (servers, os-server-actions)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:238(para)
msgid "Permits all users to list available server actions for a specified server. Permits administrators to get details for a specified server action for a specified server."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:248(title)
msgid "Servers admin actions (servers, action)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:249(para)
msgid "Administrators only. Performs actions on a server. Specify the action in the request body."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:258(title)
msgid "Servers admin password (servers, action)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:259(para)
msgid "Enables users with the administrative role or the owner of the server to change the password of the administrative user."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:268(title)
msgid "Servers console output (servers, action)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:269(para)
msgid "Gets console output for a server instance."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:277(title)
msgid "Servers multiple fixed IP support (servers, action)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:278(para)
msgid "Adds or removes fixed IP addresses from an instance."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:286(title)
msgid "Servers remote console (servers, action)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:287(para)
msgid "Provides interactive console support."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:295(title)
msgid "Servers shelve (servers, action)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:296(para)
msgid "Shelves servers, restores shelved servers, and removes shelved servers."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:300(para)
msgid "Shelving is useful when you have an unused instance that you would like to keep for later use. For example, at the end of a work week you can shelve an instance and at the start of the next week you can unshelve it."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:306(para)
msgid "Your cloud provider might bill you for a shelved server."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:309(para)
msgid "Use the <code>shelve</code> action to shelve a server. All associated data and resources are kept but anything still in memory is not retained."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:314(para)
msgid "Use the <code>unshelve</code> action to restore a shelved instance."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:317(para)
msgid "Use the <code>shelveOffload</code> action to remove a shelved instance that you no longer need."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:326(title)
msgid "Servers deferred delete (servers, action)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:327(para)
msgid "Force-deletes a server or restores a soft-deleted server."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:335(title)
msgid "Servers evacuate (servers, action)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:336(para)
msgid "Evacuates servers."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:339(para)
msgid "Specify the <code>evacuate</code> action in the request body."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:347(title)
msgid "Servers diagnostics (servers, diagnostics)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:348(para)
msgid "Gets the usage data for a server."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:356(title)
msgid "Servers IPs (servers, ips)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:357(para)
msgid "Lists the IP addresses assigned to an instance or shows details for a specified IP address."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:366(title)
msgid "Server metadata (servers, metadata)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:367(para)
msgid "Lists metadata, creates or replaces one or more metadata items, and updates one or more metadata items for a server."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:371(para)
msgid "Shows details for, creates or replaces, and updates a specified metadata item, by key, for a server."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:380(title)
msgid "Servers configuration drive (servers, os-config-drive)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:381(para)
msgid "Shows server details including configuration drive information for a specified server ID or user."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:390(title)
msgid "Servers password (servers, os-server-password)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:391(para)
msgid "Gets the encrypted administrative password set through the metadata service."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:400(title)
msgid "Servers usage (servers, os-server-usage)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:401(para)
msgid "Lists all servers and shows server details. Includes server usage information."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:405(para)
msgid "Shows <code>OS-SRV-USG:launched_at</code> and <code>OS-SRV- USG:terminated_at</code> attributes in server responses."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:409(para)
msgid "To hide <code>addresses</code> information for instances in a specified state, set the <code>osapi_hide_server_address_states</code> configuration option. Set this option to a valid VM state in the <code>nova.conf</code> configuration file."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:421(title)
msgid "Servers virtual interfaces (servers, os-virtual-interfaces)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:422(para)
msgid "Lists virtual interfaces for a specified server instance."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:430(title)
msgid "Flavors with extended attributes (flavors)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:431(para)
msgid "Shows information about flavors."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:439(title)
msgid "Flavors access (flavors, os-flavor-access, action)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:440(para)
msgid "Provides flavor access support."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:461(title)
msgid "Flavors extra-specs (flavors, os-flavor-extra-specs)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:462(para)
msgid "Lists, creates, deletes, and updates the extra-specs or keys for a flavor."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:471(title)
msgid "Flavors manage (flavors, os-flavor-manage)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:472(para)
msgid "Creates and deletes flavors."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:480(title)
msgid "Keypairs (keypairs)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:481(para)
msgid "Generates, imports, and deletes SSH keys."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:487(title) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:35(title)
msgid "Limits (limits)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:488(para)
msgid "Shows all global and rate limit information."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:496(title)
msgid "Extensions (extensions)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:497(para)
msgid "Available extensions."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:506(para)
msgid "Lists, gets details for, and deletes images. Also sets, lists, gets details for, and deletes image metadata."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:510(para)
msgid "An image is a collection of files that you use to create and rebuild a server. By default, operators provide pre-built operating system images. You can also create custom images. See Compute server actions."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:516(para)
msgid "If you set the image size policy in the <code>policy.json</code> file, the <code>OS-EXT-IMG-SIZE:size</code> extended attribute is visible."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:535(title)
msgid "Image metadata"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:536(para)
msgid "Shows details for, sets, updates, and deletes image metadata or metadata items."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:552(title)
msgid "Guest agents (os-agents)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:553(para)
msgid "Creates, lists, updates, and deletes guest agent builds. Use guest agents to access files on the disk, configure networking, or run other applications or scripts in the guest while the agent runs. This hypervisor-specific extension is not currently enabled for KVM. Use of guest agents is possible only if the underlying service provider uses the Xen driver."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:566(title)
msgid "Host aggregates (os-aggregates, action)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:567(para)
msgid "Creates and manages host aggregates. An aggregate assigns metadata to groups of compute nodes. Aggregates are only visible to the cloud provider."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:577(title)
msgid "Assisted volume snapshots (os-assisted-volume-snapshots)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:578(para)
msgid "Creates and deletes snapshots through an emulator/hypervisor. The qcow2 file format is supported."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:582(para)
msgid "An internal snapshot that lacks storage such as NFS or GlusterFS can use an emulator/hypervisor to add the snapshot feature."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:591(title)
msgid "Attach Interfaces (os-attach-interfaces)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:592(para)
msgid "Creates, lists, gets details for, and deletes port interfaces."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:600(title)
msgid "Availability zones (os-availability-zone)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:601(para)
msgid "Gets availability zone information."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:609(title)
msgid "Bare metal nodes (os-baremetal-nodes)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:610(para)
msgid "Bare metal nodes."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:616(title)
msgid "Servers with block device mapping format (servers, os-block-device-mapping)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:618(para)
msgid "Creates a server with a block device mapping."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:624(title)
msgid "Cells (os-cells, capacities)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:625(para)
msgid "Adds neighbor cells, lists neighbor cells, and gets the capabilities of the local cell."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:634(title)
msgid "Root certificates (os-certificates)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:635(para)
msgid "Creates and shows details for a root certificate."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:641(title)
msgid "Cloudpipe (os-cloudpipe)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:642(para)
msgid "Manages virtual VPNs for projects."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:648(title)
msgid "Server consoles (servers, os-consoles, os-console-auth-token)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:649(para)
msgid "Manages server consoles."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:655(title)
msgid "Fixed IPs (os-fixed-ips)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:656(para)
msgid "Shows data for a specified fixed IP, such as host name, CIDR, and address. Also, reserves and frees a fixed IP address."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:665(title)
msgid "Floating IP DNS records (os-floating-ip-dns)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:666(para)
msgid "Manages DNS records associated with IP addresses allocated by the floating IPs extension. Requests are dispatched to a DNS driver selected at startup."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:676(title)
msgid "Floating IP pools (os-floating-ip-pools)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:677(para)
msgid "Manages groups of floating IPs."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:685(title)
msgid "Floating IPs (os-floating-ips)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:686(para)
msgid "Assigns and allocates floating IP addresses to instances that run in an OpenStack cloud."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:695(title)
msgid "Floating IPs bulk (os-floating-ips-bulk)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:696(para)
msgid "Bulk-creates, deletes, and lists floating IPs. Default pool name is <code>nova</code>. To view available pools, use the <code>os-floating-ip-pools</code> extension."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:705(title)
msgid "Ping instances (os-fping)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:706(para)
msgid "Pings all or specified instances and reports which ones are alive."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:714(title)
msgid "Hosts (os-hosts)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:715(para)
msgid "Manages physical hosts."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:723(title)
msgid "Hypervisors (os-hypervisors)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:724(para) ./api-ref/src/docbkx/ch_compute-v2.1.xml:769(para)
msgid "Displays extra statistical information from the machine that hosts the hypervisor through the API for the hypervisor (XenAPI or KVM/libvirt)."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:734(title)
msgid "Instance usage audit log (os-instance-usage-audit-log)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:735(para)
msgid "Administrator only. Monitors task logs."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:743(title)
msgid "Migrations (os-migrations)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:744(para)
msgid "Shows data on migrations."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:752(title)
msgid "Networks (os-networks)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:753(para)
msgid "Creates, lists, shows information for, and deletes networks."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:756(para)
msgid "Adds network to a project, disassociates a network from a project, and disassociates a project from a network."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:760(para)
msgid "Associates host with and disassociates host from a network."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:768(title)
msgid "PCI pools (os-pci)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:779(title)
msgid "Quota class (os-quota-class-sets)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:788(title)
msgid "Quota sets (os-quota-sets)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:789(para)
msgid "Permits administrators, depending on policy settings, to view quotas for a project and view and update default quotas."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:798(title)
msgid "Scheduler hints (os-scheduler-hints)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:799(para)
msgid "Creates a server with scheduler hints that are passed directly to the scheduler."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:808(title)
msgid "Security groups (os-security-groups)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:809(para)
msgid "Lists, shows information for, creates, and deletes security groups."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:817(title)
msgid "Rules for default security group (os-security-group-default-rules)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:819(para)
msgid "Lists, shows information for, and creates default security group rules."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:828(title)
msgid "Rules for security group (os-security-group-rules)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:829(para)
msgid "Creates and deletes security group rules."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:837(title)
msgid "Execute external events (os-server-external-events)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:838(para)
msgid "Executes external events."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:846(title)
msgid "Server groups (os-server-groups)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:847(para)
msgid "Lists, shows information for, creates, and deletes server groups."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:864(title)
msgid "Manage services (os-services)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:865(para)
msgid "Lists all or only disabled Compute services for all hosts in a specified tenant. Logs information for disabled services. Enables or disables scheduling for, forces down, unsets the forced-down state of, or deletes a specified service."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:896(title)
msgid "Usage reports (os-simple-tenant-usage)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:897(para)
msgid "Reports usage statistics on compute and storage resources."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:905(title)
msgid "Project networks (os-tenant-networks)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:906(para)
msgid "Creates, lists, shows information for, and deletes project networks."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:914(title)
msgid "Volume extension (os-volumes, os-snapshots)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:915(para)
msgid "Manages volumes and snapshots for use with the Compute API."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2-experimental.xml:15(title)
msgid "Shared File Systems API v2 (EXPERIMENTAL)"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2-experimental.xml:16(para)
msgid "Contributors can change or remove the experimental part of the Shared File Systems API without maintaining backward compatibility."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2-experimental.xml:21(title)
msgid "Share actions (since API v2.5)"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2-experimental.xml:29(title)
msgid "Consistency groups (since API v2.4)"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2-experimental.xml:30(para)
msgid "Consistency groups enable you to create snapshots at the exact same point in time from multiple file system shares. For example, a database might place its tables, logs, and configuration on separate shares. To restore this database from a previous point in time, it makes sense to restore the logs, tables, and configuration together from the exact same point in time."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2-experimental.xml:38(para)
msgid "As an administrator, you can also reset the state of a consistency group and force-delete a specified consistency group in any state. Use the <code>policy.json</code> file to grant permissions for these actions to other roles."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2-experimental.xml:64(title)
msgid "Consistency group snapshots (since API v2.4)"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2-experimental.xml:65(para)
msgid "You can create snapshots of consistency groups. To create a snapshot, you specify the ID of the consistency group that you want to snapshot. After you create a consistency group snapshot, you can create a consistency group from it."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2-experimental.xml:71(para)
msgid "A consistency group snapshot can have member shares. To add a member share, include the <code>consistency_group_id</code> parameter in the create share request. This ID must match the ID of the consistency group from which the consistency group snapshot was created. Then, when you use consistency group snapshots to restore data, you can easily determine which shares belong to a specified consistency group."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2-experimental.xml:80(para)
msgid "As an administrator, you can also reset the state of a consistency group snapshot and force-delete a specified consistency group snapshot in any state. Use the <code>policy.json</code> file to grant permissions for these actions to other roles."
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:10(title)
msgid "Data Processing API v1.1 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:11(para)
msgid "Produce data processing operations."
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:13(title)
msgid "Plugins"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:14(para)
msgid "A plugin object defines the Hadoop or Spark version that it can install and which configurations can be set for the cluster."
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:31(title)
msgid "Image registry"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:32(para)
msgid "The image registry is a tool for managing images. Each plugin lists required tags for an image. The Data Processing service also requires a user name to log in to an instances OS for remote operations execution."
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:38(para)
msgid "The image registry enables you to add tags to and remove tags from images and define the OS user name."
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:60(title)
msgid "Node group templates"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:61(para)
msgid "A cluster is a group of nodes with the same configuration. A node group template configures a node in the cluster."
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:65(para)
msgid "A template configures Hadoop processes and VM characteristics, such as the number of reduced slots for task tracker, the number of CPUs, and the amount of RAM. The template specifies the VM characteristics through an OpenStack flavor."
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:84(title)
msgid "Cluster templates"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:85(para)
msgid "A cluster template configures a Hadoop cluster. A cluster template lists node groups with the number of instances in each group. You can also define cluster-scoped configurations in a cluster template."
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:104(title)
msgid "Clusters"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:105(para)
msgid "A cluster is a group of nodes with the same configuration."
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:122(title)
msgid "Event log"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:123(para)
msgid "The event log feature provides information about cluster provisioning. In the event of errors, the event log shows the reason for the failure."
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:134(title)
msgid "Data sources"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:135(para)
msgid "A data source object defines the location of input or output for MapReduce jobs and might reference different types of storage."
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:139(para)
msgid "The Data Processing service does not validate data source locations."
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:156(title)
msgid "Job binary internals"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:157(para)
msgid "Job binary internal objects represent data processing applications and libraries that are stored in the internal database."
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:179(title)
msgid "Job binaries"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:180(para)
msgid "Job binary objects represent data processing applications and libraries that are stored in either the internal database or the Object Storage service."
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:201(title)
msgid "Jobs"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:202(para)
msgid "A job object lists the binaries that a job needs to run. To run a job, you must specify data sources and job parameters."
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:206(para)
msgid "You can run a job on an existing or new transient cluster."
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:225(title)
msgid "Job executions"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:226(para)
msgid "A job execution object represents a Hadoop job that runs on a specified cluster. A job execution polls the status of a running job and reports it to the user. Also a user can cancel a running job."
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:249(title)
msgid "Job types"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:250(para)
msgid "Each plugin that supports EDP also supports specific job types. Different versions of a plugin might actually support different job types. Configuration options vary by plugin, version, and job type."
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:256(para)
msgid "The job types provide information about which plugins support which job types and how to configure the job types."
msgstr ""
#: ./api-ref/src/docbkx/api-ref-networking-v2.xml:11(title)
msgid "OpenStack Networking API v2.0 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/ch_orchestration-v1.xml:11(para)
msgid "Uses a template language to orchestrate OpenStack services."
msgstr ""
#: ./api-ref/src/docbkx/ch_orchestration-v1.xml:14(title)
msgid "General API information"
msgstr ""
#: ./api-ref/src/docbkx/ch_orchestration-v1.xml:15(para)
msgid "Authenticated calls that target a known URI but that use an HTTP method that the implementation does not support return a <code>405 Method Not Allowed</code> error code. In addition, the HTTP <code>OPTIONS</code> method is supported for each known URI. In both cases, the <code>Allow</code> response header indicates the HTTP methods that are supported for the resource."
msgstr ""
#: ./api-ref/src/docbkx/ch_orchestration-v1.xml:32(title)
msgid "Stacks"
msgstr ""
#: ./api-ref/src/docbkx/ch_orchestration-v1.xml:83(title)
msgid "Stack actions"
msgstr ""
#: ./api-ref/src/docbkx/ch_orchestration-v1.xml:84(para)
msgid "Performs non-lifecycle operations on the stack. Specify the action in the request body."
msgstr ""
#: ./api-ref/src/docbkx/ch_orchestration-v1.xml:97(title)
msgid "Stack resources"
msgstr ""
#: ./api-ref/src/docbkx/ch_orchestration-v1.xml:118(title)
msgid "Stack events"
msgstr ""
#: ./api-ref/src/docbkx/ch_orchestration-v1.xml:140(title)
msgid "Templates"
msgstr ""
#: ./api-ref/src/docbkx/ch_orchestration-v1.xml:169(title)
msgid "Build info"
msgstr ""
#: ./api-ref/src/docbkx/ch_orchestration-v1.xml:178(title)
msgid "Software configuration"
msgstr ""
#: ./api-ref/src/docbkx/ch_orchestration-v1.xml:207(title)
msgid "Manage service"
msgstr ""
#: ./api-ref/src/docbkx/api-ref-share-v1.xml:11(title)
msgid "OpenStack Shared File Systems API v1 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/api-ref-blockstorage-v2.xml:11(title)
msgid "OpenStack Block Storage API v2 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:27(title)
msgid "API extensions (extensions)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:36(para)
msgid "Shows absolute limits for a tenant."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:37(para)
msgid "An absolute limit value of <code>-1</code> indicates that the absolute limit for the item is infinite."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:45(title)
msgid "Volumes (volumes)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:46(para)
msgid "A volume is a detachable block storage device similar to a USB hard drive. You can attach a volume to one instance at a time."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:50(para)
msgid "The <code>snapshot_id</code> and <code>source_volid</code> parameters specify the ID of the snapshot or volume from which this volume originates. If the volume was not created from a snapshot or source volume, these values are null."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:56(para)
msgid "When you create, list, update, or delete volumes, the possible status values are:"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:59(caption)
msgid "Volume statuses"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:71(para)
msgid "The volume is being created."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:75(para)
msgid "The volume is ready to be attached to an instance."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:79(para)
msgid "attaching"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:80(para)
msgid "The volume is attaching to an instance."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:84(para)
msgid "in-use"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:85(para)
msgid "The volume is attached to an instance."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:90(para)
msgid "The volume is being deleted."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:94(para)
msgid "An error occurred during volume creation."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:99(para)
msgid "An error occurred during volume deletion."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:103(para)
msgid "backing-up"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:104(para)
msgid "The volume is being backed up."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:107(para)
msgid "restoring-backup"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:108(para)
msgid "A backup is being restored to the volume."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:112(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:231(para)
msgid "error_restoring"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:113(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:232(para)
msgid "An error occurred during backup restoration to a volume."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:117(para)
msgid "error_extending"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:118(para)
msgid "An error occurred while attempting to extend a volume."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:140(title)
msgid "Volume type access (volumes)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:141(para)
msgid "Creates private volumes."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:144(para)
msgid "By default, volumes are public. To create a private volume, set the <code>is_public</code> boolean field to <code>false</code> at volume creation time. To control access to a private volume, you add a project to or remove a project from the volume. Private volume types without projects are only accessible by users with the administrative role and context."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:159(title)
msgid "Volume actions (volumes, action)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:160(para)
msgid "Performs actions for a specified volume. Extends the size, resets statuses for, sets image metadata, or removes image metadata from a volume."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:178(title)
msgid "Backups (backups)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:179(para)
msgid "A backup is a full copy of a volume stored in an external service. The service can be configured. The only supported service is Object Storage. A backup can subsequently be restored from the external service to either the same volume that the backup was originally taken from or to a new volume. Backup and restore operations can only be carried out on volumes that are in an unattached and available state."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:188(para)
msgid "When you create, list, or delete backups, these status values are possible:"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:191(caption)
msgid "Backup statuses"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:204(para)
msgid "The backup is being created."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:209(para)
msgid "The backup is ready to be restored to a volume."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:215(para)
msgid "The backup is being deleted."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:220(para)
msgid "An error has occurred with the backup."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:225(para)
msgid "restoring"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:226(para)
msgid "The backup is being restored to a volume."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:238(para)
msgid "In the event of an error, more information about the error can be found in the <literal>fail_reason</literal> field for the backup."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:259(title)
msgid "Backup actions (backups, action)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:260(para)
msgid "Force-deletes a backup."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:270(title)
msgid "Capabilities for storage back ends (capabilities)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:271(para)
msgid "Shows capabilities for a storage back end."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:307(title)
msgid "Quality of service (QoS) specifications (qos-specs)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:309(para)
msgid "Creates, lists, shows details for, associates, disassociates, sets keys, unsets keys, and deletes quality of service (QoS) specifications."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:334(title)
msgid "Volume types (types)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:353(title)
msgid "Volume snapshots (snapshots)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:354(para)
msgid "A snapshot is a point-in-time copy of the data that a volume contains."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:356(para)
msgid "When you create, list, or delete snapshots, these status values are possible:"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:359(caption)
msgid "Snapshot statuses"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:372(para)
msgid "The snapshot is being created."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:377(para)
msgid "The snapshot is ready to be used."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:382(para)
msgid "The snapshot is being deleted."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:387(para)
msgid "An error occurred during snapshot creation."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:393(para)
msgid "An error occurred during snapshot deletion."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:419(title)
msgid "Volume manage extension (os-volume-manage)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:420(para)
msgid "Creates volumes by using existing storage instead of allocating new storage."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:427(title)
msgid "Volume image metadata extension (os-vol-image-meta)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:428(para)
msgid "Shows image metadata that is associated with a specified volume."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v1.xml:18(para)
msgid "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."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v1.xml:24(para)
msgid "Starting with API v2.0, the API uses Compute-style micro-versions."
msgstr ""
#. Put one translator per line, in the form of NAME <EMAIL>, YEAR1, YEAR2
#: ./api-ref/src/docbkx/ch_share-v1.xml:0(None)
msgid "translator-credits"
msgstr ""