Swagger 유효성 검사기 오류 수정
Swagger 유효성 검사기 도구는 GitHub 오픈 소스 리포지토리 및 ISV 포털에서 제출한 커넥터 파일의 유효성을 검사합니다. 커넥터 파일이 올바른지 확인하고 커넥터 요구 사항 및 지침을 준수하는지 확인합니다.
이 토픽 표를 사용하여 오류를 찾고 수정하세요. 각 표에는 도구가 생성할 수 있는 오류가 나열되어 있습니다. 각 오류에 대해 해당 이슈 및 솔루션이 있습니다. 나열된 솔루션은 제출 이전에 또는 제출하는 동안에 오류 발생을 방지하는 데 도움이 될 수 있습니다.
추가 지침이 필요한 경우 ConnectorPartnerMgmtTeam@service.microsoft.com로 이메일을 보내주세요.
작업
| 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'에 '교체' 속성이 지정되었지만 'api' 속성이 누락되었습니다. '교체' 속성을 사용하기 위해서는 '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'에 '교체' 속성이 지정되었지만 'operationId' 속성이 누락되었습니다. '교체' 속성을 사용하기 위해서는 '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. |
열거형 값은 고유해야 하며 중복되지 않아야 합니다. |
| 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"을 사용할 수 없습니다. |
| 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는 웹후크 작업을 참조해야 합니다. |
| 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가 삭제된 버전과 일치하지 않습니다. 일치할 작업 ID를 업데이트하세요. |
| OperationIdShouldEndWithRevision | The operation Id '{0}' should end with revision suffix '{1}'. |
개정이 있는 작업 ID에는 개정 접미사가 있는 이름이 있어야 합니다. |
| OperationIdTooLong | The operationId length must be less than '{0}'. |
문자 길이가 {0}보다 작도록 'operationId' 속성 값을 줄입니다. |
| 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}은(는) 작업 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. |
작업 중 하나에 작업 경로에 있는 것으로 표시되지만 경로 템플릿에는 없는 매개 변수가 있습니다. |
| 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. |
작업에는 'consumes' 속성에 정의된 '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 속성이 없는 웹후크 작업이 포함되어 있습니다. 웹후크 작업 내에 이 속성을 추가하면 작업이 수정됩니다. |
배열
| 오류 | 이슈 | 솔루션 |
|---|---|---|
| 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}은(는) 'uniqueItems'와 같은 swagger 키워드이며 사용되는 컨텍스트에서 허용되지 않습니다. |
매개 변수
| 오류 | 이슈 | 솔루션 |
|---|---|---|
| FileParameterMustBeInFormData | Parameters of type 'file' are not valid in locations other than 'formData'. |
swagger에는 'file' 유형의 매개 변수가 있으며 'formData'에만 'in' 있을 수 있습니다. |
| 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는 허용되지 않는 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에 JSON 포인터 RFC 사양에 따라 잘못된 매개 변수 참조("#/parameters/")가 있습니다. |
| 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의 본문 매개 변수 중 하나가 본문 매개 변수에 사용할 수 없는 잘못된 속성을 사용하고 있습니다. |
| 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. |
"string" 및 "binary"의 "type" 및 "format" 속성 값은 이 스키마 위치에서 허용되지 않습니다. |
| 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}. |
enum의 속성 값이 현재 사용 가능한 옵션과 일치하지 않습니다. 값을 오류 메시지에 명시된 다음 중 하나로 변경합니다. |
| 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" 속성 값은 0보다 큰 값이어야 합니다. |
| 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. |
'필수' 속성은 '객체' 유형에만 지원됩니다. 다른 모든 유형의 속성을 제거합니다. |
| 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을 잘못 복사했기 때문일 수 있습니다. |
Response
| 오류 | 이슈 | 솔루션 |
|---|---|---|
| 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에 JSON 포인터 RFC 사양에 따라 잘못된 응답 참조("#/responses/")가 있습니다. |
| 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 응답 코드에 대한 응답 스키마가 없습니다. 웹후크의 경우 응답 스키마는 알림 콘텐츠 확장의 일부로 지정되어야 합니다. |
| 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에 JSON 포인터 RFC 사양에 따라 잘못된 스키마 참조(‘#/definitions/’)가 있습니다. |
| SchemaRefLoopNotAllowed | The schema definition may not use a '$ref' to point to another definition. |
스키마에 참조 루프가 있습니다(A는 B를 가리키고 A는 다시 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'인 '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' 값이 0보다 작습니다. 이 값을 0보다 크거나 같게 변경하세요. |
| 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' 값이 0보다 작습니다. 이 값을 0보다 크거나 같게 변경하세요. |
| 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' 값이 0보다 작습니다. 이 값을 0보다 크거나 같게 변경하세요. |
| 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' 값이 0보다 작습니다. 이 값을 0보다 크거나 같게 변경하세요. |
| PatternShouldBeValidRegularExpression | The 'pattern' value should be a valid regular expression. |
'패턴' 값은 유효한 정규식이 아닙니다. 정규식을 수정하면 이 오류가 수정됩니다. |
| 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. |
마지막 문자를 영숫자 문자로 교체 |