Поделиться через


Исправление ошибок средства проверки Swagger

В этой статье рассматриваются распространенные ошибки проверки Swagger, которые могут возникнуть для соединителей Microsoft Copilot Studio и Microsoft Power Platform, и способы их исправления.

Операции

Error Выпуск Решение
ApiAnnotationExtensionReplacementInfo
ForNonDeprecatedOperations
The 'x-ms-api-annotation' extension for operation '{0}' is invalid. The replacement property should be specified for deprecated operations only. Операция {0} не помечена как устаревшая. Чтобы использовать это свойство, операция должна иметь свойство «устаревшая», установленное как true. В противном случае, если это не так, удалите свойство x-ms-api-annotation.
ApiAnnotationExtensionReplacementInfo
MissingApiProperty
The 'x-ms-api-annotation' extension for operation '{0}' is invalid. The replacement property must specify 'api' property. В аннотации x-ms-api-annotation указано свойство replacement, но свойство api отсутствует. Чтобы использовать свойство replacement, должны быть заданы свойства api и operationId.
ApiAnnotationExtensionReplacementInfo
MissingOperationIdProperty
The 'x-ms-api-annotation' extension for operation '{0}' is invalid. The replacement property must specify 'operationId' property. В аннотации x-ms-api-annotation указано свойство replacement, но свойство operationId отсутствует. Чтобы использовать свойство replacement, должны быть заданы свойства api и operationId.
ArrayDuplicateValue The array contains duplicate values, values must be unique. Массивы должны иметь уникальные значения, но ваш Swagger содержит дубликаты. Удалите дубликаты.
BodyOrFormDataParameterInFetch
OperationNotAllowed
Body or form data parameters are not supported in a fetch operation. Операции, использующие HTTP-метод "GET", не могут иметь данные текста или формы.
ConnectionIdParameterNotAllowed A parameter cannot be named as 'connectionId'. Переименуйте параметр в значение, отличное от connectionId.
ConsumesMissing At least one supported MIME type must be provided in 'consumes' for operation '{0}'. Ваше Swagger должен указывать один поддерживаемый тип MIME в потреблениях для операции.
DuplicateEnumValuesInExtension The 'x-ms-enum-values' extension has duplicate values. You can only have one display name mapped to a value. Значения перечисления должны быть уникальными и не дублироваться.
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} — это идентификатор операции, {1} — это идентификатор повторяющейся операции, {2} — это путь операции, {3} — это путь повторяющейся операции. Удалите идентификатор повторяющейся операции из пути повторяющейся операции.
DynamicExtensionDefinitionNotAllowed
InParameter
Dynamic extensions are not allowed to be defined on the body parameter. It should be in the schema. Динамические расширения определены в параметре текста и должны быть удалены. Это может быть определено только в схеме.
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 должен быть определен. Больше информации: Как использовать динамические значения
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 должен быть определен. Больше информации: Как использовать динамические значения
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-list- properties" должен быть определен. Больше информации: Как использовать динамические значения
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-list- properties должен быть определен. Больше информации: Как использовать динамические значения
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. В вашем файле Swagger отсутствует атрибут "x-ms-dynamic-properties", который является обязательным, поскольку он определяет "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}'. Путь к значению элемента расширения динамических свойств не соответствует ожидаемому пути, основанному на схеме.
DynamicTreeExtensionMissing The 'x-ms-dynamic-tree' extension must be defined to enable file picker support. Свойство "x-ms-dynamic-tree" отсутствует и должно быть определено для поддержки средства выбора файлов.
InvalidEnumValue The type of the enum value is '{0}' but it should be '{1}' as specified in the schema. Значение должно быть заменено на указанный тип.
InvalidEnumValuesExtensionValue The 'value' field must match one of the enums as defined in the 'enum' property of the schema. Выбранное перечисление не было определено в списке перечислений. Либо определите значение в свойстве enum, либо используйте значение, определенное в свойстве enum.
InvalidFormDataParameterName The form data parameter name '{0}' is invalid. All characters must be part of the US-ASCII character set. Переименуйте имя параметра данных формы, чтобы оно включало только символы US-ASCII.
InvalidNextLinkNameValue The nextLinkName value for operation '{0}' is invalid. Supported values are 'nextLink' or '@odata.nextLink'. Исправьте значение свойства "nextLinkName", чтобы оно было либо "nextLink", либо "@odata.nextLink". Любые другие значения не допускаются.
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} — это идентификатор операции. Определите в ответе операции возврат массива типа.
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} — это идентификатор операции. Определите в ответе операции конкретное свойство
MimeTypeNotCompatibleWithRequest
ContentSchemaType
The MIME type(s) are not compatible with the request content type '{0}' for operation '{1}'. Тип MIME, который вы пытаетесь использовать, несовместим с содержимым вашего запроса в указанной операции.
NotificationExtensionNotSupportedIn
WebhookOperation
The 'x-ms-notification' extension must not be defined in a webhook operation. Использование "x-ms-notification" в операции веб-перехватчика запрещено.
NotificationExtensionSupportedFor
TriggerOnly
The 'x-ms-notification' is supported for trigger operations only. Расширение "x-ms-notification" можно использовать только для триггерных операций.
NotificationOperationMustBeWebhook The 'operationId' property in 'x-ms-notification' extension must be for a webhook operation. При использовании "x-ms-notification" идентификатор операции должен относиться к операции веб-перехватчика.
OperationFamilyHasDuplicateRevisions The operation family '{0}' has operations with duplicate revision. Ваш Swagger определяет семейство операций с тем же номером версии/редакции. Каждая операция в семействе операций должна иметь уникальный номер версии.
OperationFamilyHasManyActive
Операции
The operation family '{0}' has more than two active operations. Extra operations must be deprecated. Семейства операций ограничены до двух не устаревших операций. Все остальные должны быть помечены как устаревшие, чтобы не запутать пользователя вашего соединителя.
OperationFamilyHasManyActive
ProductionOperations
The operation family '{0}' has several active operations in Production status. Previous revisions should be deprecated. Семейство операций включает в себя несколько производственных операций. Чтобы избежать путаницы, ограничьте количество производственных операций в семействе и исключите остальные.
OperationFamilyHasManyEmptyRevisions The operation family '{0}' has several operations with empty revision. Only one operation can have empty revision. Семейства операций могут иметь только одну операцию без редакции. Все остальные в семействе должны иметь редакцию.
OperationHasManyResponsesWithSchema The operation '{0}' has more than one response with specified schema, only one schema will be used in the designer. Ограничения конструктора предотвращают создание схем множественных ответов. Ваша операция указывает несколько, но должна указывать только один.
OperationIdNotFound The 'operationId' could not be found in this swagger document. operationId не может быть найден в вашем Swagger.
OperationIdNotUnique The operationId '{0}' is used multiple times. Operation identifiers must be unique. Один и тот же operationId встречается более одного раза. Удалите один из экземпляров или исправьте один из экземпляров, чтобы он отличался.
OperationIdRequired The operation 'operationId' property is required. Свойство "operationId" отсутствует, включите свойство "operationId" для своей операции.
OperationIdSanitized The 'operationId' property value is different from its sanitized value '{0}'. Please avoid the useage of non-alphanumeric characters to have matching values. Предоставленный идентификатор операции не соответствует очищенной версии. Обновите идентификатор операции, чтобы он соответствовал.
OperationIdShouldEndWithRevision The operation Id '{0}' should end with revision suffix '{1}'. Идентификаторы операций с редакцией должны иметь имя с суффиксом редакции.
OperationIdTooLong The operationId length must be less than '{0}'. Уменьшите значение свойства "operationId" так, чтобы длина символов была меньше, чем {0}.
OperationMissingPathParameter The operation '{0}' does not define the '{1}' parameter which is required by the path. У вашего Swagger есть операция, которая не определяет параметр, который, по-видимому, требуется для его шаблона пути.
OperationMissingRequiredProperty The target operation requires parameter '{0}'. У операции есть параметр "{0}", определенный как требуется, но это не определено в предоставленных параметрах. Добавьте этот параметр, чтобы устранить проблему.
OperationMustHaveNotification
ContentExtension
The operation '{0}' is missing notification content extension as it has '{1}' properties marked as notification URL. Ваш Swagger содержит операцию, не имеющую расширения содержимого уведомления. (Требуется больше контекста)
OperationMustHaveResponse The operation is not valid, it must contain at least one response definition. У вашего Swagger есть операция, для которой нет ни одного определения ответа.
OperationParameterNameIsAmbiguous The parameter name is ambiguous as it matches both a parameter name and a path to a body property. Имя параметра используется как имя параметра и имя пути к тексту параметра. Переименуйте один из экземпляров, чтобы устранить эту проблему.
OperationParameterNameNotFound The parameter could not be found in operation '{0}' in the swagger document. Параметр операции не может быть найден в вашем 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. Параметр является обязательным, но в значении для операции указано, что он является необязательным, что вызывает это несоответствие.
OperationParametersAreNotUnique The parameters in the operation '{0}' are not unique. Похоже, в параметрах операции есть дубликат. Для вашего Swagger необходимо удалить дубликаты параметров операции.
OperationParametersContain
DuplicateParameter
The operation '{0}' contains duplicate parameters with name '{1}', location '{2}'. Есть операционный параметр, который указан дважды. {0} — это название операции, {1} — дублированное имя параметра, {2} — это дублированное расположение параметра (свойство "in" в Swagger). Удалите повторное появление свойства.
OperationParametersContain
MultipleBodyParameters
The operation '{0}' contains multiple parameters in the location 'body', at most one is allowed. Параметры операции содержат дублированные параметры текста. Удалите один из параметров текста.
OperationParameterStaticTypeMismatch The parameter has type '{0}', but a static value is provided of type '{1}'. Параметр имеет статический тип, когда это не ожидается для этого параметра операции.
OperationParameterTypeMismatch The parameter has type '{0}', but operation '{1}' is providing a parameter of type '{2}'. Параметр и операция имеют разные типы. Сделайте так, чтобы тип вашего параметра и вашей операции совпадали.
OperationPathContainsUnsupportedCharacters The operation path cannot contain wildcard character '*'. Одна из ваших операций указывает путь URL-адреса, который содержит неподдерживаемые символы (например, подстановочный знак).
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. Путь операции не может содержать символы '?' и '#', если они не закодированы в URL-адресе (не переведены в их эквиваленты %xx).
OperationPathMustStartWithSlash The path is not valid, it must start with a '/' character. Если вы используете путь операции, который вы пытаетесь достичь, он должен начинаться с символа "/". Чтобы исправить эту проблему, включите символ "/" в начало пути.
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 содержит рабочий путь с незакрытыми символами "{" или "}". Эти символы используются для ссылки на переменную в пути, поэтому они не могут существовать в пути, когда они не закрыты.
OperationPathVariablesContainDefaults The operation path template variables cannot set default values with character '='. Одна из ваших операций указывает значение по умолчанию для параметра, содержащего "=". Этот параметр также указывается в пути URL-адреса. Эта комбинация недопустима.
OperationRevisionEmpty The operation '{0}' does not specify a revision in api annotation. Операция помечена как часть семейства, но не имеет редакции.
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. В операции слишком много схем. Удалите некоторые из них, чтобы итог снова оказался ниже установленного.
OperationShouldHaveSuccessfulResponse The operation '{0}' should have at least one successful response definition. У вашего Swagger есть операция, для которой нет ни одного успешного определения ответа.
OperationStatusAheadOfConnector The operation '{0}' cannot be in a Production status ahead of the connector. Операции нельзя пометить как "Производство", пока весь соединитель находится в режиме "Предварительная версия".
OperationSummaryTooLong The operation 'summary' should be fewer than {0} characters for improved readablity. Уменьшите свойство "summary" операции до менее 120 символов.
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} — это идентификатор операции, {1} — это путь операции, {2} — это набор частично дублированных путей операции. Измените путь операции, чтобы увеличить различие между одинаковыми путями операции.
PathParameterMustBeRequired The parameter must be marked as required as it is used in the operation path. Include the 'required' property, with the value 'true'. Для параметра задано расположение "Path", поэтому для свойства "required" необходимо установить значение "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. В одной из ваших операций есть параметр, который помечен как находящийся в пути операции, но не существующий в шаблоне пути.
PathParametersContain
DuplicateParameter
The path '{0}' contains duplicate parameters with name '{1}', location '{2}'. {0} — путь операции. {1} — это дублированное имя параметра. {2} — расположение (свойство "in") дублированного параметра. Удалите дублированный параметр пути.
PathParametersContainMultiple
BodyParameters
The path '{0}' contains multiple parameters in the location 'body', at most one is allowed. Не может быть нескольких параметров для операции, которые оба находятся в тексте. Чтобы исправить эту ошибку, удалите один из параметров.
PathRedefined The path '{0}' is defined multiple times with different capitalization. Paths must be unique when compared case-insensitively. Один и тот же путь определен более одного раза. Удалите или переименуйте экземпляры, чтобы они были уникальными.
RestrictedCharactersInSummary Summary string contains any of the restricted characters [{0}] Сводка одной из ваших операций содержит запрещенные символы. Чтобы исправить эту ошибку, удалите символы или перефразируйте сводку.
SelectedItemValuePathNotAllowedIn
ThisPosition
The 'selectedItemValuePath' property is not allowed in this position. It is allowed only in 'browse' operation of 'x-ms-dynamic-tree' extension. Где бы вы ни разместили "selectedItemValuePath", это недопустимо. Удалите или поместите в допустимое место.
StringBinaryNotSupportedFor
FormUrlEncoded
String/binary parameters are not supported for operation '{0}' with 'application/x-www-form-urlencoded' consumes type. У операции есть значение "application/x-www-form-urlencoded", определенное в свойстве "consumes". Параметры этой операции не могут быть строкового или двоичного типа.
TotalOperationsCountExceedsMaxAllowed The total number of operations in the swagger exceeds the maximum allowed value of '{0}'. В Swagger слишком много операций.
UnrecognizedTypeFormat The type/format '{0}' is not recognized. Данный тип/формат "{0}" неизвестен. Проверьте наличие опечаток или документацию, чтобы подтвердить поддерживаемые форматы типов.
WebhookOperationsMissingNotification
UrlProperty
The webhook operation '{0}' is missing notification URL property. Ваш Swagger содержит операцию веб-перехватчика, для которой отсутствует свойство URL-адреса уведомления. Добавление этого свойства в операцию веб-перехватчика исправляет операцию.

