Kody błędów (interfejs API REST usługi witryn sieci Web)

Artykuł
08/24/2015

Dotyczy: Windows Azure Pack

Operacje interfejsu API REST dla interfejsu API zarządzania usługą zwracają standardowe kody stanu HTTP zgodnie z definicjami kodu stanu HTTP/1.1 pod adresem http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html.

Oprócz standardowych kodów stanu HTTP interfejs API zarządzania usługą zwraca rozszerzone kody błędów i komunikaty o błędach. Kody rozszerzone nie zastępują standardowych kodów stanu HTTP, ale dostarczają dodatkowych, przydatnych informacji, które mogą być używane w połączeniu ze standardowymi kodami stanu HTTP. Na przykład błąd HTTP 404 może wystąpić z wielu powodów; w związku z tym dodatkowe informacje w komunikacie rozszerzonym mogą pomóc w rozwiązaniu problemu.

Poniższe przykładowe żądanie i odpowiedź pokazują format rozszerzonych informacji o błędzie w treści odpowiedzi.

Przykład

Użytkownik wystawia żądanie HTTP GET w następującym formacie względem witryny o nazwie Fabrikam, która nie istnieje.

https://management.core.windows.net/\ <Identyfikator> subskrypcji/usługi/WebSpaces/WebSpaceName>/<sites/Fabrikam

Poniższy przykład przedstawia odpowiedź.

HTTP/1.1 404 Not Found
Content-Length: 391
Content-Type: application/xml; charset=utf-8
Server: Microsoft-HTTPAPI/2.0
Date: Thu, 17 Jan 2013 21:01:03 GMT

<Error xmlns="https://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Code>NotFound</Code>
  <Message>Cannot find site Fabrikam.</Message>
  <ExtendedCode>04009</ExtendedCode>
  <MessageTemplate>Cannot find site {0}.</MessageTemplate>
  <Parameters xmlns:a="https://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <a:string>Fabrikam</a:string>
  </Parameters>
</Error>

W poniższej tabeli opisano kluczowe elementy w komunikacie rozszerzonym.

Nazwa elementu	Opis
Kod	Ciąg tekstowy odpowiedniego standardowego kodu stanu HTML bez spacji.
Komunikat	Tekst rozszerzonego komunikatu o błędzie dostarczonego użytkownikowi.
ExtendedCode	Rozszerzony kod błędu, który jest wartością liczbową unikatową dla tego typu błędu. Aby uzyskać listę kodów rozszerzonych, zobacz tabele w poniższej sekcji "Rozszerzone kody błędów".
MessageTemplate	Szablon rzeczywistego komunikatu prezentowanego użytkownikowi z symbolami zastępczymi wypełnionymi informacjami z elementu Parameters.
Parametry	Kontener dla ciągów, które wypełniają posiadacze miejsc w szablonie wiadomości. Te ciągi zawierają informacje unikatowe dla scenariusza użytkownika.

Rozszerzone kody błędów

W poniższych tabelach wymieniono rozszerzone kody błędów.

Ogólne — 01xxx

Kod błędu rozszerzonego	Typ błędu	Szablon komunikatu o błędzie lub komunikatu o błędzie
01001	Accessdenied	Odmowa dostępu.
01002	CommandResourceNotPresent	Obiekt zasobu polecenia nie jest obecny w treści żądania.
01003	InvalidName	Nieprawidłowa nazwa {0}.
01004	UnknownCommandVerb	Nie można zrozumieć czasownika {0}polecenia .
01005	IsInReadOnlyMode	Usługa jest obecnie w trybie tylko do odczytu.
01006	ParameterIsNotSpecified	Nie określono parametru {0} .
01007	InvalidParameterValue	Parametr {0} ma nieprawidłową wartość.
01008	InvalidRequest	{0} obiekt nie jest obecny w treści żądania.
01009	IncorrectDateTimeRange	Wartość od w ciągu zapytania jest większa niż lub równa wartości.
01010	RequiredParameterMissing	Brak wymaganego parametru {0} .
01011	ResourceNameCannotChange	Nie można zmienić nazwy przydziału sieci Web.
01012	FailedToConvertParameterValue	Nie można przekonwertować wartości parametru ciągu zapytania na wartość logiczną.
01013	ParameterNameAlreadyExists	Parametr o nazwie {0} już istnieje w żądaniu.
01014	ParameterNameIsEmpty	Nazwa parametru nie może być pusta.
01015	NotReady	Brak gotowości
01016	Gotowy	Gotowy
01017	UpdateForFieldNotAllowed	Aktualizacja nie jest dozwolona {0} dla pola.
01018	NotSupportedCommand	Usługa sieci Web nie obsługuje polecenia {0}. Obsługiwane polecenia to {1}.
01019	InvalidData	Nieprawidłowe dane ({0}).
01020	GenericConflict	Wystąpił konflikt. {0}
01021	InternalServerError	Wystąpił wewnętrzny błąd serwera. {0}

