Exporter (0) Imprimer
Développer tout

Liste des opérations d'abonnement

Mis à jour: mai 2014

L'opération List Subscription Operations retourne une liste d'opérations de création, mise à jour et suppression exécutées sur un abonnement pendant la période spécifiée.

La requête List Subscription Operations peut être spécifiée comme suit. Remplacez <subscription-id> par l'ID d'abonnement.

 

Méthode URI de demande

GET

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

Vous devez vous assurer que la demande adressée au service de gestion est sécurisée. Pour plus de détails, consultez Authentification des demandes de gestion des services.

 

Paramètre d'URI Description

StartTime=<start-of-timeframe>

Obligatoire. Début du délai d'exécution pour commencer à répertorier les opérations d'abonnement au format UTC. Ce paramètre et le paramètre EndTime indiquent le délai d'exécution pour récupérer les opérations d'abonnement. Ce paramètre ne peut pas indiquer une date de début de plus de 90 jours dans le passé.

Si vous spécifiez un délai pour ce paramètre, vous devez inclure la chaîne littérale « T » avant l'heure, pour indiquer le début de l'élément d'heure. De plus, vous devez inclure la chaîne littérale « Z » après l'élément d'heure, pour indiquer que l'heure est au format UTC. Par exemple, l'heure de début 1er mars 2011 à 16 h 30 est exprimée comme suit : StartTime=2011-03-01T16:30:00Z

Vous pouvez utiliser les formats de délai suivants :

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

    Exemple : StartTime=2011-03-01

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

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

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

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

EndTime=<end-of-timeframe>

Obligatoire. Fin du délai d'exécution pour commencer à répertorier les opérations d'abonnement au format UTC. Ce paramètre et le paramètre StartTime indiquent le délai d'exécution pour récupérer les opérations d'abonnement.

Si vous spécifiez un délai pour ce paramètre, vous devez inclure la chaîne littérale « T » avant l'heure, pour indiquer le début de l'élément d'heure. De plus, vous devez inclure la chaîne littérale « Z » après l'élément d'heure, pour indiquer que l'heure est au format UTC. Par exemple, l'heure de fin du 7 mars 2011 à 16 h 30 est exprimée comme suit : EndTime=2011-03-07T16:30:00Z

Vous pouvez utiliser les formats de délai suivants :

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

    Exemple : EndTime=2011-03-07

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

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

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

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

ObjectIdFilter=<object-url>

Facultatif. Renvoie des opérations d'abonnement uniquement pour le type d'objet et l'ID d'objet spécifiés. Ce paramètre doit être égal à la valeur de l'URL pour effectuer une opération HTTP GET sur l'objet. Si aucun objet n'est spécifié, aucun filtre n'est appliqué. Les types d'objets applicables et les exemples sont présentés ci-dessous. Remplacez les valeurs d'exemple telles que <subscription-id> par vos propres valeurs.

 

Type d'objet

URL de l'objet pour Filter

Abonnement

ObjectIdFilter=/<subscription-id>

Service de cloud computing

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

Service de stockage

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

Groupe d'affinités

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

Déploiement

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

Instance de rôle

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

Image d'ordinateur

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

OperationResultFilter=<Succeeded|Failed|InProgress>

Facultatif. Retourne les opérations d'abonnement uniquement pour l'état de résultat spécifié Succeeded, Failed, ou InProgress. Ce filtre peut être associé à ObjectIdFilter pour sélectionner les opérations d'abonnement d'un objet avec un état de résultat spécifique. Si aucun état de résultat n'est spécifié, aucun filtre n'est appliqué. Par exemple, l'extrait de code d'URI de demande suivant retourne toutes les opérations réussies d'un service de stockage :

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

ContinuationToken=<opaque-continuation-token>

Facultatif. Lorsqu'il y a trop d'opérations à afficher, par exemple lorsque le délai d'exécution demandé est très long, la réponse inclut une liste inachevée et un jeton qui peuvent être utilisés pour retourner le reste de la liste. Les demandes suivantes doivent inclure ce paramètre pour continuer à répertorier les opérations et reprendre là où la dernière réponse a été fournie. Si aucun jeton n'est spécifié, aucun filtre n'est appliqué et la réponse commence au StartTime spécifié.

Le tableau suivant décrit les en-têtes de la demande.

 

