Naprawianie błędów weryfikatora struktury Swagger

Narzędzie Swagger Validator sprawdza poprawność plików łączników przesłanych w repozytorium open-source GitHub i portalu ISV. Sprawdza pliki łączników, aby upewnić się, że są prawidłowe, i są zgodne z naszymi wymaganiami i wytycznymi dotyczącymi łączników.

Skorzystaj z tabel w tym temacie, aby znaleźć i naprawić błędy. W każdej tabeli wymieniono błędy, które może generować narzędzie. Dla każdego błędu występuje odpowiedni problem i rozwiązanie. Wymienione rozwiązania mogą pomóc w uniknięciu błędów przed przesłaniem lub podczas ich przesyłania.

Aby uzyskać dodatkowe wskazówki, wyślij wiadomość e-mail do ConnectorPartnerMgmtTeam@service.microsoft.com.

Operacje

Error Problem Rozwiązanie
ApiAnnotationExtensionReplacementInfo
ForNonDeprecatedOperations
The 'x-ms-api-annotation' extension for operation '{0}' is invalid. The replacement property should be specified for deprecated operations only. Operacja {0} nie jest oznaczona jako przestarzała. Aby użyć tej właściwości, operacja powinna mieć właściwość „deprecated” ustawioną na true. W przeciwnym razie, jeśli tak nie jest, usuń właściwość „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” ma określoną właściwość „replacement”, ale brakuje właściwości „api”. Aby użyć właściwości „replacement”, należy ustawić zarówno właściwość „api”, jak i „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” ma określoną właściwość „replacement”, ale brakuje właściwości „operationId”. Aby użyć właściwości „replacement”, należy ustawić zarówno właściwość „api”, jak i „operationId”.
ArrayDuplicateValue The array contains duplicate values, values must be unique. Tablice muszą mieć unikatowe wartości, ale swagger zawiera duplikaty. Usuń duplikaty.
BodyOrFormDataParameterInFetch
OperationNotAllowed
Body or form data parameters are not supported in a fetch operation. Operacje przy użyciu metody HTTP „GET” nie mogą mieć treści ani danych formularza.
ConnectionIdParameterNotAllowed A parameter cannot be named as 'connectionId'. Zmień nazwę parametru na wartość, która nie jest „connectionId”.
ConsumesMissing At least one supported MIME type must be provided in 'consumes' for operation '{0}'. Twój swagger powinien określać jeden obsługiwany typ MIME w zużywa do działania.
DuplicateEnumValuesInExtension The 'x-ms-enum-values' extension has duplicate values. You can only have one display name mapped to a value. Wartości wyliczenia powinny być unikatowe i nie duplikowane.
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} to identyfikator operacji, {1} czyli zduplikowany identyfikator operacji, {2} czyli ścieżka operacji {3} to ścieżka wykrywania duplikatów. Usuń zduplikowany identyfikator operacji ze ścieżki zduplikowanej operacji.
DynamicExtensionDefinitionNotAllowed
InParameter
Dynamic extensions are not allowed to be defined on the body parameter. It should be in the schema. Rozszerzenia dynamiczne są zdefiniowane w parametrze treści i muszą zostać usunięte. Można ją zdefiniować tylko w schemacie.
DynamicListExtensionRequiredFor
AmbiguousReferences
The 'x-ms-dynamic-values' extension references ambiguous parameter references. You need to define the 'x-ms-dynamic-list' extension. Należy zdefiniować listę „x-ms-dynamic-list”. Więcej informacji: Jak używać wartości dynamicznych
DynamicListExtensionRequiredFor
NonParameterReferences
The 'x-ms-dynamic-values' extension references properties within parameters. You need to define the 'x-ms-dynamic-list' extension. Należy zdefiniować listę „x-ms-dynamic-list”. Więcej informacji: Jak używać wartości dynamicznych
DynamicPropertiesExtensionRequiredFor
AmbiguousReferences
The 'x-ms-dynamic-schema' extension references ambiguous parameter references. You need to define the 'x-ms-dynamic-properties' extension. Należy zdefiniować „x-ms-dynamic- properties”. Więcej informacji: Jak używać wartości dynamicznych
DynamicPropertiesExtensionRequiredFor
NonParameterReferences
The 'x-ms-dynamic-schema' extension references properties within parameters. You need to define the 'x-ms-dynamic-properties' extension. Należy zdefiniować x-ms-dynamic- properties. Więcej informacji: Jak używać wartości dynamicznych
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. W Twoim pliku swagger brakuje „x-ms-dynamic-properties”, co jest wymagane, ponieważ definiuje „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}'. Ścieżka wartości elementu rozszerzenia właściwości dynamicznych nie jest zgodna ze ścieżką oczekiwaną na podstawie schematu.
DynamicTreeExtensionMissing The 'x-ms-dynamic-tree' extension must be defined to enable file picker support. Brak właściwości „x-ms-dynamic-tree” i należy ją zdefiniować, aby obsługiwać selektor plików.
InvalidEnumValue The type of the enum value is '{0}' but it should be '{1}' as specified in the schema. Aby wartość była określonego typu, należy ją zastąpić.
InvalidEnumValuesExtensionValue The 'value' field must match one of the enums as defined in the 'enum' property of the schema. Wybrane wyliczenie nie zostało zdefiniowane na liście wyliczeń. Zdefiniuj wartość we właściwości enum lub użyj wartości zdefiniowanej we właściwości enum.
InvalidFormDataParameterName The form data parameter name '{0}' is invalid. All characters must be part of the US-ASCII character set. Zmień nazwę parametru danych formularza, aby zawierała tylko znaki US-ASCII.
InvalidNextLinkNameValue The nextLinkName value for operation '{0}' is invalid. Supported values are 'nextLink' or '@odata.nextLink'. Napraw wartość właściwości „nextLinkName”, tak aby była to „nextLink” lub „@odata.nextLink”. Inne wartości są niedozwolone.
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} to ścieżka do właściwości odpowiedzi, {1} to identyfikator operacji. Zdefiniuj w odpowiedzi operacji zwrot typu tablica.
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} to ścieżka do właściwości odpowiedzi, {1} to identyfikator operacji. Zdefiniuj w odpowiedzi na operację konkretną właściwość
MimeTypeNotCompatibleWithRequest
ContentSchemaType
The MIME type(s) are not compatible with the request content type '{0}' for operation '{1}'. Typ MIME, którego próbujesz użyć, nie jest zgodny z treścią żądania w określonej operacji.
NotificationExtensionNotSupportedIn
WebhookOperation
The 'x-ms-notification' extension must not be defined in a webhook operation. Używanie „x-ms-notification” jest niedozwolone w operacji webhooka.
NotificationExtensionSupportedFor
TriggerOnly
The 'x-ms-notification' is supported for trigger operations only. Rozszerzenie „x-ms-notification” może być używane tylko do operacji wyzwalania.
NotificationOperationMustBeWebhook The 'operationId' property in 'x-ms-notification' extension must be for a webhook operation. W przypadku korzystania z opcji „x-ms-notification” identyfikator operacji musi odnosić się do operacji elementu webhook.
OperationFamilyHasDuplicateRevisions The operation family '{0}' has operations with duplicate revision. Twój swagger definiuje rodzinę operacji o tym samym numerze wersji/zmiany. Każda operacja w rodzinie operacji powinna mieć unikalny numer wersji.
OperationFamilyHasManyActive
Operacje
The operation family '{0}' has more than two active operations. Extra operations must be deprecated. Rodziny operacji są ograniczone do dwóch nieużywanych operacji. Wszystkie inne powinny być oznaczone jako przestarzałe, aby zmniejszyć zamieszanie dla użytkownika łącznika.
OperationFamilyHasManyActive
ProductionOperations
The operation family '{0}' has several active operations in Production status. Previous revisions should be deprecated. Rodzina operacji ma wiele operacji w produkcji. Aby zmniejszyć zamieszanie, ogranicz liczbę operacji produkcyjnych w rodzinie i odrzuć resztę.
OperationFamilyHasManyEmptyRevisions The operation family '{0}' has several operations with empty revision. Only one operation can have empty revision. Rodziny operacji mogą mieć tylko jedną operację bez zmian. Wszyscy w rodziny powinni mieć poprawki.
OperationHasManyResponsesWithSchema The operation '{0}' has more than one response with specified schema, only one schema will be used in the designer. Ograniczenia w projektancie uniemożliwiają schematy wielokrotnych odpowiedzi. Twoja operacja określa wiele, ale powinna określać tylko jeden.
OperationIdNotFound The 'operationId' could not be found in this swagger document. Nie można znaleźć identyfikatora operacji w twoim swaggerze.
OperationIdNotUnique The operationId '{0}' is used multiple times. Operation identifiers must be unique. Ta sama operationId jest wyświetlana więcej niż raz. Należy usunąć jedno z wystąpień lub poprawić jedno z wystąpień jako inne.
OperationIdRequired The operation 'operationId' property is required. Brak właściwości „operationId”, dołącz właściwość „operationId” dla swojej operacji.
OperationIdSanitized The 'operationId' property value is different from its sanitized value '{0}'. Please avoid the useage of non-alphanumeric characters to have matching values. Podany identyfikator operacji nie odpowiada wersji oczyszczonej. Zaktualizuj identyfikator operacji, aby pasował.
OperationIdShouldEndWithRevision The operation Id '{0}' should end with revision suffix '{1}'. Identyfikatory operacji z rewizją powinny mieć nazwę z przyrostkiem rewizji.
OperationIdTooLong The operationId length must be less than '{0}'. Zmniejsz wartość właściwości „operationId”, aby długość znaku była mniejsza niż {0}.
OperationMissingPathParameter The operation '{0}' does not define the '{1}' parameter which is required by the path. Twój swagger ma operację, która nie definiuje parametru, który wydaje się być wymagany przez szablon ścieżki.
OperationMissingRequiredProperty The target operation requires parameter '{0}'. Operacja ma parametr „{0}” zdefiniowany jako wymagany, ale nie jest on zdefiniowany w dostarczonych parametrach. Dodaj ten parametr, aby rozwiązać problem.
OperationMustHaveNotification
ContentExtension
The operation '{0}' is missing notification content extension as it has '{1}' properties marked as notification URL. Twój swagger zawiera operację, która nie ma rozszerzenia treści powiadomienia. (Potrzebujesz więcej kontekstu)
OperationMustHaveResponse The operation is not valid, it must contain at least one response definition. Twój swagger ma operację, która nie ma co najmniej jednej definicji odpowiedzi.
OperationParameterNameIsAmbiguous The parameter name is ambiguous as it matches both a parameter name and a path to a body property. Nazwa parametru jest używana jako nazwa parametru i nazwa ścieżki treści parametru. Zmień nazwę jednej z instancji, aby rozwiązać ten problem.
OperationParameterNameNotFound The parameter could not be found in operation '{0}' in the swagger document. Nie można znaleźć nazwy parametru operacji w swoim swaggerze.
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. Parametr jest wymagany, ale wartość operacji wskazuje, że jest opcjonalny, powodując tę niezgodność.
OperationParametersAreNotUnique The parameters in the operation '{0}' are not unique. Wydaje się, że w parametrach operacji występuje duplikat. Twój swagger musi usunąć duplikaty parametrów operacji.
OperationParametersContain
DuplicateParameter
The operation '{0}' contains duplicate parameters with name '{1}', location '{2}'. Istnieje parametr operacyjny, który pojawia się dwukrotnie. {0} to nazwa operacji, {1} to nazwa zduplikowanego parametru, {2} to lokalizacja zduplikowanego parametru (właściwość „in” w swaggerze). Usunięcie rekursji właściwości.
OperationParametersContain
MultipleBodyParameters
The operation '{0}' contains multiple parameters in the location 'body', at most one is allowed. Parametry operacji zawierają zduplikowane parametry treści. Usuń jeden z parametrów treści.
OperationParameterStaticTypeMismatch The parameter has type '{0}', but a static value is provided of type '{1}'. Parametr ma typ statyczny, gdy nie jest to oczekiwane dla tego parametru operacji.
OperationParameterTypeMismatch The parameter has type '{0}', but operation '{1}' is providing a parameter of type '{2}'. Parametr i operacja mają różne typy. Dopasuj typ parametru do operacji.
OperationPathContainsUnsupportedCharacters The operation path cannot contain wildcard character '*'. Jedna z twoich operacji określa ścieżkę URL zawierającą nieobsługiwane znaki (takie jak symbol wieloznaczny).
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. Ścieżka operacji nie może zawierać „?” oraz „#”, chyba że są zakodowane za pomocą adresu URL (przetłumaczone na ich %xx odpowiedniki).
OperationPathMustStartWithSlash The path is not valid, it must start with a '/' character. Jeśli jest wymagana ścieżka operacji, która próbujesz osiągnąć, musi zaczynać się od znaku „/”. Aby rozwiązać ten problem, należy uwzględnić znak „/” na początku ścieżki.
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 zawiera ścieżkę operacji z niezamkniętymi znakami „{” lub „}”. Te znaki są używane do odwoływania się do zmiennej w ścieżce, więc nie mogą istnieć w ścieżce, gdy są otwarte.
OperationPathVariablesContainDefaults The operation path template variables cannot set default values with character '='. Jedną z twoich operacji jest określenie domyślnej wartości parametru, który zawiera „=”. Parametr ten jest także określony jako ścieżka adresu URL. Ta kombinacja jest niedozwolona.
OperationRevisionEmpty The operation '{0}' does not specify a revision in api annotation. Operacja jest oznaczona jako część rodziny, ale nie ma wersji.
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. W operacji jest zbyt wiele schematów. Usuń niektóre z nich, aby suma wróciła poniżej limitu.
OperationShouldHaveSuccessfulResponse The operation '{0}' should have at least one successful response definition. Twój swagger ma operację, która nie ma co najmniej jednej definicji udanej odpowiedzi.
OperationStatusAheadOfConnector The operation '{0}' cannot be in a Production status ahead of the connector. Operacji nie można oznaczyć jako „Produkcja”, gdy cały łącznik jest nadal w „Podglądzie”.
OperationSummaryTooLong The operation 'summary' should be fewer than {0} characters for improved readablity. Zmniejsz właściwość „podsumowanie” operacji do mniej niż 120 znaków.
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} to identyfikator operacji, {1} czyli ścieżka operacji, {2} to zestaw częściowo zduplikowanych ścieżek operacji. Zmień ścieżkę operacji, aby uzyskać większą różnicę między ścieżkami operacji, które mają wspólne podobieństwo.
PathParameterMustBeRequired The parameter must be marked as required as it is used in the operation path. Include the 'required' property, with the value 'true'. Lokalizacja parametru jest ustawiona na „Ścieżka”, dlatego musi mieć właściwość „wymagana” ustawioną na „prawda”.
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. W jednej z Twoich operacji znajduje się parametr, który jest oznaczony jako znajdujący się w ścieżce operacji, ale nie istnieje w szablonie ścieżki.
PathParametersContain
DuplicateParameter
The path '{0}' contains duplicate parameters with name '{1}', location '{2}'. {0} to ścieżka operacji. {1} to zduplikowana nazwa parametru. {2} to lokalizacja (właściwość „in”) zduplikowanego parametru. Usunięcie parametru zduplikowanej ścieżki.
PathParametersContainMultiple
BodyParameters
The path '{0}' contains multiple parameters in the location 'body', at most one is allowed. Nie może być wielu parametrów operacji, które znajdują się w treści. Aby naprawić ten błąd, należy usunąć jeden z parametrów.
PathRedefined The path '{0}' is defined multiple times with different capitalization. Paths must be unique when compared case-insensitively. Ta sama ścieżka jest zdefiniowana więcej niż raz. Usuń lub zmień nazwy instancji, aby były unikalne.
RestrictedCharactersInSummary Summary string contains any of the restricted characters [{0}] Podsumowanie jednej z twoich operacji zawiera znaki zastrzeżone. Usuń znaki lub powtórz podsumowanie, aby naprawić ten błąd.
SelectedItemValuePathNotAllowedIn
ThisPosition
The 'selectedItemValuePath' property is not allowed in this position. It is allowed only in 'browse' operation of 'x-ms-dynamic-tree' extension. Gdziekolwiek umieściłeś „selectedItemValuePath” nie jest dozwolone. Usuń go lub umieść w prawidłowej lokalizacji.
StringBinaryNotSupportedFor
FormUrlEncoded
String/binary parameters are not supported for operation '{0}' with 'application/x-www-form-urlencoded' consumes type. Operacja ma wartość „application/x-www-form-urlencoded” zdefiniowaną we właściwości „consumes”. Parametry tej operacji nie mogą być typu „string” ani „binary”.
TotalOperationsCountExceedsMaxAllowed The total number of operations in the swagger exceeds the maximum allowed value of '{0}'. W swaggerze jest zbyt wiele operacji.
UnrecognizedTypeFormat The type/format '{0}' is not recognized. Podany typ/format „{0}” jest nieznany. Sprawdź literówki lub dokumentację, aby potwierdzić obsługiwane formaty czcionek.
WebhookOperationsMissingNotification
UrlProperty
The webhook operation '{0}' is missing notification URL property. Twój swagger zawiera operację webhooka, która nie ma brakującej właściwości adresu URL powiadomienia. Dodanie tej właściwości w ramach operacji elementu webhook naprawia tę operację.

