Обзор
Добро пожаловать в Elastic Cloud Server Справочник API. Elastic Cloud Server (ECS) — это легко‑получаемый, эластично масштабируемый вычислительный сервер, состоящий из CPU, памяти, образа и дисков EVS. ECS может работать с Virtual Private Cloud (VPC), виртуальным брандмауэром и несколькими копиями данных, чтобы создать эффективную, надёжную и безопасную вычислительную среду, позволяющую вашим сервисам стабильно работать. После создания ECS, вы можете использовать его так же, как ваш локальный компьютер или физический сервер.
В этом документе описывается ECS программные интерфейсы приложений (APIs), включая описание, синтаксис, параметры и примеры. Для подробностей обо всех поддерживаемых операциях см. Обзор API.
Если вы планируете получать доступ к ECS через API, убедитесь, что знакомы с концепциями ECS. Для получения деталей см. "Service Overview" в Elastic Cloud Server Руководство пользователя.
Вызов API
ECS поддерживает Representational State Transfer (REST) API, позволяя вызывать API через HTTPS. Для получения деталей о вызове API см. Вызов API.
Эндпоинты
Эндпоинт — это адрес запроса для вызова API. Эндпоинты различаются в зависимости от сервисов и регионов. Для получения информации об эндпоинтах всех сервисов смотрите Регионы и эндпоинты.
Ограничения
- Количество ECS, которые вы можете создать, определяется вашей квотой. Чтобы просмотреть или увеличить квоту, см. "Quota Adjustment" в Elastic Cloud Server Руководство пользователя.
- Дополнительные ограничения см. в описании API.
Концепции
- Учётная запись
Учётная запись создаётся после успешной регистрации. Учётная запись имеет полные права доступа ко всем своим облачным сервисам и ресурсам. Её можно использовать для сброса паролей пользователей и предоставления им прав. Учётная запись является платёжным субъектом, поэтому не следует использовать её напрямую для обычного управления. В целях безопасности создавайте пользователей Identity and Access Management (IAM) и предоставляйте им права для обычного управления.
- Пользователь
IAM‑пользователь создаётся учётной записью в IAM для использования облачных сервисов. У каждого IAM‑пользователя есть собственные учётные данные (пароль и ключи доступа).
Для аутентификации API требуется информация, такая как имя учётной записи, имя пользователя и пароль.
- Регион
Регион — это географическая область, в которой развертываются облачные ресурсы. Зоны доступности (AZ) в одном регионе могут обмениваться данными через интранет, тогда как зоны в разных регионах изолированы друг от друга. Размещение облачных ресурсов в разных регионах может лучше соответствовать определённым требованиям пользователей или соответствовать местным законам и нормативным актам.
- AZ
AZ содержит один или несколько физических дата‑центров с независимыми системами питания, охлаждения, подавления пожара и водоснабжения. Внутри AZ вычислительные, сетевые, хранилищные и другие ресурсы логически разбиты на несколько кластеров. AZ в пределах региона соединены высокоскоростными оптическими волокнами, позволяя создавать высокодоступные системы с перекрёстным AZ.
- Проект
Проект соответствует региону. Проекты по умолчанию определяются для группировки и физической изоляции ресурсов (включая вычислительные, хранилищные и сетевые ресурсы) между регионами. Пользователям могут быть предоставлены права в проекте по умолчанию для доступа ко всем ресурсам их учётных записей в регионе, связанном с проектом. Если требуется более детальный контроль доступа, создайте подпроекты внутри проекта по умолчанию и размещайте ресурсы в подпроектах. Затем можно назначить пользователям права, необходимые для доступа только к ресурсам в конкретных подпроектах.
Рисунок 1 Модель изоляции проектов
Запрос данных постранично
OpenStack API позволяют пользователям запрашивать данные, используя критерии поиска. Параметр limit и marker параметры добавляются к URL запроса списка, чтобы система могла выводить результаты запроса постранично. Результаты выводятся в порядке возрастания времени создания (create_time) записей. Если время создания не указано, результаты отображаются по ID объекта в порядке возрастания.
Параметр | Тип | Обязательно | Описание |
|---|---|---|---|
limit | String | Нет | Определяет количество записей, отображаемых на каждой странице. Если limit значение превышает максимально допустимое, настроенное в Nova, будет возвращён код ошибки 403. |
marker | String | Нет | Определяет ID последней записи на предыдущей странице. Если marker значение недопустимо, будет возвращён код ошибки 400. |
next ref в ответе указывает URL следующей страницы.