Dodawanie nowej witryny

Artykuł
08/24/2015

Dotyczy: Windows Azure Pack

Dodaje nową witrynę.

Żądanie

Zastąp ciąg {ServiceMgmt} adresem punktu końcowego interfejsu API zarządzania usługami. Zastąp element {Port} wartością 30005 dla interfejsu API dzierżawy lub 30006 dla interfejsu API dzierżawy publicznej. Zastąp ciąg {SUBSCRIPTIONID} wymaganym identyfikatorem subskrypcji i zastąp ciąg {WEBSPACENAME} odpowiednimi wartościami witryny internetowej.

Metoda	Identyfikator URI żądania	Wersja PROTOKOŁU HTTP
POST	<https:// ServiceMgmt>:<Port>/{SUBSCRIPTIONID}/services/webspaces/{WEBSPACENAME}/sites	HTTP/1.1

Parametry identyfikatora URI

Brak.

Nagłówki żądań

W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań.

Nagłówek żądania	Opis
x-ms-version	Wymagane. Określa wersję operacji do użycia dla tego żądania. Ten nagłówek powinien być ustawiony na 2012-10-10 lub bieżącą wersję.
Długość zawartości	Wymagane.
Typ zawartości: application/json; charset=utf-8	Wymagane, jeśli treść żądania jest wysyłana w formacie JSON.
accept: application/json	Opcjonalny. Użyj tego nagłówka, aby otrzymać odpowiedź w formacie JSON.

Treść żądania

Przykładowy kod przedstawia format treści żądania.

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

W poniższej tabeli opisano kluczowe elementy treści żądania.

Nazwa elementu	Opis
Nazwy hosta	Wymagane. W pełni kwalifikowana nazwa domeny witryny internetowej. W domenie azurewebsites.net można określić tylko jedną nazwę hosta. Nazwa hosta powinna być zgodna z nazwą witryny internetowej. Domeny niestandardowe można określić tylko dla witryn sieci Web udostępnionych lub standardowych.
Nazwa	Wymagane. Nazwa witryny sieci Web. Ta nazwa powinna być zgodna z nazwą hosta w domenie domyślnej.
ComputeMode	Ta wartość powinna być udostępniona dla bezpłatnych lub płatnych ofert udostępnionych lub dedykowanych dla oferty standardowej. Wartość domyślna to Udostępnione. Jeśli ustawisz wartość ComputeMode na Wartość Dedykowana, musisz określić wartość właściwości ServerFarm.
ServerFarm	Nazwa farmy serwerów skojarzonej z tą witryną internetową. Jest to wymagana wartość dla trybu standardowego.
SiteMode	Ta wartość jest ograniczona dla bezpłatnej oferty Podstawowa dla płatnej oferty udostępnionej. Wartość domyślna to Ograniczona. Uwaga Tryb standardowy nie używa ustawienia SiteMode; używa ustawienia ComputeMode.
WebspaceToCreate.GeoRegion	Wymagane. Region geograficzny przestrzeni internetowej do utworzenia. Zobacz Szybki przewodnik — interfejs API REST usługi witryn sieci Web, aby uzyskać możliwe wartości.
WebspaceToCreate.Name	Wymagane. Nazwa przestrzeni internetowej.
WebspaceToCreate.Plan	Wymagane. Ta wartość musi być VirtualDedicatedPlan.

Reakcja

Odpowiedź zawiera kod stanu HTTP, zestaw nagłówków odpowiedzi i treść odpowiedzi.

Kod stanu

Operacja zakończona powodzeniem zwraca kod stanu 200 (OK).

Aby uzyskać informacje o kodach stanu, zobacz Kody błędów (interfejs API REST usługi witryn sieci Web).

Nagłówki odpowiedzi

Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie nagłówki standardowe są zgodne ze specyfikacją protokołu HTTP/1.1.

Nagłówek odpowiedzi	Opis
x-ms-request-id	Wartość, która jednoznacznie identyfikuje żądanie wykonane względem usługi zarządzania.

Treść odpowiedzi

Przykładowy kod przedstawia format treści odpowiedzi.

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