Przestrzeń internetowa — 03xxx

Kod błędu rozszerzonego	Typ błędu	Szablon komunikatu o błędzie lub komunikatu o błędzie
03001	NumberOfSitesLimit	Liczba witryn przekracza dozwoloną maksymalną liczbę witryn.
03002	NumberOfWorkersLimit	LiczbaOfWorkers przekracza dozwoloną maksymalną wartość.
03003	NoStorageVolumeAvailable	Na dysku jest za mało miejsca.
03004	WebSpaceAlreadyExists	Przestrzeń internetowa o nazwie {0} już istnieje dla subskrypcji {1}.
03005	WebSpaceNotFound	Nie można odnaleźć przestrzeni {0} internetowej dla subskrypcji {1}
03006	WebSpaceContainsResources	Przestrzeń internetowa zawiera zasoby.
03007	FileStorageLimit	Pojemność magazynu plików przekracza limit.
03008	WebSpaceDeleteError	Nie można usunąć obszaru {0}internetowego: {1}
03009	NoWorkersAvailable	Za mało dostępnych serwerów wystąpień w warstwie Standardowa, aby spełnić to żądanie.
03010	WebSpaceCreateError	Nie można utworzyć miejsca {0} internetowego na woluminie {1}magazynu: {2}

Witryna — 04xxx

Kod błędu rozszerzonego	Typ błędu	Szablon komunikatu o błędzie lub komunikatu o błędzie
04001	DirectoryAlreadyExists	Katalog już istnieje dla witryny {0}.
04002	DirectoryDeleteError	Nie można usunąć katalogu {0}.
04003	InvalidHostName	Nieprawidłowa nazwa {0}hosta .
04004	InvalidNumberOfWorkers	Wartość NumberOfWorkers musi być większa niż zero.
04005	HostNameAlreadyExists	Nazwa hosta "{0}" już istnieje.
04006	InvalidCustomHostNameValidation	Brak nazwy CNAME wskazującej z {0} lokacji w domyślnej strefie DNS (lub zbyt wiele).
04007	InvalidCustomHostNameValidationNoBaseHostName	Nie ma żadnych nazw hostów, których można użyć do walidacji.
04008	SiteAlreadyExists	Witryna o nazwie {0} już istnieje.
04009	SiteNotFound	Nie można odnaleźć witryny {0}.
04010	InvalidExternalUriHeader	Zewnętrzny adres URL \{0}\ określony w nagłówku żądania \{1}\ jest nieprawidłowy.
04011	FileDeleteError	Nie można usunąć pliku {0}.
04012	NumberOfWorkersPerSiteLimit	Liczba procesów roboczych dla tej witryny przekracza dozwoloną maksymalną liczbę procesów roboczych.
04013	TraceWebSiteStorageVolume	WebSiteManager.CreateWebSite: tworzenie witryny przy użyciu elementu storageVolume {0}.

Repozytorium — 05xxx

