Agregar un nuevo sitio

Artículo
08/24/2015

Se aplica a: Windows Azure Pack

Agrega un nuevo sitio.

Solicitud

Reemplace {ServiceMgmt} por la dirección del punto de conexión de la API de Service Management. Reemplace {Port} por 30005 para la API de inquilino o 30006 para la API de inquilino público. Reemplace {SUBSCRIPTIONID} por el identificador de suscripción necesario y reemplace {WEBSPACENAME} por los valores correspondientes del sitio web.

Método	URI de solicitud	Versión de HTTP
POST	<https:// ServiceMgmt>:<Port>/{SUBSCRIPTIONID}/services/webspaces/{WEBSPACENAME}/sites	HTTP/1.1

Parámetros de identificador URI

Ninguno.

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

Encabezado de solicitud	Descripción
x-ms-version	Obligatorio. Especifica la versión de la operación que se utiliza para esta solicitud. Este encabezado debe establecerse en 2012-10-10 o en la versión actual.
Content-Length	Obligatorio.
Content-Type: application/json; charset=utf-8	Requerido si el cuerpo de la solicitud se envía en formato JSON.
accept: application/json	Opcional. Utilice este encabezado para recibir la respuesta en formato JSON.

Cuerpo de la solicitud

En el ejemplo de código se muestra el formato del cuerpo de la solicitud.

<Site xmlns="https://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
 <HostNames xmlns:a="https://schemas.microsoft.com/2003/10/Serialization/Arrays">
 <a:string>contosoapitest.azurewebsites.net</a:string>
 </HostNames>
 <Name>contosoapitest</Name>
 <WebSpaceToCreate>
 <GeoRegion>West US</GeoRegion>
 <Name>westuswebspace</Name>
 <Plan>VirtualDedicatedPlan</Plan>
 </WebSpaceToCreate>
</Site>

En la tabla siguiente se describen los elementos clave del cuerpo de la solicitud:

Nombre del elemento	Descripción
HostNames	Obligatorio. Nombre de dominio completo de un sitio web. Solo se puede especificar un nombre de host en el dominio azurewebsites.net. El nombre de host debe coincidir con el nombre del sitio web. Los dominios personalizados solo se pueden especificar para sitios web compartidos o estándar.
Nombre	Necesario. El nombre del sitio web. Este nombre debe coincidir con el nombre de host en el dominio predeterminado.
ComputeMode	Este valor debe ser Compartido para las ofertas compartidas gratis o de pago, o Dedicado para la oferta estándar. El valor predeterminado es Shared. Si establece el valor ComputeMode en Dedicado, debe especificar un valor para la propiedad ServerFarm.
ServerFarm	Nombre de la granja de servidores asociada a este sitio web. Este valor es necesario para el modo Estándar.
SiteMode	Este valor es Limitado para la oferta gratuita Básica para la oferta compartida de pago. El valor predeterminado es Limited. Nota: El modo Estándar no utiliza el valor de SiteMode, sino el de ComputeMode.
WebspaceToCreate.GeoRegion	Obligatorio. Región geográfica del espacio web que se va a crear. Consulte Referencia rápida: API DE REST del servicio Sitios web para conocer los valores posibles.
WebspaceToCreate.Name	Obligatorio. Nombre del espacio web.
WebspaceToCreate.Plan	Obligatorio. Este valor debe ser VirtualDedicatedPlan.

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.

Para obtener información sobre los códigos de estado, vea Códigos de error (API REST del servicio Sitios web).

Encabezados de respuesta

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 se ajustan a la especificación del protocolo HTTP/1.1.

Encabezado de respuesta	Descripción
x-ms-request-id	Valor que identifica de forma única la solicitud realizada ante el servicio de administración.

Cuerpo de la respuesta

En el ejemplo de código se muestra el formato del cuerpo de la respuesta.