Tablice

Błąd Problem Rozwiązanie
ArrayHasNoItems The array should have items specified. Tablica jest pusta, ale pusta tablica nie jest dozwolona.
RequiredPropertyArrayEmpty The 'required' array requires at least one value. If no properties are required in the schema, remove the 'required' property. Twój swagger ma pustą tablicę dla właściwości o nazwie „wymagane”. Należy go usunąć, jeśli nie ma wymaganych parametrów.
SchemesArrayEmpty The 'schemes' array requires at least one value. Schematy nie mogą być puste i muszą mieć co najmniej jedną wartość.

Nieobsługiwane

Błąd Problem Rozwiązanie
CollectionFormatValueNotSupported The 'collectionFormat' keyword value '{0}' is not supported. Obsługiwane są tylko niektóre formaty kolekcji. Swagger obejmuje nieobsługiwany format.
MimeTypeNotSupported The MIME type '{0}' is not supported. The supported mime types are: '{1}'. Typ MIME, którego próbujesz użyć w swoim swaggerze, nie jest obsługiwany.
PathItemRefNotSuppored The '$ref' property in a path is not supported. Ścieżka nie może mieć zdefiniowanej właściwości „$ref”. Usuń właściwość.
SwaggerKeywordNotSupported The '{0}' keyword is not supported. {0} to odważne słowo kluczowe, takie jak „unikalne elementy”, które jest niedozwolone w kontekście, w którym jest używane.

