Corrigir erros do validador swagger
A ferramenta Validador Swagger valida os arquivos do conector que você envia no repositório open-source do GitHub e no portal ISV. Ela verifica os arquivos do conector para garantir que eles sejam adequados e cumpram nossos requisitos e diretrizes de conector.
Use as tabelas neste tópico para ajudar você a localizar e corrigir erros. Cada tabela lista os erros que a ferramenta pode gerar. Para cada erro, há um problema e uma solução correspondentes. As soluções listadas podem ajudar você a evitar erros antes ou ao longo do envio.
Se precisar de mais diretrizes, envie um e-mail para ConnectorPartnerMgmtTeam@service.microsoft.com.
Operações
| Error | Emitir | 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 usar esta propriedade, a operação deve ter a propriedade "deprecated" definida como verdadeira. Caso contrário, se esse não for 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 "replacement" especificada, mas a propriedade "api" está ausente. Para usar a propriedade "replacement", as propriedades "api" e "operationId" devem 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 "replacement" especificada, mas a propriedade "operationId" está ausente. Para usar a propriedade "replacement", as propriedades "api" e "operationId" devem ser definidas. |
| ArrayDuplicateValue | The array contains duplicate values, values must be unique. |
As matrizes devem ter valores exclusivos, mas seu swagger contém duplicatas. Remova as duplicidades. |
| BodyOrFormDataParameterInFetch OperationNotAllowed |
Body or form data parameters are not supported in a fetch operation. |
As operações que usam o método HTTP "GET" não podem ter um corpo ou dados de formulário. |
| ConnectionIdParameterNotAllowed | A parameter cannot be named as 'connectionId'. |
Renomeie o 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}'. |
Seu swagger deve especificar um tipo de MIME compatível em "consumes" para 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 de enumeração devem ser únicos 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} é a ID da operação, {1} é a ID da operação duplicada, {2} é o caminho da operação, {3} é o caminho da operação duplicada. Remova a ID de operação duplicada do caminho de 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 em um parâmetro do corpo e devem 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" deve ser definido. Para obter mais informações: Como usar 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" deve ser definido. Para obter mais informações: Como usar 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" deve ser definido. Para obter mais informações: Como usar 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" deve ser definido. Para obter mais informações: Como usar 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. |
Seu arquivo swagger está sem "x-ms-dynamic-properties", o que é necessário, pois 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. |
A propriedade "x-ms-dynamic-tree" está ausente e deve ser definida para oferecer suporte ao seletor de arquivo. |
| InvalidEnumValue | The type of the enum value is '{0}' but it should be '{1}' as specified in the schema. |
O valor deve 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. |
A enumeração selecionada não foi definida na lista de enumerações. Defina o valor na propriedade enum ou use um valor definido na propriedade enum. |
| InvalidFormDataParameterName | The form data parameter name '{0}' is invalid. All characters must be part of the US-ASCII character set. |
Renomeie o nome do parâmetro de dados do formulário para incluir apenas caracteres 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’. Qualquer outro valor não é permitido. |
| 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} 1 é o caminho para uma propriedade de resposta, {1} é a ID da operação. Defina dentro da resposta da operação um retorno do 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} 1 é o caminho para uma propriedade de resposta, {1} é a ID da operação. Defina dentro da resposta da operação uma propriedade específica |
| MimeTypeNotCompatibleWithRequest ContentSchemaType |
The MIME type(s) are not compatible with the request content type '{0}' for operation '{1}'. |
O tipo 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. |
O uso de "x-ms-notification" não é permitido em uma operação de webhook. |
| NotificationExtensionSupportedFor TriggerOnly |
The 'x-ms-notification' is supported for trigger operations only. |
A extensão "x-ms-notification" só pode ser usada para operações de gatilho. |
| NotificationOperationMustBeWebhook | The 'operationId' property in 'x-ms-notification' extension must be for a webhook operation. |
Ao usar "x-ms-notification", a ID da operação deve se referir a uma operação de webhook. |
| OperationFamilyHasDuplicateRevisions | The operation family '{0}' has operations with duplicate revision. |
Seu swagger define uma família de operação com o mesmo número de versão/revisão. Cada operação em uma família de operação deve ter um número de versão exclusivo. |
| OperationFamilyHasManyActive Operações |
The operation family '{0}' has more than two active operations. Extra operations must be deprecated. |
As famílias de operação são limitadas a duas operações não preteridas. Qualquer outra deve ser marcada como preterida para reduzir a confusão para o usuário 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 várias operações em produção. Para reduzir a confusão, limite o número de operações de produção em uma família e desative o resto. |
| OperationFamilyHasManyEmptyRevisions | The operation family '{0}' has several operations with empty revision. Only one operation can have empty revision. |
As famílias de operação só podem ter uma operação sem revisão. Todos os outros membros da família devem passar por 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 designer evitam vários esquemas de resposta. Sua operação especifica vários, mas deve especificar apenas um. |
| OperationIdNotFound | The 'operationId' could not be found in this swagger document. |
A operationId não pode ser encontrada em seu swagger. |
| OperationIdNotUnique | The operationId '{0}' is used multiple times. Operation identifiers must be unique. |
A mesma operationId aparece mais de uma vez. Remova uma das instâncias ou conserte uma delas para que seja diferente. |
| OperationIdRequired | The operation 'operationId' property is required. |
A propriedade "operationId" está ausente; inclua a propriedade "operationId" para 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. |
A ID de operação fornecida não corresponde à versão sanitizada. Atualize a ID da operação para corresponder. |
| OperationIdShouldEndWithRevision | The operation Id '{0}' should end with revision suffix '{1}'. |
As 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" para que o comprimento do caractere 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 obrigatório, mas isso não está definido nos parâmetros fornecidos. Adicione esse 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. |
Seu swagger contém uma operação que não tem extensão de conteúdo de notificação. (Precisa de mais contexto) |
| OperationMustHaveResponse | The operation is not valid, it must contain at least one response definition. |
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 de caminho de corpo de parâmetro. Renomeie uma das instâncias para corrigir esse problema. |
| OperationParameterNameNotFound | The parameter could not be found in operation '{0}' in the swagger document. |
O nome do parâmetro de operação não pode ser encontrado em 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 é obrigatório, mas o valor da operação indica que é opcional, causando essa incompatibilidade. |
| OperationParametersAreNotUnique | The parameters in the operation '{0}' are not unique. |
Parece haver uma duplicata nos parâmetros de operação. Seu swagger precisa remover duplicatas de parâmetros de operação. |
| OperationParametersContain DuplicateParameter |
The operation '{0}' contains duplicate parameters with name '{1}', location '{2}'. |
Existe um parâmetro operacional que está sendo listado duas vezes. {0} é o nome da operação, {1} é o nome do parâmetro duplicado, {2} é o local 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 body duplicados. Remova um dos parâmetros body. |
| OperationParameterStaticTypeMismatch | The parameter has type '{0}', but a static value is provided of type '{1}'. |
O parâmetro tem um 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 com que o tipo de seu parâmetro e sua operação correspondam. |
| OperationPathContainsUnsupportedCharacters | The operation path cannot contain wildcard character '*'. |
Uma de suas operações especifica um caminho de URL que contém caracteres não compatíveis (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 %xx equivalentes). |
| 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, ele deve começar com o caractere "/". Inclua o caractere "/" no início do caminho para corrigir esse problema. |
| 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. |
Seu swagger contém um caminho de operação com caracteres “{“ ou “}” não fechados. Esses caracteres são usados para se referir a uma variável no caminho; portanto, eles 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 "=". Esse 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 está marcada como parte de uma família, mas não tem 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. |
Existem muitos esquemas na operação. Remova alguns deles para que o total fique 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 está em "Versão preliminar". |
| OperationSummaryTooLong | The operation 'summary' should be fewer than {0} characters for improved readablity. |
Reduza a propriedade "summary" da operação para menos de 120 caracteres. |
| 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} é a 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 da operação que compartilham a similaridade. |
| PathParameterMustBeRequired | The parameter must be marked as required as it is used in the operation path. Include the 'required' property, with the value 'true'. |
O local do parâmetro é definido como "Path"; portanto, ele precisa 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. |
Existe 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} é o local (a propriedade "in") 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 ambos no corpo. Remova um dos parâmetros para corrigir esse erro. |
| PathRedefined | The path '{0}' is defined multiple times with different capitalization. Paths must be unique when compared case-insensitively. |
O mesmo caminho é definido mais de 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 de suas operações contém caracteres restritos. Remova os caracteres ou reformule o resumo para corrigir esse erro. |
| SelectedItemValuePathNotAllowedIn ThisPosition |
The 'selectedItemValuePath' property is not allowed in this position. It is allowed only in 'browse' operation of 'x-ms-dynamic-tree' extension. |
A inserção de selectedItemValuePath não é permitida. Remova-o ou coloque-o em um local válido. |
| 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 dessa operação não podem ser do tipo "string" ou "binary". |
| TotalOperationsCountExceedsMaxAllowed | The total number of operations in the swagger exceeds the maximum allowed value of '{0}'. |
Existem muitas operações no swagger. |
| UnrecognizedTypeFormat | The type/format '{0}' is not recognized. |
O tipo/formato fornecido "{0}" é desconhecido. Verifique se há erros de digitação ou documentação para confirmar os formatos de tipo compatíveis. |
| WebhookOperationsMissingNotification UrlProperty |
The webhook operation '{0}' is missing notification URL property. |
Seu swagger contém uma operação de webhook que não possui uma propriedade de URL de notificação ausente. Adicionar essa propriedade na operação do webhook corrige a operação. |
Matrizes
| Erro | Emitir | Solução |
|---|---|---|
| ArrayHasNoItems | The array should have items specified. |
A matriz está vazia, mas uma matriz vazia não é permitida. |
| 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. |
Sem suporte
| Erro | Emitir | Solução |
|---|---|---|
| CollectionFormatValueNotSupported | The 'collectionFormat' keyword value '{0}' is not supported. |
Apenas certos formatos de coleção são compatíveis. Seu swagger contém um formato incompatível. |
| MimeTypeNotSupported | The MIME type '{0}' is not supported. The supported mime types are: '{1}'. |
O tipo MIME que você está tentando usar em seu estilo não é compatível. |
| PathItemRefNotSuppored | The '$ref' property in a path is not supported. |
Um caminho não pode ter uma propriedade "$ref" definida. Remova a 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
| Erro | Emitir | 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 só pode estar "in" em "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 que não é permitido. Remova um desses tipos de parâmetro. |
| ParameterReferenceNotFound | The parameter reference '{0}' could not be found in the swagger document. |
Seu swagger tem uma referência de parâmetro que não pode ser encontrada no documento swagger. Remova a referência a esse 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. |
Seu swagger tem uma definição de parâmetro que está usando incorretamente "$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 seu swagger tiver parâmetros com o mesmo nome em operações de busca e assinatura, eles 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 que não contém 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 possui a codificação não compatível. Corrija esta codificação. |
| ReservedParameterIsUsed | The parameter '{0}' is reserved and cannot be used in '{1}'. |
O parâmetro declarado neste erro está sendo usado, mas não pode ser usado porque está reservado para essa seção ou em geral. |
| ResponseRefLoopNotAllowed | The response definition may not use a '$ref' to point to another definition. |
Seu swagger tem uma definição de resposta que está usando incorretamente "$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 é marcada como interna, mas a operação onde a referência do parâmetro é usada não é interna. Atualize o parâmetro ou a operação para corrigir isso. |
Propriedades
| Erro | Emitir | Solução |
|---|---|---|
| AdditionalPropertyNotAllowed | The property '{0}' is not allowed and must be removed. |
Existe uma propriedade extra em seu swagger que deve ser removida. |
| AdditionalPropertyNotAllowedAdjacent ToRef |
When '$ref' is defined, no other properties may be specified. |
Ao usar "$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 você usar um caminho de base, ele deve começar com "/". Caminhos de 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 do corpo em seu swagger está usando uma propriedade inválida que não pode ser usada em um parâmetro body. |
| ConnectorMetadataPropertiesMissing | The connector metadata property '{0}' is required. |
Certos metadados são necessários para o conector. |
| ContactEmailNotValid | The contact 'email' property, if present, must be a valid email address. |
O endereço de email fornecido está em um formato incorreto ou contém caracteres não ASCII. |
| DefaultValueMustMatchType | The 'default' value is of type '{0}', but should match the given type '{1}'. |
O valor para o seu valor padrão não é o mesmo tipo que o tipo fornecido. Altere o valor do valor padrão para o do tipo fornecido para corrigir esse problema. |
| EnumMustContainAtLeastOneElement | The 'enum' array requires at least one value. |
Se o seu tipo de propriedade for uma enumeração, ele deve especificar uma matriz com pelo menos um dos valores de 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 devem começar com o prefixo "x-". |
| FilterFunctionsPropertyEmpty | The 'filterFunctions' property must have at least one element. |
A propriedade "filterFunctions" não pode estar vazia se especificada. |
| FilterFunctionsPropertyHasDuplicates | The 'filterFunctions' property cannot contain duplicates. |
A propriedade "filterFunctions" não pode conter duplicatas. |
| 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 sem suporte. |
| 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 é semelhante a "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 padrão especificado e não é obrigatória. Se você quiser garantir que isso seja incluído nas solicitações, marque-o como necessário; senão, se isso for pretendido, 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 local do esquema. |
| JsonTypeIncorrect | The type of the property is incorrect. Expected type '{0}', but value is of type '{1}'. |
Uma propriedade em seu swagger tem um tipo, mas o valor real é 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 da enumeração "in" não corresponde às opções disponíveis no momento. Altere o valor para um dos seguintes indicados na mensagem de erro. |
| MimeTypeNotValid | The MIME type '{0}' is not valid. |
O "tipo de conteúdo" MIME fornecido pelo usuário que você selecionou não é válido. Os tipos 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 maior que zero. |
| OneOfPropertiesRequired | At least one of the properties is required: [{0}]. |
{0} é um conjunto de propriedades. Esse erro exibe todas as propriedades que devem 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 "Versão preliminar". |
| 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 obrigatória. |
| RequiredPropertyDefinitionMissing | The required property '{0}' is not defined in the object schema. |
Uma propriedade de esquema é listada como "required" e, portanto, deve ser definida nas "properties" |
| RequiredPropertyMissing | The '{0}' property is required. |
É necessária uma propriedade em seu swagger, mas atualmente não está em seu swagger. Inclua essa propriedade para corrigir esse erro. |
| RequiredPropertyNotOnObject | The property 'required' is applicable to schemas with 'object' type only and should be removed. |
A propriedade "required" só é compatível com 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 obrigatória. Uma propriedade somente leitura significa que o usuário não pode modificar o valor. Uma propriedade obrigatória 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 "http" ou "https". |
| SecuritySchemePropertyNotValid | The security definition property '{0}' is not valid for definitions of type '{1}'. |
Há um nome de propriedade e um valor inválido que você incluiu no dicionário securityDefinitions. Altere esta propriedade para um nome de propriedade válido para corrigir esse problema. |
| SecuritySchemePropertyRequired | The security definition property '{0}' is required for definitions of type '{1}'. |
Há um nome e um valor de propriedade obrigatórios que não estão incluídos no dicionário securityDefinitions. Adicione essa propriedade e valor para corrigir esse problema. |
| SpecificationVersionIncorrect | The 'swagger' property must have the string value "2.0". |
Como somente a versão "2.0" é compatível, corrija a propriedade da versão do swagger para "2.0". |
| TagRedefined | The 'tags' property defines tag '{0}' multiple times. |
As tags definidas na propriedade "tags" devem ser exclusivas. Remova ou substitua qualquer ocorrência múltipla. |
| 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. |
Seu swagger tem um URL inválido. Isso pode se dever à cópia incorreta do URL de algum lugar. |
Response
| Erro | Emitir | Solução |
|---|---|---|
| BodyParameterSchemaRequired | The 'body' parameter must define a 'schema' property. |
No parâmetro de corpo, a propriedade do esquema deve ser definida. Defina a propriedade do esquema para corrigir esse 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. |
Existem muitos esquemas no objeto do corpo. Remova alguns deles para que o total fique abaixo do limite. |
| DefaultResponseHasSchema | The 'default' response should not have schema definition. Schemas should be defined on expected responses only. |
Seu swagger contém uma definição de esquema para a resposta padrão. Remover essa definição de esquema para a resposta padrão corrige esse 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á configurado para dicionário somente quando o esquema é do tipo object e configurado para propriedades adicionais permitidas. |
| JsonPointerNotValid | The JSON Pointer path is not valid. |
Uma referência (#ref) sendo usada em seu estilo não é válida. |
| NonBodyParameterSchemaNotValid | The parameter cannot define a schema as it is not in the 'body'. |
Seu swagger tem um parâmetro que usa "schema", mas apenas os parâmetros body podem usar "schema". |
| RequiredLoopInSchemaNotAllowed | Loops of required schema properties are not allowed. |
A especificação das propriedades obrigatórias não pode usar loops de referência. |
| ResponseExampleMustBeProduced ByOperation |
The response example '{0}' is not produced by the operation '{1}'. |
Seu swagger tem uma operação com um exemplo de resposta, mas essa mesma operação não produz uma resposta com o tipo MIME indicado. |
| ResponseHeadersAreNotUnique | The response headers are not unique. |
Há um cabeçalho de 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 status à sua resposta. |
| ResponseReferenceNotFound | The response reference '{0}' could not be found in the swagger document. |
Seu swagger tem uma referência de resposta que não pode ser encontrada no documento swagger. Remova a referência a essa resposta. |
| ResponseReferenceNotValid | The response reference '{0}' is not valid. Response references must start with '#/responses/' and be valid JSON Pointers. |
Seu swagger tem uma referência de resposta (“#/responses/”) que é inválida com base na especificação RFC do ponteiro 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 em sua operação para o código de resposta 200 ou 201. Para webhooks, o esquema de resposta deve ser especificado como parte da extensão do conteúdo de 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 pode ser encontrada no documento swagger. |
| SchemaReferenceNotValid | The schema reference '{0}' is not valid. Schema references must start with '#/definitions/' and be valid JSON Pointers. |
Seu swagger tem uma referência de esquema (‘#/definitions/’) que é inválida com base na especificação RFC do ponteiro 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 são limitados a uma profundidade JSON específica. Use um esquema mais superficial. |
| SchemaTypeFileNotValid | The schema type 'file' is not valid. Only parameters in 'formData' and the root response schema may be of type 'file'. |
O uso do tipo de esquema "file" é compatível apenas com dados de formulário e deve 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 é compatível. Os esquemas compatíveis 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. |
Existem muitos esquemas no swagger. |
Segurança
| Erro | Emitir | 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 devem ser um nome de escopo 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}" devem 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á ausente ou é nulo. Se nenhum escopo OAuth for necessário, especifique uma matriz vazia. |
Webhooks
| Erro | Emitir | 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" deve ser definida apenas em uma entrada. |
| NotificationUrlNotInternal | The notification URL property itself or at least one of its parents must be internal. |
Seu swagger não está configurando a propriedade URL de notificação como interno, o que deveria ser o caso. |
| NotificationUrlNotRequired | The notification URL property must be required all the way through the schema chain. |
Seu swagger não está exigindo propriedade URL de notificação, o que deve ser obrigatório. |
| NotificationUrlNotString | The notification URL property must be of type string. |
A propriedade URL de notificação tem um valor que não é do tipo string. |
Metadados
| Erro | Emitir | 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" em um parâmetro que tenha uma propriedade "location" que é "query" ou "formData". O valor da propriedade "location" não é nenhum dos dois casos. |
| DiscriminatorMustBeARequiredStringProperty | The 'discriminator' value must be the name of a required string property. |
O valor "discriminador" deve ser o nome de uma propriedade de string necessária em 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 também especificar 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 também especificar um "minimum". |
| FieldLengthExceeded | The '{0}' value goes over the character limit '{1}' |
Um campo com o nome especificado em {0} ultrapassa o limite de caracteres 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 caracteres neste campo. |
| MaxItemsMustBeGreaterThanOrEqual ToZero |
The 'maxItems' value must be greater than or equal to zero. |
O valor "maxItems" atualmente está abaixo de zero; altere este 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" deve ser um número não negativo. |
| MaxPropertiesMustBeGreaterThanOrEqual ToZero |
The 'maxProperties' value must be greater than or equal to zero. |
O valor "maxProperties" atualmente está abaixo de zero; altere este valor para maior ou igual a zero. |
| MinimumShouldBeLessThanOrEqual ToMaximum |
The 'minimum' value should be less than or equal to the 'maximum' value. |
Ao especificar 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 está abaixo de zero; altere este valor para maior ou igual a zero. |
| MinItemsShouldBeLessThanOrEqual ToMaxItems |
The 'minItems' value should be less than or equal to the 'maxItems' value. |
Ao especificar 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" deve ser um número não negativo. |
| MinLengthShouldBeLessThanOrEqual ToMaxLength |
The 'minLength' value should be less than or equal to the 'maxLength' value. |
Ao especificar 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 está abaixo de zero; altere este 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 corrigirá esse erro. |
| RequiredValueEmpty | The '{0}' property must have not empty value. |
Seu swagger contém um valor vazio para uma propriedade que é obrigatória. Definir o valor dessa propriedade obrigatória corrige esse problema. |
| ValueContainsRestrictedWords | The value '{0}' contains at least one of the restricted words: '{1}'. |
Um dos campos do swagger usa uma palavra restrita. |
| ValueMustBeInEnglish | The '{0}' value must be written in English. |
Substitua o valor por um valor contendo apenas caracteres alfanuméricos. |
| ValueMustEndWithAlphanumeric | The '{0}' value must end with alphanumeric character. |
Substitua o último caractere por um caractere alfanumérico |