Kod błędu rozszerzonego	Typ błędu	Szablon komunikatu o błędzie lub komunikatu o błędzie
05001	RepositoryDeleteError	Nie można usunąć repozytorium o nazwie {0}.
05002	RepositoryDevSiteAlreadyExists	Witryna deweloperów już istnieje w repozytorium witryny {0}.
05003	RepositoryDevSiteNotExist	Witryna deweloperów nie istnieje w repozytorium witryny {0}.
05004	RepositorySiteAlreadyExists	Witryna {0} ma już utworzone repozytorium.
05005	RepositorySiteNotExist	Repozytorium nie istnieje dla witryny {0}.
05006	TraceFailedToCreateDevSite	Nie można utworzyć lokacji programistycznej.

Publikowanie — 06xxx

Kod błędu rozszerzonego	Typ błędu	Szablon komunikatu o błędzie lub komunikatu o błędzie
06001	AuthenticationdFailed	Użytkownik {0} został odrzucony.
06002	AuthenticatedPassed	Użytkownik {0} został pomyślnie uwierzytelniony.
06003	AuthorizationFailed	Użytkownik {0} został odrzucony.
06004	AuthorizationPassed	Użytkownik {0} został autoryzowany.
06005	PublishingCredentialsNotTrimmed	Poświadczenia publikowania muszą być przycięte z białych znaków.
06006	PublishingPasswordIsEmpty	Hasło publikowania nie może być puste.
06007	PublishingPasswordNotSpecified	Należy określić hasło publikowania.
06008	PublishingUserNameAlreadyExists	Nazwa użytkownika {0} publikowania jest już używana. Określ inną nazwę użytkownika publikowania.
06009	PublishingUserNameIsEmpty	Nazwa użytkownika publikowania nie może być pusta.

Kody błędów geomastera

GeoMaster — ogólny — 51xxx

Rozszerzony kod błędu	Typ błędu	Szablon komunikatu o błędzie lub komunikatu o błędzie
51001	BłądDodawanie	Wystąpił błąd podczas dodawania {0} wpisu: {1}
51002	BłądDeleting	Wystąpił błąd podczas usuwania {0} wpisu: {1}
51003	BłądUpdating	Wystąpił błąd podczas aktualizowania {0} wpisu: {1}
51004	CannotFindEntity	Nie można odnaleźć {0} elementu o nazwie {1}.

GeoMaster — subskrypcja — 52xxx

Kod błędu rozszerzonego	Typ błędu	Szablon komunikatu o błędzie lub komunikatu o błędzie
52001	SubscriptionConflict	Subskrypcja o określonej nazwie już istnieje.
52002	SubscriptionNonEmpty	Nazwa indeksu dolnego nie może mieć wartości null ani być pusta.
52003	SubscriptionNotFound	Nie można odnaleźć subskrypcji {0} .
52004	SubskrypcjaSuspended	Subskrypcja {0} jest zawieszona.
52005	NonEmptySubscription	Subskrypcja zawiera przestrzenie internetowe.

GeoMaster — przestrzeń internetowa — 53xxx

Rozszerzony kod błędu	Typ błędu	Szablon komunikatu o błędzie lub komunikatu o błędzie
53001	WebSpaceConflict	Przestrzeń internetowa o określonej nazwie już istnieje.
53002	WebSpaceNonEmpty	Nazwa przestrzeni sieci Web nie może mieć wartości null ani być pusta.
53003	NonEmptyWebSpace	WebSpace zawiera witryny sieci Web.
53004	ErrorPickingStamp	Wystąpił błąd podczas wybierania sygnatury dla przestrzeni {0}internetowej .

GeoMaster — witryna — 54xxx

Rozszerzony kod błędu	Typ błędu	Szablon komunikatu o błędzie lub komunikatu o błędzie
54001	WebSiteConflict	Witryna sieci Web o podanej nazwie {0} już istnieje w określonej subskrypcji i przestrzeni internetowej.
54002	WebSiteNonEmpty	Nazwa witryny sieci Web nie może mieć wartości null ani być pusta.
54003	HostNameConflict	Określona nazwa {0} hosta jest już zajęta przez inną witrynę.

Zobacz też

interfejs API REST usługi Windows Azure Pack Websites

Udostępnij za pośrednictwem