Correggere gli errori di Swagger Validator
Lo strumento Swagger Validator convalida i file del connettore che invii nel repository open source GitHub e il portale ISV. Controlla i file del connettore per assicurarsi che siano corretti e aderisce ai nostri requisiti e linee guida relativi ai connettori.
Usa le tabelle in questo argomento per aiutarti a trovare e correggere gli errori. Ogni tabella elenca gli errori che lo strumento potrebbe generare. Per ogni errore, vi sono un problema e una soluzione corrispondenti. Le soluzioni elencate potrebbero aiutarti a evitare errori prima o durante l'invio.
Se hai bisogno di ulteriore assistenza, invia un messaggio e-mail a ConnectorPartnerMgmtTeam@service.microsoft.com.
Operazioni
| Error | Problema | Soluzione |
|---|---|---|
| ApiAnnotationExtensionReplacementInfo ForNonDeprecatedOperations |
The 'x-ms-api-annotation' extension for operation '{0}' is invalid. The replacement property should be specified for deprecated operations only. |
L'operazione {0} non è contrassegnata come deprecata. Per utilizzare questa proprietà, l'operazione deve avere la proprietà "deprecated" impostata su true. In caso contrario, rimuovi la proprietà "x-ms-api-annotation". |
| ApiAnnotationExtensionReplacementInfo MissingApiProperty |
The 'x-ms-api-annotation' extension for operation '{0}' is invalid. The replacement property must specify 'api' property. |
Per "x-ms-api-annotation", la proprietà "replacement" è specificata ma la proprietà "api" risulta mancante. Per utilizzare la proprietà "replacement", devono essere impostate sia la proprietà "api" che "operationId". |
| ApiAnnotationExtensionReplacementInfo MissingOperationIdProperty |
The 'x-ms-api-annotation' extension for operation '{0}' is invalid. The replacement property must specify 'operationId' property. |
Per "x-ms-api-annotation", la proprietà "replacement" è specificata ma la proprietà "operationId" risulta mancante. Per utilizzare la proprietà "replacement", devono essere impostate sia la proprietà "api" che "operationId". |
| ArrayDuplicateValue | The array contains duplicate values, values must be unique. |
Gli array devono avere valori univoci, ma lo swagger contiene duplicati. Rimuovi i duplicati. |
| BodyOrFormDataParameterInFetch OperationNotAllowed |
Body or form data parameters are not supported in a fetch operation. |
Le operazioni che utilizzano il metodo HTTP "GET" non possono avere un corpo o dati di modulo. |
| ConnectionIdParameterNotAllowed | A parameter cannot be named as 'connectionId'. |
Imposta il parametro su un valore diverso da "connectionId". |
| ConsumesMissing | At least one supported MIME type must be provided in 'consumes' for operation '{0}'. |
Lo swagger deve specificare un tipo MIME supportato in consumes per l'operazione. |
| DuplicateEnumValuesInExtension | The 'x-ms-enum-values' extension has duplicate values. You can only have one display name mapped to a value. |
I valori Enum devono essere univoci e non duplicati. |
| 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} è l'ID operazione, {1} è l'ID operazione duplicato, {2} è il percorso dell'operazione, {3} è il percorso dell'operazione duplicato. Rimuovi l'ID operazione duplicato dal percorso dell'operazione duplicato. |
| DynamicExtensionDefinitionNotAllowed InParameter |
Dynamic extensions are not allowed to be defined on the body parameter. It should be in the schema. |
Le estensioni dinamiche sono definite in un parametro del corpo e devono essere rimosse. È consentito definirle solo nello 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" deve essere definito. Maggiori informazioni: Come utilizzare valori dinamici |
| 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" deve essere definito. Maggiori informazioni: Come utilizzare valori dinamici |
| 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" deve essere definito. Maggiori informazioni: Come utilizzare valori dinamici |
| 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" deve essere definito. Maggiori informazioni: Come utilizzare valori dinamici |
| 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. |
"x-ms-dynamic-properties" risulta mancante nel file swagger, che è obbligatorio poiché definisce "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}'. |
Il percorso del valore dell'elemento dell'estensione delle proprietà dinamiche non corrisponde al percorso previsto in base allo schema. |
| DynamicTreeExtensionMissing | The 'x-ms-dynamic-tree' extension must be defined to enable file picker support. |
La proprietà "x-ms-dynamic-tree" è mancante e deve essere definita per supportare la selezione dei file. |
| InvalidEnumValue | The type of the enum value is '{0}' but it should be '{1}' as specified in the schema. |
Il valore deve essere sostituito per essere del tipo specificato. |
| InvalidEnumValuesExtensionValue | The 'value' field must match one of the enums as defined in the 'enum' property of the schema. |
L'enum selezionato non è stato definito nell'elenco delle enumerazioni. Definisci il valore nella proprietà enum o utilizza un valore definito nella proprietà enum. |
| InvalidFormDataParameterName | The form data parameter name '{0}' is invalid. All characters must be part of the US-ASCII character set. |
Rinomina il nome del parametro dei dati del modulo affinché includa solo caratteri US-ASCII. |
| InvalidNextLinkNameValue | The nextLinkName value for operation '{0}' is invalid. Supported values are 'nextLink' or '@odata.nextLink'. |
Correggi il valore della proprietà "nextLinkName" in modo che sia "nextLink" o "@odata.nextLink". Eventuali altri valori non sono consentiti. |
| 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} è il percorso di una proprietà di risposta, {1} è l'ID operazione. Definisci un valore di tipo array nella risposta dell'operazione. |
| 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} è il percorso di una proprietà di risposta, {1} è l'ID operazione. Definisci una specifica proprietà nella risposta dell'operazione |
| MimeTypeNotCompatibleWithRequest ContentSchemaType |
The MIME type(s) are not compatible with the request content type '{0}' for operation '{1}'. |
Il tipo MIME che stai tentando di utilizzare non è compatibile con il contenuto della richiesta nell'operazione specificata. |
| NotificationExtensionNotSupportedIn WebhookOperation |
The 'x-ms-notification' extension must not be defined in a webhook operation. |
L'utilizzo di "x-ms-notification" non è consentito in un'operazione webhook. |
| NotificationExtensionSupportedFor TriggerOnly |
The 'x-ms-notification' is supported for trigger operations only. |
L'estensione "x-ms-notification" può essere utilizzata solo per le operazioni di trigger. |
| NotificationOperationMustBeWebhook | The 'operationId' property in 'x-ms-notification' extension must be for a webhook operation. |
Quando si utilizza "x-ms-notification", l'ID operazione deve fare riferimento a un'operazione webhook. |
| OperationFamilyHasDuplicateRevisions | The operation family '{0}' has operations with duplicate revision. |
Lo swagger definisce una famiglia di operazioni con lo stesso numero di versione/revisione. Ogni operazione in una famiglia di operazioni deve avere un numero di versione univoco. |
| OperationFamilyHasManyActive Operazioni |
The operation family '{0}' has more than two active operations. Extra operations must be deprecated. |
Le famiglie di operazioni sono limitate a due operazioni non deprecate. Tutte le altre devono essere contrassegnate come deprecate per ridurre la confusione per l'utente del connettore. |
| OperationFamilyHasManyActive ProductionOperations |
The operation family '{0}' has several active operations in Production status. Previous revisions should be deprecated. |
Una famiglia di operazioni include più operazioni in produzione. Per ridurre la confusione, limita il numero di operazioni in produzione in una famiglia e depreca il resto. |
| OperationFamilyHasManyEmptyRevisions | The operation family '{0}' has several operations with empty revision. Only one operation can have empty revision. |
Le famiglie di operazioni possono avere solo un'operazione senza revisione. Tutte le altre nella famiglia devono avere una revisione. |
| OperationHasManyResponsesWithSchema | The operation '{0}' has more than one response with specified schema, only one schema will be used in the designer. |
Le limitazioni nella finestra di progettazione impediscono più schemi di risposta. L'operazione ne specifica diversi, ma deve specificarne sola una. |
| OperationIdNotFound | The 'operationId' could not be found in this swagger document. |
Impossibile trovare la proprietà operationId nello swagger. |
| OperationIdNotUnique | The operationId '{0}' is used multiple times. Operation identifiers must be unique. |
La stessa proprietà operationId appare più di una volta. Rimuovi una delle istanze o correggi una delle istanze di modo che sia diversa. |
| OperationIdRequired | The operation 'operationId' property is required. |
La proprietà "operationId" risulta mancante; includi la proprietà "operationId" per l'operazione. |
| OperationIdSanitized | The 'operationId' property value is different from its sanitized value '{0}'. Please avoid the useage of non-alphanumeric characters to have matching values. |
L'ID operazione fornito non corrisponde alla versione pulita. Aggiorna l'ID operazione di modo che corrisponda. |
| OperationIdShouldEndWithRevision | The operation Id '{0}' should end with revision suffix '{1}'. |
Gli ID operazione con una revisione devono avere un nome con il suffisso di revisione. |
| OperationIdTooLong | The operationId length must be less than '{0}'. |
Riduci il valore della proprietà "operationId" di modo che la lunghezza del carattere sia inferiore a {0}. |
| OperationMissingPathParameter | The operation '{0}' does not define the '{1}' parameter which is required by the path. |
Lo swagger include un'operazione che non definisce un parametro che sembra essere richiesta dal relativo modello di percorso. |
| OperationMissingRequiredProperty | The target operation requires parameter '{0}'. |
L'operazione include il parametro "{0}" definito come obbligatorio ma questo non è definito nei parametri forniti. Aggiungi questo parametro per correggere il problema. |
| OperationMustHaveNotification ContentExtension |
The operation '{0}' is missing notification content extension as it has '{1}' properties marked as notification URL. |
Lo swagger contiene un'operazione che non include un'estensione di contenuto di notifica. (È necessario ulteriore contesto) |
| OperationMustHaveResponse | The operation is not valid, it must contain at least one response definition. |
Lo swagger include un'operazione che non ha almeno una definizione di risposta. |
| OperationParameterNameIsAmbiguous | The parameter name is ambiguous as it matches both a parameter name and a path to a body property. |
Il nome del parametro viene utilizzato come nome del parametro e come nome del percorso del corpo del parametro. Rinomina una delle istanze per correggere questo problema. |
| OperationParameterNameNotFound | The parameter could not be found in operation '{0}' in the swagger document. |
Impossibile trovare il nome del parametro dell'operazione nello 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. |
Il parametro è obbligatorio ma il valore per l'operazione indica che è facoltativo e causa questa mancata corrispondenza. |
| OperationParametersAreNotUnique | The parameters in the operation '{0}' are not unique. |
È possibile che un duplicato sia presente nei parametri dell'operazione. Lo swagger deve rimuovere i duplicati dei parametri delle operazioni. |
| OperationParametersContain DuplicateParameter |
The operation '{0}' contains duplicate parameters with name '{1}', location '{2}'. |
Un parametro operativo è elencato due volte. {0} è il nome dell'operazione, {1} è il nome del parametro duplicato, {2} è la posizione del parametro duplicato (proprietà "in" nello swagger). Rimuovi la nuova occorrenza della proprietà. |
| OperationParametersContain MultipleBodyParameters |
The operation '{0}' contains multiple parameters in the location 'body', at most one is allowed. |
I parametri dell'operazione contengono parametri del corpo duplicati. Rimuovi uno dei parametri del corpo. |
| OperationParameterStaticTypeMismatch | The parameter has type '{0}', but a static value is provided of type '{1}'. |
Il parametro include un tipo statico fornito quando non è previsto per questo parametro dell'operazione. |
| OperationParameterTypeMismatch | The parameter has type '{0}', but operation '{1}' is providing a parameter of type '{2}'. |
Il parametro e l'operazione hanno tipi diversi. Fai in modo che il tipo del parametro e l'operazione corrispondano. |
| OperationPathContainsUnsupportedCharacters | The operation path cannot contain wildcard character '*'. |
Una delle operazioni specifica un percorso URL che contiene caratteri non supportati (come il simbolo del carattere jolly). |
| 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. |
Il percorso dell'operazione non può contenere "?" e "#" a meno che non siano URL codificati (tradotti nei relativi equivalenti %xx). |
| OperationPathMustStartWithSlash | The path is not valid, it must start with a '/' character. |
Se utilizzi un percorso dell'operazione che stai tentando di ottenere, devi iniziare con il carattere "/". Includi il carattere "/" all'inizio del percorso per risolvere questo problema. |
| 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. |
Lo swagger contiene il percorso di un'operazione con un carattere "{" o "}" non chiuso. Questi caratteri sono usati per fare riferimento a una variabile nel percorso, quindi non possono esistere nel percorso quando non è chiuso. |
| OperationPathVariablesContainDefaults | The operation path template variables cannot set default values with character '='. |
Una delle operazioni specifica un valore predefinito per un parametro che contiene "=". Quel parametro è anche specificato come presente nel percorso dell'URL. Questa combinazione non è consentita. |
| OperationRevisionEmpty | The operation '{0}' does not specify a revision in api annotation. |
L'operazione è contrassegnata come parte di una famiglia, ma non ha una revisione. |
| 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. |
Ci sono troppi schemi nell'operazione. Rimuovine alcuni in modo che il totale sia di nuovo al di sotto del limite. |
| OperationShouldHaveSuccessfulResponse | The operation '{0}' should have at least one successful response definition. |
Lo swagger include un'operazione che non ha almeno una definizione di risposta riuscita. |
| OperationStatusAheadOfConnector | The operation '{0}' cannot be in a Production status ahead of the connector. |
Le operazioni non possono essere contrassegnate come "Produzione" quando l'intero connettore è ancora in "Anteprima". |
| OperationSummaryTooLong | The operation 'summary' should be fewer than {0} characters for improved readablity. |
Riduci la proprietà "summary" dell'operazione a meno di 120 caratteri. |
| 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} è l'id dell'operazione, {1} è il percorso dell'operazione, {2} è l'insieme dei percorsi dell'operazione parzialmente duplicati. Modifica il percorso dell'operazione per creare una maggiore differenza tra i percorsi dell'operazione che condividono la similarità. |
| PathParameterMustBeRequired | The parameter must be marked as required as it is used in the operation path. Include the 'required' property, with the value 'true'. |
La posizione del parametro è impostata su "Path", quindi è necessario che la proprietà "required" sia impostata su "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. |
Una delle operazioni include un parametro contrassegnato come presente nel percorso dell'operazione ma non esiste nel modello del percorso. |
| PathParametersContain DuplicateParameter |
The path '{0}' contains duplicate parameters with name '{1}', location '{2}'. |
{0} è il percorso dell'operazione. {1} è il nome del parametro duplicato. {2} è la posizione (la proprietà "in") del parametro duplicato. Rimuovi il parametro del percorso duplicato. |
| PathParametersContainMultiple BodyParameters |
The path '{0}' contains multiple parameters in the location 'body', at most one is allowed. |
In un corpo non possono esserci due parametri per un'operazione. Rimuovi uno dei parametri per correggere questo errore. |
| PathRedefined | The path '{0}' is defined multiple times with different capitalization. Paths must be unique when compared case-insensitively. |
Lo stesso percorso è definito più volte. Rimuovi o rinomina le istanze in modo che siano univoche. |
| RestrictedCharactersInSummary | Summary string contains any of the restricted characters [{0}] |
Il riepilogo di una delle operazioni contiene caratteri con restrizioni. Rimuovi i caratteri o riformula il riepilogo per correggere questo errore. |
| SelectedItemValuePathNotAllowedIn ThisPosition |
The 'selectedItemValuePath' property is not allowed in this position. It is allowed only in 'browse' operation of 'x-ms-dynamic-tree' extension. |
Il posizionamento di "selectedItemValuePath" non è consentito. Rimuovilo o posizionalo in una posizione valida. |
| StringBinaryNotSupportedFor FormUrlEncoded |
String/binary parameters are not supported for operation '{0}' with 'application/x-www-form-urlencoded' consumes type. |
L'operazione include il valore "application/x-www-form-urlencoded" definito nella proprietà "consumes". I parametri per questa operazione non possono essere di tipo "string" o "binary". |
| TotalOperationsCountExceedsMaxAllowed | The total number of operations in the swagger exceeds the maximum allowed value of '{0}'. |
Ci sono troppe operazioni nello swagger. |
| UnrecognizedTypeFormat | The type/format '{0}' is not recognized. |
Il tipo/formato "{0}" specificato è sconosciuto. Verifica se vi sono errori di battitura o documentazione per confermare i formati del tipo supportato. |
| WebhookOperationsMissingNotification UrlProperty |
The webhook operation '{0}' is missing notification URL property. |
Lo swagger contiene un'operazione webhook che non include una proprietà URL di notifica mancante. L'aggiunta di questa proprietà nell'operazione webhook corregge l'operazione. |
Matrici
| Errore | Problema | Soluzione |
|---|---|---|
| ArrayHasNoItems | The array should have items specified. |
L'array è vuoto, ma un array vuoto non è consentito. |
| RequiredPropertyArrayEmpty | The 'required' array requires at least one value. If no properties are required in the schema, remove the 'required' property. |
Lo swagger include un array vuoto per una proprietà denominata "required". Deve essere rimosso se non vi sono parametri obbligatori. |
| SchemesArrayEmpty | The 'schemes' array requires at least one value. |
Gli schemi non possono essere vuoti e devono avere almeno un valore. |
Non supportato
| Errore | Problema | Soluzione |
|---|---|---|
| CollectionFormatValueNotSupported | The 'collectionFormat' keyword value '{0}' is not supported. |
Sono supportati solo alcuni formati di raccolta. Lo swagger contiene un formato non supportato. |
| MimeTypeNotSupported | The MIME type '{0}' is not supported. The supported mime types are: '{1}'. |
Il tipo MIME che stai cercando di utilizzare nello swagger non è supportato. |
| PathItemRefNotSuppored | The '$ref' property in a path is not supported. |
Un percorso non può avere una proprietà "$ref" definita. Rimuovi questa proprietà. |
| SwaggerKeywordNotSupported | The '{0}' keyword is not supported. |
{0} è una parola chiave dello swagger come "uniqueItems" e non è consentita nel contesto in cui viene utilizzata. |
Parametri
| Errore | Problema | Soluzione |
|---|---|---|
| FileParameterMustBeInFormData | Parameters of type 'file' are not valid in locations other than 'formData'. |
Lo swagger include un parametro con un tipo "file" e può essere solo "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. |
Lo swagger sta definendo un parametro del corpo e formData e ciò non è consentito. Rimuovi uno di questi tipi di parametri. |
| ParameterReferenceNotFound | The parameter reference '{0}' could not be found in the swagger document. |
Lo swagger include un riferimento di parametro introvabile nel documento dello swagger. Rimuovi il riferimento a questo parametro. |
| ParameterReferenceNotValid | The parameter reference '{0}' is not valid. Parameter references must start with '#/parameters/' and be valid JSON Pointers. |
Lo swagger include un riferimento di parametro ("#/parameters/") non valido in base alla specifica RFC del puntatore JSON. |
| ParameterRefLoopNotAllowed | The parameter definition may not use a '$ref' to point to another definition. |
Lo swagger include una definizione di parametro che utilizza erroneamente "$ref" per puntare a un'altra definizione. |
| ParamtersWithSameNameMustHave SameTypeAndVisibility |
Parameters of the same name in fetch and subscribe operations must be of the same type and visibility. |
Se lo swagger include parametri con lo stesso nome nelle operazioni di recupero e sottoscrizione, devono avere lo stesso tipo e la stessa visibilità. |
| 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} è il nome del parametro non codificato. |
| QueryParameterEncodingNotSupported | Encoding for query parameter '{0}' is not supported. All query parameters are single encoded by default. |
{0} è il nome del parametro la cui codifica non è supportata. Correggi questa codifica. |
| ReservedParameterIsUsed | The parameter '{0}' is reserved and cannot be used in '{1}'. |
Viene utilizzato il parametro indicato in questo errore, ma non può essere utilizzato perché riservato per quella sezione o in generale. |
| ResponseRefLoopNotAllowed | The response definition may not use a '$ref' to point to another definition. |
Lo swagger include una definizione di risposta che utilizza erroneamente "$ref" per puntare a un'altra definizione. |
| 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. |
Il riferimento al parametro è contrassegnato come interno, ma l'operazione in cui viene utilizzato tale riferimento non è interna. Aggiorna il parametro o l'operazione per correggere l'errore. |
Proprietà
| Errore | Problema | Soluzione |
|---|---|---|
| AdditionalPropertyNotAllowed | The property '{0}' is not allowed and must be removed. |
Lo swagger include una proprietà aggiuntiva che deve essere rimossa. |
| AdditionalPropertyNotAllowedAdjacent ToRef |
When '$ref' is defined, no other properties may be specified. |
Quando si utilizza "$ref" nello swagger, nessun'altra proprietà deve essere inclusa in quell'oggetto JSON. |
| BasePathNotValid | The 'basePath' property, if present, must start with a '/' character. |
Se utilizzi un percorso di base, deve iniziare con "/". I percorsi di base non validi sono "abc/def/ghi" o "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. |
Uno dei parametri del corpo nello swagger utilizza una proprietà non valida che non può essere utilizzata in un parametro del corpo. |
| ConnectorMetadataPropertiesMissing | The connector metadata property '{0}' is required. |
Alcuni metadati sono obbligatori per il connettore. |
| ContactEmailNotValid | The contact 'email' property, if present, must be a valid email address. |
L'indirizzo e-mail fornito è in un formato errato o contiene caratteri non ASCII. |
| DefaultValueMustMatchType | The 'default' value is of type '{0}', but should match the given type '{1}'. |
Il valore per il valore predefinito non è dello stesso tipo del tipo specificato. Imposta il valore predefinito sul valore del tipo specificato per risolvere questo problema. |
| EnumMustContainAtLeastOneElement | The 'enum' array requires at least one value. |
Se il tipo di proprietà è un enum, deve specificare un array con almeno uno dei valori enum. |
| ExtensionNameNotValid | The property '{0}' is not valid. If this property is an extension, its name must begin with "x-". |
Le proprietà che sono estensioni devono iniziare con il prefisso "x-". |
| FilterFunctionsPropertyEmpty | The 'filterFunctions' property must have at least one element. |
La proprietà "filterFunctions" non può essere vuota se specificata. |
| FilterFunctionsPropertyHasDuplicates | The 'filterFunctions' property cannot contain duplicates. |
La proprietà "filterFunctions" non può contenere duplicati. |
| FilterFunctionsPropertyInInputSchema | The 'filterFunctions' property has to be in the response schema. |
La proprietà "filterFunctions" può essere solo nello schema di risposta. |
| FilterFunctionsPropertyInvalidValue | The 'filterFunctions' property supports only these values: {0}". |
La proprietà "filterFunctions" non può specificare un valore non supportato. |
| HostNameNotValid | The 'host' property, if present, must be a valid URI host without a scheme or path. |
Un URI host senza schema o percorso assomiglia a "www.microsoft.com". Un URI non valido per l'host è simile a "https://www.microsoft.com/" o "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. |
Una proprietà è contrassegnata come interna, ha un valore predefinito specificato e non è obbligatoria. Se vuoi assicurarti che sia inclusa nelle richieste, contrassegnala come obbligatoria, altrimenti, se previsto, può essere lasciata così com'è. |
| InvalidConnectorCategory | The connector category is invalid. Available categories are: [{0}]. |
Le categorie possono provenire solo dall'elenco dei valori di categoria consentiti. |
| InvalidStringBinaryProperty | A schema with type/format 'string/binary' can only be at the top level of a body or formData parameter. |
Il valore del "tipo" e del "formato" della proprietà di "stringa" e "binario" non è consentito in questa posizione dello schema. |
| JsonTypeIncorrect | The type of the property is incorrect. Expected type '{0}', but value is of type '{1}'. |
Una proprietà nello swagger include un tipo, ma il valore effettivo è un tipo diverso. Modifica il tipo di valore in modo che corrisponda al tipo previsto. |
| JsonValueNotInEnum | The property value must be one of the following: {0}. |
Il valore della proprietà dell'enum in non corrisponde alle opzioni attualmente disponibili. Imposta uno dei valori indicati nel messaggio di errore. |
| MimeTypeNotValid | The MIME type '{0}' is not valid. |
Il "tipo di contenuto" MIME fornito dall'utente che hai selezionato non è valido. I tipi MIME validi sono: "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 non ha specificato la proprietà "displayName". |
| MultipleOfMustBeGreaterThanZero | The 'multipleOf' value must be greater than zero. |
Il valore della proprietà "multipleOf" deve essere un valore maggiore di zero. |
| OneOfPropertiesRequired | At least one of the properties is required: [{0}]. |
{0} è un insieme di proprietà. Questo errore mostra tutte le proprietà che devono essere presenti nello swagger. |
| ProductionStatusOnBetaService | The connector cannot be in Production status on a beta service. |
Il connettore non può essere contrassegnato come "Produzione" quando il servizio di backend è in versione Beta. Deve essere impostato su "Anteprima". |
| PropertyMustBeRequired | The property is internal and has a default value, it must be required. Optional internal fields are ignored. |
La proprietà non è impostata sebbene sia obbligatoria. |
| RequiredPropertyDefinitionMissing | The required property '{0}' is not defined in the object schema. |
Una proprietà dello schema è elencata come "obbligatoria" e pertanto deve essere definita nelle "proprietà" |
| RequiredPropertyMissing | The '{0}' property is required. |
Una proprietà obbligatoria nello swagger risulta mancante. Includi questa proprietà per correggere questo errore. |
| RequiredPropertyNotOnObject | The property 'required' is applicable to schemas with 'object' type only and should be removed. |
La proprietà "obbligatoria" è supportata solo per il tipo "oggetto". Rimuovi la proprietà per tutti gli altri tipi. |
| RequiredReadOnlyPropertyNotAllowed AsInput |
An input property cannot be 'readonly' and required. |
Lo swagger contiene una proprietà che è contrassegnata come di sola lettura e obbligatoria. Una proprietà di sola lettura significa che l'utente non può modificare il valore. Una proprietà obbligatoria richiede un valore per la modifica. |
| SchemeNotValid | The 'schemes' property must only contain transfer protocols from the list: {0}. |
La proprietà dello schema deve essere "http" o "https". |
| SecuritySchemePropertyNotValid | The security definition property '{0}' is not valid for definitions of type '{1}'. |
Nel dizionario securityDefinitions sono stati inclusi un nome di proprietà e un valore non validi. Imposta un nome di proprietà valido per risolvere questo problema. |
| SecuritySchemePropertyRequired | The security definition property '{0}' is required for definitions of type '{1}'. |
Nel dizionario securityDefinitions non sono stati inclusi un nome di proprietà e un valore obbligatori. Aggiungi questa proprietà e questo valore per risolvere il problema. |
| SpecificationVersionIncorrect | The 'swagger' property must have the string value "2.0". |
È supportata solo la versione "2.0", quindi la proprietà della versione dello swagger deve essere "2.0". |
| TagRedefined | The 'tags' property defines tag '{0}' multiple times. |
I tag definiti nella proprietà 'tags' devono essere univoci. Rimuovi o sostituisci eventuali occorrenze aggiuntive. |
| TooManyConnectorCategories | The maximum allowed number of categories for the connector is '{0}'. |
Esiste un limite al numero di categorie che è possibile impostare per il connettore. |
| UrlNotValid | The 'url' property must be a valid absolute URL. |
Lo swagger include un URL non valido. Ciò può essere dovuto alla copia errata dell'URL. |
Response
| Errore | Problema | Soluzione |
|---|---|---|
| BodyParameterSchemaRequired | The 'body' parameter must define a 'schema' property. |
Nel parametro del corpo è necessario definire la proprietà dello schema. Definisci la proprietà dello schema per correggere questo problema. |
| 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. |
Ci sono troppi schemi nell'oggetto body. Rimuovine alcuni in modo che il totale sia di nuovo al di sotto del limite. |
| DefaultResponseHasSchema | The 'default' response should not have schema definition. Schemas should be defined on expected responses only. |
Lo swagger contiene una definizione dello schema per la risposta predefinita. La rimozione di questa definizione dello schema per la risposta predefinita risolve questo errore. |
| InvalidCustomEditorExtension DictionaryValue |
The 'x-ms-editor' extension can be specified as 'dictionary' only for schema with type object and additional properties allowed. |
Verifica se x-ms-editor è impostato solo sul dizionario quando lo schema è di tipo oggetto ed è impostato su proprietà aggiuntive consentite. |
| JsonPointerNotValid | The JSON Pointer path is not valid. |
Un riferimento (#ref) utilizzato nello swagger non è valido. |
| NonBodyParameterSchemaNotValid | The parameter cannot define a schema as it is not in the 'body'. |
Lo swagger include un parametro che usa "scheme", ma solo i parametri del corpo possono usare "scheme". |
| RequiredLoopInSchemaNotAllowed | Loops of required schema properties are not allowed. |
La specifica delle proprietà obbligatorie non può utilizzare cicli di riferimento. |
| ResponseExampleMustBeProduced ByOperation |
The response example '{0}' is not produced by the operation '{1}'. |
Lo swagger include un'operazione con un esempio di risposta, ma quella stessa operazione non produce una risposta con il tipo di MIME indicato. |
| ResponseHeadersAreNotUnique | The response headers are not unique. |
È presente un'intestazione di risposta duplicata. Le intestazioni di risposta devono essere univoche. |
| ResponseMustBeDefaultOrHttpStatusCode | The response is not valid, the response must be a valid HTTP status code, or the string 'default'. |
Lo swagger non include un codice di stato HTTP predefinito o un codice di stato HTTP valido. Aggiungi un codice di stato alla risposta. |
| ResponseReferenceNotFound | The response reference '{0}' could not be found in the swagger document. |
Lo swagger include un riferimento di risposta introvabile nel documento dello swagger. Rimuovi il riferimento a tale risposta. |
| ResponseReferenceNotValid | The response reference '{0}' is not valid. Response references must start with '#/responses/' and be valid JSON Pointers. |
Lo swagger include un riferimento di risposta ("#/responses/") non valido in base alla specifica RFC del puntatore JSON. |
| 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. |
Uno schema di risposta risulta mancante nell'operazione per il codice di risposta 200 o 201. Per i webhook, lo schema di risposta deve essere specificato come parte dell'estensione del contenuto della notifica. |
| SchemaReferenceNotFound | The schema reference '{0}' could not be found in the swagger document. |
Lo swagger include un riferimento di schema introvabile nel documento dello swagger. |
| SchemaReferenceNotValid | The schema reference '{0}' is not valid. Schema references must start with '#/definitions/' and be valid JSON Pointers. |
Lo swagger include un riferimento di schema ("#/definitions/") non valido in base alla specifica RFC del puntatore JSON. |
| SchemaRefLoopNotAllowed | The schema definition may not use a '$ref' to point to another definition. |
Nello schema è presente un ciclo di riferimento (A punta a B, che punta ad A). |
| SchemaTooDeep | The schema exceeds the maximum allowed depth. Schemas must not exceed a depth of '{0}', including referenced ('$ref') schemas. |
Gli schemi sono limitati a una profondità JSON specifica. Utilizza uno schema meno profondo. |
| SchemaTypeFileNotValid | The schema type 'file' is not valid. Only parameters in 'formData' and the root response schema may be of type 'file'. |
L'utilizzo del tipo di schema "file" è supportato solo nei dati del modulo e deve trovarsi alla radice dello schema di risposta per la definizione della risposta. |
| SchemeNotSupported | The WebSocket transfer protocol schemes are not supported. |
Questo schema non è supportato. Gli schemi supportati sono Https e Http. |
| TotalSchemaCountExceedsMaxAllowed | The maximum allowed number of schemas in the swagger is '{0}'. Please remove any unnecessary property or item definitions. |
Sono presenti troppi schemi nello swagger. |
Sicurezza
| Errore | Problema | Soluzione |
|---|---|---|
| OAuthSecurityRequirementValueMustBe ScopeName |
The OAuth security requirement '{0}' refers to scope name '{1}', but this is not defined in the 'securityDefinitions' object. |
I nomi dei requisiti di sicurezza devono essere un nome di ambito definito nell'oggetto delle definizioni di sicurezza. |
| SecurityRequirementMustBeDefined | The security requirement '{0}' is not defined in the 'securityDefinitions' object. |
Viene utilizzato un requisito di sicurezza che non è definito nel dizionario delle definizioni di sicurezza. |
| SecurityRequirementMustHaveEmptyValue | The security requirement '{0}' cannot specify any scopes, an empty array should be provided. |
In base alla configurazione corrente, i requisiti di sicurezza con nome "{0}" devono essere un array vuoto. |
| SecurityRequirementMustHaveValue | The security requirement '{0}' must have have a value. Provide an empty array if no OAuth scopes are required. |
Il requisito di sicurezza risulta mancante o nullo. Se non sono richiesti ambiti OAuth, specificare un array vuoto. |
Webhook
| Errore | Problema | Soluzione |
|---|---|---|
| NotificationUrlNotAllowedInThisPosition | The notification URL property is not allowed in this position. It is allowed only in input body. |
La proprietà "x-ms-notification-url" deve essere definita solo in un input. |
| NotificationUrlNotInternal | The notification URL property itself or at least one of its parents must be internal. |
Lo swagger non sta attualmente impostando la proprietà dell'URL di notifica su Interna come dovrebbe. |
| NotificationUrlNotRequired | The notification URL property must be required all the way through the schema chain. |
Lo swagger attualmente non richiede la proprietà dell'URL di notifica che dovrebbe essere richiesta. |
| NotificationUrlNotString | The notification URL property must be of type string. |
La proprietà dell'URL di notifica ha un valore che non è di tipo string. |
Metadati
| Errore | Problema | Soluzione |
|---|---|---|
| AllowEmptyValueOnlyValidForQuery FormData |
The parameter cannot use the 'allowEmptyValue' keyword as it is not in the 'query' or 'formData' location. |
La proprietà "allowEmptyValue" può essere impostata solo su "true" in un parametro che ha una proprietà "location" impostata su "query" o "formData". Il valore della proprietà "location" non è impostata su uno di quei valori. |
| DiscriminatorMustBeARequiredStringProperty | The 'discriminator' value must be the name of a required string property. |
Il valore "discriminator" deve essere il nome di una proprietà string obbligatoria nello swagger. |
| ExclusiveMaximumRequiresMaximum | The 'exclusiveMaximum' keyword can only be specified if the 'maximum' keyword is also specified. |
Non puoi specificare "exclusiveMaximum" senza specificare anche "maximum". |
| ExclusiveMinimumRequiresMinimum | The 'exclusiveMinimum' keyword can only be specified if the 'minimum' keyword is also specified. |
Non puoi specificare "exclusiveMinimum" senza specificare anche "minimum". |
| FieldLengthExceeded | The '{0}' value goes over the character limit '{1}' |
Un campo con il nome specificato in {0} supera il limite di caratteri specificato in {1}. |
| FieldLengthNotInRange | The '{0}' value must be between '{1}' and '{2}' characters. |
{0} è il nome del campo, {1} è la lunghezza minima, {2} è il limite. Diminuisci la lunghezza dei caratteri in questo campo. |
| MaxItemsMustBeGreaterThanOrEqual ToZero |
The 'maxItems' value must be greater than or equal to zero. |
Il valore "maxItems" attualmente è inferiore a zero; modifica questo valore affinché sia maggiore o uguale a zero. |
| MaxLengthMustBeGreaterThanOrEqual ToZero |
The 'maxLength' value must be greater than or equal to zero. |
Il valore della proprietà “maxLength” deve essere un numero non negativo. |
| MaxPropertiesMustBeGreaterThanOrEqual ToZero |
The 'maxProperties' value must be greater than or equal to zero. |
Il valore "maxProperties" attualmente è inferiore a zero; modifica questo valore affinché sia maggiore o uguale a zero. |
| MinimumShouldBeLessThanOrEqual ToMaximum |
The 'minimum' value should be less than or equal to the 'maximum' value. |
Quando si specifica un valore minimo, deve essere minore o uguale al valore massimo. |
| MinItemsMustBeGreaterThanOrEqual ToZero |
The 'minItems' value must be greater than or equal to zero. |
Il valore "minItems" attualmente è inferiore a zero; modifica questo valore affinché sia maggiore o uguale a zero. |
| MinItemsShouldBeLessThanOrEqual ToMaxItems |
The 'minItems' value should be less than or equal to the 'maxItems' value. |
Quando si specifica il numero minimo di elementi, deve essere minore o uguale al numero massimo di elementi. |
| MinLengthMustBeGreaterThanOrEqual ToZero |
The 'minLength' value must be greater than or equal to zero. |
Il valore della proprietà “minLength” deve essere un numero non negativo. |
| MinLengthShouldBeLessThanOrEqual ToMaxLength |
The 'minLength' value should be less than or equal to the 'maxLength' value. |
Quando si specifica una lunghezza minima, deve essere minore o uguale alla lunghezza massima. |
| MinPropertiesMustBeGreaterThanOrEqual ToZero |
The 'minProperties' value must be greater than or equal to zero. |
Il valore "minProperties" è attualmente inferiore a zero; modifica questo valore affinché sia maggiore o uguale a zero. |
| PatternShouldBeValidRegularExpression | The 'pattern' value should be a valid regular expression. |
Il valore "pattern" non è un'espressione regolare valida; la correzione dell'espressione regolare elimina questo errore. |
| RequiredValueEmpty | The '{0}' property must have not empty value. |
Lo swagger contiene un valore vuoto per una proprietà obbligatoria. L'impostazione del valore di questa proprietà obbligatoria risolve questo problema. |
| ValueContainsRestrictedWords | The value '{0}' contains at least one of the restricted words: '{1}'. |
Uno dei campi nello swagger usa una parola ristretta. |
| ValueMustBeInEnglish | The '{0}' value must be written in English. |
Sostituisci il valore con uno contenente solo caratteri alfanumerici. |
| ValueMustEndWithAlphanumeric | The '{0}' value must end with alphanumeric character. |
Sostituisci l'ultimo carattere con un carattere alfanumerico |