Liste des services cloud

Article
07/19/2023

L'opération List Cloud Services répertorie les services cloud disponibles sous l'abonnement spécifié.

Requête

La demande List Cloud Services peut être spécifiée comme suit. Remplacez <subscription-id> par votre ID d’abonnement.

Méthode	URI de demande
GET	`https://management.core.windows.net/<subscription-id>/services/hostedservices`

Paramètres URI

Aucun.

En-têtes de requête

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

En-tête de requête	Description
`x-ms-version`	Obligatoire. Spécifie la version de l'opération à utiliser pour cette demande. Cet en-tête doit être défini sur `2009-10-01` ou une valeur supérieure.
`x-ms-continuation-token`	Optionnel. Spécifie un jeton de liaison qui vous permet de récupérer le reste de la réponse lorsqu'il y a davantage de services cloud à répertorier par rapport au nombre pouvant être renvoyé dans le temps alloué. La valeur de ce jeton est renvoyée dans l'en-tête d'une réponse précédente et ne sera renvoyée que si d'autres services cloud doivent être répertoriés.

Corps de la requête

Aucun.

response

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

Code d’état

Une opération réussie envoie le code d'état 200 (OK).

En-têtes de réponse

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.

En-tête de réponse Description

x-ms-request-id Spécifie une valeur qui identifie de façon unique une demande adressée au service de gestion.

x-ms-continuation-token Spécifie un jeton de liaison qui vous permet de récupérer le reste de la réponse lorsqu'il y a davantage de services cloud à répertorier par rapport au nombre pouvant être renvoyé dans le temps alloué. Si un grand nombre de services cloud existent dans l'abonnement, ceux-ci ne pourront pas tous être répertoriés dans une seule réponse. Vous pouvez utiliser le jeton contenu dans cet en-tête pour les opérations de demande suivantes tant que tous les services cloud n'ont pas été renvoyés.

En-tête de réponse	Description
`x-ms-request-id`	Spécifie une valeur qui identifie de façon unique une demande adressée au service de gestion.
`x-ms-continuation-token`	Spécifie un jeton de liaison qui vous permet de récupérer le reste de la réponse lorsqu'il y a davantage de services cloud à répertorier par rapport au nombre pouvant être renvoyé dans le temps alloué. Si un grand nombre de services cloud existent dans l'abonnement, ceux-ci ne pourront pas tous être répertoriés dans une seule réponse. Vous pouvez utiliser le jeton contenu dans cet en-tête pour les opérations de demande suivantes tant que tous les services cloud n'ont pas été renvoyés.

Corps de la réponse

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

  
<?xml version="1.0" encoding="utf-8"?>  
  <HostedServices xmlns=”http://schemas.microsoft.com/windowsazure”>  
    <HostedService>  
      <Url>address-of-cloud-service</Url>  
      <ServiceName>name-of-cloud-service</ServiceName>  
      <HostedServiceProperties>  
        <Description>description-of-cloud-service</Description>  
        <AffinityGroup>name-of-affinity-group</AffinityGroup>  
        <Location>location-of-cloud-service</Location>  
        <Label>label-of-cloud-service</Label>  
        <Status>status-of-cloud-service</Status>  
        <DateCreated>date-created</DateCreated>  
        <DateLastModified>date-modified</DateLastModified>  
        <ExtendedProperties>  
          <ExtendedProperty>  
            <Name>name-of-property-name</Name>  
            <Value>value-of-property</Value>  
          </ExtendedProperty>  
        </ExtendedProperties>  
        <ReverseDnsFqdn>reverse-dns-fqdn</ReverseDnsFqdn>  
      </HostedServiceProperties>  
      <DefaultWinRMCertificateThumbprint>certificate-thumbprint-for-winrm</DefaultWinRMCertificateThumbprint>  
      <ComputeCapabilities>  
        <VirtualMachineRoleSizes>  
          <RoleSize>role-size-name</RoleSize>  
        </VirtualMachineRoleSizes>  
        <WebWorkerRoleSizes>  
          <RoleSize>role-size-name</RoleSize>  
        </WebWorkerRoleSizes>  
      </ComputeCapabilities>  
    </HostedService>  
  </HostedServices>

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

