Обзор
Добро пожаловать к Elastic Cloud Server API Reference. Elastic Cloud Server (ECS) – это легко получаемый эластично масштабируемый сервер вычислений, состоящий из процессора, памяти, образа и дисков EVS. ECS может работать с виртуальной частной сетью (VPC), виртуальным брандмауэром и несколькими копиями данных для создания эффективной, надежной и безопасной среды вычислений, чтобы ваши службы работали стабильно. После создания ECS, вы можете использовать его так же, как свой локальный компьютер или физический сервер.
Этот документ описывает ECS интерфейсы прикладного программирования (API), включая описание, синтаксис, параметры и примеры. Для получения подробной информации обо всех поддерживаемых операциях см. раздел API Overview.
Если вы планируете обращаться к ECS через API, убедитесь, что вы знакомы с концепциями ECS. Подробности см. в разделе «Обзор сервиса» в документе Elastic Cloud Server User Guide.
Обращение к API
ECS поддерживают интерфейсы API передачи состояния представления (REST), позволяющие вызывать API с использованием HTTPS. Подробнее о вызове API см. раздел Calling APIs.
Эндпоинты
Эндпоинт – это адрес запроса для вызова API. Эндпоинты различаются в зависимости от сервисов и регионов. Чтобы узнать эндпоинты всех сервисов, см. раздел Regions and Endpoints.
Ограничения
- Количество создаваемых вами экземпляров ECS определяется вашей квотой. Чтобы просмотреть или увеличить квоту, см. раздел «Корректировка квоты» в руководстве пользователя Elastic Cloud Server User Guide.
- Для ознакомления с дополнительными ограничениями смотрите описание API.
Концепции
- Аккаунт
Аккаунт создается после успешного прохождения регистрации. Аккаунт имеет полные права доступа ко всем своим облачным сервисам и ресурсам. Он используется для сброса паролей пользователей и предоставления пользователям разрешений. Аккаунт является платёжным субъектом, который не следует напрямую использовать для выполнения рутинного администрирования. В целях безопасности создайте пользователей службы идентификации и контроля доступа (IAM) и предоставьте им разрешения для повседневного администрирования.
- Пользователь
Пользователь IAM создаётся аккаунтом в службе IAM для использования облачных сервисов. У каждого пользователя IAM есть собственные учетные данные (пароль и ключи доступа).
Аутентификация API требует таких сведений, как имя аккаунта, имя пользователя и пароль.
- Регион
Регион представляет собой географическую область, где развертываются облачные ресурсы. Зоны доступности (AZ) одного региона могут взаимодействовать друг с другом по внутренней сети, а зоны доступности разных регионов изолированы друг от друга. Развертывание облачных ресурсов в различных регионах позволяет лучше соответствовать требованиям определенных пользователей или соблюдать местные законы или нормативные акты.
- Зона доступности (AZ)
Состоит из одного или нескольких физических центров обработки данных, оснащенных независимыми системами вентиляции, пожаротушения, водоснабжения и электроснабжения. Вычислительные, сетевые, хранилищные и другие ресурсы в зоне доступности логически делятся на несколько кластеров. Зоны доступности в пределах одного региона соединены высокоскоростными оптоволоконными линиями связи, что позволяет вам создавать системы высокой доступности между зонами доступности.
- Проект
Проект соответствует региону. По умолчанию проекты определены для группировки и физического разделения ресурсов (включая вычислительные, хранилища и сетевые ресурсы) по регионам. Пользователям можно предоставить разрешения в проекте по умолчанию для доступа ко всем ресурсам под своими аккаунтами в регионе, соответствующем проекту. При необходимости более детального контроля доступа можно создать подпроекты под проектом по умолчанию и создать ресурсы в подпроектах. Затем вы сможете назначить пользователям разрешения, необходимые для доступа только к ресурсам конкретного подпроекта.
Рисунок 1 Модель изоляции проектов
Получение данных постранично
Интерфейсы OpenStack API позволяют пользователям запрашивать данные с использованием критериев поиска. Параметры limit и marker добавляются в URL-запрос списка, чтобы система могла отображать результаты запросов постранично. Результаты запросов сортируются по времени создания (create_time) записей в возрастающем порядке. Если время создания не указано, результаты сортируются по объектному идентификатору в возрастающем порядке.
Параметр | Тип | Обязательно | Описание |
|---|---|---|---|
limit | Строковый тип | Нет | Определяет количество записей, отображаемых на каждой странице. Если значение параметра limit превышает максимальное число, настроенное в Nova, возвращается код ошибки 403. |
marker | Строковый тип | Нет | Указывает идентификатор последней записи предыдущей страницы. Если параметр marker указан неверно, возвращается код ошибки 400. |
next ref в ответе указывает адрес URL следующей страницы.