Adicionar um novo site

Artigo
08/24/2015

Aplica-se a: Windows Azure Pack

Adiciona um novo site.

Pedir

Substitua {ServiceMgmt} pelo seu endereço de ponto final API de Gestão de Serviços. Substitua {Port} por 30005 para o inquilino API ou 30006 para a API de Inquilino Público. Substitua {SUBSCRIPTIONID} pelo identificador de subscrição necessário e substitua {WEBSPACENAME} pelos valores correspondentes para o seu website.

Método	URI do pedido	Versão HTTP
POST	<https:// ServiceMgmt>:<Porta>/{SUBSCRIÇID}/serviços/webspaces/{WEBSPACENAME}/sites	HTTP/1.1

Parâmetros do URI

Nenhum.

Pedido cabeçalhos

A tabela seguinte descreve os cabeçalhos de pedido necessários e opcionais.

Cabeçalho do pedido	Description
x-ms-versão	Obrigatório. Especifica a versão da operação a utilizar para este pedido. Este cabeçalho deve ser definido para 2012-10-10 ou para a versão atual.
Comprimento do conteúdo	Obrigatório.
Tipo de conteúdo: aplicação/json; charset=utf-8	Requerido se o corpo de pedido for enviado em formato JSON.
aceitar: aplicação/json	Opcional. Utilize este cabeçalho para receber a resposta no formato JSON.

Corpo do Pedido

O exemplo de código mostra o formato do corpo de pedido.

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

A tabela seguinte descreve os elementos-chave do corpo de pedido.

Nome do elemento	Descrição
HostNames	Obrigatório. O nome de domínio totalmente qualificado para um site. Apenas um nome de hospedeiro pode ser especificado no domínio azurewebsites.net. O nome do anfitrião deve corresponder ao nome do site. Os domínios personalizados só podem ser especificados para websites Partilhados ou Standard.
Name	Obrigatório. O nome do Web site. Este nome deve corresponder ao nome do anfitrião no domínio predefinido.
ComputeMode	Este valor deve ser partilhado para as ofertas partilhadas gratuitas ou pagas, ou dedicado à oferta Standard. O valor predefinido é Partilhado. Se definir o valor ComputeMode para Dedicado, tem de especificar um valor para a propriedade ServerFarm.
ServerFarm	O nome da fazenda de servidores associado a este site. Este é um valor necessário para o modo Standard.
Mapa do Site	Este valor é Limitado para a oferta gratuita Basic para a oferta partilhada paga. O valor predefinido é Limitado. Nota O modo standard não utiliza a definição SiteMode; utiliza a definição ComputeMode.
WebspaceToCreate.GeoRegion	Obrigatório. A região geográfica do espaço web a ser criada. Consulte Referência Rápida - Serviço de Web Sites Rest API para valores possíveis.
WebspaceToCreate.Name	Obrigatório. O nome do espaço web.
WebspaceToCreate.Plan	Obrigatório. Este valor deve ser VirtualDedicatedPlan.

Resposta

A resposta inclui um código de estado HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Código de Estado

Uma operação bem sucedida devolve o código de estado 200 (OK).

Para obter informações sobre códigos de estado, consulte Códigos de Erro (Serviço de Web Sites REST API).

Cabeçalhos de Resposta

A resposta para esta operação inclui os seguintes cabeçalhos. A resposta também pode incluir cabeçalhos HTTP padrão adicionais. Todos os cabeçalhos standard estão de acordo com a especificação do protocolo HTTP/1.1.

Cabeçalho de resposta	Descrição
x-ms-request-id	Um valor que identifica exclusivamente o pedido feito contra o serviço de gestão.

Corpo de Resposta

O exemplo de código mostra o formato do corpo de resposta.

{
  "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"
}

A tabela seguinte descreve os elementos-chave do corpo de resposta.