Массивы

Ошибка Выпуск Решение
ArrayHasNoItems The array should have items specified. Массив пуст, но пустой массив не допускается.
RequiredPropertyArrayEmpty The 'required' array requires at least one value. If no properties are required in the schema, remove the 'required' property. У вашего Swagger есть пустой массив для свойства с именем "required". Его следует удалить, если нет обязательных параметров.
SchemesArrayEmpty The 'schemes' array requires at least one value. Схемы не могут быть пустыми и должны иметь хотя бы одно значение.

Неподдерживаемые

Ошибка Выпуск Решение
CollectionFormatValueNotSupported The 'collectionFormat' keyword value '{0}' is not supported. Поддерживаются только определенные форматы коллекций. Ваш Swagger содержит неподдерживаемый формат.
MimeTypeNotSupported The MIME type '{0}' is not supported. The supported mime types are: '{1}'. Тип MIME, который вы пытаетесь использовать в своем Swagger, не поддерживается.
PathItemRefNotSuppored The '$ref' property in a path is not supported. Для пути не может быть определено свойство "$ref". Удалите это свойство.
SwaggerKeywordNotSupported The '{0}' keyword is not supported. {0} является ключевым словом Swagger, например "uniqueItems", и не допускается в контексте, в котором оно используется.

Параметры

