Subdomain-Einstellungen zu einer Subdomain hinzufügen¶

Note

Alle Attribute des Objekts SubdomainSettingVO müssen definiert werden. Nicht definierte Attribute erhalten automatisch den Standardwert.

Note

Subdomain-Einstellungen werden nicht aktualisiert, sondern immer neu erstellt. Die Create-Subdomain-Settings-Anfrage ist zugleich die Change-Subdomain-Settings-Anfrage.

Senden einer POST-Anfrage an den Endpunkt /domain/{domainId}/{vHostName}/settings.

Beschreibung¶

Mit der Add-Subdomain-Settings-Anfrage fügen Sie Subdomain-Einstellungen für eine Subdomain der Organisation hinzu.

Voraussetzungen¶

Werte der Anfrage: Domain-ID {domainId}, Subdomain name {vHostName}

Objekte: SubdomainSettingVO

Anfrage¶

Um Subdomain-Einstellungen für eine Subdomain hinzuzufügen, fügen Sie die Domain-ID {domainId} und den Subdomain name {vHostName} dem Pfad der Anfrage hinzu.

Für eine detaillierte Spezifikation, welche Informationen zum Hinzufügen von Subdomain-Einstellungen erforderlich sind, muss im Body das Objekt SubdomainSettingVO mit den folgenden Attributen definiert werden:

Attribut	Beschreibung	Werte
`accept_encoding`
`access_log`	(Protokollierung) Aktiviert oder deaktiviert das Zugriffsprotokoll.	Standard: `false` Mögliche Werte: `true` `false`
`antibot_post_flood`	(Sicherheit) Aktiviert oder deaktiviert die Erkennung von POST-Floods mithilfe eines JavaScript-basierten Puzzles.	Standard: `false` Mögliche Werte: `true` `false`
`antibot_post_flood_threshold`	(Sicherheit) Der Parameter, der bestimmt, wie häufig das Puzzle gelöst werden muss. Je höher der Wert, desto unwahrscheinlicher ist es, dass das Puzzle gelöst werden muss.	Standard: `20` Mögliche Werte: 0 to 100
`antibot_proof_of_work`	(Sicherheit) Aktiviert oder deaktiviert die JavaScript-basierte Bot-Erkennung. Bots werden dann beim Zugriff auf Ihre Website automatisch blockiert.	Standard: `false` Mögliche Werte: `true` `false`
`antibot_proof_of_work_threshold`	(Sicherheit) Der Parameter, der bestimmt, wie häufig das Puzzle gelöst werden muss. Je höher der Wert, desto unwahrscheinlicher ist es, dass das Puzzle gelöst werden muss.	Standard: `20` Mögliche Werte: 0 to 100
`balancing_method`	(Verbindung) Die Methode für die Lastverteilung zwischen den Upstream-Servern.	Standard: `round_robin` Mögliche Werte: `round_robin` -> Round-Robin-Verteilung `ip_hash` -> IP-Hash leitet dieselbe Client-IP immer an denselben Upstream-Server weiter `least_conn` -> Least-Conn leitet die Anfrage an den Upstream-Server mit aktuell den wenigsten Verbindungen weiter `cookie_based` -> Cookie-Based verwendet den von Ihnen unten angegebenen Cookie-Namen
`block_ip_by_header`
`block_not_whitelisted`	(Sicherheit) Aktiviert oder deaktiviert das Blockieren aller IPs, die nicht auf der Whitelist stehen.	Standard: `false` Mögliche Werte: `true` `false`
`block_tor_network`	(Sicherheit) Aktiviert oder deaktiviert das Blockieren von Traffic aus dem TOR-Netzwerk.	Standard: `false` Mögliche Werte: `true` `false`
`bot_calc_fingerprint`
`bot_customer_regex_0`
`bot_customer_regex_1`
`bot_customer_regex_2`
`bot_external_session_id`
`cache_enabled`	(Performance) Aktiviert oder deaktiviert das Caching. Wenn Sie den Cache aktivieren, müssen Sie in den Cache-Einstellungen auch die zu cachenden Objekte definieren.	Standard: `false` Mögliche Werte: `true` `false`
`cache_revalidate`	(Performance) Aktiviert oder deaktiviert, ob abgelaufene Cache-Objekte mit den zusätzlichen HTTP-Headern If-Modified-Since und If-None-Match angefragt werden.	Standard: `true` Mögliche Werte: `true` `false`
`cache_sort_active`
`client_max_body_size`	(Verbindung) Die maximal zulässige Größe des Client-Request-Bodys, angegeben im Request-Header-Feld Content-Length.	Standard: `10 MB` Mögliche Werte: up to 5120MB
`diffie_hellman_exchange`	(Sicherheit) Die Größe der Diffie-Hellman-Schlüsselaustauschparameter in Bit. Beachten Sie, dass Java 6 und 7 keine Diffie-Hellman-Parameter größer als 1024 Bit unterstützen.	Standard: `1024` Mögliche Werte: `1024` `2048`
`disable_accept_encoding`
`disable_forwarded_for`	(Verbindung) Aktiviert oder deaktiviert den X-Forwarded-For-Header zur Übertragung der IP-Adresse der Besuchenden.	Standard: `false` Mögliche Werte: `true` `false`
`enable_origin_sni`	(Sicherheit) Die Verfügbarkeit des Origin-SNI.	Standard: `true` Mögliche Werte: `true` `false`
`enforce_cache_ttl`	(Performance) Die Verfügbarkeit der Einstellung, die Cache-TTL-Einstellungen anstelle der Cache-Informationen der Kundeninfrastruktur zu erzwingen.	Standard: `false` Mögliche Werte: `true` `false`
`forwarded_for_replacement`	(Verbindung) Der Name des X-Forwarded-For-Headers.	Standard: `X-Forwarded-For` Mögliche Werte: A valid HTTP header name
`host_header`	(Experte) Der Name des Proxy-Host-Headers.	Standard: `$myra_host`
`hsts`	(Sicherheit) Aktiviert oder deaktiviert den Web-Security-Policy-Mechanismus, der Websites vor Protocol-Downgrade-Angriffen und Cookie-Hijacking schützt.	Standard: `false` Mögliche Werte: `true` `false`
`hsts_include_subdomains`	(Sicherheit) Aktiviert oder deaktiviert, ob alle Subdomains in den HSTS-Schutz einbezogen werden.	Standard: `false` Mögliche Werte: `true` `false`
`hsts_max_age`	(Sicherheit) Die Zeit in Sekunden, in der nur HTTPS-verschlüsselte Verbindungen zugelassen werden.	Standard: `31536000` Mögliche Werte: `0` to `2147483647`
`hsts_preload`	(Sicherheit) Aktiviert oder deaktiviert das Hinzufügen der Domain zur HSTS-Preload-Liste (hstspreload.appspot.com).	Standard: `false` Mögliche Werte: `true` `false`
`http_origin_port`
`ignore_nocache`	(Performance) Aktiviert oder deaktiviert, ob No-Cache-Header ignoriert werden.	Standard: `false` Mögliche Werte: `true` `false`
`image_optimization`	(Performance) Aktiviert oder deaktiviert die verlustfreie Optimierung von JPEG- und PNG-Bildern.	Standard: `true` Mögliche Werte: `true` `false`
`ipv6_active`	(Verbindung) Aktiviert oder deaktiviert Verbindungen über IPv6 zu Ihren Systemen.	Standard: `true` Mögliche Werte: `true` `false`
`limit_allowed_http_method`	(Sicherheit) Ein Array aller zulässigen HTTP-Methoden. Nicht ausgewählte HTTP-Methoden werden blockiert.	Standard: leer Mögliche Werte: `GET` `HEAD` `POST` `PUT` `DELETE` `MKCOL` `COPY` `MOVE` `OPTIONS` `PROPFIND` `PROPPATCH` `LOCK` `UNLOCK` `PATCH`
`limit_tls_version`	(Sicherheit) Ein Array aller zulässigen TLS-Versionen. Nur ausgewählte TLS-Versionen werden verwendet.	Standardwerte: `TLSv1` `TLSv1.1` `TLSv1.2` `TLSv1.3` Mögliche Werte: `TLSv1` `TLSv1.1` `TLSv1.2` `TLSv1.3`
`log_format`	(Protokollierung) Das Protokollformat für die Zugriffsprotokolle. Eine Liste aller möglichen Formate erhalten Sie beim Service-Support.	Standard: `myra-combined`
`monitoring_alert_threshold`	(Monitoring) Die Anzahl der Fehler pro Minute, die auftreten müssen, bis eine Meldung gesendet wird.	Standard: `300`
`monitoring_contact_email`	(Monitoring) Die E-Mail-Adressen, an die Monitoring-E-Mails gesendet werden sollen. Mehrere Adressen werden durch ein Leerzeichen getrennt.	Standard: leer
`monitoring_send_alert`	(Monitoring) Aktiviert oder deaktiviert die Meldung von Upstream-Fehlern.	Standard: `false` Mögliche Werte: `true` `false`
`myra_ssl_certificate`	(Sicherheit) Ein SSL/TLS-Zertifikat (und die Kette), das für Anfragen an die Kundeninfrastruktur verwendet wird.	Standard: leer
`myra_ssl_certificate_key`	(Sicherheit) Der private Schlüssel für das SSL/TLS-Zertifikat.	Standard: leer
`myra_ssl_header`	(Sicherheit) Aktiviert oder deaktiviert den X-Myra-SSL-Header, der angibt, ob eine Anfrage über SSL empfangen wurde.	Standard: `false` Mögliche Werte: `true` `false`
`next_upstream`	(Experte) Ein Array der Fehler, die den aktuellen Upstream als down markieren.	Standardwert: `error` `timeout` `invalid_header` Mögliche Werte: `error` `timeout` -> Beim Verbinden mit der Kundeninfrastruktur ist ein allgemeiner Fehler oder ein Timeout aufgetreten beim Senden der Anfrage oder beim Lesen der Antwort. `invalid_header` -> Ungültige oder leere Antwort von der Kundeninfrastruktur. `http_500` `http_502` `http_503` `http_504` -> Die Kundeninfrastruktur hat mit dem entsprechenden Antwortcode geantwortet. `off` -> Deaktiviert das next_upstream-Verhalten vollständig.
`only_https`	(Verbindung) Aktiviert oder deaktiviert, ob Anfragen immer auf HTTPS umgeleitet werden.	Standard: `false` Mögliche Werte: `true` `false`
`origin_connection_header`	(Experte) Der Connection-Header, der mit einer Anfrage an die Kundeninfrastruktur übertragen wird.	Standard: `none` Mögliche Werte: `upgrade` `close` `none`
`proxy_cache_bypass`	(Experte) Der Name des Cookies, das Myra zwingt, die Antwort nicht aus dem Cache auszuliefern. Die Werte des Cookies dürfen nicht leer oder gleich 0 sein, damit das Umgehen aktiviert wird.	Standard: leer
`proxy_cache_lock_age`
`proxy_cache_lock_timeout`
`proxy_cache_min_uses`
`proxy_cache_stale`	(Experte) Ein Array mit Fehlerfällen bei der Kommunikation mit dem Upstream-Server, in denen eine veraltete zwischengespeicherte Antwort verwendet werden soll.	Standardwert: `updating` Mögliche Werte: `error` `timeout` -> Beim Verbinden mit der Kundeninfrastruktur ist ein allgemeiner Fehler oder ein Timeout aufgetreten beim Senden der Anfrage oder beim Lesen der Antwort. `invalid_header` -> Ungültige oder leere Antwort von der Kundeninfrastruktur. `http_500` `http_502` `http_503` `http_504` -> Die Kundeninfrastruktur hat mit dem entsprechenden Antwortcode geantwortet. `off` -> Deaktiviert das next_upstream-Verhalten vollständig. `updating` -> Erlaubt das Ausliefern einer veralteten zwischengespeicherten Antwort, während sie aktualisiert wird, um Verbindungen zur Kundeninfrastruktur zu reduzieren.
`proxy_connect_timeout`	(Experte) Ein Timeout in Sekunden für den Verbindungsaufbau mit der Kundeninfrastruktur. Das Timeout darf nicht größer als 60 Sekunden sein.	Standard: `20` Mögliche Werte: `1` to `60`
`proxy_read_timeout`	(Experte) Ein Timeout in Sekunden für das Lesen einer Antwort vom Proxy-Server. Das Timeout gilt nur zwischen zwei aufeinanderfolgenden Lesevorgängen, nicht für die Übertragung der gesamten Antwort.	Standard: `1200` Mögliche Werte: `1` `2` `5` `10` `15` `30` `45` `60` `120` `180` `300` `600` `1200` `2400` `3600` `7200`
`proxy_send_timeout`
`proxy_ssl_name`
`proxy_ssl_trusted_certificate`
`proxy_ssl_verify`
`proxy_ssl_verify_depth`
`request_limit_block`	(Experte) Aktiviert oder deaktiviert, ob nach Überschreiten des konfigurierten Anfragelimits ein CAPTCHA gelöst werden muss.	Standard: `false` Mögliche Werte: `captcha` `HTTP_429` `false`
`request_limit_level`	(Verbindung) Ein Anfragelimit für zulässige Anfragen einer IP pro Minute. Wird das Limit erreicht, wird die IP blockiert und es wird ein CAPTCHA angezeigt, um die IP wieder freizugeben.	Standard: `6000` Mögliche Werte: `0` to `65535`
`request_limit_report`	(Experte) Aktiviert oder deaktiviert, ob eine E-Mail mit den blockierten IP-Adressen gesendet wird, die das konfigurierte Anfragelimit überschritten haben.	Standard: `false` Mögliche Werte: `true` `false`
`request_limit_report_email`	(Experte) Eine E-Mail-Adresse, an die E-Mails zum Anfragelimit gesendet werden sollen. Mehrere Adressen werden durch ein Leerzeichen getrennt.	Standard: leer
`request_limit_timeframe`
`rewrite`	Zeigt an, ob die automatische JavaScript-Optimierung verwendet wird. Sämtliches JavaScript wird gesammelt und am Ende der Seite ausgeführt. Dies verringert die DOM-Content-Loaded-Zeit deutlich. Wenn nicht alle JavaScript-Dateien gesammelt werden sollen, können Sie den Wert auf regex setzen und in der Option rewrite_regex die zu verwendende Regex für den Abgleich der Dateinamen angeben.	Standard: `false` Mögliche Werte: `true` `false`
`source_port`	(Verbindung) Ein Port für die Kommunikation mit der Kundeninfrastruktur über HTTP.	Standard: `80`
`source_protocol`	(Verbindung) Das für die Abfrage der Kundeninfrastruktur verwendete Protokoll: HTTP oder HTTPS.	Standard: `same` Mögliche Werte: `same` `http` `https`
`spdy`	(Verbindung) Aktiviert oder deaktiviert das leistungsstarke HTTP/2-Protokoll. Beachten Sie, dass HTTPS aktiviert sein muss, damit Myra HTTP/2 aktivieren kann.	Standard: `false` Mögliche Werte: `true` `false`
`ssl_client_certificate`	(Sicherheit) Ein vertrauenswürdiges CA-Zertifikat im PEM-Format zur Überprüfung von Client-Zertifikaten.	Standard: leer
`ssl_client_header_fingerprint`	(Sicherheit) Der Fingerprint des Zertifikats, mit dem sich der Client authentifiziert hat.	Standard: `X-MYRA-SSL-Fingerprint`
`ssl_client_header_verification`	(Sicherheit) Der Name des Headers, der den SSL-Verifizierungsstatus enthält.	Standard: `X-MYRA-SSL-VERIFIED`
`ssl_client_verify`	(Sicherheit) Aktiviert oder deaktiviert die Überprüfung von Client-Zertifikaten.	Standard: `false` Mögliche Werte: `optional` `activate` `off`
`ssl_origin_port`	(Sicherheit) Der Port für die Kommunikation mit der Kundeninfrastruktur über SSL.	Standard: `443`
`waf_enable`	(Sicherheit) Aktiviert oder deaktiviert die Web Application Firewall.	Standard: `false` Mögliche Werte: `true` `false`
`waf_levels_enable`	(Sicherheit) Ein Array der Hierarchie der WAF.	Default: `waf_tag` `waf_domain` `waf_subdomain` Mögliche Werte: `waf_tag` `waf_domain` `waf_subdomain`
`waf_policy`	(Sicherheit) Die Standardrichtlinie der Web Application Firewall im Falle eines Regelfehlers.	Standard: `allow` Mögliche Werte: `allow` `block`
`ip_lock`	(Verbindung) Aktiviert oder deaktiviert den Schutz vor versehentlichen Änderungen der Myra-IP-Adresse nach der Aktualisierung eines SSL/TLS-Zertifikats.	Standard: `true` Mögliche Werte: `true` `false`