Nom de l'élément	Description
Url	Spécifie l'URI de demande utilisé pour obtenir des informations sur le service cloud.
NomService	Spécifie le nom du service cloud. Ce nom est le nom du préfixe DNS et peut être utilisé pour accéder au service. Par exemple, si le nom du service est MyService vous pouvez accéder à ce service en appelant : http://MyService.cloudapp.net
Description	Spécifie la description du service cloud. L’élément `Description` est disponible uniquement à l’aide de la version 2012-03-01 ou ultérieure.
AffinityGroup	Spécifie le groupe d'affinités auquel ce service cloud est associé, le cas échéant. Si le service est associé à un groupe d'affinités, l'élément `Location` n'est pas renvoyé. L’élément `AffinityGroup` est disponible uniquement à l’aide de la version 2012-03-01 ou ultérieure.
Emplacement	Spécifie la localisation géographique du service cloud dans Azure, si le service n'est pas associé à un groupe d'affinités. Si un emplacement est spécifié, l'élément `AffinityGroup` n'est pas renvoyé. L’élément `Location` est disponible uniquement à l’aide de la version 2012-03-01 ou ultérieure.
Étiquette	Spécifie l'identificateur encodé en base 64 du service cloud. Cet identificateur peut être utilisé pour identifier l'offre à des fins de suivi. L’élément `Label` est disponible uniquement à l’aide de la version 2012-03-01 ou ultérieure.
Statut	Spécifie l'état du service cloud. Les valeurs possibles sont les suivantes : - `Creating` - `Created` - `Deleting` - `Deleted` - `Changing` - `ResolvingDns` L’élément `Status` est disponible uniquement à l’aide de la version 2012-03-01 ou ultérieure.
DateCreated	Spécifie la date à laquelle le service cloud a été créé, selon le format [année en 4 chiffres]-[mois en 2 chiffres]-[jour en 2 chiffres]T[heures en 2 chiffres]:[minutes en 2 chiffres]:[secondes en 2 chiffres]Z. La date 2011-05-11T16:15:26Z est un exemple qui peut être renvoyé par les éléments `DateCreated` ou `DateLastModified`. L’élément `DateCreated` est disponible uniquement à l’aide de la version 2012-03-01 ou ultérieure.
DateLastModified	Spécifie la date à laquelle le service cloud a été mis à jour pour la dernière fois, selon le format [année en 4 chiffres]-[mois en 2 chiffres]-[jour en 2 chiffres]T[heures en 2 chiffres]:[minutes en 2 chiffres]:[secondes en 2 chiffres]Z. La date 2011-05-11T16:15:26Z est un exemple qui peut être renvoyé par les éléments `DateCreated` ou `DateLastModified`. L’élément `DateLastModified` est disponible uniquement à l’aide de la version 2012-03-01 ou ultérieure.
Nom	Spécifie le nom d'une propriété étendue du service cloud. Chaque propriété étendue doit avoir un nom et une valeur définis. Vous pouvez définir un maximum de 50 propriétés étendues. L’élément `Name` est disponible uniquement à l’aide de la version 2012-03-01 ou ultérieure.
Valeur	Représente la valeur d'une propriété étendue du service cloud. La valeur de la propriété étendue ne doit pas dépasser 255 caractères. L’élément `Value` est disponible uniquement à l’aide de la version 2012-03-01 ou ultérieure.
ReverseDnsFqdn	Optionnel. Spécifie l'adresse DNS avec laquelle l'adresse IP du service cloud est résolue lorsqu'il est interrogé à l'aide d'une requête DNS inversée. L’élément `ReverseDnsFqdn` est disponible uniquement à l’aide de la version 2014-06-01 ou ultérieure.
DefaultWinRMCertificateThumbprint	Spécifie le certificat par défaut pour une connexion sécurisée avec WinRM. Si une empreinte numérique de certificat n'est pas spécifiée pour WinRM lorsqu'une machine virtuelle est déployée dans un service cloud, un certificat est automatiquement créé et l'empreinte numérique est répertoriée comme la valeur de cet élément. Pour plus d’informations sur la définition de WinRM, consultez Créer un déploiement de machine virtuelle ou Ajouter un rôle.
ComputeCapabilities	Spécifie les tailles de rôle disponibles pour les déploiements dans le service cloud. Les tailles de rôle disponibles sont définies par les ressources qui sont prises en charge par le service cloud. Par exemple, les déploiements de rôles web et de travail peuvent avoir des tailles disponibles différentes de celles des déploiements de machines virtuelles. L’élément `ComputeCapabilities` est disponible uniquement à l’aide de la version 2014-05-01 ou ultérieure.

ComputeCapabilities

Spécifie les tailles de rôle disponibles pour les déploiements dans le service cloud.

Nom de l'élément	Description
VirtualMachineRoleSizes	Contient une collection d'éléments RoleSize.
WebWorkerRoleSizes	Contient une collection d'éléments RoleSize.
RoleSize	Spécifie la taille de rôle disponible pour le type de déploiement.

Notes

Si la version x-ms-version est plus ancienne que la version 2012-03-01, les services cloud qui contiennent des déploiements de machines virtuelles ne seront pas renvoyés.

Vous pouvez afficher les services cloud qui existent dans votre abonnement en consultant la section Services cloud sur le Portail de gestion. Vous pouvez également obtenir la liste des services cloud à l’aide de l’applet de commande Get-AzureService .

Partager via