Exportar (0) Imprimir
Expandir todo

Enumerar operaciones de suscripción

Actualizado: mayo de 2014

La operación List Subscription Operations devuelve una lista de operaciones de creación, actualización y eliminación que se realizaron en una suscripción durante la franja temporal especificada.

La solicitud List Subscription Operations se puede especificar como sigue. Reemplace <subscription-id> por el identificador de la suscripción.

 

Método URI de solicitud

GET

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

Debe asegurarse de que la solicitud que se realice al servicio de administración sea segura. Para obtener detalles adicionales, vea Autenticar solicitudes de administración del servicio.

 

Parámetro URI Descripción

StartTime=<start-of-timeframe>

Requerido. Inicio de la franja temporal para empezar a enumerar operaciones de suscripción en formato UTC. Este parámetro y el parámetro EndTime indican la franja temporal para recuperar operaciones de suscripción. Este parámetro no puede indicar una fecha de inicio superior a 90 días en el pasado.

Si especifica una hora para ese parámetro, debe incluir la cadena literal “T” antes de la hora que indica el inicio del elemento tiempo. Además, debe incluir la cadena literal “Z” después del elemento hora, que indica que la hora está en formato UTC. Por ejemplo, una hora de inicio de 1 de marzo de 2011 a las 16:30 se expresaría como sigue: StartTime=2011-03-01T16:30:00Z

Puede utilizar los formatos de hora siguientes:

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

    Ejemplo: StartTime=2011-03-01

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

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

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

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

EndTime=<end-of-timeframe>

Requerido. Final de la franja temporal para empezar a enumerar operaciones de suscripción en formato UTC. Este parámetro y el parámetro StartTime indican la franja temporal para recuperar operaciones de suscripción.

Si especifica una hora para ese parámetro, debe incluir la cadena literal “T” antes de la hora que indica el inicio del elemento tiempo. Además, debe incluir la cadena literal “Z” después del elemento hora, que indica que la hora está en formato UTC. Por ejemplo, una hora de finalización de 7 de marzo de 2011 a las 16:30 se expresaría como sigue: EndTime=2011-03-07T16:30:00Z

Puede utilizar los formatos de hora siguientes:

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

    Ejemplo: EndTime=2011-03-07

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

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

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

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

ObjectIdFilter=<object-url>

Opcional. Devuelve operaciones de suscripción únicamente para el tipo de objeto especificado e identificador de objeto. Este parámetro debe ser igual al valor de la URL para realizar un HTTP GET en el objeto. Si no se especifica ningún objeto, no se aplica ningún filtro. Los tipos de objetos aplicables y los ejemplos se incluyen a continuación. Reemplace los valores de ejemplo como <subscription-id> con sus propios valores.

 

Tipo de objeto

URL del objeto para el filtro

Suscripción

ObjectIdFilter=/<subscription-id>

Servicio en la nube

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

Servicio de almacenamiento

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

Grupo de afinidad

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

Implementación

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

Instancia de rol

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

Imagen de la máquina

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

OperationResultFilter=<Succeeded|Failed|InProgress>

Opcional. Devuelve las operaciones de suscripción solo para el estado de resultados especificado, Succeeded, Failed o InProgress. Este filtro se puede combinar con el ObjectIdFilter para seleccionar operaciones de suscripción para un objeto con un estado de resultados específico. Si no se especifica ningún estado de resultados, no se aplica ningún filtro. Por ejemplo, el fragmento siguiente de la URI de solicitud devuelve todas las operaciones correctas para un servicio de almacenamiento:

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

ContinuationToken=<opaque-continuation-token>

Opcional. Cuando hay demasiadas operaciones para enumerar, como cuando la franja temporal solicitada es muy grande, la respuesta incluye una lista incompleta y se pueden usa un token para devolver el resto de la lista. Las solicitudes posteriores deben incluir este parámetro para continuar enumerando operaciones desde donde se dejó la última respuesta. Si no se especifica ningún token, no se aplica ningún filtro y la respuesta empezará en la StartTimeespecificada.

