Update zone level schema validation settings

client.APIGateway.Settings.SchemaValidation.Update(ctx, params) (*Settings, error)

PUT/zones/{zone_id}/api_gateway/settings/schema_validation

Updates zone level schema validation settings on the zone

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)

Account API GatewayDomain API Gateway

ParametersExpand Collapse

params SettingSchemaValidationUpdateParams

ZoneID param.Field[string]

Path param: Identifier.

maxLength32

ValidationDefaultMitigationAction param.Field[SettingSchemaValidationUpdateParamsValidationDefaultMitigationAction]

Body param: The default mitigation action used when there is no mitigation action defined on the operation

Mitigation actions are as follows:

log - log request when request does not conform to schema
block - deny access to the site when request does not conform to schema

A special value of of none will skip running schema validation entirely for the request when there is no mitigation action defined on the operation

const SettingSchemaValidationUpdateParamsValidationDefaultMitigationActionNone SettingSchemaValidationUpdateParamsValidationDefaultMitigationAction = "none"

const SettingSchemaValidationUpdateParamsValidationDefaultMitigationActionLog SettingSchemaValidationUpdateParamsValidationDefaultMitigationAction = "log"

const SettingSchemaValidationUpdateParamsValidationDefaultMitigationActionBlock SettingSchemaValidationUpdateParamsValidationDefaultMitigationAction = "block"

ValidationOverrideMitigationAction param.Field[SettingSchemaValidationUpdateParamsValidationOverrideMitigationAction]Optional

Body param: When set, this overrides both zone level and operation level mitigation actions.

none will skip running schema validation entirely for the request
null indicates that no override is in place

To clear any override, use the special value disable_override or null

const SettingSchemaValidationUpdateParamsValidationOverrideMitigationActionNone SettingSchemaValidationUpdateParamsValidationOverrideMitigationAction = "none"

const SettingSchemaValidationUpdateParamsValidationOverrideMitigationActionDisableOverride SettingSchemaValidationUpdateParamsValidationOverrideMitigationAction = "disable_override"

ReturnsExpand Collapse

type Settings struct{…}

ValidationDefaultMitigationAction SettingsValidationDefaultMitigationActionOptional

The default mitigation action used when there is no mitigation action defined on the operation

Mitigation actions are as follows:

log - log request when request does not conform to schema
block - deny access to the site when request does not conform to schema

A special value of of none will skip running schema validation entirely for the request when there is no mitigation action defined on the operation

One of the following:

const SettingsValidationDefaultMitigationActionNone SettingsValidationDefaultMitigationAction = "none"

const SettingsValidationDefaultMitigationActionLog SettingsValidationDefaultMitigationAction = "log"

const SettingsValidationDefaultMitigationActionBlock SettingsValidationDefaultMitigationAction = "block"

ValidationOverrideMitigationAction SettingsValidationOverrideMitigationActionOptional

When set, this overrides both zone level and operation level mitigation actions.

none will skip running schema validation entirely for the request
null indicates that no override is in place

Update zone level schema validation settings

package main

import (
  "context"
  "fmt"

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

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  settings, err := client.APIGateway.Settings.SchemaValidation.Update(context.TODO(), api_gateway.SettingSchemaValidationUpdateParams{
    ZoneID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
    ValidationDefaultMitigationAction: cloudflare.F(api_gateway.SettingSchemaValidationUpdateParamsValidationDefaultMitigationActionBlock),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", settings.ValidationDefaultMitigationAction)
}

{
  "validation_default_mitigation_action": "block",
  "validation_override_mitigation_action": "none"
}

Returns Examples

{
  "validation_default_mitigation_action": "block",
  "validation_override_mitigation_action": "none"
}