新增網站

發行項
08/24/2015

適用于：Windows Azure Pack

新增網站。

要求

以您的服務管理 API 端點位址取代 {ServiceMgmt} 。將 {Port} 取代為租使用者 API 的 30005 或公用租使用者 API 的 30006。以必要的訂用帳戶識別碼取代 {SUBSCRIPTIONID}，並將 {WEBSPACENAME} 取代為您網站的對應值。

方法	要求 URI	HTTP 版本
POST	<HTTPs:// ServiceMgmt > ： < Port > /{SUBSCRIPTIONID}/services/webspaces/{WEBSPACENAME}/sites	HTTP/1.1

URI 參數

無。

要求標頭

下表描述必要的和選用的要求標頭。

要求標頭	描述
x-ms-version	必要。指定用於這個要求的作業版本。此標頭應設定為 2012-10-10 或目前版本。
Content-Length	必要。
Content-Type：application/json;charset=utf-8	如果要求主體是以 JSON 格式傳送，則為必要項目。
accept：application/json	選擇性。若要接收 JSON 格式的回應，請使用此標頭。

要求本文

程式碼範例會顯示要求本文的格式。

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

下表說明要求主體的重要元素。

元素名稱	描述
HostNames	必要。網站的完整功能變數名稱。 azurewebsites.net 網域中只能指定一個主機名稱。主機名稱應該符合網站的名稱。自訂網域只能針對共用網站或標準網站指定。
名稱	必要。網站的名稱。此名稱應符合預設網域中的主機名稱。
ComputeMode	此值應為免費或付費共用供應專案共用，或適用于標準供應專案的專用。預設值為 Shared。如果您將 ComputeMode 值設定為 Dedicated，則必須指定 ServerFarm 屬性的值。
ServerFarm	與此網站相關聯的伺服器陣列名稱稱。對於標準模式而言，這是必要的值。
SiteMode	對於付費共用供應專案的免費供應專案，此值為「有限」。預設值為 Limited。注意標準模式不會使用 SiteMode 設定，而是使用 ComputeMode 設定。
WebspaceToCreate.GeoRegion	必要。要建立之 Webspace 的地理區域。如需可能的值，請參閱快速參考 - Web Sites 服務 REST API。
WebspaceToCreate.Name	必要。網路空間的名稱。
WebspaceToCreate.Plan	必要。此值必須是 VirtualDedicatedPlan。

回應

回應包括 HTTP 狀態碼、一組回應標頭和回應主體。

狀態碼

成功的作業會傳回狀態碼 200 (OK)。

如需狀態碼的相關資訊，請參閱錯誤碼 (Web Sites Service REST API) 。

回應標頭

這項作業的回應包括下列標頭。回應也可能包括其他標準 HTTP 標頭。所有標準標頭都符合 HTTP/1.1 通訊協定規格。

回應標頭	描述
x-ms-request-id	唯一識別對管理服務發出之要求的值。

回應本文

程式碼範例會顯示回應本文的格式。

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

下表描述回應主體的重要元素。

