列出订阅操作
折叠目录
展开目录
本文由机器翻译。若要查看英语原文,请勾选“英语”复选框。 也可将鼠标指针移到文本上,在弹出窗口中显示英语原文。
翻译
英语

列出订阅操作

 

List Subscription Operations 操作返回在指定时间范围中已对某一订阅执行的创建、更新和删除操作的列表。

可以按以下方式指定 List Subscription Operations 请求。<subscription-id> 替换为订阅 ID。

方法

请求 URI

GET

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

你必须确保向管理服务发出的请求是安全的。 有关其他详细信息,请参阅 进行身份验证服务管理请求

URI 参数

说明

StartTime=<start-of-timeframe>

必需。 采用 UTC 格式的用于开始列出订阅操作的时间范围的开始时间。 此参数和 EndTime 参数一起指示用来检索订阅操作的时间范围。 此参数不能指示过去超过 90 天的开始日期。

如果你为该参数指定某个时间,则必须在该时间前包括文本字符串“T”,这指示时间元素的开头。 此外,你还必须在时间元素后包括文本字符串“Z”,这指示该时间采用 UTC 格式。 例如,2011 年 3 月 1 日下午 4: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 格式。 例如,2011 年 3 月 7 日下午 4: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>

可选。 只为指定的对象类型和对象 ID 返回订阅操作。 为了针对该对象执行 HTTP GET,此参数必须设置为等于 URL 值。 如果未指定对象,则筛选器不适用于。 下面包括了适用对象类型和示例。 用你自己的值替代示例值,例如 <subscription-id>

Object Type

Object URL for Filter

订阅

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>

可选。 只为指定的结果状态(SucceededFailedInProgress)返回订阅操作。 可将此筛选器与 ObjectIdFilter 结合使用,以便为具有特定结果状态的对象选择订阅操作。 如果未指定结果状态,则筛选器不适用于。 例如,以下请求 URI 代码段返回某一存储服务的所有成功的操作:

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

ContinuationToken=<opaque-continuation-token>

可选。 在操作过多以致无法列出时,例如在请求的时间范围非常大时,响应将包括不完整列表以及可用于返回列表其余部分的标记。 后续请求必须包括此参数以便从上一个响应停止的位置开始继续列出其余操作。 如果未指定任何标记,筛选器将不应用,并且响应将从指定的 StartTime 开始。

下表介绍请求标头。

请求标头

说明

x-ms-version

必需。 指定用于此请求的操作的版本。 此标头应设置为 2011年-02-25 或更高版本。 有关版本控制标头的详细信息,请参阅 服务管理版本控制

响应包括 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

指定操作的目标对象。 该值等于要针对该对象执行 HTTP GET 的 URL,并且对应于请求中 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 关联的电子邮件。 仅在 UsedServiceManagementApifalse 时返回该元素。

ClientIP

指定启动了该操作的客户端计算机的 IP 地址。 仅在 UsedServiceManagementApitrue 时返回该元素。

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

System_CAPS_note注意

指定仅在 01.06.11 版或更高版本中才可以使用 OperationStartedTime 元素。

OperationCompletedTime

指定操作完成执行的时间。 如果操作仍在进行中,则该元素不存在。 该时间的格式为:

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

示例: 2011-05-11T16:15:32Z

System_CAPS_note注意

仅在 2011-06-01 版或更高版本中才可以使用 OperationCompletedTime 元素。

显示:
© 2016 Microsoft