La tabla siguiente describe los encabezados de solicitud.

 

Encabezado de solicitud Descripción

x-ms-version

Requerido. Especifica la versión de la operación que se utiliza para esta solicitud. Este encabezado debería establecerse en 25/02/2011 o posterior. Para obtener más información acerca de los encabezados de control de versiones, vea Control de versiones de la administración del servicio.

La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.

Una operación correcta devuelve el código de estado 200 (Correcto). Para obtener información acerca de los códigos de estado, vea Estado y códigos de error de administración del servicio.

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar cumplen la especificación del protocolo HTTP/1.1.

 

Encabezado de respuesta Descripción

x-ms-request-id

Valor que identifica de forma exclusiva una solicitud realizada ante el servicio de administración.

El formato del cuerpo de respuesta es el siguiente:


<?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>

En la tabla siguiente se describen los elementos del cuerpo de respuesta.

 

Nombre del elemento Descripción

Operaciones de suscripción

Especifica la lista de operaciones que se han realizado en la suscripción durante la franja temporal especificada.

Token de continuación

Especifica la cadena que se puede utilizar para devolver el resto de la lista. Las solicitudes posteriores deben incluir este parámetro para continuar enumerando operaciones desde donde se dejó la última respuesta. Este elemento solo existe si no se devolvió la lista completa de suscripción.

Operación de suscripción

Especifica una única operación que se ha realizado en la suscripción durante la franja temporal especificada.

Id. de operación

Especifica el identificador único global (GUID) de la operación.

Identificador del objeto de la operación

Especifica el objeto de destino de la operación. Este valor es igual a la URL para realizar un HTTP GET en el objeto, y corresponde a los mismos valores para el ObjectIdFilter en la solicitud.

Nombre de la operación

Especifica el nombre de la operación realizada. Los valores posibles son:

  • 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 de la operación

Especifica la colección de parámetros de la operación realizada.

Parámetro de la operación

Especifica un único parámetro de la operación realizada.

Nombre

Especifica el nombre del parámetro.

Valor

Especifica el valor del parámetro. El valor se puede representar como una cadena o un documento XML, dependiendo de la operación de suscripción que se realizó.

OperationCaller

Especifica una colección de atributos que identifica el origen de la operación.

UsedServiceManagementApi

Indica si la operación se inició utilizando la API de administración de servicios. False si se inició desde otro origen, como el Portal de administración.

UserEmailAddress

Especifica el correo electrónico asociado al identificador de Windows Live del usuario que inició la operación desde el Portal de administración. Se devuelve este elemento solo si UsedServiceManagementApi es false.

ClientIP

Especifica la dirección IP del equipo del cliente que inició la operación. Se devuelve este elemento solo si UsedServiceManagementApi es true.

SubscriptionCertificateThumbprint

Especifica la huella digital del certificado de la suscripción utilizada para iniciar la operación.

Estado de la operación

Especifica un objeto que contiene la información sobre el estado actual de la operación. El objeto devuelto tiene el formato XML siguiente:

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

Los posibles valores del elemento Status, que contiene el estado de la operación, son:

  • Succeeded

  • Failed

  • InProgress

OperationStartedTime

Especifica la hora a la que la operación empezó a ejecutarse. El formato de la hora es:

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

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

noteNota
Especifica que el elemento OperationStartedTime solamente se encuentra disponible si se utiliza la versión 2011-06-01 o versiones posteriores.

OperationCompletedTime

Especifica la hora a la que la operación terminó de ejecutarse. Este elemento no está presente si la operación aún está en curso. El formato de la hora es:

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

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

noteNota
El elemento OperationCompletedTime solamente se encuentra disponible si se utiliza la versión 2011-06-01 o versiones posteriores.

Mostrar:
© 2014 Microsoft