Adicionar um novo site

Artigo
08/24/2015

Aplica-se a: Windows Azure Pack

Adiciona um novo site.

Solicitação

Substitua {ServiceMgmt} pelo endereço do ponto de extremidade da API de Gerenciamento de Serviços. Substitua {Port} por 30005 para a API de locatário ou 30006 para a API de Locatário Público. Substitua {SUBSCRIPTIONID} pelo identificador de assinatura necessário e substitua {WEBSPACENAME} pelos valores correspondentes do seu site.

Método	URI da solicitação	Versão HTTP
POST	<https:// ServiceMgmt>:<Port>/{SUBSCRIPTIONID}/services/webspaces/{WEBSPACENAME}/sites	HTTP/1.1

Parâmetros de URI

Nenhum.

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.

Cabeçalho da solicitação	Descrição
x-ms-version	Obrigatórios. Especifica a versão da operação a ser usada para esta solicitação. Esse cabeçalho deve ser definido como 2012-10-10 ou a versão atual.
Content-Length	Obrigatórios.
Tipo de Conteúdo: application/json; charset=utf-8	Obrigatório se o corpo da solicitação for enviada no formato JSON.
accept: application/json	Opcional. Use este cabeçalho para receber uma resposta em formato JSON.

Corpo da solicitação

O exemplo de código mostra o formato do corpo da solicitação.

<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 a seguir descreve os principais elementos do corpo da solicitação.

Nome do elemento	Descrição
HostNames	Obrigatórios. O nome de domínio totalmente qualificado para um site. Somente um nome de host pode ser especificado no domínio azurewebsites.net. O nome do host deve corresponder ao nome do site. Domínios personalizados só podem ser especificados para sites Compartilhados ou Standard.
Nome	Obrigatórios. O nome do site. Esse nome deve corresponder ao nome do host no domínio padrão.
ComputeMode	Esse valor deve ser Compartilhado para as ofertas Compartilhadas Gratuitas ou Pagas ou Dedicado para a oferta Standard. O valor padrão é Compartilhado. Se você definir o valor ComputeMode como Dedicado, deverá especificar um valor para a propriedade ServerFarm.
ServerFarm	O nome do farm de servidores associado a este site. Esse é um valor necessário para o modo padrão.
SiteMode	Esse valor é Limitado para a oferta gratuita Básica para a oferta Compartilhada Paga. O valor padrão é Limitado. Observação O modo padrão não usa a configuração SiteMode; usa a configuração ComputeMode.
WebspaceToCreate.GeoRegion	Obrigatórios. A região geográfica do webspace a ser criado. Consulte Referência Rápida – API REST do Serviço de Sites para obter valores possíveis.
WebspaceToCreate.Name	Obrigatórios. O nome do webspace.
WebspaceToCreate.Plan	Obrigatórios. Esse valor deve ser VirtualDedicatedPlan.

Resposta

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

Código de status

Uma operação bem-sucedida retorna o código de status 200 (OK).

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

Cabeçalhos de resposta

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

Cabeçalho de resposta	Descrição
x-ms-request-id	Um valor que identifica exclusivamente a solicitação feita no serviço de gerenciamento.

Corpo da resposta

O exemplo de código mostra o formato do corpo da 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 a seguir descreve os principais elementos do corpo da resposta.

