# SOME DESCRIPTIVE TITLE. # Copyright (C) 2015, OpenStack contributors # This file is distributed under the same license as the API-Quick-Start package. # FIRST AUTHOR , 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 \n" "Language-Team: LANGUAGE \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 `__." 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 `__." 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 `__." 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 `__. 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 `__, `OpenStack Admin User Guide `__, and `OpenStack Command-Line Interface " "Reference `__." 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 `__ 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 `__. For Chrome, see `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 `__ in " "the *OpenStack End User Guide*." msgstr "" #: ../index.rst:51 msgid "Learn more" msgstr ""