Exportar (0) Imprimir
Expandir Tudo

Listar operações de assinatura

Atualizado: maio de 2014

A operação List Subscription Operations retorna uma lista de operações de criação, atualização e exclusão executadas em uma assinatura durante o período especificado.

A solicitação List Subscription Operations pode ser especificada da seguinte maneira. Substitua <subscription-id> por sua ID de assinatura.

 

Método URI de solicitação

GET

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

Verifique se a solicitação feita ao serviço de gerenciamento é segura. Para obter mais detalhes, consulte Autenticando solicitações do gerenciamento de serviços.

 

Parâmetro URI Descrição

StartTime=<start-of-timeframe>

Obrigatória. O início do período de tempo para iniciar a lista de operações de assinatura no formato UTC. Esse parâmetro e o parâmetro EndTime indicam o período de tempo para recuperar operações de assinatura. Esse parâmetro não pode indicar uma data de início de mais de 90 dias no passado.

Se você especificar uma hora para esse parâmetro, deverá incluir a cadeia de caracteres literal “T” antes da hora, o que indica o início do elemento de hora. Além disso, você deve incluir a cadeia de caracteres literal “Z” depois do elemento de hora, que indica que a hora está no formato UTC. Por exemplo, a data/hora de início 1º de março de 2011 às 16h30 seria expressa da seguinte maneira: StartTime=2011-03-01T16:30:00Z

Você também pode usar os seguintes formatos de hora:

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

    Exemplo: StartTime=2011-03-01

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

    Exemplo: StartTime=2011-03-01T16:30:00Z

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

    Exemplo: StartTime=2011-03-01T16:30:00.0005000Z

EndTime=<end-of-timeframe>

Obrigatória. O fim do período de tempo para iniciar a lista de operações de assinatura no formato UTC. Esse parâmetro e o parâmetro StartTime indicam o período de tempo para recuperar operações de assinatura.

Se você especificar uma hora para esse parâmetro, deverá incluir a cadeia de caracteres literal “T” antes da hora, o que indica o início do elemento de hora. Além disso, você deve incluir a cadeia de caracteres literal “Z” depois do elemento de hora, que indica que a hora está no formato UTC. Por exemplo, a data/hora de término 7 de março de 2011 às 16h30 seria expressa da seguinte maneira: EndTime=2011-03-07T16:30:00Z

Você também pode usar os seguintes formatos de hora:

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

    Exemplo: EndTime=2011-03-07

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

    Exemplo: EndTime=2011-03-07T16:30:00Z

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

    Exemplo: EndTime=2011-03-07T16:30:00.0005000Z

ObjectIdFilter=<object-url>

Opcional. Retorna operações de assinatura somente para o tipo de objeto e o ID de objeto especificados. Esse parâmetro deve ser definido igual ao valor de URL para a execução de um HTTP GET no objeto. Se nenhum objeto for especificado, um filtro não será aplicado. Os tipos de objeto aplicáveis e os exemplos são incluídos abaixo. Substitua os valores de exemplo como <subscription-id> pelos seus próprios valores.

 

Tipo de objeto

URL do objeto para filtragem

Assinatura

ObjectIdFilter=/<subscription-id>

Serviço de Nuvem

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

Serviço de armazenamento

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

Grupo de Afinidade

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

Implantação

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

Instância da Função

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

Imagem de máquina

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

OperationResultFilter=<Succeeded|Failed|InProgress>

Opcional. Retorna operações de assinatura apenas para o status de resultado especificado, Succeeded, Failed ou InProgress. Esse filtro pode ser combinado com o ObjectIdFilter para selecionar operações de assinatura para um objeto com um status de resultado específico. Se nenhum status de resultado for especificado, um filtro não será aplicado. Por exemplo, o trecho de URI de solicitação a seguir retorna todas as operações bem-sucedidas para um serviço de armazenamento:

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

ContinuationToken=<opaque-continuation-token>

Opcional. Quando há muitas operações para listar, como quando o período de tempo solicitado é muito grande, a resposta inclui uma lista incompleta e um token que pode ser usado para retornar o restante da lista. As solicitações subsequentes devem incluir esse parâmetro para continuar a listar as operações de onde a última resposta parou. Se nenhum token for especificado, um filtro não será aplicado e a resposta será iniciada no StartTime especificado.

