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

Перечисление операций подписки

Обновлено: Февраль 2015 г.

Операция List Subscription Operations возвращает список операций создания, обновления и удаления, которые выполнялись в подписке в течение заданных временных рамок.

Запрос List Subscription Operations можно указать следующим образом. Замените <subscription-id> идентификатором подписки.

 

Метод URI запроса

GET

https://management.core.windows.net/<subscription-id>/operations

Необходимо убедиться, что запрос к службе управления безопасен. Дополнительные сведения см. в разделе Проверка подлинности запросов по управлению службами.

 

Параметр URI Описание

StartTime=<start-of-timeframe>

Обязательно. Начало временного отрезка для перечисления операций подписки в формате UTC. Этот параметр и параметр EndTime определяют временные рамки для получения операций подписки. Этот параметр может указывать дату начала максимум за последние 90 дней.

Если для этого параметра задается время, необходимо вставить перед значением времени строковый литерал T, обозначающий начало элемента времени. Кроме того, после элемента времени необходимо вставить строковый литерал Z, указывающий на то, что время представлено в формате UTC. Например, время начала "1 марта 2011 г. в 16:30" будет записано следующим образом: StartTime=2011-03-01T16:30:00Z

Можно использовать следующие форматы времени:

  • StartTime=[4DigitYear]-[2DigitMonth]-[2DigitDay]

    Пример. StartTime=2011-03-01

  • StartTime=[4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:2DigitSecond]Z

    Пример. StartTime=2011-03-01T16:30:00Z

  • StartTime=[4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitMinute]:[2DigitSecond].[7DigitsOfPrecision]Z

    Пример. StartTime=2011-03-01T16:30:00.0005000Z

EndTime=<end-of-timeframe>

Обязательно. Конец отрезка времени для начала перечисления операций подписки в формате UTC. Этот параметр и параметр StartTime определяют временные рамки для получения операций подписки.

Если для этого параметра задается время, необходимо вставить перед значением времени строковый литерал T, обозначающий начало элемента времени. Кроме того, после элемента времени необходимо вставить строковый литерал Z, указывающий на то, что время представлено в формате UTC. Например, время окончания "7 марта 2011 г. в 16:30" будет записано следующим образом: EndTime=2011-03-07T16:30:00Z

Можно использовать следующие форматы времени:

  • EndTime=[4DigitYear]-[2DigitMonth]-[2DigitDay]

    Пример. EndTime=2011-03-07

  • EndTime=[4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:2DigitSecond]Z

    Пример. EndTime=2011-03-07T16:30:00Z

  • EndTime=[4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitMinute]:[2DigitSecond].[7DigitsOfPrecision]Z

    Пример. EndTime=2011-03-07T16:30:00.0005000Z

ObjectIdFilter=<object-url>

Необязательно. Возвращает операции подписки только для указанного типа и идентификатора объекта. Для выполнения в объекте операции HTTP GET этот параметр должен быть установлен равным значению URL-адреса. Если какой-либо объект не указан, то фильтр не применяется. Применимые типы объектов и примеры приведены ниже. Замените значения примера для <subscription-id> своими значениями.

 

Тип объекта

URL-адрес объекта для фильтрации

Подписка

ObjectIdFilter=/<subscription-id>

Облачная служба

ObjectIdFilter=/<subscription-id>/services/hostedservices/<cloud-service-name>

Служба хранения

ObjectIdFilter=/<subscription-id>/services/storageservices/<storage-service-name>

Территориальная группа

ObjectIdFilter=/<subscription-id>/affinitygroups/<affinity-group-name>

Развертывание

ObjectIdFilter=/<subscription-id>/services/hostedservices/<cloud-service-name>/deployments/<deployment-name>

Экземпляр роли

ObjectIdFilter=/<subscription-id>/services/hostedservices/<cloud-service-name>/deployments/<deployment-name>/roleinstances/<role-instance-name>

Образ машины

ObjectIdFilter=/<subscription-id>/machineimages/<machine-image-name>

OperationResultFilter=<Succeeded|Failed|InProgress>

Необязательно. Возвращает только операции подписки для указанного состояния результата — Succeeded, Failed или InProgress. Этот фильтр можно объединить с ObjectIdFilter, чтобы выделить операции подписки для объекта с определенным состоянием результата. Если состояние результата не указано, то фильтр не применяется. Например, следующий пример URI-запроса возвращает все успешные операции для службы хранения:

ObjectIdFilter=/<subscription-id>/services/storageservices/<storage-service-name>&OperationResultFilter=Succeeded

ContinuationToken=<opaque-continuation-token>

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

В следующей таблице описаны заголовки запросов.

 

Заголовок запроса Описание

x-ms-version

Обязательно. Задает версию операции, используемой для этого запроса. Этот заголовок должен быть установлен в значение 25.02.11 или на более позднюю дату. Дополнительные сведения об управлении версиями заголовков см. в разделе Работа с версиями при управлении службами.

Отсутствует.

Ответ включает код состояния HTTP, набор заголовков ответа и текст ответа.

Успешная операция возвращает код состояния 200 (ОК). Сведения о кодах состояния см. в разделе Коды состояний и ошибок управления службами.

Ответ для этой операции включает следующие заголовки. Ответ может также включать дополнительные стандартные заголовки HTTP. Все стандартные заголовки соответствуют спецификации протокола HTTP/1.1.

 

Заголовок ответа Описание

x-ms-request-id

Значение, которое однозначно определяет запрос к службе управления.

Текст ответа имеет следующий формат:


