修正 Swagger 驗證程式錯誤

本文重點說明 Power Platform 連接器可能出現的常見 Swagger 驗證錯誤以及如何修正它們。

營運

Error	問題	方案
ApiAnnotationExtensionReplacementInfo ForNonDeprecatedOperations	The 'x-ms-api-annotation' extension for operation '{0}' is invalid. The replacement property should be specified for deprecated operations only.	作業 {0} 未標記為已取代。 若要使用此屬性，該作業應將「已取代」屬性設為 True。 如果不是這種情況，請移除「x-ms-api-annotation」屬性。
ApiAnnotationExtensionReplacementInfo MissingApiProperty	The 'x-ms-api-annotation' extension for operation '{0}' is invalid. The replacement property must specify 'api' property.	「x-ms-api-annotation」指定了「replacement」屬性，但缺少「api」屬性。 為了使用「replacement」屬性，必須設定「api」和「operationId」屬性。
ApiAnnotationExtensionReplacementInfo MissingOperationIdProperty	The 'x-ms-api-annotation' extension for operation '{0}' is invalid. The replacement property must specify 'operationId' property.	「x-ms-api-annotation」指定了「replacement」屬性，但缺少「operationId」屬性。 為了使用「replacement」屬性，必須設定「api」和「operationId」屬性。
ArrayDuplicateValue	The array contains duplicate values, values must be unique.	陣列必須具有唯一值，但您的 Swagger 包含重複資料。 移除重複資料。
BodyOrFormDataParameterInFetch OperationNotAllowed	Body or form data parameters are not supported in a fetch operation.	使用「GET」HTTP 方法的作業不能有主體或表單資料。
ConnectionIdParameterNotAllowed	A parameter cannot be named as 'connectionId'.	將參數重新命名為不是「connectionId」的值。
ConsumesMissing	At least one supported MIME type must be provided in 'consumes' for operation '{0}'.	您的 Swagger 應在取用作業中指定一個支援的 MIME 類型。
DuplicateEnumValuesInExtension	The 'x-ms-enum-values' extension has duplicate values. You can only have one display name mapped to a value.	Enum 值必須是唯一且不重複。
DuplicateOperationPath	The operations '{0}' and '{1}' have the path templates '{2}' and '{3}' which are duplicate and indistinguishable. They need to have a difference in static path segments for a deterministic routing.	{0} 為作業識別碼，{1} 為重複作業識別碼，{2} 為作業路徑，{3} 為重複作業路徑。 從重複作業路徑中移除重複作業識別碼。
DynamicExtensionDefinitionNotAllowed InParameter	Dynamic extensions are not allowed to be defined on the body parameter. It should be in the schema.	動態擴充功能是在主體參數上定義，必須移除。 它僅可在結構描述中定義。
DynamicListExtensionRequiredFor AmbiguousReferences	The 'x-ms-dynamic-values' extension references ambiguous parameter references. You need to define the 'x-ms-dynamic-list' extension.	必須定義「x-ms-dynamic-list」。 其他資訊：如何使用動態值
DynamicListExtensionRequiredFor NonParameterReferences	The 'x-ms-dynamic-values' extension references properties within parameters. You need to define the 'x-ms-dynamic-list' extension.	必須定義「x-ms-dynamic-list」。 其他資訊：如何使用動態值
DynamicPropertiesExtensionRequiredFor AmbiguousReferences	The 'x-ms-dynamic-schema' extension references ambiguous parameter references. You need to define the 'x-ms-dynamic-properties' extension.	必須定義「x-ms-dynamic- properties」。 其他資訊：如何使用動態值
DynamicPropertiesExtensionRequiredFor NonParameterReferences	The 'x-ms-dynamic-schema' extension references properties within parameters. You need to define the 'x-ms-dynamic-properties' extension.	必須定義「x-ms-dynamic- properties」。 其他資訊：如何使用動態值
DynamicPropertiesExtensionRequiredFor PropertiesValuePath	The 'x-ms-dynamic-schema' extension property 'value-path' points to schema properties. You need to define the 'x-ms-dynamic-properties' extension, which points to schema object.	您的 Swagger 檔案缺少「x-ms-dynamic-properties」，這是必要的，因為它定義了「x-ms-dynamic-schema」。
DynamicPropertiesItemValue PathMismatch	The 'x-ms-dynamic-properties' extension should have the same item value path as 'x-ms-dynamic-schema' extension without 'properties' ending. The expected path is '{0}'.	動態屬性擴充項目值路徑與根據結構描述的預期路徑不相符。
DynamicTreeExtensionMissing	The 'x-ms-dynamic-tree' extension must be defined to enable file picker support.	缺少屬性「x-ms-dynamic-tree」，必須定義它以支援檔案選取器。
InvalidEnumValue	The type of the enum value is '{0}' but it should be '{1}' as specified in the schema.	該值必須以指定的類型取代。
InvalidEnumValuesExtensionValue	The 'value' field must match one of the enums as defined in the 'enum' property of the schema.	所選取的列舉尚未在列舉清單中定義。 在列舉屬性中定義值，或使用在列舉屬性中定義的值。
InvalidFormDataParameterName	The form data parameter name '{0}' is invalid. All characters must be part of the US-ASCII character set.	將表單資料參數名稱重新命名為僅包含 US-ASCII 字元。
InvalidNextLinkNameValue	The nextLinkName value for operation '{0}' is invalid. Supported values are 'nextLink' or '@odata.nextLink'.	修正「nextLinkName」屬性的值，使其為「nextLink」或「@odata.nextLink」。 不允許使用任何其他值。
InvokedOperationShouldProduceArray	The dynamic operation expects an array on the specified path '{0}' which should be defined in the successful response of the invoked operation '{1}'.	{0} 為回覆屬性路徑，{1} 為作業識別碼。在作業回覆中定義類型陣列的傳回。
InvokedOperationShouldProduceProperty	The dynamic operation expects a property on the specified path '{0}' which should be defined in the successful response of the invoked operation '{1}'.	{0} 為回覆屬性路徑，{1} 為作業識別碼。在作業回覆中定義特定屬性
MimeTypeNotCompatibleWithRequest ContentSchemaType	The MIME type(s) are not compatible with the request content type '{0}' for operation '{1}'.	您嘗試使用的 MIME 類型與指定作業中的要求內容不相容。
NotificationExtensionNotSupportedIn WebhookOperation	The 'x-ms-notification' extension must not be defined in a webhook operation.	在 Webhook 作業中不允許使用「x-ms-notification」。
NotificationExtensionSupportedFor TriggerOnly	The 'x-ms-notification' is supported for trigger operations only.	「x-ms-notification」擴充只能用於觸發作業。
NotificationOperationMustBeWebhook	The 'operationId' property in 'x-ms-notification' extension must be for a webhook operation.	當您使用「x-ms-notification」時，作業識別碼必須參考 Webhook 作業。
OperationFamilyHasDuplicateRevisions	The operation family '{0}' has operations with duplicate revision.	您的 swagger 會定義具有相同版本/修訂編號的作業系列。 作業系列中的每個作業都應具有唯一的版本號碼。
OperationFamilyHasManyActive 營運	The operation family '{0}' has more than two active operations. Extra operations must be deprecated.	作業系列僅限於兩個未被取代的作業。 所有其他作業都應標記為已取代，以減少連接器使用者的混淆。
OperationFamilyHasManyActive ProductionOperations	The operation family '{0}' has several active operations in Production status. Previous revisions should be deprecated.	作業系列在生產中有多個作業。 若要減少混淆，請限制系列中的生產作業數目，並取代其餘部分。
OperationFamilyHasManyEmptyRevisions	The operation family '{0}' has several operations with empty revision. Only one operation can have empty revision.	作業系列只能有一個沒有修訂的作業。 系列中的所有其他作業都應具有修訂。
OperationHasManyResponsesWithSchema	The operation '{0}' has more than one response with specified schema, only one schema will be used in the designer.	設計工具的限制會阻止多個回覆結構描述。 您的作業指定多個回覆結構描述，但應該只指定一個。
OperationIdNotFound	The 'operationId' could not be found in this swagger document.	在您的 Swagger 中找不到 operationId。
OperationIdNotUnique	The operationId '{0}' is used multiple times. Operation identifiers must be unique.	相同的 operationId 出現不只一次。 請移除其中一個執行個體，或將其中一個執行個體修正為不同的執行個體。
OperationIdRequired	The operation 'operationId' property is required.	缺少「operationId」屬性，包括您作業的「operationId」屬性。
OperationIdSanitized	The 'operationId' property value is different from its sanitized value '{0}'. Please avoid the useage of non-alphanumeric characters to have matching values.	提供的作業識別碼與處理過的版本不相符。 請更新作業識別碼以讓其相符。
OperationIdShouldEndWithRevision	The operation Id '{0}' should end with revision suffix '{1}'.	具有修訂的作業識別碼應具有含修訂後綴的名稱。
OperationIdTooLong	The operationId length must be less than '{0}'.	請減少「operationId」屬性的值，讓字元長度小於 {0}。
OperationMissingPathParameter	The operation '{0}' does not define the '{1}' parameter which is required by the path.	您的 Swagger 有一個未定義其路徑範本所需之參數的作業。
OperationMissingRequiredProperty	The target operation requires parameter '{0}'.	該作業將 {0} 參數定義為必要參數，但其未在提供的參數中定義。 新增此參數以解決問題。
OperationMustHaveNotification ContentExtension	The operation '{0}' is missing notification content extension as it has '{1}' properties marked as notification URL.	您的 Swagger 包含沒有通知內容擴充的作業。 (需要更多內容)
OperationMustHaveResponse	The operation is not valid, it must contain at least one response definition.	您的 Swagger 有一個作業不具備至少一個回應定義。
OperationParameterNameIsAmbiguous	The parameter name is ambiguous as it matches both a parameter name and a path to a body property.	參數的名稱會做為參數名稱和參數主體路徑名稱使用。 重新命名其中一個執行個體以解決此問題。
OperationParameterNameNotFound	The parameter could not be found in operation '{0}' in the swagger document.	在您的 Swagger 中找不到作業參數名稱。
OperationParameterRequiredMismatch	The parameter is required, but an optional value is provided by operation '{0}'. The request cannot be made until a value for this parameter is provided.	該參數是必要的，但作業的值表明這是選擇性的，造成此不相符。
OperationParametersAreNotUnique	The parameters in the operation '{0}' are not unique.	作業參數中似乎存在重復資料。 您的 Swagger 必須移除作業參數重複資料。
OperationParametersContain DuplicateParameter	The operation '{0}' contains duplicate parameters with name '{1}', location '{2}'.	有一個作業參數被列出兩次。 {0} 是作業名稱，{1} 是重複參數名稱，{2} 是重複參數位置 (Swagger 中的「in」屬性)。 移除重複出現的屬性。
OperationParametersContain MultipleBodyParameters	The operation '{0}' contains multiple parameters in the location 'body', at most one is allowed.	作業參數包含重複的主體參數。 移除其中一個主體參數。
OperationParameterStaticTypeMismatch	The parameter has type '{0}', but a static value is provided of type '{1}'.	不需要此作業參數時，該參數提供為靜態類型。
OperationParameterTypeMismatch	The parameter has type '{0}', but operation '{1}' is providing a parameter of type '{2}'.	參數和作業具有不同的類型。 讓您的參數類型和您的作業相符。
OperationPathContainsUnsupportedCharacters	The operation path cannot contain wildcard character '*'.	您的其中一項作業指定了包含不支援的字元 (如萬用字元符號) 的 URL 路徑。
OperationPathMayNotContainQueryOrFragment	The path is not valid, it must not contain a query part or fragment identifier. To include '?' or '#' characters in the path, they must be URL encoded.	作業的路徑不能包含“「？」和「#」，除非它們經過 URL 編碼 (轉換為其 %xx 等效項)。
OperationPathMustStartWithSlash	The path is not valid, it must start with a '/' character.	如果您使用的是嘗試達成的作業路徑，則必須以「/」字元開頭。 若要修正此問題，請在路徑的開頭包含「/」字元。
OperationPathTemplateNotValid	The path is not valid, each path template variable enclosed by '{{' and '}}' characters must be contained within a single URL segment. Individual '{{' or '}}' characters which are not enclosing a path template variable must be URL encoded.	您的 Swagger 包含具有未封閉「{」或「}」字元的作業路徑。 這些字元是用來參考路徑中的變數，因此在未封閉時不能存在於路徑中。
OperationPathVariablesContainDefaults	The operation path template variables cannot set default values with character '='.	您的其中一項作業是為包含「=」的參數指定預設值。 也會將該參數指定於 URL 路徑中。 不允許此組合。
OperationRevisionEmpty	The operation '{0}' does not specify a revision in api annotation.	該作業會被標記為某系列的一部分，但沒有修訂。
OperationSchemaCountExceedsMaxAllowed	The total number of schemas in the operation has exceeded the maximum allowed value of '{0}'. Please remove any unnecessary property or item definitions.	作業中包含過多結構描述。 移除部分結構描述，使總數小於限制。
OperationShouldHaveSuccessfulResponse	The operation '{0}' should have at least one successful response definition.	您的 Swagger 有一個不具備至少一個成功回覆定義的作業。
OperationStatusAheadOfConnector	The operation '{0}' cannot be in a Production status ahead of the connector.	當整個連接器仍處於「預覽」狀態時，無法將作業標記為「生產」。
OperationSummaryTooLong	The operation 'summary' should be fewer than {0} characters for improved readablity.	請將作業「摘要」屬性減少到 120 個字元以內。
PartialDuplicateOperationPath	The operation '{0}' has the path template '{1}' which is similar to other operation path templates, this can lead to an unexpected routing to a different operation in case an input path parameter value matches to a static value segment. It is better to have unconditional routing in all cases. Partially duplicated paths are: {2}	{0} 是作業識別碼，{1} 是作業路徑，{2} 是部分重複的作業路徑組。 變更作業路徑以在共用相似性的作業路徑之間建立更大的差異。
PathParameterMustBeRequired	The parameter must be marked as required as it is used in the operation path. Include the 'required' property, with the value 'true'.	參數的位置設定為「路徑」，因此必須將「必要」屬性設為「True」。
PathParameterNotDefinedInTemplate	The 'path' parameter '{0}' is not defined in the URI path template. To include the parameter as a variable in the path, use '{{' and '}}' characters to enclose the name of the parameter in the path.	您的其中一項作業中有一個參數標記為在作業路徑中，但不存在於路徑範本。
PathParametersContain DuplicateParameter	The path '{0}' contains duplicate parameters with name '{1}', location '{2}'.	{0} 是作業路徑。 {1} 是重複參數名稱。 {2} 是重複參數的位置 (「in」屬性)。 移除重複的路徑參數。
PathParametersContainMultiple BodyParameters	The path '{0}' contains multiple parameters in the location 'body', at most one is allowed.	一個作業不能有多個參數同時存在於主體中。 若要修正此錯誤，請移除其中一個參數。
PathRedefined	The path '{0}' is defined multiple times with different capitalization. Paths must be unique when compared case-insensitively.	相同的路徑定義了不只一次。 移除或重新命名執行個體，使其成為唯一的。
RestrictedCharactersInSummary	Summary string contains any of the restricted characters [{0}]	其中一項作業的摘要包含受限字元。 若要修正此錯誤，請移除字元或改寫摘要。
SelectedItemValuePathNotAllowedIn ThisPosition	The 'selectedItemValuePath' property is not allowed in this position. It is allowed only in 'browse' operation of 'x-ms-dynamic-tree' extension.	不允許在任何地方放置「selectedItemValuePath」。 移除它，或將其置於有效位置。
StringBinaryNotSupportedFor FormUrlEncoded	String/binary parameters are not supported for operation '{0}' with 'application/x-www-form-urlencoded' consumes type.	該作業具有在「取用」屬性中定義的「application/x-www-form-urlencoded」值。 此作業的參數不能是「字串」或「二進位」類型。
TotalOperationsCountExceedsMaxAllowed	The total number of operations in the swagger exceeds the maximum allowed value of '{0}'.	在 Swagger 中包含過多作業。
UnrecognizedTypeFormat	The type/format '{0}' is not recognized.	指定的類型/格式 {0} 為未知。 請檢查是否有錯字，或檢查文件以確認支援的類型格式。
WebhookOperationsMissingNotification UrlProperty	The webhook operation '{0}' is missing notification URL property.	您的 Swagger 包含一個未具備缺少通知 URL 屬性的 Webhook 作業。 在 Webhook 作業中新增此屬性可修正此作業。

