Cloud CLI Концепции

Эта тема описывает общие термины, связанные с Cloud CLI.

• Команда

  Команды — это инструкции по выполнению операций, предоставляемые Cloud CLI для настройки рабочей среды или вызова открытых API облачных сервисов.

  Формат команды вызова API выглядит следующим образом:

  cloud [options] <service> <operation> [--param1=paramValue1 --param2=paramValue2 ...]

  Формат системной команды выглядит следующим образом:

  cloud [options] <systemCommand> <operation> [--param1=paramValue1 --param2=paramValue2 ...]

  В следующей команде для запроса Elastic Cloud Servers (ECSs), service — ECS, operation — NovaListServers, а общая информация, необходимая для вызова API, получена из profile с именем default:

  cloud ECS NovaListServers --cli-profile=default
  
  

• Операция

  A unique name for a cloud service API released on API Explorer. You can query the operation list of a cloud service by using API Explorer or by running the cloud <service> --help command.

• Профиль

  Профили хранят общую информацию, необходимую для вызова API облачных сервисов. Их можно определить, выполнив команды Cloud CLI. Все профили образуют файл конфигурации, который хранится на вашем локальном хосте. При вызове API облачного сервиса вы можете указать профиль вместо ручного ввода общей информации.

  Общая информация, которую можно задать в профиле, включает ключ доступа (AK/SK), регион (cli-region), идентификатор проекта (cli-project-id) и идентификатор аккаунта (cli-domain-id).

• Default profile

  Профиль, используемый по умолчанию, если в команде не указан профиль. Cloud CLI использует в качестве профиля по умолчанию тот, который был последним добавлен или изменён. Если профиль по умолчанию удалён, в качестве нового профиля по умолчанию используется самый ранний добавленный профиль из оставшихся. Вы можете выполнить команду cloud configure set --cli-profile=${profileName}, чтобы изменить профиль по умолчанию.

• Parameter

  Параметры классифицируются на API‑параметры и системные параметры Cloud CLI. API‑параметры определяются в API облачных сервисов. Системные параметры являются встроенными параметрами Cloud CLI. Системные параметры используются в фиксированном режиме и имеют определённые значения. Для получения подробной информации см. system parameter list.

• Option

  Опции являются системными параметрами Cloud CLI, которые могут быть непосредственно добавлены к командам для вызова API. Не все системные параметры могут использоваться как опции. Для получения подробной информации см. option list.

• Metadata

  Details about cloud services and their APIs that are obtained by Cloud CLI during command execution to verify and parse parameters. Remotely obtained metadata is stored locally to reduce network I/O and improve command response. A file that stores metadata is called a metadata cache file. For details, see Managing Metadata.

  When using the offline mode, Cloud CLI downloads existing metadata, which is called an "offline metadata package".