419 lines
15 KiB
Plaintext
419 lines
15 KiB
Plaintext
#
|
|
# 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 ""
|