Přidání nového webu

Článek
08/24/2015

Platí pro: Windows Azure Pack

Přidá nový web.

Žádost

Nahraďte {ServiceMgmt} adresou koncového bodu rozhraní API pro správu služeb. Položku {Port} nahraďte 30005 pro rozhraní API tenanta nebo 30006 pro rozhraní API veřejného tenanta. Nahraďte {SUBSCRIPTIONID} požadovaným identifikátorem předplatného a nahraďte {WEBSPACENAME} odpovídajícími hodnotami pro váš web.

Metoda	Identifikátor URI žádosti	Verze HTTP
POST	<https:// ServiceMgmt>:<Port>/{SUBSCRIPTIONID}/services/webspaces/{WEBSPACENAME}/sites	HTTP/1.1

Parametry identifikátoru URI

Žádné

Hlavičky požadavku

Následující tabulka popisuje požadované a volitelné hlavičky požadavků.

Hlavička požadavku	Popis
x-ms-version	Povinná hodnota. Určuje verzi operace, která se má použít pro tento požadavek. Tato hlavička by měla být nastavená na verzi 2012-10-10 nebo aktuální verzi.
Délka obsahu	Povinná hodnota.
Content-Type: application/json; charset=utf-8	Vyžaduje se, pokud se text požadavku odešle ve formátu JSON.
accept: application/json	Nepovinný parametr. Pomocí této hlavičky obdržíte odpověď ve formátu JSON.

Text požadavku

Příklad kódu ukazuje formát textu požadavku.

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

Následující tabulka popisuje klíčové prvky textu požadavku.

Název elementu	Popis
Hostname	Povinná hodnota. Plně kvalifikovaný název domény pro web. V doméně azurewebsites.net lze zadat pouze jeden název hostitele. Název hostitele by měl odpovídat názvu webu. Pro sdílené nebo standardní weby je možné zadat jenom vlastní domény.
Název	Povinná hodnota. Název webových stránek. Tento název by měl odpovídat názvu hostitele ve výchozí doméně.
ComputeMode	Tato hodnota by měla být sdílená pro bezplatné nebo placené sdílené nabídky nebo vyhrazená pro standardní nabídku. Výchozí hodnota je Sdílená. Pokud nastavíte hodnotu ComputeMode na Dedicated, musíte zadat hodnotu pro ServerFarm vlastnost.
ServerFarm	Název serverové farmy přidružené k tomuto webu. Jedná se o požadovanou hodnotu pro režim Standard.
SiteMode	Tato hodnota je omezená pro nabídku Free Basic pro placenou sdílenou nabídku. Výchozí hodnota je Omezená. Poznámka Standardní režim nepoužívá nastavení SiteMode; používá nastavení ComputeMode.
WebspaceToCreate.GeoRegion	Povinná hodnota. Geografická oblast webového prostoru, kterou chcete vytvořit. Informace o možných hodnotách najdete v rychlém odkazu – rozhraní REST API služby Web Sites.
WebspaceToCreate.Name	Povinná hodnota. Název webového prostoru.
WebspaceToCreate.Plan	Povinná hodnota. Tato hodnota musí být VirtualDedicatedPlan.

Odpověď

Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědí a text odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK).

Informace o stavových kódech najdete v tématu Kódy chyb (rozhraní REST API služby weby).

Hlavičky odpovědi

Odpověď pro tuto operaci obsahuje následující hlavičky. Odpověď může obsahovat také další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička odpovědi	Description
x-ms-request-id	Hodnota, která jednoznačně identifikuje požadavek provedený ve službě pro správu.

Text odpovědi

Příklad kódu ukazuje formát textu odpovědi.

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

Následující tabulka popisuje klíčové prvky textu odpovědi.