{
  "AdminEnabled": true,
  "AvailabilityState": 0,
  "Cers": [
    {
      "CerBlob": [
        81,
        109,
        70,
        122,
        90,
        83,
        65,
        50,
        78,
        67,
        66,
        84,
        100,
        72,
        74,
        108,
        89,
        87,
        48,
        61
      ],
      "ExpirationDate": "\/Date(928174800000-0700)\/",
      "FriendlyName": "String content",
      "HostNames": [
        "String content"
      ],
      "IssueDate": "\/Date(928174800000-0700)\/",
      "Issuer": "String content",
      "Password": "String content",
      "PfxBlob": [
        81,
        109,
        70,
        122,
        90,
        83,
        65,
        50,
        78,
        67,
        66,
        84,
        100,
        72,
        74,
        108,
        89,
        87,
        48,
        61
      ],
      "PublicKeyHash": "String content",
      "SelfLink": "http:\/\/www.example.com\/",
      "SiteName": "String content",
      "SubjectName": "String content",
      "Thumbprint": "String content",
      "ToDelete": true,
      "Valid": true
    }
  ],
  "ComputeMode": 0,
  "ContentAvailabilityState": 0,
  "Csrs": [
    {
      "CsrString": "String content",
      "DistinguishedName": "String content",
      "HostNames": [
        "String content"
      ],
      "Password": "String content",
      "PfxBlob": [
        81,
        109,
        70,
        122,
        90,
        83,
        65,
        50,
        78,
        67,
        66,
        84,
        100,
        72,
        74,
        108,
        89,
        87,
        48,
        61
      ],
      "PublicKeyHash": "String content",
      "SelfLink": "http:\/\/www.example.com\/",
      "SiteName": "String content",
      "ToDelete": true,
      "Valid": true
    }
  ],
  "Enabled": true,
  "EnabledHostNames": [
    "String content"
  ],
  "HostNameSslStates": [
    {
      "IpBasedSslResult": "String content",
      "Name": "String content",
      "SslState": 0,
      "Thumbprint": "String content",
      "ToUpdate": true,
      "ToUpdateIpBasedSsl": true,
      "VirtualIP": "String content"
    }
  ],
  "HostNames": [
    "String content"
  ],
  "LastModifiedTimeUtc": "\/Date(928174800000-0700)\/",
  "Name": "String content",
  "Owner": "String content",
  "RepositorySiteName": "String content",
  "RuntimeAvailabilityState": 0,
  "SSLCertificates": [
    {
      "CerBlob": [
        81,
        109,
        70,
        122,
        90,
        83,
        65,
        50,
        78,
        67,
        66,
        84,
        100,
        72,
        74,
        108,
        89,
        87,
        48,
        61
      ],
      "ExpirationDate": "\/Date(928174800000-0700)\/",
      "FriendlyName": "String content",
      "HostNames": [
        "String content"
      ],
      "IssueDate": "\/Date(928174800000-0700)\/",
      "Issuer": "String content",
      "Password": "String content",
      "PfxBlob": [
        81,
        109,
        70,
        122,
        90,
        83,
        65,
        50,
        78,
        67,
        66,
        84,
        100,
        72,
        74,
        108,
        89,
        87,
        48,
        61
      ],
      "PublicKeyHash": "String content",
      "SelfLink": "http:\/\/www.example.com\/",
      "SiteName": "String content",
      "SubjectName": "String content",
      "Thumbprint": "String content",
      "ToDelete": true,
      "Valid": true
    }
  ],
  "SelfLink": "http:\/\/www.example.com\/",
  "ServerFarm": "String content",
  "SiteMode": "String content",
  "SiteProperties": {
    "AppSettings": [
      {
        "Name": "String content",
        "Value": "String content"
      }
    ],
    "Metadata": [
      {
        "Name": "String content",
        "Value": "String content"
      }
    ],
    "Properties": [
      {
        "Name": "String content",
        "Value": "String content"
      }
    ]
  },
  "State": "String content",
  "StorageRecoveryDefaultState": "String content",
  "UsageState": 0,
  "WebSpace": "String content"
}

La tabla siguiente describe los elementos clave del cuerpo de la respuesta.

