Naprawianie błędów weryfikatora struktury Swagger
W tym artykule przedstawiono typowe błędy walidacji struktury Swagger, które mogą wystąpić w przypadku Power Platform łączników, oraz sposób ich naprawiania.
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 go 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 z oczekiwaną ścieżką 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'. |
Ustal 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 zawartoś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 polecenia "x-ms-notification" identyfikator operacji musi odwoływać 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 nieprzestarzałych 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 jest zgodny z oczyszczoną wersją. 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. |
Struktura 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 zgodnie z wymaganiami, ale nie jest on zdefiniowany w podanych 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 stwierdza, że jest opcjonalny, co powoduje 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 jest wymieniany 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 operacyjne zawierają zduplikowane parametry obiektu. 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 operacji określa ścieżkę adresu URL, która zawiera 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ć „?” I '#', chyba że są zakodowane w adresie URL (przetłumaczone na ich odpowiedniki %xx). |
| OperationPathMustStartWithSlash | The path is not valid, it must start with a '/' character. |
Jeśli używasz ścieżki operacji, którą próbujesz osiągnąć, wymaga, aby zaczynała się od znaku "/". Aby rozwiązać ten problem, dołącz 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 operacji jest określenie wartości domyślnej dla parametru, który zawiera znak "=". 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 poprawki. |
| 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. |
Struktura Swagger ma operację, która nie ma co najmniej jednej pomyślnej definicji odpowiedzi. |
| OperationStatusAheadOfConnector | The operation '{0}' cannot be in a Production status ahead of the connector. |
Operacji nie można oznaczyć jako "Produkcyjne", gdy cały łącznik jest nadal w wersji zapoznającej. |
| 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 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, usuń 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ń wystąpienia lub zmień ich nazwy, aby były unikatowe. |
| RestrictedCharactersInSummary | Summary string contains any of the restricted characters [{0}] |
Podsumowanie jednej z twoich operacji zawiera znaki zastrzeżone. Aby naprawić ten błąd, usuń znaki lub przeformułuj podsumowanie. |
| 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 "ciąg" lub "binarny". |
| 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. |
Struktura Swagger zawiera operację elementu webhook, 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. |
Struktura Swagger ma pustą tablicę dla właściwości o nazwie "required". 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} jest słowem kluczowym struktury Swagger, takim jak "uniqueItems", i nie jest dozwolone w kontekście, w którym jest używane. |
Parametry
| Error | Problem | Rozwiązanie |
|---|---|---|
| FileParameterMustBeInFormData | Parameters of type 'file' are not valid in locations other than 'formData'. |
Struktura Swagger ma parametr o typie "file" i może być tylko "in" 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. |
Struktura 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. |
Struktura Swagger ma odwołanie do parametru ("#/parameters/"), które jest nieprawidłowe na podstawie specyfikacji 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. Aby rozwiązać ten problem, zaktualizuj parametr lub operację. |
Właściwości
| Error | Problem | Rozwiązanie |
|---|---|---|
| AdditionalPropertyNotAllowed | The property '{0}' is not allowed and must be removed. |
W twoim swaggerze jest dodatkowa właściwość, którą należy usunąć. |
| AdditionalPropertyNotAllowedAdjacent ToRef |
When '$ref' is defined, no other properties may be specified. |
W przypadku użycia wartości "$ref" w strukturze Swagger żadne inne właściwości nie powinny być uwzględniane 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. |
Identyfikator URI hosta bez schematu lub ścieżki wygląda następująco jak "www.microsoft.com". Nieprawidłowy identyfikator URI hosta wygląda następująco: "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 zostanie to uwzględnione w żądaniach, oznacz to jako wymagane; W przeciwnym razie, jeśli jest to zamierzone, można go pozostawić tak, jak jest. |
| 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 wyliczenia w nie jest zgodna 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'. |
Parametr x-ms-enum-values nie określił 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 "Wersja zapoznawcza". |
| 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 wymagana. |
| 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. Aby naprawić ten błąd, dołącz tę właściwość. |
| 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. |
Struktura Swagger zawiera właściwość, która jest oznaczona jako tylko do odczytu i wymagana. 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ść scheme powinna mieć wartość "http" lub "https". |
| SecuritySchemePropertyNotValid | The security definition property '{0}' is not valid for definitions of type '{1}'. |
Istnieje nazwa i wartość właściwości, które są nieprawidłowe, a które zostały uwzględnione w słowniku securityDefinitions. Aby rozwiązać ten problem, zmień tę właściwość na prawidłową nazwę właściwości. |
| SecuritySchemePropertyRequired | The security definition property '{0}' is required for definitions of type '{1}'. |
Istnieje nazwa i wartość właściwości, które są wymagane, a które nie są uwzględnione 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 limit 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}'. |
Struktura 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'. |
Struktura 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. |
Struktura Swagger ma odwołanie do schematu, którego nie można znaleźć w dokumencie struktury Swagger. |
| 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 schemacie znajduje się pętla referencyjna (A wskazuje B, który 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 mniejsza od 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. |
Po określeniu wartości minimalnej wartość ta 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 mniejsza od 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. |
Po określeniu minimalnej liczby elementów wartość powinna być mniejsza lub równa maksymalnej liczbie elementów. |
| 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. |
Po określeniu długości minimalnej wartość powinna być mniejsza lub równa długości maksymalnej. |
| MinPropertiesMustBeGreaterThanOrEqual ToZero |
The 'minProperties' value must be greater than or equal to zero. |
Wartość "minProperties" jest obecnie mniejsza niż zero. 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 naprawia 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 |