Parametry

Błąd Problem Rozwiązanie
FileParameterMustBeInFormData Parameters of type 'file' are not valid in locations other than 'formData'. Twój swagger ma parametr z typem „plik” i może być tylko „w” „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. Twój swagger definiuje zarówno parametr body, jak i formData, co jest niedozwolone. Usuń jeden z tych typów parametrów.
ParameterReferenceNotFound The parameter reference '{0}' could not be found in the swagger document. Twój swagger ma odniesienie do parametru, którego nie można znaleźć w dokumencie swaggera. Usuń odwołanie do tego parametru.
ParameterReferenceNotValid The parameter reference '{0}' is not valid. Parameter references must start with '#/parameters/' and be valid JSON Pointers. Twój swagger ma odwołanie do parametru („#/parameters/”), które jest nieprawidłowe w oparciu o specyfikację RFC wskaźnika JSON.
ParameterRefLoopNotAllowed The parameter definition may not use a '$ref' to point to another definition. Twój swagger ma definicję parametru, która błędnie używa „$ref”, aby wskazać inną definicję.
ParamtersWithSameNameMustHave
SameTypeAndVisibility
Parameters of the same name in fetch and subscribe operations must be of the same type and visibility. Jeśli Twój swagger ma parametry o tej samej nazwie w operacjach pobierania i subskrybowania, powinny mieć ten sam typ i widoczność.
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} to nazwa parametru, który nie ma kodowania.
QueryParameterEncodingNotSupported Encoding for query parameter '{0}' is not supported. All query parameters are single encoded by default. {0} to nazwa parametru, który ma nieobsługiwane kodowanie. Napraw to kodowanie.
ReservedParameterIsUsed The parameter '{0}' is reserved and cannot be used in '{1}'. Parametr podany w tym błędzie jest używany, ale nie można go użyć, ponieważ jest zarezerwowany dla tej sekcji lub ogólnie.
ResponseRefLoopNotAllowed The response definition may not use a '$ref' to point to another definition. Twój swagger ma definicję odpowiedzi, która błędnie używa „$ref”, aby wskazać inną definicję.
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. Odwołanie do parametru jest oznaczone jako wewnętrzne, ale operacja, w której jest używane odwołanie do parametru, nie jest wewnętrzna. Zaktualizuj parametr lub operację, aby to naprawić.

