← Cloudflare Spectrum / spectrum / reference

Kódy chyb

Tato stránka popisuje chybové kódy vracené Spectrum API, spolu s doporučenými opravami, které pomohou při řešení potíží.

Chyby Spectrum API se řídí standardní obálkou chyb Cloudflare v4. Tělo odpovědi obsahuje errors pole s code a message pole:

{
  "errors": [
    {
      "code": 11044,
      "message": "No matching routes in the specified virtual network."
    }
  ],
  "messages": [],
  "success": false,
  "result": null
}

Během zpracování požadavku došlo k neočekávané chybě. Odpověď neobsahuje diagnostické podrobnosti. Pokud kontaktujete podporu Cloudflare, uveďte Ray ID z odpovědi, aby bylo možné dohledat původní chybu.

HTTP 503 znamená, že závislá služba (například DNS nebo správa IP adres) je dočasně nedostupná. HTTP 500 označuje jakoukoli jinou interní chybu.

Tělo požadavku obsahuje pole, které API nerozpoznává. Tato chyba se vrací pouze u aplikací na účtech Pay-as-you-go. Aplikace Enterprise neznámá pole tiše ignorují.

Účty s platbou za spotřebu mají limit protocol, dns, a origin_direct při vytváření nebo aktualizaci aplikace Spectrum. Častou příčinou je účet bez Spectrum entitlement, který odešle úplnou konfiguraci Spectrum: jakékoli pole mimo tato tři bude odmítnuto.

Řešení: Chcete-li použít úplné konfigurační API Spectrum, kontaktujte svůj account team a požádejte o povolení Spectrum jako placeného doplňku. Jinak odstraňte všechna pole kromě protocol, dns, a origin_direct z požadavku.

Tyto chyby se vrací jako HTTP 400, pokud není uvedeno jinak.

Požadavek musí obsahovat právě jedno z origin_direct nebo origin_dns. Zadání obou hodnot nebo žádné z nich vyvolá tuto chybu.

origin_dns konfigurace neprošla validací. Časté příčiny:

• origin_dns.name není platný název domény.
• Ne-SRV origin_dns.type bylo zadáno bez origin_port.
• origin_dns.ttl je mimo povolený rozsah.

Jedna nebo více zadaných adres originu je neplatných.

Časté příčiny:

• IPv6 adresa originu bez hranatých závorek: IPv6 adresy musí být uvedeny v hranatých závorkách v origin_direct, například tcp://[2001:db8::1]:443. Bez hranatých závorek by dvojtečky v adrese činily analýzu nejednoznačnou.
• IP adresa originu neprošla ověřením řízení přístupu: IP adresa originu může neprojít interní kontrolou řízení přístupu. Ověřte, že je IP adresa platná a patří do povoleného rozsahu.

Typ DNS musí odpovídat režimu přidělování edge IP adres. Dynamické edge IP adresy vyžadují type: "CNAME". Statické (BYOIP) hraniční IP adresy vyžadují type: "ADDRESS". Tato chyba se vrátí i v případě, že se pokusíte změnit typ DNS při aktualizaci existující aplikace.

Typ provozu FTP není pro účet povolen. Vrací se jako HTTP 403.

Řešení: Kontaktujte svůj account team a požádejte o povolení podpory FTP.

edge_ips funkce (BYOIP) není pro účet povolena. Vrací se jako HTTP 403.

Řešení: Kontaktujte svůj account team a požádejte o povolení BYOIP pro účet.

Ověřený účet není oprávněn použít zadaný edge_ips.

Časté příčiny:

• Tokenu API chybí oprávnění pro prefix IP adres: API tokeny s oprávněním pro Spectrum nemusí obsahovat oprávnění k IP prefixům požadovaná pro ověření BYOIP. Použijte Global API Key, nebo přidejte Účet > IP prefixy oprávnění k API tokenu.
• Prefix BYOIP není přiřazen k účtu: Před přiřazením ověřte, že je prefix BYOIP alokován žádajícímu účtu.

Požadavek nastavil argo_smart_routing na true, ale Argo Smart Routing není pro účet povoleno. Vrací se jako HTTP 403.

