msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2015-08-25 06:07+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-quick-start/src/docbkx/api-quick-start-intro.xml:6(title)
msgid "OpenStack APIs"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:7(para)
msgid "To authenticate access to OpenStack services, you must first issue an authentication request to OpenStack Identity to acquire an authentication token. To request an authentication token, you must supply a payload of credentials in the authentication request."
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:12(para)
msgid "Credentials are usually a combination of your user name and password, and optionally, the name or ID of the tenant in which your cloud runs. Ask your cloud administrator for your user name, password, and tenant so that you can generate authentication tokens. Alternatively, you can supply a token rather than a user name and password."
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:18(para)
msgid "When you send API requests, you include the token in the <literal>X-Auth-Token</literal> header. If you access multiple OpenStack services, you must get a token for each service. A token is valid for a limited time before it expires. A token can also become invalid for other reasons. For example, if the roles for a user change, existing tokens for that user are invalid."
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:26(title)
msgid "Authentication and API request workflow"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:28(para)
msgid "Request an authentication token from the Identity endpoint that your cloud administrator gave you. Send a payload of credentials in the request:"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:38(th)
msgid "Parameter"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:39(th)
msgid "Type"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:40(th)
msgid "Description"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:45(td)
msgid "username (required)"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:46(td) ./api-quick-start/src/docbkx/api-quick-start-intro.xml:53(td) ./api-quick-start/src/docbkx/api-quick-start-intro.xml:58(td)
msgid "xsd:string"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:47(td)
msgid "The user name. If you do not provide a user name and password, you must provide a token."
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:52(td)
msgid "password (required)"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:54(td)
msgid "The password for the user."
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:57(td)
msgid "tenantName (Optional)"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:60(parameter) ./api-quick-start/src/docbkx/api-quick-start-intro.xml:72(parameter)
msgid "tenantId"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:61(parameter) ./api-quick-start/src/docbkx/api-quick-start-intro.xml:73(parameter)
msgid "tenantName"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:65(errorcode) ./api-quick-start/src/docbkx/api-quick-start-intro.xml:76(errorcode)
msgid "400"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:66(errorname) ./api-quick-start/src/docbkx/api-quick-start-intro.xml:77(errorname)
msgid "Bad Request"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:59(td)
msgid "The tenant name. Both the <placeholder-1/> and <placeholder-2/> are optional, but should not be specified together. If both attributes are specified, the server responds with a <placeholder-3/><placeholder-4/>."
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:69(td)
msgid "tenantId (Optional)"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:70(td) ./api-quick-start/src/docbkx/api-quick-start-intro.xml:84(td)
msgid "capi:UUID"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:71(td)
msgid "The tenant ID. Both the <placeholder-1/> and <placeholder-2/> are optional, but should not be specified together. If both attributes are specified, the server responds with a <placeholder-3/><placeholder-4/>. If you do not know the tenantId, you can send a request with \"\" for the tenantId and get the ID returned to you in the response."
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:83(td)
msgid "token (Optional)"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:85(td)
msgid "A token. If you do not provide a token, you must provide a user name and password."
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:91(para)
msgid "If the request succeeds, the server returns an authentication token."
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:95(para)
msgid "Send API requests and include the token in the <literal>X-Auth-Token</literal> header. Continue to send API requests with that token until the job completes or a <errorcode>401</errorcode><errortext>Unauthorized</errortext> error occurs."
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:103(para)
msgid "If the <errorcode>401</errorcode><errortext>Unauthorized</errortext> error occurs, request another token."
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:108(para)
msgid "The examples in this section use cURL commands. For information about cURL, see <link xlink:href=\"http://curl.haxx.se/\">http://curl.haxx.se/</link>. For information about the OpenStack APIs, see <link xlink:href=\"http://developer.openstack.org/api-ref.html\">OpenStack API Reference</link>."
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:117(title)
msgid "Authenticate"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:118(para)
msgid "For a typical OpenStack deployment that runs Identity, use a cURL command like the following command to request a token:"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:126(para)
msgid "If the request succeeds, you receive a <returnvalue>200 OK</returnvalue> response followed by a response body that contains a token in the form <code>\"id\":\"<replaceable>token</replaceable>\"</code> and an expiration date and time in the form <code>\"expires\":\"<replaceable>datetime</replaceable>\"</code>."
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:132(para)
msgid "The following example shows a successful response:"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:136(para)
msgid "If you do not know your tenant name or ID, you can send an authentication request with an empty tenantName, as follows:"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:147(title)
msgid "Send API requests"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:148(para)
msgid "This section shows how to make some basic Compute API calls. For a complete list of Compute API calls, see <link xlink:href=\"http://developer.openstack.org/api-ref-compute-v2.html\">Compute APIs and Extensions</link>."
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:153(para)
msgid "Use the Compute API to list flavors, as follows:"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:155(replaceable) ./api-quick-start/src/docbkx/api-quick-start-intro.xml:161(replaceable) ./api-quick-start/src/docbkx/api-quick-start-intro.xml:167(replaceable)
msgid "token"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:156(replaceable) ./api-quick-start/src/docbkx/api-quick-start-intro.xml:162(replaceable) ./api-quick-start/src/docbkx/api-quick-start-intro.xml:168(replaceable)
msgid "tenant_id"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:159(para)
msgid "Use the Compute API to list images, as follows:"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml:165(para)
msgid "Use the Compute API to list servers, as follows:"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-onepager.xml:8(title)
msgid "OpenStack API Quick Start"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-onepager.xml:10(para)
msgid "Although you install each OpenStack service separately, the OpenStack services work together to meet your cloud needs: Identity, Compute, Image service, Block Storage, Networking (neutron), Object Storage, Orchestration, and Telemetry. With the <link xlink:href=\"http://www.trystack.org/\">TryStack</link> OpenStack installation, these services work together in the background of the installation."
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-onepager.xml:17(para)
msgid "After you authenticate through Identity, you can use the other OpenStack APIs to create and manage resources in your OpenStack cloud. You can launch instances from images and assign metadata to instances through the Compute API or the <placeholder-1/> command-line client."
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-onepager.xml:22(para)
msgid "To begin sending API requests, use one of the following methods:"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-onepager.xml:26(emphasis)
msgid "cURL"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-onepager.xml:27(para)
msgid "A command-line tool that lets you send HTTP requests and receive responses. See <xref linkend=\"Compute_API_Quick_Start\"/>."
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-onepager.xml:32(emphasis) ./api-quick-start/src/docbkx/cli-uses.xml:6(title)
msgid "OpenStack command-line clients"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-onepager.xml:34(para)
msgid "Each OpenStack project provides a command-line client that enables you to access its API through easy-to-use commands. See <xref linkend=\"cli-intro\"/>."
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-onepager.xml:40(emphasis)
msgid "REST clients"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-onepager.xml:41(para)
msgid "Both Mozilla and Google provide browser-based graphical interfaces for REST. For Firefox, see <link xlink:href=\"https://addons.mozilla.org/en-US/firefox/addon/restclient/\">RESTClient</link>. For Chrome, see <link xlink:href=\"http://code.google.com/p/rest-client/\">rest-client</link>."
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-onepager.xml:49(emphasis)
msgid "OpenStack Python Software Development Kit (SDK)"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-onepager.xml:51(para)
msgid "Use this SDK to write Python automation scripts that create and manage resources in your OpenStack cloud. The SDK implements Python bindings to the OpenStack API, which enables you to perform automation tasks in Python by making calls on Python objects rather than making REST calls directly. All OpenStack command-line tools are implemented by using the Python SDK. See <link xlink:href=\"http://docs.openstack.org/user-guide/sdk.html\">OpenStack Python SDK</link> in the <citetitle>OpenStack End User Guide</citetitle>."
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml:7(para)
msgid "For scripting work, you can use a command-line client like the <systemitem role=\"client\">python-novaclient</systemitem> client. This client enables you to use the Compute API through a command-line interface."
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml:11(para)
msgid "For information about the command-line clients, see <link xlink:href=\"http://docs.openstack.org/cli-reference/content/\"><citetitle>OpenStack Command-Line Interface Reference</citetitle></link>."
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml:16(title)
msgid "Install the clients"
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml:17(para)
msgid "Use <placeholder-1/> to install the OpenStack clients on a Mac OS X or Linux system. It is easy and ensures that you get the latest version of the client from the <link xlink:href=\"http://pypi.python.org/pypi\">Python Package Index</link>. Also, <placeholder-2/> lets you update or remove a package."
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml:23(para)
msgid "You must install each client separately."
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml:24(para)
msgid "Run this command to install or update a client package:"
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml:26(replaceable)
msgid "PROJECT"
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml:27(para)
msgid "Where <replaceable>PROJECT</replaceable> is the project name."
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml:29(para)
msgid "For example, to install the <placeholder-1/> client, run this command:"
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml:32(para)
msgid "To update the <placeholder-1/> client, run this command:"
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml:35(para)
msgid "To remove the <placeholder-1/> client, run this command:"
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml:38(para)
msgid "Before you can issue client commands, you must download and source the <filename>openrc</filename> file to set environment variables."
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml:41(para)
msgid "For complete information about the OpenStack clients, including how to source the <filename>openrc</filename> file, see <link xlink:href=\"http://docs.openstack.org/user-guide/\"><citetitle>OpenStack End User Guide</citetitle></link>, <link xlink:href=\"http://docs.openstack.org/user-guide-admin/\"><citetitle>OpenStack Admin User Guide</citetitle></link>, and <link xlink:href=\"http://docs.openstack.org/cli-reference/content/\"><citetitle>OpenStack Command-Line Interface Reference</citetitle></link>."
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml:59(title)
msgid "Launch an instance"
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml:60(para)
msgid "To launch instances, you must choose a name, an image, and a flavor for your instance."
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml:62(para)
msgid "To list available images, call the Compute API through the <placeholder-1/> client, as follows:"
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml:72(para)
msgid "To list flavors, run this command:"
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml:85(para)
msgid "To launch an instance, note the IDs of your desired image and flavor."
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml:87(para)
msgid "To launch an instance named <literal>my_instance</literal>, run the <placeholder-1/> command with the image and flavor IDs and the server name, as follows:"
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml:122(para)
msgid "Use the <placeholder-1/> command to view your server:"
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml:130(para)
msgid "To view details for a specified server, use the <placeholder-1/> command. Include the ID of the server:"
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml:165(para)
msgid "For information about the default ports that the OpenStack components use, see <link xlink:href=\"http://docs.openstack.org/trunk/config-reference/content/firewalls-default-ports.html\"><citetitle>Appendix A. Firewalls and default ports</citetitle></link> in the <citetitle>OpenStack Configuration Reference</citetitle>."
msgstr ""

#. Put one translator per line, in the form of NAME <EMAIL>, YEAR1, YEAR2
#: ./api-quick-start/src/docbkx/cli-uses.xml:0(None)
msgid "translator-credits"
msgstr ""