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

 

Aplica-se a: Windows Azure Pack

As operações de API REST para a API de Gerenciamento de Serviço retornam códigos de status HTTP padrão, conforme definido nas definições de código de status HTTP/1.1 em http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html.

Além dos códigos de status HTTP padrão, a API de Gerenciamento de Serviços retorna códigos de erro estendidos e mensagens de erro. Os códigos estendidos não substituem os códigos de status HTTP padrão, mas fornecem informações adicionais e acionáveis que podem ser usadas com os códigos de status padrão de HTTP. Por exemplo, um erro HTTP 404 pode ocorrer por vários motivos; portanto, as informações adicionais na mensagem estendida podem ajudar na resolução de problemas.

O exemplo de pergunta e resposta a seguir mostra o formato das informações de erro estendidas no corpo da resposta.

Exemplo

Um usuário emite uma solicitação HTTP GET no formato a seguir em um site chamado Fabrikam, que não existe.

https://management.core.windows.net/\ <Subscription-ID>/services/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 a seguir descreve os elementos-chave na mensagem estendida.

Nome do elemento	Descrição
Código	A cadeia de caracteres de texto do código de status HTML padrão relevante sem espaços.
Mensagem	O texto da mensagem de erro estendida fornecida ao usuário.
ExtendedCode	Um código de erro estendido, que é um valor numérico exclusivo para esse tipo de erro. Para obter uma lista de códigos estendidos, consulte as tabelas na seção a seguir "Códigos de erro estendidos".
MessageTemplate	Um modelo da mensagem real que é apresentado ao usuário, com os espaços que são preenchidos com informações do elemento Parameters.
Parâmetros	Um contêiner de cadeia de caracteres que preenche os espaços reservados no modelo de mensagem. Essas cadeias de caracteres contêm informações exclusivas do cenário do usuário.

Códigos de erro estendidos

As tabelas a seguir listam os códigos de erro estendidos.

Genérico - 01xxx

Código de erro estendido	Tipo de erro	Mensagem de erro ou modelo de mensagem de erro
01001	AccessDenied	O acesso foi negado.
01002	CommandResourceNotPresent	O objeto do recurso do comando não está presente no corpo da solicitação.
01003	InvalidName	Nome {0}inválido.
01004	UnknownCommandVerb	Não é possível entender o verbo {0}de comando.
01005	IsInReadOnlyMode	O serviço está atualmente no modo de leitura somente.
01006	ParameterIsNotSpecified	O {0} parâmetro não é especificado.
01007	InvalidParameterValue	O parâmetro {0} tem um valor inválido.
01008	InvalidRequest	{0} o objeto não está presente no corpo da solicitação.
01009	IncorrectDateTimeRange	O valor De na cadeia de caracteres da consulta é maior ou igual ao valor.
01010	RequiredParameterMissing	O parâmetro {0} necessário está ausente.
01011	ResourceNameCannotChange	Nome da cota da Web não pode ser alterado.
01012	FailedToConvertParameterValue	O valor do parâmetro da cadeia de caracteres da consulta não pode ser convertido para Booleano.
01013	ParameterNameAlreadyExists	O parâmetro com nome {0} já existe na solicitação.
01014	ParameterNameIsEmpty	O nome do parâmetro não pode ficar vazio.
01015	NotReady	Não está pronto.
01016	Ready	Ready
01017	UpdateForFieldNotAllowed	A atualização não é permitida para o {0} campo.
01018	NotSupportedCommand	O Serviço Web não dá suporte ao Comando {0}. Somente comando suportado é {1}.
01019	InvalidData	Dados inválidos ({0}).
01020	GenericConflict	Houve um conflito. {0}
01021	InternalServerError	Ocorrido erro de servidor interno. {0}

Webspace - 03xxx

Código de erro estendido	Tipo de erro	Mensagem de erro ou modelo de mensagem de erro
03001	NumberOfSitesLimit	O número de sites excede o máximo permitido.
03002	NumberOfWorkersLimit	NumberOfWorkers excede o máximo permitido.
03003	NoStorageVolumeAvailable	Espaço insuficiente no disco.
03004	WebSpaceAlreadyExists	O WebSpace com nome {0} já existe para assinatura {1}.
03005	WebSpaceNotFound	Não é possível localizar o webspace {0} para assinatura {1}
03006	WebSpaceContainsResources	Espaço da Web contém recursos.
03007	FileStorageLimit	A capacidade de armazenamento de arquivo excede o limite.
03008	WebSpaceDeleteError	Falha ao excluir espaço {0}na Web: {1}
03009	NoWorkersAvailable	Sem servidores de instância padrão suficientes disponíveis para atender a essa solicitação.
03010	WebSpaceCreateError	Falha ao criar espaço {0} na Web no volume {1}de armazenamento: {2}

