Swagger 検証エラーの修正
Swagger 検証ツールは、GitHub オープン ソース リポジトリおよび ISV ポータルで送信したコネクタ ファイルを検証します。 コネクタ ファイルをチェックして適切であること、またコネクタの要件とガイドラインに準拠していることを確認します。
このトピックのテーブルは、エラーを見つけて修正するのに役立ちます。 各テーブルには、ツールが生成する可能性のあるエラーがリストされています。 エラーごとに、対応する問題とソリューションがあります。 リストされているソリューションは、送信前または送信中に発生するエラーの回避に役立ちます。
さらに詳しいガイダンスが必要な場合は、ConnectorPartnerMgmtTeam@service.microsoft.com にメールを送信してください。
操作
| 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. |
操作 {0} は、非推奨とはマークされていません。 このプロパティを使用するには、操作で ’deprecated’ プロパティを 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 タイプを 1 つ指定する必要があります。 |
| DuplicateEnumValuesInExtension | The 'x-ms-enum-values' extension has duplicate values. You can only have one display name mapped to a value. |
列挙値は一意であり、重複してはなりません。 |
| 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} は操作 ID であり、{1} は重複する操作 ID、{2} は操作パス、{3} は重複する操作パスです。 重複する操作パスから重複する操作 ID を削除します。 |
| 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} は操作 ID です。操作の応答内で、型配列の戻り値を定義します。 |
| 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} は操作 ID です。操作の応答内で、特定のプロパティを定義します |
| 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. |
“x-ms-notification" の使用は、Webhook 操作では許可されていません。 |
| 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. |
操作ファミリは、非推奨ではない 2 つ操作に制限されています。 コネクタのユーザーの混乱を減らすために、その他は非推奨としてマークする必要があります。 |
| 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. |
操作ファミリは、リビジョンなしで 1 つのオペレーションのみを持つことができます。 ファミリ内のその他すべてはリビジョンを持つ必要があります。 |
| OperationHasManyResponsesWithSchema | The operation '{0}' has more than one response with specified schema, only one schema will be used in the designer. |
デザイナーの制限により、複数の応答スキーマが中断されます。 操作は複数指定しますが、1 つのみ指定する必要があります。 |
| OperationIdNotFound | The 'operationId' could not be found in this swagger document. |
operationId が Swagger に見つかりません。 |
| OperationIdNotUnique | The operationId '{0}' is used multiple times. Operation identifiers must be unique. |
同じ operationId が複数回表示されます。 インスタンスの 1 つを削除するか、インスタンスの 1 つを別のものに修正します。 |
| 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 は、サニタイズされたバージョンと一致しません。 一致するように操作 ID を更新します。 |
| OperationIdShouldEndWithRevision | The operation Id '{0}' should end with revision suffix '{1}'. |
リビジョンのある操作 ID には、リビジョンの接尾辞が付いた名前を付ける必要があります。 |
| 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 には、少なくとも 1 つの応答定義がない操作があります。 |
| OperationParameterNameIsAmbiguous | The parameter name is ambiguous as it matches both a parameter name and a path to a body property. |
パラメーターの名前は、パラメーター名およびパラメーター本体のパス名として使用されます。 この問題を修正するには、インスタンスの 1 つの名前を変更します。 |
| 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}'. |
2 回リストされている操作パラメーターがあります。 {0} は操作名、{1} は重複しているパラメーター名、{2} は重複しているパラメーターの場所です (Swagger の 'in' プロパティ)。 プロパティの繰り返しを削除します。 |
| OperationParametersContain MultipleBodyParameters |
The operation '{0}' contains multiple parameters in the location 'body', at most one is allowed. |
操作パラメーターには、重複した本体パラメーターが含まれています。 本文パラメーターの 1 つを削除します。 |
| 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 '*'. |
操作の 1 つで、サポートされていない文字 (ワイルドカード文字など) を含む 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 には、閉じられていない “{“ or “}” 文字の操作パスが含まれています。 これらの文字はパス内の変数を参照するために使用されるため、閉じていない場合はパス内に存在できません。 |
| OperationPathVariablesContainDefaults | The operation path template variables cannot set default values with character '='. |
操作の 1 つは、“=” を含むパラメーターの既定値を指定することです。 そのパラメーターは、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 には、成功した応答定義が少なくとも 1 つない操作があります。 |
| 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. |
操作の ‘summary’ プロパティを 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} は操作 ID であり、{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'. |
パラメーターの場所は ‘Path’ に設定されているため、プロパティ ‘required’ を ‘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. |
操作の 1 つに、操作パスにあるとマークされていてもパス テンプレートに存在しないパラメーターがあります。 |
| 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. |
複数の操作パラメーターを、本体に含めることはできません。 このエラーを修正するには、パラメーターの 1 つを削除してください。 |
| 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}] |
操作の 1 つの概要には、制限された文字が含まれています。 このエラーを修正するには、文字を削除するか、概要を言い換えてください。 |
| 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. |
この操作には、‘consumes’ プロパティで定義された ‘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 には、欠落している通知 URL プロパティがない Webhook 操作が含まれています。 このプロパティを Webhook 操作に追加すると、操作が修正されます。 |
Array
| エラー | イシュー | ソリューション |
|---|---|---|
| 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. |
スキーマを空にすることはできず、少なくとも 1 つの値が必要です。 |
サポートしていません
| エラー | イシュー | ソリューション |
|---|---|---|
| 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} は、'uniqueItems' などの Swagger キーワードであり、使用されているコンテキストでは許可されていません。 |
パラメーター
| エラー | イシュー | ソリューション |
|---|---|---|
| FileParameterMustBeInFormData | Parameters of type 'file' are not valid in locations other than 'formData'. |
Swagger には ‘file’ タイプのパラメーターがあり、‘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 の両方を定義しています。 これらのパラメーターの種類の 1 つを削除します。 |
| 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. |
パラメーター参照は内部としてマークされていますが、パラメーター参照が使用される操作は内部ではありません。 これを修正するには、パラメーターまたは操作を更新してください。 |
プロパティ
| エラー | イシュー | ソリューション |
|---|---|---|
| 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 の本文パラメーターの 1 つは、本文パラメーターで使用できない無効なプロパティを使用しています。 |
| 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. |
プロパティの種類が列挙型の場合、少なくとも 1 つの列挙値を持つ配列を指定する必要があります。 |
| 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. |
このスキーマの場所では、“string” および “binary” のプロパティ “type” および “format” の値は許可されていません。 |
| JsonTypeIncorrect | The type of the property is incorrect. Expected type '{0}', but value is of type '{1}'. |
Swagger のプロパティには 1 つの種類がありますが、実際の値は異なる種類です。 必要な種類に一致するように値の種類を変更します。 |
| JsonValueNotInEnum | The property value must be one of the following: {0}. |
列挙型のプロパティ値が、現在使用可能なオプションと一致しません。 エラー メッセージに記載されている次のいずれかに値を変更します。 |
| MimeTypeNotValid | The MIME type '{0}' is not valid. |
選択したユーザー提供の MIME 'content type' は無効です。 有効な 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. |
バックエンド サービスがベータ版の場合、コネクタを「実稼働」としてマークすることはできません。 「プレビュー」に設定する必要があります。 |
| 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. |
‘required’ プロパティは、‘object’ の種類でのみサポートされます。 他のすべての種類のプロパティを削除します。 |
| 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. |
‘tags’ プロパティで定義されたタグは一意である必要があります。 重複する項目を削除または置換します。 |
| 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 には ‘schema’ を使用するパラメーターがありますが、‘schema’ を使用できるのは本体パラメーターのみです。 |
| 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 応答コードの応答スキーマがありません。 Webhook の場合、応答スキーマを通知コンテンツ拡張の一部として指定する必要があります。 |
| 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 スコープが必要ない場合は、代わりに空の配列を指定してください。 |
Webhook
| エラー | イシュー | ソリューション |
|---|---|---|
| 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’ である ‘location’ プロパティを持つパラメータでのみ ‘true’ に設定できます。 'location' プロパティの値はそのどちらでもありません。 |
| 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. |
“maximum” も指定せずに “exclusiveMaximum” を指定することはできません。 |
| ExclusiveMinimumRequiresMinimum | The 'exclusiveMinimum' keyword can only be specified if the 'minimum' keyword is also specified. |
“minimum” も指定せずに “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 のフィールドの 1 つは、制限された単語を使用しています。 |
| ValueMustBeInEnglish | The '{0}' value must be written in English. |
値を英数字のみを含む値に置き換えます。 |
| ValueMustEndWithAlphanumeric | The '{0}' value must end with alphanumeric character. |
最後の文字を英数字に置き換えます |