A Swagger Validator hibáinak kijavítása
A Swagger Validator eszköz ellenőrzi a GitHub nyílt forráskódú adattárban és az ISV portálon beküldött összekötőfájlokat. Ellenőrzi az összekötőfájlok megfelelőségét, és hogy megfelelnek-e az összekötőkre vonatkozó követelményeinknek és irányelveinknek.
Az ebben a témakörben található táblázatok segítségével keresse meg és javítsa ki a hibákat. Az egyes táblázatok felsorolják azokat a hibákat, amelyeket az eszköz generálhat. Mindegyik hiba esetén fel van tüntetve a probléma és a megoldás. A felsorolásban szereplő megoldások segíthetnek abban, hogy elkerülje a hibákat az elküldés előtt vagy közben.
Ha további útmutatásra van szüksége, küldjön egy e-mailt a címre ConnectorPartnerMgmtTeam@service.microsoft.com.
Műveletek
| Hiba | Probléma | Megoldás |
|---|---|---|
| ApiAnnotationExtensionReplacementInfo ForNonDeprecatedOperations |
The 'x-ms-api-annotation' extension for operation '{0}' is invalid. The replacement property should be specified for deprecated operations only. |
A(z) {0} művelet nincs megjelölve elavultként. A tulajdonság akkor használható, ha a művelet 'elavult' tulajdonsága igaz értékre van állítva. Amennyiben nem ez a helyzet, távolítsa el az 'x-ms-api-annotation' tulajdonságot. |
| ApiAnnotationExtensionReplacementInfo MissingApiProperty |
The 'x-ms-api-annotation' extension for operation '{0}' is invalid. The replacement property must specify 'api' property. |
Az "x-ms-api-annotation" esetén a megadott "csere" tulajdonság meg van adva, de az "api" tulajdonság hiányzik. A "csere" tulajdonság használatához az "api" és az "operationId" tulajdonságot is be kell állítani. |
| ApiAnnotationExtensionReplacementInfo MissingOperationIdProperty |
The 'x-ms-api-annotation' extension for operation '{0}' is invalid. The replacement property must specify 'operationId' property. |
Az "x-ms-api-annotation" esetén a megadott "csere" tulajdonság meg van adva, de az "operationId" tulajdonság hiányzik. A "csere" tulajdonság használatához az "api" és az "operationId" tulajdonságot is be kell állítani. |
| ArrayDuplicateValue | The array contains duplicate values, values must be unique. |
A tömböknek egyedi értékeket kell tartalmazniuk, de a swagger duplikátumokat tartalmaz. Távolítsa el a duplikált elemeket. |
| BodyOrFormDataParameterInFetch OperationNotAllowed |
Body or form data parameters are not supported in a fetch operation. |
A "GET" HTTP metódust használó műveletekhez nem tartozhat törzs- vagy űrlapadat. |
| ConnectionIdParameterNotAllowed | A parameter cannot be named as 'connectionId'. |
Nevezze át a paramétert olyan értékre, amely nem 'connectionId'. |
| ConsumesMissing | At least one supported MIME type must be provided in 'consumes' for operation '{0}'. |
A swaggernek meg kell adnia egy támogatott MIME-típust a felhasznált erőforrásokban a működéshez. |
| DuplicateEnumValuesInExtension | The 'x-ms-enum-values' extension has duplicate values. You can only have one display name mapped to a value. |
Az enum értékeknek egyedinek kell lennie és nem lehet duplikált. |
| 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. |
A(z) {0} a művelet azonosítója, a(z) {1} a duplikált művelet azonosítója, a(z) {2} a művelet elérési útja, a(z) {3} pedig a duplikált művelet elérési útja. Távolítsa el a duplikált művelet azonosítóját a duplikált művelet elérési útjából. |
| DynamicExtensionDefinitionNotAllowed InParameter |
Dynamic extensions are not allowed to be defined on the body parameter. It should be in the schema. |
A dinamikus bővítményeket egy törzsparaméteren definiálják, és el kell őket távolítani. Csak a sémában definiálhatók. |
| DynamicListExtensionRequiredFor AmbiguousReferences |
The 'x-ms-dynamic-values' extension references ambiguous parameter references. You need to define the 'x-ms-dynamic-list' extension. |
Az "x-ms-dynamic-list" paramétert definiálni kell. További információk: A dinamikus értékek használata |
| DynamicListExtensionRequiredFor NemParameterReferences |
The 'x-ms-dynamic-values' extension references properties within parameters. You need to define the 'x-ms-dynamic-list' extension. |
Az "x-ms-dynamic-list" paramétert definiálni kell. További információk: A dinamikus értékek használata |
| DynamicPropertiesExtensionRequiredFor AmbiguousReferences |
The 'x-ms-dynamic-schema' extension references ambiguous parameter references. You need to define the 'x-ms-dynamic-properties' extension. |
Az "x-ms-dynamic- properties" paramétert definiálni kell. További információk: A dinamikus értékek használata |
| DynamicPropertiesExtensionRequiredFor NemParameterReferences |
The 'x-ms-dynamic-schema' extension references properties within parameters. You need to define the 'x-ms-dynamic-properties' extension. |
Az "x-ms-dynamic-properties" paramétert definiálni kell. További információk: A dinamikus értékek használata |
| 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. |
Hiányzik a swagger fájlból az "x-ms-dynamic-properties" tulajdonság, ami azért szükséges, mert egy "x-ms-dynamic-schema" paramétert definiál. |
| 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}'. |
A dinamikus tulajdonságbővítmény-elem érték elérési útja nem egyezik meg a séma alapján várt elérési úttal. |
| DynamicTreeExtensionMissing | The 'x-ms-dynamic-tree' extension must be defined to enable file picker support. |
Hiányzik az "x-ms-dynamic-tree" tulajdonság, amelyet a fájlválasztó támogatásához meg kell határozni. |
| InvalidEnumValue | The type of the enum value is '{0}' but it should be '{1}' as specified in the schema. |
Az értéket a megadott típusúra kell lecserélni. |
| InvalidEnumValuesExtensionValue | The 'value' field must match one of the enums as defined in the 'enum' property of the schema. |
A kijelölt felsorolás nincs meghatározva a felsorolások listájában. Definiálja a felsorolás tulajdonság értékét, vagy használjon a felsorolási tulajdonságban definiált értéket. |
| InvalidFormDataParameterName | The form data parameter name '{0}' is invalid. All characters must be part of the US-ASCII character set. |
Nevezze át az űrlap adatparaméterét, hogy csak US-ASCII karakterek szerepeljenek a fájlban. |
| InvalidNextLinkNameValue | The nextLinkName value for operation '{0}' is invalid. Supported values are 'nextLink' or '@odata.nextLink'. |
Javítsa ki a "nextLinkName" tulajdonság értékét, hogy az "nextLink" vagy ""@odata.nextLink legyen. Más értékek nem engedélyezettek. |
| 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}'. |
A(z) {0} egy választulajdonság elérési útja, a(z) {1} a művelet azonosítója. A művelet válaszán belül definiáljon egy tömb típusú visszatérést. |
| 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}'. |
A(z) {0} egy választulajdonság elérési útja, a(z) {1} a művelet azonosítója. A művelet válaszán belül definiáljon egy konkrét tulajdonságot |
| MimeTypeNotCompatibleTypeRequest ContentSchemaType |
The MIME type(s) are not compatible with the request content type '{0}' for operation '{1}'. |
A használni próbált MIME-típus nem kompatibilis a megadott műveletben szereplő kérelem tartalmával. |
| NotificationExtensionNotSupportedIn WebhookOperation |
The 'x-ms-notification' extension must not be defined in a webhook operation. |
Az "x-ms-notification" használata webhook műveletben nem engedélyezett. |
| NotificationExtensionSupportedFor TriggerOnly |
The 'x-ms-notification' is supported for trigger operations only. |
Az "x-ms-notification" bővítmény csak eseményindító műveletekhez használható. |
| NotificationOperationWebtBeWebhook | The 'operationId' property in 'x-ms-notification' extension must be for a webhook operation. |
Az "x-ms-notification" használata esetén a műveletazonosítónak egy webhook műveletre kell hivatkozni. |
| OperationFamilyHasDuplicateRevisions | The operation family '{0}' has operations with duplicate revision. |
A swagger azonos verziószámmal/felülvizsgálati számmal definiál egy műveletcsaládot. A műveletcsalád minden műveletének egyedi verziószámmal kell lennie. |
| OperationFamilyHasManyActive Műveletek |
The operation family '{0}' has more than two active operations. Extra operations must be deprecated. |
A műveletcsaládok két nem elavult műveletre korlátozottak. A többi felhasználót elavultként kell megjelölni, hogy csökkenjenek a zavaró tényezők az összekötő felhasználója számára. |
| OperationFamilyHasManyActive ProductionOperations |
The operation family '{0}' has several active operations in Production status. Previous revisions should be deprecated. |
Egy műveletsornak több művelete van éles környezetben. A zavaró tényezők csökkentése érdekében korlátozza a családban az éles termelési műveletek számát, a többit pedig tegye elavulttá. |
| OperationFamilyHasManyEmptyRevisions | The operation family '{0}' has several operations with empty revision. Only one operation can have empty revision. |
A műveletcsaládnak csak egy művelete lehet felülvizsgálat nélküli. A család minden más tagjának felülvizsgálattal kell rendelkeznie. |
| OperationHasManyResponsesWithSchema | The operation '{0}' has more than one response with specified schema, only one schema will be used in the designer. |
A tervező korlátai akadályoznak több válaszsémát. A művelet több értéket ad meg, de csak egyet kellene megadnia. |
| OperationIdNotFound | The 'operationId' could not be found in this swagger document. |
A műveletazonosító nem található a swaggerben. |
| OperationIdNotUnique | The operationId '{0}' is used multiple times. Operation identifiers must be unique. |
Ugyanaz a műveletazonosító egynél többször jelenik meg. Távolítsa el az egyik példányt, vagy módosítsa. |
| OperationIdRequired | The operation 'operationId' property is required. |
Hiányzik a "operationId" tulajdonság, adja hozzá a művelethez az "operationId" tulajdonságot. |
| OperationIdSanitized | The 'operationId' property value is different from its sanitized value '{0}'. Please avoid the useage of non-alphanumeric characters to have matching values. |
A megadott műveletazonosító nem egyezik a megtisztított verzióval. Frissítse a műveletazonosítót, hogy egyezzen. |
| OperationIdShouldEndWithRevision | The operation Id '{0}' should end with revision suffix '{1}'. |
A felülvizsgálatban a műveletek azonosítóinak felülvizsgálás utótagúnak kell lennie. |
| OperationIdTooLong | The operationId length must be less than '{0}'. |
Csökkentse az "operationId" tulajdonság értékét, hogy a karakter hossza kisebb legyen, mint {0}. |
| OperationMissingPathParameter | The operation '{0}' does not define the '{1}' parameter which is required by the path. |
A swaggernek van egy olyan művelete, amely nem definiál olyan paramétert, amelyet az elérésiútvonal-sablonja megkövetel. |
| OperationMissingRequiredProperty | The target operation requires parameter '{0}'. |
A művelethez szükséges '{0}' paraméter meg van adva, de a megadott paraméterekben nincs definiálva. A probléma megoldásához adja hozzá ezt a paramétert. |
| OperationMustHaveNotification ContentExtension |
The operation '{0}' is missing notification content extension as it has '{1}' properties marked as notification URL. |
A swagger olyan műveletet tartalmaz, amelyben nem található értesítési tartalombővítmény. (Több kontextusra van szükség) |
| OperationMustHaveResponse | The operation is not valid, it must contain at least one response definition. |
A swagger olyan művelettel rendelkezik, amelyben nem található legalább egy válaszdefiníció. |
| OperationParameterNameIsAmbiguous | The parameter name is ambiguous as it matches both a parameter name and a path to a body property. |
A paraméter neve paraméternévként és a paraméter törzsének elérési útjaként használatos. A probléma megoldásához nevezze át az egyik példányt. |
| OperationParameterNameNotFound | The parameter could not be found in operation '{0}' in the swagger document. |
A műveletparaméter neve nem található a swaggerben. |
| 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. |
A paraméter kötelező, de a művelet értéke azt állítja, hogy nem kötelező, ami ezt az eltérést okozza. |
| OperationParametersAreNotUnique | The parameters in the operation '{0}' are not unique. |
Úgy tűnik, hogy a művelet paraméterei között duplikált elem van. A swaggernek el kell távolítania a műveletparaméterek duplikált elemét. |
| OperationParametersContain DuplicateParameter |
The operation '{0}' contains duplicate parameters with name '{1}', location '{2}'. |
Van egy műveleti paraméter, amely kétszer szerepel a listán. {0} a művelet neve, {1} a duplikált paraméternév, {2} a duplikált paraméter helye ('in' tulajdonság a swaggerben). Távolítsa el a tulajdonság ismétlődő példányát. |
| OperationParametersContain MultipleBodyParameters |
The operation '{0}' contains multiple parameters in the location 'body', at most one is allowed. |
A művelet paraméterei duplikált törzsparamétereket tartalmaznak. Távolítsa el a törzsparaméterek valamelyikét. |
| OperationParameterStaticTypeMismatch | The parameter has type '{0}', but a static value is provided of type '{1}'. |
A paraméternek statikus típusa van, holott ez nem várható el ettől a műveletparamétertől. |
| OperationParameterTypeMismatch | The parameter has type '{0}', but operation '{1}' is providing a parameter of type '{2}'. |
A paraméter és a művelet típusa különbözik. A paraméter típusának és a műveletnek meg kell egyeznie. |
| OperationPathContainsUnsupportedCharacters | The operation path cannot contain wildcard character '*'. |
Az egyik művelet olyan URL elérési utat ad meg, amely nem támogatott karaktereket (például helyettesítő karaktert) tartalmaz. |
| 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. |
A művelet elérési útja nem tartalmazhat "?" karaktert és '#' karaktert, kivéve, ha URL-kódoltak (lefordítva %xx megfelelőjükre). |
| OperationPathMustStartWithSlash | The path is not valid, it must start with a '/' character. |
Ha olyan művelet útvonalát használja, amit elérni próbál, azt a "/" karakterrel kell kezdenie. A hiba kijavítása érdekében az elérési út elején szerepeltesse a '/' karaktert. |
| 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. |
A swagger nem zárt “{“ vagy “}” karakterekkel rendelkező műveleti elérési utat tartalmaz. Ezek a karakterek az elérési úton található változókra hivatkoznak, így nem lezárt formában nem jelenhetnek meg az elérési útban. |
| OperationPathVariablesContainDefaults | The operation path template variables cannot set default values with character '='. |
Az egyik művelete egy "=" karaktert tartalmazó paraméter alapértelmezett értékének megadása. Ez a paraméter az URL elérési útvonalában is szerepel. Ez a kombináció nem engedélyezett. |
| OperationRevisionEmpty | The operation '{0}' does not specify a revision in api annotation. |
A művelet egy család tagjaként van megjelölve, de nincs felülvizsgálva. |
| 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. |
Túl sok séma van a műveletben. Távolítson el néhányat közülük, hogy a teljes összeg ismét a határérték alá kerüljön. |
| OperationShouldHaveSuccessfulResponse | The operation '{0}' should have at least one successful response definition. |
A swagger olyan művelettel rendelkezik, amelyben nem található legalább egy sikeres válaszdefiníció. |
| OperationStatusAheadOfConnector | The operation '{0}' cannot be in a Production status ahead of the connector. |
A műveleteket nem lehet "Termelési"-ként megjelölni, amíg az egész összekötő "Előzetes verzióban" van. |
| OperationSummaryTooLong | The operation 'summary' should be fewer than {0} characters for improved readablity. |
Csökkentse az "összegzés" művelet tulajdonságát 120 karakternél rövidebbre. |
| 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} a művelet azonosítója, {1} a művelet elérési útja, {2} pedig a részben duplikált művelet elérési útjainak készlete. Módosítsa a műveleti elérési útját, hogy nagyobb különbséget hozzon létre a hasonlóságot mutató műveleti útvonalak között. |
| PathParameterMustBeRequired | The parameter must be marked as required as it is used in the operation path. Include the 'required' property, with the value 'true'. |
A paraméter helye "Elérési út" lesz, ezért a 'szükséges' tulajdonságot 'igaz' értékre kell állítani. |
| 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. |
Az egyik műveletben van egy paraméter, amelyet a művelet elérési útjának részeként jelölt meg, de nem létezik az elérési út sablonjában. |
| PathParametersContain DuplicateParameter |
The path '{0}' contains duplicate parameters with name '{1}', location '{2}'. |
{0} a művelet elérési útja. {1} a duplikált paraméternév. {2} a duplikált paraméter helye (az 'in' tulajdonság). Távolítsa el a duplikált elérésiút-paramétert. |
| PathParametersContainMultiple BodyParameters |
The path '{0}' contains multiple parameters in the location 'body', at most one is allowed. |
Egy műveletnek nem lehet több olyan paramétere, amelyből mindkettő a törzsben van. A hiba kijavításához távolítsa el az egyik paramétert. |
| PathRedefined | The path '{0}' is defined multiple times with different capitalization. Paths must be unique when compared case-insensitively. |
Ugyanaz az elérési út egynél többször van definiálva. Távolítsa el vagy nevezze át a példányokat, hogy egyediek legyenek. |
| RestrictedCharactersInSummary | Summary string contains any of the restricted characters [{0}] |
Az egyik művelet összefoglalója korlátozott karaktereket tartalmaz. Távolítsa el a karaktereket, vagy fogalmazza át az összefoglalót, hogy kijavítsa ezt a hibát. |
| SelectedItemValuePathNotAllowedIn ThisPosition |
The 'selectedItemValuePath' property is not allowed in this position. It is allowed only in 'browse' operation of 'x-ms-dynamic-tree' extension. |
Bárhová is helyezte a 'selectedItemValuePath' paramétert, az nem megengedett. Távolítsa el, vagy helyezze el egy érvényes helyen. |
| StringBinaryNotSupportedFor FormUrlEncoded |
String/binary parameters are not supported for operation '{0}' with 'application/x-www-form-urlencoded' consumes type. |
A művelet a ' felhasznált erőforrások' tulajdonságban meghatározott 'application/x-www-form-urlencoded' értékkel rendelkezik. A művelet paraméterei nem lehetnek 'karakterlánc' vagy 'bináris' típusúak. |
| TotalOperationsCountExceedsMaxAllowed | The total number of operations in the swagger exceeds the maximum allowed value of '{0}'. |
Túl sok művelet van a swaggerben. |
| UnrecognizedTypeFormat | The type/format '{0}' is not recognized. |
A megadott ‘{0}’ típus/formátum ismeretlen. A támogatott típusformátumok megerősítése érdekében ellenőrizze a gépelési hibákat vagy a dokumentációt. |
| WebhookOperationsMissingNotification UrlProperty |
The webhook operation '{0}' is missing notification URL property. |
A swagger egy olyan webhook műveletet tartalmaz, amely nem rendelkezik hiányzó értesítési URL-tulajdonsággal. Ennek a tulajdonságnak a webhook művelethez történő hozzáadása kijavítja a műveletet. |
Tömbök
| Hiba | Probléma | Megoldás |
|---|---|---|
| ArrayNotNoItems | The array should have items specified. |
A tömb üres, de üres tömb nem engedélyezett. |
| RequiredPropertyArrayEmpty | The 'required' array requires at least one value. If no properties are required in the schema, remove the 'required' property. |
A swagger egy üres tömböt tartalmaz a 'required' nevű tulajdonsághoz. El kell távolítani, ha nincsenek kötelező paraméterek. |
| SchemesArrayEmpty | The 'schemes' array requires at least one value. |
A sémák nem lehet üresek, és legalább egy értékkel kell rendelkezniük. |
Nem támogatott
| Hiba | Probléma | Megoldás |
|---|---|---|
| CollectionFormatValueNotSupported | The 'collectionFormat' keyword value '{0}' is not supported. |
Csak bizonyos gyűjteményformátumok támogatottak. A swagger nem támogatott formátumot tartalmaz. |
| MimeTypeNotSupported | The MIME type '{0}' is not supported. The supported mime types are: '{1}'. |
A swaggerben használni próbált MIME-típus nem támogatott. |
| PathItemRefNotSuppored | The '$ref' property in a path is not supported. |
Egy elérési úthoz nem lehet definiálva "$ref" tulajdonság. Távolítsa el ezt a tulajdonságot. |
| SwaggerKeywordNotSupported | The '{0}' keyword is not supported. |
A(z) {0} egy swagger-kulcsszó, például mint a 'uniqueItems', és nem megengedett abban a kontextusban, ahol használják. |
Paraméterek
| Hiba | Probléma | Megoldás |
|---|---|---|
| FileParameterMustBeInFormData | Parameters of type 'file' are not valid in locations other than 'formData'. |
A swaggernek van egy 'fájl' típusú paramétere, amely csak 'in' lehet az 'formData' paraméterben. |
| 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. |
A swagger törzsparamétert és formData-t is definiál, ami nem megengedett. Távolítsa el a paramétertípusok valamelyikét. |
| ParameterReferenceNotFound | The parameter reference '{0}' could not be found in the swagger document. |
A swaggernek van egy paraméterhivatkozása, amely a swaggerdokumentumban nem található. Távolítsa el a paraméterre vonatkozó hivatkozást. |
| ParameterReferenceNotValid | The parameter reference '{0}' is not valid. Parameter references must start with '#/parameters/' and be valid JSON Pointers. |
A swaggerben van egy paraméterhivatkozás ("#/parameters/"), amely a JSON-mutató RFC-specifikációja alapján érvénytelen. |
| ParameterRefLoopNotAllowed | The parameter definition may not use a '$ref' to point to another definition. |
A swaggernek van egy paraméterdefiníciója, amely helytelenül használja a "$ref" paramétert, hogy egy másik definícióra mutasson. |
| ParamtersWithSameNameMustHave SameTypeAndVisibility |
Parameters of the same name in fetch and subscribe operations must be of the same type and visibility. |
Ha a swaggernek azonos nevű paraméterei vannak a beolvasás és előfizetés műveletekben, akkor ugyanazzal a típussal és láthatósággal kell rendelkezniük. |
| 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} a paraméter neve, amelyből hiányzik a kódolás. |
| QueryParameterEncodingNotSupported | Encoding for query parameter '{0}' is not supported. All query parameters are single encoded by default. |
{0} a paraméter neve, amelynek a kódolása nem támogatott. Javítsa ki ezt a kódolást. |
| ReservedParameterIsUsed | The parameter '{0}' is reserved and cannot be used in '{1}'. |
A hibában megadott paramétert használják, holott az nem használható, mert az az adott szakaszra vagy általánosságban van fenntartva. |
| ResponseRefLoopNotAllowed | The response definition may not use a '$ref' to point to another definition. |
A swaggernek van egy válaszdefiníciója, amely helytelenül használja a "$ref" paramétert, hogy egy másik definícióra mutasson. |
| 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. |
A paraméterre vonatkozó hivatkozás belsőként van megjelölve, de a paraméterhivatkozást használó művelet nem belső. Frissítse a paramétert vagy a műveletet a hiba kijavításához. |
Tulajdonságok
| Hiba | Probléma | Megoldás |
|---|---|---|
| AdditionalPropertyNotAllowed | The property '{0}' is not allowed and must be removed. |
A swaggerben van egy extra tulajdonság, amit el kell távolítani. |
| AdditionalPropertyNotAllowedAdjacent ToRef |
When '$ref' is defined, no other properties may be specified. |
A "$ref" swaggerben történő használata esetén az adott JSON-objektumba nem szabad más tulajdonságokat foglalni. |
| BasePathNotValid | The 'basePath' property, if present, must start with a '/' character. |
Ha alap elérési utat használ, annak “/” karakterrel kell kezdődnie. Érvénytelen alap elérési utak például: “abc/def/ghi” vagy “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. |
A swaggerben a törzsparaméterek egyike olyan érvénytelen tulajdonságot használ, amely nem használható törzsparaméterben. |
| ConnectorMetadataPropertiesMissing | The connector metadata property '{0}' is required. |
Az összekötőhöz bizonyos metaadatok szükségesek. |
| ContactEmailNotValid | The contact 'email' property, if present, must be a valid email address. |
A megadott e-mail-cím nem megfelelő formátumú, vagy nem ASCII karaktereket tartalmaz. |
| DefaultValueMustMatchType | The 'default' value is of type '{0}', but should match the given type '{1}'. |
Az alapértelmezett érték nem ugyanaz a típus, mint az adott típus. A probléma megoldásához módosítsa az alapértelmezett értéket adott típusúra. |
| EnumMustContainAtLeastOneElement | The 'enum' array requires at least one value. |
Ha a tulajdonság típusa egy felsorolás, akkor egy olyan tömböt kell megadnia, amely legalább a felsorolási értékek egyikét tartalmazza. |
| ExtensionNameNotValid | The property '{0}' is not valid. If this property is an extension, its name must begin with "x-". |
A kiterjesztés jellegű tulajdonságoknak az "x" előtaggal kell kezdődnie. |
| FilterFunctionsPropertyEmpty | The 'filterFunctions' property must have at least one element. |
Ha meg van adva, a 'filterFunction' tulajdonság nem lehet üres. |
| FilterFunctionsPropertyHasDuplicates | The 'filterFunctions' property cannot contain duplicates. |
A ‘filterFunctions’ tulajdonság nem tartalmazhat duplikált adatokat. |
| FilterFunctionsPropertyInInputSchema | The 'filterFunctions' property has to be in the response schema. |
A ‘filterFunctions’ tulajdonság csak a válaszsémában lehet. |
| FilterFunctionsPropertyInvalidValue | The 'filterFunctions' property supports only these values: {0}". |
A ‘filterFunctions’ tulajdonság nem tud meghatározni nem támogatott értéket. |
| HostNameNotValid | The 'host' property, if present, must be a valid URI host without a scheme or path. |
A séma vagy elérési út nélküli állomás URI-azonosítója úgy néz ki, mint a "www.microsoft.com". Az állomás érvénytelen URI-azonosítója a következőképpen néz ki: “https://www.microsoft.com/” vagy “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. |
A tulajdonságot belsőként jelöli meg, alapértelmezett értékkel rendelkezik, és nem kötelező. Ha biztosítani szeretné, hogy a kérések ezt tartalmazzák, jelölje meg szükség szerint; máskülönben hagyja változatlanul. |
| InvalidConnectorCategory | The connector category is invalid. Available categories are: [{0}]. |
A kategóriák csak az engedélyezett kategóriaértékek listájából jöhetnek. |
| InvalidStringBinaryProperty | A schema with type/format 'string/binary' can only be at the top level of a body or formData parameter. |
A "típus" és "formátum" tulajdonság "sztring" és "bináris" értéke nem megengedett ezen a sémahelyen. |
| JsonTypeIncorrect | The type of the property is incorrect. Expected type '{0}', but value is of type '{1}'. |
A swaggerben található tulajdonságnak egy típusa van, de a tényleges érték más típusú. Módosítsa az értéktípust úgy, hogy megfeleljen az elvárt típusnak. |
| JsonValueNotInEnum | The property value must be one of the following: {0}. |
A felsorolás 'in' tulajdonságértéke nem egyezik meg az aktuálisan elérhető beállításokkal. Módosítsa a hibaüzenetben a következő értékek valamelyikét. |
| MimeTypeNotValid | The MIME type '{0}' is not valid. |
A kiválasztott, felhasználó által megadott MIME "tartalomtípus" nem érvényes. Az érvényes mime-típusok: "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'. |
Az x-ms-enum-értékek nem határozzák meg a ‘displayName’ tulajdonságot. |
| MultipleOfMustBeGreaterThanZero | The 'multipleOf' value must be greater than zero. |
A "multipleOf" tulajdonság értékének nullánál nagyobbnak kell lennie. |
| OneOfPropertiesRequired | At least one of the properties is required: [{0}]. |
A(z) {0} a tulajdonságok egy halmaza. Ez a hiba megjeleníti az összes olyan tulajdonságot, amelynek jelen kell lennie a swaggerben. |
| ProductionStatusOnBetaService | The connector cannot be in Production status on a beta service. |
Az összekötőt nem lehet 'Termelés'-ként megjelölni, ha a háttéralkalmazás szolgáltatás béta verzióban van. Előzetes verzióban kell lennie. |
| PropertyMustBeRequired | The property is internal and has a default value, it must be required. Optional internal fields are ignored. |
A tulajdonság nincs beállítva, pedig szükséges. |
| RequiredPropertyDefinitionMissing | The required property '{0}' is not defined in the object schema. |
A sématulajdonságok a "szükséges" listában szerepelnek, ezért ezeket a "tulajdonságok" alatt kell megadni |
| RequiredPropertyMissing | The '{0}' property is required. |
Egy tulajdonság a swaggerben szükséges, de jelenleg nincs benne. A hiba kijavításához vegye fel ezt a tulajdonságot. |
| RequiredPropertyNotOnObject | The property 'required' is applicable to schemas with 'object' type only and should be removed. |
A "szükséges" tulajdonság csak az "objektum" típus esetén támogatott. Az összes többi típus esetében távolítsa el a tulajdonságot. |
| RequiredReadOnlyPropertyNotAllowed AsInput |
An input property cannot be 'readonly' and required. |
A swagger egy olyan tulajdonságot tartalmaz, amelyet csak olvashatónak és kötelezőnek jelölt meg. A csak olvasható tulajdonság azt jelenti, hogy a felhasználó nem tudja módosítani az értéket. A szükséges tulajdonsághoz egy módosítási érték kell. |
| SchemeNotValid | The 'schemes' property must only contain transfer protocols from the list: {0}. |
A sématulajdonságnak "http" vagy "https" tulajdonságnak kell lennie. |
| SecuritySchemePropertyNotValid | The security definition property '{0}' is not valid for definitions of type '{1}'. |
Van egy olyan tulajdonságnév és érték, amely nem érvényes, és amelyet Ön a securityDefinitions szótárban szerepeltetett. A probléma megoldásához módosítsa a tulajdonságot érvényes tulajdonságnévre. |
| SecuritySchemePropertyRequired | The security definition property '{0}' is required for definitions of type '{1}'. |
Van egy olyan tulajdonságnév és érték, amely szükséges, és amelyet Ön a securityDefinitions szótárban nem szerepeltetett. A probléma megoldásához adja hozzá ezt a tulajdonságot és értéket. |
| SpecificationVersionIncorrect | The 'swagger' property must have the string value "2.0". |
Csak a "2.0-s" verzió támogatott, ezért javítsa a swagger verzió tulajdonságát úgy, hogy "2.0" legyen. |
| TagRedefined | The 'tags' property defines tag '{0}' multiple times. |
A "címkék" tulajdonságban definiált címkéknek egyedinek kell lenniük. Távolítsa el vagy cserélje le a több előfordulást. |
| TooManyConnectorCategories | The maximum allowed number of categories for the connector is '{0}'. |
Az összekötőre beállítható kategóriák száma korlátozva van. |
| UrlNotValid | The 'url' property must be a valid absolute URL. |
A swaggernek érvénytelen URL-címe van. Ennek oka az URL-cím helytelen átmásolása lehet valahonnan. |
Response
| Hiba | Probléma | Megoldás |
|---|---|---|
| BodyParameterSchemaRequired | The 'body' parameter must define a 'schema' property. |
A törzsparaméterben meg kell határozni a sématulajdonságot. Adja meg a sématulajdonságot a probléma megoldásához. |
| 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. |
Túl sok séma van a törzsobjektumban. Távolítson el néhányat közülük, hogy a teljes összeg ismét a határérték alá kerüljön. |
| DefaultResponseHasSchema | The 'default' response should not have schema definition. Schemas should be defined on expected responses only. |
A swagger az alapértelmezett válasz sémadefinícióját tartalmazza. Az alapértelmezett válasz sémadefiníciójának eltávolítása kijavítja a hibát. |
| InvalidCustomEditorExtension DictionaryValue |
The 'x-ms-editor' extension can be specified as 'dictionary' only for schema with type object and additional properties allowed. |
Ellenőrizze, hogy az x-ms-szerkesztő csak akkor van-e szótárra beállítva, ha a séma objektum típusú, és további tulajdonságok is engedélyezettek. |
| JsonPointerNotValid | The JSON Pointer path is not valid. |
A swaggerben használt hivatkozás (#ref) nem érvényes. |
| NonBodyParameterSchemaNotValid | The parameter cannot define a schema as it is not in the 'body'. |
A swaggernek van egy olyan paramétere, amely a sémát használja, de csak a törzsparaméterek használhatjak a "sémát". |
| RequiredLoopInSchemaNotAllowed | Loops of required schema properties are not allowed. |
A szükséges tulajdonságok megadása nem képes referenciahurkokat használni. |
| ResponseExampleMustBeProduced ByOperation |
The response example '{0}' is not produced by the operation '{1}'. |
A swaggernek van egy művelete egy válaszpéldával, de ugyanez a művelet nem hoz létre választ a jelzett MIME-típussal. |
| ResponseHeadersAreNotUnique | The response headers are not unique. |
Van egy duplikált válaszfejléc. A válaszfejlécnek egyedinek kell lennie. |
| ResponseMustBeDefaultOrHttpStatusCode | The response is not valid, the response must be a valid HTTP status code, or the string 'default'. |
A swagger nem rendelkezik alapértelmezett vagy érvényes HTTP állapotkóddal. Adjon hozzá egy állapotkódot a válaszhoz. |
| ResponseReferenceNotFound | The response reference '{0}' could not be found in the swagger document. |
A swaggernek van egy válaszhivatkozása, amely a swaggerdokumentumban nem található. Távolítsa el a válaszra vonatkozó hivatkozást. |
| ResponseReferenceNotValid | The response reference '{0}' is not valid. Response references must start with '#/responses/' and be valid JSON Pointers. |
A swaggerben van egy válaszhivatkozás ("#/responses/"), amely a JSON-mutató RFC-specifikációja alapján érvénytelen. |
| SchemaDefinitionSetIncorrectly | The operation '{0}' should define an output schema on the 200 or 201 response code or in 'x-ms-notification-content' extension for a webhook to be visible in the designer. |
A művelethez hiányzik a 200- vagy 201-es válaszkódhoz szükséges válaszséma. Webhookok esetében a válaszsémát az értesítési tartalombővítmény részeként kell megadni. |
| SchemaReferenceNotFound | The schema reference '{0}' could not be found in the swagger document. |
A swaggernek van egy sémahivatkozása, amely a swaggerdokumentumban nem található. |
| SchemaReferenceNotValid | The schema reference '{0}' is not valid. Schema references must start with '#/definitions/' and be valid JSON Pointers. |
A swaggerben van egy sémahivatkozás ("#/definitions/"), amely a JSON-mutató RFC-specifikációja alapján érvénytelen. |
| SchemaRefLoopNotAllowed | The schema definition may not use a '$ref' to point to another definition. |
A sémában van egy referenciahurok (az A pont B pontra mutat, amely visszamutat A-ra). |
| SchemaTooDeep | The schema exceeds the maximum allowed depth. Schemas must not exceed a depth of '{0}', including referenced ('$ref') schemas. |
A sémák egy adott JSON-mélységre korlátozottak. Használjon sekélyebb sémát. |
| SchemaTypeFileNotValid | The schema type 'file' is not valid. Only parameters in 'formData' and the root response schema may be of type 'file'. |
A "fájl" sématípus használata csak űrlapadatok esetén támogatott, és a válaszdefinícióhoz használt válaszsémának a gyökérében kell lennie. |
| SchemeNotSupported | The WebSocket transfer protocol schemes are not supported. |
A séma nem támogatott. A támogatott séma a Https és a Http. |
| TotalSchemaCountExceedsMaxAllowed | The maximum allowed number of schemas in the swagger is '{0}'. Please remove any unnecessary property or item definitions. |
Túl sok séma van a swaggerben. |
Biztonsági
| Hiba | Probléma | Megoldás |
|---|---|---|
| OAuthSecurityRequirementValueMustBe ScopeName |
The OAuth security requirement '{0}' refers to scope name '{1}', but this is not defined in the 'securityDefinitions' object. |
A biztonságikövetelmény-neveknek a biztonsági definíciók objektumában definiált hatókörnévnek kell lenniük. |
| SecurityRequirementMustBeDefined | The security requirement '{0}' is not defined in the 'securityDefinitions' object. |
A biztonsági követelményt a rendszer használja, de a biztonsági definíciók szótárában nem definiálja. |
| SecurityRequirementMustHaveEmptyValue | The security requirement '{0}' cannot specify any scopes, an empty array should be provided. |
Az aktuális konfigurációtól függően a(z) ‘{0}’ nevű biztonsági követelményeknek üres tömbnek kell lennie. |
| SecurityRequirementMustHaveValue | The security requirement '{0}' must have have a value. Provide an empty array if no OAuth scopes are required. |
A biztonsági követelmény hiányzik vagy null értékű. Ha nincs szükség OAuth hatókörre, adjon meg inkább egy üres tömböt. |
Webhookok
| Hiba | Probléma | Megoldás |
|---|---|---|
| NotificationUrlNotAllowedInThisPosition | The notification URL property is not allowed in this position. It is allowed only in input body. |
Az "x-ms-notification-url" tulajdonságot csak bemenetben lehet definiálni. |
| NotificationUrlNotInternal | The notification URL property itself or at least one of its parents must be internal. |
A swagger jelenleg nem állítja az értesítési URL-tulajdonságot belsőre, amit meg kellene tennie. |
| NotificationUrlNotRequired | The notification URL property must be required all the way through the schema chain. |
A swagger jelenleg nem kér értesítési URL-tulajdonságot, ami kötelező lenne. |
| NotificationUrlNotString | The notification URL property must be of type string. |
Az értesítési URL-tulajdonságnak olyan értéke van, amely nem karakterlánc típusú. |
Metaadat
| Hiba | Probléma | Megoldás |
|---|---|---|
| AllowEmptyValueOnlyValidForQuery FormData |
The parameter cannot use the 'allowEmptyValue' keyword as it is not in the 'query' or 'formData' location. |
Az "allowEmptyValue" tulajdonság csak olyan paraméternél beállítható "igaz" értékre, amely esetében a paraméter "hely" tulajdonsága "lekérdezés" vagy "formData". A "hely" tulajdonság értéke egyik sem. |
| DiscriminatorMustBeARequiredStringProperty | The 'discriminator' value must be the name of a required string property. |
A ' diszkriminátor ' értéknek egy kötelező sztringtulajdonság nevének kell lennie a swaggerben. |
| ExclusiveMaximumRequiresMaximum | The 'exclusiveMaximum' keyword can only be specified if the 'maximum' keyword is also specified. |
Nem lehet megadni az “exclusiveMaximum” értéket a “maximum” megadása nélkül. |
| ExclusiveMinimumRequiresMinimum | The 'exclusiveMinimum' keyword can only be specified if the 'minimum' keyword is also specified. |
Nem lehet megadni az “exclusiveMinimum” értéket a “minimum” megadása nélkül. |
| FieldLengthExceeded | The '{0}' value goes over the character limit '{1}' |
A(z) {0} mezőben megadott név túllépi a(z) {1} mezőben megadott korlátot. |
| FieldLengthNotInRange | The '{0}' value must be between '{1}' and '{2}' characters. |
A(z) {0} a mező neve, a(z) {1} a minimális hosszúság, a(z) {2} a korlát. Csökkentse a mezőben szereplő karakterek hosszát. |
| MaxItemsMustBeGreaterThanOrEqual ToZero |
The 'maxItems' value must be greater than or equal to zero. |
A "maxItems" érték jelenleg nulla alatt van, módosítsa ezt az értéket nullánál nagyobbra vagy azzal egyenlőre. |
| MaxLengthMustBeGreaterThanOrEqual ToZero |
The 'maxLength' value must be greater than or equal to zero. |
A "maxLength" tulajdonság értéke egy nem negatív szám legyen. |
| MaxPropertiesMustBeGreaterThanOrEqual ToZero |
The 'maxProperties' value must be greater than or equal to zero. |
A "maxProperties" érték jelenleg nulla alatt van, módosítsa ezt az értéket nullánál nagyobbra vagy azzal egyenlőre. |
| MinimumShouldBeLessThanOrEqual ToMaximum |
The 'minimum' value should be less than or equal to the 'maximum' value. |
A minimumértéknek kevesebbnek vagy ugyanannyinak kell lennie, mint a maximumértéknek. |
| MinItemsMustBeGreaterThanOrEqual ToZero |
The 'minItems' value must be greater than or equal to zero. |
A "minItems" érték jelenleg nulla alatt van, módosítsa ezt az értéket nullánál nagyobbra vagy azzal egyenlőre. |
| MinItemsShouldBeLessThanOrEqual ToMaxItems |
The 'minItems' value should be less than or equal to the 'maxItems' value. |
A minimumtételeknek kevesebbnek vagy ugyanannyinak kell lenniük, mint a maximumtételeknek. |
| MinLengthMustBeGreaterThanOrEqual ToZero |
The 'minLength' value must be greater than or equal to zero. |
A "minLength" tulajdonság értéke egy nem negatív szám legyen. |
| MinLengthShouldBeLessThanOrEqual ToMaxLength |
The 'minLength' value should be less than or equal to the 'maxLength' value. |
A minimumhossznak kevesebbnek vagy ugyanannyinak kell lennie, mint a maximumhossznak. |
| MinPropertiesMustBeGreaterThanOrEqual ToZero |
The 'minProperties' value must be greater than or equal to zero. |
A "minProperties" érték jelenleg nulla alatt van, módosítsa ezt az értéket nullánál nagyobbra vagy azzal egyenlőre. |
| PatternShouldBeValidRegularExpression | The 'pattern' value should be a valid regular expression. |
A "minta" érték nem érvényes reguláris kifejezés, a reguláris kifejezés kijavítása korrigálja ezt a hibát. |
| RequiredValueEmpty | The '{0}' property must have not empty value. |
A swaggered üres értéket tartalmaz egy kötelező tulajdonságnál. A szükséges tulajdonság értékének beállítása megoldja a problémát. |
| ValueContainsRestrictedWords | The value '{0}' contains at least one of the restricted words: '{1}'. |
A swagger egyik mezője egy korlátozott szót használ. |
| ValueMustBeInEnglish | The '{0}' value must be written in English. |
Cserélje le az értéket egy olyan értékre, amely csak alfanumerikus karaktereket tartalmaz. |
| ValueMustEndWithAlphanumeric | The '{0}' value must end with alphanumeric character. |
Az utolsó karakter lecserélése alfanumerikus karakterre |