# 
# Translators:
msgid ""
msgstr ""
"Project-Id-Version: OpenStack Manuals\n"
"POT-Creation-Date: 2014-03-18 06:08+0000\n"
"PO-Revision-Date: 2014-03-17 18:07+0000\n"
"Last-Translator: jaegerandi <jaegerandi@gmail.com>\n"
"Language-Team: English (United States) (http://www.transifex.com/projects/p/openstack/language/en_US/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: en_US\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"

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

#: ./api-quick-start/src/docbkx/api-quick-start-onepager.xml10(para)
msgid ""
"Although you install each OpenStack service separately, the OpenStack "
"services work together to meet your cloud needs: Identity Service, Compute, "
"Image Service, Block Storage Service, Networking, Object Storage, "
"Orchestration, and Telemetry. With the <link "
"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.xml17(para)
msgid ""
"After you authenticate through the Identity Service, 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 nova command-line client."
msgstr ""

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

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

#: ./api-quick-start/src/docbkx/api-quick-start-onepager.xml27(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.xml32(emphasis)
#: ./api-quick-start/src/docbkx/cli-uses.xml6(title)
msgid "OpenStack command-line clients"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-onepager.xml34(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.xml39(emphasis)
msgid "REST clients"
msgstr ""

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

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

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

#: ./api-quick-start/src/docbkx/cli-uses.xml17(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 href=\"http://pypi.python.org/pypi\">Python Package "
"Index</link>. Also, <placeholder-2/> lets you update or remove a package. "
"After you install the clients, you must source an "
"<filename>openrc</filename> file to set required environment variables "
"before you can request OpenStack services through the clients or the APIs. "
"For complete information about the OpenStack clients including how to source"
" the <filename>openrc</filename> file, see <link "
"href=\"http://docs.openstack.org/user-guide/content/\"><citetitle>OpenStack "
"End User Guide</citetitle></link>, <link href=\"http://docs.openstack.org"
"/user-guide-admin/content/\"><citetitle>OpenStack Admin User "
"Guide</citetitle></link>, and <link href=\"http://docs.openstack.org/cli-"
"reference/content/\"><citetitle>OpenStack Command Line Interface "
"Reference</citetitle></link>."
msgstr ""

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

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

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

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

#: ./api-quick-start/src/docbkx/cli-uses.xml49(para)
msgid "For example, to install the nova client, run the following command:"
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml52(para)
msgid "To update the nova client, run the following command:"
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml55(para)
msgid "To remove the nova client, run the following command:"
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml58(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.xml63(title)
msgid "Launch an instance"
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml64(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.xml66(para)
msgid ""
"To list available images, call the Compute API through the nova client, as "
"follows:"
msgstr ""

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

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

#: ./api-quick-start/src/docbkx/cli-uses.xml91(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.xml126(para)
msgid "Use the <placeholder-1/> command to view your server:"
msgstr ""

#: ./api-quick-start/src/docbkx/cli-uses.xml134(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/api-quick-start-intro.xml6(title)
msgid "OpenStack APIs"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml7(para)
msgid ""
"To authenticate access to OpenStack services, you must first issue an "
"authentication request to the OpenStack Identity Service 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.xml12(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.xml18(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.xml26(title)
msgid "Authentication and API request workflow"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml28(para)
msgid ""
"Request an authentication token from the Identity Service 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.xml38(th)
msgid "Parameter"
msgstr ""

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

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

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml45(td)
msgid "username (Optional)"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml46(td)
#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml53(td)
#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml58(td)
msgid "xsd:string"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml47(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.xml52(td)
msgid "password (Optional)"
msgstr ""

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

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

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml60(parameter)
#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml72(parameter)
msgid "tenantId"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml61(parameter)
#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml73(parameter)
msgid "tenantName"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml65(errorcode)
#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml77(errorcode)
msgid "400"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml66(errorname)
#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml78(errorname)
msgid "Bad Request"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml59(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.xml69(td)
msgid "tenantId (Optional)"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml70(td)
#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml82(td)
msgid "capi:UUID"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml71(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/>."
msgstr ""

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

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml83(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.xml89(para)
msgid "If the request succeeds, the server returns an authentication token."
msgstr ""

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

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

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

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml120(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.xml126(para)
msgid "The following example shows a successful response:"
msgstr ""

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

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

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

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml151(para)
msgid "Use the Identity Service API to request a list of tenants, as follows:"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml153(replaceable)
#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml157(replaceable)
#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml160(replaceable)
msgid "token"
msgstr ""

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml155(para)
msgid ""
"Use the Identity Service API to request a list of endpoints, as follows:"
msgstr ""

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

#: ./api-quick-start/src/docbkx/api-quick-start-intro.xml160(replaceable)
msgid "tenant_id"
msgstr ""

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