Właściwości

Błąd Problem Rozwiązanie
AdditionalPropertyNotAllowed The property '{0}' is not allowed and must be removed. W twoim swaggerze jest dodatkowa właściwość, którą musisz usunąć.
AdditionalPropertyNotAllowedAdjacent
ToRef
When '$ref' is defined, no other properties may be specified. Używając „$ref” w swaggerze, żadne inne właściwości nie powinny być zawarte w tym obiekcie JSON.
BasePathNotValid The 'basePath' property, if present, must start with a '/' character. Jeśli używasz ścieżki podstawowej, musi zaczynać się od „/”. Nieprawidłowe ścieżki podstawowe wyglądają jak „abc/def/ghi” lub „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. Jeden z parametrów treści w Twoim swaggerze używa nieprawidłowej właściwości, której nie można użyć w parametrze treści.
ConnectorMetadataPropertiesMissing The connector metadata property '{0}' is required. Do łącznika są wymagane pewne metadane.
ContactEmailNotValid The contact 'email' property, if present, must be a valid email address. Podany adres e-mail ma nieprawidłowy format lub zawiera znaki spoza zestawu ASCII.
DefaultValueMustMatchType The 'default' value is of type '{0}', but should match the given type '{1}'. Wartość Twojej wartości domyślnej nie jest tego samego typu, co podany typ. Zmień wartość domyślną na wartość danego typu, aby rozwiązać ten problem.
EnumMustContainAtLeastOneElement The 'enum' array requires at least one value. Jeśli typem właściwości jest wyliczenie, należy określić tablicę z co najmniej jedną z wartości wyliczenia.
ExtensionNameNotValid The property '{0}' is not valid. If this property is an extension, its name must begin with "x-". Właściwości, które są rozszerzeniami, muszą zaczynać się od przedrostka „x-”.
FilterFunctionsPropertyEmpty The 'filterFunctions' property must have at least one element. Właściwość „filterFunctions” nie może być pusta, jeśli została określona.
FilterFunctionsPropertyHasDuplicates The 'filterFunctions' property cannot contain duplicates. Właściwość „filterFunctions” nie może zawierać duplikatów.
FilterFunctionsPropertyInInputSchema The 'filterFunctions' property has to be in the response schema. Właściwość „filterFunctions” może znajdować się tylko w schemacie odpowiedzi.
FilterFunctionsPropertyInvalidValue The 'filterFunctions' property supports only these values: {0}". Właściwość „filterFunctions” nie może określać nieobsługiwanej wartości.
HostNameNotValid The 'host' property, if present, must be a valid URI host without a scheme or path. Host URI bez schematu lub ścieżki wygląda jak „www.microsoft.com”. Nieprawidłowy identyfikator URI hosta ma postać „https://www.microsoft.com/” lub „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. Właściwość jest oznaczona jako wewnętrzna, ma określoną wartość domyślną i nie jest wymagana. Jeśli chcesz mieć pewność, że jest to uwzględnione we wnioskach, zaznacz to jako wymagane; w przeciwnym razie, jeśli jest to zamierzone, można go pozostawić bez zmian.
InvalidConnectorCategory The connector category is invalid. Available categories are: [{0}]. Kategorie mogą pochodzić tylko z listy dozwolonych wartości kategorii.
InvalidStringBinaryProperty A schema with type/format 'string/binary' can only be at the top level of a body or formData parameter. Wartość właściwości „type” i „format” „string” i „binary” nie jest dozwolona w tej lokalizacji schematu.
JsonTypeIncorrect The type of the property is incorrect. Expected type '{0}', but value is of type '{1}'. Właściwość w Twoim swaggerze ma jeden typ, ale rzeczywista wartość jest innego typu. Zmień typ wartości, aby pasował do oczekiwanego typu.
JsonValueNotInEnum The property value must be one of the following: {0}. Wartość właściwości w enum nie jest zgodne z bieżącymi dostępnymi opcjami. Zmień wartość na jedną z następujących podanych w komunikacie o błędzie.
MimeTypeNotValid The MIME type '{0}' is not valid. Wybrany przez użytkownika „typ treści” MIME jest nieprawidłowy. Prawidłowe typy MIME to: „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 nie określały właściwości „displayName”.
MultipleOfMustBeGreaterThanZero The 'multipleOf' value must be greater than zero. Wartość właściwości „multipleOf” powinna być wartością większą od zera.
OneOfPropertiesRequired At least one of the properties is required: [{0}]. {0} to zestaw właściwości. Ten błąd wyświetla wszystkie właściwości, które muszą być obecne w swaggerze.
ProductionStatusOnBetaService The connector cannot be in Production status on a beta service. Nie można oznaczyć łącznika jako „Produkcyjnego”, gdy usługa backendu jest w wersji beta. Musi być ustawiony na „Podgląd”.
PropertyMustBeRequired The property is internal and has a default value, it must be required. Optional internal fields are ignored. Właściwość nie jest ustawiana, chociaż jest to wymagane.
RequiredPropertyDefinitionMissing The required property '{0}' is not defined in the object schema. Właściwość schematu jest wymieniona jako „wymagana” i dlatego musi być zdefiniowana we „właściwościach”
RequiredPropertyMissing The '{0}' property is required. Właściwość w Twoim swaggerze jest wymagana, ale obecnie nie ma jej w Twoim swaggerze. Dołącz tę właściwość, aby naprawić ten błąd.
RequiredPropertyNotOnObject The property 'required' is applicable to schemas with 'object' type only and should be removed. Właściwość „wymagana” jest obsługiwana tylko dla typu „obiekt”. Usuń właściwość dla wszystkich innych typów.
RequiredReadOnlyPropertyNotAllowed
AsInput
An input property cannot be 'readonly' and required. Twój swagger zawiera właściwość oznaczoną jako tylko do odczytu i wymaganą. Właściwość tylko do odczytu oznacza, że użytkownik nie może modyfikować wartości. Wymagana właściwość wymaga wartości do modyfikacji.
SchemeNotValid The 'schemes' property must only contain transfer protocols from the list: {0}. Właściwość schematu powinna mieć wartość „http” lub „https”.
SecuritySchemePropertyNotValid The security definition property '{0}' is not valid for definitions of type '{1}'. Istnieje nieprawidłowa nazwa i wartość właściwości, które zostały uwzględnione w słowniku securityDefinitions. Zmień tę właściwość na prawidłową nazwę właściwości, aby rozwiązać ten problem.
SecuritySchemePropertyRequired The security definition property '{0}' is required for definitions of type '{1}'. Istnieje wymagana nazwa i wartość właściwości, które nie są zawarte w słowniku securityDefinitions. Dodaj tę właściwość i wartość, aby rozwiązać ten problem.
SpecificationVersionIncorrect The 'swagger' property must have the string value "2.0". Obsługiwana jest tylko wersja „2.0”, więc ustaw właściwość wersji swagger na „2.0”.
TagRedefined The 'tags' property defines tag '{0}' multiple times. Tagi zdefiniowane we właściwości „tags” muszą być unikalne. Usuń lub zastąp wiele wystąpień.
TooManyConnectorCategories The maximum allowed number of categories for the connector is '{0}'. Istnieje ograniczenie liczby kategorii, które można ustawić dla łącznika.
UrlNotValid The 'url' property must be a valid absolute URL. Adres URL użytkownika jest nieprawidłowy. Może to być spowodowane nieprawidłowym skopiowaniem skądś adresu URL.