W poniższej tabeli opisano kluczowe elementy treści odpowiedzi.

Nazwa elementu	Opis
Site.AdminEnabled	Tylko do odczytu. Ta wartość jest zawsze prawdziwa.
Site.AvailabilityState	Stan dostępności informacji o zarządzaniu dla lokacji. Możliwe wartości są normalne lub ograniczone. Normalna oznacza, że lokacja działa prawidłowo i że informacje o zarządzaniu lokacją są dostępne. Ograniczone oznacza, że dostępne są tylko częściowe informacje o zarządzaniu lokacją i że szczegółowe informacje o witrynie są niedostępne.
Site.ComputeMode	Tryb obliczeniowy witryny internetowej. Możliwe wartości są udostępnione lub dedykowane.
Site.ContentAvailabilityState	Nieużywane właściwości.
Site.Enabled	Ustaw wartość true, jeśli lokacja jest włączona; w przeciwnym razie jest to fałsz. Ustawienie tej wartości na wartość false powoduje wyłączenie witryny. Przełącz witrynę do trybu offline.
Site.EnabledHostNames	Tablica ciągów, która zawiera włączone nazwy hostów dla witryny. Domyślnie są < to siteName.azurewebsites.net> i<SiteName.scm.azurewebsites.net>.
Site.HostNameSslStates	Element kontenera dla stanów Ssl (Secure Socket Layer).
Site.HostNameSslStates.HostNameSslState	Zawiera informacje o stanie certyfikatu SSL powiązanego z witryną internetową.
Site.HostNameSslStates.HostNameSslState.IpBasedSslResult	Nieużywane właściwości.
Site.HostNameSslStates.HostNameSslState.Name	Adres URL witryny internetowej.
Site.HostNameSslStates.HostNameSslState.SslState	Stan SSL. Możliwe wartości to Disabled, SniEnabled lub IpBasedEnabled.
Site.HostNameSslStates.HostNameSslState.Thumbprint	Ciąg zawierający odcisk palca certyfikatu SSL.
Site.HostNameSslStates.HostNameSslState.ToUpdate	Boolean. Nieużywane właściwości.
Site.HostNameSslStates.HostNameSslState.ToUpdateIpBasedSsl	Boolean. Nieużywane właściwości.
Site.HostNameSslStates.HostNameSslState.VirtualIP	Ciąg zawierający adres IP przypisany do nazwy hosta, jeśli nazwa hosta używa protokołu IP SSL.
Site.HostNames	Tablica ciągów, która zawiera nazwy hostów publicznych dla lokacji, w tym domeny niestandardowe. Ważne Podczas dodawania domeny niestandardowej w operacji PUT należy uwzględnić każdą nazwę hosta wymaganą dla witryny internetowej. Aby usunąć niestandardową nazwę domeny w operacji PUT, uwzględnij wszystkie nazwy hostów dla witryny, którą musisz zachować, ale pomiń tę, którą musisz usunąć. Aby uzyskać więcej informacji na temat domen niestandardowych na platformie Windows Azure, zobacz Konfigurowanie niestandardowej nazwy domeny dla witryny internetowej platformy Azure Windows.
Site.LastModifiedTimeUtc	Wartość dateTime zawierająca w uniwersalnym czasie koordynowanym (UTC) czas ostatniej modyfikacji witryny internetowej.
Site.Name	Nazwa witryny sieci Web.
Site.Owner	Właściwość tylko do odczytu.
Site.RepositorySiteName	Nazwa witryny internetowej repozytorium.
Site.RuntimeAvailabilityState	Możliwe wartości to Normalne, Obniżone lub Niedostępne. Normalny: witryna internetowa działa prawidłowo. Obniżona wydajność: witryna internetowa jest uruchomiona tymczasowo w trybie obniżonej wydajności, zazwyczaj z mniejszą ilością pamięci i wystąpieniem udostępnionym. Niedostępne: z powodu nieoczekiwanego problemu witryna została wykluczona z aprowizacji. Ta wartość zazwyczaj występuje tylko w przypadku bezpłatnych witryn.
Site.SSLCertificates	Tablica certyfikatów SSL.
Site.SSLCertificates.Certificate	Zawiera właściwości certyfikatu SSL.
Site.SSLCertificates.Certificate.ExpirationDate	Wartość dateTime zawierająca datę wygaśnięcia certyfikatu.
Site.SSLCertificates.Certificate.FriendlyName	Ciąg zawierający przyjazną nazwę certyfikatu.
Site.SSLCertificates.Certificate.HostNames	Tablica ciągów zawierających nazwy hostów, z którymi jest powiązany certyfikat.
Site.SSLCertificates.Certificate.IssueDate	Wartość dateTime zawierająca datę wystawienia certyfikatu.
Site.SSLCertificates.Certificate.Issuer	Ciąg identyfikujący wystawcę certyfikatu.
Site.SSLCertificates.Certificate.Password	Ciąg zawierający hasło certyfikatu.
Site.SSLCertificates.Certificate.PfxBlob	Wartość base64Binary zawierająca wartość PfxBlob certyfikatu.
Site.SSLCertificates.Certificate.SelfLink	Wartość identyfikatora URI zawierająca punkt końcowy lokacji, z którą jest powiązany certyfikat.
Site.SSLCertificates.Certificate.SiteName	Ciąg zawierający nazwę lokacji, z którą jest powiązany certyfikat.
Site.SSLCertificates.Certificate.SubjectName	Ciąg zawierający nazwę jednostki, dla której wystawiono certyfikat.
Site.SSLCertificates.Certificate.Thumbprint	Ciąg zawierający odcisk palca certyfikatu.
Site.SSLCertificates.Certificate.ToDelete	Boolean. Jeśli certyfikat ma zostać usunięty, jest to prawda; w przeciwnym razie jest to fałsz.
Site.SSLCertificates.Certificate.Valid	Boolean. Jeśli certyfikat jest prawidłowy, to prawda; w przeciwnym razie jest to fałsz.
Site.SelfLink	Bezpośredni adres URL do punktu końcowego witryny internetowej w witrynach internetowych platformy Windows Azure, który zawiera identyfikator subskrypcji, nazwę przestrzeni internetowej i nazwę witryny.
Site.ServerFarm	Ciąg, dla którego, jeśli istnieje farma serwerów, wartość to DefaultServerFarm.
Site.SiteMode	Ciąg reprezentujący tryb witryny internetowej. Jeśli tryb witryny internetowej ma wartość Bezpłatna, ta wartość jest ograniczona. Jeśli tryb witryny internetowej jest udostępniony, ta wartość to Podstawowa. Uwaga Wartość właściwości SiteMode nie jest używana w trybie zarezerwowanym. Tryb zarezerwowany używa ustawienia ComputeMode.
Site.SiteProperties	Zawiera appSettings, Metadata i Properties jako zestawy par nazwa/wartość dla witryny.
Site.SiteProperties.AppSettings	Zestaw par nazwa/wartość, które zawierają ustawienia aplikacji dla lokacji.
Site.SiteProperties.Metadata	Zestaw par nazwa/wartość, które zawierają informacje o metadanych dla lokacji.
Site.SiteProperties.Properties	Zestaw par nazwa/wartość, które zawierają właściwości witryny.
Site.State	Ciąg opisujący stan witryny internetowej. Możliwe wartości są zatrzymane lub uruchomione.
Site.StorageRecoveryDefaultState	Nieużywane właściwości.
Site.UsageState	Możliwe wartości są normalne lub przekroczone. Jeśli jakikolwiek limit przydziału zostanie przekroczony, wartość UsageState zmieni się na Przekroczono, a witryna przejdzie do trybu offline.
Site.WebSpace	Nazwa przestrzeni internetowej, w której znajduje się witryna internetowa. Ta właściwość jest tylko do odczytu. Aby uzyskać możliwe wartości, zobacz Szybki przewodnik — interfejs API REST zarządzania witrynami sieci Web.

Zobacz też

Windows interfejs API REST usługi Azure Pack Websites

Udostępnij za pośrednictwem