Error Выпуск Решение
FileParameterMustBeInFormData Parameters of type 'file' are not valid in locations other than 'formData'. У вашего Swagger есть параметр с типом "файл", и он может быть только in в "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. Ваш Swagger определяет как параметр текста, так и formData, что недопустимо. Удалите один из этих типов параметров.
ParameterReferenceNotFound The parameter reference '{0}' could not be found in the swagger document. У вашего Swagger есть ссылка на параметр, который нельзя найти в документе Swagger. Уберите ссылку на этот параметр.
ParameterReferenceNotValid The parameter reference '{0}' is not valid. Parameter references must start with '#/parameters/' and be valid JSON Pointers. В вашем Swagger есть ссылка на параметр ("#/parameters/"), который недопустим на основании спецификации RFC указателя JSON.
ParameterRefLoopNotAllowed The parameter definition may not use a '$ref' to point to another definition. У вашего Swagger есть определение параметра, в котором неправильно используется "$ref", чтобы указать на другое определение.
ParamtersWithSameNameMustHave
SameTypeAndVisibility
Parameters of the same name in fetch and subscribe operations must be of the same type and visibility. Если ваш Swagger имеет параметры с одинаковым именем в операциях получения и подписки, они должны иметь одинаковый тип и видимость.
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} — это имя параметра, в котором отсутствует кодировка.
QueryParameterEncodingNotSupported Encoding for query parameter '{0}' is not supported. All query parameters are single encoded by default. {0} — это имя параметра, в котором есть неподдерживаемая кодировка. Исправьте эту кодировку.
ReservedParameterIsUsed The parameter '{0}' is reserved and cannot be used in '{1}'. Параметр, указанный в этой ошибке, используется, но его нельзя использовать, потому что он зарезервирован для этого раздела или в целом.
ResponseRefLoopNotAllowed The response definition may not use a '$ref' to point to another definition. У вашего Swagger есть определение ответа, в котором неправильно используется "$ref", чтобы указать на другое определение.
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. Ссылка на параметр помечена как внутренняя, но операция, в которой используется ссылка на параметр, не является внутренней. Чтобы исправить это, обновите параметр или операцию.