Nome do elemento	Descrição
Site.AdminEnabled	Somente leitura. Esse valor é sempre verdadeiro.
Site.AvailabilityState	O estado de disponibilidade das informações de gerenciamento do site. Os valores possíveis são Normal ou Limitado. Normal significa que o site está sendo executado corretamente e que as informações de gerenciamento do site estão disponíveis. Limitado significa que apenas as informações de gerenciamento parcial do site estão disponíveis e que as informações detalhadas do site não estão disponíveis.
Site.ComputeMode	O modo de computação do site. Os valores possíveis são Compartilhados ou Dedicados.
Site.ContentAvailabilityState	Propriedade não utilizada.
Site.Enabled	Definir como true se o site estiver habilitado; caso contrário, é falso. Definir esse valor como false desabilita o site. Ele coloca o site offline.
Site.EnabledHostNames	Uma matriz de cadeias de caracteres que contém nomes de host habilitados para o site. Por padrão, eles são <SiteName.azurewebsites.net> e<SiteName.scm.azurewebsites.net>.
Site.HostNameSslStates	Elemento container para estados SSL (Secure Socket Layer).
Site.HostNameSslStates.HostNameSslState	Contém as informações de status de um certificado SSL associado ao site.
Site.HostNameSslStates.HostNameSslState.IpBasedSslResult	Propriedade não utilizada.
Site.HostNameSslStates.HostNameSslState.Name	A URL do site.
Site.HostNameSslStates.HostNameSslState.SslState	O estado de SSL. Os valores possíveis são Desabilitado, SniEnabled ou IpBasedEnabled.
Site.HostNameSslStates.HostNameSslState.Thumbprint	Uma cadeia de caracteres que contém a impressão digital do certificado SSL.
Site.HostNameSslStates.HostNameSslState.ToUpdate	Booliano. Propriedade não utilizada.
Site.HostNameSslStates.HostNameSslState.ToUpdateIpBasedSsl	Booliano. Propriedade não utilizada.
Site.HostNameSslStates.HostNameSslState.VirtualIP	Uma cadeia de caracteres que contém o endereço IP atribuído ao nome do host se o nome do host usar o SSL de IP.
Site.HostNames	Uma matriz de cadeias de caracteres que contém os nomes de host público para o site, que incluem domínios personalizados. Importante Ao adicionar um domínio personalizado em uma operação PUT, certifique-se de incluir todos os nomes de host necessários para o site. Para excluir um nome de domínio personalizado em uma operação PUT, inclua todos os nomes de host para o site que você precisa manter, mas omita aquele que você precisa excluir. Para obter mais informações sobre domínios personalizados no Windows Azure, consulte Configurando um nome de domínio personalizado para um site do Windows Azure.
Site.LastModifiedTimeUtc	Um valor dateTime que contém, em UTC (Tempo Universal Coordenado), a última vez que o site foi modificado.
Site.Name	O nome do site.
Site.Owner	Propriedade somente leitura.
Site.RepositorySiteName	O nome do site do repositório.
Site.RuntimeAvailabilityState	Os valores possíveis são Normal, Degradado ou Não Disponível. Normal: o site está sendo executado corretamente. Degradado: o site está sendo executado temporariamente em um modo degradado, normalmente com menos memória e uma instância compartilhada. Não disponível: devido a um problema inesperado, o site foi excluído do provisionamento. Normalmente, esse valor ocorre apenas para sites gratuitos.
Site.SSLCertificates	Uma matriz de certificados SSL.
Site.SSLCertificates.Certificate	Contém as propriedades do certificado SSL.
Site.SSLCertificates.Certificate.ExpirationDate	Um valor dateTime que contém a data de validade do certificado.
Site.SSLCertificates.Certificate.FriendlyName	Uma cadeia de caracteres que contém o nome de exibição do certificado.
Site.SSLCertificates.Certificate.HostNames	Uma matriz de cadeias de caracteres que contêm os nomes de host aos quais o certificado está associado.
Site.SSLCertificates.Certificate.IssueDate	Um valor dateTime que contém a data em que o certificado foi emitido.
Site.SSLCertificates.Certificate.Issuer	Uma cadeia de caracteres que identifica o emissor do certificado.
Site.SSLCertificates.Certificate.Password	Uma cadeia de caracteres que contém a senha do certificado.
Site.SSLCertificates.Certificate.PfxBlob	Um valor base64Binary que contém o PfxBlob do certificado.
Site.SSLCertificates.Certificate.SelfLink	Um valor de URI que contém o ponto de extremidade do site ao qual o certificado está associado.
Site.SSLCertificates.Certificate.SiteName	Uma cadeia de caracteres que contém o nome do site ao qual o certificado está associado.
Site.SSLCertificates.Certificate.SubjectName	Uma cadeia de caracteres que contém a entidade para a qual o certificado foi emitido.
Site.SSLCertificates.Certificate.Thumbprint	Uma cadeia de caracteres que contém a impressão digital do certificado.
Site.SSLCertificates.Certificate.ToDelete	Booliano. Se o certificado for excluído, ele será verdadeiro; caso contrário, é falso.
Site.SSLCertificates.Certificate.Valid	Booliano. Se o certificado for válido, ele será verdadeiro; caso contrário, é falso.
Site.SelfLink	Direcionar a URL para o ponto de extremidade do site em Windows Sites do Azure, que inclui a ID da assinatura, o nome do webspace e o nome do site.
Site.ServerFarm	Uma cadeia de caracteres para a qual, se existir um farm de servidores, o valor será DefaultServerFarm.
Site.SiteMode	Cadeia de caracteres que representa o modo de site. Se o modo de site for Gratuito, esse valor será Limitado. Se o modo de site for Compartilhado, esse valor será Básico. Observação O valor da propriedade SiteMode não é usado para o modo Reservado. O modo reservado usa a configuração ComputeMode.
Site.SiteProperties	Contém AppSettings, Metadados e Propriedades como conjuntos de pares nome/valor para um site.
Site.SiteProperties.AppSettings	Um conjunto de pares de nome/valor que contém as configurações do aplicativo para um site.
Site.SiteProperties.Metadata	Um conjunto de pares de nome/valor que contém as informações de metadados de um site.
Site.SiteProperties.Properties	Um conjunto de pares de nome/valor que contém as propriedades de um site.
Site.State	Uma cadeia de caracteres que descreve o estado do site. Os valores possíveis são Parado ou Em Execução.
Site.StorageRecoveryDefaultState	Propriedade não utilizada.
Site.UsageState	Os valores possíveis são Normal ou Excedido. Se alguma cota for excedida, o valor UsageState será alterado para Excedido e o site ficar offline.
Site.WebSpace	O nome do webspace no qual o site está localizado. Esta propriedade é somente para leitura. Para obter valores possíveis, consulte Referência Rápida – API REST de Gerenciamento de Sites.

Consulte Também

Windows API REST do Serviço de Sites do Azure Pack

Compartilhar via