Swagger Validator-Fehler beheben
In diesem Artikel werden die häufigsten Swagger-Validierungsfehler erläutert, die bei Power Platform Konnektoren auftreten können, und wie diese behoben werden können.
Vorgänge
| Error | Issue | Solution |
|---|---|---|
| ApiAnnotationExtensionReplacementInfo ForNonDeprecatedOperations |
The 'x-ms-api-annotation' extension for operation '{0}' is invalid. The replacement property should be specified for deprecated operations only. |
Die Operation {0} ist nicht als veraltet markiert. Um diese Eigenschaft zu verwenden, sollte die Eigenschaft „deprecated“ für den Vorgang auf true gesetzt sein. Andernfalls, wenn dies nicht der Fall ist, entfernen Sie die Eigenschaft „x-ms-API-annotation“. |
| ApiAnnotationExtensionReplacementInfo MissingApiProperty |
The 'x-ms-api-annotation' extension for operation '{0}' is invalid. The replacement property must specify 'api' property. |
In der „x-ms-API-Annotation“ ist die „replacement“-Eigenschaft angegeben, aber die „API“-Eigenschaft fehlt. Um die 'replacement'-Eigenschaft zu verwenden, müssen sowohl die 'API'- als auch die 'operationId'-Eigenschaft gesetzt werden. |
| ApiAnnotationExtensionReplacementInfo MissingOperationIdProperty |
The 'x-ms-api-annotation' extension for operation '{0}' is invalid. The replacement property must specify 'operationId' property. |
In der „x-ms-API-Annotation“ ist die „replacement“-Eigenschaft angegeben, aber die „operationId“-Eigenschaft fehlt. Um die 'replacement'-Eigenschaft zu verwenden, müssen sowohl die 'API'- als auch die 'operationId'-Eigenschaft gesetzt werden. |
| ArrayDuplicateValue | The array contains duplicate values, values must be unique. |
Arrays müssen eindeutige Werte haben, aber Ihre Prahlerei enthält Duplikate. Entfernen Sie die Duplikate. |
| BodyOrFormDataParameterInFetch OperationNotAllowed |
Body or form data parameters are not supported in a fetch operation. |
Vorgänge, die die HTTP-Methode „GET“ verwenden, dürfen keine Text- oder Formulardaten enthalten. |
| ConnectionIdParameterNotAllowed | A parameter cannot be named as 'connectionId'. |
Benennen Sie den Parameter in einen Wert um, der nicht „connectionId“ ist. |
| ConsumesMissing | At least one supported MIME type must be provided in 'consumes' for operation '{0}'. |
Ihr Swagger sollte einen unterstützten MIME-Typ angeben, der für den Betrieb verwendet wird. |
| DuplicateEnumValuesInExtension | The 'x-ms-enum-values' extension has duplicate values. You can only have one display name mapped to a value. |
Enum-Werte sollten eindeutig sein und dürfen nicht dupliziert werden. |
| 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} ist die Vorgangs-ID, {1} ist die doppelte Vorgangs-ID, {2} ist der Operationspfad, {3} ist der doppelte Operationspfad. Entfernen Sie die doppelte Vorgangs-ID aus dem doppelten Vorgangspfad. |
| DynamicExtensionDefinitionNotAllowed InParameter |
Dynamic extensions are not allowed to be defined on the body parameter. It should be in the schema. |
Die dynamischen Erweiterungen werden für einen Body-Parameter definiert und müssen entfernt werden. Es kann nur im Schema definiert werden. |
| DynamicListExtensionRequiredFor AmbiguousReferences |
The 'x-ms-dynamic-values' extension references ambiguous parameter references. You need to define the 'x-ms-dynamic-list' extension. |
'x-ms-dynamic-list' muss definiert sein. Weitere Informationen: So verwenden Sie dynamische Werte |
| DynamicListExtensionRequiredFor NonParameterReferences |
The 'x-ms-dynamic-values' extension references properties within parameters. You need to define the 'x-ms-dynamic-list' extension. |
'x-ms-dynamic-list' muss definiert sein. Weitere Informationen: So verwenden Sie dynamische Werte |
| DynamicPropertiesExtensionRequiredFor AmbiguousReferences |
The 'x-ms-dynamic-schema' extension references ambiguous parameter references. You need to define the 'x-ms-dynamic-properties' extension. |
'x-ms-dynamic-list- properties' muss definiert sein. Weitere Informationen: So verwenden Sie dynamische Werte |
| DynamicPropertiesExtensionRequiredFor NonParameterReferences |
The 'x-ms-dynamic-schema' extension references properties within parameters. You need to define the 'x-ms-dynamic-properties' extension. |
x-ms-dynamic-list- properties' muss definiert sein. Weitere Informationen: So verwenden Sie dynamische Werte |
| 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. |
In Ihrer Swagger-Datei fehlen 'x-ms-dynamic-properties', was erforderlich ist, da sie ein 'x-ms-dynamic-schema' definiert. |
| 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}'. |
Der Wertpfad des Elements der dynamischen Eigenschaftenerweiterung stimmt nicht mit dem basierend auf dem Schema erwarteten Pfad überein. |
| DynamicTreeExtensionMissing | The 'x-ms-dynamic-tree' extension must be defined to enable file picker support. |
Die Eigenschaft 'x-ms-dynamic-tree' fehlt und muss definiert werden, um die Dateiauswahl zu unterstützen. |
| InvalidEnumValue | The type of the enum value is '{0}' but it should be '{1}' as specified in the schema. |
Der Wert muss durch den angegebenen Typ ersetzt werden. |
| InvalidEnumValuesExtensionValue | The 'value' field must match one of the enums as defined in the 'enum' property of the schema. |
Das ausgewählte Enumeration wurde in der Enumerationsliste nicht definiert. Definieren Sie entweder den Wert in der Enum-Eigenschaft oder verwenden Sie einen in der Enum-Eigenschaft definierten Wert. |
| InvalidFormDataParameterName | The form data parameter name '{0}' is invalid. All characters must be part of the US-ASCII character set. |
Benennen Sie den Namen des Formulardatenparameters so um, dass er nur US-ASCII-Zeichen enthält. |
| InvalidNextLinkNameValue | The nextLinkName value for operation '{0}' is invalid. Supported values are 'nextLink' or '@odata.nextLink'. |
Korrigieren Sie den Wert der Eigenschaft „nextLinkName“, sodass er entweder „nextLink“ oder „@odata.nextLink“ lautet. Alle anderen Werte sind nicht zulässig. |
| 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} ist der Pfad zu einer Antworteigenschaft, {1} ist die Vorgangs-ID. Definieren Sie in der Antwort der Operation eine Rückgabe vom Typ Array. |
| 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} ist der Pfad zu einer Antworteigenschaft, {1} ist die Vorgangs-ID. Definieren Sie in der Antwort der Operation eine spezifische Eigenschaft |
| MimeTypeNotCompatibleWithRequest ContentSchemaType |
The MIME type(s) are not compatible with the request content type '{0}' for operation '{1}'. |
Der Typ MIME, den Sie verwenden möchten, ist im angegebenen Vorgang nicht mit dem Inhalt Ihrer Anfrage kompatibel. |
| NotificationExtensionNotSupportedIn WebhookOperation |
The 'x-ms-notification' extension must not be defined in a webhook operation. |
Die Verwendung von „x-ms-notification“ ist in einem Webhook-Vorgang nicht zulässig. |
| NotificationExtensionSupportedFor TriggerOnly |
The 'x-ms-notification' is supported for trigger operations only. |
Die Erweiterung „x-ms-notification“ kann nur für Trigger-Operationen verwendet werden. |
| NotificationOperationMustBeWebhook | The 'operationId' property in 'x-ms-notification' extension must be for a webhook operation. |
Wenn Sie „x-ms-notification“ verwenden, muss sich die Vorgangs-ID auf einen Webhook-Vorgang beziehen. |
| OperationFamilyHasDuplicateRevisions | The operation family '{0}' has operations with duplicate revision. |
Ihre Swagger definiert eine Betriebsfamilie mit derselben Versions-/Revisionsnummer. Jeder Vorgang in einer Vorgangsfamilie sollte eine eindeutige Versionsnummer haben. |
| OperationFamilyHasManyActive Vorgänge |
The operation family '{0}' has more than two active operations. Extra operations must be deprecated. |
Operationsfamilien sind auf zwei nicht veraltete Operationen beschränkt. Alle anderen sollten als veraltet markiert werden, um Verwirrung für den Benutzer Ihres Connectors zu vermeiden. |
| OperationFamilyHasManyActive ProductionOperations |
The operation family '{0}' has several active operations in Production status. Previous revisions should be deprecated. |
Eine Vorgangsfamilie hat mehrere Vorgänge in der Produktion. Um Verwirrung zu vermeiden, begrenzen Sie die Anzahl der Produktionsvorgänge in einer Familie und stellen Sie den Rest ein. |
| OperationFamilyHasManyEmptyRevisions | The operation family '{0}' has several operations with empty revision. Only one operation can have empty revision. |
Vorgangsfamilien können nur einen Vorgang ohne Revision haben. Alle anderen in der Familie sollten eine Revision haben. |
| OperationHasManyResponsesWithSchema | The operation '{0}' has more than one response with specified schema, only one schema will be used in the designer. |
Einschränkungen im Designer verhindern Mehrfachantwortschemata. Ihre Operation gibt mehrere an, sollte jedoch nur eine angeben. |
| OperationIdNotFound | The 'operationId' could not be found in this swagger document. |
Die operationId kann in Ihrem Swagger nicht gefunden werden. |
| OperationIdNotUnique | The operationId '{0}' is used multiple times. Operation identifiers must be unique. |
Dieselbe operationId wird mehr als einmal angezeigt. Entfernen Sie eine der Instanzen oder korrigieren Sie, dass eine der Instanzen anders ist. |
| OperationIdRequired | The operation 'operationId' property is required. |
Die Eigenschaft 'operationId' fehlt, schließen Sie die Eigenschaft 'operationId' für Ihren Vorgang ein. |
| OperationIdSanitized | The 'operationId' property value is different from its sanitized value '{0}'. Please avoid the useage of non-alphanumeric characters to have matching values. |
Die angegebene Vorgangs-ID stimmt nicht mit der bereinigten Version überein. Aktualisieren Sie die Vorgangs-ID entsprechend. |
| OperationIdShouldEndWithRevision | The operation Id '{0}' should end with revision suffix '{1}'. |
Vorgangs-IDs mit einer Revision sollten einen Namen mit dem Revisionssuffix haben. |
| OperationIdTooLong | The operationId length must be less than '{0}'. |
Reduzieren Sie den Wert der Eigenschaft 'operationId', sodass die Zeichenlänge kleiner ist als {0}. |
| OperationMissingPathParameter | The operation '{0}' does not define the '{1}' parameter which is required by the path. |
Ihr Swagger weist eine Operation auf, die einen Parameter nicht definiert, der für die Pfadvorlage offenbar erforderlich ist. |
| OperationMissingRequiredProperty | The target operation requires parameter '{0}'. |
Für die Operation ist der Parameter „{0}“ als erforderlich definiert, dies ist jedoch in den bereitgestellten Parametern nicht definiert. Fügen Sie diesen Parameter hinzu, um das Problem zu beheben. |
| OperationMustHaveNotification ContentExtension |
The operation '{0}' is missing notification content extension as it has '{1}' properties marked as notification URL. |
Ihr Swagger enthält einen Vorgang, der keine Benachrichtigungsinhaltserweiterung hat. (Mehr Kontext erforderlich) |
| OperationMustHaveResponse | The operation is not valid, it must contain at least one response definition. |
Ihr Swagger hat eine Operation, die nicht über mindestens eine Antwortdefinition verfügt. |
| OperationParameterNameIsAmbiguous | The parameter name is ambiguous as it matches both a parameter name and a path to a body property. |
Der Name des Parameters wird als Parametername und als Pfadname für den Parametertext verwendet. Benennen Sie eine der Instanzen um, um dieses Problem zu beheben. |
| OperationParameterNameNotFound | The parameter could not be found in operation '{0}' in the swagger document. |
Der Vorgangsparametername kann in Ihrem Swagger nicht gefunden werden. |
| 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. |
Der Parameter ist erforderlich, aber der Wert für die Operation gibt an, dass er optional ist, was zu dieser Nichtübereinstimmung führt. |
| OperationParametersAreNotUnique | The parameters in the operation '{0}' are not unique. |
Es scheint ein Duplikat innerhalb der Betriebsparameter zu geben. Ihr Swagger muss Duplikate von Betriebsparametern entfernen. |
| OperationParametersContain DuplicateParameter |
The operation '{0}' contains duplicate parameters with name '{1}', location '{2}'. |
Es gibt einen Betriebsparameter, der zweimal aufgeführt wird. {0} ist der Vorgangsname, {1} ist der duplizierte Parametername, {2} ist die duplizierte Parameterposition ('in'-Eigenschaft in Swagger). Entfernen Sie das Wiederauftreten der Eigenschaft. |
| OperationParametersContain MultipleBodyParameters |
The operation '{0}' contains multiple parameters in the location 'body', at most one is allowed. |
Die Operationsparameter enthalten duplizierte Body-Parameter. Entfernen Sie einen der Körperparameter. |
| OperationParameterStaticTypeMismatch | The parameter has type '{0}', but a static value is provided of type '{1}'. |
Der Parameter hat einen statischen Typ, wenn dies für diesen Operationsparameter nicht erwartet wird. |
| OperationParameterTypeMismatch | The parameter has type '{0}', but operation '{1}' is providing a parameter of type '{2}'. |
Der Parameter und der Vorgang haben unterschiedliche Typen. Passen Sie den Typ Ihres Parameters und Ihren Vorgang an. |
| OperationPathContainsUnsupportedCharacters | The operation path cannot contain wildcard character '*'. |
Einer Ihrer Vorgänge gibt einen URL-Pfad an, der nicht unterstützte Zeichen enthält (wie das Platzhaltersymbol). |
| 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. |
Der Pfad des Vorgangs darf kein '?' enthalten. Und „#“, sofern sie nicht URL-codiert sind (übersetzt in ihre %xx-Äquivalente). |
| OperationPathMustStartWithSlash | The path is not valid, it must start with a '/' character. |
Wenn Sie einen Operationspfad verwenden, muss dieser, um ihn zu erreichen, mit dem Zeichen „/“ beginnen. Um dieses Problem zu beheben, fügen Sie am Anfang des Pfads das Zeichen „/“ ein. |
| 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. |
Ihr Swagger enthält einen Operationspfad mit einem nicht geschlossenen „{' oder '}“-Zeichen. Diese Zeichen werden verwendet, um auf eine Variable im Pfad zu verweisen, sodass sie nicht im Pfad vorhanden sein können, wenn sie nicht geschlossen sind. |
| OperationPathVariablesContainDefaults | The operation path template variables cannot set default values with character '='. |
Eine Ihrer Operationen besteht darin, einen Standardwert für einen Parameter anzugeben, der "=" enthält. Dieser Parameter wird auch im URL-Pfad angegeben. Diese Kombination ist nicht zulässig. |
| OperationRevisionEmpty | The operation '{0}' does not specify a revision in api annotation. |
Der Vorgang ist als Teil einer Familie gekennzeichnet, verfügt jedoch über keine Revision. |
| 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. |
Der Vorgang enthält zu viele Schemata. Entfernen Sie einige von ihnen, damit die Gesamtzahl wieder unter dem Grenzwert liegt. |
| OperationShouldHaveSuccessfulResponse | The operation '{0}' should have at least one successful response definition. |
Ihr Swagger weist eine Operation auf, die nicht über mindestens eine erfolgreiche Antwort-Definition verfügt. |
| OperationStatusAheadOfConnector | The operation '{0}' cannot be in a Production status ahead of the connector. |
Vorgänge können nicht als „Produktion“ markiert werden, solange sich der gesamte Connector noch in „Vorschauversion“ befindet. |
| OperationSummaryTooLong | The operation 'summary' should be fewer than {0} characters for improved readablity. |
Reduzieren Sie die Eigenschaft 'Zusammenfassung' der Operation auf weniger als 120 Zeichen. |
| 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} ist die Vorgangs-ID, {1} ist der Operationspfad, {2} ist der Satz von teilweise duplizierten Operationspfaden. Ändern Sie den Vorgangspfad, um einen größeren Unterschied zwischen den Vorgangspfaden zu erzielen, die die Ähnlichkeit aufweisen. |
| PathParameterMustBeRequired | The parameter must be marked as required as it is used in the operation path. Include the 'required' property, with the value 'true'. |
Die Position des Parameters ist auf 'Path' gesetzt, daher muss die Eigenschaft 'required' auf 'true' gesetzt sein. |
| 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. |
In einer Ihrer Operationen gibt es einen Parameter, der als im Operationspfad befindlich markiert ist, in der Pfadvorlage jedoch nicht vorhanden ist. |
| PathParametersContain DuplicateParameter |
The path '{0}' contains duplicate parameters with name '{1}', location '{2}'. |
{0} ist der Vorgangspfad. {1} ist der duplizierte Parametername. {2} ist die Position (die 'in'-Eigenschaft) des duplizierten Parameters. Entfernen Sie den duplizierten Pfadparameter. |
| PathParametersContainMultiple BodyParameters |
The path '{0}' contains multiple parameters in the location 'body', at most one is allowed. |
Es kann nicht mehrere Parameter für einen Vorgang geben, die sich beide im Textkörper befinden. Um diesen Fehler zu beheben, entfernen Sie einen der Parameter. |
| PathRedefined | The path '{0}' is defined multiple times with different capitalization. Paths must be unique when compared case-insensitively. |
Derselbe Pfad wird mehr als einmal definiert. Entfernen Sie die Instanzen oder benennen Sie sie um, sodass sie eindeutig sind. |
| RestrictedCharactersInSummary | Summary string contains any of the restricted characters [{0}] |
Die Zusammenfassung einer Ihrer Vorgänge enthält eingeschränkte Zeichen. Um diesen Fehler zu beheben, entfernen Sie die Zeichen oder formulieren Sie die Zusammenfassung neu. |
| SelectedItemValuePathNotAllowedIn ThisPosition |
The 'selectedItemValuePath' property is not allowed in this position. It is allowed only in 'browse' operation of 'x-ms-dynamic-tree' extension. |
Wo auch immer Sie den 'selectedItemValuePath' platziert haben, ist nicht zulässig. Entfernen Sie es oder platzieren Sie es an einem gültigen Ort. |
| StringBinaryNotSupportedFor FormUrlEncoded |
String/binary parameters are not supported for operation '{0}' with 'application/x-www-form-urlencoded' consumes type. |
Für die Operation ist der Wert 'application/x-www-Form-urlencoded' in der Eigenschaft 'consumes' definiert. Die Parameter für diesen Vorgang dürfen nicht vom Typ „Zeichenfolge“ oder „Binär“ sein. |
| TotalOperationsCountExceedsMaxAllowed | The total number of operations in the swagger exceeds the maximum allowed value of '{0}'. |
Der Swagger enthält zu viele Vorgänge. |
| UnrecognizedTypeFormat | The type/format '{0}' is not recognized. |
Der gegebene Typ/das gegebene Format „{0}“ ist unbekannt. Suchen Sie nach Tippfehlern oder in der Dokumentation, um die unterstützten Typformate zu bestätigen. |
| WebhookOperationsMissingNotification UrlProperty |
The webhook operation '{0}' is missing notification URL property. |
Ihr Swagger enthält einen Webhook-Vorgang, bei dem die Eigenschaft „Benachrichtigungs-URL fehlt“ nicht vorhanden ist. Das Hinzufügen dieser Eigenschaft innerhalb des Webhook-Vorgangs behebt den Vorgang. |
Arrays
| Fehler | Issue | Lösung |
|---|---|---|
| ArrayHasNoItems | The array should have items specified. |
Das Array ist leer, aber ein leeres Array ist nicht zulässig. |
| RequiredPropertyArrayEmpty | The 'required' array requires at least one value. If no properties are required in the schema, remove the 'required' property. |
Ihr Swagger hat ein leeres Array für eine Eigenschaft mit dem Namen „erforderlich“. Es sollte entfernt werden, wenn keine erforderlichen Parameter vorhanden sind. |
| SchemesArrayEmpty | The 'schemes' array requires at least one value. |
Schemas dürfen nicht leer sein und müssen mindestens einen Wert haben. |
Nicht unterstützt
| Fehler | Issue | Lösung |
|---|---|---|
| CollectionFormatValueNotSupported | The 'collectionFormat' keyword value '{0}' is not supported. |
Es werden nur bestimmte Sammlungsformate unterstützt. Ihr Swagger enthält ein nicht unterstütztes Format. |
| MimeTypeNotSupported | The MIME type '{0}' is not supported. The supported mime types are: '{1}'. |
Der MIME-Typ, den Sie in Ihrem Swagger verwenden möchten, wird nicht unterstützt. |
| PathItemRefNotSuppored | The '$ref' property in a path is not supported. |
Für einen Pfad kann keine '$ref'-Eigenschaft definiert sein. Diese Eigenschaft entfernen. |
| SwaggerKeywordNotSupported | The '{0}' keyword is not supported. |
{0} ist ein Swagger-Schlüsselwort wie „uniqueItems“ und ist im Kontext, in dem es verwendet wird, nicht zulässig. |
Parameter
| Error | Issue | Solution |
|---|---|---|
| FileParameterMustBeInFormData | Parameters of type 'file' are not valid in locations other than 'formData'. |
Ihr Swagger hat einen Parameter vom Typ „Datei“ und dieser kann nur „in“ den „Formulardaten“ sein. |
| 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. |
Ihr Swagger definiert sowohl einen Body-Parameter als auch FormData, was nicht zulässig ist. Entfernen Sie einen dieser Parametertypen. |
| ParameterReferenceNotFound | The parameter reference '{0}' could not be found in the swagger document. |
Ihr Swagger hat eine Parameterreferenz, die im swagger-Dokument nicht zu finden ist. Entfernen Sie den Verweis auf diesen Parameter. |
| ParameterReferenceNotValid | The parameter reference '{0}' is not valid. Parameter references must start with '#/parameters/' and be valid JSON Pointers. |
Ihr Swagger hat eine Parameterreferenz („#/parameters/“), die basierend auf der RFC-Spezifikation für JSON-Zeiger ungültig ist. |
| ParameterRefLoopNotAllowed | The parameter definition may not use a '$ref' to point to another definition. |
Ihr Swagger hat eine Parameterdefinition, die fälschlicherweise '$ref' verwendet, um auf eine andere Definition zu verweisen. |
| ParamtersWithSameNameMustHave SameTypeAndVisibility |
Parameters of the same name in fetch and subscribe operations must be of the same type and visibility. |
Wenn Ihr Swagger Parameter mit demselben Namen in Abruf- und Abonnementvorgängen hat, sollten sie denselben Typ und dieselbe Sichtbarkeit haben. |
| 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} ist der Parametername, dem die Codierung fehlt. |
| QueryParameterEncodingNotSupported | Encoding for query parameter '{0}' is not supported. All query parameters are single encoded by default. |
{0} ist der Parametername, der die nicht unterstützte Codierung hat. Korrigieren Sie diese Codierung. |
| ReservedParameterIsUsed | The parameter '{0}' is reserved and cannot be used in '{1}'. |
Der in diesem Fehler angegebene Parameter wird verwendet, kann jedoch nicht verwendet werden, da er für diesen Abschnitt oder allgemein reserviert ist. |
| ResponseRefLoopNotAllowed | The response definition may not use a '$ref' to point to another definition. |
Ihr Swagger hat eine Antwortdefinition, die fälschlicherweise '$ref' verwendet, um auf eine andere Definition zu verweisen. |
| 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. |
Die Parameterreferenz ist als intern gekennzeichnet, aber die Operation, bei der die Parameterreferenz verwendet wird, ist nicht intern. Um dies zu beheben, aktualisieren Sie den Parameter oder die Operation. |
Eigenschaften
| Error | Issue | Solution |
|---|---|---|
| AdditionalPropertyNotAllowed | The property '{0}' is not allowed and must be removed. |
Ihr Swagger enthält eine zusätzliche Eigenschaft, die entfernt werden muss. |
| AdditionalPropertyNotAllowedAdjacent ToRef |
When '$ref' is defined, no other properties may be specified. |
Wenn Sie „$ref“ im Swagger verwenden, sollten in diesem JSON-Objekt keine anderen Eigenschaften enthalten sein. |
| BasePathNotValid | The 'basePath' property, if present, must start with a '/' character. |
Wenn Sie einen Basispfad verwenden, muss dieser mit „/“ beginnen. Ungültige Basispfade sehen wie „abc/def/ghi“ oder „microsoft.com/abc“ aus. |
| BodyParameterPropertyNotValid | The 'body' parameter cannot use property '{0}', instead, the 'schema' property should be used to define the type used by the parameter. |
Einer der body-Parameter in Ihrem Swagger verwendet eine ungültige Eigenschaft, die nicht in einem body-Parameter verwendet werden kann. |
| ConnectorMetadataPropertiesMissing | The connector metadata property '{0}' is required. |
Für den Connector sind bestimmte Metadaten erforderlich. |
| ContactEmailNotValid | The contact 'email' property, if present, must be a valid email address. |
Die angegebene E-Mail-Adresse hat ein falsches Format oder enthält Nicht-ASCII-Zeichen. |
| DefaultValueMustMatchType | The 'default' value is of type '{0}', but should match the given type '{1}'. |
Der Wert für Ihren Standardwert ist nicht derselbe Typ wie der angegebene Typ. Ändern Sie den Wert für den Standardwert in den des angegebenen Typs, um dieses Problem zu beheben. |
| EnumMustContainAtLeastOneElement | The 'enum' array requires at least one value. |
Wenn Ihr Eigenschaftstyp eine Aufzählung ist, sollte er ein Array mit mindestens einem der Aufzählungswerte angeben. |
| ExtensionNameNotValid | The property '{0}' is not valid. If this property is an extension, its name must begin with "x-". |
Eigenschaften, die Erweiterungen sind, müssen mit dem Präfix „x-“ beginnen. |
| FilterFunctionsPropertyEmpty | The 'filterFunctions' property must have at least one element. |
Die Eigenschaft 'filterFunctions' darf nicht leer sein, wenn sie angegeben ist. |
| FilterFunctionsPropertyHasDuplicates | The 'filterFunctions' property cannot contain duplicates. |
Die Eigenschaft 'filterFunctions' darf keine Duplikate enthalten. |
| FilterFunctionsPropertyInInputSchema | The 'filterFunctions' property has to be in the response schema. |
Die Eigenschaft 'filterFunctions' kann nur im Antwortschema enthalten sein. |
| FilterFunctionsPropertyInvalidValue | The 'filterFunctions' property supports only these values: {0}". |
Die Eigenschaft 'filterFunctions' kann keinen nicht unterstützten Wert angeben. |
| HostNameNotValid | The 'host' property, if present, must be a valid URI host without a scheme or path. |
Eine Host-URI ohne Schema oder Pfad sieht wie „www.microsoft.com“ aus. Eine ungültige URI für den Host sieht wie „https://www.microsoft.com/“ oder „www.microsoft.com/hello“ aus. |
| InternalPropertyWithDefaultOptional | The internal property has a default value but is optional. Only required properties are guaranteed to be included in requests. |
Eine Eigenschaft ist als intern gekennzeichnet, hat einen angegebenen Standardwert und ist nicht erforderlich. Wenn Sie sicherstellen möchten, dass dies in den Anfragen enthalten ist, markieren Sie es als erforderlich. Andernfalls können Sie es so belassen, wenn dies beabsichtigt ist. |
| InvalidConnectorCategory | The connector category is invalid. Available categories are: [{0}]. |
Kategorien können nur aus der Liste der zulässigen Kategoriewerte stammen. |
| InvalidStringBinaryProperty | A schema with type/format 'string/binary' can only be at the top level of a body or formData parameter. |
Der Wert der Eigenschaft „type“ und „Format“ von „string“ und „binary“ ist an dieser Schemaposition nicht zulässig. |
| JsonTypeIncorrect | The type of the property is incorrect. Expected type '{0}', but value is of type '{1}'. |
Eine Eigenschaft in Ihrem Swagger hat einen Typ, aber der tatsächliche Wert ist ein anderer Typ. Ändern Sie den Werttyp so, dass er dem erwarteten Typ entspricht. |
| JsonValueNotInEnum | The property value must be one of the following: {0}. |
Der Eigenschaftswert von Enumeration stimmt nicht mit den aktuell verfügbaren Optionen überein. Ändern Sie den Wert in einen der folgenden in der Fehlermeldung angegebenen Werte. |
| MimeTypeNotValid | The MIME type '{0}' is not valid. |
Das vom Benutzer bereitgestellte MIME 'Inhaltstyp', das Sie ausgewählt haben, ist ungültig. Die gültigen MIME-Typen sind: „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'. |
Die x-ms-enum-values haben die Eigenschaft „displayName“ nicht angegeben. |
| MultipleOfMustBeGreaterThanZero | The 'multipleOf' value must be greater than zero. |
Der Wert der Eigenschaft „multipleOf“ sollte ein Wert größer als Null sein. |
| OneOfPropertiesRequired | At least one of the properties is required: [{0}]. |
{0} ist eine Menge von Eigenschaften. Dieser Fehler zeigt alle Eigenschaften an, die im Swagger vorhanden sein müssen. |
| ProductionStatusOnBetaService | The connector cannot be in Production status on a beta service. |
Der Connector kann nicht als „Produktion“ gekennzeichnet werden, wenn sich der Back-End-Dienst in der Betaphase befindet. Es muss auf „Vorschauversion“ eingestellt sein. |
| PropertyMustBeRequired | The property is internal and has a default value, it must be required. Optional internal fields are ignored. |
Die Eigenschaft wird nicht festgelegt, obwohl sie erforderlich ist. |
| RequiredPropertyDefinitionMissing | The required property '{0}' is not defined in the object schema. |
Eine Schemaeigenschaft wird als „erforderlich“ aufgeführt und muss daher in den „Eigenschaften“ definiert werden. |
| RequiredPropertyMissing | The '{0}' property is required. |
Eine Eigenschaft in Ihrer Prahlerei ist erforderlich, befindet sich jedoch derzeit nicht in Ihrer Prahlerei. Um diesen Fehler zu beheben, schließen Sie diese Eigenschaft ein. |
| RequiredPropertyNotOnObject | The property 'required' is applicable to schemas with 'object' type only and should be removed. |
Die Eigenschaft 'erforderlich' wird nur für den Typ 'Objekt' unterstützt. Entfernen Sie die Eigenschaft für alle anderen Typen. |
| RequiredReadOnlyPropertyNotAllowed AsInput |
An input property cannot be 'readonly' and required. |
Ihr Swagger enthält eine Eigenschaft, die als schreibgeschützt und erforderlich markiert ist. Eine schreibgeschützte Eigenschaft bedeutet, dass der Benutzer den Wert nicht ändern kann. Eine erforderliche Eigenschaft erfordert einen Wert zum Ändern. |
| SchemeNotValid | The 'schemes' property must only contain transfer protocols from the list: {0}. |
Die Schemaeigenschaft sollte „http“ oder „https“ sein. |
| SecuritySchemePropertyNotValid | The security definition property '{0}' is not valid for definitions of type '{1}'. |
Sie haben in das SecurityDefinitions-Wörterbuch einen ungültigen Eigenschaftsnamen und -wert aufgenommen. Um dieses Problem zu beheben, ändern Sie diese Eigenschaft in einen gültigen Eigenschaftsnamen. |
| SecuritySchemePropertyRequired | The security definition property '{0}' is required for definitions of type '{1}'. |
Es sind ein Eigenschaftsname und ein Eigenschaftswert erforderlich, die nicht im SecurityDefinitions-Wörterbuch enthalten sind. Fügen Sie diese Eigenschaft und diesen Wert hinzu, um dieses Problem zu beheben. |
| SpecificationVersionIncorrect | The 'swagger' property must have the string value "2.0". |
Es wird nur die Version „2.0“ unterstützt, also berichtigen Sie die Versionseigenschaft von swagger auf „2.0“. |
| TagRedefined | The 'tags' property defines tag '{0}' multiple times. |
In der Eigenschaft 'tags' definierte Tags müssen eindeutig sein. Entfernen oder ersetzen Sie alle mehrfachen Vorkommen. |
| TooManyConnectorCategories | The maximum allowed number of categories for the connector is '{0}'. |
Die Anzahl der Kategorien, die für den Connector festgelegt werden können, ist begrenzt. |
| UrlNotValid | The 'url' property must be a valid absolute URL. |
Ihr Swagger hat eine ungültige URL. Dies kann daran liegen, dass die URL falsch von irgendwoher kopiert wurde. |
Response
| Fehler | Issue | Lösung |
|---|---|---|
| BodyParameterSchemaRequired | The 'body' parameter must define a 'schema' property. |
Im Parameter body muss die Schemaeigenschaft definiert werden. Definieren Sie die Schemaeigenschaft, um dieses Problem zu beheben. |
| 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. |
Das body-Objekt enthält zu viele Schemata. Entfernen Sie einige von ihnen, damit die Gesamtzahl wieder unter dem Grenzwert liegt. |
| DefaultResponseHasSchema | The 'default' response should not have schema definition. Schemas should be defined on expected responses only. |
Ihr Swagger enthält eine Schemadefinition für die Standardantwort. Das Entfernen dieser Schemadefinition für die Standardantwort behebt diesen Fehler. |
| InvalidCustomEditorExtension DictionaryValue |
The 'x-ms-editor' extension can be specified as 'dictionary' only for schema with type object and additional properties allowed. |
Überprüfen Sie, ob der x-ms-Editor nur dann auf Dictionary gesetzt ist, wenn das Schema vom Typ object ist und auf zusätzliche Eigenschaften gesetzt ist. |
| JsonPointerNotValid | The JSON Pointer path is not valid. |
Eine Referenz (#ref), die in Ihrem Swagger verwendet wird, ist ungültig. |
| NonBodyParameterSchemaNotValid | The parameter cannot define a schema as it is not in the 'body'. |
Ihr Swagger hat einen Parameter, der 'schema' verwendet, aber nur Körperparameter können 'schema' verwenden. |
| RequiredLoopInSchemaNotAllowed | Loops of required schema properties are not allowed. |
Die Angabe erforderlicher Eigenschaften kann keine Referenzschleifen verwenden. |
| ResponseExampleMustBeProduced ByOperation |
The response example '{0}' is not produced by the operation '{1}'. |
Ihr Swagger hat eine Operation mit einem Antwort-Beispiel, aber dieselbe Operation erzeugt kein Antwort mit dem angegebenen MIME-Typ. |
| ResponseHeadersAreNotUnique | The response headers are not unique. |
Es gibt einen doppelten Antwort-Header. Antwortheader sollten eindeutig sein. |
| ResponseMustBeDefaultOrHttpStatusCode | The response is not valid, the response must be a valid HTTP status code, or the string 'default'. |
Ihr Swagger hat weder einen Standard-HTTP-Statuscode noch einen gültigen HTTP-Statuscode. Fügen Sie Ihrer Antwort einen Statuscode hinzu. |
| ResponseReferenceNotFound | The response reference '{0}' could not be found in the swagger document. |
Ihr Swagger hat eine Antwortreferenz, die im Swagger-Dokument nicht zu finden ist. Entfernen Sie den Verweis auf diese Antwort. |
| ResponseReferenceNotValid | The response reference '{0}' is not valid. Response references must start with '#/responses/' and be valid JSON Pointers. |
Ihr Swagger hat eine Antwortreferenz („#/responses/“), die basierend auf der JSON-Zeiger-RFC-Spezifikation ungültig ist. |
| 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. |
In Ihrem Vorgang fehlt ein Antwortschema für den Antwortcode 200 oder 201. Für Webhooks sollte das Antwortschema als Teil der Benachrichtigungsinhaltserweiterung angegeben werden. |
| SchemaReferenceNotFound | The schema reference '{0}' could not be found in the swagger document. |
Ihr Swagger hat eine Schemareferenz, die im Swagger-Dokument nicht gefunden werden konnte. |
| SchemaReferenceNotValid | The schema reference '{0}' is not valid. Schema references must start with '#/definitions/' and be valid JSON Pointers. |
Ihr Swagger hat eine Schemareferenz (‘#/definitions/’), die basierend auf der JSON-Zeiger-RFC-Spezifikation ungültig ist. |
| SchemaRefLoopNotAllowed | The schema definition may not use a '$ref' to point to another definition. |
In Ihrem Schema gibt es eine Referenzschleife (A zeigt auf B, das zurück auf A zeigt). |
| SchemaTooDeep | The schema exceeds the maximum allowed depth. Schemas must not exceed a depth of '{0}', including referenced ('$ref') schemas. |
Schemas sind auf eine bestimmte JSON-Tiefe beschränkt. Verwenden Sie ein flacheres Schema. |
| SchemaTypeFileNotValid | The schema type 'file' is not valid. Only parameters in 'formData' and the root response schema may be of type 'file'. |
Die Verwendung des Schematyps 'Datei' wird nur in Formulardaten unterstützt und muss sich am Stamm des Antwortschemas für die Antwortdefinition befinden. |
| SchemeNotSupported | The WebSocket transfer protocol schemes are not supported. |
Das Schema wird nicht unterstützt. Die unterstützten Schemata sind HTTPS und HTTP. |
| TotalSchemaCountExceedsMaxAllowed | The maximum allowed number of schemas in the swagger is '{0}'. Please remove any unnecessary property or item definitions. |
Der Swagger enthält zu viele Schemata. |
Sicherheit
| Fehler | Issue | Lösung |
|---|---|---|
| OAuthSecurityRequirementValueMustBe ScopeName |
The OAuth security requirement '{0}' refers to scope name '{1}', but this is not defined in the 'securityDefinitions' object. |
Sicherheitsanforderungsnamen müssen ein Bereichsname sein, der im Sicherheitsdefinitionsobjekt definiert ist. |
| SecurityRequirementMustBeDefined | The security requirement '{0}' is not defined in the 'securityDefinitions' object. |
Eine Sicherheitsanforderung wird verwendet, aber nicht im Wörterbuch der Sicherheitsdefinitionen definiert. |
| SecurityRequirementMustHaveEmptyValue | The security requirement '{0}' cannot specify any scopes, an empty array should be provided. |
Basierend auf der aktuellen Konfiguration müssen die Sicherheitsanforderungen mit dem Namen '{0}' ein leeres Array sein. |
| SecurityRequirementMustHaveValue | The security requirement '{0}' must have have a value. Provide an empty array if no OAuth scopes are required. |
Die Sicherheitsanforderung fehlt oder ist null. Wenn keine OAuth-Bereiche erforderlich sind, geben Sie stattdessen ein leeres Array an. |
Webhooks
| Fehler | Issue | Lösung |
|---|---|---|
| NotificationUrlNotAllowedInThisPosition | The notification URL property is not allowed in this position. It is allowed only in input body. |
Die Eigenschaft „x-ms-notification-url“ sollte nur in einer Eingabe definiert werden. |
| NotificationUrlNotInternal | The notification URL property itself or at least one of its parents must be internal. |
Ihre Swagger setzt die Benachrichtigungs-URL-Eigenschaft derzeit nicht auf intern, was der Fall sein sollte. |
| NotificationUrlNotRequired | The notification URL property must be required all the way through the schema chain. |
Ihr Swagger erfordert derzeit keine Benachrichtigungs-URL-Eigenschaft, die erforderlich sein sollte. |
| NotificationUrlNotString | The notification URL property must be of type string. |
Die Benachrichtigungs-URL-Eigenschaft hat einen Wert, der nicht vom Typ string ist. |
Metadaten
| Fehler | Issue | Lösung |
|---|---|---|
| AllowEmptyValueOnlyValidForQuery FormData |
The parameter cannot use the 'allowEmptyValue' keyword as it is not in the 'query' or 'formData' location. |
Die Eigenschaft 'allowEmptyValue' kann nur in einem Parameter mit einer 'location'-Eigenschaft, die 'query' oder 'formData' ist, auf 'true' gesetzt werden. Der Wert der Eigenschaft 'location' ist nicht der Fall. |
| DiscriminatorMustBeARequiredStringProperty | The 'discriminator' value must be the name of a required string property. |
Der 'discriminator'-Wert sollte der Name einer erforderlichen Zeichenfolgeneigenschaft in Ihrem Swagger sein. |
| ExclusiveMaximumRequiresMaximum | The 'exclusiveMaximum' keyword can only be specified if the 'maximum' keyword is also specified. |
Sie können kein „exclusiveMaximum“ angeben, ohne auch ein „maximum“ anzugeben. |
| ExclusiveMinimumRequiresMinimum | The 'exclusiveMinimum' keyword can only be specified if the 'minimum' keyword is also specified. |
Sie können kein „exclusiveMinimum“ angeben, ohne auch ein „minimum“ anzugeben. |
| FieldLengthExceeded | The '{0}' value goes over the character limit '{1}' |
Ein Feld mit dem in angegebenen Namen {0} überschreitet die Zeichenbegrenzung, die in {1} angegeben ist. |
| FieldLengthNotInRange | The '{0}' value must be between '{1}' and '{2}' characters. |
{0} ist der Feldname, {1} ist die Mindestlänge, {2} ist die Grenze. Verringern Sie die Länge der Zeichen in diesem Feld. |
| MaxItemsMustBeGreaterThanOrEqual ToZero |
The 'maxItems' value must be greater than or equal to zero. |
Der „maxItems“-Wert liegt derzeit unter Null. Ändern Sie diesen Wert auf größer oder gleich Null. |
| MaxLengthMustBeGreaterThanOrEqual ToZero |
The 'maxLength' value must be greater than or equal to zero. |
Der Wert der Eigenschaft „maxLength“ sollte eine positive Zahl sein. |
| MaxPropertiesMustBeGreaterThanOrEqual ToZero |
The 'maxProperties' value must be greater than or equal to zero. |
Der Wert „maxProperties“ ist derzeit kleiner als Null. Ändern Sie diesen Wert auf größer oder gleich Null. |
| MinimumShouldBeLessThanOrEqual ToMaximum |
The 'minimum' value should be less than or equal to the 'maximum' value. |
Wenn Sie einen Mindestwert angeben, sollte dieser kleiner oder gleich dem Höchstwert sein. |
| MinItemsMustBeGreaterThanOrEqual ToZero |
The 'minItems' value must be greater than or equal to zero. |
Der „minItems“-Wert ist derzeit kleiner als Null. Ändern Sie diesen Wert auf größer oder gleich Null. |
| MinItemsShouldBeLessThanOrEqual ToMaxItems |
The 'minItems' value should be less than or equal to the 'maxItems' value. |
Wenn Sie eine Mindestanzahl an Elementen angeben, sollte der Wert kleiner oder gleich der Höchstanzahl an Elementen sein. |
| MinLengthMustBeGreaterThanOrEqual ToZero |
The 'minLength' value must be greater than or equal to zero. |
Der Wert der Eigenschaft „minLength“ sollte eine positive Zahl sein. |
| MinLengthShouldBeLessThanOrEqual ToMaxLength |
The 'minLength' value should be less than or equal to the 'maxLength' value. |
Wenn Sie eine Mindestlänge angeben, sollte der Wert kleiner oder gleich der maximalen Länge sein. |
| MinPropertiesMustBeGreaterThanOrEqual ToZero |
The 'minProperties' value must be greater than or equal to zero. |
Der „minProperties“-Wert ist derzeit kleiner als Null. Ändern Sie diesen Wert auf größer oder gleich Null. |
| PatternShouldBeValidRegularExpression | The 'pattern' value should be a valid regular expression. |
Der „Muster“-Wert ist kein gültiger regulärer Ausdruck. Das Korrigieren des regulären Ausdrucks behebt diesen Fehler. |
| RequiredValueEmpty | The '{0}' property must have not empty value. |
Ihr Swagger enthält einen leeren Wert für eine erforderliche Eigenschaft. Das Festlegen des Werts dieser erforderlichen Eigenschaft behebt dieses Problem. |
| ValueContainsRestrictedWords | The value '{0}' contains at least one of the restricted words: '{1}'. |
Eines der Felder im Swagger verwendet ein eingeschränktes Wort. |
| ValueMustBeInEnglish | The '{0}' value must be written in English. |
Ersetzen Sie den Wert durch einen Wert, der nur alphanumerische Zeichen enthält. |
| ValueMustEndWithAlphanumeric | The '{0}' value must end with alphanumeric character. |
Ersetzen Sie das letzte Zeichen durch ein alphanumerisches Zeichen |