Свойства

Error Выпуск Решение
AdditionalPropertyNotAllowed The property '{0}' is not allowed and must be removed. В вашем Swagger есть лишнее свойство, которое необходимо удалить.
AdditionalPropertyNotAllowedAdjacent
ToRef
When '$ref' is defined, no other properties may be specified. При использовании "$ref" в Swagger никакие другие свойства не должны быть включены в этот объект JSON.
BasePathNotValid The 'basePath' property, if present, must start with a '/' character. Если вы используете базовый путь, он должен начинаться с "/". Недопустимые базовые пути выглядят как "abc/def/ghi" или "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. Один из параметров текста в вашем Swagger использует недопустимое свойство, которое нельзя использовать в параметре текста.
ConnectorMetadataPropertiesMissing The connector metadata property '{0}' is required. Для соединителя требуются определенные метаданные.
ContactEmailNotValid The contact 'email' property, if present, must be a valid email address. Указанный адрес электронной почты имеет неправильный формат или содержит символы, отличные от ASCII.
DefaultValueMustMatchType The 'default' value is of type '{0}', but should match the given type '{1}'. Значение вашего значения по умолчанию не того же типа, что указанный тип. Измените значение по умолчанию на значение данного типа, чтобы устранить эту проблему.
EnumMustContainAtLeastOneElement The 'enum' array requires at least one value. Если ваш тип свойства является перечислением, он должен указывать массив, по крайней мере, с одним из значений перечисления.
ExtensionNameNotValid The property '{0}' is not valid. If this property is an extension, its name must begin with "x-". Свойства, являющиеся расширениями, должны начинаться с префикса "x-".
FilterFunctionsPropertyEmpty The 'filterFunctions' property must have at least one element. Свойство "filterFunctions" не может быть пустым, если задано.
FilterFunctionsPropertyHasDuplicates The 'filterFunctions' property cannot contain duplicates. Свойство "filterFunctions" не может содержать дубликаты.
FilterFunctionsPropertyInInputSchema The 'filterFunctions' property has to be in the response schema. Свойство "filterFunctions" может быть только в схеме ответа.
FilterFunctionsPropertyInvalidValue The 'filterFunctions' property supports only these values: {0}". Свойство "filterFunctions" не может указывать неподдерживаемое значение.
HostNameNotValid The 'host' property, if present, must be a valid URI host without a scheme or path. URI узла без схемы или пути выглядит как "www.microsoft.com". Недопустимый URI для узла выглядит как "https://www.microsoft.com/"" или "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. Свойство помечено как внутреннее, для него указано значение по умолчанию, и оно не является обязательным. Если вы хотите, чтобы это было включено в запросы, отметьте его как обязательное; или, если это так и задумано, его можно оставить как есть.
InvalidConnectorCategory The connector category is invalid. Available categories are: [{0}]. Категории могут поступать только из списка допустимых значений категорий.
InvalidStringBinaryProperty A schema with type/format 'string/binary' can only be at the top level of a body or formData parameter. Значение свойства "type" и "format", равное "строковое" и "двоичное", не допускается в этом месте схемы.
JsonTypeIncorrect The type of the property is incorrect. Expected type '{0}', but value is of type '{1}'. Свойство в вашем Swagger имеет один тип, но фактическое значение — другого типа. Измените тип значения, чтобы он соответствовал ожидаемому типу.
JsonValueNotInEnum The property value must be one of the following: {0}. Значение свойства перечисления in не соответствует текущим доступным параметрам. Измените значение на одно из следующих, указанных в сообщении об ошибке.
MimeTypeNotValid The MIME type '{0}' is not valid. Пользовательский MIME content type, который вы выбрали, недопустим. Допустимые типы MIME: "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'. В значениях x-ms-enum-values не указано свойство "displayName".
MultipleOfMustBeGreaterThanZero The 'multipleOf' value must be greater than zero. Значение свойства "multipleOf" должно быть больше нуля.
OneOfPropertiesRequired At least one of the properties is required: [{0}]. {0} — это набор свойств. Эта ошибка отображает все свойства, которые должны присутствовать в Swagger.
ProductionStatusOnBetaService The connector cannot be in Production status on a beta service. Соединитель не может быть помечен как "Производство", когда серверная служба находится в бета-версии. Он должен быть установлен как "предварительная версия".
PropertyMustBeRequired The property is internal and has a default value, it must be required. Optional internal fields are ignored. Свойство не задается, хотя это необходимо.
RequiredPropertyDefinitionMissing The required property '{0}' is not defined in the object schema. Свойство схемы указано как "required", поэтому должно быть определено в свойствах "properties"
RequiredPropertyMissing The '{0}' property is required. Свойство в вашем Swagger требуется, но в настоящее время его нет в вашем Swagger. Чтобы исправить эту ошибку, включите это свойство.
RequiredPropertyNotOnObject The property 'required' is applicable to schemas with 'object' type only and should be removed. Свойство "required" поддерживается только для типа "object". Удалите свойство для всех остальных типов.
RequiredReadOnlyPropertyNotAllowed
AsInput
An input property cannot be 'readonly' and required. Ваш Swagger содержит свойство, помеченное как readonly и required. Свойство readonly означает, что пользователь не может изменять значение. Свойство required требует изменения значения.
SchemeNotValid The 'schemes' property must only contain transfer protocols from the list: {0}. Свойство схемы должно иметь одно из значений "http" или "https".
SecuritySchemePropertyNotValid The security definition property '{0}' is not valid for definitions of type '{1}'. Существует недопустимое имя свойства и значение, которые вы включили в словарь securityDefinitions. Чтобы устранить эту проблему, измените это свойство на допустимое имя свойства.
SecuritySchemePropertyRequired The security definition property '{0}' is required for definitions of type '{1}'. Существуют требуемые имя свойства и значение, которые не включены в словарь securityDefinitions. Добавьте это свойство и значение, чтобы устранить эту проблему.
SpecificationVersionIncorrect The 'swagger' property must have the string value "2.0". Поддерживается только версия "2.0", поэтому исправьте свойство версии Swagger на "2.0".
TagRedefined The 'tags' property defines tag '{0}' multiple times. Теги, определенные в свойстве "tags", должны быть уникальными. Удалите или замените любые множественные вхождения.
TooManyConnectorCategories The maximum allowed number of categories for the connector is '{0}'. Существует ограничение на количество категорий, которые можно установить для соединителя.
UrlNotValid The 'url' property must be a valid absolute URL. У вашего Swagger недействительный URL. Это может быть из-за неправильного копирования URL откуда-то.

