Códigos de erro (Serviço de Web Sites REST API)

 

Aplica-se a: Windows Azure Pack

REST Operações API para a norma de retorno da API de gestão de serviços CÓDIGOS DE ESTADO HTTP, tal como definido nas Definições do Código de Estado HTTP/1.1 em http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html.

Além dos códigos de estado HTTP padrão, a API de Gestão de Serviços devolve códigos de erro alargados e mensagens de erro. Os códigos estendidos não substituem os códigos de estado HTTP padrão, mas fornecem informações adicionais e accuais que podem ser utilizadas em conjunto com os códigos de estado HTTP padrão. Por exemplo, um erro HTTP 404 pode ocorrer por inúmeras razões; por conseguinte, as informações adicionais na mensagem estendida podem ajudar na resolução de problemas.

O seguinte exemplo de pedido e resposta mostra o formato das informações de erro estendidas no organismo de resposta.

Exemplo

Um utilizador emite um pedido HTTP GET no seguinte formato contra um site chamado Fabrikam, que não existe.

https://management.core.windows.net/\ <ID> de subscrição/serviços/WebSpaces/<WebSpaceName>/sites/Fabrikam

O exemplo a seguir mostra a resposta.

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>

A tabela seguinte descreve os elementos-chave na mensagem estendida.

Nome do elemento	Descrição
Código	A cadeia de texto do código de estado HTML padrão relevante sem espaços.
Mensagem	O texto da mensagem de erro estendida que é fornecida ao utilizador.
Código Estendido	Um código de erro estendido, que é um valor numérico que é exclusivo deste tipo de erro. Para obter uma lista de códigos estendidos, consulte as tabelas na secção seguinte "Códigos de Erro Alargados".
MensagemTemplate	Um modelo da mensagem real que é apresentado ao utilizador, com os detentores de lugares que são preenchidos com informações a partir do elemento Parâmetros.
Parâmetros	Um recipiente para cordas que preenchem os suportes de lugar no modelo de mensagem. Estas cordas contêm informações únicas ao cenário do utilizador.

Códigos de erro alargados

As tabelas a seguir enumeram os códigos de erro alargados.

Genérico - 01xxx

Código de erro alargado	Tipo de erro	Modelo de mensagem de erro ou de erro
01001	AcessoDenied	O acesso é negado.
01002	CommandResourceNotPresent	O objeto de recurso de comando não está presente no organismo de pedido.
01003	Nome invalido	Nome {0}inválido .
01004	DesconhecidoCommandVerb	Não consigo compreender o verbo de {0}comando.
01005	IsInReadOnlyMode	O serviço está atualmente apenas em modo de leitura.
01006	ParâmetroS Não Éspecizado	O {0} parâmetro não está especificado.
01007	InvalidParameterValue	O parâmetro {0} tem valor inválido.
01008	InáduloRequest	{0} objeto não está presente no corpo de pedido.
01009	IncorretoDateTimeRange	O valor do valor na cadeia de consulta é maior ou igual ao valor.
01010	Parametrómetro necessário	O parâmetro {0} necessário está em falta.
01011	RecursosNameCanotChange	O nome da quota web não pode ser alterado.
01012	Falha na Comparação DeParameter	O valor do parâmetro de cadeia de consulta não pode ser convertido para Boolean.
01013	ParâmetroNameAlreadyExists	Parâmetro com nome {0} já existe no pedido.
01014	Nome de Parâmetros Emmpty	O nome do parâmetro não pode estar vazio.
01015	NotReady	Não está pronto.
01016	Pronto	Pronto
01017	UpdateForFieldNotAllowed	A atualização não é permitida para o {0} campo.
01018	NotSupportedCommand	O Serviço Web não suporta o Comando {0}. Apenas os comandos suportados são {1}.
01019	InvalidData	Dados inválidos ({0}).
01020	Conflito Genérico	Houve um conflito. {0}
01021	InternalServerError	Ocorreu um erro interno do servidor. {0}

Webspace - 03xxx

Código de erro alargado	Tipo de erro	Modelo de mensagem de erro ou de erro
03001	NúmeroOfSitesLimit	O número de sites excede o máximo permitido.
03002	NúmeroOfWorkersLimit	O númeroofWorkers excede o máximo permitido.
03003	NoStorageVolume Disponível	Não há espaço suficiente no disco.
03004	WebSpaceAlreadyExists	WebSpace com nome {0} já existe para subscrição {1}.
03005	WebSpaceNotFound	Não é possível encontrar espaço {0} web para subscrição {1}
03006	WebSpaceContainsResources	O espaço web contém recursos.
03007	FileStorageLimit	A capacidade de armazenamento de ficheiros excede o limite.
03008	WebSpaceDeleteError	Falha na eliminação do espaço {0}web: {1}
03009	NoWorkers Disponível	Não há servidores standard instance disponíveis suficientes para satisfazer este pedido.
03010	WebSpaceCreateError	Falhou na criação de espaço {0} web no volume {1}de armazenamento: {2}

Site - 04xxx

