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

Change-Id: Iddd033fc590b62f5aa360145399777f30ebe204f
2016-04-13 06:02:19 +00:00

3841 lines
165 KiB
Plaintext

msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2016-04-13 06:01+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-2016"
msgstr ""
#: ./api-ref/src/docbkx/api-ref-identity-v2.xml:11(title)
msgid "OpenStack Identity API v2 (DEPRECATED)"
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)
msgid "Versions"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-admin-v2.xml:21(title) ./api-ref/src/docbkx/ch_identity-v2.xml:25(title) ./api-ref/src/docbkx/ch_networking-v2-ext.xml:16(title)
msgid "Extensions"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-admin-v2.xml:22(para)
msgid "For information about Identity API v2.0 extensions, see <link xlink:href=\"http://developer.openstack.org/api-ref-identity-v2.html#identity-api-extensions\">Extensions</link>."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-admin-v2.xml:28(title)
msgid "Tokens"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-admin-v2.xml:44(title) ./api-ref/src/docbkx/ch_identity-v3.xml:103(link)
msgid "Users"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-admin-v2.xml:61(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:70(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, API v2.2, and API v2.3."
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/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_networking-v2.xml:26(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-v2.xml:14(title) ./api-ref/src/docbkx/ch_images-v1.xml:22(title) ./api-ref/src/docbkx/ch_compute-v2.1.xml:39(title) ./api-ref/src/docbkx/ch_orchestration-v1.xml:23(title) ./api-ref/src/docbkx/ch_clustering-v1.xml:17(title) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:16(title)
msgid "API versions"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:29(title)
msgid "Images (images)"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:30(para)
msgid "Creates, lists, updates, and deletes images."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:31(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:36(para)
msgid "The possible status values for images are:"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:40(caption)
msgid "Image status"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:45(th) ./api-ref/src/docbkx/ch_share-v2.xml:168(th) ./api-ref/src/docbkx/ch_share-v2.xml:731(th) ./api-ref/src/docbkx/ch_networking-v2-ext.xml:123(th) ./api-ref/src/docbkx/ch_networking-v2-ext.xml:182(th) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:68(th) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:216(th) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:428(th)
msgid "Status"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:46(th) ./api-ref/src/docbkx/ch_objectstorage-v1.xml:128(th) ./api-ref/src/docbkx/ch_identity-v3.xml:201(th) ./api-ref/src/docbkx/ch_share-v2.xml:169(th) ./api-ref/src/docbkx/ch_share-v2.xml:732(th) ./api-ref/src/docbkx/ch_networking-v2-ext.xml:124(th) ./api-ref/src/docbkx/ch_networking-v2-ext.xml:183(th) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:69(th) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:217(th) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:429(th)
msgid "Description"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:51(para)
msgid "queued"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:53(para)
msgid "The Image service reserved an image ID for the image in the registry but did not yet upload any image data."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:61(para)
msgid "saving"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:63(para)
msgid "The Image service is currently uploading the raw data for the image."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:70(para) ./api-ref/src/docbkx/ch_share-v2.xml:738(code)
msgid "active"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:72(para)
msgid "The image is active and fully available in the Image service."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:79(para)
msgid "killed"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:81(para)
msgid "An image data upload error occurred."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:87(para)
msgid "deleted"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:89(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:97(para)
msgid "pending_delete"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:99(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:127(title)
msgid "Image data (images, file)"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:128(para)
msgid "Uploads and downloads raw image data."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:139(title)
msgid "Image tags (images, tags)"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:140(para)
msgid "Adds and deletes image tags."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:151(title)
msgid "Members (images, members)"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:152(para)
msgid "Creates, lists, updates, and deletes image members."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:168(title)
msgid "Image schemas (schemas, image, images, member, members)"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:169(para)
msgid "Gets a JSON-schema document that represents an images or image entity."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:177(title)
msgid "Metadata definition resource types (since API v2.0) (metadefs, namespaces, resource_types)"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:178(para)
msgid "Lists resource types. Also, creates, lists, and removes resource type associations in a namespace."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:186(title)
msgid "Metadata definition namespaces (since API v2.0) (metadefs, namespaces)"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:187(para)
msgid "Creates, lists, shows details for, updates, and deletes metadata definition namespaces. Defines namespaces that can contain property definitions, object definitions, and resource type associations."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:197(title)
msgid "Metadata definition properties (since API v2.0) (metadefs, namespaces, properties)"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:198(para)
msgid "Creates, lists, shows details for, updates, and deletes metadata definition properties."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:206(title)
msgid "Metadata definition objects (since API v2.0) (metadefs, namespaces, objects)"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:207(para)
msgid "Creates, lists, shows details for, updates, and deletes metadata definition objects."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:215(title)
msgid "Metadata definition tags (since API v2.0) (metadefs, namespaces, tags)"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:216(para)
msgid "Creates, lists, shows details for, updates, and deletes metadata definition tags."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:224(title)
msgid "Metadata definition schemas (schemas, metadefs, namespace, namespaces, object, objects, property, properties, tag, tags, resource_type, resource_types)"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:225(para)
msgid "Gets a JSON-schema document that represents a metadata definition entity."
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:233(title)
msgid "Tasks (since API v2.2) (tasks)"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v2.xml:234(para)
msgid "Creates, lists, and shows details for tasks."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v2-ext.xml:14(title) ./api-ref/src/docbkx/itemizedlist-service-list.xml:65(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:21(para)
msgid "Supports create, read, update, and delete (CRUD) operations for users, tenants, roles, and services. Requires administrator privileges."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v2-ext.xml:30(title)
msgid "OS-KSCATALOG admin extension"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v2-ext.xml:31(para)
msgid "Supports CRUD operations for endpoint templates and endpoints. Requires administrator privileges."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v2-ext.xml:40(title)
msgid "OS-KSEC2 admin extension"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v2-ext.xml:41(para)
msgid "Supports Amazon Elastic Compute (EC2) style authentication."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v2-ext.xml:49(title)
msgid "OS-KSS3 admin extension"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v2-ext.xml:55(title)
msgid "OS-KSVALIDATE admin extension"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2.xml:10(title) ./api-ref/src/docbkx/itemizedlist-service-list.xml:80(link)
msgid "Networking API v2.0 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2.xml:11(para)
msgid "Use virtual networking services among devices that the OpenStack Compute service manages. 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 an IP address from the block or let OpenStack Networking choose the first available IP address."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2.xml:21(para)
msgid "Effective in the OpenStack Liberty release, the Networking API v2.0 does not support XML requests and responses."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2.xml:27(para)
msgid "Lists information for all Networking API versions."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2.xml:36(title)
msgid "Networks"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2.xml:37(para)
msgid "Lists, shows details for, creates, updates, and deletes networks."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2.xml:56(title)
msgid "Subnets"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2.xml:57(para)
msgid "Lists, shows details for, creates, updates, and deletes subnet resources."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2.xml:65(title)
msgid "Ports"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2.xml:66(para)
msgid "Lists, shows details for, creates, updates, and deletes ports."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2.xml:73(title)
msgid "Service providers"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2.xml:74(para)
msgid "Lists service providers."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:14(title) ./api-ref/src/docbkx/itemizedlist-service-list.xml:50(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:56(title)
msgid "OS-ENDPOINT-POLICY extension (OS-ENDPOINT-POLICY)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:28(link) ./api-ref/src/docbkx/ch_identity-v3-ext.xml:127(title)
msgid "OS-INHERIT extension (OS-INHERIT)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:35(link) ./api-ref/src/docbkx/ch_identity-v3-ext.xml:141(title)
msgid "Key Distribution Server (KDS) extension (OS-KDS)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:42(link) ./api-ref/src/docbkx/ch_identity-v3-ext.xml:364(title)
msgid "OAuth extension (OS-OAUTH1)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:49(link) ./api-ref/src/docbkx/ch_identity-v3-ext.xml:431(title)
msgid "Trust extension (OS-TRUST)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:57(para)
msgid "Creates, verifies, and deletes associations between service endpoints and policies. Such associations enable an endpoint to request its policy."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:62(para)
msgid "To create, check, or delete an association, you reference a policy by its ID in the Identity server."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:66(para)
msgid "The extension supports these associations:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:71(para)
msgid "A policy and endpoint association."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:76(para)
msgid "A policy and service-type endpoint in a region association."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:81(para)
msgid "A policy and service-type endpoint association."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:86(para)
msgid "This order reflects policies in their most to least-specific order."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:89(para)
msgid "When an endpoint requests the appropriate policy for itself, the extension finds the policy by traversing the ordered sequence of methods of association. The extension shows the policy for the first association that it finds."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:95(para)
msgid "If the region of the endpoint has a parent, the extension examines the region associations up the region tree in ascending order. For region associations, the extension examines any parent regions in ascending order. The extension does not combine polices."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:128(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:132(para)
msgid "(Since API v3.4) The OS-INHERIT extension allows inheritance from both projects and 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:142(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:156(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:165(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:177(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:183(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:192(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:203(para)
msgid "Other guidelines:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:206(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 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:220(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:230(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:246(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:260(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:268(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:278(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:288(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:297(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:302(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:310(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:321(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:333(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:338(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:365(para)
msgid "Enables users to delegate roles to third-party consumers through <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:370(para)
msgid "A user is an Identity API user who delegates its roles and who authorizes request tokens."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:374(para)
msgid "A consumer is a third-party application that uses OAuth to access a protected resource."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:378(para)
msgid "Administrative users use an OAuth-derived token to act on behalf of the authorizing user."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:382(para)
msgid "The consumer uses a request token to get authorization from the user. The consumer provides an OAuth verifier string with the request token in exchange for an access token."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:387(para)
msgid "The consumer uses an access token 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:392(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 token. Both request and access tokens have token secrets."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:398(para)
msgid "Delegated authentication through OAuth occurs as follows:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:403(para)
msgid "A user creates a consumer."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:406(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:411(para)
msgid "The user authorizes the request token."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:414(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:418(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:422(para)
msgid "The consumer uses the access token to request an Identity API token."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:432(para)
msgid "Creates a trust."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:435(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, known as the trustee, for a limited time."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:443(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, the API automatically revokes any trusts and the related tokens that the user issued with that role."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3-ext.xml:450(para)
msgid "For more information, see <link xlink:href=\"http://docs.openstack.org/admin-guide/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:14(title) ./api-ref/src/docbkx/itemizedlist-service-list.xml:90(link)
msgid "Object Storage API v1 (SUPPORTED)"
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:15(para)
msgid "Manages the accounts, containers, and objects in the Object Storage system."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:19(para)
msgid "To run the cURL command examples for these requests, set these environment variables:"
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:25(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:33(para)
msgid "<code>token</code>. The authentication token for Object Storage."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:39(para)
msgid "To obtain these values, run the <placeholder-1/> command."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:43(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:59(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:64(para)
msgid "The API returns the <code>Range Not Satisfiable (416)</code> response code for any ranged requests that specify more than:"
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:70(para)
msgid "Fifty ranges."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:75(para)
msgid "Three overlapping ranges."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:80(para)
msgid "Eight non-increasing ranges."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:86(title)
msgid "Discoverability"
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:87(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:98(title)
msgid "Endpoints"
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:99(para)
msgid "If configured, lists endpoints for an account."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:110(title)
msgid "Accounts"
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:111(para)
msgid "Lists containers for an account. Creates, updates, shows, and deletes account metadata."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:115(para)
msgid "Account metadata operations work differently than container and object metadata operations work. Depending on the contents of your account metadata request, the Object Storage API updates the metadata in one of these ways:"
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:122(caption)
msgid "Account metadata operations"
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:127(th)
msgid "POST request body contains"
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:134(para) ./api-ref/src/docbkx/ch_objectstorage-v1.xml:150(para)
msgid "A metadata key without a value."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:137(para) ./api-ref/src/docbkx/ch_objectstorage-v1.xml:169(para)
msgid "The metadata key already exists for the account."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:142(para)
msgid "The API removes the metadata item from the account."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:153(para) ./api-ref/src/docbkx/ch_objectstorage-v1.xml:184(para)
msgid "The metadata key does not already exist for the account."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:159(para)
msgid "The API ignores the metadata key."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:166(para) ./api-ref/src/docbkx/ch_objectstorage-v1.xml:181(para)
msgid "A metadata key value."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:174(para)
msgid "The API updates the metadata key value for the account."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:190(para)
msgid "The API adds the metadata key and value pair, or item, to the account."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:198(para)
msgid "One or more account metadata items are omitted."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:201(para)
msgid "The metadata items already exist for the account."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:207(para)
msgid "The API does not change the existing metadata items."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:215(para)
msgid "For these requests, specifying the <code>X-Remove-Account-Meta-*</code> request header for the key with any value is equivalent to specifying the <code>X-Account-Meta-*</code> request header with an empty value."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:220(para)
msgid "Metadata keys must be treated as case-insensitive at all times. These keys can contain ASCII 7-bit characters that are not control (0-31) characters, DEL, or a separator character, according to <link xlink:href=\"http://www.w3.org/Protocols/rfc2616/rfc2616.html\">HTTP/1.1</link>. Also, Object Storage does not support the underscore character, which it silently converts to a hyphen."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:228(para)
msgid "The metadata values in Object Storage do not follow HTTP/1.1 rules for character encodings. You must use a UTF-8 encoding to get a byte array for any string that contains characters that are not in the 7-bit ASCII 0-127 range. Otherwise, Object Storage returns the 404 response code for ISO-8859-1 characters in the 128-255 range, which is a direct violation of the HTTP/1.1 <link xlink:href=\"http://www.w3.org/Protocols/rfc2616/rfc2616-sec2.html#sec2.2\">basic rules</link>."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:247(title)
msgid "Containers"
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:248(para)
msgid "Lists objects in a container. Creates, shows details for, and deletes containers. Creates, updates, shows, and deletes container metadata."
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:265(title)
msgid "Objects"
msgstr ""
#: ./api-ref/src/docbkx/ch_objectstorage-v1.xml:266(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:40(link)
msgid "Database Service API v1.0 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:13(para)
msgid "Lists information for all Database Service API versions and shows Database Service v1.0 details."
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:30(title)
msgid "Database instances (instances)"
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:31(para)
msgid "Creates, lists, shows details for, attaches a configuration group to, detaches a configuration group from, deletes, lists configuration defaults, creates root, and determines whether root is enables for instances."
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:57(title)
msgid "Database instance actions (action)"
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:58(para)
msgid "Resizes instances and volumes and restarts instances."
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:71(title)
msgid "Databases (databases)"
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:72(para)
msgid "Creates, lists all, and deletes databases."
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:88(title)
msgid "Users (users)"
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:89(para)
msgid "Creates, lists all, and deletes users."
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:108(title)
msgid "Flavors (flavors)"
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:109(para)
msgid "Lists all flavors and shows details for a flavor, by ID."
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:124(title)
msgid "Data stores (datastores)"
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:125(para)
msgid "Lists data store versions, lists parameters for data stores, and shows parameter details for a data store version."
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:144(title)
msgid "Configuration groups (configurations)"
msgstr ""
#: ./api-ref/src/docbkx/ch_database-v1.xml:145(para)
msgid "Creates and lists all configuration groups."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:10(title) ./api-ref/src/docbkx/itemizedlist-service-list.xml:20(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 attach 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 occurred."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:32(para)
msgid "ERROR_DELETING. A volume deletion error occurred."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:38(para)
msgid "Lists information about API versions."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:51(title)
msgid "Volumes"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:52(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:73(title)
msgid "Volume types"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:74(para)
msgid "Lists, creates, updates, shows information for, and deletes volume types."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:91(title)
msgid "Snapshots"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:92(para)
msgid "Creates, lists, shows information for, and deletes snapshots. Shows and updates snapshot metadata."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:115(title) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:340(title)
msgid "Quota sets extension (os-quota-sets)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:116(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:341(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:368(para)
msgid "Administrators only, depending on policy settings."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v1.xml:119(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:344(para)
msgid "Shows, updates, and deletes quotas for a tenant."
msgstr ""
#: ./api-ref/src/docbkx/api-ref-baremetal-v1.xml:11(title)
msgid "OpenStack Bare Metal API v1 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/api-ref-baremetal-v1.xml:13(year)
msgid "2016"
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:34(para)
msgid "You must install the packages for each API separately."
msgstr ""
#: ./api-ref/src/docbkx/preface.xml:37(para)
msgid "You can use the APIs and extensions after you authenticate through the Identity API. In exchange for a set of authentication credentials, the Identity service generates tokens. A token represents the authenticated identity of a user and, optionally, grants authorization on a specific project or domain."
msgstr ""
#: ./api-ref/src/docbkx/preface.xml:44(para) ./api-ref/src/docbkx/ch_identity-v3.xml:134(para)
msgid "The body of an authentication request must include a payload that specifies the authentication method, which is <code>password</code> or <code>token</code>, the credentials, and, optionally, the authorization scope. You can scope a token to a project or domain, or the token can be unscoped. You cannot scope a token to both a project and domain."
msgstr ""
#: ./api-ref/src/docbkx/preface.xml:61(para)
msgid "To get started with the APIs, see the <link xlink:href=\"http://developer.openstack.org/api-guide/quick-start/\">OpenStack API Guide</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:110(link)
msgid "Telemetry API v2 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:11(para)
msgid "Manages alarms, meters, samples, resources, and capabilities through a set of services:"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:17(para)
msgid "<link xlink:href=\"http://docs.openstack.org/developer/aodh/\">Aodh</link>. An alarm service."
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:23(para)
msgid "<link xlink:href=\"http://docs.openstack.org/developer/ceilometer/\"> Ceilometer </link>. A data collection service."
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:29(para)
msgid "<link xlink:href=\"http://docs.openstack.org/developer/gnocchi/\">Gnocchi</link>. A time-series database and resource indexing service."
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:36(para)
msgid "If Gnocchi is enabled, meters, samples, and resources API operations return the <code>410</code> response code."
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:41(title)
msgid "Alarms"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:42(para)
msgid "Lists, creates, gets details for, updates, and deletes alarms."
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:70(title)
msgid "Meters"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:71(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:78(para)
msgid "Also, computes and lists statistics for samples in a 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:86(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:90(para)
msgid "The API silently ignores any duplicate aggregate function and parameter pairs."
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:94(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:102(emphasis)
msgid "Examples:"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:103(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:108(para) ./api-ref/src/docbkx/ch_telemetry-v2.xml:150(para)
msgid "The response looks like this:"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:126(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:131(para)
msgid "The following, more complex, example determines:"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:136(para)
msgid "The number of distinct instances (<code>cardinality</code>)"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:141(para)
msgid "The total number of instance samples (<code>count</code>) for a tenant in 15-minute intervals (<code>period</code> and <code>groupby</code> options)"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:223(title)
msgid "Samples"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:224(para)
msgid "Lists all samples and gets information for a sample."
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:227(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:245(title)
msgid "Resources"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:246(para)
msgid "Lists all and gets information for resources."
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:259(title)
msgid "Capabilities"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:260(para)
msgid "Gets information for API and storage capabilities."
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:261(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:267(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:273(para)
msgid "You can optionally configure separate database back ends for samples, events, and alarms definitions. The <code>capabilities</code> response shows a value of <code>true</code> to indicate that the definitions database for samples, events, or alarms is ready to use in a production environment."
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:289(title) ./api-ref/src/docbkx/ch_clustering-v1.xml:90(title)
msgid "Events"
msgstr ""
#: ./api-ref/src/docbkx/ch_telemetry-v2.xml:290(para)
msgid "Lists all events and shows details for an event."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:14(title) ./api-ref/src/docbkx/itemizedlist-service-list.xml:45(link)
msgid "Identity API v3 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:15(para)
msgid "The Identity service generates authentication tokens that permit access to the OpenStack services REST APIs. Clients obtain this token and the URL endpoints for other service APIs by supplying their valid credentials to the authentication service."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:21(para)
msgid "Each time you make a REST API request to an OpenStack service, you supply your authentication token in the <code>X-Auth-Token</code> request header."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:26(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:31(para)
msgid "The Identity service <link xlink:href=\"http://docs.openstack.org/liberty/config-reference/content/keystone-configuration-file.html\">keystone.conf</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:36(para)
msgid "For information about Identity API protection, see <link xlink:href=\"http://docs.openstack.org/admin-guide/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:42(para)
msgid "This page lists the Identity API operations in the following order:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:53(link)
msgid "Authentication and token management"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:58(link)
msgid "Credentials"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:63(link)
msgid "Domains"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:68(link)
msgid "Domain configuration"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:73(link)
msgid "Groups"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:78(link) ./api-ref/src/docbkx/ch_clustering-v1.xml:125(title)
msgid "Policies"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:83(link)
msgid "Projects"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:88(link)
msgid "Regions"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:93(link)
msgid "Roles and role assignments"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:98(link)
msgid "Service catalog and endpoints"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:127(title)
msgid "Authentication and token management (auth, tokens)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:128(para)
msgid "In exchange for a set of authentication credentials, the Identity service generates tokens. A token represents the authenticated identity of a user and, optionally, grants authorization on a specific project or domain."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:142(para)
msgid "Tokens have IDs, which the Identity API returns in the <code>X-Subject-Token</code> response header."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:146(para)
msgid "Also, validates an authentication token and lists the domains, projects, roles, and endpoints to which the token gives access. Forces the immediate revocation of a token."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:151(para)
msgid "After you obtain an authentication token, you can:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:156(para)
msgid "Make REST API requests to other OpenStack services. You supply the ID of your authentication token in the <code>X-Auth-Token</code> request header."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:163(para)
msgid "Validate your authentication token and list the domains, projects, roles, and endpoints that your token gives you access to."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:170(para)
msgid "Use your token to request another token scoped for a different domain and project."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:176(para)
msgid "Force the immediate revocation of a token."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:181(para)
msgid "List revoked public key infrastructure (PKI) tokens."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:186(para)
msgid "The Identity API treats expired tokens as no longer valid tokens. The deployment determines how long expired tokens are stored."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:191(para)
msgid "These authentication errors can occur:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:195(caption)
msgid "Authentication errors"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:200(th)
msgid "Response code"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:208(code)
msgid "Bad Request (400)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:212(para)
msgid "The Identity service failed to parse the request as expected. One of the following errors occurred:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:218(para)
msgid "A required attribute was missing."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:223(para)
msgid "An attribute that is not allowed was specified, such as an ID on a request in a basic CRUD operation."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:230(para)
msgid "An attribute of an unexpected data type was specified."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:241(code)
msgid "Unauthorized (401)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:245(para)
msgid "One of the following errors occurred:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:250(para)
msgid "Authentication was not performed."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:255(para)
msgid "The specified <code>X-Auth-Token</code> header is not valid."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:261(para)
msgid "The authentication credentials are not valid."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:271(code)
msgid "Forbidden (403)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:275(para)
msgid "The identity was successfully authenticated but it is not authorized to perform the requested action."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:284(code)
msgid "Not Found (404)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:288(para)
msgid "An operation failed because a referenced entity cannot be found by ID. For a request, the referenced entity might be specified in the request body rather than in the resource path."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:299(code)
msgid "Conflict (409)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:303(para)
msgid "A or operation failed. For example, a client tried to update a unique attribute for an entity, which conflicts with that of another entity in the same collection."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:309(para)
msgid "Or, a client issued a create operation twice on a collection with a user-defined, unique attribute. For example, a client made a /users request two times for the unique, user-defined name attribute for a user entity."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:339(title)
msgid "Credentials (credentials)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:340(para)
msgid "In exchange for a set of authentication credentials that the user submits, the Identity service generates and returns a token. A token represents the authenticated identity of a user and, optionally, grants authorization on a specific project or domain."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:346(para)
msgid "You can list all credentials, and create, show details for, update, and delete a credential."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:359(title)
msgid "Domains (domains, users, groups, roles)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:360(para)
msgid "A domain is a collection of users, groups, and projects. Each group and project is owned by exactly one domain."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:364(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 these attributes is as follows:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:372(para)
msgid "<emphasis role=\"italic\">Domain name</emphasis>. Globally unique across all domains."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:378(para)
msgid "<emphasis role=\"italic\">Role name</emphasis>. Globally unique across all domains."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:384(para)
msgid "<emphasis role=\"italic\">User name</emphasis>. Unique within the owning domain."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:390(para)
msgid "<emphasis role=\"italic\">Project name</emphasis>. Unique within the owning domain."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:396(para)
msgid "<emphasis role=\"italic\">Group name</emphasis>. Unique within the owning domain."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:420(title)
msgid "Domain configuration (domains, config) (since v3.4) (EXPERIMENTAL)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:421(para)
msgid "You can manage domain-specific configuration options."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:424(para)
msgid "Domain-specific configuration options are structured within their group objects. The API supports only the <code>identity</code> and <code>ldap</code> groups. These groups override the default configuration settings for the storage of users and groups by the Identity server."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:431(para)
msgid "You can create, update, and delete domain-specific configuration options by using the HTTP , , and methods. When updating, it is only necessary to include those options that are being updated."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:437(para)
msgid "To create an option, use the method. The Identity API does not return options that are considered sensitive, although you can create and update these options. The only option currently considered sensitive is the password option within the ldap group."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:444(para)
msgid "The API enables you to include sensitive options as part of non- sensitive options. For example, you can include the password as part of the <code>url</code> option."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:449(para)
msgid "If you try to create or update configuration options for groups other than the <code>identity</code> or <code>ldap</code> groups, the <code>Forbidden (403)</code> response code is returned."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:455(para)
msgid "For information about how to integrate the Identity service with LDAP, see <link xlink:href=\"http://docs.openstack.org/admin-guide/keystone_integrate_with_ldap.html\">Integrate Identity with LDAP</link>."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:470(title)
msgid "Groups (groups, users)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:471(para)
msgid "A group is a collection of users. Each group is owned by a domain."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:474(para)
msgid "When you grant a role to a group, you explicitly associate that group with a project or domain. This action is equivalent to granting the role to each group member on that project and domain."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:479(para)
msgid "When you grant a role to a group, that role is automatically granted to any user that you add to the group. When you revoke a role from a group, that role is automatically revoked from any user that you remove from the group. Any token that authenticates that user, project, and domain is revoked."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:486(para)
msgid "As with users, a group without any role grants is useless from the perspective an OpenStack service and has no access to resources. However, a group without role grants is permitted as a way of acquiring or loading users and groups from external sources before mapping them to projects and domains."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:504(title)
msgid "Policies (policies)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:505(para)
msgid "A policy is an arbitrarily serialized policy engine rule set to be consumed by a remote service."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:509(para)
msgid "You encode policy rule sets into a blob that remote services can consume. 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:538(title)
msgid "Projects (projects, users, groups, roles)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:539(para)
msgid "A project is the base unit of ownership. Resources are owned by a specific project. A project is owned by a specific domain."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:543(para)
msgid "(Since v3.4) You can create a hierarchy of projects by setting a parent ID when you create projects. All projects in a hierarchy must be owned by the same domain."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:548(para)
msgid "(Since v3.6) Optionally, you can create a project that behaves both as a project and a domain. As a domain, the project provides a name space in which you can create users, groups, and other projects. If you create a project that behaves as a domain, you cannot update this project to behave like a regular project."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:575(title)
msgid "Regions (regions) (since v3.2)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:576(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:581(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/ch_identity-v3.xml:586(para)
msgid "You can list, create, update, show details for, and delete regions."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:600(title)
msgid "Roles (roles)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:601(para)
msgid "Roles grant a user a set of permitted actions for either a specific project or an entire domain."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:605(para)
msgid "You can grant roles to a user on a project, including projects owned by other domains."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:609(para)
msgid "You can create, list, and delete roles. You can also list roles assigned to a specified domain, project, or user."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:613(para)
msgid "You can list role assignments and, since v3.6, all role assignments within a tree of projects. Use the query parameters to filter the list because the role assignments list can be long. Some typical examples are:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:621(para)
msgid "List role assignments for the specified user:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:629(para)
msgid "List role assignments for the specified project:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:637(para)
msgid "List all role assignments for a specified project and its sub- projects:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:643(para)
msgid "If you specify <code>include_subtree=true</code>, you must also specify the <code>scope.project.id</code>. Otherwise, this call returns the <code>Bad Request (400)</code> response code."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:651(para)
msgid "Each role assignment entity in the collection contains a link to the assignment that created the entity."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:655(para)
msgid "Use the <code>effective</code> query parameter to list effective assignments at the user, project, and domain level. This parameter allows for the effects of group membership. The group role assignment entities themselves are not returned in the collection. This represents the effective role assignments that would be included in a scoped token."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:663(para)
msgid "In the response, the <code>links</code> entity section for entities for group members also contains a URL that enables access to the membership of the group."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:668(para)
msgid "You can use the other query parameters with the <code>effective</code> parameter, such as:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:674(para)
msgid "Determine what a user can actually do:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:682(para)
msgid "Get the equivalent set of role assignments that are included in a project-scoped token response:"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:746(title)
msgid "Service catalog and endpoints (services, endpoints)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:747(para)
msgid "A service is an OpenStack web service that you can access through a URL, or endpoint."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:751(para)
msgid "A service catalog lists the services that are available to the caller based upon the current authorization."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:755(para)
msgid "You can create, list, show details for, update, and delete services. When you create or update a service, you can enable the service, which causes it and its endpoints to appear in the service catalog."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:761(para)
msgid "You can create, list, show details for, update, and delete endpoints."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:775(title)
msgid "Users (users, groups, projects, roles)"
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:776(para)
msgid "A user is an individual API consumer that is owned by a domain. A role explicitly associates a user with projects or domains. A user with no assigned roles has no access to OpenStack resources."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:781(para)
msgid "You can list, create, show details for, update, delete, and change the password for users."
msgstr ""
#: ./api-ref/src/docbkx/ch_identity-v3.xml:784(para)
msgid "You can also list groups, projects, and roles for a specified user. To list user roles, see <link xlink:href=\"http://developer.openstack.org/api-ref-identity-v3.html#roles-v3\">Roles</link>."
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:55(link)
msgid "Identity API v2.0 (SUPPORTED)"
msgstr ""
#: ./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-v2.xml:36(title)
msgid "Tokens and tenants"
msgstr ""
#: ./api-ref/src/docbkx/api-ref-clustering-v1.xml:11(title)
msgid "OpenStack Clustering API v1 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/api-ref-clustering-v1.xml:13(year)
msgid "2015-2016"
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_images-v1.xml:10(title) ./api-ref/src/docbkx/itemizedlist-service-list.xml:75(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:40(title) ./api-ref/src/docbkx/ch_compute-v2.1.xml:460(title)
msgid "Images"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v1.xml:58(title)
msgid "Members"
msgstr ""
#: ./api-ref/src/docbkx/ch_images-v1.xml:70(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_baremetal-api-v1.xml:10(title)
msgid "Bare Metal API v1 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/itemizedlist-service-list.xml:15(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:25(link) ./api-ref/src/docbkx/ch_clustering-v1.xml:10(title)
msgid "Clustering API v1 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/itemizedlist-service-list.xml:30(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:35(link)
msgid "Data Processing v1.1 (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/itemizedlist-service-list.xml:60(link)
msgid "Identity admin API v2.0 (SUPPORTED)"
msgstr ""
#: ./api-ref/src/docbkx/itemizedlist-service-list.xml:85(link) ./api-ref/src/docbkx/ch_networking-v2-ext.xml:14(title)
msgid "Networking API v2.0 extensions (CURRENT)"
msgstr ""
#: ./api-ref/src/docbkx/itemizedlist-service-list.xml:95(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:100(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:105(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/api-ref-identity-v2-ext.xml:11(title)
msgid "OpenStack Identity API v2 extensions (DEPRECATED)"
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.15\"</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:href=\"http://developer.openstack.org/api-ref-share-v1.html#share-api-v1\"> Shared File Systems API v1. </link>"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:32(para)
msgid "Subsequent API v2 micro-versions, such as v2.1, differ from API v1. 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:37(para)
msgid "Latest micro-version for <code>Liberty</code> release of Manila is 2.6"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:40(para)
msgid "Latest micro-version for <code>Mitaka</code> release of Manila is 2.15"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:44(link)
msgid "History of all Manila API changes."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:59(title)
msgid "API extensions"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:60(para)
msgid "Lists available Shared File Systems API extensions."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:70(title)
msgid "Limits"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:71(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:76(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:82(para)
msgid "Total maximum share memory, in GBs."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:85(para)
msgid "Number of share-networks."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:88(para)
msgid "Number of share-snapshots."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:91(para)
msgid "Number of shares."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:94(para)
msgid "Shares and total used memory, in GBs."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:97(para)
msgid "Snapshots and total used memory, in GBs."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:100(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:115(title)
msgid "Shares"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:116(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:121(para)
msgid "You can create a share and associate it with a network, list shares, and show information for, update, and delete a share."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:125(para)
msgid "To create a share, specify one of these supported protocols:"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:130(para)
msgid "<code>NFS</code>. Network File System (NFS)."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:135(para)
msgid "<code>CIFS</code>. Common Internet File System (CIFS)."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:140(para)
msgid "<code>GLUSTERFS</code>. Gluster file system (GlusterFS)."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:145(para)
msgid "<code>HDFS</code>. Hadoop Distributed File System (HDFS)."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:150(para)
msgid "<code>CEPHFS</code>. Ceph File System (CephFS)."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:155(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:159(para)
msgid "A share has one of these status values:"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:163(caption)
msgid "Share statuses"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:175(code) ./api-ref/src/docbkx/ch_share-v2.xml:447(code) ./api-ref/src/docbkx/ch_share-v2.xml:501(code) ./api-ref/src/docbkx/ch_share-v2.xml:764(code) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:74(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:223(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:435(para)
msgid "creating"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:178(para)
msgid "The share is being created."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:183(code) ./api-ref/src/docbkx/ch_share-v2.xml:450(code) ./api-ref/src/docbkx/ch_share-v2.xml:504(code) ./api-ref/src/docbkx/ch_share-v2.xml:755(code) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:93(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:247(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:459(para)
msgid "deleting"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:186(para)
msgid "The share is being deleted."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:191(code) ./api-ref/src/docbkx/ch_share-v2.xml:444(code) ./api-ref/src/docbkx/ch_share-v2.xml:498(code) ./api-ref/src/docbkx/ch_share-v2.xml:746(code) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:97(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:259(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:471(para)
msgid "error"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:194(para)
msgid "An error occurred during share creation."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:201(code) ./api-ref/src/docbkx/ch_share-v2.xml:453(code) ./api-ref/src/docbkx/ch_share-v2.xml:507(code) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:103(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:483(para)
msgid "error_deleting"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:204(para)
msgid "An error occurred during share deletion."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:211(code) ./api-ref/src/docbkx/ch_share-v2.xml:441(code) ./api-ref/src/docbkx/ch_share-v2.xml:495(code) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:78(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:235(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:447(para)
msgid "available"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:214(para)
msgid "The share is ready to use."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:219(code) ./api-ref/src/docbkx/ch_share-v2.xml:510(code)
msgid "manage_starting"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:222(para)
msgid "Share manage started."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:227(code) ./api-ref/src/docbkx/ch_share-v2.xml:513(code)
msgid "manage_error"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:230(para)
msgid "Share manage failed."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:235(code) ./api-ref/src/docbkx/ch_share-v2.xml:516(code)
msgid "unmanage_starting"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:238(para)
msgid "Share unmanage started."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:243(code) ./api-ref/src/docbkx/ch_share-v2.xml:519(code)
msgid "unmanage_error"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:246(para)
msgid "Share cannot be unmanaged."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:251(code)
msgid "unmanaged"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:254(para)
msgid "Share was unmanaged."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:259(code)
msgid "extending"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:262(para)
msgid "The extend, or increase, share size request was issued successfully."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:270(code)
msgid "extending_error"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:273(para)
msgid "Extend share failed."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:278(code)
msgid "shrinking"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:281(para)
msgid "Share is being shrunk."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:286(code)
msgid "shrinking_error"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:289(para)
msgid "Failed to update quota on share shrinking."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:294(code)
msgid "shrinking_possible_data_loss_error"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:297(para)
msgid "Shrink share failed due to possible data loss."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:314(para)
msgid "Configures Shared File Systems to manage a share. This API is available for micro-versions later than or equal to 2.7"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:329(title)
msgid "Share export locations (since API v2.9)"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:330(para)
msgid "Set of APIs used for viewing export locations of shares."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:333(para) ./api-ref/src/docbkx/ch_share-v2.xml:811(para)
msgid "By default, these APIs are admin-only. 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:342(para)
msgid "Lists all export locations for a share."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:351(para)
msgid "Show details of an export location belonging to a share."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:360(title)
msgid "Share metadata"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:361(para)
msgid "Shows, sets, updates, and unsets share metadata."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:376(title)
msgid "Share actions"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:377(para)
msgid "Grants or revokes share access, lists the permissions for a share, and explicitly updates the state of a share."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:381(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:387(para)
msgid "<code>rw</code>. Read and write (RW) access."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:392(para)
msgid "<code>ro</code>. Read-only (RO) access."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:397(para)
msgid "You must also specify one of these supported authentication methods:"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:403(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:410(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:419(para)
msgid "<code>user</code>. Authenticates by a 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:426(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:430(para)
msgid "As administrator, you can reset the state of a share and force-delete a 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:436(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:457(para)
msgid "If micro-version 1.0-2.6 is used then all share actions, defined below, should include prefix <code>os-</code> in top element of request JSON's body."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:462(para)
msgid "For example: {\"access_list\": null} is valid for v2.7+. And {\"os-access_list\": null} is valid for v1.0-2.6"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:481(title)
msgid "Share snapshots"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:482(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, manage, update, and delete share snapshots. After you create or manage a share snapshot, you can create a share from it."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:489(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:522(para)
msgid "As administrator, you can also reset the state of a snapshot and force-delete a 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:552(title)
msgid "Share networks"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:553(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:560(para)
msgid "You can create, update, view, and delete a share network."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:563(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:568(para)
msgid "Neutron network. Specify a network ID and subnet ID."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:572(para)
msgid "Nova network. Specify a network ID."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:576(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:582(para)
msgid "A share network has these attributes:"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:587(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:593(para)
msgid "The IP version of the network."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:598(para)
msgid "The network type, which is <code>vlan</code>, <code>vxlan</code>, <code>gre</code>, or <code>flat</code>."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:605(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:632(title)
msgid "Security services"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:633(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:640(para)
msgid "You can associate a share with from one to three security service types:"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:646(para)
msgid "<code>ldap</code>. LDAP."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:650(para)
msgid "<code>kerberos</code>. Kerberos."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:655(para)
msgid "<code>active_directory</code>. Microsoft Active Directory."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:660(para)
msgid "You can configure a security service with these options:"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:665(para)
msgid "A DNS IP address."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:668(para)
msgid "An IP address or host name."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:671(para)
msgid "A domain."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:674(para)
msgid "A user or group name."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:678(para)
msgid "The password for the user, if you specify a user name."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:697(title)
msgid "Share servers"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:698(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:705(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:712(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:716(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:722(para)
msgid "The possible share servers statuses are:"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:726(caption)
msgid "Share server statuses"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:741(para)
msgid "Share server was successfully set up."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:749(para)
msgid "The set up or deletion of the share server failed."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:758(para)
msgid "The share server has no dependent shares and is being deleted."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:767(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:786(title)
msgid "Share instances (since API v2.3)"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:787(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:807(title)
msgid "Share instance export locations (since API v2.9)"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:808(para)
msgid "Set of APIs used to view export locations of share instances."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:820(para)
msgid "Lists all export locations for a share instance."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:829(para)
msgid "Show details of an export location belonging to a share instance."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:838(title)
msgid "Share types"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:839(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:844(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:848(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:856(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:863(para)
msgid "You can set share types as either public or private. By default a share type is created as publicly accessible. Set <code>share_type_access:is_public</code> ( <code>os-share-type-access:is_public</code> for micro-versions 1.0-2.6) to <code>False</code> to make the share type private."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:870(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 private share type."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:875(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:881(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:886(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:890(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:896(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:900(para)
msgid "Set to <code>True</code> to find back ends that support share snapshots."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:903(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:909(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:915(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:923(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:932(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:939(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:943(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:976(title) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:531(title)
msgid "Back-end storage pools"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:977(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:991(title)
msgid "Services"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:992(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:998(para)
msgid "Administrators can also enable or disable a service."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:1002(para)
msgid "For old microversions 1.0-2.6 replace URL part <code>services</code> with <code>os-services</code>."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:1020(title)
msgid "Availability zones"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:1021(para)
msgid "Describes availability zones."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:1025(para)
msgid "For old microversions 1.0-2.6 replace URL part <code>availability-zones</code> with <code>os-availability-zone</code>."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:1037(title)
msgid "Manage share"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:1038(para)
msgid "Configures Shared File Systems to manage or unmanage a share."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:1041(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:1045(para)
msgid "You can unmanage a share that has no dependent snapshots."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:1048(para)
msgid "These APIs are available for micro-versions 1.0-2.6"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:1051(para)
msgid "Starting with micro-version 2.7 these APIs are available under 'shares' API group."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:1058(para)
msgid "Configures Shared File Systems to manage a share."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:1070(title)
msgid "Quota sets"
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:1071(para)
msgid "Provides quotas management support."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v2.xml:1075(para)
msgid "For old microversions 1.0-2.6 replace URL part <code>quota-sets</code> with <code>os-quota-sets</code>."
msgstr ""
#: ./api-ref/src/docbkx/ch_baremetal-api-v1.xml:11(para)
msgid "Manages chassis, drivers, links, nodes, and ports for use with the Bare Metal API, also known as ironic services."
msgstr ""
#: ./api-ref/src/docbkx/ch_baremetal-api-v1.xml:15(para)
msgid "Each Bare Metal API response returns the <code>X-OpenStack-Ironic-API-Minimum-Version</code> and <code>X-OpenStack-Ironic-API-Maximum-Version</code> headers, which indicate, respectively, the minimum and maximum supported API versions that the server supports."
msgstr ""
#: ./api-ref/src/docbkx/ch_baremetal-api-v1.xml:22(para)
msgid "The client can use the <code>X-OpenStack-Ironic-API-Version</code> request header to request an API version. If the client does not request an API version, the default is API v1.1, which is the minimum supported version. The client has access to the features that the requested API version supports. OpenStack recommends that clients always request a specific version of API. However, you can request the <code>latest</code> value, which always requests the most current, supported API version."
msgstr ""
#: ./api-ref/src/docbkx/ch_baremetal-api-v1.xml:51(title)
msgid "Chassis (chassis)"
msgstr ""
#: ./api-ref/src/docbkx/ch_baremetal-api-v1.xml:52(para)
msgid "Chassis operations."
msgstr ""
#: ./api-ref/src/docbkx/ch_baremetal-api-v1.xml:71(title)
msgid "Drivers (drivers)"
msgstr ""
#: ./api-ref/src/docbkx/ch_baremetal-api-v1.xml:91(title)
msgid "Links (links)"
msgstr ""
#: ./api-ref/src/docbkx/ch_baremetal-api-v1.xml:108(title)
msgid "Nodes (nodes)"
msgstr ""
#: ./api-ref/src/docbkx/ch_baremetal-api-v1.xml:125(title)
msgid "Ports (ports)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:16(para)
msgid "This documentation supports the API v2.1 base version. If you enable all extensions, 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:21(para)
msgid "Each API version lists the extensions that it requires to make the full request and responses 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:28(para)
msgid "Effective in the OpenStack Kilo release, the Compute API no longer supports XML in requests and responses."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:33(para)
msgid "For details about the Compute API, see the <link xlink:href=\"http://developer.openstack.org/api-guide/compute/\">Compute API</link>."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:40(para)
msgid "Lists information for all API versions."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:59(title)
msgid "Servers (servers)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:60(para)
msgid "Lists, creates, shows details for, updates, and deletes servers."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:61(emphasis)
msgid "Passwords"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:62(para)
msgid "When you create a server, you can specify a password through the optional <property>adminPass</property> attribute. The 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:70(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 meets the security requirements set by the compute provider. For security reasons, subsequent calls do not require this password."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:76(emphasis)
msgid "Server metadata"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:77(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 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:84(emphasis)
msgid "Server networks"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:85(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:91(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:97(emphasis)
msgid "Server personality"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:98(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:107(para)
msgid "Follow these guidelines when you inject files:"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:112(para)
msgid "The maximum size of the file path data is 255 bytes."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:117(para)
msgid "Encode the file contents as a Base64 string. The compute provider determines the maximum size of the file contents. The image that you use to create the server determines this value."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:123(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:130(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:138(para)
msgid "The <code>maxPersonalitySize</code> absolute limit is a byte limit that applies to all images in the deployment. Providers can set additional per-image personality limits."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:145(para)
msgid "The file injection might not occur until after the server builds and boots."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:149(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 (<code>chmod 440</code>)."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:155(emphasis)
msgid "Server access addresses"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:156(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, you cannot use the addresses that the implementation provides to access the server from outside the local LAN. Instead, the API might assign a separate <firstterm>access address</firstterm> 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. However, clients should use an access address to access the server directly."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:173(title)
msgid "Servers multiple create (servers)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:174(para)
msgid "Creates one or more servers."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:177(para)
msgid "Optionally, you can set <code>\"return_reservation_id\": \"True\"</code> in the request body to request that a reservation ID be returned instead of the newly created instance information. With this parameter, the response shows only the reservation ID."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:188(title)
msgid "Servers - run an action (servers, action)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:189(para)
msgid "Enables all users to performs an action on a server. Specify the action in the request body."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:193(para)
msgid "You can associate a fixed or floating IP address with a server instance, or disassociate a fixed or floating IP address from a server instance. You can attach a volume to a server."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:198(para)
msgid "You can create an image from a server, evacuate a server from a failed host to a new host, and force-delete a server before deferred cleanup. You can lock, pause, reboot, rebuild, rescue, resize, resume, confirm the resize of, revert a pending resize for, shelve, shelf-offload, unshelve, start, stop, unlock, unpause, and unrescue a server. You can also change the password of the server and add a security group to or remove a security group from a server. You can also trigger a crash dump into a server since Mitaka release."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:208(para)
msgid "You can get an RDP, serial, SPICE, or VNC console for a server."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:285(title)
msgid "Servers - run an administrative action (servers, action)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:286(para)
msgid "Enables administrators to perform an action on a server. Specify the action in the request body."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:290(para)
msgid "You can change the administrative password for, create a back up of, and inject network information into a server."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:294(para)
msgid "You can migrate, live-migrate, reset networking on, and reset the state of a server."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:303(title)
msgid "Servers diagnostics (servers, diagnostics)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:304(para)
msgid "Shows the usage data for a server."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:312(title)
msgid "Servers IPs (servers, ips)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:313(para)
msgid "Lists the IP addresses for an instance and shows details for an IP address."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:322(title)
msgid "Server metadata (servers, metadata)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:323(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:327(para)
msgid "Shows details for, creates or replaces, and updates a metadata item, by key, for a server."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:336(title)
msgid "Servers - list actions (servers, os-instance-actions)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:337(para)
msgid "All users can list available actions for a server."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:340(para)
msgid "All users can show details for a server action; however, only administrators can view server events in server action details."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:349(title)
msgid "Port interfaces (servers, os-interface)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:350(para)
msgid "Creates a port interface and uses it to attach a port to a server and detaches a port interface from a server. Also, lists all port interfaces and shows details for a port interface."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:360(title)
msgid "Servers password (servers, os-server-password)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:361(para)
msgid "Shows the encrypted administrative password. Also, clears the encrypted administrative password for a server, which removes it from the metadata server."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:371(title)
msgid "Servers virtual interfaces (servers, os-virtual-interfaces)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:372(para)
msgid "Lists virtual interfaces for a server instance."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:380(title)
msgid "Servers with volume attachments (servers, os-volume_attachments)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:381(para)
msgid "Attaches volumes that are created through the volume API to server instances. Also, lists volume attachments for a server instance, shows details for a volume attachment, and detaches a volume."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:391(title)
msgid "Flavors with extended attributes (flavors)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:392(para)
msgid "Shows information about flavors."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:400(title)
msgid "Flavors access (flavors, os-flavor-access, action)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:401(para)
msgid "Lists tenants who have access to a private flavor and adds private flavor access to and removes private flavor access from tenants. By default, only administrators can manage private flavor access. A private flavor has <code>is_public</code> set to <code>false</code> while a public flavor has <code>is_public</code> set to <code>true</code>."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:419(title)
msgid "Flavors extra-specs (flavors, os-flavor-extra-specs)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:420(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:429(title)
msgid "Keypairs (keypairs)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:430(para)
msgid "Generates, imports, and deletes SSH keys."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:436(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:437(para)
msgid "Shows rate and absolute limits for the tenant."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:445(title)
msgid "Extensions (extensions)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:446(para)
msgid "Lists available extensions and shows information for an extension, by alias."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:450(para)
msgid "OpenStack Compute API v2.0 supports extensions. However, extensions are deprecated in Compute API v2.1. For information about extensions, see <link xlink:href=\"http://developer.openstack.org/api-guide/compute/extensions.html\">Extensions</link>."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:461(para)
msgid "Lists, shows details for, and deletes images. Also sets, lists, shows details for, and deletes image metadata."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:465(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:471(para)
msgid "By default, the <code>policy.json</code> file authorizes all users to view the image size in the <code>OS-EXT-IMG-SIZE:size</code> extended attribute."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:490(title)
msgid "Image metadata"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:491(para)
msgid "Shows details for, sets, updates, and deletes image metadata or metadata items."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:510(title)
msgid "Guest agents (os-agents)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:511(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:524(title)
msgid "Host aggregates (os-aggregates, action)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:525(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:535(title)
msgid "Assisted volume snapshots (os-assisted-volume-snapshots)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:536(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:540(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:549(title)
msgid "Availability zones (os-availability-zone)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:550(para)
msgid "Shows availability zone information."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:558(title)
msgid "Bare metal nodes (os-baremetal-nodes)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:559(para)
msgid "Bare metal nodes."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:565(title)
msgid "Cells (os-cells, capacities)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:566(para)
msgid "Adds neighbor cells, lists neighbor cells, and shows the capabilities of the local cell."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:575(title)
msgid "Root certificates (os-certificates)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:576(para)
msgid "Creates and shows details for a root certificate."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:582(title)
msgid "Cloudpipe (os-cloudpipe)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:583(para)
msgid "Manages virtual VPNs for projects."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:589(title)
msgid "Server consoles (servers, os-consoles, os-console-auth-token)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:590(para)
msgid "Manages server consoles."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:596(title)
msgid "Fixed IPs (os-fixed-ips)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:597(para)
msgid "Shows data for a 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:606(title)
msgid "Floating IP DNS records (os-floating-ip-dns)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:607(para)
msgid "Manages DNS records associated with floating IP addresses. The API dispatches requests to a DNS driver that is selected at startup."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:616(title)
msgid "Floating IP pools (os-floating-ip-pools)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:617(para)
msgid "Manages groups of floating IPs."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:625(title)
msgid "Floating IPs (os-floating-ips)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:626(para)
msgid "Lists floating IP addresses for a project. Also, creates (allocates) a floating IP address for a project, shows floating IP address details, and deletes (deallocates) a floating IP address from a project."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:631(para)
msgid "The cloud administrator configures a pool of floating IP addresses in OpenStack Compute. The project quota defines the maximum number of floating IP addresses that you can allocate to the project. After you <link xlink:href=\"http://developer.openstack.org/api-ref-compute-v2.1.html#createFloatingIP\">allocate a floating IP address</link> for a project, you can:"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:642(para)
msgid "<link xlink:href=\"http://developer.openstack.org/api-ref-compute-v2.1.html#addFloatingIp\">Add (associate) the floating IP address</link> with an instance in the project. You can associate only one floating IP address with an instance at a time."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:651(para)
msgid "<link xlink:href=\"http://developer.openstack.org/api-ref-compute-v2.1.html#removeFloatingIp\">Remove (disassociate) the floating IP address</link> from an instance in the project."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:657(para)
msgid "Delete, or deallocate, a floating IP from the project, which automatically deletes any associations for that IP address."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:668(title)
msgid "Floating IPs bulk (os-floating-ips-bulk)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:669(para)
msgid "(nova-network only) Bulk-creates, deletes, and lists floating IPs. Default pool name is <code>nova</code>."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:673(para)
msgid "To view available pools, use the <code>os-floating-ip-pools</code> extension."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:682(title)
msgid "Ping instances (os-fping)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:683(para)
msgid "Pings instances and reports which ones are alive."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:691(title)
msgid "Hosts (os-hosts)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:692(para)
msgid "Manages physical hosts. Some virt drivers don not support all host functions. For more information, see <link xlink:href=\"http://docs.openstack.org/developer/nova/support-matrix.html\"> nova virt support matrix</link>"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:703(title)
msgid "Hypervisors (os-hypervisors)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:704(para)
msgid "Lists all hypervisors, shows summary statistics for all hypervisors over all compute nodes, shows details for a hypervisor, and shows the uptime for a hypervisor."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:714(title)
msgid "Instance usage audit log (os-instance-usage-audit-log)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:715(para)
msgid "Administrator only. Monitors task logs."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:723(title)
msgid "Migrations (os-migrations)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:724(para)
msgid "Shows data on migrations."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:732(title)
msgid "Networks (os-networks)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:733(para)
msgid "Creates, lists, shows information for, and deletes networks."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:736(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:740(para)
msgid "Associates host with and disassociates host from a network."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:748(title)
msgid "Quota class (os-quota-class-sets)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:749(para)
msgid "Provides quota classes management support."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:756(title)
msgid "Quota sets (os-quota-sets)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:757(para)
msgid "Permits administrators, depending on policy settings, to view default quotas, view details for quotas, revert quotas to defaults, and update the quotas for a project or a project and user."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:776(title)
msgid "Security groups (os-security-groups)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:777(para)
msgid "Lists, shows information for, creates, and deletes security groups."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:785(title)
msgid "Rules for default security group (os-security-group-default-rules)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:787(para)
msgid "Lists, shows information for, and creates default security group rules."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:796(title)
msgid "Rules for security group (os-security-group-rules)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:797(para)
msgid "Creates and deletes security group rules."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:805(title)
msgid "Create external events (os-server-external-events)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:806(para)
msgid "Creates one or more external events. The API dispatches each event to a server instance."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:815(title)
msgid "Server groups (os-server-groups)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:816(para)
msgid "Lists, shows information for, creates, and deletes server groups."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:833(title)
msgid "Compute services (os-services)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:834(para)
msgid "Lists all running Compute services for a tenant, enables or disables scheduling for a Compute service, logs disabled Compute service information, and deletes a Compute service."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:839(para)
msgid "For an overview of Compute services, see <link xlink:href=\"http://docs.openstack.org/liberty/install-guide-obs/common/get_started_compute.html\">OpenStack Compute</link>."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:847(title)
msgid "Usage reports (os-simple-tenant-usage)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:848(para)
msgid "Reports usage statistics on compute and storage resources."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:856(title)
msgid "Project networks (os-tenant-networks)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:857(para)
msgid "Creates, lists, shows information for, and deletes project networks."
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:865(title)
msgid "Volume extension (os-volumes, os-snapshots)"
msgstr ""
#: ./api-ref/src/docbkx/ch_compute-v2.1.xml:866(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 "Experimental share actions"
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 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 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 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:22(title)
msgid "Image registry"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:23(para)
msgid "Use the image registry tool to manage images, add tags to and remove tags from images, and define the user name for an instance operating system. Each plugin lists required tags for an image. To run remote operations, the Data Processing service requires a user name with which to log in to the operating system for an instance."
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:34(title)
msgid "Node group templates"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:35(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:39(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:49(title)
msgid "Cluster templates"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:50(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:60(title) ./api-ref/src/docbkx/ch_clustering-v1.xml:54(title)
msgid "Clusters"
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."
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:68(title)
msgid "Event log"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:69(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:77(title)
msgid "Data sources"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:78(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:82(para)
msgid "The Data Processing service does not validate data source locations."
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:90(title)
msgid "Job binary internals"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:91(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:99(title)
msgid "Job binaries"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:100(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:109(title)
msgid "Jobs"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:110(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:114(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:121(title)
msgid "Job executions"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:122(para)
msgid "A job execution object represents a Hadoop job that runs on a 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:131(title)
msgid "Job types"
msgstr ""
#: ./api-ref/src/docbkx/ch_data-processing-v1.1.xml:132(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:138(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:91(title)
msgid "Stack actions"
msgstr ""
#: ./api-ref/src/docbkx/ch_orchestration-v1.xml:92(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:105(title)
msgid "Stack resources"
msgstr ""
#: ./api-ref/src/docbkx/ch_orchestration-v1.xml:126(title)
msgid "Stack events"
msgstr ""
#: ./api-ref/src/docbkx/ch_orchestration-v1.xml:148(title)
msgid "Templates"
msgstr ""
#: ./api-ref/src/docbkx/ch_orchestration-v1.xml:177(title)
msgid "Build info"
msgstr ""
#: ./api-ref/src/docbkx/ch_orchestration-v1.xml:186(title)
msgid "Software configuration"
msgstr ""
#: ./api-ref/src/docbkx/ch_orchestration-v1.xml:215(title)
msgid "Manage service"
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:11(para)
msgid "Clustering service for OpenStack."
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:12(para)
msgid "For more information, see <link xlink:href=\"https://wiki.openstack.org/wiki/Senlin\">Senlin</link>."
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:18(para)
msgid "Lists information for all Clustering API versions."
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:28(title)
msgid "Actions"
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:29(para)
msgid "Lists all actions and shows details for an action."
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:42(title)
msgid "Build information"
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:43(para)
msgid "Shows build information for a <link xlink:href=\"https://wiki.openstack.org/wiki/Senlin\">Senlin</link> deployment."
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:55(para)
msgid "Lists all clusters and creates, shows information for, updates, deletes, and triggers an action on a cluster."
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:75(title)
msgid "Cluster policies"
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:76(para)
msgid "Lists all cluster policies and shows information for a cluster policy."
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:91(para)
msgid "Lists all events and shows information for an event."
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:104(title)
msgid "Nodes"
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:105(para)
msgid "Lists all nodes, and creates, shows information for, updates, deletes a node."
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:126(para)
msgid "Lists all policies and creates, shows information for, updates, and deletes a policy."
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:143(title)
msgid "Policy types"
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:144(para)
msgid "Lists all policy types and shows details for a policy type."
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:157(title)
msgid "Profiles"
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:158(para)
msgid "Lists all profiles and creates, shows information for, updates, and deletes a profile."
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:175(title)
msgid "Profile types"
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:176(para)
msgid "Lists all profile types and shows details for a profile type."
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:189(title)
msgid "Receivers"
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:190(para)
msgid "Lists all receivers and creates, shows information for, and deletes a receiver."
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:206(title)
msgid "Webhooks"
msgstr ""
#: ./api-ref/src/docbkx/ch_clustering-v1.xml:207(para)
msgid "Triggers an action represented by a webhook."
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/ch_networking-v2-ext.xml:17(para)
msgid "Lists available Networking API v2.0 extensions and shows details for an extension."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:32(title)
msgid "Networking Flavors Framework v2.0 (CURRENT) (flavor, service_profile)"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:33(para)
msgid "Extension that allows user selection of operator-curated flavors during resource creation."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:37(para)
msgid "Service <code>q-flavors</code> must be enabled in the configuration to use this feature."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:45(title)
msgid "FWaaS v2.0 (CURRENT) (fw, firewalls, firewall_policies, firewall_rules)"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:46(para)
msgid "Use the Firewall-as-a-Service (FWaaS) v2.0 extension to deploy firewalls to protect your networks."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:50(para)
msgid "The FWaaS extension enables you to:"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:55(para)
msgid "Apply firewall rules on traffic entering and leaving tenant networks."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:59(para)
msgid "Apply TCP, UDP, ICMP, or protocol-agnostic rules."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:64(para)
msgid "Create and share firewall policies that hold an ordered collection of the firewall rules."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:70(para)
msgid "Audit firewall rules and policies."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:73(para) ./api-ref/src/docbkx/ch_networking-v2-ext.xml:373(para) ./api-ref/src/docbkx/ch_networking-v2-ext.xml:492(para)
msgid "This extension introduces these resources:"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:76(para)
msgid "<code>firewall</code>. A logical firewall resource that a tenant can instantiate and manage. A firewall can have one firewall policy."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:83(para)
msgid "<code>firewall_policy</code>. An ordered collection of firewall rules. You can share a firewall policy across tenants. You can include a firewall policy as part of an audit workflow so that an authorized relevant entity can audit the firewall policy. This entity can differ from the tenant who created, or the tenants that use, the firewall policy."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:93(para)
msgid "<code>firewall_rule</code>. A collection of attributes, such as ports and IP addresses. These attributes define match criteria and an action to take, such as allow or deny, on matched data traffic."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:105(title)
msgid "LBaaS 2.0 (STABLE) (lbaas, loadbalancers, listeners, health_monitors, pools, members)"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:106(para)
msgid "The Load-Balancer-as-a-Service (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_networking-v2-ext.xml:113(para)
msgid "Use this extension to create and manage load balancers, listeners, pools, members of a pool, and health monitors and view status of a resource."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:118(caption) ./api-ref/src/docbkx/ch_networking-v2-ext.xml:177(caption)
msgid "Load balancer statuses"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:129(para) ./api-ref/src/docbkx/ch_networking-v2-ext.xml:188(para)
msgid "ACTIVE"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:130(para) ./api-ref/src/docbkx/ch_networking-v2-ext.xml:189(para)
msgid "The resource is ready and active."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:133(para) ./api-ref/src/docbkx/ch_networking-v2-ext.xml:192(para)
msgid "PENDING_CREATE"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:134(para) ./api-ref/src/docbkx/ch_networking-v2-ext.xml:193(para)
msgid "The resource is being created."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:137(para) ./api-ref/src/docbkx/ch_networking-v2-ext.xml:196(para)
msgid "PENDING_UPDATE"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:138(para) ./api-ref/src/docbkx/ch_networking-v2-ext.xml:197(para)
msgid "The resource is being updated."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:141(para) ./api-ref/src/docbkx/ch_networking-v2-ext.xml:200(para)
msgid "PENDING_DELETE"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:142(para) ./api-ref/src/docbkx/ch_networking-v2-ext.xml:201(para)
msgid "The resource is pending deletion."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:145(para) ./api-ref/src/docbkx/ch_networking-v2-ext.xml:204(para)
msgid "INACTIVE"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:146(para) ./api-ref/src/docbkx/ch_networking-v2-ext.xml:205(para)
msgid "The resource is not active."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:149(para) ./api-ref/src/docbkx/ch_networking-v2-ext.xml:208(para)
msgid "ERROR"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:150(para) ./api-ref/src/docbkx/ch_networking-v2-ext.xml:210(para)
msgid "An 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_networking-v2-ext.xml:164(title)
msgid "LBaaS 1.0 (DEPRECATED) (lb, vips, health_monitors, pools, members)"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:165(para)
msgid "The Load-Balancer-as-a-Service (LBaaS) v1.0 extension pairs with the Networking v2.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_networking-v2-ext.xml:172(para)
msgid "Use this extension to create and manage virtual IP addresses (VIPs), pools, members of a pool, health monitors, and view status of a resource."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:226(title)
msgid "Metering labels and rules (metering-labels, metering-label-rules)"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:227(para)
msgid "Creates, modifies, and deletes OpenStack Layer3 metering labels and rules."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:232(title)
msgid "Networks provider extended attributes (networks)"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:233(para)
msgid "Lists, creates, shows information for, updates, and deletes networks."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:236(para)
msgid "The provider extension decorates network resources with additional 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-ext.html#networks-multi-provider-ext\"> Networks multiple provider extension</link>. You cannot use both extensions at the same time."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:251(title)
msgid "Networks multiple provider extension (networks)"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:252(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_networking-v2-ext.xml:257(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_networking-v2-ext.xml:261(para)
msgid "To delete a network with multiple physical bindings, issue a normal delete network request."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:265(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-ext.html#network_provider-ext\">Networks provider extended attributes</link>. You cannot use both extensions at the same time."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:279(para)
msgid "The NSX and ML2 plug-ins support this extension. With the ML2 plug-in, you can specify multiple VLANs for a network, a VXLAN tunnel ID, and a VLAN."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:288(title)
msgid "VLAN transparency extension (networks)"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:289(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_networking-v2-ext.xml:296(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_networking-v2-ext.xml:300(para)
msgid "To delete a VLAN-transparent network, issue a normal delete network request."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:304(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_networking-v2-ext.xml:313(title)
msgid "Ports binding extended attributes (ports)"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:314(para)
msgid "Lists, creates, shows information for, updates, and deletes ports."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:330(title)
msgid "QoS policies (qos)"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:331(para)
msgid "Lists, creates, shows information for, and updates QoS policies."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:336(title)
msgid "Quotas extension (quotas)"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:337(para)
msgid "Lists quotas for tenants who have non-default quota values, and lists, updates, and resets quotas for a tenant."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:341(para)
msgid "A quota value of <code>-1</code> means that quota has no limit."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:348(title)
msgid "Extra routes (routers)"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:349(para)
msgid "Adds extra routes to the <code>router</code> resource."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:351(para)
msgid "You can update a router to add a set of next hop IPs and destination CIDRs."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:354(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/ch_networking-v2-ext.xml:367(title)
msgid "Layer-3 networking (routers, floatingips)"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:368(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_networking-v2-ext.xml:378(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_networking-v2-ext.xml:385(para)
msgid "<emphasis role=\"bold\">floatingip</emphasis>. An external IP address that you map to a port in an internal network."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:395(title)
msgid "Security groups (security-groups)"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:396(para)
msgid "Lists, creates, shows information for, updates, and deletes security groups."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:413(title)
msgid "Security group rules (security-group-rules)"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:414(para)
msgid "Lists, creates, shows information for, and deletes security group rules."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:432(title)
msgid "Subnet pools extension (subnetpools)"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:433(para)
msgid "Lists, creates, shows details for, updates, and deletes subnet pools."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:449(title)
msgid "Tag extension (tags)"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:450(para)
msgid "Shows details for, updates, and deletes tags. This extension is available since Mitaka release."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:458(title)
msgid "VPNaaS 2.0 (CURRENT) (vpn, vpnservices, ikepolicies, ipsecpolicies, endpoint-groups, ipsec-site-connections)"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:459(para)
msgid "The Virtual-Private-Network-as-a-Service (VPNaaS) extension enables OpenStack tenants to extend private networks across the public telecommunication infrastructure."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:464(para)
msgid "This initial implementation of the VPNaaS extension provides:"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:469(para)
msgid "Site-to-site VPN that connects two private networks."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:473(para)
msgid "Multiple VPN connections per tenant."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:476(para)
msgid "IKEv1 policy support with 3des, aes-128, aes-256, or aes-192 encryption."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:480(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_networking-v2-ext.xml:488(para)
msgid "Dead Peer Detection (DPD) with hold, clear, restart, disabled, or restart-by-peer actions."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:495(para)
msgid "<code>service</code>. A parent object that associates VPN with a specific subnet and router."
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:499(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_networking-v2-ext.xml:506(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_networking-v2-ext.xml:514(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_networking-v2-ext.xml:527(title)
msgid "Network IP availability and usage stats"
msgstr ""
#: ./api-ref/src/docbkx/ch_networking-v2-ext.xml:528(para)
msgid "List and show the network IP usage stats of all networks and a specified network. These operations are available in the Mitaka release (April 2016)."
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:39(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:47(title)
msgid "Volumes (volumes)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:48(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:52(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:58(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:63(caption)
msgid "Volume statuses"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:75(para)
msgid "The volume is being created."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:79(para)
msgid "The volume is ready to attach to an instance."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:83(para)
msgid "attaching"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:84(para)
msgid "The volume is attaching to an instance."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:88(para)
msgid "in-use"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:89(para)
msgid "The volume is attached to an instance."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:94(para)
msgid "The volume is being deleted."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:98(para)
msgid "A volume creation error occurred."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:104(para)
msgid "A volume deletion error occurred."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:108(para)
msgid "backing-up"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:109(para)
msgid "The volume is being backed up."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:112(para)
msgid "restoring-backup"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:113(para)
msgid "A backup is being restored to the volume."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:117(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:283(para)
msgid "error_restoring"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:118(para) ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:288(para)
msgid "A backup restoration error occurred."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:121(para)
msgid "error_extending"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:122(para)
msgid "An error occurred while attempting to extend a volume."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:149(title)
msgid "Volume type access (volumes)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:150(para)
msgid "Private volume type access to project."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:153(para)
msgid "By default, volumes types are public. To create a private volume type, set the <code>is_public</code> boolean field to <code>false</code> at volume type creation time. To control access to a private volume type, user needs to add a project to or remove a project from the volume type. 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:173(title)
msgid "Volume actions (volumes, action)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:174(para)
msgid "Extends the size of, resets statuses for, sets image metadata for, and removes image metadata from a volume. Attaches a volume to a server, detaches a volume from a server, and removes a volume from Block Storage management without actually removing the back-end storage object associated with it."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:196(title)
msgid "Backups (backups)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:197(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:206(para)
msgid "When you create, list, or delete backups, these status values are possible:"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:211(caption)
msgid "Backup statuses"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:228(para)
msgid "The backup is being created."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:240(para)
msgid "The backup is ready to restore to a volume."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:252(para)
msgid "The backup is being deleted."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:264(para)
msgid "A backup error occurred."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:271(para)
msgid "restoring"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:276(para)
msgid "The backup is being restored to a volume."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:296(para)
msgid "If an error occurs, you can find more information about the error in the <code>fail_reason</code> field for the backup."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:318(title)
msgid "Backup actions (backups, action)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:319(para)
msgid "Force-deletes a backup."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:329(title)
msgid "Capabilities for storage back ends (capabilities)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:330(para)
msgid "Shows capabilities for a storage back end."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:367(title)
msgid "Quality of service (QoS) specifications (qos-specs)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:371(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:397(title)
msgid "Volume types (types)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:413(title)
msgid "Volume snapshots (snapshots)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:414(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:418(para)
msgid "When you create, list, or delete snapshots, these status values are possible:"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:423(caption)
msgid "Snapshot statuses"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:440(para)
msgid "The snapshot is being created."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:452(para)
msgid "The snapshot is ready to use."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:464(para)
msgid "The snapshot is being deleted."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:476(para)
msgid "A snapshot creation error occurred."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:488(para)
msgid "A snapshot deletion error occurred."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:516(title)
msgid "Volume manage extension (os-volume-manage)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:517(para)
msgid "Creates volumes by using existing storage instead of allocating new storage."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:524(title)
msgid "Volume image metadata extension (os-vol-image-meta)"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:525(para)
msgid "Shows image metadata that is associated with a volume."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:532(para)
msgid "Administrator only. Lists all back-end storage pools that are known to the scheduler service."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:539(title)
msgid "Volume transfer"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:540(para)
msgid "Transfers a volume from one user to another user."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:546(title)
msgid "Consistency groups"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:547(para)
msgid "Consistency groups enable you to create snapshots at the exact same point in time from multiple volumes. For example, a database might place its tables, logs, and configuration on separate volumes. 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_blockstorage-api-v2.xml:555(para)
msgid "Use the <code>policy.json</code> file to grant permissions for these actions to limit roles."
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:562(title)
msgid "Consistency group snapshots"
msgstr ""
#: ./api-ref/src/docbkx/ch_blockstorage-api-v2.xml:563(para)
msgid "Lists all, lists all with details, shows details for, creates, and deletes consistency group snapshots."
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:href=\"api-ref-share-v2.html#share-api-v2\">Shared File Systems API v2</link>. Subsequent API v2 micro-versions, such as v2.1, differ from API v1."
msgstr ""
#: ./api-ref/src/docbkx/ch_share-v1.xml:24(para)
msgid "(Since 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 ""