<?xml version="1.0" encoding="utf-8"?>
<SubscriptionOperationCollection xmlns="http://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <SubscriptionOperations>
    <SubscriptionOperation>
      <OperationId>subscription-operation-id</OperationId>
      <OperationObjectId>subscription-object-id</OperationObjectId>
      <OperationName>subscription-operation-name</OperationName>
      <OperationParameters">
        <OperationParameter>
          <a:Name>operation-parameter-name</a:Name>
          <a:Value>value-of-parameter</a:Value>
        </OperationParameter>
      </OperationParameters>
      <OperationCaller>
        <UsedServiceManagementApi>true</UsedServiceManagementApi>
        <SubscriptionCertificateThumbprint>subscription-certificate-thumbprint</SubscriptionCertificateThumbprint>
        <ClientIP>client-ip-address</ClientIP>
      </OperationCaller>
      <OperationStatus>operation-status</OperationStatus>
      <OperationStartedTime>operation-start-time</OperationStartedTime>
      <OperationCompletedTime>operation-completed-time</OperationCompletedTime>
    </SubscriptionOperation>
  </SubscriptionOperations>
<ContinuationToken>continuation-token-value</ContinuationToken>
</SubscriptionOperationCollection>

В следующей таблице описаны элементы текста ответа.

 

Имя элемента Описание

Subscription Operations

Указывает список операций, выполненных в подписке в течение заданных временных рамок.

Continuation Token

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

Subscription Operation

Указывает единственную операцию, выполненную в подписке в течение заданных временных рамок.

Operation ID

Указывает глобальный уникальный идентификатор (GUID) операции.

Operation Object ID

Указывает целевой объект операции. Это значение равно URL-адресу для выполнения запроса HTTP GET относительно объекта и соответствует тем же значениям ObjectIdFilter в запросе.

Operation Name

Указывает имя выполненной операции. Возможные значения:

  • ActivateDomainName

  • AddCertificates

  • AddSubscriptionCertificate

  • ChangeDeploymentConfiguration

  • ChangeDeploymentConfigurationBySlot

  • CommitImageUpload

  • CreateAffinityGroup

  • CreateDeployment

  • CreateDeploymentBySlot

  • CreateHostedService

  • CreateStorageService

  • DeleteAffinityGroup

  • DeleteCertificate

  • DeleteDeployment

  • DeleteHostedService

  • DeleteImage

  • DeleteStorageService

  • PrepareImageUpload

  • RebootDeploymentRoleInstance

  • RebootDeploymentRoleInstanceBySlot

  • ReimageDeploymentRoleInstance

  • ReimageDeploymentRoleInstanceBySlot

  • RegenerateStorageServiceKeys

  • RegisterDomainName

  • RemoveSubscriptionCertificate

  • RollbackDeploymentUpdateOrUpgrade

  • SetImageProperties

  • SetParentImage

  • SwapDeployment

  • UnregisterDomainName

  • UpdateAffinityGroup

  • UpdateDeploymentStatus

  • UpdateDeploymentStatusBySlot

  • UpdateHostedService

  • UpdateStorageService

  • UpdateStorageService

  • UpgradeDeployment

  • UpgradeDeploymentBySlot

  • WalkUpgradeDomain

  • WalkUpgradeDomainBySlot

Operation Parameters

Указывает коллекцию параметров для выполненной операции.

Operation Parameter

Указывает одиночный параметр для выполненной операции.

Название

Указывает имя параметра.

Value

Указывает значение параметра. Значение можно представить в виде строки или XML-документа в зависимости от того, какая операция подписки была выполнена.

OperationCaller

Указывает коллекцию атрибутов, которая определяет источник операции.

UsedServiceManagementApi

Показывает, была ли операция начата с помощью API управления службами. Значение false, если она была начата другим источником, таким как Портал управления.

UserEmailAddress

Указывает электронную почту, связанную с Windows Live ID пользователя, который начал операцию из Портал управления. Этот элемент возвращается, только если элемент UsedServiceManagementApi имеет значение false.

ClientIP

Указывает IP-адрес клиентского компьютера, который начал операцию. Этот элемент возвращается, только если элемент UsedServiceManagementApi имеет значение true.

SubscriptionCertificateThumbprint

Указывает отпечаток сертификата подписки, использовавшейся для начала операции.

Operation Status

Указывает объект, содержащий сведения о текущем состоянии операции. Возвращаемый объект имеет следующий формат XML.

<OperationStatus><ID>339c6c13-1f81-412f-9bc6-00e9c5876695</ID><Status>Succeeded</Status><HttpStatusCode>200</HttpStatusCode></OperationStatus>

Возможные значения элемента Status, который содержит состояние операции:

  • Succeeded

  • Failed

  • InProgress

OperationStartedTime

Указывает время начала выполнения операции. Формат времени:

[4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:2DigitSecond]Z

Пример. 2011-05-11T16:15:26Z

noteПримечание
Указывает, что элемент OperationStartedTime доступен только при использовании версии 2011-06-01 или более поздней.

OperationCompletedTime

Указывает время окончания выполнения операции. Этот элемент не присутствует, если операция все еще выполняется. Формат времени:

[4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:2DigitSecond]Z

Пример. 2011-05-11T16:15:32Z

noteПримечание
Элемент OperationCompletedTime доступен только при использовании версии 2011-06-01 или более поздней.

Корпорация Майкрософт проводит интернет-опрос, чтобы выяснить ваше мнение о веб-сайте MSDN. Если вы желаете принять участие в этом интернет-опросе, он будет отображен при закрытии веб-сайта MSDN.

Вы хотите принять участие?
Показ:
© 2015 Microsoft