Site - 04xxx

Código de erro estendido	Tipo de erro	Mensagem de erro ou modelo de mensagem de erro
04001	DirectoryAlreadyExists	O diretório já existe para o site {0}.
04002	DirectoryDeleteError	Falha ao excluir o diretório {0}.
04003	InvalidHostName	Nome {0}do host inválido.
04004	InvalidNumberOfWorkers	O valor NumberOfWorkers deve ser maior que zero.
04005	HostNameAlreadyExists	O nome do host '{0}' já existe.
04006	InvalidCustomHostNameValidation	Nenhum CNAME apontando para {0} um site em uma zona DNS padrão (ou muitos).
04007	InvalidCustomHostNameValidationNoBaseHostName	Não há hostnames para serem usados para validação.
04008	SiteAlreadyExists	Site com nome {0} já existe.
04009	SiteNotFound	Não é possível localizar o site {0}.
04010	InvalidExternalUriHeader	A URL externa \{0}\ especificada no cabeçalho da solicitação \{1}\ é inválida.
04011	FileDeleteError	Falha ao excluir o arquivo {0}.
04012	NumberOfWorkersPerSiteLimit	O número de trabalhadores para esse sites excede o máximo permitido.
04013	TraceWebSiteStorageVolume	WebSiteManager.CreateWebSite: Criando Site usando storageVolume {0}.

Repositório - 05xxx

Código de erro estendido	Tipo de erro	Mensagem de erro ou modelo de mensagem de erro
05001	RepositoryDeleteError	Não é possível excluir o repositório com o nome {0}.
05002	RepositoryDevSiteAlreadyExists	O site de desenvolvimento já existe no repositório do site {0}.
05003	RepositoryDevSiteNotExist	O site de desenvolvimento não existe no repositório do site {0}.
05004	RepositorySiteAlreadyExists	O site {0} já tem repositório criado para ele.
05005	RepositorySiteNotExist	O repositório não existe para o site {0}.
05006	TraceFailedToCreateDevSite	Falha ao criar um site de desenvolvimento.

Publicando - 06xxx

Código de erro estendido	Tipo de erro	Mensagem de erro ou modelo de mensagem de erro
06001	AuthenticatedFailed	O usuário {0} foi rejeitado.
06002	AuthenticatedPassed	O usuário {0} foi autenticado com êxito.
06003	AuthorizationFailed	O usuário {0} foi rejeitado.
06004	AuthorizationPassed	O usuário {0} foi autorizado.
06005	PublishingCredentialsNotTrimmed	As credenciais de publicação devem ser cortadas dos caracteres em branco.
06006	PublishingPasswordIsEmpty	A senha de publicação não pode estar vazia.
06007	PublishingPasswordNotSpecified	A senha de publicação deve ser especificada.
06008	PublishingUserNameAlreadyExists	O nome {0} de usuário de publicação já é usado. Especifique um nome de usuário de publicação diferente.
06009	PublishingUserNameIsEmpty	O nome do usuário de publicação não pode estar vazio.

Códigos de erro GeoMaster

GeoMaster - Genérico - 51xxx

Código de erro estendido	Tipo de erro	Mensagem de erro ou modelo de mensagem de erro
51001	ErrorAdding	Ocorreu um erro ao adicionar a {0} entrada: {1}
51002	ErrorDeleting	Ocorreu um erro ao excluir a {0} entrada: {1}
51003	ErrorUpdating	Ocorreu um erro ao atualizar a {0} entrada: {1}
51004	CannotFindEntity	Não é possível encontrar {0} com o nome {1}.

GeoMaster - Assinatura - 52xxx

Código de erro estendido	Tipo de erro	Mensagem de erro ou modelo de mensagem de erro
52001	SubscriptionConflict	Assinatura com nome especificado já existe.
52002	SubscriptionNonEmpty	O nome da assinatura não pode ser nulo ou vazio.
52003	SubscriptionNotFound	Assinatura {0} não encontrada.
52004	SubscriptionSuspended	A assinatura {0} está suspensa.
52005	NonEmptySubscription	Assinatura contém WebSpaces.

GeoMaster - Webspace - 53xxx

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

GeoMaster - Site - 54xxx

Código de erro estendido	Tipo de erro	Mensagem de erro ou modelo de mensagem de erro
54001	WebSiteConflict	O site com determinado nome {0} já existe na Assinatura e no Webspace especificados.
54002	WebSiteNonEmpty	O nome WebSiteName não pode ser nulo ou vazio.
54003	HostNameConflict	O nome {0} do host especificado já é tomado por outro site.

Consulte Também

Windows API REST do Serviço de Sites do Azure Pack