Delete TLS setting for hostname

client.Hostnames.Settings.TLS.Delete(ctx, settingID, hostname, body) (*SettingTLSDeleteResponse, error)

DELETE/zones/{zone_id}/hostnames/settings/{setting_id}/{hostname}

Delete the tls setting value for the hostname.

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

Accepted Permissions (at least one required)

SSL and Certificates Write

ParametersExpand Collapse

settingID SettingTLSDeleteParamsSettingID

The TLS Setting name. The value type depends on the setting:

ciphers: value is an array of cipher suite strings (e.g., ["ECDHE-RSA-AES128-GCM-SHA256", "AES128-GCM-SHA256"]).
min_tls_version: value is a TLS version string ("1.0", "1.1", "1.2", or "1.3").
http2: value is "on" or "off".

One of the following:

const SettingTLSDeleteParamsSettingIDCiphers SettingTLSDeleteParamsSettingID = "ciphers"

const SettingTLSDeleteParamsSettingIDMinTLSVersion SettingTLSDeleteParamsSettingID = "min_tls_version"

const SettingTLSDeleteParamsSettingIDHTTP2 SettingTLSDeleteParamsSettingID = "http2"

hostname string

The hostname for which the tls settings are set.

body SettingTLSDeleteParams

ZoneID param.Field[string]

Identifier.

maxLength32

ReturnsExpand Collapse

type SettingTLSDeleteResponse struct{…}

CreatedAt TimeOptional

This is the time the tls setting was originally created for this hostname.

formatdate-time

Hostname stringOptional

The hostname for which the tls settings are set.

Status stringOptional

Deployment status for the given tls setting.

UpdatedAt TimeOptional

This is the time the tls setting was updated.

formatdate-time

Value SettingValueUnionOptional

The TLS setting value. The type depends on the setting_id used in the request path:

ciphers: an array of allowed cipher suite strings in BoringSSL format (e.g., ["ECDHE-RSA-AES128-GCM-SHA256", "AES128-GCM-SHA256"]).
min_tls_version: a string indicating the minimum TLS version — one of "1.0", "1.1", "1.2", or "1.3" (e.g., "1.2").
http2: a string indicating whether HTTP/2 is enabled — "on" or "off" (e.g., "on").

One of the following:

type SettingValueString string

One of the following:

const SettingValueString1_0 SettingValueString = "1.0"

const SettingValueString1_1 SettingValueString = "1.1"

const SettingValueString1_2 SettingValueString = "1.2"

const SettingValueString1_3 SettingValueString = "1.3"

const SettingValueStringOn SettingValueString = "on"

const SettingValueStringOff SettingValueString = "off"

type SettingValueArray []string

Used when setting_id is ciphers. An array of allowed cipher suite strings.

Delete TLS setting for hostname

package main

import (
  "context"
  "fmt"

  "github.com/stainless-sdks/cloudflare-go"
  "github.com/stainless-sdks/cloudflare-go/hostnames"
  "github.com/stainless-sdks/cloudflare-go/option"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  tls, err := client.Hostnames.Settings.TLS.Delete(
    context.TODO(),
    hostnames.SettingTLSDeleteParamsSettingIDCiphers,
    "app.example.com",
    hostnames.SettingTLSDeleteParams{
      ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", tls.CreatedAt)
}

{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "success": true,
  "result": {
    "created_at": "2023-07-10T20:01:50.219171Z",
    "hostname": "app.example.com",
    "status": "pending_deployment",
    "updated_at": "2023-07-10T20:01:50.219171Z",
    "value": [
      "ECDHE-RSA-AES128-GCM-SHA256",
      "AES128-GCM-SHA256"
    ]
  }
}

Returns Examples

{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "success": true,
  "result": {
    "created_at": "2023-07-10T20:01:50.219171Z",
    "hostname": "app.example.com",
    "status": "pending_deployment",
    "updated_at": "2023-07-10T20:01:50.219171Z",
    "value": [
      "ECDHE-RSA-AES128-GCM-SHA256",
      "AES128-GCM-SHA256"
    ]
  }
}