Solucionar errores de Swagger Validator
La herramienta Swagger Validator valida los archivos de conector que envía en el Repositorio de código abierto de GitHub y el Portal de ISV. Comprueba los archivos del conector para asegurarse de que sean correctos y se adhieran a nuestros requisitos y pautas de conectores.
Utilice las tablas de este tema para encontrar y corregir errores. Cada tabla enumera los errores que podría generar la herramienta. Para cada error hay un problema y una solución correspondientes. Las soluciones enumeradas pueden ayudarlo a evitar errores antes o durante el envío.
Si necesita más orientación, envíe un correo electrónico a ConnectorPartnerMgmtTeam@service.microsoft.com.
Operaciones
| Error | Incidencia | Solution |
|---|---|---|
| ApiAnnotationExtensionReplacementInfo ForNonDeprecatedOperations |
The 'x-ms-api-annotation' extension for operation '{0}' is invalid. The replacement property should be specified for deprecated operations only. |
La operación {0} no está marcado como en desuso. Para utilizar esta propiedad, la operación debe tener la propiedad ’deprecated’ establecida en true. De lo contrario, si este no es el caso, elimine la propiedad ‘x-ms-api-annotation'. |
| ApiAnnotationExtensionReplacementInfo MissingApiProperty |
The 'x-ms-api-annotation' extension for operation '{0}' is invalid. The replacement property must specify 'api' property. |
La 'x-ms-api-annotation' tiene la propiedad 'replacement' especificada pero falta la propiedad 'api'. Para usar la propiedad 'replacement', se deben establecer tanto la propiedad 'api' como la propiedad 'operationId'. |
| ApiAnnotationExtensionReplacementInfo MissingOperationIdProperty |
The 'x-ms-api-annotation' extension for operation '{0}' is invalid. The replacement property must specify 'operationId' property. |
La 'x-ms-api-annotation' tiene la propiedad 'replacement' especificada pero falta la propiedad 'operationId'. Para usar la propiedad 'replacement', se deben establecer tanto la propiedad 'api' como la propiedad 'operationId'. |
| ArrayDuplicateValue | The array contains duplicate values, values must be unique. |
Las matrices deben tener valores únicos, pero Swagger contiene duplicados. Quite los duplicados. |
| BodyOrFormDataParameterInFetch OperationNotAllowed |
Body or form data parameters are not supported in a fetch operation. |
Las operaciones que utilizan el método HTTP "GET" no pueden tener un cuerpo o datos de formulario. |
| ConnectionIdParameterNotAllowed | A parameter cannot be named as 'connectionId'. |
Cambie el nombre del parámetro a un valor que no sea 'connectionId'. |
| ConsumesMissing | At least one supported MIME type must be provided in 'consumes' for operation '{0}'. |
Swagger debe especificar un tipo MIME admitido en los consumos para la operación. |
| DuplicateEnumValuesInExtension | The 'x-ms-enum-values' extension has duplicate values. You can only have one display name mapped to a value. |
Los valores de enumeración deben ser únicos y no 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} es el ID de operación, {1} es el ID de operación duplicada, {2} es la ruta de operación, {3} es la ruta de operación duplicada. Elimine el ID de operación duplicada de la ruta de operación duplicada. |
| DynamicExtensionDefinitionNotAllowed InParameter |
Dynamic extensions are not allowed to be defined on the body parameter. It should be in the schema. |
Las extensiones dinámicas se definen en un parámetro de cuerpo y deben eliminarse. Solo se permite definirlas en el esquema. |
| DynamicListExtensionRequiredFor AmbiguousReferences |
The 'x-ms-dynamic-values' extension references ambiguous parameter references. You need to define the 'x-ms-dynamic-list' extension. |
Se debe definir 'x-ms-dynamic-list'. Más información: Cómo 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. |
Se debe definir 'x-ms-dynamic-list'. Más información: Cómo 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. |
Se debe definir ‘x-ms-dynamic- properties'. Más información: Cómo 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. |
Se debe definir 'x-ms-dynamic- properties'. Más información: Cómo 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. |
A su archivo de Swagger le falta 'x-ms-dynamic-properties', que es necesario ya que define un '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}'. |
La ruta del valor del elemento de extensión de propiedades dinámicas no coincide con la ruta esperada según el esquema. |
| DynamicTreeExtensionMissing | The 'x-ms-dynamic-tree' extension must be defined to enable file picker support. |
Falta la propiedad 'x-ms-dynamic-tree' y debe definirse para admitir el selector de archivos. |
| InvalidEnumValue | The type of the enum value is '{0}' but it should be '{1}' as specified in the schema. |
El valor debe reemplazarse para que sea del tipo especificado. |
| InvalidEnumValuesExtensionValue | The 'value' field must match one of the enums as defined in the 'enum' property of the schema. |
La enumeración seleccionada no se ha definido en la lista de enumeraciones. Defina el valor en la propiedad enum o use un valor definido en la propiedad enum. |
| InvalidFormDataParameterName | The form data parameter name '{0}' is invalid. All characters must be part of the US-ASCII character set. |
Cambie el nombre del parámetro de datos del formulario para incluir solo caracteres US-ASCII. |
| InvalidNextLinkNameValue | The nextLinkName value for operation '{0}' is invalid. Supported values are 'nextLink' or '@odata.nextLink'. |
Corrija el valor de la propiedad 'nextLinkName' para que sea 'nextLink' o '@odata.nextLink'. No se admiten otros valores. |
| 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} es la ruta a una propiedad de respuesta, {1} es el ID de operación. Defina en la respuesta de la operación un retorno 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} es la ruta a una propiedad de respuesta, {1} es el ID de operación. Defina en la respuesta de la operación una propiedad específica |
| MimeTypeNotCompatibleWithRequest ContentSchemaType |
The MIME type(s) are not compatible with the request content type '{0}' for operation '{1}'. |
El tipo MIME que está intentando utilizar no es compatible con el contenido de su solicitud en la operación especificada. |
| NotificationExtensionNotSupportedIn WebhookOperation |
The 'x-ms-notification' extension must not be defined in a webhook operation. |
No se permite el uso de "x-ms-notification" en una operación de webhook. |
| NotificationExtensionSupportedFor TriggerOnly |
The 'x-ms-notification' is supported for trigger operations only. |
La extensión "x-ms-notification" solo se puede utilizar para operaciones de desencadenamiento. |
| NotificationOperationMustBeWebhook | The 'operationId' property in 'x-ms-notification' extension must be for a webhook operation. |
Cuando se utiliza "x-ms-notification", el ID de operación debe hacer referencia a una operación de webhook. |
| OperationFamilyHasDuplicateRevisions | The operation family '{0}' has operations with duplicate revision. |
Swagger define una familia de operaciones con el mismo número de versión/revisión. Cada operación de una familia de operaciones debe tener un número de versión exclusivo. |
| OperationFamilyHasManyActive Operaciones |
The operation family '{0}' has more than two active operations. Extra operations must be deprecated. |
Las familias de operaciones están limitadas a dos operaciones no en desuso. Los demás deben marcarse como en desuso para reducir la confusión del usuario de su conector. |
| OperationFamilyHasManyActive ProductionOperations |
The operation family '{0}' has several active operations in Production status. Previous revisions should be deprecated. |
Una familia de operaciones tiene varias operaciones en producción. Para reducir la confusión, limite el número de operaciones de producción en una familia y ponga en desuso el resto. |
| OperationFamilyHasManyEmptyRevisions | The operation family '{0}' has several operations with empty revision. Only one operation can have empty revision. |
Las familias de operaciones solo pueden tener una operación sin una revisión. Todas las demás de la familia deberían someterse a una revisión. |
| OperationHasManyResponsesWithSchema | The operation '{0}' has more than one response with specified schema, only one schema will be used in the designer. |
Las limitaciones del diseñador impiden múltiples esquemas de respuesta. Su operación especifica varios, pero solo debe especificar uno. |
| OperationIdNotFound | The 'operationId' could not be found in this swagger document. |
El operationId no se encuentra en Swagger. |
| OperationIdNotUnique | The operationId '{0}' is used multiple times. Operation identifiers must be unique. |
Aparece el mismo operationId más de una vez. Elimine una de las instancias o corrija una de las instancias para que sea diferente. |
| OperationIdRequired | The operation 'operationId' property is required. |
Falta la propiedad 'operationId', incluya la propiedad 'operationId' para su operación. |
| OperationIdSanitized | The 'operationId' property value is different from its sanitized value '{0}'. Please avoid the useage of non-alphanumeric characters to have matching values. |
El ID de operación proporcionado no coincide con la versión desinfectada. Actualice el ID de operación para que coincida. |
| OperationIdShouldEndWithRevision | The operation Id '{0}' should end with revision suffix '{1}'. |
Los ID de operación con una revisión deben tener un nombre con el sufijo de revisión. |
| OperationIdTooLong | The operationId length must be less than '{0}'. |
Reduzca el valor de la propiedad 'operationId' para que la longitud del carácter sea menor que {0}. |
| OperationMissingPathParameter | The operation '{0}' does not define the '{1}' parameter which is required by the path. |
Swagger tiene una operación que no define un parámetro que parece ser requerido por su plantilla de ruta. |
| OperationMissingRequiredProperty | The target operation requires parameter '{0}'. |
La operación tiene un parámetro '{0}' definido como requerido pero no está definido en los parámetros proporcionados. Añada este parámetro para solucionar este problema. |
| OperationMustHaveNotification ContentExtension |
The operation '{0}' is missing notification content extension as it has '{1}' properties marked as notification URL. |
Swagger contiene una operación que no tiene extensión de contenido de notificación. (Se necesita más contexto) |
| OperationMustHaveResponse | The operation is not valid, it must contain at least one response definition. |
Swagger tiene una operación que no tiene al menos una definición de respuesta. |
| OperationParameterNameIsAmbiguous | The parameter name is ambiguous as it matches both a parameter name and a path to a body property. |
El nombre del parámetro se utiliza como nombre de parámetro y como nombre de ruta del cuerpo del parámetro. Cambie el nombre de una de las instancias para solucionar este problema. |
| OperationParameterNameNotFound | The parameter could not be found in operation '{0}' in the swagger document. |
El nombre del parámetro de operación no se encuentra en 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. |
El parámetro es obligatorio, pero el valor de la operación indica que es opcional, lo que provoca esta discrepancia. |
| OperationParametersAreNotUnique | The parameters in the operation '{0}' are not unique. |
Parece haber un duplicado en los parámetros de operación. Swagger necesita eliminar duplicados de parámetros de operación. |
| OperationParametersContain DuplicateParameter |
The operation '{0}' contains duplicate parameters with name '{1}', location '{2}'. |
Hay un parámetro operativo que aparece dos veces. {0} es el nombre de la operación, {1} es el nombre del parámetro duplicado, {2} es la ubicación del parámetro duplicado (propiedad 'in' en Swagger). Elimine la repetición de la propiedad. |
| OperationParametersContain MultipleBodyParameters |
The operation '{0}' contains multiple parameters in the location 'body', at most one is allowed. |
Los parámetros de operación contienen parámetros de cuerpo duplicados. Elimine uno de los parámetros del cuerpo. |
| OperationParameterStaticTypeMismatch | The parameter has type '{0}', but a static value is provided of type '{1}'. |
El parámetro tiene un tipo estático proporcionado cuando no se espera para este parámetro de operación. |
| OperationParameterTypeMismatch | The parameter has type '{0}', but operation '{1}' is providing a parameter of type '{2}'. |
El parámetro y la operación tienen diferentes tipos. Haga coincidir el tipo de su parámetro y su operación. |
| OperationPathContainsUnsupportedCharacters | The operation path cannot contain wildcard character '*'. |
Una de sus operaciones especifica una ruta de URL que contiene caracteres no admitidos (como el símbolo comodín). |
| 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. |
La ruta de la operación no puede contener '?' ni '#' a menos que estén codificados en URL (traducidos a sus equivalentes en %xx). |
| OperationPathMustStartWithSlash | The path is not valid, it must start with a '/' character. |
Si usa una ruta de operación que está tratando de lograr, debe comenzar con el carácter '/'. Incluya el carácter '/' al principio de la ruta para solucionar este 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. |
Swagger contiene una ruta de operación con “{“ o “}” caracteres sin cerrar. Esos caracteres se utilizan para hacer referencia a una variable en la ruta, por lo que no pueden existir en la ruta cuando no están cerrados. |
| OperationPathVariablesContainDefaults | The operation path template variables cannot set default values with character '='. |
Una de sus operaciones está especificando un valor predeterminado para un parámetro que contiene "=". Ese parámetro también se especifica que está en la ruta de URL. Esta combinación no está permitida. |
| OperationRevisionEmpty | The operation '{0}' does not specify a revision in api annotation. |
La operación está marcada como parte de una familia, pero no tiene revisión. |
| 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. |
Hay demasiados esquemas en la operación. Quite algunos de ellos para que el total vuelva a estar por debajo del límite. |
| OperationShouldHaveSuccessfulResponse | The operation '{0}' should have at least one successful response definition. |
Swagger tiene una operación que no tiene al menos una definición de respuesta correcta. |
| OperationStatusAheadOfConnector | The operation '{0}' cannot be in a Production status ahead of the connector. |
Las operaciones no se pueden marcar como "Producción" mientras el conector completo sigue en "Versión preliminar". |
| OperationSummaryTooLong | The operation 'summary' should be fewer than {0} characters for improved readablity. |
Reduzca la propiedad ‘summary’ de la operación a 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} es el ID de operación, {1} es la ruta de operación, {2} es el conjunto de rutas de operación parcialmente duplicadas. Cambie la ruta de operación para crear una mayor diferencia entre las rutas de operación que comparten la similitud. |
| PathParameterMustBeRequired | The parameter must be marked as required as it is used in the operation path. Include the 'required' property, with the value 'true'. |
La ubicación del parámetro se establece en 'Ruta', por lo que debe tener la propiedad 'required' establecida en '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. |
Hay un parámetro en una de sus operaciones que está marcado como presente en la ruta de operación pero no existe en la plantilla de ruta. |
| PathParametersContain DuplicateParameter |
The path '{0}' contains duplicate parameters with name '{1}', location '{2}'. |
{0} es la ruta de operación. {1} es el nombre del parámetro duplicado. {2} es la ubicación (la propiedad 'in') del parámetro duplicado. Quite el parámetro de ruta duplicado. |
| PathParametersContainMultiple BodyParameters |
The path '{0}' contains multiple parameters in the location 'body', at most one is allowed. |
No puede haber varios parámetros para una operación que estén ambos en el cuerpo. Quite uno de los parámetros para corregir este error. |
| PathRedefined | The path '{0}' is defined multiple times with different capitalization. Paths must be unique when compared case-insensitively. |
Se define la misma ruta más de una vez. Quite o cambie el nombre de las instancias para que sean únicas. |
| RestrictedCharactersInSummary | Summary string contains any of the restricted characters [{0}] |
El resumen de una de sus operaciones contiene caracteres restringidos. Quite los caracteres o reformule el resumen para corregir este error. |
| SelectedItemValuePathNotAllowedIn ThisPosition |
The 'selectedItemValuePath' property is not allowed in this position. It is allowed only in 'browse' operation of 'x-ms-dynamic-tree' extension. |
Los lugares donde colocó 'selectedItemValuePath' no se permiten. Quítelo o colóquelo en una ubicación válida. |
| StringBinaryNotSupportedFor FormUrlEncoded |
String/binary parameters are not supported for operation '{0}' with 'application/x-www-form-urlencoded' consumes type. |
La operación tiene el valor ‘application/x-www-form-urlencoded' definido en la propiedad 'consumes'. Los parámetros para esta operación no pueden ser de tipo 'cadena' o 'binario'. |
| TotalOperationsCountExceedsMaxAllowed | The total number of operations in the swagger exceeds the maximum allowed value of '{0}'. |
Hay demasiadas operaciones en Swagger. |
| UnrecognizedTypeFormat | The type/format '{0}' is not recognized. |
El tipo/formato dados ‘{0}’ es desconocido. Compruebe si hay errores tipográficos o de documentación para confirmar los formatos de tipo admitidos. |
| WebhookOperationsMissingNotification UrlProperty |
The webhook operation '{0}' is missing notification URL property. |
Su Swagger contiene una operación de webhook a la que le falta una propiedad de URL de notificación. Si agrega esta propiedad dentro de la operación de webhook se corregirá la operación. |
Matrices
| Error | Incidencia | Solución |
|---|---|---|
| ArrayHasNoItems | The array should have items specified. |
La matriz está vacía, pero no se permite una matriz vacía. |
| RequiredPropertyArrayEmpty | The 'required' array requires at least one value. If no properties are required in the schema, remove the 'required' property. |
Su Swagger tiene una matriz vacía para una propiedad llamada ‘required’. Debe quitarse si no hay parámetros obligatorios. |
| SchemesArrayEmpty | The 'schemes' array requires at least one value. |
Los esquemas no pueden estar vacíos y deben tener al menos un valor. |
No admitida
| Error | Incidencia | Solución |
|---|---|---|
| CollectionFormatValueNotSupported | The 'collectionFormat' keyword value '{0}' is not supported. |
Solo se admiten determinados formatos de colección. Su Swagger contiene un formato no admitido. |
| MimeTypeNotSupported | The MIME type '{0}' is not supported. The supported mime types are: '{1}'. |
El tipo MIME que está intentando utilizar en su Swagger no es compatible. |
| PathItemRefNotSuppored | The '$ref' property in a path is not supported. |
Una ruta no puede tener definida una propiedad ‘$ref’. Quite esta propiedad. |
| SwaggerKeywordNotSupported | The '{0}' keyword is not supported. |
{0} es una palabra clave de Swagger como 'uniqueItems' y no está permitida en el contexto donde se usa. |
Parámetros
| Error | Incidencia | Solución |
|---|---|---|
| FileParameterMustBeInFormData | Parameters of type 'file' are not valid in locations other than 'formData'. |
Su Swagger tiene un parámetro con un tipo 'archivo' y solo puede estar 'en' el ‘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. |
Su Swagger está definiendo tanto un parámetro de cuerpo como formData que no está permitido. Elimine uno de estos tipos de parámetros. |
| ParameterReferenceNotFound | The parameter reference '{0}' could not be found in the swagger document. |
Su Swagger tiene una referencia de parámetro que no se puede encontrar en el documento de Swagger. Elimine la referencia a este parámetro. |
| ParameterReferenceNotValid | The parameter reference '{0}' is not valid. Parameter references must start with '#/parameters/' and be valid JSON Pointers. |
Su Swagger tiene una referencia de parámetro (“#/parameters/”) que no es válida según la especificación RFC del puntero JSON. |
| ParameterRefLoopNotAllowed | The parameter definition may not use a '$ref' to point to another definition. |
Su Swagger tiene una definición de parámetro que usa incorrectamente '$ref' para apuntar a otra definición. |
| ParamtersWithSameNameMustHave SameTypeAndVisibility |
Parameters of the same name in fetch and subscribe operations must be of the same type and visibility. |
Si su Swagger tiene parámetros del mismo nombre en las operaciones de captura y suscripción, deben tener el mismo tipo y visibilidad. |
| 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} es el nombre del parámetro al que le falta la codificación. |
| QueryParameterEncodingNotSupported | Encoding for query parameter '{0}' is not supported. All query parameters are single encoded by default. |
{0} es el nombre del parámetro que tiene codificación incompatible. Corrija esta codificación. |
| ReservedParameterIsUsed | The parameter '{0}' is reserved and cannot be used in '{1}'. |
Se está usando el parámetro que se indica en este error, mientras que no se puede usar porque está reservado para esa sección o en general. |
| ResponseRefLoopNotAllowed | The response definition may not use a '$ref' to point to another definition. |
Su Swagger tiene una definición de respuesta que usa incorrectamente '$ref' para apuntar a otra definición. |
| 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. |
La referencia de parámetro está marcada como interna, pero la operación donde se usa la referencia de parámetro no es interna. Actualice el parámetro o la operación para solucionar este problema. |
Propiedades
| Error | Incidencia | Solución |
|---|---|---|
| AdditionalPropertyNotAllowed | The property '{0}' is not allowed and must be removed. |
Hay una propiedad adicional en su Swagger que debe eliminarse. |
| AdditionalPropertyNotAllowedAdjacent ToRef |
When '$ref' is defined, no other properties may be specified. |
Al usar '$ref' en el Swagger, no se deben incluir otras propiedades en ese objeto JSON. |
| BasePathNotValid | The 'basePath' property, if present, must start with a '/' character. |
Si usa una ruta base, debe comenzar con "/". Las rutas base no válidas tiene el formato "abc/def/ghi" o "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. |
Uno de los parámetros del cuerpo en su Swagger está usando una propiedad no válida que no se puede usar en un parámetro del cuerpo. |
| ConnectorMetadataPropertiesMissing | The connector metadata property '{0}' is required. |
Se requieren algunos metadatos para el conector. |
| ContactEmailNotValid | The contact 'email' property, if present, must be a valid email address. |
La dirección de correo electrónico proporcionada tiene un formato incorrecto o contiene caracteres que no son ASCII. |
| DefaultValueMustMatchType | The 'default' value is of type '{0}', but should match the given type '{1}'. |
El valor de su valor predeterminado no es del mismo tipo que el tipo dado. Cambie el valor del valor predeterminado por el del tipo dado para solucionar este problema. |
| EnumMustContainAtLeastOneElement | The 'enum' array requires at least one value. |
Si su tipo de propiedad es una enumeración, debe especificar una matriz con al menos uno de los valores de enumeración. |
| ExtensionNameNotValid | The property '{0}' is not valid. If this property is an extension, its name must begin with "x-". |
Las propiedades que son extensiones deben comenzar con el prefijo "x-". |
| FilterFunctionsPropertyEmpty | The 'filterFunctions' property must have at least one element. |
La propiedad 'filterFunctions' no puede estar vacía si se especifica. |
| FilterFunctionsPropertyHasDuplicates | The 'filterFunctions' property cannot contain duplicates. |
La propiedad 'filterFunctions' no puede contener duplicados. |
| FilterFunctionsPropertyInInputSchema | The 'filterFunctions' property has to be in the response schema. |
La propiedad 'filterFunctions' solo puede estar en el esquema de respuesta. |
| FilterFunctionsPropertyInvalidValue | The 'filterFunctions' property supports only these values: {0}". |
La propiedad 'filterFunctions' no puede especificar un valor no admitido. |
| HostNameNotValid | The 'host' property, if present, must be a valid URI host without a scheme or path. |
Un URI de host sin un esquema o ruta se parece a "www.microsoft.com". Un URI no válido para el host se parece a "https://www.microsoft.com/" o "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. |
Una propiedad está marcada como interna, tiene un valor predeterminado especificado y no es obligatoria. Si desea asegurarse de que esté incluida en las solicitudes, márquela como requerida; si es intencional, se puede dejar como está. |
| InvalidConnectorCategory | The connector category is invalid. Available categories are: [{0}]. |
Las categorías solo pueden provenir de la lista de valores de categoría permitidos. |
| InvalidStringBinaryProperty | A schema with type/format 'string/binary' can only be at the top level of a body or formData parameter. |
El valor de la propiedad "type" y "format" de "cadena" y "binario" no se permite en esta ubicación de esquema. |
| JsonTypeIncorrect | The type of the property is incorrect. Expected type '{0}', but value is of type '{1}'. |
Una propiedad en su Swagger tiene un tipo, pero el valor real es de un tipo diferente. Cambie el tipo de valor para que coincida con el tipo esperado. |
| JsonValueNotInEnum | The property value must be one of the following: {0}. |
El valor de propiedad de la enumeración in no coincide con las opciones disponibles actualmente. Cambie el valor a uno de los siguientes indicados en el mensaje de error. |
| MimeTypeNotValid | The MIME type '{0}' is not valid. |
El MIME proporcionado por el usuario 'content type' que seleccionó no es válido. Los tipos de mime válidos son: "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'. |
Los x-ms-enum-values no especificaron la propiedad 'displayName'. |
| MultipleOfMustBeGreaterThanZero | The 'multipleOf' value must be greater than zero. |
El valor de la propiedad "multipleOf" debe ser un valor mayor que cero. |
| OneOfPropertiesRequired | At least one of the properties is required: [{0}]. |
{0} es un conjunto de propiedades. Este error muestra todas las propiedades que deben estar presentes en el Swagger. |
| ProductionStatusOnBetaService | The connector cannot be in Production status on a beta service. |
El conector no se puede marcar como 'Producción' cuando el servicio de backend está en Beta. Debe estar configurado en 'Versión preliminar'. |
| PropertyMustBeRequired | The property is internal and has a default value, it must be required. Optional internal fields are ignored. |
La propiedad no se está configurando aunque es requerida. |
| RequiredPropertyDefinitionMissing | The required property '{0}' is not defined in the object schema. |
Una propiedad de esquema aparece en "obligatorio" y, por lo tanto, debe definirse en las "propiedades" |
| RequiredPropertyMissing | The '{0}' property is required. |
Se requiere una propiedad en su Swagger, pero actualmente no está en su Swagger. Incluya esta propiedad para corregir este error. |
| RequiredPropertyNotOnObject | The property 'required' is applicable to schemas with 'object' type only and should be removed. |
La propiedad 'required' solo es compatible con el tipo 'objeto'. Quite la propiedad para todos los demás tipos. |
| RequiredReadOnlyPropertyNotAllowed AsInput |
An input property cannot be 'readonly' and required. |
Su Swagger contiene una propiedad que está marcada como de solo lectura y obligatoria. Una propiedad de solo lectura significa que el usuario no puede modificar el valor. Una propiedad obligatoria requiere un valor para su modificación. |
| SchemeNotValid | The 'schemes' property must only contain transfer protocols from the list: {0}. |
La propiedad del esquema debe ser "http" o "https". |
| SecuritySchemePropertyNotValid | The security definition property '{0}' is not valid for definitions of type '{1}'. |
Hay un nombre y un valor de propiedad que no son válidos y que ha incluido en el diccionario securityDefinitions. Cambie esta propiedad por un nombre de propiedad válido para solucionar este problema. |
| SecuritySchemePropertyRequired | The security definition property '{0}' is required for definitions of type '{1}'. |
Hay un nombre y un valor de propiedad que son obligatorios y que no están incluidos en el diccionario securityDefinitions. Agregue esta propiedad y valor para solucionar este problema. |
| SpecificationVersionIncorrect | The 'swagger' property must have the string value "2.0". |
Solo se admite la versión "2.0", corrija la propiedad de la versión de Swagger para que sea "2.0". |
| TagRedefined | The 'tags' property defines tag '{0}' multiple times. |
Las etiquetas definidas en la propiedad 'tags' deben ser únicas. Elimine o reemplace las repeticiones. |
| TooManyConnectorCategories | The maximum allowed number of categories for the connector is '{0}'. |
Existe un límite en el número de categorías que se pueden configurar para el conector. |
| UrlNotValid | The 'url' property must be a valid absolute URL. |
Su Swagger tiene una URL no válida. Esto puede deberse a una copia incorrecta de la URL desde algún lugar. |
Response
| Error | Incidencia | Solución |
|---|---|---|
| BodyParameterSchemaRequired | The 'body' parameter must define a 'schema' property. |
En el parámetro del cuerpo se debe definir la propiedad del esquema. Defina la propiedad del esquema para solucionar 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. |
Hay demasiados esquemas en la operación en el objeto del cuerpo. Quite algunos de ellos para que el total vuelva a estar por debajo del límite. |
| DefaultResponseHasSchema | The 'default' response should not have schema definition. Schemas should be defined on expected responses only. |
Su Swagger contiene una definición de esquema para la respuesta predeterminada. La eliminación de esta definición de esquema para la respuesta predeterminada corrige este error. |
| InvalidCustomEditorExtension DictionaryValue |
The 'x-ms-editor' extension can be specified as 'dictionary' only for schema with type object and additional properties allowed. |
Verifique si el x-ms-editor solo está configurado como diccionario cuando el esquema es de tipo objeto y está configurado para propiedades adicionales permitidas. |
| JsonPointerNotValid | The JSON Pointer path is not valid. |
Una referencia (#ref) que se usa en su Swagger no es válida. |
| NonBodyParameterSchemaNotValid | The parameter cannot define a schema as it is not in the 'body'. |
Su Swagger tiene un parámetro que usa 'esquema', pero solo los parámetros de cuerpo pueden usar 'esquema'. |
| RequiredLoopInSchemaNotAllowed | Loops of required schema properties are not allowed. |
La especificación de propiedades requeridas no puede usar bucles de referencia. |
| ResponseExampleMustBeProduced ByOperation |
The response example '{0}' is not produced by the operation '{1}'. |
Su Swagger tiene una operación con un ejemplo de respuesta, pero esa misma operación no produce una respuesta con el tipo MIME indicado. |
| ResponseHeadersAreNotUnique | The response headers are not unique. |
Hay un encabezado de respuesta duplicado. Los encabezados de respuesta deben ser únicos. |
| ResponseMustBeDefaultOrHttpStatusCode | The response is not valid, the response must be a valid HTTP status code, or the string 'default'. |
Su Swagger no tiene un código de estado HTTP predeterminado o un código de estado HTTP válido. Agregue un código de estado a su respuesta. |
| ResponseReferenceNotFound | The response reference '{0}' could not be found in the swagger document. |
Su Swagger tiene una referencia de respuesta que no se puede encontrar en el documento de Swagger. Elimine la referencia a esta respuesta. |
| ResponseReferenceNotValid | The response reference '{0}' is not valid. Response references must start with '#/responses/' and be valid JSON Pointers. |
Su Swagger tiene una referencia de respuesta (“#/responses/”) que no es válida según la especificación RFC del puntero 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. |
A su operación le falta un esquema de respuesta para el código de respuesta 200 o 201. Para webhooks, el esquema de respuesta debe especificarse como parte de la extensión del contenido de la notificación. |
| SchemaReferenceNotFound | The schema reference '{0}' could not be found in the swagger document. |
Su Swagger tiene una referencia de esquema que no se puede encontrar en el documento de Swagger. |
| SchemaReferenceNotValid | The schema reference '{0}' is not valid. Schema references must start with '#/definitions/' and be valid JSON Pointers. |
Su Swagger tiene una referencia de esquema (‘#/definitions/’) que no es válida según la especificación RFC del puntero JSON. |
| SchemaRefLoopNotAllowed | The schema definition may not use a '$ref' to point to another definition. |
Hay un bucle de referencia en su esquema (A apunta a B, que apunta de nuevo a A). |
| SchemaTooDeep | The schema exceeds the maximum allowed depth. Schemas must not exceed a depth of '{0}', including referenced ('$ref') schemas. |
Los esquemas están limitados a una profundidad JSON específica. Utilice un 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'. |
El uso del tipo de esquema 'file' solo se admite en datos de formulario y debe estar en la raíz del esquema de respuesta para la definición de respuesta. |
| SchemeNotSupported | The WebSocket transfer protocol schemes are not supported. |
Este esquema no se admite. Los esquemas admitidos son Https y Http. |
| TotalSchemaCountExceedsMaxAllowed | The maximum allowed number of schemas in the swagger is '{0}'. Please remove any unnecessary property or item definitions. |
Hay demasiados esquemas en el Swagger. |
Seguridad
| Error | Incidencia | Solución |
|---|---|---|
| OAuthSecurityRequirementValueMustBe ScopeName |
The OAuth security requirement '{0}' refers to scope name '{1}', but this is not defined in the 'securityDefinitions' object. |
Los nombres de los requisitos de seguridad deben ser un nombre de ámbito definido en el objeto de definiciones de seguridad. |
| SecurityRequirementMustBeDefined | The security requirement '{0}' is not defined in the 'securityDefinitions' object. |
Se utiliza un requisito de seguridad, pero no se define en el diccionario de definiciones de seguridad. |
| SecurityRequirementMustHaveEmptyValue | The security requirement '{0}' cannot specify any scopes, an empty array should be provided. |
Según la configuración actual, los requisitos de seguridad con el nombre '{0}' debe ser una matriz vacía. |
| SecurityRequirementMustHaveValue | The security requirement '{0}' must have have a value. Provide an empty array if no OAuth scopes are required. |
Falta el requisito de seguridad o es nulo. Si no se requieren ámbitos de OAuth, especifique una matriz vacía en su lugar. |
Webhooks
| Error | Incidencia | Solución |
|---|---|---|
| NotificationUrlNotAllowedInThisPosition | The notification URL property is not allowed in this position. It is allowed only in input body. |
La propiedad “x-ms-notification-url" solo debe definirse en una entrada. |
| NotificationUrlNotInternal | The notification URL property itself or at least one of its parents must be internal. |
Su Swagger actualmente no está configurando la propiedad de URL de notificación como interna, que debería ser el caso. |
| NotificationUrlNotRequired | The notification URL property must be required all the way through the schema chain. |
Su Swagger actualmente no requiere propiedad de URL de notificación, que debería ser obligatoria. |
| NotificationUrlNotString | The notification URL property must be of type string. |
La propiedad de URL de notificación tiene un valor que no es de tipo cadena. |
Metadatos
| Error | Incidencia | Solución |
|---|---|---|
| AllowEmptyValueOnlyValidForQuery FormData |
The parameter cannot use the 'allowEmptyValue' keyword as it is not in the 'query' or 'formData' location. |
La propiedad 'allowEmptyValue' solo se puede establecer en 'true' en un parámetro que tenga una propiedad 'property' que es 'query' o 'formData'. El valor de la propiedad 'location' no es ninguno de ambos. |
| DiscriminatorMustBeARequiredStringProperty | The 'discriminator' value must be the name of a required string property. |
El valor de 'discriminator' debe ser el nombre de una propiedad de cadena requerida en su Swagger. |
| ExclusiveMaximumRequiresMaximum | The 'exclusiveMaximum' keyword can only be specified if the 'maximum' keyword is also specified. |
No puede especificar un “exclusiveMaximum” sin especificar también un "maximum". |
| ExclusiveMinimumRequiresMinimum | The 'exclusiveMinimum' keyword can only be specified if the 'minimum' keyword is also specified. |
No puede especificar un “exclusiveMinimum” sin especificar también un “minimum”. |
| FieldLengthExceeded | The '{0}' value goes over the character limit '{1}' |
Un campo con el nombre especificado en {0} supera el límite de caracteres especificado en {1}. |
| FieldLengthNotInRange | The '{0}' value must be between '{1}' and '{2}' characters. |
{0} es el nombre del campo, {1} es la longitud mínima, {2} es el límite. Disminuya la longitud de los caracteres en este campo. |
| MaxItemsMustBeGreaterThanOrEqual ToZero |
The 'maxItems' value must be greater than or equal to zero. |
El valor de 'maxItems' actualmente está por debajo de cero, cambie este valor a mayor o igual a cero. |
| MaxLengthMustBeGreaterThanOrEqual ToZero |
The 'maxLength' value must be greater than or equal to zero. |
El valor de la propiedad “maxLength” debe ser un número no negativo. |
| MaxPropertiesMustBeGreaterThanOrEqual ToZero |
The 'maxProperties' value must be greater than or equal to zero. |
El valor de 'maxProperties' actualmente está por debajo de cero, cambie este valor a mayor o igual a cero. |
| MinimumShouldBeLessThanOrEqual ToMaximum |
The 'minimum' value should be less than or equal to the 'maximum' value. |
Cuando especifique un valor mínimo, el valor debe ser menor o igual que el valor máximo. |
| MinItemsMustBeGreaterThanOrEqual ToZero |
The 'minItems' value must be greater than or equal to zero. |
El valor de 'minItems' actualmente está por debajo de cero, cambie este valor a mayor o igual a cero. |
| MinItemsShouldBeLessThanOrEqual ToMaxItems |
The 'minItems' value should be less than or equal to the 'maxItems' value. |
Cuando especifique elementos mínimos, el valor debe ser menor o igual que los elementos máximos. |
| MinLengthMustBeGreaterThanOrEqual ToZero |
The 'minLength' value must be greater than or equal to zero. |
El valor de la propiedad “minLength” debe ser un número no negativo. |
| MinLengthShouldBeLessThanOrEqual ToMaxLength |
The 'minLength' value should be less than or equal to the 'maxLength' value. |
Cuando especifique una longitud mínima, el valor debe ser menor o igual que la longitud máxima. |
| MinPropertiesMustBeGreaterThanOrEqual ToZero |
The 'minProperties' value must be greater than or equal to zero. |
El valor de 'minProperties' actualmente está por debajo de cero, cambie este valor a mayor o igual a cero. |
| PatternShouldBeValidRegularExpression | The 'pattern' value should be a valid regular expression. |
El valor de 'patrón' no es una expresión regular válida, si corrige la expresión regular se solucionará este error. |
| RequiredValueEmpty | The '{0}' property must have not empty value. |
Su Swagger contiene un valor vacío para una propiedad que se requiere. Establezca el valor de esta propiedad requerida para solucionar este problema. |
| ValueContainsRestrictedWords | The value '{0}' contains at least one of the restricted words: '{1}'. |
Uno de los campos del Swagger utiliza una palabra restringida. |
| ValueMustBeInEnglish | The '{0}' value must be written in English. |
Reemplace el valor con un valor que contenga solo caracteres alfanuméricos. |
| ValueMustEndWithAlphanumeric | The '{0}' value must end with alphanumeric character. |
Reemplace el último carácter con un carácter alfanumérico |