527adb3f77
For more information about this automatic import see: https://wiki.openstack.org/wiki/Translations/Infrastructure Change-Id: Iddd033fc590b62f5aa360145399777f30ebe204f
417 lines
12 KiB
Plaintext
417 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: 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-quick-start.rst:5
|
|
msgid "OpenStack APIs"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:7
|
|
msgid ""
|
|
"To authenticate access to OpenStack services, you must first issue an "
|
|
"authentication request with a payload of credentials to OpenStack Identity "
|
|
"to get an authentication token."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:11
|
|
msgid ""
|
|
"Credentials are usually a combination of your user name and password, and "
|
|
"optionally, the name or ID of the tenant where 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:17
|
|
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 no longer valid."
|
|
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 the Unauthorized (401) error occurs."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:35
|
|
msgid "If the Unauthorized (401) 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:45
|
|
msgid "Authenticate"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:47
|
|
msgid "The payload of credentials to authenticate contains these parameters:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:50
|
|
msgid "Description"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:50
|
|
msgid "Parameter"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:50
|
|
msgid "Type"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:52
|
|
msgid ""
|
|
"The user name. If you do not provide a user name and password, you must "
|
|
"provide a token."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:52
|
|
msgid "username (required)"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:52 ../api-quick-start.rst:56
|
|
#: ../api-quick-start.rst:58 ../api-quick-start.rst:65
|
|
#: ../api-quick-start.rst:75
|
|
msgid "xsd:string"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:56
|
|
msgid "The password for the user."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:56
|
|
msgid "password (required)"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:58
|
|
msgid "*tenantName* (Optional)"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:58
|
|
msgid ""
|
|
"The tenant name. Both the *tenantId* and *tenantName* are optional and "
|
|
"mutually exclusive. If you specify both attributes, the server returns the "
|
|
"Bad Request (400) response code."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:65
|
|
msgid "*tenantId* (Optional)"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:65
|
|
msgid ""
|
|
"The tenant ID. Both the *tenantId* and *tenantName* are optional and "
|
|
"mutually exclusive. If you specify both attributes, the server returns the "
|
|
"Bad Request (400) response code. If you do not know the tenant name ID, send "
|
|
"a request with \"\" for the tenant name or ID. The response returns the "
|
|
"tenant name or ID."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:75
|
|
msgid ""
|
|
"A token. If you do not provide a token, you must provide a user name and "
|
|
"password."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:75
|
|
msgid "token (Optional)"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:81
|
|
msgid ""
|
|
"In a typical OpenStack deployment that runs Identity, you can specify your "
|
|
"tenant name, and user name and password credentials to authenticate."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:84
|
|
msgid ""
|
|
"First, export your tenant name to the `OS_TENANT_NAME` environment variable, "
|
|
"your user name to the `OS_USERNAME` environment variable, and your password "
|
|
"to the `OS_PASSWORD` environment variable. The example below uses a TryStack "
|
|
"endpoint but you can also use `$OS_IDENTITYENDPOINT` as an environment "
|
|
"variable as needed."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:89
|
|
msgid "Then, run this cURL command to request a token:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:98
|
|
msgid ""
|
|
"If the request succeeds, it returns the ``OK (200)`` response code 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:104
|
|
msgid ""
|
|
"If you do not know the tenant name or ID, send a request with \"\" for the "
|
|
"tenant name or ID. The response returns the tenant name or ID."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:114
|
|
msgid "The following example shows a successful response:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:339
|
|
msgid "Send API requests"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:341
|
|
msgid ""
|
|
"This section shows how to make some basic Compute API calls. For a complete "
|
|
"list of Compute API calls, see `Compute API (CURRENT) <http://developer."
|
|
"openstack.org/api-ref-compute-v2.1.html>`__."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:345
|
|
msgid ""
|
|
"Export the token ID to the ``OS_TOKEN`` environment variable. For example:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:351
|
|
msgid "The token expires every 24 hours."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:353
|
|
msgid ""
|
|
"Export the tenant name to the ``OS_TENANT_NAME`` environment variable. For "
|
|
"example:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:359
|
|
msgid "Then, use the Compute API to list flavors:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:444
|
|
msgid "Use the Compute API to list images:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:554
|
|
msgid "Use the Compute API to list servers:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:586
|
|
msgid "OpenStack command-line clients"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:588
|
|
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 command-line interface (CLI)."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:594
|
|
msgid ""
|
|
"For information about the command-line clients, see `OpenStack Command-Line "
|
|
"Interface Reference <http://docs.openstack.org/cli-reference/>`__."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:598
|
|
msgid "Install the clients"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:600
|
|
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:605
|
|
msgid ""
|
|
"You must install the client for each project separately, but the ``python-"
|
|
"openstackclient`` covers multiple projects."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:608
|
|
msgid "Install or update a client package:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:614
|
|
msgid "Where *PROJECT* is the project name."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:616
|
|
msgid "For example, install the ``openstack`` client:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:622
|
|
msgid "To update the ``openstack`` client, run this command:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:628
|
|
msgid "To remove the ``openstack`` client, run this command:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:634
|
|
msgid ""
|
|
"Before you can issue client commands, you must download and source the "
|
|
"``openrc`` file to set environment variables."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:637
|
|
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 Administrator Guide <http://docs."
|
|
"openstack.org/admin-guide/>`__, and `OpenStack Command-Line Interface "
|
|
"Reference <http://docs.openstack.org/cli-reference/>`__."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:643
|
|
msgid "Launch an instance"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:645
|
|
msgid ""
|
|
"To launch instances, you must choose a name, an image, and a flavor for your "
|
|
"instance."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:648
|
|
msgid ""
|
|
"To list available images, call the Compute API through the ``openstack`` "
|
|
"client:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:663
|
|
msgid "To list flavors, run this command:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:683
|
|
msgid "To launch an instance, note the IDs of your desired image and flavor."
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:685
|
|
msgid ""
|
|
"To launch the ``my_instance`` instance, run the ``openstack server create`` "
|
|
"command with the image and flavor IDs and the server name:"
|
|
msgstr ""
|
|
|
|
#: ../api-quick-start.rst:727
|
|
msgid ""
|
|
"For information about the default ports that the OpenStack components use, "
|
|
"see `Firewalls and default ports <http://docs.openstack.org/liberty/ config-"
|
|
"reference/content/firewalls-default-ports.html>`_ 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 :ref:`openstack_API_quick_guide`."
|
|
msgstr ""
|
|
|
|
#: ../index.rst:24
|
|
msgid "**OpenStack command-line client**"
|
|
msgstr ""
|
|
|
|
#: ../index.rst:26
|
|
msgid ""
|
|
"The OpenStack project provides a command-line client that enables you to "
|
|
"access APIs through easy-to-use commands. See the section called :ref:"
|
|
"`client-intro`."
|
|
msgstr ""
|
|
|
|
#: ../index.rst:30
|
|
msgid "**REST clients**"
|
|
msgstr ""
|
|
|
|
#: ../index.rst:32
|
|
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:38
|
|
msgid "**OpenStack Python Software Development Kit (SDK)**"
|
|
msgstr ""
|
|
|
|
#: ../index.rst:40
|
|
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:50
|
|
msgid "Learn more"
|
|
msgstr ""
|