A tabela a seguir descreve os cabeçalhos da solicitação.

 

Cabeçalho de solicitação Descrição

x-ms-version

Obrigatória. Especifica a versão da operação a ser usada para esta solicitação. Este cabeçalho deve ser definido como 25/02/2011 ou posterior. Para obter mais informações sobre cabeçalhos de controle de versão, consulte Controle de versão de gerenciamento de serviço.

A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Uma operação bem-sucedida retorna o código de status 200 (OK). Para obter informações sobre códigos de status, consulte Status de Gerenciamento de Serviço e códigos de erro.

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão obedecem à especificação de protocolo HTTP/1.1.

 

Cabeçalho de resposta Descrição

x-ms-request-id

Um valor que identifica exclusivamente uma solicitação feita no serviço de gerenciamento.

Formato do corpo da resposta:


<?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 xmlns:a="http://schemas.datacontract.org/2004/07/Microsoft.Samples.WindowsAzure.ServiceManagement">
        <OperationParameter>
          <a:Name>operation-parameter-name</a:Name>
          <a:Value><?xml version="1.0" encoding="utf-16"?>
            <z:anyType xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:d1p1="http://schemas.microsoft.com/windowsazure" i:type="d1p1:<type-body>" xmlns:z="http://schemas.microsoft.com/2003/10/Serialization/">
              …xml body…
            </z:anyType>
          </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>

A tabela a seguir descreve os elementos no corpo da resposta.

 

Nome do elemento Descrição

Operações de assinatura

Especifica a lista de operações que foram executadas na assinatura durante o período de tempo especificado.

Token de continuação

Especifica a cadeia de caracteres que pode ser usada para retornar o restante da lista. As solicitações subsequentes devem incluir esse parâmetro para continuar a listar as operações de onde a última resposta parou. Este elemento existirá somente se a lista completa de operações de assinatura não tiver sido retornada.

operação de assinatura

Especifica uma única operação que foi executada na assinatura durante o período de tempo especificado.

ID da Operação

Especifica o identificador global exclusivo (GUID) da operação.

ID de Objeto da Operação

Especifica o objeto de destino da operação. Esse valor é igual à URL para executar um HTTP GET no objeto e corresponde aos mesmos valores para o ObjectIdFilter na solicitação.

Nome da Operação

Especifica o nome da operação executada. Os possíveis valores são:

  • 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

Parâmetros da Operação

Especifica a coleção de parâmetros da operação executada.

Parâmetro da Operação

Especifica um único parâmetro da operação executada.

Nome

Especifica o nome do parâmetro.

Valor

Especifica o valor do parâmetro. O valor pode ser representado como uma cadeia de caracteres ou um documento XML, dependendo da operação de assinatura que foi executada.

OperationCaller

Especifica uma coleção de atributos que identifica a origem da operação.

UsedServiceManagementApi

Indica se a operação foi iniciada usando a API do Gerenciamento de Serviços. Falso se tiver sido iniciada por outra fonte, como o Portal de gerenciamento.

UserEmailAddress

Especifica o email associado ao Windows Live ID do usuário que iniciou a operação no Portal de gerenciamento. Esse elemento será retornado somente se UsedServiceManagementApi for false.

ClientIP

Especifica o endereço IP do computador cliente que iniciou a operação. Esse elemento será retornado somente se UsedServiceManagementApi for true.

SubscriptionCertificateThumbprint

Especifica a impressão digital do certificado de assinatura usado para iniciar a operação.

Status da operação

Especifica um objeto que contém informações sobre o status atual da operação. O objeto retornado tem o seguinte formato XML:

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

Os valores possíveis do elemento Status, que contém o status da operação, são:

  • Succeeded

  • Failed

  • InProgress

OperationStartedTime

Especifica a hora em que a operação começou a ser executada. O formato da hora é:

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

Exemplo: 2011-05-11T16:15:26Z

noteObservação
Especifica que o elemento OperationStartedTime só está disponível com a versão 2011-06-01 ou superior.

OperationCompletedTime

Especifica a hora em que a operação terminou de ser executada. Esse elemento não estará presente se a operação ainda estiver em andamento. O formato da hora é:

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

Exemplo: 2011-05-11T16:15:32Z

noteObservação
O elemento OperationCompletedTime só está disponível com a versão 2011-06-01 ou superior.

Mostrar:
© 2014 Microsoft