Response

Błąd Problem Rozwiązanie
BodyParameterSchemaRequired The 'body' parameter must define a 'schema' property. W parametrze body należy zdefiniować właściwość schematu. Zdefiniuj właściwość schematu, aby rozwiązać ten problem.
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. W obiekcie body jest zbyt wiele schematów. Usuń niektóre z nich, aby suma wróciła poniżej limitu.
DefaultResponseHasSchema The 'default' response should not have schema definition. Schemas should be defined on expected responses only. Twój swagger zawiera definicję schematu odpowiedzi domyślnej. Usunięcie tej definicji schematu dla odpowiedzi domyślnej naprawia ten błąd.
InvalidCustomEditorExtension
DictionaryValue
The 'x-ms-editor' extension can be specified as 'dictionary' only for schema with type object and additional properties allowed. Sprawdź, czy x-ms-editor jest ustawiony na słownik tylko wtedy, gdy schemat jest typu object i ma ustawione dodatkowe właściwości.
JsonPointerNotValid The JSON Pointer path is not valid. Odniesienie (#ref) używane w Twoim swaggerze jest nieprawidłowe.
NonBodyParameterSchemaNotValid The parameter cannot define a schema as it is not in the 'body'. Twój swagger ma parametr, który używa „schematu”, ale tylko parametry treści mogą używać „schematu”.
RequiredLoopInSchemaNotAllowed Loops of required schema properties are not allowed. Specyfikacja wymaganych właściwości nie może używać pętli odwołań.
ResponseExampleMustBeProduced
ByOperation
The response example '{0}' is not produced by the operation '{1}'. Twój swagger ma operację z przykładem odpowiedzi, ale ta sama operacja nie generuje odpowiedzi ze wskazanym typem MIME.
ResponseHeadersAreNotUnique The response headers are not unique. Istnieje zduplikowany nagłówek odpowiedzi. Nagłówki odpowiedzi powinny być unikatowe.
ResponseMustBeDefaultOrHttpStatusCode The response is not valid, the response must be a valid HTTP status code, or the string 'default'. Twój swagger nie ma domyślnego kodu stanu HTTP ani prawidłowego kodu stanu HTTP. Dodanie kodu stanu do odpowiedzi.
ResponseReferenceNotFound The response reference '{0}' could not be found in the swagger document. Twój swagger ma odniesienie do odpowiedzi, którego nie można znaleźć w dokumencie swaggera. Usuń odniesienie do tej odpowiedzi.
ResponseReferenceNotValid The response reference '{0}' is not valid. Response references must start with '#/responses/' and be valid JSON Pointers. Twój swagger ma odwołanie do odpowiedzi („#/responses/”), które jest nieprawidłowe na podstawie specyfikacji JSON wskaźnika RFC.
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. W Twojej operacji brakuje schematu odpowiedzi dla kodu odpowiedzi 200 lub 201. W przypadku elementów webhook schemat odpowiedzi należy określić jako część rozszerzenia treści powiadomienia.
SchemaReferenceNotFound The schema reference '{0}' could not be found in the swagger document. Twój swagger ma odniesienie do schematu, którego nie można znaleźć w dokumencie swaggera.
SchemaReferenceNotValid The schema reference '{0}' is not valid. Schema references must start with '#/definitions/' and be valid JSON Pointers. Twój swagger ma odwołanie do schematu („#/definitions/”), które jest nieprawidłowe w oparciu o specyfikację RFC wskaźnika JSON.
SchemaRefLoopNotAllowed The schema definition may not use a '$ref' to point to another definition. W twoim schemacie istnieje pętla odniesienia (A wskazuje na B, co wskazuje z powrotem na A).
SchemaTooDeep The schema exceeds the maximum allowed depth. Schemas must not exceed a depth of '{0}', including referenced ('$ref') schemas. Schematy są ograniczone do określonej głębokości JSON. Użyj płytszego schematu.
SchemaTypeFileNotValid The schema type 'file' is not valid. Only parameters in 'formData' and the root response schema may be of type 'file'. Użycie typu schematu „plik” jest obsługiwane tylko w danych formularza i musi znajdować się w katalogu głównym schematu odpowiedzi dla definicji odpowiedzi.
SchemeNotSupported The WebSocket transfer protocol schemes are not supported. Ten schemat nie jest obsługiwany. Obsługiwane schematy to HTTPS i HTTP.
TotalSchemaCountExceedsMaxAllowed The maximum allowed number of schemas in the swagger is '{0}'. Please remove any unnecessary property or item definitions. W swaggerze jest zbyt wiele schematów.

Zabezpieczenia

Błąd Problem Rozwiązanie
OAuthSecurityRequirementValueMustBe
ScopeName
The OAuth security requirement '{0}' refers to scope name '{1}', but this is not defined in the 'securityDefinitions' object. Nazwy wymagań zabezpieczeń muszą być nazwą zakresu zdefiniowaną w obiekcie definicji zabezpieczeń.
SecurityRequirementMustBeDefined The security requirement '{0}' is not defined in the 'securityDefinitions' object. Wymóg bezpieczeństwa jest używany, ale nie jest zdefiniowany w słowniku definicji bezpieczeństwa.
SecurityRequirementMustHaveEmptyValue The security requirement '{0}' cannot specify any scopes, an empty array should be provided. Na podstawie bieżącej konfiguracji wymagania dotyczące zabezpieczeń o nazwie „{0}” muszą być pustą tablicą.
SecurityRequirementMustHaveValue The security requirement '{0}' must have have a value. Provide an empty array if no OAuth scopes are required. Brak wymagania bezpieczeństwa lub jest on zerowy. Jeśli nie są wymagane żadne zakresy OAuth, zamiast tego określ pustą tablicę.

Elementy webhook

Błąd Problem Rozwiązanie
NotificationUrlNotAllowedInThisPosition The notification URL property is not allowed in this position. It is allowed only in input body. Właściwość „x-ms-notification-url” należy zdefiniować tylko w danych wejściowych.
NotificationUrlNotInternal The notification URL property itself or at least one of its parents must be internal. Twój swagger obecnie nie ustawia właściwości adresu URL powiadomienia na wartość wewnętrzna, co powinno mieć miejsce.
NotificationUrlNotRequired The notification URL property must be required all the way through the schema chain. Twój swagger obecnie nie wymaga właściwości adresu URL powiadomienia, która powinna być wymagana.
NotificationUrlNotString The notification URL property must be of type string. Właściwość adresu URL powiadomienia ma wartość, która nie jest typu string.

Metadane

Błąd Problem Rozwiązanie
AllowEmptyValueOnlyValidForQuery
FormData
The parameter cannot use the 'allowEmptyValue' keyword as it is not in the 'query' or 'formData' location. Właściwość „allowEmptyValue” można ustawić na „true” tylko w parametrze, który ma właściwość „location”, która jest „query” lub „formData”. Wartość właściwości „location” też nie jest taka sama.
DiscriminatorMustBeARequiredStringProperty The 'discriminator' value must be the name of a required string property. Wartość „dyskryminator ” powinna być nazwą wymaganej właściwości ciągu w Twoim swaggerze.
ExclusiveMaximumRequiresMaximum The 'exclusiveMaximum' keyword can only be specified if the 'maximum' keyword is also specified. Nie można określić „exclusiveMaximum” bez określenia „maksimum”.
ExclusiveMinimumRequiresMinimum The 'exclusiveMinimum' keyword can only be specified if the 'minimum' keyword is also specified. Nie można określić „exclusiveMinimum” bez określenia „minimum”.
FieldLengthExceeded The '{0}' value goes over the character limit '{1}' Pole o nazwie określonej w {0} przekracza limit znaków określony w {1}.
FieldLengthNotInRange The '{0}' value must be between '{1}' and '{2}' characters. {0} to nazwa pola, {1} to minimalna długość, {2} jest ograniczeniem. Zmniejsz długość znaków w tym polu.
MaxItemsMustBeGreaterThanOrEqual
ToZero
The 'maxItems' value must be greater than or equal to zero. Wartość „maxItems” jest obecnie poniżej zera, zmień tę wartość na większą lub równą zero.
MaxLengthMustBeGreaterThanOrEqual
ToZero
The 'maxLength' value must be greater than or equal to zero. Wartość właściwości „maxLength” powinna być liczbą nieujemną.
MaxPropertiesMustBeGreaterThanOrEqual
ToZero
The 'maxProperties' value must be greater than or equal to zero. Wartość 'maxProperties' jest obecnie poniżej zera, zmień tę wartość na większą lub równą zero.
MinimumShouldBeLessThanOrEqual
ToMaximum
The 'minimum' value should be less than or equal to the 'maximum' value. Podczas określania wartości minimalnej wartość powinna być mniejsza lub równa wartości maksymalnej.
MinItemsMustBeGreaterThanOrEqual
ToZero
The 'minItems' value must be greater than or equal to zero. Wartość „minItems” jest obecnie poniżej zera, zmień tę wartość na większą lub równą zero.
MinItemsShouldBeLessThanOrEqual
ToMaxItems
The 'minItems' value should be less than or equal to the 'maxItems' value. Podczas określania pozycji minimalnych wartość powinna być mniejsza lub równa maksymalnej pozycji.
MinLengthMustBeGreaterThanOrEqual
ToZero
The 'minLength' value must be greater than or equal to zero. Wartość właściwości „minLength” powinna być liczbą nieujemną.
MinLengthShouldBeLessThanOrEqual
ToMaxLength
The 'minLength' value should be less than or equal to the 'maxLength' value. Podczas określania minimalnej długości wartość powinna być mniejsza lub równa maksymalnej długości.
MinPropertiesMustBeGreaterThanOrEqual
ToZero
The 'minProperties' value must be greater than or equal to zero. Wartość 'minProperties' jest obecnie poniżej zera, zmień tę wartość na większą lub równą zero.
PatternShouldBeValidRegularExpression The 'pattern' value should be a valid regular expression. Wartość „wzorzec” nie jest prawidłowym wyrażeniem regularnym, naprawienie wyrażenia regularnego naprawi ten błąd.
RequiredValueEmpty The '{0}' property must have not empty value. Rozłożenie zawiera pustą wartość wymaganej właściwości. Ustawienie wartości tej wymaganej właściwości rozwiązuje ten problem.
ValueContainsRestrictedWords The value '{0}' contains at least one of the restricted words: '{1}'. Jedno z pól w swaggerze używa słowa zastrzeżonego.
ValueMustBeInEnglish The '{0}' value must be written in English. Zastąp wartość wartością zawierającą tylko znaki alfanumeryczne.
ValueMustEndWithAlphanumeric The '{0}' value must end with alphanumeric character. Zastąp ostatni znak znakiem alfanumerycznym