Enumerar Cloud Services

La operación List Cloud Services enumera los servicios en la nube disponibles en la suscripción especificada.

Request

La solicitud List Cloud Services se puede especificar como sigue. Reemplace <subscription-id> con el Id. de suscripción.

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

Parámetros de identificador URI

Ninguno.

Encabezados de solicitud

La tabla siguiente describe los encabezados de solicitud.

Encabezado de solicitud	Descripción
x-ms-version	Necesario. Especifica la versión de la operación que se utiliza para esta solicitud. Este encabezado debe establecerse 2009-10-01 en o superior.
x-ms-continuation-token	Opcional. Especifica un token de continuación que le permite obtener un recordatorio de la respuesta cuando aparezcan más servicios en la nube que puedan devolverse en el tiempo asignado. El valor de este token se devuelve en el encabezado de la respuesta anterior y solo se devolverá si es necesario enumerar servicios en la nube adicionales.

Cuerpo de la solicitud

Ninguno.

Response

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

Código de estado

Una operación correcta devuelve el código de estado 200 Correcto.

Encabezados de respuesta

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar.

Encabezado de respuesta	Descripción
x-ms-request-id	Especifica un valor que identifica de forma exclusiva una solicitud realizada ante el servicio de administración.
x-ms-continuation-token	Especifica un token de continuación que le permite obtener un recordatorio de la respuesta cuando aparezcan más servicios en la nube que puedan devolverse en el tiempo asignado. Si en la suscripción existe una gran cantidad de servicios en la nube, no se podrán mostrar todos ellos en una única respuesta. Puede usar el token en este encabezado en las solicitudes de operación posteriores hasta que se devuelvan todos los servicios en la nube.

Cuerpo de la respuesta

El formato del cuerpo de respuesta es el siguiente:

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

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

Nombre del elemento	Descripción
Url	Especifica el URI de solicitud que se usa para obtener información acerca del servicio en la nube.
ServiceName	Especifica el nombre del servicio en la nube. Este nombre es el nombre del prefijo DNS y se puede utilizar para tener acceso al servicio. Por ejemplo, si el nombre de servicio es MyService puede tener acceso al servicio llamando a: http://MyService.cloudapp.net
Descripción	Especifica la descripción del servicio en la nube. El Description elemento solo está disponible con la versión 2012-03-01 o posterior.
AffinityGroup	Especifica el grupo de afinidad al que está asociado este servicio en la nube, en su caso. Si el servicio está asociado a un grupo de afinidad, el elemento Location no se devuelve. El AffinityGroup elemento solo está disponible con la versión 2012-03-01 o posterior.
Location	Especifica la ubicación geográfica del servicio en la nube en Azure, si el servicio no está asociado a un grupo de afinidad. Si se especificó una ubicación, el elemento AffinityGroup no se devuelve. El Location elemento solo está disponible con la versión 2012-03-01 o posterior.
Etiqueta	Especifica el identificador codificado en base 64 del servicio en la nube. Este identificador se puede usar con fines de seguimiento. El Label elemento solo está disponible con la versión 2012-03-01 o posterior.
Estado	Especifica el estado del servicio en la nube. Los valores posibles son: - Creating - Created - Deleting - Deleted - Changing - ResolvingDns El Status elemento solo está disponible con la versión 2012-03-01 o posterior.
DateCreated	Especifica la fecha en que se creó el servicio en la nube, en formato [4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:[2DigitSecond]Z. La fecha 2011-05-11T16: 15:26Z es un ejemplo que podrían devolver los elementos DateCreated o DateLastModified. El DateCreated elemento solo está disponible con la versión 2012-03-01 o posterior.
DateLastModified	Especifica la fecha en que se actualizó por última vez el servicio en la nube, en el formato [4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:[2DigitSecond]Z. La fecha 2011-05-11T16: 15:26Z es un ejemplo que podrían devolver los elementos DateCreated o DateLastModified El DateLastModified elemento solo está disponible con la versión 2012-03-01 o posterior.
Nombre	Especifica el nombre de una propiedad de servicio en la nube extendida. Cada propiedad extendida debe tener tanto un nombre como un valor definidos. Puede definir 50 propiedades extendidas, como máximo. El Name elemento solo está disponible con la versión 2012-03-01 o posterior.
Value	Representa el valor de una propiedad de servicio en la nube extendida. El valor de la propiedad extendida puede tener una longitud máxima de 255 caracteres. El Value elemento solo está disponible con la versión 2012-03-01 o posterior.
ReverseDnsFqdn	Opcional. Especifica la dirección DNS en la que se resuelve la dirección IP del servicio en la nube cuando se envía una consulta mediante una consulta de DNS inversa. El ReverseDnsFqdn elemento solo está disponible con la versión 2014-06-01 o posterior.
DefaultWinRMCertificateThumbprint	Especifica el certificado predeterminado de una conexión segura con WinRM. Si no se especifica una huella de certificado para WinRM cuando se implementa una máquina virtual en un servicio en la nube, automáticamente se crea un certificado y la huella aparece como el valor de este elemento. Para obtener más información sobre cómo definir WinRM, vea Crear implementación de máquina virtual o Agregar rol.
ComputeCapabilities	Especifica los tamaños de roles disponibles para las implementaciones en el servicio en la nube. Los tamaños de roles disponibles están definidos por los recursos que admite el servicio en la nube. Por ejemplo, las implementaciones de roles web y roles de trabajo pueden tener disponibles diferentes tamaños que las implementaciones de Máquinas virtuales. El ComputeCapabilities elemento solo está disponible con la versión 2014-05-01 o posterior.

ComputeCapabilities

Especifica los tamaños de roles disponibles para las implementaciones en el servicio en la nube.

Nombre del elemento	Descripción
VirtualMachineRoleSizes	Contiene una colección de elementos RoleSize.
WebWorkerRoleSizes	Contiene una colección de elementos RoleSize.
RoleSize	Especifica el tamaño de rol disponible para el tipo de implementación.

Comentarios

Si el x-ms-version es anterior a 2012-03-01, no se devolverán los servicios en la nube que contengan implementaciones de la máquina virtual.

Puede ver Cloud Services que existen en su suscripción mirando la sección Cloud Services del Portal de administración. También puede obtener una lista de servicios en la nube mediante el cmdlet Get-AzureService .