Экспорт (0) Печать
Развернуть все

Справочник по API-интерфейсу управления службами REST

Обновлено: Апрель 2014 г.

API-интерфейс управления службами предоставляет программный доступ к большинству функций, доступных через административный портал.

API-интерфейс управления службами является API-интерфейсом REST. Все API-операции выполняются через протокол SSL и проходят взаимную проверку подлинности с использованием сертификатов x.509 v3.

Подписка Windows Azure является уникальной учетной записью пользователя в Windows Azure. Все ресурсы, доступные через API-интерфейс управления службами, предоставляются по подписке.

Подписка Windows Azure при создании обозначается уникальным идентификатором подписки Идентификатор подписки входит в состав URI для каждого вызова, выполняемого API-интерфейсом управления службами. См. Addressing Service Management Resources для получения сведений о построении URI для операций управления службами.

Учетная запись хранилища — это уникальная конечная точка для служб BLOB-объектов, очередей и таблиц в Windows Azure. Дополнительные сведения о службах BLOB-объектов, очередей и таблиц см. в разделе Справочник по API-интерфейсу REST служб хранилища.

Для использования служб BLOB-объектов, очередей и таблиц необходимо создать учетную запись хранилища. Имя, присвоенное учетной записи хранилища, становится именем узла в URI, который используется для адресации ресурсов больших двоичных объектов, очередей и таблиц. Например, для адресации ресурса контейнера в службе BLOB-объектов используется URI следующего вида, где <storage-account> — это имя учетной записи хранилища:

http://<storage-account>.blob.core.windows.net/mycontainer

Каждая учетная запись хранилища имеет 2 связанных ключа доступа: первичный ключ доступа и вторичный ключ доступа. Эти ключи используются для проверки подлинности запросов относительно учетной записи хранилища.

Можно использовать API управления службами для управления существующей учетной записью хранилища. Этот API-интерфейс включает операции нумерации учетных записей хранилища в подписке, возвращения свойств учетной записи хранилища, получения основного или вторичного ключа доступа и повторного создания ключей. Полный список операций API см. в разделе Operations on Storage Accounts.

Облачная служба является контейнером для ваших развертываний приложений в Windows Azure. Имя, назначаемое облачной службе, должно быть уникальным во всей службе Windows Azure. Это имя будет использоваться как часть URI для вызовов к API-интерфейсу управления службами, необходимых для работы в этой облачной службе.

Несколько операций в API-интерфейсе управления службами позволяют управлять облачной службой либо путем ссылки на развертывание по имени развертывания, либо по ссылке на среду развертывания (промежуточную или рабочую), в которой выполняется развертывание.

noteПримечание
Несколько операций управления службами в облачных службах являются асинхронными. См. Tracking Asynchronous Service Management Requests для получения дополнительных сведений о вызове асинхронных операций.

Полный список операций API см. в разделе Operations on Cloud Services.

Сертификаты управления можно загрузить в хранилище сертификатов Windows Azure для конкретной подписки посредством портала управления. Сертификаты теперь упаковываются и загружаются отдельно от двоичных файлов для службы. Это значит, что управление сертификатами теперь может выполнять не только разработчик, но и, например, ИТ-менеджер. Файл определения службы определяет логическое имя сертификата, а также имя и расположение локального хранилища, в котором он может быть найден, и сопоставляет сертификат с конечной точкой облачной службы. Файл конфигурации службы сопоставляет логическое имя сертификата со своим отпечатком.

Полный список операций API см. в разделе Operations on Service Certificates.

При создании облачной службы или учетной записи хранилища следует указать для нее географическое расположение. Это можно сделать, либо задав расположение центра обработки данных, либо отнеся облачную службу или учетную запись хранилища к территориальной группе. Обратите внимание, что необходимо выбрать одно или другое — нельзя указать и то и другое сразу.

Территориальная группа гарантирует, что ваши облачные службы будут расположены вместе в центрах обработки данных Windows Azure. Если облачные службы в вашей подписке должны работать совместно (например, если служба хранит данные в облачной службе BLOB-объектов или таблиц или рабочий процесс основан на службе очередей), можно упорядочить облачную службу и учетную запись хранилища по территориальной группе для оптимальной производительности.

Территориальная группа определяется на уровне подписки и доступна для всех последующих создаваемых облачных служб и учетных записей хранилища. Территориальную группу можно создать при создании учетной записи хранилища или облачной службы. Затем можно связывать другие облачные службы с территориальной группой по мере их создания.

noteПримечание
Если облачная служба или учетная запись хранилища создается, но не связывается с территориальной группой во время создания, то для связывания с территориальной группой позднее необходимо ее удалить и повторно создать.

Для создания, перечисления, удаления, обновления и извлечения свойств территориальной группы и расположений в подписке можно использовать API управления службами. Полный список операций API см. в разделах Operations on Affinity Groups и Operations on Locations.

Журнал подписки за указанные временные рамки можно просматривать с помощью API управления службами. Например, можно вывести список всех облачных служб, которые были созданы в прошлом месяце. Полный список операций API см. в разделе Operations on Subscriptions.

С помощью API управления службами можно создавать виртуальные машины и управлять ими. Полный список операций API-интерфейса см. здесь:

Можно задавать и изменять конфигурацию виртуальной сети. Полный список операций API см. в разделах Operations on Virtual Networks и Operations on Virtual Network Gateways.

См. также

Показ:
© 2014 Microsoft