陣列

錯誤	問題	應用程式執行個體
ArrayHasNoItems	The array should have items specified.	陣列是空白的，但不允許使用空白陣列。
RequiredPropertyArrayEmpty	The 'required' array requires at least one value. If no properties are required in the schema, remove the 'required' property.	您的 Swagger 有一個名為「必要」屬性的空白陣列。 如果沒有必要參數，則應將其移除。
SchemesArrayEmpty	The 'schemes' array requires at least one value.	結構描述不能是空白的，且必須至少有一個值。

不支援

錯誤	問題	應用程式執行個體
CollectionFormatValueNotSupported	The 'collectionFormat' keyword value '{0}' is not supported.	僅支援特定的集合格式。 您的 Swagger 包含不支援的格式。
MimeTypeNotSupported	The MIME type '{0}' is not supported. The supported mime types are: '{1}'.	不支援您嘗試在 Swagger 中使用的 MIME 類型。
PathItemRefNotSuppored	The '$ref' property in a path is not supported.	路徑不能定義「$ref」屬性。 移除此屬性。
SwaggerKeywordNotSupported	The '{0}' keyword is not supported.	{0} 是 Swagger 關鍵字，例如「uniqueItems」，且在使用該關鍵字的內容中不允許使用。

參數

Error	問題	方案
FileParameterMustBeInFormData	Parameters of type 'file' are not valid in locations other than 'formData'.	您的 Swagger 有一個「檔案」類型的參數，且其只能「在」「formData」中。
ParameterListContainsFormDataAndBody	The 'parameters' list defines both a 'body' parameter, and a 'formData' parameter. Only one of these location types can be used in an operation.	您的 Swagger 同時定義了主體參數和 formData，而這是不被允許的。 移除這些參數類型之一。
ParameterReferenceNotFound	The parameter reference '{0}' could not be found in the swagger document.	您的 Swagger 具有在 Swagger 文件中找不到的參數參考。 移除此參數的參考。
ParameterReferenceNotValid	The parameter reference '{0}' is not valid. Parameter references must start with '#/parameters/' and be valid JSON Pointers.	您的 Swagger 具有參數參考 (「#/parameters/」)，根據 JSON 指標 RFC 規範其為無效的。
ParameterRefLoopNotAllowed	The parameter definition may not use a '$ref' to point to another definition.	您的 Swagger 有一個參數定義，其錯誤地使用「$ref」來指向另一個定義。
ParamtersWithSameNameMustHave SameTypeAndVisibility	Parameters of the same name in fetch and subscribe operations must be of the same type and visibility.	如果您的 Swagger 在擷取和訂閱作業中具有相同名稱的參數，則它們應具有相同的類型與可見性。
PathParameterMissingEncoding	Encoding for path parameter '{0}' is missing, which might lead to invalid requests. Use "x-ms-url-encoding": "single" to ensure the value is URL encoded.	{0} 是缺少編碼的參數名稱。
QueryParameterEncodingNotSupported	Encoding for query parameter '{0}' is not supported. All query parameters are single encoded by default.	{0} 是具有不受支援之編碼的參數名稱。 修正此編碼。
ReservedParameterIsUsed	The parameter '{0}' is reserved and cannot be used in '{1}'.	正在使用此錯誤中所述的參數，但這是無法使用的，因其是為該區段或一般情況保留的。
ResponseRefLoopNotAllowed	The response definition may not use a '$ref' to point to another definition.	您的 Swagger 有一個回覆定義，其錯誤地使用「$ref」來指向另一個定義。
SourcePropertyInternal	The parameter reference '{0}' in the source operation '{1}' is internal or one of its parent(s) are internal. Either make the property visible or update the parameter reference to a static value.	參數參考被標記為內部，但使用參數參考的作業不是內部。 若要修正此錯誤，請更新參數或作業。

內容

Error	問題	方案
AdditionalPropertyNotAllowed	The property '{0}' is not allowed and must be removed.	你的 Swagger 中還有一個額外屬性必須移除。
AdditionalPropertyNotAllowedAdjacent ToRef	When '$ref' is defined, no other properties may be specified.	當您在 Swagger 中使用「$ref」時，該 JSON 物件中不應包含其他屬性。
BasePathNotValid	The 'basePath' property, if present, must start with a '/' character.	如果您使用的是基礎路徑，則其必須以「/」開頭。 無效的基礎路徑看起來像「abc/def/ghi」或「microsoft.com/abc」。
BodyParameterPropertyNotValid	The 'body' parameter cannot use property '{0}', instead, the 'schema' property should be used to define the type used by the parameter.	Swagger 中的其中一個主體參數使用了不能在主體參數中使用的無效屬性。
ConnectorMetadataPropertiesMissing	The connector metadata property '{0}' is required.	連接器需要某些中繼資料。
ContactEmailNotValid	The contact 'email' property, if present, must be a valid email address.	提供的電子郵件地址格式不正確或包含非 ASCII 字元。
DefaultValueMustMatchType	The 'default' value is of type '{0}', but should match the given type '{1}'.	預設值的值與指定類型的類型不同。 將預設值的值變更為指定類型的值以修正此問題。
EnumMustContainAtLeastOneElement	The 'enum' array requires at least one value.	如果您的屬性類型是列舉，則其應指定一個至少包含一個列舉值的陣列。
ExtensionNameNotValid	The property '{0}' is not valid. If this property is an extension, its name must begin with "x-".	做為擴充的屬性必須以「x-」前綴開頭。
FilterFunctionsPropertyEmpty	The 'filterFunctions' property must have at least one element.	如果指定，則「filterFunctions」屬性不能為空白。
FilterFunctionsPropertyHasDuplicates	The 'filterFunctions' property cannot contain duplicates.	「FilterFunctions」屬性不能包含重複資料。
FilterFunctionsPropertyInInputSchema	The 'filterFunctions' property has to be in the response schema.	「FilterFunctions」屬性只能位於回覆結構描述中。
FilterFunctionsPropertyInvalidValue	The 'filterFunctions' property supports only these values: {0}".	「FilterFunctions」屬性無法指定不受支援的值。
HostNameNotValid	The 'host' property, if present, must be a valid URI host without a scheme or path.	沒有結構描述或路徑的主機 URI 看起來像「www.microsoft.com」。主機的無效 URI 看起來像：「https://www.microsoft.com/"」；或「www.microsoft.com/hello」
InternalPropertyWithDefaultOptional	The internal property has a default value but is optional. Only required properties are guaranteed to be included in requests.	屬性標記為內部且指定了預設值，這不是必要的。 如果要確保要求中包含此項目，請將其標記為必要；否則它會保持原樣。
InvalidConnectorCategory	The connector category is invalid. Available categories are: [{0}].	類別只能來自允許的類別值清單。
InvalidStringBinaryProperty	A schema with type/format 'string/binary' can only be at the top level of a body or formData parameter.	「字串」和「二進位」的「類型」和「格式」屬性值在此結構描述位置是不允許的。
JsonTypeIncorrect	The type of the property is incorrect. Expected type '{0}', but value is of type '{1}'.	Swagger 中的屬性是一種類型，但實際值為不同類型。 變更值類型以符合預期的類型。
JsonValueNotInEnum	The property value must be one of the following: {0}.	列舉中的屬性值與目前可用的選項不相符。 將改值變更為以下錯誤訊息中所述的其中一個值。
MimeTypeNotValid	The MIME type '{0}' is not valid.	您所選取的使用者提供的 MIME「內容類型」無效。 有效的 MIME 類型包括：「application/json」、「text/plain」、「multipart/form-data」、「application/x-www-form-urlencoded」
MissingEnumValuesDisplayName	The 'x-ms-enum-values' extension is invalid. Please specify the property 'displayName'.	x-ms-enum-values 未指定「displayName」屬性。
MultipleOfMustBeGreaterThanZero	The 'multipleOf' value must be greater than zero.	「multipleOf」屬性的值應該是一個大於零的值。
OneOfPropertiesRequired	At least one of the properties is required: [{0}].	{0} 是一組屬性。 此錯誤會顯示 Swagger 中必須存在的所有屬性。
ProductionStatusOnBetaService	The connector cannot be in Production status on a beta service.	當後端服務處於 Beta 版時，連接器不能標記為「生產」。 它必須設為「預覽」。
PropertyMustBeRequired	The property is internal and has a default value, it must be required. Optional internal fields are ignored.	屬性雖為必要，但未被設定。
RequiredPropertyDefinitionMissing	The required property '{0}' is not defined in the object schema.	結構描述屬性列在「必要」底下，因此必須在「屬性」中定義
RequiredPropertyMissing	The '{0}' property is required.	需要您 Swagger 中的屬性，但它目前不在您的 Swagger 中。 若要修正此錯誤，請包含此屬性。
RequiredPropertyNotOnObject	The property 'required' is applicable to schemas with 'object' type only and should be removed.	「必要」屬性僅支援「物件」類型。 移除所有其他類型的屬性。
RequiredReadOnlyPropertyNotAllowed AsInput	An input property cannot be 'readonly' and required.	您的 Swagger 包含標記為唯讀和必要的屬性。 唯讀屬性代表使用者不能修改該值。 必要屬性需要一個值進行修改。
SchemeNotValid	The 'schemes' property must only contain transfer protocols from the list: {0}.	結構描述屬性應該是「http」或「https」兩者之一。
SecuritySchemePropertyNotValid	The security definition property '{0}' is not valid for definitions of type '{1}'.	您包含在 securityDefinitions 字典中的屬性名稱和值無效。 若要解決此問題，請將此屬性變更為有效的屬性名稱。
SecuritySchemePropertyRequired	The security definition property '{0}' is required for definitions of type '{1}'.	有必要的屬性名稱和值未包含在 securityDefinitions 字典中。 新增此屬性與值以修正此問題。
SpecificationVersionIncorrect	The 'swagger' property must have the string value "2.0".	僅支援「2.0」版本，因此請將 Swagger 版本屬性修正為「2.0」。
TagRedefined	The 'tags' property defines tag '{0}' multiple times.	在「標籤」屬性中定義的標籤必須是唯一的。 移除或取代任何多次發生次數。
TooManyConnectorCategories	The maximum allowed number of categories for the connector is '{0}'.	可以為連接器設定的類別數目有限制。
UrlNotValid	The 'url' property must be a valid absolute URL.	您的 Swagger 具有無效 URL。 這可能是因為從某處錯誤地複製了 URL。

回應

錯誤	問題	應用程式執行個體
BodyParameterSchemaRequired	The 'body' parameter must define a 'schema' property.	在主體參數中，必須定義結構描述屬性。 定義結構描述屬性以解決此問題。
BodySchemaCountExceedsMaxAllowed	The total number of schemas in the object exceeds the max schema count allowed value of '{0}'. Please remove any unnecessary property or item definitions.	主體物件中包含過多結構描述。 移除部分結構描述，使總數小於限制。
DefaultResponseHasSchema	The 'default' response should not have schema definition. Schemas should be defined on expected responses only.	您的 Swagger 包含預設回覆的結構描述定義。 移除預設回覆的此結構描述定義可修正此錯誤。
InvalidCustomEditorExtension DictionaryValue	The 'x-ms-editor' extension can be specified as 'dictionary' only for schema with type object and additional properties allowed.	檢查 x-ms-editor 是否僅在結構描述類型為物件並設為允許的其他屬性時設為字典。
JsonPointerNotValid	The JSON Pointer path is not valid.	在您的 Swagger 中使用的參考 (#ref) 無效。
NonBodyParameterSchemaNotValid	The parameter cannot define a schema as it is not in the 'body'.	您的 Swagger 具有使用「結構描述」的參數，但只有主體參數可以使用「結構描述」。
RequiredLoopInSchemaNotAllowed	Loops of required schema properties are not allowed.	必要屬性的規範不能使用參考迴圈。
ResponseExampleMustBeProduced ByOperation	The response example '{0}' is not produced by the operation '{1}'.	您的 Swagger 有一個具有回覆範例的作業，但該作業並不會產生具有指定 MIME 類型的回覆。
ResponseHeadersAreNotUnique	The response headers are not unique.	有重複的回覆標頭。 回應標頭應該是唯一的。
ResponseMustBeDefaultOrHttpStatusCode	The response is not valid, the response must be a valid HTTP status code, or the string 'default'.	您的 Swagger 沒有預設的 HTTP 狀態碼或有效的 HTTP 狀態碼。 將狀態碼新增至回應。
ResponseReferenceNotFound	The response reference '{0}' could not be found in the swagger document.	您的 Swagger 具有在 Swagger 文件中找不到的回應參考。 移除此回應的參考。
ResponseReferenceNotValid	The response reference '{0}' is not valid. Response references must start with '#/responses/' and be valid JSON Pointers.	您的 Swagger 具有回覆參考 (「#/responses/」)，根據 JSON 指標 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.	您的作業缺少 200 或 201 回覆碼的回覆結構描述。 如果是 Webhooks，則回覆結構描述應指定為通知內容擴充的一部分。
SchemaReferenceNotFound	The schema reference '{0}' could not be found in the swagger document.	您的 Swagger 具有在 Swagger 文件中找不到的結構描述參考。
SchemaReferenceNotValid	The schema reference '{0}' is not valid. Schema references must start with '#/definitions/' and be valid JSON Pointers.	您的 Swagger 具有結構描述參考 (「#/definitions/」)，根據 JSON 指標 RFC 規範其為無效。
SchemaRefLoopNotAllowed	The schema definition may not use a '$ref' to point to another definition.	您的結構描述中有一個參考迴圈 (A 指向 B，B 又指向 A)。
SchemaTooDeep	The schema exceeds the maximum allowed depth. Schemas must not exceed a depth of '{0}', including referenced ('$ref') schemas.	結構描述僅限於特定的 JSON 深度。 使用更淺的結構描述。
SchemaTypeFileNotValid	The schema type 'file' is not valid. Only parameters in 'formData' and the root response schema may be of type 'file'.	僅在表單資料中支援使用結構描述類型「檔案」，且必須位於回覆定義的回覆結構描述根目錄中。
SchemeNotSupported	The WebSocket transfer protocol schemes are not supported.	不支援此結構描述。 支援的結構描述為 Https 和 Http。
TotalSchemaCountExceedsMaxAllowed	The maximum allowed number of schemas in the swagger is '{0}'. Please remove any unnecessary property or item definitions.	Swagger 中包含過多結構描述。

安全性

錯誤	問題	應用程式執行個體
OAuthSecurityRequirementValueMustBe ScopeName	The OAuth security requirement '{0}' refers to scope name '{1}', but this is not defined in the 'securityDefinitions' object.	安全性要求名稱必須是在安全性定義物件中定義的範圍名稱。
SecurityRequirementMustBeDefined	The security requirement '{0}' is not defined in the 'securityDefinitions' object.	已使用安全性需求，但未在安全性定義字典中定義。
SecurityRequirementMustHaveEmptyValue	The security requirement '{0}' cannot specify any scopes, an empty array should be provided.	根據目前的設定，名稱為「{0}」的安全性要求必須是空白陣列。
SecurityRequirementMustHaveValue	The security requirement '{0}' must have have a value. Provide an empty array if no OAuth scopes are required.	安全性要求遺失或為 Null。 如果不需要 OAuth 範圍，請指定空白陣列。

Webhooks

錯誤	問題	方案
NotificationUrlNotAllowedInThisPosition	The notification URL property is not allowed in this position. It is allowed only in input body.	「x-ms-notification-url」屬性應該只在輸入中定義。
NotificationUrlNotInternal	The notification URL property itself or at least one of its parents must be internal.	應該是您的 Swagger 目前並未將通知 URL 屬性設為內部。
NotificationUrlNotRequired	The notification URL property must be required all the way through the schema chain.	您的 Swagger 目前沒有要求通知 URL 屬性，而這應該是必要的。
NotificationUrlNotString	The notification URL property must be of type string.	通知 URL 屬性的值不是字串類型。

中繼資料

錯誤	問題	應用程式執行個體
AllowEmptyValueOnlyValidForQuery FormData	The parameter cannot use the 'allowEmptyValue' keyword as it is not in the 'query' or 'formData' location.	「allowEmptyValue」屬性只能具有「位置」屬性為「query」或「formData」的參數中設為「True」。 「位置」屬性的值不屬於這兩種。
DiscriminatorMustBeARequiredStringProperty	The 'discriminator' value must be the name of a required string property.	「discriminator」值應該是您的 Swagger 中所需字串屬性的名稱。
ExclusiveMaximumRequiresMaximum	The 'exclusiveMaximum' keyword can only be specified if the 'maximum' keyword is also specified.	您不能在不指定「最大值」的情況下指定「exclusiveMaximum」。
ExclusiveMinimumRequiresMinimum	The 'exclusiveMinimum' keyword can only be specified if the 'minimum' keyword is also specified.	您不能在不指定「最小值」的情況下指定「exclusiveMinimum」。
FieldLengthExceeded	The '{0}' value goes over the character limit '{1}'	{0} 中指定名稱的欄位超出 {1} 中指定的字元限制。
FieldLengthNotInRange	The '{0}' value must be between '{1}' and '{2}' characters.	{0} 是欄位名稱，{1} 是最小長度，{2} 為限制。 減少此欄位中字元的長度。
MaxItemsMustBeGreaterThanOrEqual ToZero	The 'maxItems' value must be greater than or equal to zero.	「maxItems」值目前小於零。 將此值變更為大於或等於零。
MaxLengthMustBeGreaterThanOrEqual ToZero	The 'maxLength' value must be greater than or equal to zero.	「maxLength」屬性的值應該是非負數值。
MaxPropertiesMustBeGreaterThanOrEqual ToZero	The 'maxProperties' value must be greater than or equal to zero.	「maxProperties」值目前小於零。 將此值變更為大於或等於零。
MinimumShouldBeLessThanOrEqual ToMaximum	The 'minimum' value should be less than or equal to the 'maximum' value.	當您指定最小值時，該值應小於或等於最大值。
MinItemsMustBeGreaterThanOrEqual ToZero	The 'minItems' value must be greater than or equal to zero.	「minItems」值目前小於零。 將此值變更為大於或等於零。
MinItemsShouldBeLessThanOrEqual ToMaxItems	The 'minItems' value should be less than or equal to the 'maxItems' value.	當您指定最小項目時，該值應小於或等於最大項目。
MinLengthMustBeGreaterThanOrEqual ToZero	The 'minLength' value must be greater than or equal to zero.	「minLength」屬性的值應該是非負數值。
MinLengthShouldBeLessThanOrEqual ToMaxLength	The 'minLength' value should be less than or equal to the 'maxLength' value.	當您指定最小長度時，該值應小於或等於最大長度。
MinPropertiesMustBeGreaterThanOrEqual ToZero	The 'minProperties' value must be greater than or equal to zero.	「minProperties」值目前小於零。 將此值變更為大於或等於零。
PatternShouldBeValidRegularExpression	The 'pattern' value should be a valid regular expression.	「pattern」值不是有效的規則運算式，修正規則運算式可修正此錯誤。
RequiredValueEmpty	The '{0}' property must have not empty value.	您的 Swagger 包含所需屬性的空白值。 設定這個必要屬性的值可修正此問題。
ValueContainsRestrictedWords	The value '{0}' contains at least one of the restricted words: '{1}'.	Swagger 中的其中一個欄位使用了受限的文字。
ValueMustBeInEnglish	The '{0}' value must be written in English.	將該值取代為僅包含英數字元的值。
ValueMustEndWithAlphanumeric	The '{0}' value must end with alphanumeric character.	以英數字元取代最後一個字元