Исправление ошибок средства проверки Swagger
В этой статье описаны распространенные ошибки проверки swagger, которые могут возникнуть для соединителей 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} — это ключевое слово, такое как «uniqueItems», и оно не разрешено в контексте, где оно используется. |
Параметры
| Error | Выпуск | Решение |
|---|---|---|
| FileParameterMustBeInFormData | Parameters of type 'file' are not valid in locations other than 'formData'. |
У вашего Swagger есть параметр с типом «файл», и он может находиться только «в» 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. |
Ваше чванство определяет как параметр тела, так и 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. |
В вашем чванстве есть лишнее свойство, которое необходимо удалить. |
| 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}. |
Значение свойства перечисление не соответствует текущим доступным параметрам. Измените значение на одно из следующих, указанных в сообщении об ошибке. |
| 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 и поэтому должно быть определено в свойствах. |
| 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 требует изменения значения. |
| 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 есть параметр, который использует "схему", но только параметры текста могут использовать "схему". |
| 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'. |
Использование типа схемы «файл» поддерживается только в данных формы и должно быть в корне схемы ответа для определения ответа. |
| 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. |
Значение «шаблон» не является допустимым регулярным выражением. Исправление регулярного выражения устраняет эту ошибку. |
| 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. |
Замените последний символ буквенно-цифровым символом |