Corrigir erros do Validador do Swagger
Este artigo destaca os erros comuns de validação de swagger que podem surgir para Power Platform conectores e como corrigi-los.
Operações
| Error | Problema | Solução |
|---|---|---|
| ApiAnnotationExtensionReplacementInfo ForNonDeprecatedOperations |
The 'x-ms-api-annotation' extension for operation '{0}' is invalid. The replacement property should be specified for deprecated operations only. |
A operação {0} não está marcada como preterida. Para utilizar esta propriedade, a operação deve ter a propriedade "preterida" definida como true. Caso contrário, se não for esse o caso, remova a propriedade "x-ms-api-annotation". |
| ApiAnnotationExtensionReplacementInfo MissingApiProperty |
The 'x-ms-api-annotation' extension for operation '{0}' is invalid. The replacement property must specify 'api' property. |
A "x-ms-api-annotation" tem a propriedade de "substituição" especificada, mas a propriedade "api" está em falta. Para utilizar a propriedade "substituição", ambas as propriedades "api" e "operationId" têm de ser definidas. |
| ApiAnnotationExtensionReplacementInfo MissingOperationIdProperty |
The 'x-ms-api-annotation' extension for operation '{0}' is invalid. The replacement property must specify 'operationId' property. |
A "x-ms-api-annotation" tem a propriedade de "substituição" especificada, mas a propriedade "operationId" está em falta. Para utilizar a propriedade "substituição", ambas as propriedades "api" e "operationId" têm de ser definidas. |
| ArrayDuplicateValue | The array contains duplicate values, values must be unique. |
As matrizes têm de ter valores exclusivos, mas o seu swagger contém duplicados. Remova os duplicados. |
| BodyOrFormDataParameterInFetch OperationNotAllowed |
Body or form data parameters are not supported in a fetch operation. |
As operações que utilizam o método HTTP "GET" não podem ter dados de corpo ou de formulário. |
| ConnectionIdParameterNotAllowed | A parameter cannot be named as 'connectionId'. |
Mude o nome do parâmetro para um valor que não seja "connectionId". |
| ConsumesMissing | At least one supported MIME type must be provided in 'consumes' for operation '{0}'. |
O seu swagger deve especificar um tipo de MIME suportado em consumos para a operação. |
| DuplicateEnumValuesInExtension | The 'x-ms-enum-values' extension has duplicate values. You can only have one display name mapped to a value. |
Os valores Enum devem ser exclusivos e não duplicados. |
| DuplicateOperationPath | The operations '{0}' and '{1}' have the path templates '{2}' and '{3}' which are duplicate and indistinguishable. They need to have a difference in static path segments for a deterministic routing. |
{0} é o ID da operação, {1} é o ID da operação duplicada, {2} é o caminho da operação, {3} é o caminho da operação duplicada. Remova o ID da operação duplicada do caminho da operação duplicada. |
| DynamicExtensionDefinitionNotAllowed InParameter |
Dynamic extensions are not allowed to be defined on the body parameter. It should be in the schema. |
As extensões dinâmicas são definidas num parâmetro de corpo e têm de ser removidas. Só pode ser definido no esquema. |
| DynamicListExtensionRequiredFor AmbiguousReferences |
The 'x-ms-dynamic-values' extension references ambiguous parameter references. You need to define the 'x-ms-dynamic-list' extension. |
"x-ms-dynamic-list" tem de ser definida. Mais informações: Como utilizar valores dinâmicos |
| DynamicListExtensionRequiredFor NonParameterReferences |
The 'x-ms-dynamic-values' extension references properties within parameters. You need to define the 'x-ms-dynamic-list' extension. |
"x-ms-dynamic-list" tem de ser definida. Mais informações: Como utilizar valores dinâmicos |
| DynamicPropertiesExtensionRequiredFor AmbiguousReferences |
The 'x-ms-dynamic-schema' extension references ambiguous parameter references. You need to define the 'x-ms-dynamic-properties' extension. |
"x-ms-dynamic- properties" tem de ser definida. Mais informações: Como utilizar valores dinâmicos |
| DynamicPropertiesExtensionRequiredFor NonParameterReferences |
The 'x-ms-dynamic-schema' extension references properties within parameters. You need to define the 'x-ms-dynamic-properties' extension. |
"x-ms-dynamic- properties" tem de ser definida. Mais informações: Como utilizar valores dinâmicos |
| DynamicPropertiesExtensionRequiredFor PropertiesValuePath |
The 'x-ms-dynamic-schema' extension property 'value-path' points to schema properties. You need to define the 'x-ms-dynamic-properties' extension, which points to schema object. |
O seu ficheiro de swagger não tem "x-ms-dynamic-properties", o que é obrigatório, uma vez que define um "x-ms-dynamic-schema". |
| DynamicPropertiesItemValue PathMismatch |
The 'x-ms-dynamic-properties' extension should have the same item value path as 'x-ms-dynamic-schema' extension without 'properties' ending. The expected path is '{0}'. |
O caminho do valor do item de extensão de propriedades dinâmicas não corresponde ao caminho esperado com base no esquema. |
| DynamicTreeExtensionMissing | The 'x-ms-dynamic-tree' extension must be defined to enable file picker support. |
Falta a propriedade "x-ms-dynamic-tree" e tem de ser definida para suportar o seletor de ficheiros. |
| InvalidEnumValue | The type of the enum value is '{0}' but it should be '{1}' as specified in the schema. |
O valor tem de ser substituído para ser do tipo especificado. |
| InvalidEnumValuesExtensionValue | The 'value' field must match one of the enums as defined in the 'enum' property of the schema. |
O enumeração selecionado não foi definido na lista de enums. Ou define o valor na propriedade de enumeração ou utiliza um valor definido na propriedade de enumeração. |
| InvalidFormDataParameterName | The form data parameter name '{0}' is invalid. All characters must be part of the US-ASCII character set. |
Mude o nome do parâmetro de dados do formulário para incluir apenas carateres US-ASCII. |
| InvalidNextLinkNameValue | The nextLinkName value for operation '{0}' is invalid. Supported values are 'nextLink' or '@odata.nextLink'. |
Corrija o valor da propriedade 'nextLinkName' para que seja 'nextLink' ou '@odata.nextLink'. Quaisquer outros valores não são permitidos. |
| InvokedOperationShouldProduceArray | The dynamic operation expects an array on the specified path '{0}' which should be defined in the successful response of the invoked operation '{1}'. |
{0} é o caminho para uma propriedade de resposta, {1} é o ID da operação. Defina dentro da resposta da operação um regresso de tipo matriz. |
| InvokedOperationShouldProduceProperty | The dynamic operation expects a property on the specified path '{0}' which should be defined in the successful response of the invoked operation '{1}'. |
{0} é o caminho para uma propriedade de resposta, {1} é o ID da operação. Defina dentro da resposta da operação um propriedade específica |
| MimeTypeNotCompatibleWithRequest ContentSchemaType |
The MIME type(s) are not compatible with the request content type '{0}' for operation '{1}'. |
O tipo de MIME que você está tentando usar não é compatível com o conteúdo da sua solicitação na operação especificada. |
| NotificationExtensionNotSupportedIn WebhookOperation |
The 'x-ms-notification' extension must not be defined in a webhook operation. |
A utilização de "x-ms-notification" não é permitida numa operação webhook. |
| NotificationExtensionSupportedFor TriggerOnly |
The 'x-ms-notification' is supported for trigger operations only. |
A extensão "x-ms-notification" só pode ser utilizada para operações de acionador. |
| NotificationOperationMustBeWebhook | The 'operationId' property in 'x-ms-notification' extension must be for a webhook operation. |
Quando você usa "x-ms-notification", o ID da operação deve se referir a uma operação webhook. |
| OperationFamilyHasDuplicateRevisions | The operation family '{0}' has operations with duplicate revision. |
O seu swagger define uma família de operações com o mesmo número de versão/revisão. Cada operação numa família de operações deve ter um número de versão único. |
| OperationFamilyHasManyActive Operações |
The operation family '{0}' has more than two active operations. Extra operations must be deprecated. |
As famílias de operações estão limitadas a duas operações não obsoletas. Quaisquer outros devem ser marcados como preteridos para reduzir a confusão para o utilizador do seu conector. |
| OperationFamilyHasManyActive ProductionOperations |
The operation family '{0}' has several active operations in Production status. Previous revisions should be deprecated. |
Uma família de operações tem múltiplas operações em produção. Para reduzir a confusão, terá de limitar o número de operações de produção numa família e preterir as restantes. |
| OperationFamilyHasManyEmptyRevisions | The operation family '{0}' has several operations with empty revision. Only one operation can have empty revision. |
As famílias de operações só podem ter uma operação sem uma revisão. Todos os outros na família devem ter uma revisão. |
| OperationHasManyResponsesWithSchema | The operation '{0}' has more than one response with specified schema, only one schema will be used in the designer. |
As limitações no estruturador impedem vários esquemas de resposta. A sua operação especifica vários, mas deve especificar apenas um. |
| OperationIdNotFound | The 'operationId' could not be found in this swagger document. |
Não foi possível encontrar operationId no seu swagger. |
| OperationIdNotUnique | The operationId '{0}' is used multiple times. Operation identifiers must be unique. |
O mesmo operationId aparece mais do que uma vez. Remova uma das instâncias ou corrija uma das instâncias para que seja diferente. |
| OperationIdRequired | The operation 'operationId' property is required. |
A propriedade "operationId" está em falta, incluindo a propriedade "operationId" para a sua operação. |
| OperationIdSanitized | The 'operationId' property value is different from its sanitized value '{0}'. Please avoid the useage of non-alphanumeric characters to have matching values. |
O ID da operação fornecido não corresponde à versão limpa. Atualize o ID da operação para que corresponda. |
| OperationIdShouldEndWithRevision | The operation Id '{0}' should end with revision suffix '{1}'. |
Os IDs de operação com uma revisão devem ter um nome com o sufixo de revisão. |
| OperationIdTooLong | The operationId length must be less than '{0}'. |
Reduza o valor da propriedade "operationId" de modo que o comprimento do caráter seja inferior a {0}. |
| OperationMissingPathParameter | The operation '{0}' does not define the '{1}' parameter which is required by the path. |
Seu swagger tem uma operação que não define um parâmetro que parece ser exigido por seu modelo de caminho. |
| OperationMissingRequiredProperty | The target operation requires parameter '{0}'. |
A operação tem o parâmetro '{0}' definido como necessário, mas isso não está definido nos parâmetros fornecidos. Adicione este parâmetro para corrigir o problema. |
| OperationMustHaveNotification ContentExtension |
The operation '{0}' is missing notification content extension as it has '{1}' properties marked as notification URL. |
O seu swagger contém uma operação que não tem qualquer extensão de conteúdo de notificação. (Necessita de mais contexto) |
| OperationMustHaveResponse | The operation is not valid, it must contain at least one response definition. |
O seu swagger tem uma operação que não tem pelo menos uma definição de resposta. |
| OperationParameterNameIsAmbiguous | The parameter name is ambiguous as it matches both a parameter name and a path to a body property. |
O nome do parâmetro é usado como um nome de parâmetro e um nome do caminho de corpo do parâmetro. Mude o nome de uma das instâncias para resolver este problema. |
| OperationParameterNameNotFound | The parameter could not be found in operation '{0}' in the swagger document. |
Não foi possível encontrar o nome do parâmetro da operação no seu swagger. |
| OperationParameterRequiredMismatch | The parameter is required, but an optional value is provided by operation '{0}'. The request cannot be made until a value for this parameter is provided. |
O parâmetro é necessário, mas o valor da operação indica que ele é opcional, causando essa incompatibilidade. |
| OperationParametersAreNotUnique | The parameters in the operation '{0}' are not unique. |
Parece haver um duplicado dentro dos parâmetros da operação. O seu swagger precisa de remover duplicados dos parâmetros de operação. |
| OperationParametersContain DuplicateParameter |
The operation '{0}' contains duplicate parameters with name '{1}', location '{2}'. |
Há um parâmetro operacional que está sendo listado duas vezes. {0} é o nome da operação, {1} é o nome do parâmetro duplicado, {2} é a localização do parâmetro duplicado (propriedade "in" no swagger). Remova a recorrência da propriedade. |
| OperationParametersContain MultipleBodyParameters |
The operation '{0}' contains multiple parameters in the location 'body', at most one is allowed. |
Os parâmetros de operação contêm parâmetros de corpo duplicados. Remova um dos parâmetros de corpo. |
| OperationParameterStaticTypeMismatch | The parameter has type '{0}', but a static value is provided of type '{1}'. |
O parâmetro tem o tipo estático fornecido quando não é esperado para este parâmetro de operação. |
| OperationParameterTypeMismatch | The parameter has type '{0}', but operation '{1}' is providing a parameter of type '{2}'. |
O parâmetro e a operação têm tipos diferentes. Faça o tipo do seu parâmetro e a sua operação corresponderem. |
| OperationPathContainsUnsupportedCharacters | The operation path cannot contain wildcard character '*'. |
Uma de suas operações especifica um caminho de URL que contém caracteres sem suporte (como o símbolo curinga). |
| OperationPathMayNotContainQueryOrFragment | The path is not valid, it must not contain a query part or fragment identifier. To include '?' or '#' characters in the path, they must be URL encoded. |
O caminho da operação não pode conter "?" E '#', a menos que sejam codificados por URL (traduzidos para seus equivalentes %xx). |
| OperationPathMustStartWithSlash | The path is not valid, it must start with a '/' character. |
Se você usar um caminho de operação que está tentando alcançar, é necessário que ele comece com o caractere '/'. Para corrigir esse problema, inclua o caractere '/' no início do caminho. |
| OperationPathTemplateNotValid | The path is not valid, each path template variable enclosed by '{{' and '}}' characters must be contained within a single URL segment. Individual '{{' or '}}' characters which are not enclosing a path template variable must be URL encoded. |
O seu swagger contém um caminho de operação com um carateres "{" ou "}" não fechados. Esses carateres são usados para se referir a uma variável no caminho, por isso não podem existir no caminho quando não fechados. |
| OperationPathVariablesContainDefaults | The operation path template variables cannot set default values with character '='. |
Uma de suas operações é especificar um valor padrão para um parâmetro que contém "=". Este parâmetro também é especificado como estando no caminho do URL. Esta combinação não é permitida. |
| OperationRevisionEmpty | The operation '{0}' does not specify a revision in api annotation. |
A operação é marcada como parte de uma família, mas não tem uma revisão. |
| OperationSchemaCountExceedsMaxAllowed | The total number of schemas in the operation has exceeded the maximum allowed value of '{0}'. Please remove any unnecessary property or item definitions. |
Há demasiados esquemas na operação. Remova alguns deles para que o total esteja de volta abaixo do limite. |
| OperationShouldHaveSuccessfulResponse | The operation '{0}' should have at least one successful response definition. |
Seu swagger tem uma operação que não tem pelo menos uma definição de resposta bem-sucedida. |
| OperationStatusAheadOfConnector | The operation '{0}' cannot be in a Production status ahead of the connector. |
As operações não podem ser marcadas como "Produção" enquanto todo o conector ainda estiver em "pré-visualização". |
| OperationSummaryTooLong | The operation 'summary' should be fewer than {0} characters for improved readablity. |
Reduza a operação de propriedade "summary" para ser inferior a 120 carateres. |
| PartialDuplicateOperationPath | The operation '{0}' has the path template '{1}' which is similar to other operation path templates, this can lead to an unexpected routing to a different operation in case an input path parameter value matches to a static value segment. It is better to have unconditional routing in all cases. Partially duplicated paths are: {2} |
{0} é o ID da operação, {1} é o caminho da operação, {2} é o conjunto de caminhos de operação parcialmente duplicados. Altere o caminho da operação para criar uma diferença maior entre os caminhos de operação que partilham a semelhança. |
| PathParameterMustBeRequired | The parameter must be marked as required as it is used in the operation path. Include the 'required' property, with the value 'true'. |
A localização do parâmetro está definida para "path", pelo que precisa de ter a propriedade "required" definida como "true". |
| PathParameterNotDefinedInTemplate | The 'path' parameter '{0}' is not defined in the URI path template. To include the parameter as a variable in the path, use '{{' and '}}' characters to enclose the name of the parameter in the path. |
Há um parâmetro em uma de suas operações que está marcado como estando no caminho da operação, mas não existe no modelo de caminho. |
| PathParametersContain DuplicateParameter |
The path '{0}' contains duplicate parameters with name '{1}', location '{2}'. |
{0} é o caminho da operação. {1} é o nome do parâmetro duplicado. {2} é a localização (a propriedade "in2) do parâmetro duplicado. Remova o parâmetro de caminho duplicado. |
| PathParametersContainMultiple BodyParameters |
The path '{0}' contains multiple parameters in the location 'body', at most one is allowed. |
Não pode haver vários parâmetros para uma operação que estejam no corpo. Para corrigir esse erro, remova um dos parâmetros. |
| PathRedefined | The path '{0}' is defined multiple times with different capitalization. Paths must be unique when compared case-insensitively. |
O mesmo caminho é definido mais do que uma vez. Remova ou renomeie as instâncias para que sejam exclusivas. |
| RestrictedCharactersInSummary | Summary string contains any of the restricted characters [{0}] |
O resumo de uma das suas operações contém carateres restritos. Para corrigir esse erro, remova os caracteres ou reformule o resumo. |
| SelectedItemValuePathNotAllowedIn ThisPosition |
The 'selectedItemValuePath' property is not allowed in this position. It is allowed only in 'browse' operation of 'x-ms-dynamic-tree' extension. |
Onde quer que tenha colocado o "selectedItemValuePath" não é permitido. Remova-o ou coloque-o dentro de uma localização válida. |
| StringBinaryNotSupportedFor FormUrlEncoded |
String/binary parameters are not supported for operation '{0}' with 'application/x-www-form-urlencoded' consumes type. |
A operação tem o valor "application/x-www-form-urlencoded" definido na propriedade "consumes". Os parâmetros para esta operação não podem ser do tipo 'string' ou 'binário'. |
| TotalOperationsCountExceedsMaxAllowed | The total number of operations in the swagger exceeds the maximum allowed value of '{0}'. |
Há demasiadas operações no swagger. |
| UnrecognizedTypeFormat | The type/format '{0}' is not recognized. |
O tipo/formato "{0}" dado é desconhecido. Verifique se há erros ortográficos ou documentação para confirmar os formatos do tipo suportado. |
| WebhookOperationsMissingNotification UrlProperty |
The webhook operation '{0}' is missing notification URL property. |
Seu swagger contém uma operação webhook que não tem uma propriedade de URL de notificação ausente. A adição desta propriedade dentro da operação webhook corrige a operação. |
Matrizes
| Erro | Problema | Solução |
|---|---|---|
| ArrayHasNoItems | The array should have items specified. |
A matriz está vazia, mas não é permitida uma matriz vazia. |
| RequiredPropertyArrayEmpty | The 'required' array requires at least one value. If no properties are required in the schema, remove the 'required' property. |
Seu swagger tem uma matriz vazia para uma propriedade chamada 'required'. Deve ser removido se não houver parâmetros obrigatórios. |
| SchemesArrayEmpty | The 'schemes' array requires at least one value. |
Os esquemas não podem estar vazios e devem ter pelo menos um valor. |
Não suportado
| Erro | Problema | Solução |
|---|---|---|
| CollectionFormatValueNotSupported | The 'collectionFormat' keyword value '{0}' is not supported. |
Apenas certos formatos de coleção são suportados. O seu swagger contém um formato não suportado. |
| MimeTypeNotSupported | The MIME type '{0}' is not supported. The supported mime types are: '{1}'. |
O tipo de MIME que está a tentar usar no seu swagger não é suportado. |
| PathItemRefNotSuppored | The '$ref' property in a path is not supported. |
Um caminho não pode ter uma propriedade "$ref" definida. Remova esta propriedade. |
| SwaggerKeywordNotSupported | The '{0}' keyword is not supported. |
{0} é uma palavra-chave swagger como 'uniqueItems' e não é permitida no contexto em que está sendo usada. |
Parâmetros
| Error | Problema | Solução |
|---|---|---|
| FileParameterMustBeInFormData | Parameters of type 'file' are not valid in locations other than 'formData'. |
Seu swagger tem um parâmetro com um tipo de 'arquivo' e ele só pode estar 'em' o 'formData'. |
| ParameterListContainsFormDataAndBody | The 'parameters' list defines both a 'body' parameter, and a 'formData' parameter. Only one of these location types can be used in an operation. |
Seu swagger está definindo um parâmetro body e formData, o que não é permitido. Remova um destes tipos de parâmetros. |
| ParameterReferenceNotFound | The parameter reference '{0}' could not be found in the swagger document. |
O seu swagger tem uma referência de parâmetro que não pode ser encontrada no documento do swagger. Remova a referência a este parâmetro. |
| ParameterReferenceNotValid | The parameter reference '{0}' is not valid. Parameter references must start with '#/parameters/' and be valid JSON Pointers. |
Seu swagger tem uma referência de parâmetro ("#/parameters/"), que é inválida com base na especificação RFC do ponteiro JSON. |
| ParameterRefLoopNotAllowed | The parameter definition may not use a '$ref' to point to another definition. |
O seu swagger tem uma definição de parâmetro que está a usar incorretamente o "$ref" para apontar para outra definição. |
| ParamtersWithSameNameMustHave SameTypeAndVisibility |
Parameters of the same name in fetch and subscribe operations must be of the same type and visibility. |
Se o seu swagger tiver parâmetros com o mesmo nome nas operações obter e subscrever, devem ter o mesmo tipo e visibilidade. |
| PathParameterMissingEncoding | Encoding for path parameter '{0}' is missing, which might lead to invalid requests. Use "x-ms-url-encoding": "single" to ensure the value is URL encoded. |
{0} é o nome do parâmetro ao qual falta a codificação. |
| QueryParameterEncodingNotSupported | Encoding for query parameter '{0}' is not supported. All query parameters are single encoded by default. |
{0} é o nome do parâmetro que tem a codificação não suportada. Corrija esta codificação. |
| ReservedParameterIsUsed | The parameter '{0}' is reserved and cannot be used in '{1}'. |
O parâmetro indicado neste erro está a ser usado, mas não pode ser usado porque está reservado para essa secção ou em geral. |
| ResponseRefLoopNotAllowed | The response definition may not use a '$ref' to point to another definition. |
O seu swagger tem uma definição de resposta que está a usar incorretamente o "$ref" para apontar para outra definição. |
| SourcePropertyInternal | The parameter reference '{0}' in the source operation '{1}' is internal or one of its parent(s) are internal. Either make the property visible or update the parameter reference to a static value. |
A referência do parâmetro está marcada como interna, mas a operação onde a referência do parâmetro é usada não é interna. Para corrigir isso, atualize o parâmetro ou a operação. |
_Propriedades
| Error | Problema | Solução |
|---|---|---|
| AdditionalPropertyNotAllowed | The property '{0}' is not allowed and must be removed. |
Há uma propriedade extra em seu swagger que deve ser removida. |
| AdditionalPropertyNotAllowedAdjacent ToRef |
When '$ref' is defined, no other properties may be specified. |
Quando você usa '$ref' no swagger, nenhuma outra propriedade deve ser incluída nesse objeto JSON. |
| BasePathNotValid | The 'basePath' property, if present, must start with a '/' character. |
Se utilizar um caminho base, tem de começar por "/". Caminhos base inválidos se parecem com "abc/def/ghi" ou "microsoft.com/abc". |
| BodyParameterPropertyNotValid | The 'body' parameter cannot use property '{0}', instead, the 'schema' property should be used to define the type used by the parameter. |
Um dos parâmetros de corpo no seu swagger está a usar uma propriedade inválida que não pode ser usada num parâmetro de corpo. |
| ConnectorMetadataPropertiesMissing | The connector metadata property '{0}' is required. |
Determinados metadados são obrigatórios para o conector. |
| ContactEmailNotValid | The contact 'email' property, if present, must be a valid email address. |
O endereço de e-mail fornecido é um formato incorreto ou contém carateres não ASCII. |
| DefaultValueMustMatchType | The 'default' value is of type '{0}', but should match the given type '{1}'. |
O valor para o seu valor predefinido não é o mesmo tipo que o tipo dado. Altere o valor do valor predefinido para o do tipo dado para corrigir este problema. |
| EnumMustContainAtLeastOneElement | The 'enum' array requires at least one value. |
Se o seu tipo de propriedade for uma enumeração, deve especificar uma matriz com, pelo menos, um dos valores da enumeração. |
| ExtensionNameNotValid | The property '{0}' is not valid. If this property is an extension, its name must begin with "x-". |
As propriedades que são extensões têm de começar pelo prefixo "x-". |
| FilterFunctionsPropertyEmpty | The 'filterFunctions' property must have at least one element. |
A propriedade "filterFunctions" não pode ser vazia se especificada. |
| FilterFunctionsPropertyHasDuplicates | The 'filterFunctions' property cannot contain duplicates. |
A propriedade "filterFunctions" não pode conter duplicados. |
| FilterFunctionsPropertyInInputSchema | The 'filterFunctions' property has to be in the response schema. |
A propriedade "filterFunctions" só pode estar no esquema de resposta. |
| FilterFunctionsPropertyInvalidValue | The 'filterFunctions' property supports only these values: {0}". |
A propriedade "filterFunctions" não pode especificar um valor não suportado. |
| HostNameNotValid | The 'host' property, if present, must be a valid URI host without a scheme or path. |
Um URI de host sem um esquema ou caminho se parece com "www.microsoft.com". Um URI inválido para o host se parece com "https://www.microsoft.com/" ou "www.microsoft.com/hello" |
| InternalPropertyWithDefaultOptional | The internal property has a default value but is optional. Only required properties are guaranteed to be included in requests. |
Uma propriedade é marcada como interna, tem um valor predefinido especificado e não é obrigatório. Se você quiser garantir que isso esteja incluído nas solicitações, marque-o como necessário; caso contrário, se for essa a intenção, pode ser deixado como está. |
| InvalidConnectorCategory | The connector category is invalid. Available categories are: [{0}]. |
As categorias só podem vir da lista de valores de categoria permitidos. |
| InvalidStringBinaryProperty | A schema with type/format 'string/binary' can only be at the top level of a body or formData parameter. |
O valor da propriedade "type" e "format" de "string" e "binary" não é permitido neste esquema. |
| JsonTypeIncorrect | The type of the property is incorrect. Expected type '{0}', but value is of type '{1}'. |
Uma propriedade no seu swagger tem um tipo, mas o valor real é de um tipo diferente. Altere o tipo de valor para corresponder ao tipo esperado. |
| JsonValueNotInEnum | The property value must be one of the following: {0}. |
O valor da propriedade do enumeração não corresponde às opções disponíveis atualmente. Altere o valor para um dos seguintes indicados na mensagem de erro. |
| MimeTypeNotValid | The MIME type '{0}' is not valid. |
O "content type" MIME fornecido pelo utilizador que selecionou não é válido. Os tipos de MIME válidos são: "application/json" "text/plain" "multipart/form-data" "application/x-www-form-urlencoded" |
| MissingEnumValuesDisplayName | The 'x-ms-enum-values' extension is invalid. Please specify the property 'displayName'. |
Os x-ms-enum-values não especificaram a propriedade 'displayName'. |
| MultipleOfMustBeGreaterThanZero | The 'multipleOf' value must be greater than zero. |
O valor da propriedade "multipleOf" deve ser um valor superior a zero. |
| OneOfPropertiesRequired | At least one of the properties is required: [{0}]. |
{0} é um conjunto de propriedades. Este erro mostra todas as propriedades que precisam de estar presentes no swagger. |
| ProductionStatusOnBetaService | The connector cannot be in Production status on a beta service. |
O conector não pode ser marcado como "Produção" quando o serviço de back-end está em Beta. Deve ser definido como 'pré-visualização'. |
| PropertyMustBeRequired | The property is internal and has a default value, it must be required. Optional internal fields are ignored. |
A propriedade não está sendo definida, embora seja necessária. |
| RequiredPropertyDefinitionMissing | The required property '{0}' is not defined in the object schema. |
Uma propriedade de esquema é listada como "required" e, portanto, tem de ser definida em "properties" |
| RequiredPropertyMissing | The '{0}' property is required. |
Uma propriedade no seu swagger é obrigatória, mas não está no seu swagger. Para corrigir esse errador, inclua esta propriedade. |
| RequiredPropertyNotOnObject | The property 'required' is applicable to schemas with 'object' type only and should be removed. |
A propriedade "required" só é suportada para o tipo "object". Remova a propriedade para todos os outros tipos. |
| RequiredReadOnlyPropertyNotAllowed AsInput |
An input property cannot be 'readonly' and required. |
Seu swagger contém uma propriedade marcada como somente leitura e necessária. Uma propriedade readonly significa que o utilizador não pode modificar o valor. Uma propriedade required requer um valor para modificação. |
| SchemeNotValid | The 'schemes' property must only contain transfer protocols from the list: {0}. |
A propriedade do esquema deve ser uma de "http" ou "https". |
| SecuritySchemePropertyNotValid | The security definition property '{0}' is not valid for definitions of type '{1}'. |
Há um nome e um valor de propriedade que não são válidos que você incluiu no dicionário securityDefinitions. Para corrigir esse problema, altere essa propriedade para um nome de propriedade válido. |
| SecuritySchemePropertyRequired | The security definition property '{0}' is required for definitions of type '{1}'. |
Há um nome e um valor de propriedade necessários que não estão incluídos no dicionário securityDefinitions. Adicione esta propriedade e valor para corrigir este problema. |
| SpecificationVersionIncorrect | The 'swagger' property must have the string value "2.0". |
Apenas a versão "2.0" é suportada, por isso corrija a propriedade da versão do swagger para que seja "2.0". |
| TagRedefined | The 'tags' property defines tag '{0}' multiple times. |
As etiquetas definidas na propriedade "tags" têm de ser exclusivas. Remova ou substitua quaisquer ocorrências múltiplas. |
| TooManyConnectorCategories | The maximum allowed number of categories for the connector is '{0}'. |
Há um limite para o número de categorias que podem ser definidas para o conector. |
| UrlNotValid | The 'url' property must be a valid absolute URL. |
O seu swagger tem um URL inválido. Isto pode ser devido a copiar incorretamente o URL de algum lugar. |
Response
| Erro | Problema | Solução |
|---|---|---|
| BodyParameterSchemaRequired | The 'body' parameter must define a 'schema' property. |
No parâmetro do corpo, a propriedade do esquema tem de ser definida. Defina a propriedade do esquema para corrigir este problema. |
| BodySchemaCountExceedsMaxAllowed | The total number of schemas in the object exceeds the max schema count allowed value of '{0}'. Please remove any unnecessary property or item definitions. |
Há demasiados esquemas no objeto do corpo. Remova alguns deles para que o total esteja de volta abaixo do limite. |
| DefaultResponseHasSchema | The 'default' response should not have schema definition. Schemas should be defined on expected responses only. |
O seu swagger contém uma definição de esquema para a resposta predefinida. A remoção desta definição de esquema para a resposta predefinida corrige este erro. |
| InvalidCustomEditorExtension DictionaryValue |
The 'x-ms-editor' extension can be specified as 'dictionary' only for schema with type object and additional properties allowed. |
Verifique se o x-ms-editor está definido apenas para o dicionário quando o esquema é de tipo objeto e definido para propriedades adicionais permitidas. |
| JsonPointerNotValid | The JSON Pointer path is not valid. |
Uma referência (#ref) a ser usada no seu swagger não é válido. |
| NonBodyParameterSchemaNotValid | The parameter cannot define a schema as it is not in the 'body'. |
O seu swagger tem um parâmetro que usa "schema", mas apenas os parâmetros do corpo podem usar "schema". |
| RequiredLoopInSchemaNotAllowed | Loops of required schema properties are not allowed. |
A especificação de propriedades requeridas não pode usar ciclos de referência. |
| ResponseExampleMustBeProduced ByOperation |
The response example '{0}' is not produced by the operation '{1}'. |
Seu swagger tem uma operação com um resposta exemplo, mas essa mesma operação não produz um resposta com o tipo de MIME indicado. |
| ResponseHeadersAreNotUnique | The response headers are not unique. |
Há um cabeçalho resposta duplicado. Os cabeçalhos de resposta devem ser exclusivos. |
| ResponseMustBeDefaultOrHttpStatusCode | The response is not valid, the response must be a valid HTTP status code, or the string 'default'. |
Seu swagger não tem um código de status HTTP padrão ou um código de status HTTP válido. Adicione um código de estado à sua resposta. |
| ResponseReferenceNotFound | The response reference '{0}' could not be found in the swagger document. |
O seu swagger tem uma referência de resposta que não pode ser encontrada no documento do swagger. Remova a referência a esta resposta. |
| ResponseReferenceNotValid | The response reference '{0}' is not valid. Response references must start with '#/responses/' and be valid JSON Pointers. |
O seu swagger tem uma referência de resposta ("#/respostas/") que é inválida com base na especificação RFC do apontador JSON. |
| SchemaDefinitionSetIncorrectly | The operation '{0}' should define an output schema on the 200 or 201 response code or in 'x-ms-notification-content' extension for a webhook to be visible in the designer. |
Falta um esquema de resposta para o código à sua operação para o código de resposta 200 ou 201. Para os webhooks, o esquema de resposta deve ser especificado como parte da extensão do conteúdo da notificação. |
| SchemaReferenceNotFound | The schema reference '{0}' could not be found in the swagger document. |
Seu swagger tem uma referência de esquema que não pôde ser encontrada no documento swagger. |
| SchemaReferenceNotValid | The schema reference '{0}' is not valid. Schema references must start with '#/definitions/' and be valid JSON Pointers. |
O seu swagger tem uma referência de esquema ("#/definições/") que é inválida com base na especificação RFC do apontador JSON. |
| SchemaRefLoopNotAllowed | The schema definition may not use a '$ref' to point to another definition. |
Há um loop de referência em seu esquema (A aponta para B, que aponta de volta para A). |
| SchemaTooDeep | The schema exceeds the maximum allowed depth. Schemas must not exceed a depth of '{0}', including referenced ('$ref') schemas. |
Os esquemas estão limitados a uma profundidade JSON específica. Use um esquema menos profundo. |
| SchemaTypeFileNotValid | The schema type 'file' is not valid. Only parameters in 'formData' and the root response schema may be of type 'file'. |
A utilização do tipo de esquema "file" só é suportada em dados de formulário e tem de estar na raiz do esquema de resposta para a definição de resposta. |
| SchemeNotSupported | The WebSocket transfer protocol schemes are not supported. |
Este esquema não é suportado. Os esquemas suportados são Https e Http. |
| TotalSchemaCountExceedsMaxAllowed | The maximum allowed number of schemas in the swagger is '{0}'. Please remove any unnecessary property or item definitions. |
Há demasiados esquemas no swagger. |
Segurança
| Erro | Problema | Solução |
|---|---|---|
| OAuthSecurityRequirementValueMustBe ScopeName |
The OAuth security requirement '{0}' refers to scope name '{1}', but this is not defined in the 'securityDefinitions' object. |
Os nomes dos requisitos de segurança têm de ser um nome de âmbito definido no objeto de definições de segurança. |
| SecurityRequirementMustBeDefined | The security requirement '{0}' is not defined in the 'securityDefinitions' object. |
Um requisito de segurança é usado, mas não definido no dicionário de definições de segurança. |
| SecurityRequirementMustHaveEmptyValue | The security requirement '{0}' cannot specify any scopes, an empty array should be provided. |
Com base na configuração atual, os requisitos de segurança com o nome "{0}" têm de ser uma matriz vazia. |
| SecurityRequirementMustHaveValue | The security requirement '{0}' must have have a value. Provide an empty array if no OAuth scopes are required. |
O requisito de segurança está em falta ou é nulo. Se não forem requeridos âmbitos OAuth, especifique uma matriz vazia. |
Webhooks
| Erro | Problema | Solução |
|---|---|---|
| NotificationUrlNotAllowedInThisPosition | The notification URL property is not allowed in this position. It is allowed only in input body. |
A propriedade "x-ms-notification-url" só deve ser definida numa entrada. |
| NotificationUrlNotInternal | The notification URL property itself or at least one of its parents must be internal. |
O seu swagger não está a definir a propriedade URL de notificação para interna, o que deve ser o caso. |
| NotificationUrlNotRequired | The notification URL property must be required all the way through the schema chain. |
O seu swagger não está a requerer a propriedades URL de notificação, a qual deve ser requerida. |
| NotificationUrlNotString | The notification URL property must be of type string. |
A propriedade URL de notificação tem um valor que não é do tipo cadeia. |
Metadados
| Erro | Problema | Solução |
|---|---|---|
| AllowEmptyValueOnlyValidForQuery FormData |
The parameter cannot use the 'allowEmptyValue' keyword as it is not in the 'query' or 'formData' location. |
A propriedade "allowEmptyValue" só pode ser definida como "true" num parâmetro que tenha uma propriedade "location" que seja "query" ou "formData". O valor da propriedade "location" não é qualquer um dos casos. |
| DiscriminatorMustBeARequiredStringProperty | The 'discriminator' value must be the name of a required string property. |
O valor "discriminator" deve ser o nome de uma propriedade de cadeia requerida no seu swagger. |
| ExclusiveMaximumRequiresMaximum | The 'exclusiveMaximum' keyword can only be specified if the 'maximum' keyword is also specified. |
Não é possível especificar um "exclusiveMaximum" sem especificar também um "maximum". |
| ExclusiveMinimumRequiresMinimum | The 'exclusiveMinimum' keyword can only be specified if the 'minimum' keyword is also specified. |
Não é possível especificar um "exclusiveMinimum" sem especificar também um "minimum". |
| FieldLengthExceeded | The '{0}' value goes over the character limit '{1}' |
Um campo com o nome especificado em {0} está acima do limite de carateres especificado em {1}. |
| FieldLengthNotInRange | The '{0}' value must be between '{1}' and '{2}' characters. |
{0} é o nome do campo, {1} é o comprimento mínimo, {2} é o limite. Diminua o comprimento dos carateres neste campo. |
| MaxItemsMustBeGreaterThanOrEqual ToZero |
The 'maxItems' value must be greater than or equal to zero. |
O valor 'maxItems' atualmente está abaixo de zero. Altere esse valor para maior ou igual a zero. |
| MaxLengthMustBeGreaterThanOrEqual ToZero |
The 'maxLength' value must be greater than or equal to zero. |
O valor da propriedade “maxLength” tem de ser um número não negativo. |
| MaxPropertiesMustBeGreaterThanOrEqual ToZero |
The 'maxProperties' value must be greater than or equal to zero. |
O valor 'maxProperties' atualmente é menor que zero. Altere esse valor para maior ou igual a zero. |
| MinimumShouldBeLessThanOrEqual ToMaximum |
The 'minimum' value should be less than or equal to the 'maximum' value. |
Quando você especifica um valor mínimo, o valor deve ser menor ou igual ao valor máximo. |
| MinItemsMustBeGreaterThanOrEqual ToZero |
The 'minItems' value must be greater than or equal to zero. |
O valor 'minItems' atualmente é menor que zero. Altere esse valor para maior ou igual a zero. |
| MinItemsShouldBeLessThanOrEqual ToMaxItems |
The 'minItems' value should be less than or equal to the 'maxItems' value. |
Quando você especifica itens mínimos, o valor deve ser menor ou igual aos itens máximos. |
| MinLengthMustBeGreaterThanOrEqual ToZero |
The 'minLength' value must be greater than or equal to zero. |
O valor da propriedade “minLength” tem de ser um número não negativo. |
| MinLengthShouldBeLessThanOrEqual ToMaxLength |
The 'minLength' value should be less than or equal to the 'maxLength' value. |
Quando você especifica um comprimento mínimo, o valor deve ser menor ou igual ao comprimento máximo. |
| MinPropertiesMustBeGreaterThanOrEqual ToZero |
The 'minProperties' value must be greater than or equal to zero. |
O valor 'minProperties' atualmente é menor que zero. Altere esse valor para maior ou igual a zero. |
| PatternShouldBeValidRegularExpression | The 'pattern' value should be a valid regular expression. |
O valor 'pattern' não é uma expressão regular válida, corrigir a expressão regular corrige esse erro. |
| RequiredValueEmpty | The '{0}' property must have not empty value. |
O seu swagger contém um valor vazio para uma propriedade que é obrigatória. Definir o valor desta propriedade obrigatória corrige este problema. |
| ValueContainsRestrictedWords | The value '{0}' contains at least one of the restricted words: '{1}'. |
Um dos campos no swagger usa uma palavra restrita. |
| ValueMustBeInEnglish | The '{0}' value must be written in English. |
Substitua o valor por um valor que contenha apenas carateres alfanuméricos. |
| ValueMustEndWithAlphanumeric | The '{0}' value must end with alphanumeric character. |
Substitua o último caráter por um caráter alfanumérico |