Řešení: Kontaktujte svůj account team a požádejte o povolení Argo Smart Routing pro tento účet.

Jeden nebo více zadaných edge_ips se již používá v jiné zóně.

Běžná příčina: požadovaná edge IP adresa může být držena starší aplikací Spectrum ve smazané zóně. Kontaktujte podporu Cloudflare, aby osiřelou aplikaci odstranila.

Účty s platbou za spotřebu mají limit jedné aplikace na protokol. Pokud potřebujete více aplikací pro stejný protokol, kontaktujte tým spravující váš účet a nechte si povolit Spectrum jako placený doplněk.

DNS záznam nebo Load Balancer použitý jako origin se nachází v jiné zóně nebo v nepovolené zóně.

Řešení: Přesuňte DNS záznam originu nebo Load Balancer do stejné zóny, nebo použijte origin_direct místo toho s IP adresou.

Následující kódy vrací POST /zones/:zone/spectrum/apps a PATCH /zones/:zone/spectrum/apps/:id při ověřování aplikace, která používá origin virtuální sítě.

virtual_network_id bylo nastaveno u požadavku, který používá origin_dns. Originy virtuální sítě jsou podporovány pouze s originy založenými na IP adrese.

Řešení: Nahraďte origin_dns hodnotou origin_direct a zadejte privátní IP adresu a jeden port, na který virtuální síť směruje.

origin_direct obsahoval více než jednu adresu. Originy virtuální sítě se musí přeložit na jedinou privátní IP adresu a port.

Řešení: Snižte origin_direct na jednu položku ve tvaru tcp://<IP>:<PORT> nebo udp://<IP>:<PORT>.

Požadavek obsahoval rozsah portů, buď v origin_port nebo v origin_direct adresu. Originy virtuální sítě nepodporují rozsahy portů.

Řešení: Použijte jeden port místo rozsahu. Pokud potřebujete zpřístupnit více portů, vytvořte pro každý port samostatnou aplikaci Spectrum.

Kombinace IP adresy a virtual_network_id neodpovídá žádné trase v zadané virtuální síti. To zahrnuje dva případy: virtuální síť neexistuje, nebo IP adresa není v rámci zadané virtuální sítě směrovatelná.

Řešení:

• Ověřte virtual_network_id odpovídá virtuální síti ve vašem účtu. Seznam virtuálních sítí získáte pomocí Seznam virtuálních sítí koncový bod.
• Ověřte, že IP adresa origin serveru spadá do trasy připojené k dané virtuální síti. Seznam tras můžete zobrazit pomocí Seznam síťových tras koncový bod.
• Pokud neexistuje odpovídající trasa, přidejte ji podle postupu Připojení IP/CIDR.

virtual_network_id není platné UUID.

Řešení: Zadejte UUID. ID virtuálních sítí vrací Seznam virtuálních sítí endpoint v id pole každé položky.

Zóna má přiděleny všechny dostupné IPv4 adresy ve své kvótě.

Řešení: Zkonsolidujte aplikace na méně IP adres (více aplikací může sdílet hostname na různých portech), zakupte další IP adresy spravované Cloudflare, nebo onboardujte BYOIP.

Požadovaný protokol není pro tuto zónu k dispozici. Chybová zpráva obsahuje konkrétní edge porty, které nejsou pro požadovaný protokol povoleny.

Hostname se stejným DNS názvem již existuje, ale patří do jiné zóny. K tomu může dojít při vytváření nebo aktualizaci aplikace, pokud vyhledávání hostname odpovídá záznamu, který vlastní jiná zóna.

Řešení:

• Ověřte, že v URL adrese požadavku API používáte správné ID zóny.
• Pro aplikaci použijte jiný název DNS.
• Pokud byl daný název DNS dříve použit v jiné zóně, kterou spravujete, nejprve v této zóně aplikaci odstraňte.
• Pokud se na vás nic z výše uvedeného nevztahuje, kontaktujte podporu Cloudflare, protože název hostitele bude možná nutné interně vyčistit.