Název elementu	Popis
Site.AdminEnabled	Jen pro čtení. Tato hodnota je vždy pravdivá.
Site.AvailabilityState	Stav dostupnosti informací o správě webu. Možné hodnoty jsou Normální nebo Omezené. Normální znamená, že web běží správně a že jsou k dispozici informace o správě webu. Omezené znamená, že jsou k dispozici pouze částečné informace o správě webu a že podrobné informace o webu nejsou k dispozici.
Site.ComputeMode	Výpočetní režim webu. Možné hodnoty jsou Sdílené nebo Vyhrazené.
Site.ContentAvailabilityState	Nepoužitá vlastnost.
Web.Enabled	Nastavte na hodnotu True, pokud je web povolený; jinak je nepravda. Nastavení této hodnoty na false zakáže web. Web se přenese do offline režimu.
Site.EnabledHostNames	Pole řetězců, které obsahují povolené názvy hostitelů pro web. Ve výchozím nastavení jsou <to SiteName.azurewebsites.net a<SiteName.scm.azurewebsites.net>>.
Site.HostNameSslStates	Element kontejneru pro stavy SSL (Secure Socket Layer).
Site.HostNameSslStates.HostNameSslState	Obsahuje informace o stavu certifikátu SSL, který je vázán na web.
Site.HostNameSslStates.HostNameSslState.IpBasedSslResult	Nepoužitá vlastnost
Site.HostNameSslStates.HostNameSslState.Name	Adresa URL webu.
Site.HostNameSslStates.HostNameSslState.SslState	Stav SSL. Možné hodnoty jsou Disabled, SniEnabled nebo IpBasedEnabled.
Site.HostNameSslStates.HostNameSslState.Thumbprint	Řetězec obsahující kryptografický otisk certifikátu SSL.
Site.HostNameSslStates.HostNameSslState.ToUpdate	Boolean. Nepoužitá vlastnost
Site.HostNameSslStates.HostNameSslState.ToUpdateIpBasedSsl	Boolean. Nepoužitá vlastnost
Site.HostNameSslStates.HostNameSslState.VirtualIP	Řetězec obsahující IP adresu přiřazenou k názvu hostitele, pokud název hostitele používá protokol IP SSL.
Site.HostNames	Pole řetězců obsahujících názvy veřejných hostitelů pro web, které zahrnují vlastní domény. Důležité Při přidání vlastní domény do operace PUT nezapomeňte zahrnout každý název hostitele, který požadujete pro web. Pokud chcete odstranit vlastní název domény v operaci PUT, zahrňte všechny názvy hostitelů pro lokalitu, kterou musíte zachovat, ale vynecháte název, který musíte odstranit. Další informace o vlastních doménách v Windows Azure najdete v tématu Konfigurace vlastního názvu domény pro web Windows Azure.
Site.LastModifiedTimeUtc	Hodnota dateTime , která obsahuje v koordinovaném univerzálním čase (UTC) čas poslední změny webu.
Site.Name	Název webových stránek.
Site.Owner	Vlastnost jen pro čtení
Site.RepositorySiteName	Název webu úložiště.
Site.RuntimeAvailabilityState	Možné hodnoty jsou Normální, Degradované nebo Nedostupné. Normální: web běží správně. Snížený výkon: Web běží dočasně v degradovaném režimu, obvykle s menší pamětí a sdílenou instancí. Není k dispozici: Kvůli neočekávanému problému se web vyloučil ze zřizování. K této hodnotě obvykle dochází pouze u bezplatných webů.
Site.SSLCertificates	Pole certifikátů SSL.
Site.SSLCertificates.Certificate	Obsahuje vlastnosti certifikátu SSL.
Site.SSLCertificates.Certificate.ExpirationDate	Hodnota dateTime , která obsahuje datum vypršení platnosti certifikátu.
Site.SSLCertificates.Certificate.FriendlyName	Řetězec, který obsahuje popisný název certifikátu.
Site.SSLCertificates.Certificate.HostNames	Pole řetězců, které obsahují názvy hostitelů, ke kterým je certifikát vázán.
Site.SSLCertificates.Certificate.IssueDate	Hodnota dateTime , která obsahuje datum vydání certifikátu.
Site.SSLCertificates.Certificate.Issuer	Řetězec, který identifikuje vystavitele certifikátu.
Site.SSLCertificates.Certificate.Password	Řetězec, který obsahuje heslo pro certifikát.
Site.SSLCertificates.Certificate.PfxBlob	Hodnota base64Binary, která obsahuje PfxBlob certifikátu.
Site.SSLCertificates.Certificate.SelfLink	Hodnota identifikátoru URI, která obsahuje koncový bod lokality, ke které je certifikát vázán.
Site.SSLCertificates.Certificate.SiteName	Řetězec, který obsahuje název lokality, ke které je certifikát vázán.
Site.SSLCertificates.Certificate.SubjectName	Řetězec obsahující název entity, pro kterou byl certifikát vystaven.
Site.SSLCertificates.Certificate.Thumbprint	Řetězec obsahující kryptografický otisk certifikátu.
Site.SSLCertificates.Certificate.ToDelete	Boolean. Pokud má být certifikát odstraněn, je pravdivý; jinak je nepravda.
Site.SSLCertificates.Certificate.Valid	Boolean. Pokud je certifikát platný, je pravdivý; jinak je nepravda.
Site.SelfLink	Přímou adresu URL koncového bodu webu na Windows webech Azure, včetně ID předplatného, názvu webového prostoru a názvu webu.
Site.ServerFarm	Řetězec, pro který existuje serverová farma, je hodnota DefaultServerFarm.
Site.SiteMode	Řetězec, který představuje režim webu. Pokud je režim webu zdarma, je tato hodnota omezená. Pokud je režim webu sdílený, tato hodnota je Basic. Poznámka Hodnota vlastnosti SiteMode se nepoužívá pro rezervovaný režim. Rezervovaný režim používá nastavení ComputeMode.
Site.SiteProperties	Obsahuje AppSettings, Metadata a Vlastnosti jako sady dvojic name/value pro web.
Site.SiteProperties.AppSettings	Sada párů název/hodnota, které obsahují nastavení aplikace pro web.
Site.SiteProperties.Metadata	Sada dvojic name/value, které obsahují informace o metadatech pro web.
Site.SiteProperties.Properties	Sada dvojic name/value, které obsahují vlastnosti lokality.
Site.State	Řetězec, který popisuje stav webu. Možné hodnoty jsou zastavené nebo spuštěné.
Site.StorageRecoveryDefaultState	Nepoužitá vlastnost.
Site.UsageState	Možné hodnoty jsou normální nebo překročené. Pokud je překročena nějaká kvóta, hodnota UsageState se změní na Překročení a web přejde do offline režimu.
Site.WebSpace	Název webového prostoru, ve kterém se nachází web. Tato vlastnost je jen ke čtení. Možné hodnoty najdete v tématu Rychlá reference – Rozhraní REST API pro správu webů.

Viz také

Windows rozhraní REST API služby Azure Pack

Sdílet prostřednictvím