Nome do elemento	Descrição
Site.AdminEnabled	Só para ler. Este valor é sempre verdadeiro.
Estado do Site.Disponibilidade	O estado da disponibilidade de informação de gestão para o site. Os valores possíveis são normais ou limitados. Normal significa que o site está a funcionar corretamente e que a informação de gestão do site está disponível. Limitado significa que apenas informações parciais de gestão para o site estão disponíveis e que informações detalhadas do site não estão disponíveis.
Site.ComputeMode	O modo de computação para o site. Os valores possíveis são Partilhados ou Dedicados.
Site.ContentAilabilityState	Propriedade não serusada.
Site.Ativado	Definido como verdadeiro se o site estiver ativado; caso contrário, é falso. Definir este valor para falso desativa o site. Desativa o site.
Site.EnabledHostNames	Uma variedade de cordas que contém nomes de anfitriões ativados para o site. Por padrão, estes são <SiteName.azurewebsites.net> e<SiteName.scm.azurewebsites.net>.
Estados de Natal do Site.HostName	Elemento de recipiente para estados de camada de tomada segura (SSL).
Site.HostNameSslStates.HostNameSslState	Contém as informações de estado de um certificado SSL que está ligado ao website.
Site.HostNameSslStates.HostNameSslState.IpBasedSslResult	Propriedade não serusada.
Site.HostNameSslStates.HostNameSslState.Name	A URL do site.
Site.HostNameSslStates.HostNameSslState.SslState	O estado da SSL. Os valores possíveis são Desativados, SniEnabled ou IpBasedEnabled.
Site.HostNameSslStates.HostNameSslState.Thumbprint	Uma corda que contém a impressão digital do certificado SSL.
Site.HostNameSslStates.HostNameSslState.ToUpdate	O Boolean. Propriedade não serusada.
Site.HostNameSslStates.HostNameSslState.ToUpdateIpBassl	O Boolean. Propriedade não serusada.
Site.HostNameSslStates.HostNameSslState.VirtualIP	Uma cadeia que contém o endereço IP que é atribuído ao nome de anfitrião se o nome do anfitrião utilizar IP SSL.
Site.HostNames	Uma variedade de cordas que contém os nomes de anfitriões públicos para o site, que incluem domínios personalizados. Importante Quando adicionar um domínio personalizado numa operação PUT, certifique-se de incluir todos os nomes de anfitrião que necessitar para o site. Para eliminar um nome de domínio personalizado numa operação PUT, inclua todos os nomes de anfitriões para o site que tem de guardar, mas omita o que tem de eliminar. Para obter mais informações sobre domínios personalizados no Windows Azure, consulte configurar um nome de domínio personalizado para um web site Windows Azure.
Site.LastModifiedTimeUtc	Um valor de dataTime que contém, em Tempo Universal Coordenado (UTC), a última vez que o site foi modificado.
Site.Name	O nome do Web site.
Site.Proprietário	Propriedade só de leitura.
Site.RepositorySiteName	O nome do site do repositório.
Site.RuntimeAvailabilityState	Os valores possíveis são normais, degradados ou não disponíveis. Normal: o site está a funcionar corretamente. Degradado: o site está a funcionar temporariamente em modo degradado, tipicamente com menos memória e um caso partilhado. Não disponível: devido a um problema inesperado, o site foi excluído do provisionamento. Este valor ocorre normalmente apenas para sites gratuitos.
Site.SSlCertificates	Uma variedade de certificados SSL.
Site.SSLCertificates.Certificate	Contém propriedades de certificado SSL.
Site.SSLCertificates.Certificate.ExpirationDa	Um valor de dataTime que contenha a data de validade do certificado.
Site.SSLCertificates.Certificate.FriendlyName	Uma corda que contém o nome amigável do certificado.
Site.SSLCertificates.Certificate.HostNames	Uma série de cordas que contêm os nomes hospedeiros aos quais o certificado está ligado.
Site.SSLCertificates.Certificate.IssueDate	Um valor dataTime que contém a data em que o certificado foi emitido.
Site.SSLCertificates.Certificate.Emitente	Uma corda que identifica o emitente do certificado.
Site.SSLCertificates.Certificate.Password	Uma corda que contém a senha do certificado.
Site.SSLCertificates.Certificate.PfxBlob	Um valor base64Taio que contém o PfxBlob do certificado.
Site.SSLCertificates.Certificate.SelfLink	Um valor URI que contém o ponto final do site ao qual o certificado está vinculado.
Site.SSLCertificates.Certificate.SiteName	Uma cadeia que contém o nome do site ao qual o certificado está ligado.
Site.SSLCertificates.Certificate.SubjectName	Uma cadeia que contém o nome da entidade a quem o certificado foi emitido.
Site.SSLCertificates.Certificate.Thumbprint	Uma corda que contém a impressão digital do certificado.
Site.SSlCertificates.Certificate.ToDelete	O Boolean. Se o certificado for suprimido, é verdade; caso contrário, é falso.
Site.SSLCertificates.Certificate.Valid	O Boolean. Se o certificado for válido, é verdade; caso contrário, é falso.
Site.SelfLink	URL direto para o ponto final do site em Windows Azure Web Sites, que inclui o ID de subscrição, nome do espaço web e nome do site.
Site.ServerFarm	Uma cadeia para a qual, se existe uma exploração de servidor, o valor é DefaultServerFarm.
Site.SiteMode	String que representa o modo do site. Se o modo do site for Gratuito, este valor é Limitado. Se o modo do site for Partilhado, este valor é Básico. Nota O valor da propriedade SiteMode não é utilizado para o modo Reservado. O modo reservado utiliza a definição ComputeMode.
Site.SiteProperties	Contém AppSettings, Metadados e Propriedades como conjuntos de pares de nome/valor para um site.
Site.SiteProperties.AppSettings	Um conjunto de pares de nome/valor que contêm configurações de aplicação para um site.
Site.SiteProperties.Metadados	Um conjunto de pares de nome/valor que contêm informações de metadados para um site.
Site.SiteProperties.Properties	Um conjunto de pares de nome/valor que contêm propriedades para um site.
Site.State	Uma cadeia que descreve o estado do site. Os valores possíveis são interrompidos ou em execução.
Site.StorageRecoveryDefaultState	Propriedade não serusada.
Estado do Site.Usage	Os valores possíveis são normais ou ultrapassados. Se alguma quota for excedida, o valor do Estado de Utilização muda para Excedido e o site fica offline.
Site.WebSpace	O nome do espaço web no qual o site está localizado. Esta propriedade é só para leitura. Para obter valores possíveis, consulte Referência Rápida - Web Sites Management REST API.

Consulte também

Windows Azure Pack Websites Service REST API

Partilhar via