修正 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”時，操作 ID 必須引用 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.	提供的操作 ID 與清理的版本不匹配。 請更新作業識別碼以讓其相符。
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」值。 此操作的參數不能是「string」或「binary」類型。
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 包含一個 webhook 操作，該操作沒有缺少通知 URL 屬性。 在 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 有一個名為“required”的屬性的空陣列。 如果沒有必要參數，則應將其移除。
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 有一個“file”類型的參數，它只能是“in”，即“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.	你的大搖大擺既定義了 body 參數又定義了 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.	你的大搖大擺中有一個額外的屬性必須被移除。
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}.	Scheme 屬性應為“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.	以英數字元取代最後一個字元