Das System gibt das Objekt SubdomainSettingVO mit den geänderten Informationen zurück.

Beispiel¶

Beispiel-Request-Body:

{
  "accept_encoding": [
    "string"
  ],
  "access_log": true,
  "antibot_post_flood": true,
  "antibot_post_flood_threshold": 0,
  "antibot_proof_of_work": true,
  "antibot_proof_of_work_threshold": 0,
  "availability_zones": "string",
  "balancing_method": "string",
  "block_ip_by_header": "string",
  "block_not_whitelisted": true,
  "block_tor_network": true,
  "bot_block_ai_category": true,
  "bot_calc_fingerprint": true,
  "bot_customer_regex_0": "string",
  "bot_customer_regex_1": "string",
  "bot_customer_regex_2": "string",
  "bot_external_session_id": "string",
  "cache_enabled": true,
  "cache_revalidate": true,
  "cache_sort_active": true,
  "cdn": true,
  "client_max_body_size": 0,
  "comment": "string",
  "cookie_name": "string",
  "diffie_hellman_exchange": 0,
  "disable_accept_encoding": true,
  "disable_forwarded_for": true,
  "enable_origin_sni": "string",
  "enforce_cache_ttl": true,
  "forwarded_for_replacement": "string",
  "host_header": "string",
  "hsts": true,
  "hsts_include_subdomains": true,
  "hsts_max_age": 0,
  "hsts_preload": true,
  "http_origin_port": 0,
  "ignore_nocache": true,
  "image_optimization": true,
  "ip_lock": true,
  "ipv6_active": true,
  "limit_allowed_http_method": [
    "string"
  ],
  "limit_tls_version": [
    "string"
  ],
  "log_archive_format": "string",
  "log_format": "string",
  "monitoring_alert_threshold": 0,
  "monitoring_contact_email": "string",
  "monitoring_send_alert": true,
  "myra_ssl_certificate": [
    "string"
  ],
  "myra_ssl_certificate_key": [
    "string"
  ],
  "myra_ssl_header": true,
  "next_upstream": [
    "string"
  ],
  "nginx_filter": "string",
  "nginx_filter_inject_type": "string",
  "nginx_server_inject": "string",
  "nginx_server_inject_type": "string",
  "nginx_ssl_server_inject": "string",
  "nginx_ssl_server_inject_type": "string",
  "nginx_ssl_upstream_inject": "string",
  "nginx_ssl_upstream_inject_type": "string",
  "nginx_upstream_inject": "string",
  "nginx_upstream_inject_type": "string",
  "objectType": "string",
  "only_https": true,
  "origin_connection_header": "string",
  "proxy_cache_bypass": "string",
  "proxy_cache_key": "string",
  "proxy_cache_lock_age": 0,
  "proxy_cache_lock_timeout": 0,
  "proxy_cache_min_uses": 0,
  "proxy_cache_stale": [
    "string"
  ],
  "proxy_connect_timeout": 0,
  "proxy_read_timeout": 0,
  "proxy_send_timeout": 0,
  "proxy_ssl_name": "string",
  "proxy_ssl_session_reuse": true,
  "proxy_ssl_trusted_certificate": [
    "string"
  ],
  "proxy_ssl_verify": true,
  "proxy_ssl_verify_depth": 0,
  "request_limit_block": "string",
  "request_limit_level": 0,
  "request_limit_report": true,
  "request_limit_report_email": "string",
  "request_limit_timeframe": 0,
  "rewrite": true,
  "source_port": 0,
  "source_protocol": "string",
  "spdy": true,
  "ssl_client_certificate": [
    "string"
  ],
  "ssl_client_header_fingerprint": "string",
  "ssl_client_header_verification": "string",
  "ssl_client_verify": "string",
  "ssl_origin_port": 0,
  "waf_enable": true,
  "waf_levels_enable": [
    "string"
  ],
  "waf_policy": "string",
  "websocket_connection": "string"
}

Antworten¶

Die folgenden Antworten sind möglich:

STATUSCODE	BESCHREIBUNG
201	Die Anfrage war erfolgreich und ein neues Objekt wurde erstellt.
400	Die Anfrage war nicht erfolgreich. Die Anfrage war fehlerhaft oder es fehlen Informationen.
401	Die Anfrage war nicht erfolgreich, da die Authentifizierung fehlerhaft war.
403	Die Anfrage war nicht erfolgreich, da die erforderlichen Berechtigungen fehlen.