Отклик

Ошибка Выпуск Решение
BodyParameterSchemaRequired The 'body' parameter must define a 'schema' property. В параметре текста должно быть определено свойство схемы. Определите свойство схемы, чтобы устранить эту проблему.
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. В объекте текста слишком много схем. Удалите некоторые из них, чтобы итог снова оказался ниже установленного.
DefaultResponseHasSchema The 'default' response should not have schema definition. Schemas should be defined on expected responses only. Ваш Swagger содержит определение схемы для ответа по умолчанию. Удаление этого определения схемы для ответа по умолчанию устраняет эту ошибку.
InvalidCustomEditorExtension
DictionaryValue
The 'x-ms-editor' extension can be specified as 'dictionary' only for schema with type object and additional properties allowed. Проверьте, установлен ли x-ms-editor только для словаря, когда схема — тип объекта и задана для дополнительных разрешенных свойств.
JsonPointerNotValid The JSON Pointer path is not valid. Ссылка (#ref), используемая в вашем Swagger, недопустима.
NonBodyParameterSchemaNotValid The parameter cannot define a schema as it is not in the 'body'. У вашего Swagger есть параметр, который использует схему "schema", но только параметры текста могут использовать схему "schema".
RequiredLoopInSchemaNotAllowed Loops of required schema properties are not allowed. В спецификации требуемых свойств нельзя использовать ссылочные циклы.
ResponseExampleMustBeProduced
ByOperation
The response example '{0}' is not produced by the operation '{1}'. В вашем Swagger есть операция с примером ответа, но эта же операция не дает ответа с указанным типом MIME.
ResponseHeadersAreNotUnique The response headers are not unique. Заголовок ответа дублируется. Заголовки ответа должны быть уникальными.
ResponseMustBeDefaultOrHttpStatusCode The response is not valid, the response must be a valid HTTP status code, or the string 'default'. У вашего Swagger нет кода состояния HTTP по умолчанию или допустимого кода состояния HTTP. Добавьте код состояния в свой ответ.
ResponseReferenceNotFound The response reference '{0}' could not be found in the swagger document. У вашего Swagger есть ссылка на ответ, который нельзя найти в документе Swagger. Уберите ссылку на этот ответ.
ResponseReferenceNotValid The response reference '{0}' is not valid. Response references must start with '#/responses/' and be valid JSON Pointers. В вашем Swagger есть ссылка на ответ ("#/responses/"), который недопустим на основании спецификации RFC указателя 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. В вашей операции отсутствует схема ответа для кода ответа 200 или 201. Для веб-перехватчиков схема ответа должна быть указана как часть расширения содержимого уведомления.
SchemaReferenceNotFound The schema reference '{0}' could not be found in the swagger document. У вашего Swagger есть ссылка на схему, которую нельзя найти в документе Swagger.
SchemaReferenceNotValid The schema reference '{0}' is not valid. Schema references must start with '#/definitions/' and be valid JSON Pointers. В вашем Swagger есть ссылка на схему ("#/definitions/"), которая недопустима на основании спецификации RFC указателя JSON.
SchemaRefLoopNotAllowed The schema definition may not use a '$ref' to point to another definition. В вашей схеме есть ссылочный цикл (A указывает на B, что указывает обратно на A).
SchemaTooDeep The schema exceeds the maximum allowed depth. Schemas must not exceed a depth of '{0}', including referenced ('$ref') schemas. Схемы ограничены определенной глубиной JSON. Используйте менее глубокую схему.
SchemaTypeFileNotValid The schema type 'file' is not valid. Only parameters in 'formData' and the root response schema may be of type 'file'. Использование типа схемы "file" поддерживается только в данных формы и должно быть в корне схемы ответа для определения ответа.
SchemeNotSupported The WebSocket transfer protocol schemes are not supported. Эта схема не поддерживается. Поддерживаемые схемы: Https и Http.
TotalSchemaCountExceedsMaxAllowed The maximum allowed number of schemas in the swagger is '{0}'. Please remove any unnecessary property or item definitions. В Swagger слишком много схем.

Безопасность

Ошибка Выпуск Решение
OAuthSecurityRequirementValueMustBe
ScopeName
The OAuth security requirement '{0}' refers to scope name '{1}', but this is not defined in the 'securityDefinitions' object. Имена требований безопасности должны быть именем области, которое определено в объекте определений безопасности.
SecurityRequirementMustBeDefined The security requirement '{0}' is not defined in the 'securityDefinitions' object. Требование безопасности используется, но не определено в словаре определений безопасности.
SecurityRequirementMustHaveEmptyValue The security requirement '{0}' cannot specify any scopes, an empty array should be provided. Исходя из текущей конфигурации, требования безопасности с именем "{0}" должны быть пустым массивом.
SecurityRequirementMustHaveValue The security requirement '{0}' must have have a value. Provide an empty array if no OAuth scopes are required. Требование безопасности отсутствует или равно null. Если области OAuth не требуются, укажите вместо них пустой массив.

Веб-перехватчики

Ошибка Выпуск Решение
NotificationUrlNotAllowedInThisPosition The notification URL property is not allowed in this position. It is allowed only in input body. Свойство "x-ms-notification-url" следует определять только во входных данных.
NotificationUrlNotInternal The notification URL property itself or at least one of its parents must be internal. Ваш Swagger в настоящее время не задает свойство URL-адреса уведомления на внутреннее, а должно.
NotificationUrlNotRequired The notification URL property must be required all the way through the schema chain. Вашему Swagger в настоящее время не требуется свойство URL-адреса уведомления, которое должно быть обязательным.
NotificationUrlNotString The notification URL property must be of type string. Свойство URL-адреса уведомления имеет значение, не являющееся строкой типа.

Метаданные

Ошибка Выпуск Решение
AllowEmptyValueOnlyValidForQuery
FormData
The parameter cannot use the 'allowEmptyValue' keyword as it is not in the 'query' or 'formData' location. Свойству "allowEmptyValue" можно присвоить значение "true" только в параметре, имеющем свойство "location", которое имеет значение "query" или "formData". Значение свойства "location" не имеет значения.
DiscriminatorMustBeARequiredStringProperty The 'discriminator' value must be the name of a required string property. Значение "discriminator" должно быть именем обязательного строкового свойства в вашем Swagger.
ExclusiveMaximumRequiresMaximum The 'exclusiveMaximum' keyword can only be specified if the 'maximum' keyword is also specified. Вы не можете указать "exclusiveMaximum", не указав также "maximum".
ExclusiveMinimumRequiresMinimum The 'exclusiveMinimum' keyword can only be specified if the 'minimum' keyword is also specified. Вы не можете указать "exclusiveMinimum", не указав также "minimum".
FieldLengthExceeded The '{0}' value goes over the character limit '{1}' Поле с именем, указанным в {0}, превышает ограничение на количество символов, указанное в {1}.
FieldLengthNotInRange The '{0}' value must be between '{1}' and '{2}' characters. {0} — это имя поля, {1} — минимальная длина, {2} — это предел. Уменьшите длину символов в этом поле.
MaxItemsMustBeGreaterThanOrEqual
ToZero
The 'maxItems' value must be greater than or equal to zero. Значение maxItems в настоящее время ниже нуля. Измените это значение, чтобы оно было больше или равно нулю.
MaxLengthMustBeGreaterThanOrEqual
ToZero
The 'maxLength' value must be greater than or equal to zero. Значение свойства "maxLength" должно быть неотрицательным числом.
MaxPropertiesMustBeGreaterThanOrEqual
ToZero
The 'maxProperties' value must be greater than or equal to zero. Значение maxProperties в настоящее время меньше нуля. Измените это значение, чтобы оно было больше или равно нулю.
MinimumShouldBeLessThanOrEqual
ToMaximum
The 'minimum' value should be less than or equal to the 'maximum' value. При указании минимального значения оно должно быть меньше или равно максимальному значению.
MinItemsMustBeGreaterThanOrEqual
ToZero
The 'minItems' value must be greater than or equal to zero. Значение 'minItems' в настоящее время меньше нуля. Измените это значение, чтобы оно было больше или равно нулю.
MinItemsShouldBeLessThanOrEqual
ToMaxItems
The 'minItems' value should be less than or equal to the 'maxItems' value. При указании минимальных элементов значение должно быть меньше или равно максимальным элементам.
MinLengthMustBeGreaterThanOrEqual
ToZero
The 'minLength' value must be greater than or equal to zero. Значение свойства "minLength" должно быть неотрицательным числом.
MinLengthShouldBeLessThanOrEqual
ToMaxLength
The 'minLength' value should be less than or equal to the 'maxLength' value. При указании минимальной длины значение должно быть меньше или равно максимальной длине.
MinPropertiesMustBeGreaterThanOrEqual
ToZero
The 'minProperties' value must be greater than or equal to zero. Значение 'minProperties' в настоящее время меньше нуля. Измените это значение, чтобы оно было больше или равно нулю.
PatternShouldBeValidRegularExpression The 'pattern' value should be a valid regular expression. Значение pattern не является допустимым регулярным выражением, исправление регулярного выражения исправляет эту ошибку.
RequiredValueEmpty The '{0}' property must have not empty value. Ваш Swagger содержит пустое значение для обязательного свойства. Установка значения этого обязательного свойства устраняет эту проблему.
ValueContainsRestrictedWords The value '{0}' contains at least one of the restricted words: '{1}'. В одном из полей Swagger используется запрещенное слово.
ValueMustBeInEnglish The '{0}' value must be written in English. Замените значение значением, содержащим только буквенно-цифровые символы.
ValueMustEndWithAlphanumeric The '{0}' value must end with alphanumeric character. Замените последний символ буквенно-цифровым символом