元素名稱	描述
Site.AdminEnabled	唯讀。這個值一律是 true。
Site.AvailabilityState	網站之管理資訊可用性的狀態。可能的值為 Normal 或 Limited。一般表示月臺已正確執行，且月臺的管理資訊可供使用。有限表示只有部分管理資訊可供使用，且無法使用詳細的網站資訊。
Site.ComputeMode	網站的計算模式。可能的值為 [共用] 或 [專用]。
Site.ContentAvailabilityState	未使用的屬性。
Site.Enabled	如果啟用網站，請將設定為 true;否則為 false。將此值設定為 false 會停用網站。它會讓網站離線。
Site.EnabledHostNames	字串陣列，包含網站的已啟用主機名稱。根據預設，這些是 <SiteName.azurewebsites.net> 和 <SiteName.scm.azurewebsites.net> 。
Site.HostNameSslStates	安全通訊端層的容器元素 (SSL) 狀態。
Site.HostNameSslStates.HostNameSslState	包含系結至網站的 SSL 憑證狀態資訊。
Site.HostNameSslStates.HostNameSslState.IpBasedSslResult	未使用的屬性。
Site.HostNameSslStates.HostNameSslState.Name	網站的 URL。
Site.HostNameSslStates.HostNameSslState.SslState	SSL 狀態。可能的值為 Disabled、SniEnabled 或 IpBasedEnabled。
Site.HostNameSslStates.HostNameSslState.Thumbprint	包含 SSL 憑證指紋的字串。
Site.HostNameSslStates.HostNameSslState.ToUpdate	布林值。未使用的屬性。
Site.HostNameSslStates.HostNameSslState.ToUpdateIpBasedSsl	布林值。未使用的屬性。
Site.HostNameSslStates.HostNameSslState.VirtualIP	字串，包含如果主機名稱使用 IP SSL，則指派給主機名稱的 IP 位址。
Site.HostNames	字串陣列，包含網站的公用主機名稱，其中包含自訂網域。重要當您在 PUT 作業中新增自訂網域時，請務必包含網站所需的每個主機名稱。若要刪除 PUT 作業中的自訂功能變數名稱，請包含您必須保留之網站的所有主機名稱，但省略您必須刪除的主機名稱。如需Windows Azure 上自訂網域的詳細資訊，請參閱設定Windows Azure 網站的自訂功能變數名稱。
Site.LastModifiedTimeUtc	dateTime值，其中包含在國際標準時間 (UTC) ，上次修改網站的時間。
Site.Name	網站的名稱。
Site.Owner	唯讀的屬性。
Site.RepositorySiteName	存放庫網站的名稱。
Site.RuntimeAvailabilityState	可能的值為 [一般]、[降級] 或 [無法使用]。一般：網站正常執行。已降級：網站在降級模式中暫時執行，通常記憶體較少和共用實例。無法使用：由於非預期的問題，網站已從布建中排除。此值通常只會針對免費網站發生。
Site.SSLCertificates	SSL 憑證的陣列。
Site.SSLCertificates.Certificate	包含 SSL 憑證屬性。
Site.SSLCertificates.Certificate.ExpirationDate	dateTime值，包含憑證的到期日。
Site.SSLCertificates.Certificate.FriendlyName	包含憑證之易記名稱的字串。
Site.SSLCertificates.Certificate.HostNames	字串陣列，包含憑證所系結的主機名稱。
Site.SSLCertificates.Certificate.IssueDate	dateTime值，包含已發行憑證的日期。
Site.SSLCertificates.Certificate.Issuer	識別憑證簽發者的字串。
Site.SSLCertificates.Certificate.Password	包含憑證之密碼的字串。
Site.SSLCertificates.Certificate.PfxBlob	包含憑證之 PfxBlob 的 base64Binary 值。
Site.SSLCertificates.Certificate.SelfLink	URI 值，包含憑證所系結之月臺的端點。
Site.SSLCertificates.Certificate.SiteName	包含憑證所繫結之網站名稱的字串。
Site.SSLCertificates.Certificate.SubjectName	包含憑證所簽發之目標實體名稱的字串。
Site.SSLCertificates.Certificate.Thumbprint	包含憑證指紋的字串。
Site.SSLCertificates.Certificate.ToDelete	布林值。如果要刪除憑證，則為 true;否則為 false。
Site.SSLCertificates.Certificate.Valid	布林值。如果憑證有效，則為 true;否則為 false。
Site.SelfLink	Windows Azure 網站上的網站端點直接 URL，其中包含訂用帳戶識別碼、Webspace 名稱和網站名稱。
Site.ServerFarm	字串，如果伺服器陣列存在，此值為 DefaultServerFarm。
Site.SiteMode	表示網站模式的字串。如果網站模式為 [免費]，則此值為 [有限]。如果網站模式為 [共用]，則此值為 [基本]。注意 SiteMode 屬性值不會用於保留模式。保留模式會使用 ComputeMode 設定。
Site.SiteProperties	包含 AppSettings、中繼資料和屬性，做為網站的名稱/值組集。
Site.SiteProperties.AppSettings	包含網站之應用程式設定的一組名稱/值組。
Site.SiteProperties.Metadata	包含網站之中繼資料資訊的一組名稱/值組。
Site.SiteProperties.Properties	包含網站之屬性的一組名稱/值組。
Site.State	描述網站狀態的字串。可能的值為 Stopped 或 Running。
Site.StorageRecoveryDefaultState	未使用的屬性。
Site.UsageState	可能的值為 Normal 或 Exceeded。如果超過任何配額，UsageState 值會變更為 [已超過]，而網站會離線。
Site.WebSpace	網站所在的 Webspace 名稱。這是唯讀的屬性。如需可能的值，請參閱快速參考 - 網站管理 REST API。

另請參閱

Windows Azure Pack 網站服務 REST API

共用方式為