Código de erro alargado	Tipo de erro	Modelo de mensagem de erro ou de erro
04001	DirectórioAlreadyExists	O diretório já existe para o site {0}.
04002	DirectoryDeleteError	Não conseguiu apagar o diretório {0}.
04003	InvalidHostName	Nome {0}de anfitrião inválido .
04004	InvalidNumberOfWorkers	O valor dos Trabalhadores deve ser superior a zero.
04005	HostNameAlreadyExists	O nome de anfitrião já{0} existe.
04006	InvalidCustomHostNameValidation	Não há CNAME a {0} apontar para um site numa zona de DNS predefinido (ou demasiados).
04007	InvalidCustomHostNameValidationNoBaseHostName	Não existem hostnames que possam ser usados para validação.
04008	SiteAlreadyExists	Site com nome {0} já existe.
04009	SiteNotFound	Não consigo encontrar o local {0}.
04010	InvalidExternalUriHeader	O URL externo \{0}\ especificado no cabeçalho de pedido \{1}\ é inválido.
04011	FileDeleteError	Não eliminou o ficheiro {0}.
04012	NúmeroOfWorkersPerSiteLimit	O número de trabalhadores para este site excede o máximo permitido.
04013	TraceWebStorageVolume	WebSiteManager.CreateWebSite: Criar Site utilizando o armazenamentoVolume {0}.

Repositório - 05xxx

Código de erro alargado	Tipo de erro	Modelo de mensagem de erro ou de erro
05001	RepositoryDeleteError	Não é possível eliminar o repositório com o nome {0}.
05002	RepositoryDevSiteAlreadyExists	O local de desenvolvimento já existe no repositório para o local {0}.
05003	RepositórioDevSiteNotExist	O local de desenvolvimento não existe no repositório do local {0}.
05004	RepositorySiteAlreadyExists	O site {0} já tem repositório criado para ele.
05005	RepositorySiteNotExist	O repositório não existe para o local {0}.
05006	TraceFailedToCreatedevsite	Falhou na criação de um local de desenvolvimento.

Publicação - 06xxx

Código de erro alargado	Tipo de erro	Modelo de mensagem de erro ou de erro
06001	AutenticadoFailado	O utilizador {0} foi rejeitado.
06002	Autenticado	O utilizador {0} foi autenticado com sucesso.
06003	Autorizações Destruídas	O utilizador {0} foi rejeitado.
06004	AutorizaçãoPassada	O utilizador {0} foi autorizado.
06005	PublicaçõesCredentialsNotTrimmed	As credenciais de publicação têm de ser aparadas de caracteres brancos.
06006	PublicaçãoPasswordIsEmpty	A palavra-passe de publicação não pode estar vazia.
06007	PublicaçãoPasswordNotSpecified	A palavra-passe de publicação deve ser especificada.
06008	PublishingUserNameAlreadyExists	O nome de utilizador {0} da publicação já está utilizado. Especifique um nome de utilizador de publicação diferente.
06009	PublicaçãoUserNameIsEmpty	A publicação do nome de utilizador não pode ser vazia.

Códigos de erro GeoMaster

GeoMaster - Genérico - 51xxx

Código de erro alargado	Tipo de erro	Modelo de mensagem de erro ou de erro
51001	ErrorAdding	Ocorreu um erro ao adicionar a {0} entrada: {1}
51002	ErroDeleting	Ocorreu um erro ao apagar a {0} entrada: {1}
51003	ErroUpdating	Ocorreu um erro ao atualizar a {0} entrada: {1}
51004	Não PodeFicar Entidade	Não consigo encontrar {0} com o nome {1}.

GeoMaster - Assinatura - 52xxx

Código de Erro Alargado	Tipo de Erro	Modelo de mensagem de erro ou mensagem de erro
52001	Conflict de subscrição	A subscrição com nome especificado já existe.
52002	SubscriçãoNonEmpty	Subscrição O nome não pode ser nulo ou vazio.
52003	SubscriçãoNotFound	Assinatura {0} não encontrada.
52004	SubscriçãoSpendida	A assinatura {0} está suspensa.
52005	Não-Subscrição DeSubscrevição	A subscrição contém WebSpaces.

GeoMaster - Webspace - 53xxxx

Código de erro alargado	Tipo de erro	Modelo de mensagem de erro ou de erro
53001	WebSpaceConflict	WebSpace com nome especificado já existe.
53002	WebSpaceNonEmpty	O Nome WebSpace não pode ser nulo ou vazio.
53003	NonEmptyWebSpace	O WebSpace contém web sites.
53004	ErrorPickingStamp	Ocorreu um erro ao escolher o Carimbo para o WebSpace {0}.

GeoMaster - Site - 54xxx

Código de erro alargado	Tipo de erro	Modelo de mensagem de erro ou de erro
54001	WebSiteConflict	O web site com nome {0} próprio já existe na subscrição especificada e no Espaço Web.
54002	WebSiteNonEmpty	WebSiteName não pode ser nula ou vazia.
54003	HostNameConflict	O nome {0} de anfitrião especificado já está tomado por outro site.

Consulte também

Windows Azure Pack Websites Service REST API