En-tête de demande Description

x-ms-version

Obligatoire. Spécifie la version de l'opération à utiliser pour cette demande. Cet en-tête devrait être défini sur 25/02/2011 ou une version ultérieure. Pour plus d'informations sur les en-têtes du suivi de version, consultez Contrôle de version du service de gestion.

La réponse inclut un code d'état HTTP, un ensemble d'en-têtes de réponse et un corps de réponse.

Une opération ayant réussi retourne le code d'état 200 (OK). Pour plus d'informations sur les codes d'état, consultez Codes d'état et d'erreur de la gestion des services.

La réponse de l'opération inclut les en-têtes suivants. La réponse peut aussi inclure des en-têtes HTTP standard supplémentaires. Tous les en-têtes standard sont conformes à la spécification du protocole HTTP/1.1.

 

En-tête de réponse Description

x-ms-request-id

Valeur qui identifie de façon unique une demande effectuée au service de gestion.

Le corps de la réponse présente le format suivant :


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

Le tableau suivant décrit les éléments dans le corps de la réponse.

 

Nom de l'élément Description

Opérations d'abonnement

Spécifie la liste des opérations qui ont été exécutées sur l'abonnement pendant le délai d'exécution spécifié.

Jeton consécutif

Spécifie la chaîne qui peut être utilisée pour renvoyer le reste de la liste. Les demandes suivantes doivent inclure ce paramètre pour continuer à répertorier les opérations et reprendre là où la dernière réponse a été fournie. Cet élément existe uniquement si la liste complète des opérations d'abonnement n'a pas été retournée.

Opération d'abonnement

Spécifie une opération unique qui a été exécutée sur l'abonnement pendant le délai d'exécution spécifié.

ID de l'opération

Spécifie l'identificateur global unique (GUID) de l'opération.

ID d'objet d'opération

Spécifie l'objet cible de l'opération. Cette valeur est égale à l'URL qui effectue une opération HTTP GET sur l'objet, et correspond aux mêmes valeurs de ObjectIdFilter dans la demande.

Nom de l'opération

Spécifie le nom de l'opération effectuée. Les valeurs possibles sont les suivantes :

  • 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

Paramètres de l'opération

Spécifie la collection de paramètres pour l'opération effectuée.

Paramètre de l'opération

Spécifie un paramètre unique pour l'opération effectuée.

Nom

Spécifie le nom du paramètre.

Valeur

Spécifie la valeur du paramètre. La valeur peut être représentée comme une chaîne ou un document XML, selon l'opération d'abonnement qui est exécutée.

OperationCaller

Spécifie une collection d'attributs qui identifie la source de l'opération.

UsedServiceManagementApi

Indique si l'opération a été appelée à l'aide de l'API de gestion des services. False si elle a été appelée par une autre source, par exemple Portail de gestion.

UserEmailAddress

Spécifie l'adresse de messagerie associée à l'identifiant Windows Live ID de l'utilisateur qui a appelé l'opération à partir du Portail de gestion. Cet élément est retourné uniquement si UsedServiceManagementApi est false.

ClientIP

Spécifie l'adresse IP de l'ordinateur client qui a appelé l'opération. Cet élément est retourné uniquement si UsedServiceManagementApi est true.

SubscriptionCertificateThumbprint

Spécifie l'empreinte numérique du certificat d'abonnement utilisé pour appeler l'opération.

État de l'opération

Spécifie un objet qui contient des informations sur l'état actuel de l'opération. L'objet retourné est au format XML suivant :

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

Les valeurs possibles de l'élément Status, qui contient l'état de l'opération, sont :

  • Succeeded

  • Failed

  • InProgress

OperationStartedTime

Spécifie l'heure de début d'exécution de l'opération. Le format est le suivant :

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

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

noteRemarque
Indique que l'élément OperationStartedTime est uniquement disponible si vous utilisez la version 2011-06-01 ou une version ultérieure.

OperationCompletedTime

Spécifie l'heure de fin d'exécution de l'opération. Cet élément n'est pas présent si l'opération est encore en cours. Le format est le suivant :

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

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

noteRemarque
L'élément OperationCompletedTime est uniquement disponible si vous utilisez la version 2011-06-01 ou une version ultérieure.

Afficher:
© 2014 Microsoft