# 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: 2016-01-19 06:04+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: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 `__." 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 "" "For a typical OpenStack deployment that runs Identity, use the following " "cURL command to request a token. Specify your tenant name, and user name and " "password credentials:" msgstr "" #: ../api-quick-start.rst:93 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:99 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:110 msgid "The following example shows a successful response:" msgstr "" #: ../api-quick-start.rst:335 msgid "Send API requests" msgstr "" #: ../api-quick-start.rst:337 msgid "" "This section shows how to make some basic Compute API calls. For a complete " "list of Compute API calls, see `Compute API (CURRENT) `__." msgstr "" #: ../api-quick-start.rst:341 msgid "Export the token ID to the ``TOKEN`` environment variable. For example:" msgstr "" #: ../api-quick-start.rst:347 msgid "The token expires every 24 hours." msgstr "" #: ../api-quick-start.rst:349 msgid "Use the Compute API to list flavors:" msgstr "" #: ../api-quick-start.rst:432 msgid "Use the Compute API to list images:" msgstr "" #: ../api-quick-start.rst:542 msgid "Use the Compute API to list servers:" msgstr "" #: ../api-quick-start.rst:574 msgid "OpenStack command-line clients" msgstr "" #: ../api-quick-start.rst:576 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:582 msgid "" "For information about the command-line clients, see `OpenStack Command-Line " "Interface Reference `__." msgstr "" #: ../api-quick-start.rst:586 msgid "Install the clients" msgstr "" #: ../api-quick-start.rst:588 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:593 msgid "" "You must install the client for each project separately, but the ``python-" "openstackclient`` covers multiple projects." msgstr "" #: ../api-quick-start.rst:596 msgid "Install or update a client package:" msgstr "" #: ../api-quick-start.rst:602 msgid "Where *PROJECT* is the project name." msgstr "" #: ../api-quick-start.rst:604 msgid "For example, install the ``openstack`` client:" msgstr "" #: ../api-quick-start.rst:610 msgid "To update the ``openstack`` client, run this command:" msgstr "" #: ../api-quick-start.rst:616 msgid "To remove the ``openstack`` client, run this command:" msgstr "" #: ../api-quick-start.rst:622 msgid "" "Before you can issue client commands, you must download and source the " "``openrc`` file to set environment variables." msgstr "" #: ../api-quick-start.rst:625 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:631 msgid "Launch an instance" msgstr "" #: ../api-quick-start.rst:633 msgid "" "To launch instances, you must choose a name, an image, and a flavor for your " "instance." msgstr "" #: ../api-quick-start.rst:636 msgid "" "To list available images, call the Compute API through the ``openstack`` " "client:" msgstr "" #: ../api-quick-start.rst:651 msgid "To list flavors, run this command:" msgstr "" #: ../api-quick-start.rst:671 msgid "To launch an instance, note the IDs of your desired image and flavor." msgstr "" #: ../api-quick-start.rst:673 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:715 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 :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 `__. For Chrome, see `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 `__ in " "the *OpenStack End User Guide*." msgstr "" #: ../index.rst:50 msgid "Learn more" msgstr ""