9151d1c364
For more information about this automatic import see: https://wiki.openstack.org/wiki/Translations/Infrastructure Change-Id: I31b07d580d8614f84e2b2775979844219167bbd5
394 lines
12 KiB
Plaintext
394 lines
12 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2015, OpenStack contributors
|
|
# This file is distributed under the same license as the API-Quick-Start package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: API-Quick-Start 0.1\n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2015-10-09 06:18+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.rst:3
|
|
msgid "OpenStack APIs"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:5
|
|
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.rst:10
|
|
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.rst:16
|
|
msgid ""
|
|
"When you send API requests, you include the token in the ``X-Auth-Token`` "
|
|
"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.rst:24
|
|
msgid "Authentication and API request workflow"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:26
|
|
msgid ""
|
|
"Request an authentication token from the Identity endpoint that your cloud "
|
|
"administrator gave you. Send a payload of credentials in the request as "
|
|
"shown in :ref:`authenticate`. If the request succeeds, the server returns an "
|
|
"authentication token."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:31
|
|
msgid ""
|
|
"Send API requests and include the token in the ``X-Auth-Token`` header. "
|
|
"Continue to send API requests with that token until the service completes "
|
|
"the request or a 401 Unauthorized error occurs."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:35
|
|
msgid "If the 401 Unauthorized error occurs, request another token."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:37
|
|
msgid ""
|
|
"The examples in this section use cURL commands. For information about cURL, "
|
|
"see http://curl.haxx.se/. For information about the OpenStack APIs, see "
|
|
"`OpenStack API Reference <http://developer.openstack.org/api-ref.html>`__."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:46
|
|
msgid "Authenticate"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:48
|
|
msgid "The payload of credentials to authenticate contains these parameters:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:51
|
|
msgid "Description"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:51
|
|
msgid "Parameter"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:51
|
|
msgid "Type"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:53
|
|
msgid ""
|
|
"The user name. If you do not provide a user name and password, you must "
|
|
"provide a token."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:53
|
|
msgid "username (required)"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:53 ../api-quick-start.rst:57
|
|
#: ../api-quick-start.rst:59 ../api-quick-start.rst:66
|
|
#: ../api-quick-start.rst:77
|
|
msgid "xsd:string"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:57
|
|
msgid "The password for the user."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:57
|
|
msgid "password (required)"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:59
|
|
msgid "*tenantName* (Optional)"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:59
|
|
msgid ""
|
|
"The tenant name. Both the *tenantId* and *tenantName* are optional, but "
|
|
"should not be specified together. If both attributes are specified, the "
|
|
"server responds with a 400 Bad Request."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:66
|
|
msgid ""
|
|
"The tenant ID. Both the *tenantId* and *tenantName* are optional, but should "
|
|
"not be specified together. If both attributes are specified, the server "
|
|
"responds with a 400 Bad Request. 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.rst:67
|
|
msgid "(Optional)"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:74
|
|
msgid "*tenantId*"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:77
|
|
msgid ""
|
|
"A token. If you do not provide a token, you must provide a user name and "
|
|
"password."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:77
|
|
msgid "token (Optional)"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:83
|
|
msgid ""
|
|
"For a typical OpenStack deployment that runs Identity, use the following "
|
|
"cURL command to request a token with your tenantName and ID:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:94
|
|
msgid ""
|
|
"If the request succeeds, you receive a 200 OK response followed by a "
|
|
"response body that contains a token in the form ``\"id\":\"token\"`` and an "
|
|
"expiration date and time in the form ``\"expires\":\"datetime\"``."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:99
|
|
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.rst:110
|
|
msgid "The following example shows a successful response:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:307
|
|
msgid "Send API requests"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:309
|
|
msgid ""
|
|
"This section shows how to make some basic Compute API calls. For a complete "
|
|
"list of Compute API v2.0 calls, see `Compute APIs and Extensions <http://"
|
|
"developer.openstack.org/api-ref-compute-v2.html>`__."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:313
|
|
msgid "Use the Compute API to list flavors, as follows:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:399
|
|
msgid "Use the Compute API to list images, as follows:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:510
|
|
msgid "Use the Compute API to list servers, as follows:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:542
|
|
msgid "OpenStack command-line clients"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:544
|
|
msgid ""
|
|
"For scripting work and simple requests, you can use a command-line client "
|
|
"like the ``openstack-client`` client. This client enables you to use the "
|
|
"Identity, Compute, Block Storage, and Object Storage APIs through a command-"
|
|
"line interface. Also, each OpenStack project has a related client project "
|
|
"that includes Python API bindings and a CLI."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:550
|
|
msgid ""
|
|
"For information about the command-line clients, see `OpenStack Command-Line "
|
|
"Interface Reference <http://docs.openstack.org/cli-reference/content/>`__."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:554
|
|
msgid "Install the clients"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:556
|
|
msgid ""
|
|
"Use ``pip`` 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 `Python Package Index <http://pypi.python.org/pypi>`__. Also, ``pip`` "
|
|
"lets you update or remove a package."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:561
|
|
msgid ""
|
|
"You must install each project's client separately, but the python-"
|
|
"openstackclient covers multiple projects."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:564
|
|
msgid "Run this command to install or update a client package:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:570
|
|
msgid "Where *PROJECT* is the project name."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:572
|
|
msgid "For example, to install the ``openstack`` client, run this command:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:578
|
|
msgid "To update the ``openstack`` client, run this command:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:584
|
|
msgid "To remove the ``openstack`` client, run this command:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:590
|
|
msgid ""
|
|
"Before you can issue client commands, you must download and source the "
|
|
"``openrc`` file to set environment variables."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:593
|
|
msgid ""
|
|
"For complete information about the OpenStack clients, including how to "
|
|
"source the ``openrc`` file, see `OpenStack End User Guide <http://docs."
|
|
"openstack.org/user-guide/>`__, `OpenStack Admin User Guide <http://docs."
|
|
"openstack.org/user-guide-admin/>`__, and `OpenStack Command-Line Interface "
|
|
"Reference <http://docs.openstack.org/cli-reference/content/>`__."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:601
|
|
msgid "Launch an instance"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:603
|
|
msgid ""
|
|
"To launch instances, you must choose a name, an image, and a flavor for your "
|
|
"instance."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:606
|
|
msgid ""
|
|
"To list available images, call the Compute API through the ``openstack`` "
|
|
"client, as follows:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:621
|
|
msgid "To list flavors, run this command:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:641
|
|
msgid "To launch an instance, note the IDs of your desired image and flavor."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:643
|
|
msgid ""
|
|
"To launch an instance named ``my_instance``, run the ``openstack server "
|
|
"create`` command with the image and flavor IDs and the server name, as "
|
|
"follows:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:685
|
|
msgid ""
|
|
"For information about the default ports that the OpenStack components use, "
|
|
"see `Firewalls and default ports`_ in the *OpenStack Configuration "
|
|
"Reference*."
|
|
msgstr ""
|
|
|
|
#: ../index.rst:3
|
|
msgid "OpenStack API Guide"
|
|
msgstr ""
|
|
|
|
#: ../index.rst:5
|
|
msgid ""
|
|
"Although you install each OpenStack service separately, the OpenStack "
|
|
"services work together to meet your cloud needs: Identity, Compute, Images, "
|
|
"Block Storage, Networking (neutron), Object Storage, Databases, and "
|
|
"Metering. With the `TryStack <http://www.trystack.org/>`__ OpenStack "
|
|
"installation, these services work together in the background of the "
|
|
"installation."
|
|
msgstr ""
|
|
|
|
#: ../index.rst:12
|
|
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 **openstack** command-line client."
|
|
msgstr ""
|
|
|
|
#: ../index.rst:17
|
|
msgid "To begin sending API requests, use one of the following methods:"
|
|
msgstr ""
|
|
|
|
#: ../index.rst:19
|
|
msgid "**cURL**"
|
|
msgstr ""
|
|
|
|
#: ../index.rst:21
|
|
msgid ""
|
|
"A command-line tool that lets you send HTTP requests and receive responses. "
|
|
"See `the section called “OpenStack APIs” <#Compute_API_Quick_Start>`__."
|
|
msgstr ""
|
|
|
|
#: ../index.rst:25
|
|
msgid "**OpenStack command-line client**"
|
|
msgstr ""
|
|
|
|
#: ../index.rst:27
|
|
msgid ""
|
|
"The OpenStack project provides a command-line client that enables you to "
|
|
"access APIs through easy-to-use commands. See `the section called “OpenStack "
|
|
"command-line clients” <#cli-intro>`__."
|
|
msgstr ""
|
|
|
|
#: ../index.rst:31
|
|
msgid "**REST clients**"
|
|
msgstr ""
|
|
|
|
#: ../index.rst:33
|
|
msgid ""
|
|
"Both Mozilla and Google provide browser-based graphical interfaces for REST. "
|
|
"For Firefox, see `RESTClient <https://addons.mozilla.org/en-US/firefox/addon/"
|
|
"restclient/>`__. For Chrome, see `rest-client <http://code.google.com/p/rest-"
|
|
"client/>`__."
|
|
msgstr ""
|
|
|
|
#: ../index.rst:39
|
|
msgid "**OpenStack Python Software Development Kit (SDK)**"
|
|
msgstr ""
|
|
|
|
#: ../index.rst:41
|
|
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 "
|
|
"`OpenStack Python SDK <http://docs.openstack.org/user-guide/sdk.html>`__ in "
|
|
"the *OpenStack End User Guide*."
|
|
msgstr ""
|
|
|
|
#: ../index.rst:51
|
|
msgid "Learn more"
|
|
msgstr ""
|