Nombre del elemento	Descripción
Site.AdminEnabled	Solo lectura. Este valor siempre es true.
Site.AvailabilityState	Estado de la disponibilidad de información de administración del sitio. Los valores posibles son Normal o Limited. Normal significa que el sitio se está ejecutando correctamente y que la información de administración del sitio está disponible. Limitado significa que solo la información de administración parcial del sitio está disponible y que la información detallada del sitio no está disponible.
Site.ComputeMode	Modo de proceso para el sitio web. Los valores posibles son Shared o Dedicated.
Site.ContentAvailabilityState	Propiedad no usada.
Site.Enabled	Establézcalo en true si el sitio está habilitado; de lo contrario, es false. Si se establece este valor en false, se deshabilita el sitio. Desconecta el sitio.
Site.EnabledHostNames	Matriz de cadenas que contiene nombres de host habilitados para el sitio. De forma predeterminada, son <SiteName.azurewebsites.net> y<SiteName.scm.azurewebsites.net>.
Site.HostNameSslStates	Elemento container para estados de Capa de sockets seguros (SSL).
Site.HostNameSslStates.HostNameSslState	Contiene la información de estado de un certificado SSL enlazado al sitio web.
Site.HostNameSslStates.HostNameSslState.IpBasedSslResult	Propiedad no usada.
Site.HostNameSslStates.HostNameSslState.Name	Dirección URL del sitio web.
Site.HostNameSslStates.HostNameSslState.SslState	Estado de SSL. Los valores posibles son Disabled, SniEnabled o IpBasedEnabled.
Site.HostNameSslStates.HostNameSslState.Thumbprint	Cadena que contiene la huella digital del certificado SSL.
Site.HostNameSslStates.HostNameSslState.ToUpdate	booleano. Propiedad no usada.
Site.HostNameSslStates.HostNameSslState.ToUpdateIpBasedSsl	booleano. Propiedad no usada.
Site.HostNameSslStates.HostNameSslState.VirtualIP	Cadena que contiene la dirección IP asignada al nombre de host si el nombre de host usa SSL de IP.
Site.HostNames	Matriz de cadenas que contiene los nombres de host públicos del sitio, que incluyen dominios personalizados. Importante Al agregar un dominio personalizado en una operación PUT, asegúrese de incluir todos los nombres de host que necesite para el sitio web. Para eliminar un nombre de dominio personalizado en una operación PUT, incluya todos los nombres de host del sitio que tiene que conservar, pero omita el que tiene que eliminar. Para más información sobre los dominios personalizados en Windows Azure, consulte Configuración de un nombre de dominio personalizado para un sitio web de Azure Windows.
Site.LastModifiedTimeUtc	Valor dateTime que contiene, en hora universal coordinada (UTC), la última vez que se modificó el sitio web.
Site.Name	El nombre del sitio web.
Site.Owner	Propiedad de solo lectura.
Site.RepositorySiteName	Nombre del sitio web del repositorio.
Site.RuntimeAvailabilityState	Los valores posibles son Normal, Degradado o No disponible. Normal: el sitio web se está ejecutando correctamente. Degradado: el sitio web se ejecuta temporalmente en un modo degradado, normalmente con menos memoria y una instancia compartida. No disponible: debido a un problema inesperado, el sitio se ha excluido del aprovisionamiento. Este valor suele ocurrir solo para sitios gratuitos.
Site.SSLCertificates	Matriz de certificados SSL.
Site.SSLCertificates.Certificate	Contiene propiedades de certificado SSL.
Site.SSLCertificates.Certificate.ExpirationDate	Valor dateTime que contiene la fecha de expiración del certificado.
Site.SSLCertificates.Certificate.FriendlyName	Cadena que contiene el nombre descriptivo del certificado.
Site.SSLCertificates.Certificate.HostNames	Matriz de cadenas que contienen los nombres de host a los que está enlazado el certificado.
Site.SSLCertificates.Certificate.IssueDate	Valor dateTime que contiene la fecha en que se emitió el certificado.
Site.SSLCertificates.Certificate.Issuer	Cadena que identifica el emisor del certificado.
Site.SSLCertificates.Certificate.Password	Cadena que contiene la contraseña del certificado.
Site.SSLCertificates.Certificate.PfxBlob	Valor base64Binary que contiene el PfxBlob del certificado.
Site.SSLCertificates.Certificate.SelfLink	Valor de URI que contiene el punto de conexión del sitio al que está enlazado el certificado.
Site.SSLCertificates.Certificate.SiteName	Cadena que contiene el nombre del sitio al que está enlazado el certificado.
Site.SSLCertificates.Certificate.SubjectName	Cadena que contiene el nombre de la entidad a la que se emitió el certificado.
Site.SSLCertificates.Certificate.Thumbprint	Cadena que contiene la huella digital del certificado.
Site.SSLCertificates.Certificate.ToDelete	booleano. Si se va a eliminar el certificado, es true; de lo contrario, es false.
Site.SSLCertificates.Certificate.Valid	booleano. Si el certificado es válido, es true; de lo contrario, es false.
Site.SelfLink	Dirección URL directa al punto de conexión del sitio web en Windows Sitios web de Azure, que incluye el identificador de suscripción, el nombre del espacio web y el nombre del sitio.
Site.ServerFarm	Cadena para la que, si existe una granja de servidores, el valor es DefaultServerFarm.
Site.SiteMode	Cadena que representa el modo de sitio web. Si el modo de sitio web es Gratis, este valor es Limitado. Si el modo de sitio web es Compartido, este valor es Básico. Nota El valor de la propiedad SiteMode no se usa para el modo Reservado. El modo reservado usa la configuración ComputeMode.
Site.SiteProperties	Contiene AppSettings, Metadata y Properties como conjuntos de pares nombre-valor para un sitio.
Site.SiteProperties.AppSettings	Conjunto de pares nombre-valor que contienen la configuración de aplicaciones de un sitio.
Site.SiteProperties.Metadata	Conjunto de pares nombre-valor que contienen información de metadatos de un sitio.
Site.SiteProperties.Properties	Conjunto de pares nombre-valor que contienen propiedades de un sitio.
Site.State	Cadena que describe el estado del sitio web. Los valores posibles son Detenido o En ejecución.
Site.StorageRecoveryDefaultState	Propiedad no usada.
Site.UsageState	Los valores posibles son Normal o Superado. Si se supera alguna cuota, el valor UsageState cambia a Exceeded y el sitio se queda sin conexión.
Site.WebSpace	Nombre del espacio web en el que se encuentra el sitio web. Esta propiedad es de sólo lectura. Para conocer los valores posibles, consulte Referencia rápida: API rest de administración de sitios web.

Consulte también

API REST del servicio Azure Pack Websites Windows

Compartir a través de