Problemi noti di Apigee

Questa pagina si applica ad Apigee e Apigee hybrid.

Visualizza la documentazione di Apigee Edge.

Seleziona una o più delle seguenti opzioni per filtrare questa pagina:

Seleziona il prodotto API Hub Monitoraggio/analisi delle API Apigee Apigee in VS Code Archiviare i deployment Connettori Documentazione ibrido Integrazione Portale integrato Monetizzazione UI Seleziona stato RISOLTO APERTO Apigee 1-10 Apigee 1-9 ibrido 1.16 ibrido 1.15 ibrido 1.14 ibrido 1.13 ibrido 1.12 ibrido 1.11 ibrido 1.10 ibrido 1.9 ibrido 1.8 ibrido 1.7 ibrido 1.6 ibrido 1.5 ibrido 1.4 ibrido 1.3

Questa sezione elenca i problemi noti per i componenti Apigee. Per un elenco di bug, nuove funzionalità e altre informazioni sulla release, consulta le note di rilascio.

ID problema	Paesi interessati	Stato	Descrizione
N/D	ibrido 1.16.0	APRI	Deployment del proxy non completato a causa di autorizzazioni RBAC mancanti in Hybrid v1.16.0. Esiste un problema noto nella versione 1.16.0 in cui i cluster ibridi potrebbero non segnalare lo stato di deployment dei proxy. Ciò è dovuto a un'autorizzazione mancante nel ruolo apigee-manager-role. Soluzione alternativa:aggiungi l'autorizzazione al modello di grafico Helm apigee-operator: Modifica il apigee-operator file modello del grafico Helm apigee-operator/templates/apigee-operators.yaml. Aggiungi il verbo - watch alla risorsa deployments, dopo il verbo - update alla riga 584. Aggiorna la release Helm di apigee-operator.
418274570	ibrido 1.16.0	RISOLTO	La pagina delle note di rilascio ibride non è stata aggiornata con le informazioni relative alla correzione rapida 1.16.0.1. La pagina delle note di rilascio di hybrid non mostra le informazioni sull'aggiornamento 1.16.0-hotfix.1. Per i dettagli dell'aggiornamento, consulta le note di rilascio di Apigee hybrid v1.16.0-hotfix.1.
484366184	ibrido 1.14.x, ibrido 1.15.x	CORRETTO in hybrid 1.16.0	Le versioni 1.14 e 1.15 di Apigee Hybrid riscontrano un ciclo di arresti anomali in apigee-ingressgateway-manager quando viene utilizzata l'API Gateway di Kubernetes v1.4.0 o versioni successive. Apigee Hybrid 1.16 non è interessato da questo problema. Soluzione alternativa: se devi utilizzare l'API Gateway di Kubernetes con Apigee Hybrid versioni 1.14 o 1.15, installa la versione v1.3.x dell'API Gateway. Ad esempio: kubectl apply -f https://github.com/kubernetes-sigs/gateway-api/releases/download/v1.3.0/standard-install.yaml Vedi anche: API Gateway di Kubernetes v1.3 API Gateway v1.3.0: miglioramenti nel mirroring delle richieste, in CORS, nell'unione dei gateway e nei budget per i tentativi
480997525	Apigee 1-17-0-apigee-1	CORRETTO in Apigee 1-17-0-apigee-2	Le chiamate proxy non riescono a causa dell'errore The URI contain illegal characters dopo l'upgrade di Netty. Nella versione 1-17-0-apigee-1 di Apigee, un upgrade di Netty alla versione 4.1.129.Final ha introdotto una regressione. Ciò può causare errori nelle chiamate proxy API con un codice di stato 400 e il messaggio di errore The URI contain illegal characters. Questo problema è monitorato esternamente in netty/netty#16020.
465834046	hybrid 1.14.3, hybrid 1.15.1 e hybrid 1.16.0 e versioni successive per gli upgrade	CORRETTO in hybrid 1.14.3, hybrid 1.15.1 e hybrid 1.16.0 per le nuove installazioni	Le versioni 1.18 e successive di cert-manager hanno modificato il valore predefinito per la norma di rotazione della chiave privata da Never a Always. Se la chiave privata per apigee-ca viene ruotata, il traffico ne risentirà Nota:questo vale solo per i cluster ibridi Apigee di cui è stato eseguito l'upgrade. I certificati nelle nuove installazioni delle versioni ibride 1.14.3+, 1.15.1+ e 1.16.0 hanno già la policy di rotazione impostata su Never. Le versioni più recenti di cert-manager (v1.18+) ora ruotano automaticamente le chiavi private. Quando questa chiave viene ruotata per il certificato apigee-ca, si verifica un'interruzione. Soluzione alternativa:per evitare questo problema, puoi scegliere una delle seguenti opzioni: Non eseguire l'upgrade di cert-manager a una versione superiore alla 1.17.x. Modifica il certificato apigee-ca nello spazio dei nomi cert-manager e imposta spec.privateKey.rotationPolicy su Never. Utilizza la seguente procedura per modificare il certificato apigee-ca e aggiornare cert-manager: Avviso: esegui questi passaggi prima di aggiornare cert-manager. In caso contrario, potresti attivare una rotazione del certificato. Controlla i contenuti del certificato apigee-ca per vedere se rotationPolicy è impostato: Suggerimento: se utilizzi uno spazio dei nomi cert-manager personalizzato, sostituisci cert-manager con lo spazio dei nomi corretto nei seguenti comandi. kubectl get certificate apigee-ca -n cert-manager -o yaml Cerca i valori in spec.privateKey nell'output: ... spec: commonName: apigee-hybrid duration: 87600h isCA: true issuerRef: group: cert-manager.io kind: ClusterIssuer name: apigee-root-certificate-issuer privateKey: algorithm: ECDSA # Note: rotationPolicy would appear here if it is set. size: 256 secretName: apigee-ca ... Se rotationPolicy non è impostato o se è impostato su Always, modifica il certificato apigee-ca per impostare il valore di rotationPolicy su Never: Esegui prima un dry run: kubectl patch Certificate \ --dry-run=server \ -n cert-manager \ --type=json \ -p='[{"op": "replace", "path": "/spec/privateKey/rotationPolicy", "value": "Never"}]' \ -o=yaml \ apigee-ca Applica la patch al certificato: kubectl patch Certificate \ -n cert-manager \ --type=json \ -p='[{"op": "replace", "path": "/spec/privateKey/rotationPolicy", "value": "Never"}]' \ -o=yaml \ apigee-ca Verifica che il valore di rotationPolicy sia ora impostato su Never: kubectl get certificate apigee-ca -n cert-manager -o yaml L'output dovrebbe essere simile al seguente: ... spec: commonName: apigee-hybrid duration: 87600h isCA: true issuerRef: group: cert-manager.io kind: ClusterIssuer name: apigee-root-certificate-issuer privateKey: algorithm: ECDSA rotationPolicy: Never size: 256 secretName: apigee-ca ... Esegui l'upgrade di cert-manager. Il seguente comando scaricherà e installerà cert-manager v0.14.2: kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v0.14.2/cert-manager.yaml Vedi: Piattaforme e versioni supportate: cert-manager Upgrade di Apigee hybrid alla versione 1.16: esegui l'upgrade di cert-manager cert-manager versione 1.18: il valore predefinito di Certificate.Spec.PrivateKey.rotationPolicy è ora Always
458417250	Apigee 1-16-0-apigee-4	FIXED in Apigee 1-16-0-apigee-6	Il processore di messaggi restituisce l'errore 500 con "Duplicate Header "authorization"". Quando in una richiesta sono presenti più intestazioni di autorizzazione, il gateway in entrata Apigee non le concatena in un'unica intestazione. Di conseguenza, il processore di messaggi restituisce un errore 500 con un messaggio "Duplicate Header "authorization"". Soluzione alternativa:se nella richiesta sono presenti più intestazioni di autorizzazione, concatenale in un'unica intestazione. Ad esempio: curl -s https://my-hostname.net/mocktarget/echo \ -H 'authorization: a, b'
462685598	UI	APRI	Al momento, la UI di Apigee non offre l'opzione per il provisioning delle organizzazioni Apigee con un Google-owned and Google-managed encryption key. L'interfaccia utente Apigee non offre la possibilità di selezionare un Google-owned and Google-managed encryption key durante il provisioning delle organizzazioni di abbonamento. Soluzione alternativa: utilizza le API Apigee per creare organizzazioni basate su abbonamento con un Google-owned and Google-managed encryption key. Come indicato nella documentazione dell'API Apigee, durante la creazione dell'organizzazione Apigee, puoi creare l'organizzazione utilizzando un Google-owned and Google-managed encryption key senza fornire valori per i campi runtimeDatabaseEncryptionKeyName, apiConsumerDataEncryptionKeyName e controlPlaneEncryptionKeyName.
460431753	Apigee, Apigee hybrid	APRI	Le policy di Apigee Model Armor non sono supportate con i WebSocket. Le policy Apigee Model Armor, tra cui SanitizeUserPrompt e SanitizeModelResponse, al momento non funzionano come previsto se utilizzate nei proxy API che gestiscono le connessioni WebSocket. Per maggiori informazioni sulla configurazione di WebSocket, consulta WebSockets con Apigee.
433759657	Apigee	CORRETTO nella versione 1-16-0-apigee-3 o successive	Dopo l'upgrade alla versione 1-16-0-apigee-3, alcune organizzazioni Apigee potrebbero riscontrare errori HTTP 500 derivanti da un java.lang.NoClassDefFoundError all'interno di un criterio Java Callout. L'errore è simile al seguente: {"fault":{"faultstring":"Failed to execute JavaCallout. org/apache/commons/lang/StringUtils","detail":{"errorcode":"steps.javacallout.ExecutionError"}}} Questo errore si verifica quando un criterio Java Callout dipende in modo errato da librerie destinate all'uso interno di Apigee anziché fornire le proprie dipendenze. Azione richiesta:per evitare questo problema, gli sviluppatori devono assicurarsi che tutti i callout Java siano autonomi e utilizzino le proprie librerie dedicate, evitando qualsiasi dipendenza dal classpath interno di Apigee. Nel proxy API che utilizza la libreria JAR Apache Commons, importa il file JAR Apache Commons da includere come risorsa per il proxy. Per saperne di più, consulta le linee guida per le risorse Java.
451841788	ibrido 1.14.3 e ibrido 1.15.1	RISOLTO	Apigee hybrid richiede la proprietà mintTaskScheduler.serviceAccountPath anche quando la monetizzazione non è attivata. L'upgrade del grafico apigee-org può non riuscire se la proprietà mintTaskScheduler.serviceAccountPath non è impostata, anche se la monetizzazione non è attivata: Error: UPGRADE FAILED: execution error at (apigee-org/templates/mint-task-scheduler-gsa-secret.yaml:12:63): mintTaskScheduler.serviceAccountPath is required! Soluzione: rimuovi i file apigee-org/templates/mint-task-scheduler-gsa-secret.yaml e apitee-org/templates/mint-task-scheduler-sa.yaml. Se vuoi, puoi spostare i file in una posizione separata al di fuori della directory del grafico Helm. In alternativa, puoi scaricarli di nuovo se vuoi abilitare la monetizzazione in futuro, seguendo le istruzioni riportate nel passaggio 2: scarica i grafici Helm di Apigee. Ad esempio, dalla directory helm-charts/: ls apigee-org/templates/ Output: apigee-org-guardrails.yaml mart-sa.yaml apigee-proxy-chaining-certificate.yaml mint-task-scheduler-gsa-secret.yaml apigee-proxy-chaining-route.yaml mint-task-scheduler-sa.yaml ax-hash-salt-secret.yaml NOTES.txt connect-agent-gsa-secret.yaml organization.yaml connect-agent-sa.yaml udca-gsa-secret.yaml data-encryption-secret.yaml udca-sa.yaml encryption-keys-secret.yaml watcher-gsa-secret.yaml _helpers.tpl watcher-sa.yaml mart-gsa-secret.yaml (Facoltativo:) cp apigee-org/templates/mint-task-scheduler-gsa-secret.yaml /tmp/ cp apigee-org/templates/mint-task-scheduler-sa.yaml /tmp/ rm apigee-org/templates/mint-task-scheduler-gsa-secret.yaml rm apigee-org/templates/mint-task-scheduler-sa.yaml ls apigee-org/templates/ Output: apigee-org-guardrails.yaml mart-gsa-secret.yaml apigee-proxy-chaining-certificate.yaml mart-sa.yaml apigee-proxy-chaining-route.yaml NOTES.txt ax-hash-salt-secret.yaml organization.yaml connect-agent-gsa-secret.yaml udca-gsa-secret.yaml connect-agent-sa.yaml udca-sa.yaml data-encryption-secret.yaml watcher-gsa-secret.yaml encryption-keys-secret.yaml watcher-sa.yaml _helpers.tpl
451375397	ibrido 1.14.3	CORRETTO in hybrid 1.15.1	Lo script apigee-pull-push.sh può restituire un messaggio di errore No such image, ad esempio: Error response from daemon: No such image: gcr.io/apigee-release/hybrid/apigee-stackdriver-logging-agent:latest Soluzione alternativa: modifica lo script HELM_CHARTS_DIR/apigee-operator/etc/tools/apigee-pull-push.sh per cambiare la riga 114 della funzione docker_tag() da: docker tag "${source}/$i" "${dest}/$i:${TAG}" A: docker tag "${source}/$i:${TAG}" "${dest}/$i:${TAG}"
405936071	ibrido 1.15.0	CORRETTO in hybrid 1.15.1	Quando metrics.serviceAccountRef o metrics.serviceAccountSecretProviderClass viene specificato nel file overrides.yaml, il ruolo di telemetria avrà come target ilaccount di serviziot errato. Soluzione: applica la patch _helper.tpl nel grafico apigee-operator/. Modifica apigee-operator/templates/_helpers.tpl e rimuovi le seguenti righe in grassetto: {{- define "metricsSA" -}} {{- $metricsName := "apigee-metrics" }} {{- $telemetryName := "apigee-telemetry" -}} {{- $generatedName := include "orgScopeEncodedName" (dict "name" .Values.org) -}} {{- if .Values.gcp.workloadIdentity.enabled -}} {{- printf "%s-sa" $metricsName -}} {{- else if .Values.serviceAccountSecretProviderClass -}} <-- DELETE {{- .Values.serviceAccountSecretProviderClass -}} <-- DELETE {{- else if .Values.metrics.serviceAccountRef -}} <-- DELETE {{- .Values.metrics.serviceAccountRef -}} <-- DELETE {{- else if .Values.multiOrgCluster -}} {{- printf "%s-%s" $metricsName $generatedName -}} {{- else -}} {{- printf "%s-%s" $metricsName $telemetryName -}} {{- end -}} {{- end -}} La sezione risultante dovrebbe avere l'aspetto seguente: {{- define "metricsSA" -}} {{- $metricsName := "apigee-metrics" }} {{- $telemetryName := "apigee-telemetry" -}} {{- $generatedName := include "orgScopeEncodedName" (dict "name" .Values.org) -}} {{- if .Values.gcp.workloadIdentity.enabled -}} {{- printf "%s-sa" $metricsName -}} {{- else if .Values.multiOrgCluster -}} {{- printf "%s-%s" $metricsName $generatedName -}} {{- else -}} {{- printf "%s-%s" $metricsName $telemetryName -}} {{- end -}} {{- end -}} Applica di nuovo il grafico apigee-operator. helm upgrade operator apigee-operator/ \ --namespace APIGEE_NAMESPACE \ --atomic \ -f overrides.yaml
419856132	ibrido 1.14.2 e versioni successive	CORRETTO in hybrid 1.14.3 e hybrid 1.15.0	Se gateway.networking.k8s.io/v1 è installato nel tuo cluster,l'upgrade diapigee-ingressgateway-manager potrebbe non riuscire. Nota:gateway.networking.k8s.io/v1 viene generalmente installato nei cluster in esecuzione su Google Distributed Cloud (solo software) su bare metal v1.32 o versioni successive. Per una soluzione alternativa, segui i passaggi descritti in Problema noto 416634326.
378686709	Apigee Apigee hybrid	CORRETTO in Apigee (è necessaria una chiamata di assistenza) CORRETTO in hybrid 1.14.3 e hybrid 1.15.1 (procedura richiesta)	L'utilizzo di caratteri jolly (*) nei percorsi di base del proxy Apigee potrebbe entrare in conflitto con altri percorsi di base espliciti, causando un errore 404. Ad esempio, l'utilizzo dei seguenti percorsi di base per due proxy di cui è stato eseguito il deployment nello stesso ambiente potrebbe generare un errore 404 durante la chiamata a Proxy-2: Proxy-1: /a/v1/b Proxy-2: /a/*/c In questo caso, le chiamate al percorso di base esplicito verranno risolte correttamente, ma le chiamate a Proxy-2 potrebbero restituire 404 se il percorso con caratteri jolly viene valutato come /a/v1/c. Corretto:questo problema è stato risolto in Apigee e in hybrid 1.14.3 e versioni successive. Tuttavia, la correzione non è abilitata per impostazione predefinita. Se vuoi attivare l'utilizzo di caratteri jolly nei percorsi di base: I clienti con organizzazioni Apigee devono contattare l'assistenza Apigee per attivare la correzione, se necessario. I clienti con organizzazioni ibride Apigee devono utilizzare la seguente procedura per abilitare la correzione, se necessario. Procedura:per attivare l'utilizzo di caratteri jolly (*) nei percorsi di base dei proxy Apigee in Apigee hybrid: Suggerimento:applica prima questa modifica a un ambiente non di produzione per testarla prima di applicarla all'ambiente di produzione. Aggiungi la seguente strofa al file overrides.yaml prima di eseguire l'upgrade a ibrido 1.14.3 o versioni successive: runtime: cwcAppend: conf_message-processor-communication_classificationV2.enabled: "true" Applica le modifiche al grafico apigee-env. Ripeti la modifica per ogni ambiente dell'installazione. helm upgrade ENV_RELEASE_NAME apigee-env/ \ --install \ --namespace APIGEE_NAMESPACE \ --set env=ENV_NAME \ -f OVERRIDES_FILE ENV_RELEASE_NAME è un nome utilizzato per tenere traccia dell'installazione e degli upgrade del grafico apigee-env. Questo nome deve essere univoco rispetto agli altri nomi delle release Helm nell'installazione. Di solito è uguale a ENV_NAME. Tuttavia, se il tuo ambiente ha lo stesso nome del tuo gruppo di ambienti, devi utilizzare nomi di release diversi per l'ambiente e il gruppo di ambienti, ad esempio dev-env-release e dev-envgroup-release. Per saperne di più sulle release in Helm, consulta la sezione Tre concetti importanti nella documentazione di Helm. ENV_NAME è il nome dell'ambiente che stai eseguendo l'upgrade. OVERRIDES_FILE è il file di override. Esegui l'upgrade a hybrid 1.14.3 o versioni successive.
382565315	ibrido 1.13.0, ibrido 1.13.1, ibrido 1.13.2, ibrido 1.14.0	CORRETTO nelle versioni ibride 1.13.3 e 1.14.1	L'utilizzo di LogTimer in SecurityPolicy può causare una perdita di memoria. In alcune circostanze, i thread del logger di Apigee Hybrid potrebbero consumare tutta la memoria disponibile. Ad esempio, voci di log frequenti che documentano errori di autorizzazione associati a Javacallout potrebbero causare un errore di memoria insufficiente. Nota:Apigee consiglia di eseguire l'upgrade all'ultima release della patch di hybrid v1.13 o v1.14, ad esempio la versione 1.13.3 o la versione 1.14.2.
421190799	Apigee	CORRETTO in Apigee 1-15-0-apigee-7	Il processore di estensioni Apigee non supporta l'elaborazione di più di 100 KB di dati nell'ambito degli eventi del corpo della richiesta e della risposta.
432315283	Apigee	APRI	Quando aggiorni un keystore o un truststore senza crearne uno nuovo, gli aggiornamenti del runtime potrebbero non riuscire e causare il seguente errore intermittente: {"fault":{"faultstring":"SSL Handshake failed sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target","detail":{"errorcode":"messaging.adaptors.http.flow.SslHandshakeFailed"}}} L'errore è intermittente perché l'aggiornamento del keystore o del truststore potrebbe non riuscire su un pod di runtime, ma riuscire su altri pod. Per evitare questo problema, aggiorna il keystore o il truststore creando un nuovo keystore o truststore. Riassegna il riferimento al nuovo keystore o truststore, come descritto in Quando un certificato scade.
412740465	ibrido 1.14.0 e versioni successive	CORRETTO nelle versioni ibride 1.14.3 e 1.15.1	A partire dalla versione 1.14.0 di Apigee Hybrid, è stata rimossa l'aggiunta automatica delle intestazioni di traccia Zipkin (x-b3-*).
N/D	Apigee hybrid	APRI	La configurazione dell'inoltro del proxy non API utilizzando httpProxy senza impostare anche envs.httpProxy non applicherà la configurazione del proxy alle chiamate esterne di Apigee Runtime a servizi come Pub/Sub o altre API Google Cloud. Se specifichi solo httpProxy, devi anche assicurarti che *.googleapis.com sia incluso nella lista consentita per i pod Apigee Runtime per abilitare la connettività a questi servizi. Consulta Configurare il proxy di inoltro per i proxy API.
416634326	ibrido 1.14.2 e versioni successive	CORRETTO nelle versioni ibride 1.14.3 e 1.15.1	La presenza di definizioni di risorse personalizzate (CRD) istio.io in un cluster ibrido Apigee può causare errori nei pod apigee-ingressgateway-manager. Durante l'upgrade di Apigee Hybrid dalle versioni precedenti alla 1.14.2 o successive, la presenza di CRD istio.io esistenti potrebbe causare probe di idoneità non riusciti nei container discovery dei pod apigee-ingressgateway-manager. Soluzione alternativa: i CRD istio.io non sono richiesti da Apigee Hybrid v1.14.2 o versioni successive. Esistono due modi per risolvere il problema: Elimina le CRD istio.io se non utilizzi Istio per scopi diversi da Apigee nel tuo cluster. Aggiorna apigee-ingressgateway-manager clusterrole per aggiungere le autorizzazioni per istio.io. Dopo ogni opzione precedente, dovrai riavviare i pod apigee-ingressgateway-manager. Elimina CRD Elenca le CRD istio.io nel cluster in un file CSV: kubectl get crd -o custom-columns=NAME:metadata.name | grep istio.io > istio-crd.csv (Facoltativo) Salva i CRD localmente nel caso in cui tu debba ricrearli: kubectl get crd $(cat istio-crd.csv) -o yaml > istio-crd.yaml Elimina le CRD istio.io: Prova: kubectl delete crd $(cat istio-crd.csv) --dry-run=client Suggerimento: puoi utilizzare --dry-run=client o --dry-run=server. Per ulteriori informazioni, consulta le opzioni di kubectl delete. Esegui: kubectl delete crd $(cat istio-crd.csv) Aggiorna clusterrole Recupera il clusterrole apigee-ingressgateway-manager attuale: kubectl get clusterrole apigee-ingressgateway-manager-apigee -o yaml > apigee-ingressgateway-manager-apigee-clusterrole.yaml Copia il clusterrole in una nuova posizione: cp apigee-ingressgateway-manager-apigee-clusterrole.yaml apigee-ingressgateway-manager-apigee-clusterrole-added-istio-permissions.yaml Aggiungi le seguenti autorizzazioni aggiuntive alla fine del file: - apiGroups: - gateway.networking.k8s.io resources: - gatewayclasses - gateways - grpcroutes - httproutes - referencegrants verbs: - get - list - watch - apiGroups: - networking.istio.io resources: - sidecars - destinationrules - gateways - virtualservices - envoyfilters - workloadentries - serviceentries - workloadgroups - proxyconfigs verbs: - get - list - watch - apiGroups: - security.istio.io resources: - peerauthentications - authorizationpolicies - requestauthentications verbs: - get - list - watch - apiGroups: - telemetry.istio.io resources: - telemetries verbs: - get - list - watch - apiGroups: - extensions.istio.io resources: - wasmplugins verbs: - get - list - watch Applica il ruolo: kubectl -n APIGEE_NAMESPACE apply -f apigee-ingressgateway-manager-apigee-clusterrole-added-istio-permissions.yaml Dopo aver completato le opzioni precedenti, dovrai riavviare i pod apigee-ingressgateway-manager. Elenca i pod ingress-manager da reinstallare o ricreare: kubectl get deployments -n APIGEE_NAMESPACE Output di esempio: NAME READY UP-TO-DATE AVAILABLE AGE apigee-controller-manager 1/1 1 1 32d apigee-ingressgateway-manager 2/2 2 2 32d Riavvia i pod ingress-manager: kubectl rollout restart deployment -n APIGEE_NAMESPACE apigee-ingressgateway-manager Dopo qualche minuto, monitora i pod apigee-ingressgateway-manager: watch -n 10 kubectl -n APIGEE_NAMESPACE get pods -l app=apigee-ingressgateway-manager Output di esempio: NAME READY STATUS RESTARTS AGE apigee-ingressgateway-manager-12345abcde-678wx 3/3 Running 0 10m apigee-ingressgateway-manager-12345abcde-901yz 3/3 Running 0 10m
414499328	ibrido 1.14.1	CORRETTO in hybrid 1.14.3 e hybrid 1.15.0	ApigeeTelemetry può bloccarsi nello stato creating. Questo problema è stato riscontrato nelle installazioni di OpenShift. Soluzione alternativa:modifica il modello di grafico apigee-operator per creare l'accesso clusterrole corretto. Modifica il file modello helm-charts/apigee-operator/templates/apigee-operators.yaml e individua la definizione di clusterrole -apigee-manager-role-. Ecco quali sono: kind: ClusterRole metadata: name: apigee-manager-role-{{ include 'namespace' }} rules: ... Individua il blocco - apiGroups: apiregistration.k8s.io e aggiungi la risorsa apiservices/finalizers all'elenco delle risorse: - apiGroups: - apiregistration.k8s.io resources: - apiservices - apiservices/finalizers verbs: - create - delete - get - patch - update Trova il blocco - apiGroups: authorization.k8s.io e aggiungi il blocco - apiGroups: apigee.cloud.google.com dopo la fine del blocco con il seguente testo: - apiGroups: - apigee.cloud.google.com resources: - apigeetelemetries/finalizers verbs: - get - patch - update Ad esempio: - apiGroups: - authorization.k8s.io resources: - subjectaccessreviews verbs: - create - get - list - apiGroups: - apigee.cloud.google.com resources: - apigeetelemetries/finalizers verbs: - get - patch - update Applica le modifiche al grafico apigee-operator: Prova: helm upgrade operator apigee-operator/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f OVERRIDES_FILE \ --dry-run=server esegui l'upgrade del grafico: helm upgrade operator apigee-operator/ \ --install \ --namespace APIGEE_NAMESPACE \ --atomic \ -f OVERRIDES_FILE \
402739748	Apigee	APRI	I prodotti API sono limitati a 50 percorsi. Se aggiungi altri percorsi, viene visualizzato un messaggio di errore: Operation group limit of 51 exceeded in Operation Config Soluzione alternativa:utilizza i pattern jolly per combinare i percorsi delle risorse e le operazioni come descritto in Configurazione dei percorsi delle risorse. Soluzione alternativa:crea più prodotti API. Questa soluzione alternativa è stata verificata ed è fattibile per chi aggiunge molti proxy API a un prodotto API. L'app associata ai tuoi prodotti API dovrà essere aggiornata per includere quella nuova, ma è stato dimostrato che le credenziali e i dettagli della richiesta lato client non devono essere modificati.
291294211	Apigee	APRI	Errore durante l'utilizzo delle API Custom Reports e Stats durante la selezione per tipo di tariffa per le installazioni che utilizzano la monetizzazione. Soluzione alternativa:recupera tutti i tipi di commissione sul lato client prima di filtrare.
391140293	Apigee Apigee hybrid	RISOLTO	Lo scaling dei pod di ingresso Istio può causare un errore 503. Lo scaling dei pod di ingresso Istio può occasionalmente causare un errore 503. Se si verifica un errore 503, i log del bilanciatore del carico mostrano il seguente messaggio: statusDetails: backend_connection_closed_before_data_sent_to_client. Soluzione alternativa: scala manualmente i pod di ingresso Istio.
368155212	ibrido 1.14.0 ibrido 1.14.1	CORRETTO nella versione ibrida 1.14.2	ESS e non-ESS La rotazione delle credenziali Cassandra non funziona nelle organizzazioni con limiti proxy avanzati. Il traffico di runtime non è interessato.
401624396	ibrido 1.13.x ibrido 1.14.x	APRI	Il job di ripristino di Apigee non riesce a ripristinare i backup di GCP o HYBRID dei provider cloud eseguiti da una configurazione multiregionale. Questo problema non influisce sul ripristino di CSI. I backup eseguiti dalla configurazione multiregionale utilizzando i provider di servizi cloud GCP e HYBRID contengono informazioni su tutte le regioni ibride esistenti al momento dell'acquisizione dello snapshot. Poiché queste regioni non esistono più, il job di ripristino entrerà in conflitto con lo stato attuale di Cassandra e non riuscirà a essere eseguito, restituendo il seguente errore: Unrecognized strategy option passed to NetworkTopologyStrategy. Nota: se almeno una regione ibrida è ancora attiva e integra, devi seguire la guida al ripristino della regione anziché ripristinare Cassandra da uno snapshot.
401746333	Apigee hybrid 1.12.4 hybrid 1.13.3 hybrid 1.14.1	RISOLTO	La libreria Nimbus JOSE + JWT potrebbe causare un java.lang.ClassCircularityError quando utilizzi un criterio JavaCallout . Se hai un'organizzazione abilitata per Apigee Hybrid con un criterio JavaCallout che utilizza la libreria Nimbus JOSE + JWT, non eseguire l'upgrade a hybrid 1.12.4, hybrid 1.13.3, hybrid 1.14.1.
397693324	ibrido 1.14.0 ibrido 1.14.1	CORRETTO nella versione ibrida 1.14.2	ESS e non ESS La rotazione delle credenziali Cassandra multiregionale non andrà a buon fine in tutte le regioni, tranne la prima. Il traffico di runtime non è interessato. Segui la soluzione alternativa fornita per risolvere il problema.
391861216	ibrido 1.13.x ibrido 1.14.x	CORRETTO nelle versioni ibride 1.13.3 e 1.14.1	Il riavvio dei pod Cassandra su un cluster ibrido ripristinato utilizzando i provider GCP o HYBRID Cloud causerà l'arresto anomalo dei pod. Questo problema non influisce sul ripristino di CSI. I pod Cassandra verranno riavviati dopo l'applicazione delle modifiche agli override di Cassandra, ad esempio quando viene riattivato il backup, il che attiverà questo problema. I log di un pod Cassandra nello stato CrashLoopBackoff mostreranno il seguente errore: Cannot change the number of tokens from 512 to 256. Segui la soluzione alternativa fornita per risolvere il problema.
388608440	ibrido 1.11.x ibrido 1.12.x	CORRETTO nella versione ibrida 1.12.4 e successive	Il job di backup di Apigee non pulisce gli snapshot intermedi di Cassandra. In alcuni rari casi, il job di backup di Apigee non pulisce gli snapshot intermedi di Cassandra che crea durante l'esecuzione dei backup utilizzando i provider di servizi cloud HYBRID o GCP. Ciò si verifica solo se un problema sottostante impedisce al processo di backup di connettersi correttamente al server remoto o a Cloud Storage. Se il problema di connessione persiste, gli snapshot Cassandra rimanenti possono accumularsi nel tempo, utilizzando lo spazio di archiviazione sui dischi di Cassandra. Se il problema ti riguarda, correggi il problema di connessione sottostante e poi segui i passaggi forniti nella guida alla risoluzione dei problemi di Cassandra per cancellare manualmente gli snapshot di Cassandra. Nota:questo problema noto non influisce sul backup e sul ripristino CSI.
392135466	ibrido 1.14.0	APRI	Il concatenamento dei proxy con mTLS non è supportato quando si utilizzano i limiti proxy avanzati per ambiente
383334511	Apigee	APRI	Voce KVM creata con nome imprevisto Quando viene utilizzata una norma KeyValueMapOperations con ambito apiproxy e l'operazione <Put> della norma viene chiamata in un flusso condiviso tramite un hook di flusso, la voce KVM viene creata con il nome del flusso condiviso. Dovrebbe essere creato con il nome del proxy API.
384937220	ibrido 1.14.0	RISOLTO	La creazione della release Helm potrebbe non riuscire quando sono presenti più host virtuali. Nota: questo problema è stato risolto nella versione 1.14.2. Apigee consiglia di eseguire l'upgrade alla versione 1.14.2 o successive. Quando sono presenti più host virtuali, la creazione della release Helm potrebbe non riuscire a causa di nomi ApigeeRoute in conflitto. La soluzione alternativa consiste nell'eseguire i seguenti comandi per ogni host virtuale durante la creazione: kubectl annotate ar apigee-ingressgateway-internal-chaining-PROJECT_ID_SUFFIX -n APIGEE_NAMESPACE meta.helm.sh/release-name=NEW_ENV_GROUP_NAME --overwrite kubectl annotate cert apigee-ingressgateway-internal-chaining-PROJECT_ID_SUFFIX -n APIGEE_NAMESPACE meta.helm.sh/release-name=NEW_ENV_GROUP_NAME --overwrite dove: PROJECT_ID_SUFFIX è un suffisso univoco per il concatenamento interno per il tuo progetto in Kubernetes. Puoi trovare questo suffisso con il seguente comando: kubectl get svc -n apigee -l app=apigee-ingressgateway | grep internal-chaining L'output sarà simile al seguente: kubectl get svc -n apigee -l app=apigee-ingressgateway | grep internal-chaining apigee-ingressgateway-internal-chaining-my-project--1234567 ClusterIP 34.118.226.140 <none> 15021/TCP,443/TCP 5d6h Nell'output di esempio, my-project--1234567 è PROJECT_ID_SUFFIX. APIGEE_NAMESPACE è il tuo spazio dei nomi Apigee. NEW_ENV_GROUP_NAME è il nome del gruppo di ambienti aggiuntivo. Aggiorna questo valore per ogni host virtuale.
N/D	Apigee hybrid	APRI	Un account di servizio non valido può inviare l'API UpdateControlPlaneAccess in un ciclo di nuovi tentativi. Se un utente fornisce un account di servizio non valido all'API UpdateControlPlaneAccess, l'operazione entra in un ciclo di tentativi che blocca effettivamente l'organizzazione dall'invocazione dell'API fino al timeout dell'operazione.
373722434	ibrido 1.13.x	CORRETTO a partire da hybrid 1.13.2 e versioni successive	Il job di backup di Apigee non può essere caricato nei bucket Cloud Storage con policy di conservazione. Quando utilizzi il fornitore di servizi cloud GCP, il job di backup di Apigee non è in grado di caricare nei bucket Cloud Storage con criteri di conservazione. I file di backup potrebbero essere lasciati nel bucket Cloud Storage con una dimensione del file di 0 byte. Soluzione alternativa: disattiva i criteri di conservazione nel bucket Cloud Storage.
341099433	Apigee hybrid	APRI	Il componente apigee-logger non supporta la federazione delle identità per i workload. apigee-logger utilizza i service account Google IAM per inviare i log a Cloud Logging. Ciò è dovuto alla mancanza di supporto di FluentBit per la federazione delle identità del workload, che impedisce a apigee-logger di utilizzare questa funzionalità.
N/D	Apigee hybrid	APRI	Distributed Trace in Apigee hybrid non è supportato per le organizzazioni che utilizzano la residenza dei dati.
N/D	Apigee	APRI	Apigee non supporta la ri-crittografia delle chiavi, il che significa che anche dopo la rotazione, verrà comunque utilizzata la vecchia versione della chiave e non potrai modificare la chiave CMEK dopo la creazione dell'organizzazione.
270574696	Apigee	RISOLTO	Apigee non supporta Cloud External Key Manager.
268104619	Apigee Apigee hybrid	APRI	Nella policy OASValidation, quando specifichi un tipo di array nell'intestazione, il MP genererà un errore, anche se l'input è valido.
364872027	Apigee Apigee hybrid	RISOLTO	Errore di analisi PEM nelle policy JWT/JWS a causa del formato non standard Per Apigee e Apigee Hybrid versioni 1.13 e successive, eventuali deviazioni nel formato PEM richiesto delle chiavi utilizzate nei criteri JWS o JWT di Apigee potrebbero causare un errore di analisi. Ad esempio, inserire un carattere diverso da un carattere di nuova riga (/n) immediatamente prima della riga "-----END" (limite post-incapsulamento) non è consentito e genererà un errore. Per evitare questo errore, assicurati che nessun carattere diverso da un carattere di nuova riga, ad esempio spazi o barre finali, preceda immediatamente il limite post-incapsulamento. Per saperne di più sulla codifica utilizzata per le chiavi pubbliche o private, consulta IETF RFC 7468.
310191899	Apigee Apigee hybrid	APRI	Timeout durante il deployment di proxy API e flussi condivisi I seguenti endpoint potrebbero subire timeout se utilizzati con un volume elevato di query al secondo (QPS): organizations.environments.apis.revisions. deployments.deploy organizations.environments.apis.revisions. deployments.undeploy organizations.environments.sharedflows.revisions. deployments.deploy organizations.environments.sharedflows.revisions. deployments.undeploy Per ridurre la probabilità di timeout, ti consigliamo di impostare un target di 1 QPS quando utilizzi questi endpoint o di controllare lo stato di un deployment prima di tentare un altro deployment.
329304975	Apigee	RISOLTO	Limite al numero di percorsi di base per ambiente Apigee sta applicando un limite temporaneo di 1000 basepath per ambiente per evitare potenziali errori durante il deployment delle revisioni del proxy API. Durante questo limite, puoi eseguire il deployment di un massimo di 1000 revisioni del proxy API (ognuna contenente un singolo percorso di base) per ambiente. Se i proxy API o le revisioni contengono più di un percorso di base, il numero totale di percorsi di base per ambiente non deve superare 1000.
333791378	ibrido 1.12.0	APRI	Funzionalità di backup e ripristino di Cassandra non supportate dallo strumento di migrazione Helm Per i passaggi necessari per installare una patch per la soluzione alternativa, consulta Risoluzione dei problemi.
310384001	ibrido 1.11.0	APRI	Gli errori di convalida dei certificati potrebbero restituire un errore 502 anziché 503 quando gli utenti aggiungono il tag <Enforce>true</Enforce> nel blocco <SSLInfo> per la convalida predefinita dei certificati dell'endpoint di destinazione TLS.
289583112	Apigee	APRI	Il criterio OASValidation non funziona con i requisiti di sicurezza globali nelle specifiche OpenAPI Se il criterio OASValidation specifica un <OASResource> con requisiti di sicurezza impostati a livello globale, i requisiti di sicurezza non vengono applicati. Soluzione alternativa: per garantire l'applicazione, tutti i requisiti di sicurezza devono essere impostati a livello di operazione nella specifica OpenAPI passata nell'elemento <OASResource> del criterio OASValidation.
205666368	Apigee hybrid 1.10.2 hybrid 1.10.3	CORRETTO in Apigee 1-10-0-apigee-6 e Hybrid 1.10.3-hotfix.1	Apigee hybrid non convalida il certificato di destinazione per impostazione predefinita. Consulta Informazioni sull'impostazione delle opzioni TLS in un endpoint di destinazione o in un server di destinazione.
295929616	ibrido 1.10.0 e versioni successive	CORRETTO in hybrid 1.10.3	L'installazione di Apigee Hybrid 1.10 su OpenShift (OSE) può non riuscire a causa di errori di memoria insufficiente. L'installazione o l'upgrade ad Apigee hybrid 1.10.0-1.10.2 potrebbe non riuscire su OSE a causa di problemi di esaurimento della memoria. Corretto nella versione 1.10.3 di Apigee hybrid.
292118812	ibrido 1.10.1	RISOLTO	apigee-udca potrebbe non rispettare le impostazioni del proxy HTTP. Se il firewall forza tutto il traffico attraverso un proxy di inoltro, apigee-udca potrebbe entrare in uno stato di backoff del ciclo di arresto anomalo.
292558790	Apigee hybrid 1.8.0 e versioni successive	APRI	Il criterio OASValidation non riesce e restituisce l'errore Unable to parse JSON. Il criterio OASValidation non riesce quando i contenuti JSON non corrispondono al pattern previsto. Ad esempio, se un'intestazione prevede un valore nel formato <text>@<text> e viene compilata con un testo a cui manca il simbolo @, il criterio non verrà rispettato e verrà visualizzato un errore Unable to parse JSON. Se il criterio OASValidation specifica un <OASResource> contenente un parametro path che utilizza uno schema $ref, il criterio non verrà applicato e verrà visualizzato un errore Unable to parse JSON - Unrecognized token. Soluzione: non utilizzare $ref nei parametri path della specifica OpenAPI specificata nell'elemento <OASResource>.
297012500	Apigee hybrid 1.8.0 e versioni successive	APRI	Problemi di deployment con la convalida OAS durante l'utilizzo di un riferimento circolare. Il deployment di Apigee non riuscirà per il criterio di convalida OAS quando si utilizzano riferimenti circolari per la specifica OpenAPI 3.0.0, poiché entra in un ciclo infinito. Soluzione alternativa: utilizza un file YAML di specifica OpenAPI senza riferimenti circolari.
289254725	Apigee Apigee 1-10-0-apigee-3 hybrid 1.8.8 hybrid 1.9.3	CORRETTO in Apigee 1-10-0-apigee-5 CORRETTO in hybrid	I deployment proxy che includono il criterio OASValidation potrebbero non riuscire. I deployment proxy che includono il criterio OASValidation potrebbero non riuscire se: La specifica OpenAPI utilizzata per la convalida nel criterio OASValidation è in formato YAML e La specifica OpenAPI in formato YAML contiene un numero mobile. Ad esempio: schema: type: number example: 2.345
284500460	Apigee Apigee 1-10-0-apigee-1	RISOLTO	Aumento della latenza per i criteri di registrazione dei messaggi se utilizzati con Cloud Logging. Per evitare di aumentare la latenza nelle risposte al client, la norma di registrazione dei messaggi deve essere allegata a PostClientFlow. Per saperne di più sull'utilizzo dei criteri in PostClientFlows, consulta Controllo dei proxy API con i flussi.
282997216	ibrido 1.8.0 e versioni successive ibrido 1.9.0 e versioni successive	APRI	Caratteri speciali non consentiti nella password di Cassandra Jolokia Utilizza solo caratteri alfanumerici per la password di Cassandra Jolokia. L'utilizzo di caratteri speciali (inclusi, a titolo esemplificativo, "!", "@", "#", "$", "%", "^", "&" e "*") può causare l'avvio di Cassandra non riuscito.
270371160	ibrido 1.9.0 e versioni successive	RISOLTO	Il gateway Apigee Ingress supporta solo protocolli/cifre TLS1.2+ Apigee Ingress gateway supporta solo TLS1.2+ e non le versioni precedenti di TLS.
269139342	ibrido 1.7.0 e versioni successive	RISOLTO	apigeectl getOrg non segue le impostazioni di HTTP_PROXY in overrides.yaml La convalida dell'organizzazione Apigee non segue le regole del proxy di inoltro HTTP impostate in overrides.yaml. Imposta validateOrg: false per saltare questa convalida.
266452840	Apigee hybrid 1.7.0 e versioni successive hybrid 1.8.0 e versioni successive hybrid 1.9.0 e versioni successive	RISOLTO	I websocket non funzionano con Anthos Service Mesh 1.15.3 in Apigee X e Apigee Hybrid In determinate circostanze, i websocket non funzionano per Apigee X e Apigee Hybrid quando si utilizza Anthos Service Mesh 1.15.3-asm.6.
287922301	Apigee	APRI	Imprecisioni nei tassi di monetizzazione intorno alle soglie delle fasce di volume A causa del design attuale, potrebbero essere valutate tariffe di monetizzazione imprecise per le transazioni che si verificano in prossimità di una soglia di banda di volume. Ciò si manifesta con un numero eccessivo di transazioni valutate alla tariffa precedente alla soglia ed è più probabile che si verifichi quando molte transazioni per una determinata combinazione di sviluppatore e piano tariffario si verificano in un intervallo di 30 secondi. Ciò significa che i report sulla monetizzazione sovrastimeranno gli addebiti con tassi a bande decrescenti e sottostimeranno gli addebiti con tassi a bande crescenti. Questo problema si verifica in Apigee X e Apigee Hybrid e non è nota alcuna soluzione alternativa. La risoluzione è iniziata e sarà disponibile in una release futura.
242213234	Apigee	RISOLTO	Il prodotto API non viene caricato e viene visualizzato l'errore "Nessuna connessione disponibile" Questo errore potrebbe essere restituito quando si tenta di caricare i prodotti API: "I prodotti non sono stati caricati correttamente. Errore: nessuna connessione disponibile dagli agenti Apigee Connect." Il problema si verifica dopo aver attivato il controllo di servizio VPC nel progetto Google Cloud e aver aggiunto iamcredentials.googleapis.com come uno dei servizi limitati nel perimetro di servizio. Soluzione: crea manualmente una regola in uscita, ad esempio la seguente: -egressTo: operations: -serviceName: "iamcredentials.googleapis.com" methodSelectors: -method: resources: -projects/608305225983 egressFrom: identityType: ANY_IDENTITY
247540503	ibrido 1.7.0 e versioni successive ibrido 1.8.0 e versioni successive	RISOLTO	Una race condition con la ricerca della chiave di crittografia può causare errori di ricerca KVM. In determinate circostanze, con una velocità effettiva molto elevata, una condizione di competizione con la ricerca della chiave di crittografia può causare errori di ricerca KVM.
258699204	ibrido 1.8.0 e versioni successive	RISOLTO	Le richieste e i limiti di memoria predefiniti per i pod delle metriche sono cambiati inavvertitamente nella versione 1.8.x. Se riscontri problemi con i pod apigee-telemetry-app o apigee-telemetry-proxy che non sono in esecuzione, modifica le proprietà metrics resources requests e resources limits in modo che corrispondano ai seguenti valori predefiniti in Riferimento alle proprietà di configurazione: metriche. Proprietà di configurazione Valore predefinito metrics.aggregator.resources.requests.memory: 512Mi metrics.aggregator.resources.limits.memory: 3Gi metrics.app.resources.requests.memory: 512Mi metrics.app.resources.limits.memory: 1Gi metrics.appStackdriverExporter.resources.requests.memory: 512Mi metrics.appStackdriverExporter.resources.limits.memory: 1Gi metrics.proxy.resources.requests.memory: 512Mi metrics.proxy.resources.limits.memory: 1Gi metrics.proxyStackdriverExporter.resources.requests.memory: 512Mi metrics.proxyStackdriverExporter.resources.limits.memory: 1Gi Applica le modifiche con apigeectl apply con il flag ‑‑telemetry: apigeectl apply --telemetry -f overrides.yaml
260324159	Apigee 1-9-0-apigee-16	RISOLTO	Deployment di proxy API e flussi condivisi che richiedono fino a 30 minuti. In determinate circostanze, il deployment di proxy API e flussi condivisi nel piano di runtime potrebbe richiedere circa 20-30 minuti a causa di un errore "socket chiuso" nel sincronizzatore.
214447386	Tutti	APRI	Il messaggio "config not modified" viene visualizzato negli audit log dell'accesso ai dati dell'API Apigee come Error. Questo comportamento è previsto ogni minuto e non influisce sul costo di fatturazione.
260772383	ibrido 1.8.0 e versioni successive	APRI	Errore di binding del socket sulla piattaforma AKS Se installi hybrid su AKS, potresti visualizzare questo errore: envoy config listener '0.0.0.0_443' failed to bind or apply socket options: cannot bind '0.0.0.0:443': Permission denied Soluzione:aggiungi la seguente stanza svcAnnotations al file di override: ingressGateways: - name: INGRESS_NAME ... svcAnnotations: service.beta.kubernetes.io/azure-load-balancer-internal: "true" Vedi Configurare il runtime di hybrid. Vedi anche Utilizza un bilanciatore del carico interno con AKS.
241786534	ibrido 1.8.0 e versioni successive	RISOLTO	A volte MART non riesce a connettersi a FluentD. Quando si utilizza UDCA con ambito organizzativo, a volte MART non riesce a connettersi a FluentD. UDCA con ambito organizzazione è l'impostazione predefinita in Apigee hybrid versione 1.8. Consulta orgScopedUDCA nel riferimento alle proprietà di configurazione.
N/D	ibrido 1.6.0 e versioni successive	APRI	apigee-logger non funziona su Anthos BareMetal con CentOS o RHEL. Dopo la migrazione di apigee-logger da fluend a fluent-bit in Apigee Hybrid versione 1.6.6, il logger ha smesso di funzionare su Anthos Bare Metal con CentOS o RHEL.
207762842	ibrido 1.5.0 e versioni successive	RISOLTO	Log non inviati a Cloud Logging da apigee-logger. Le attuali configurazioni di apigee-logger, inclusi i probe di attività, non sono compatibili con il runtime Kubernetes, pertanto i log non vengono inviati a Cloud Logging come previsto. Questo problema causa anche l'arresto anomalo regolare dei pod apigee-logger. Questo problema riguarda le installazioni ibride di Apigee su AKS, Anthos Bare Metal e altre piattaforme. Tieni presente che in alcuni casi questo problema comporta un volume eccessivo di log.
191291501, 191000617	Apigee	RISOLTO	La modifica dell'indirizzo email di un'entità sviluppatore non andrà a buon fine nell'interfaccia utente.
191002224	ibrido 1.5.0 e versioni successive	RISOLTO	La modifica di un indirizzo email non riesce durante l'utilizzo dell'API PUT /organizations/{org_name}/developers/{developer_email}.
184555974	ibrido 1.5.0 e versioni successive	RISOLTO	apigee-logger Fluentd non riesce ad analizzare i log nel cluster OpenShift.
N/D	Archiviare i deployment	APRI	La gestione e il debug delle implementazioni degli archivi Apigee nella UI non sono supportati Nell'interfaccia utente di Apigee, non puoi visualizzare, confermare lo stato del deployment o gestire i deployment degli archivi, come descritto in Deployment di un proxy API, né utilizzare l'interfaccia utente di debug come descritto in Utilizzo di Debug. Come soluzione alternativa, puoi utilizzare gcloud o l'API per elencare tutti i deployment di archiviazione in un ambiente e utilizzare l' API Debug.
N/D	Archiviare i deployment	APRI	Il rollback di un deployment di archivio non è supportato Il rollback di un deployment di archivio non è attualmente supportato. Per rimuovere una versione di un deployment di un archivio, devi eseguire nuovamente il deployment di una versione precedente di un archivio oppure eliminare l'ambiente.
421402073	Apigee in VS Code	APRI	L'autenticazione Google nelle policy non è supportata in Apigee in Visual Studio Code (VS Code) L'autenticazione Google nelle policy ServiceCallout ed ExternalCallout, come descritto in Utilizzo dell'autenticazione Google, non è supportata in Apigee in VS Code.
422757662	Apigee 1-15-0-apigee-5 hybrid 1.15.0	CORRETTO in Apigee 1-15-0-apigee-7 e Apigee 1-15-0-apigee-8	Intestazioni x-b3 non disponibili quando DistributedTrace è disabilitato Nelle release Apigee 1-15-0-apigee-5 e hybrid 1.15.0, Apigee ha interrotto l'invio di intestazioni x-b3 agli endpoint di destinazione quando Distributed Trace è disattivato. Tuttavia, alcune installazioni di Apigee si basavano sull'invio di intestazioni x-b3 indipendentemente dal fatto che Distributed Trace fosse attivato o disattivato. Pertanto, questa modifica è stata ripristinata a partire da Apigee 1-15-0-apigee-7. Nota:se riscontri questo problema, contatta Apigee per ripristinare temporaneamente questa modifica nella tua organizzazione Apigee. Attenzione:Apigee sconsiglia di utilizzare le intestazioni x-b3 quando Distributed Trace è disattivato. In questo modo, si eviteranno modifiche future a questo comportamento.
146222881	ibrido 1.3.0 e versioni successive	RISOLTO	Errore di intestazione HTTP non valida Errore di intestazione HTTP non valida: l'ingresso Istio passa tutte le risposte di destinazione in entrata al protocollo HTTP2. Poiché il processore di messaggi ibrido supporta solo HTTP1, potresti visualizzare il seguente errore quando viene chiamato un proxy API: http2 error: Invalid HTTP header field was received: frame type: 1, stream: 1, name: [:authority], value: [domain_name] Se visualizzi questo errore, puoi eseguire una delle seguenti azioni per risolvere il problema: Modifica il servizio di destinazione per omettere l'intestazione Host nella risposta. Se necessario, rimuovi l'intestazione Host utilizzando i criteri AssignMessage nel proxy API.
420985360	Portale integrato	APRI	SmartDocs Apigee supporta la specifica OpenAPI 3.0 quando pubblichi le tue API utilizzando SmartDocs sul tuo portale, anche se un sottoinsieme di funzionalità non è ancora supportato. Ad esempio, proprietà allOf per combinare ed estendere gli schemi. Se nella specifica OpenAPI viene fatto riferimento a una funzionalità non supportata, in alcuni casi gli strumenti ignorano la funzionalità, ma eseguono comunque il rendering della documentazione di riferimento dell'API. In altri casi, una funzionalità non supportata causerà errori che impediranno il rendering corretto della documentazione di riferimento dell'API. In entrambi i casi, dovrai modificare la specifica OpenAPI per evitare l'utilizzo della funzionalità non supportata finché non verrà supportata in una release futura. Prova questa API presenta le seguenti limitazioni: L'intestazione Accept è impostata su application/json indipendentemente dal valore impostato per consumes nella specifica OpenAPI. Le intestazioni delle richieste di tipo diverso da stringa non sono supportate.
N/D	Portale integrato	APRI	Amministratore del portale Al momento non sono supportati aggiornamenti simultanei del portale (ad esempio modifiche a pagine, temi, CSS o script) da parte di più utenti. Se elimini una pagina di documentazione di riferimento dell'API dal portale, non è possibile ricrearla. Dovrai eliminare e aggiungere di nuovo il prodotto API e rigenerare la documentazione di riferimento dell'API. Quando personalizzi il tema del portale, l'applicazione completa delle modifiche potrebbe richiedere fino a 5 minuti.
N/D	Portale integrato	APRI	Funzionalità del portale La ricerca verrà integrata nel portale integrato in una release futura.
N/D	Portale integrato	APRI	Provider di identità SAML L'uscita singola (SLO) con il provider di identità SAML non è supportata per i domini personalizzati. Per attivare un dominio personalizzato con un provider di identità SAML, lascia vuoto il campo URL di disconnessione quando configuri le impostazioni SAML.
191815997	ibrido 1.6.0 e versioni successive	RISOLTO	Se un cliente ibrido configura un proxy di inoltro per il proxy API, il token Google non funzionerà a meno che non abbia accesso diretto a *.googleapis.com.
N/D	Apigee	CORRETTO in Apigee 1-12-0-apigee-2 e hybrid 1.12.0	API Monitoring e Cloud Monitoring mostrano picchi anomali I conteggi delle richieste e delle risposte del proxy API (per proxy e target) mostrano picchi anomali Ecco un esempio che mostra un picco di questo tipo: (visualizza immagine più grande) A causa di un bug, il sistema registra il conteggio in modo errato per un breve periodo e il conteggio viene corretto. Ciò si verifica quando si verifica una riduzione del traffico API (che comporta una fare lo scale downne delle dimensioni dei gateway API). Per distinguere i picchi effettivi di richieste da questo problema, consulta la pagina API Analytics (in particolare le pagine Rendimento proxy e Rendimento target) Metriche interessate: apigee.googleapis.com/proxyv2/request_count apigee.googleapis.com/proxyv2/response_count apigee.googleapis.com/targetv2/request_count apigee.googleapis.com/targetv2/response_count Nuove metriche Puoi utilizzare le nuove metriche per evitare questo problema. Nota: queste metriche sono attualmente disponibili per Apigee e Apigee hybrid 1.12 e versioni successive. Per Apigee hybrid v1.10 e v1.11, utilizza le metriche originali. Metrica Descrizione apigee.googleapis.com/proxy/request_count Numero di richieste al proxy Apigee dall'ultimo campione registrato. apigee.googleapis.com/proxy/response_count Numero di risposte inviate dal proxy API Apigee. apigee.googleapis.com/proxy/latencies Distribuzione delle latenze, calcolate dal momento in cui la richiesta è stata ricevuta dal proxy Apigee al momento in cui la risposta è stata inviata dal proxy Apigee al client. apigee.googleapis.com/target/request_count Numero di richieste inviate alla destinazione Apigee dall'ultima registrazione del campione. apigee.googleapis.com/target/response_count Numero di risposte ricevute dal target Apigee dall'ultimo campione registrato. apigee.googleapis.com/target/latencies Distribuzione delle latenze, calcolate dal momento in cui la richiesta è stata inviata al target Apigee al momento in cui la risposta è stata ricevuta dal proxy Apigee. Il tempo non include l'overhead del proxy API Apigee. Per Apigee hybrid, consulta Panoramica della raccolta di metriche e Visualizzare le metriche.
203778087	ibrido 1.5.3 e versioni successive	APRI	apigee-stackdriver-logging-agent attualmente viene eseguito come root. Soluzione alternativa:disattiva l'agente Logging su ibrido.
205629443	Apigee	RISOLTO	Se ServiceCallout è fire and forget (nessun tag <Response>), può verificarsi una race condition se è presente un'altra policy che si verifica dopo. Soluzione alternativa:per mantenere il comportamento "fire and forget": Aggiungi <Response>calloutResponse</Response> a ServiceCallout. Imposta continueOnError su true.
207719377	Apigee	CORRETTO in Apigee 1-11-0-apigee-1	Se in un bundle è presente più di una norma Spike Arrest, si verificano errori 502. Soluzione alternativa:evita di utilizzare più di un criterio Spike Arrest nel proxy per evitare il problema.
209097822	hybrid 1.5.0 e versioni successive Apigee	RISOLTO	Gli aggiornamenti dinamici della frequenza nell'arresto dei picchi potrebbero non essere riflessi immediatamente Per una determinata chiave, se il traffico è continuo, la chiave potrebbe non essere limitata in base alla frequenza aggiornata. Se non viene rilevato traffico per cinque minuti per una determinata chiave, la frequenza verrà aggiornata. Soluzione alternativa: esegui nuovamente il deployment del proxy con una nuova variabile di riferimento se la tariffa deve essere applicata immediatamente. In alternativa, utilizza due arresti di picco condizionali con variabili di flusso diverse per regolare la velocità.
221305498	Apigee	APRI	Il monitoraggio API potrebbe visualizzare il codice di errore "(not set)". API Monitoring dei proxy API configurabili potrebbe mostrare un codice di errore "(not set)" per le risposte con uno stato non 2xx dal target.
246774745	Apigee	RISOLTO	Il valore di io.timeout.millis non viene rispettato quando viene utilizzato con più target dinamici. Se un proxy imposta due o più valori io.timeout.millis in due o più flussi utilizzando lo stesso host di destinazione, viene rispettato un solo valore io.timeout.millis.
245664917	ibrido 1.8.x	RISOLTO	L'errore di upgrade di Apigee hybrid può essere ignorato Durante l'upgrade ad Apigee hybrid 1.8.x, dopo aver eseguito apigeectl init e aver confermato che check-ready è andato a buon fine, potresti notare, se visualizzi i pod, che il job di convalida dello schema Cassandra è in stato di errore. Si tratta di una condizione innocua e puoi passare tranquillamente al passaggio successivo della procedura di upgrade.
300660653	Apigee	RISOLTO	Viene restituito un errore durante il deployment di proxy con lo stesso percorso in più ambienti collegati allo stesso gruppo di istanze e ambiente Il deployment di proxy con lo stesso percorso in più ambienti collegati allo stesso gruppo di istanze e ambienti non è consentito e deve restituire un messaggio di avviso relativo a un conflitto del percorso di base. Al contrario, non viene visualizzato alcun errore e i deployment sembrano riuscire. Soluzione alternativa: durante e dopo il deployment, verifica che non vi siano conflitti del percorso di base con i proxy di cui è stato eseguito il deployment e correggi in base alle necessità.
301458133	Apigee	RISOLTO	Alcuni tentativi di deployment del proxy restituiscono un errore che indica che la revisione è immutabile Quando tenti di salvare un proxy di cui è stato eseguito il deployment in precedenza, il deployment potrebbe non riuscire con un errore che indica che la revisione è immutabile. Soluzione alternativa: fai clic sulla freccia del menu a discesa accanto al pulsante Salva e seleziona Salva come nuova revisione. Quindi, riprova a eseguire il deployment.
301845257	Apigee	RISOLTO	Il tentativo di deployment di più di 800 proxy in un gruppo di ambienti non riesce e viene visualizzato un errore. Il limite in base al quale viene restituito un errore è inferiore a 800 quando i percorsi di base sono più lunghi di 15 caratteri.
315820718	Apigee	RISOLTO	Con le richieste proxy gRPC, i trailer gRPC vengono rimossi dalla risposta Quando viene effettuata una chiamata a un server di destinazione gRPC, l'unico trailer restituito è il trailer "grpc-status". Tutti gli altri trailer vengono rimossi dalla risposta.
341157011	Apigee	RISOLTO	Le specifiche generate con l'Assistente codice Gemini in Cloud Code che includono anche caratteri UTF-8 non ASCII non vengono analizzate correttamente quando vengono caricate nell'hub API. Di conseguenza, l'hub API non estrarrà correttamente operazioni, definizioni e altri metadati.
338285095	Apigee	RISOLTO	Le app associate a un AppGroup non vengono visualizzate nell'elenco delle app nell'interfaccia utente Apigee. Di conseguenza, gli utenti non possono accedere alla pagina Dettagli app nella console. L'utilizzo della ricerca nella console con un nome dell'app o una chiave API parziale per cercare l'app non è supportato finché il problema non viene risolto. Le organizzazioni Apigee Hybrid non sono interessate da questo problema, in quanto utilizzano la UI classica per visualizzare i dettagli dell'app. Soluzione alternativa parziale: è disponibile un elenco di tutte le app utilizzando le API. Consulta organizations.apps.list.
355714868	Monetizzazione Apigee hybrid	CORRETTO in hybrid 1.14.3, hybrid 1.15.1, hybrid 1.16.0	Dati relativi a commissioni ricorrenti, di configurazione e di ricarica non acquisiti o fatturati per organizzazioni ibride Per le organizzazioni ibride con monetizzazione, i dati relativi a commissioni ricorrenti (RECURRING_FEE), di configurazione (SETUP_FEE) e di ricarica (TOPUP_FEE) non vengono acquisiti o fatturati per la fatturazione postpagata. Per la fatturazione prepagata, la detrazione dal portafoglio avviene per queste commissioni, ma non viene segnalata.
438850078	Apigee	APRI	Si verifica una ricorsione infinita all'interno della policy OASValidation quando una risposta di backend contiene un tipo di discriminatore uguale allo schema principale. Questo problema può portare a un StackOverflowError.
449012244	Apigee	APRI	Utilizza definizioni di endpoint di destinazione separate per le destinazioni SSE (server sent-event). La combinazione di endpoint di destinazione SSE e non SSE potrebbe comportare un comportamento incoerente, ad esempio variabili di flusso response.content vuote.
445936920	Apigee 1-16-0-apigee-2 e versioni successive	APRI	Problemi di configurazione DNS precedentemente non rilevati ora potrebbero causare errori DNS. Apigee ha rimosso la funzionalità di fallback DNS automatico presente in 1-16-0-apigee-2. Questa rimozione elimina la resilienza della piattaforma alle configurazioni DNS errate e ora potrebbe causare errori DNS. Trova gli errori correlati controllando i log di runtime per gli errori di risoluzione DNS.
383372330	Versioni dell'emulatore Apigee dalla 1.13.0 alla 1.15.1 esclusa	CORRETTO nelle versioni 1.15.1 e successive dell'emulatore Apigee	Tutti i deployment del proxy non riescono a livello locale con messaggi di errore che includono Error parsing deployment report as JSON: 06/13/2025 6:45 PM EMULATOR INFO Deploying environment testenv, to Container apigee-1.14.2 (1.14.2) 06/13/2025 6:45 PM EMULATOR ERROR Error parsing deployment report as JSON 06/13/2025 6:45 PM EMULATOR ERROR null 06/13/2025 6:45 PM EMULATOR ERROR Environment testenv deployment, to Container apigee-1.14.2 (1.14.2) failed with Error: 500 06/13/2025 6:45 PM EMULATOR ERROR Deploy to Container apigee-1.14.2 (1.14.2), failed with Error: Environment testenv deployment, to Container apigee-1.14.2 (1.14.2) failed with Error: 500 Correzione:esegui l'aggiornamento a una versione dell'emulatore Apigee 1.15.1 o successive.