Documentation ¶
Index ¶
- Constants
- type ASN
- type ASNParam
- type AuditLog
- type AuditLogAction
- type AuditLogActor
- type AuditLogActorType
- type AuditLogOwner
- type AuditLogResource
- type CertificateCA
- type CertificateRequestType
- type CloudflareTunnel
- type CloudflareTunnelConnection
- type CloudflareTunnelStatus
- type CloudflareTunnelTunType
- type Error
- type ErrorData
- type MemberParam
- type MemberRoleParam
- type MemberRolesPermissionsParam
- type MemberStatus
- type MemberUserParam
- type Permission
- type PermissionGrant
- type PermissionGrantParam
- type RequestTracerService
- type ResponseInfo
- type Role
- type SortDirection
- type Trace
- type TraceItem
- type TraceNewParams
- type TraceNewParamsBody
- type TraceNewParamsContext
- type TraceNewParamsContextGeoloc
- type TraceNewResponse
- type TraceNewResponseEnvelope
- type TraceNewResponseEnvelopeSuccess
- type TraceService
Constants ¶
const AuditLogActorTypeAdmin = shared.AuditLogActorTypeAdmin
This is an alias to an internal value.
const AuditLogActorTypeCloudflare = shared.AuditLogActorTypeCloudflare
This is an alias to an internal value.
const AuditLogActorTypeUser = shared.AuditLogActorTypeUser
This is an alias to an internal value.
const CertificateCADigicert = shared.CertificateCADigicert
This is an alias to an internal value.
const CertificateCAGoogle = shared.CertificateCAGoogle
This is an alias to an internal value.
const CertificateCALetsEncrypt = shared.CertificateCALetsEncrypt
This is an alias to an internal value.
const CertificateRequestTypeKeylessCertificate = shared.CertificateRequestTypeKeylessCertificate
This is an alias to an internal value.
const CertificateRequestTypeOriginECC = shared.CertificateRequestTypeOriginECC
This is an alias to an internal value.
const CertificateRequestTypeOriginRSA = shared.CertificateRequestTypeOriginRSA
This is an alias to an internal value.
const CloudflareTunnelStatusDegraded = shared.CloudflareTunnelStatusDegraded
This is an alias to an internal value.
const CloudflareTunnelStatusDown = shared.CloudflareTunnelStatusDown
This is an alias to an internal value.
const CloudflareTunnelStatusHealthy = shared.CloudflareTunnelStatusHealthy
This is an alias to an internal value.
const CloudflareTunnelStatusInactive = shared.CloudflareTunnelStatusInactive
This is an alias to an internal value.
const CloudflareTunnelTunTypeCNI = shared.CloudflareTunnelTunTypeCNI
This is an alias to an internal value.
const CloudflareTunnelTunTypeCfdTunnel = shared.CloudflareTunnelTunTypeCfdTunnel
This is an alias to an internal value.
const CloudflareTunnelTunTypeGRE = shared.CloudflareTunnelTunTypeGRE
This is an alias to an internal value.
const CloudflareTunnelTunTypeIPSec = shared.CloudflareTunnelTunTypeIPSec
This is an alias to an internal value.
const CloudflareTunnelTunTypeWARPConnector = shared.CloudflareTunnelTunTypeWARPConnector
This is an alias to an internal value.
const MemberStatusAccepted = shared.MemberStatusAccepted
This is an alias to an internal value.
const MemberStatusPending = shared.MemberStatusPending
This is an alias to an internal value.
const SortDirectionAsc = shared.SortDirectionAsc
This is an alias to an internal value.
const SortDirectionDesc = shared.SortDirectionDesc
This is an alias to an internal value.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type AuditLogAction ¶
type AuditLogAction = shared.AuditLogAction
This is an alias to an internal type.
type AuditLogActor ¶
type AuditLogActor = shared.AuditLogActor
This is an alias to an internal type.
type AuditLogActorType ¶
type AuditLogActorType = shared.AuditLogActorType
The type of actor, whether a User, Cloudflare Admin, or an Automated System.
This is an alias to an internal type.
type AuditLogOwner ¶
type AuditLogOwner = shared.AuditLogOwner
This is an alias to an internal type.
type AuditLogResource ¶
type AuditLogResource = shared.AuditLogResource
This is an alias to an internal type.
type CertificateCA ¶ added in v2.2.0
type CertificateCA = shared.CertificateCA
The Certificate Authority that will issue the certificate
This is an alias to an internal type.
type CertificateRequestType ¶ added in v2.2.0
type CertificateRequestType = shared.CertificateRequestType
Signature type desired on certificate ("origin-rsa" (rsa), "origin-ecc" (ecdsa), or "keyless-certificate" (for Keyless SSL servers).
This is an alias to an internal type.
type CloudflareTunnel ¶
type CloudflareTunnel = shared.CloudflareTunnel
A Cloudflare Tunnel that connects your origin to Cloudflare's edge.
This is an alias to an internal type.
type CloudflareTunnelConnection ¶
type CloudflareTunnelConnection = shared.CloudflareTunnelConnection
This is an alias to an internal type.
type CloudflareTunnelStatus ¶ added in v2.3.0
type CloudflareTunnelStatus = shared.CloudflareTunnelStatus
The status of the tunnel. Valid values are `inactive` (tunnel has never been run), `degraded` (tunnel is active and able to serve traffic but in an unhealthy state), `healthy` (tunnel is active and able to serve traffic), or `down` (tunnel can not serve traffic as it has no connections to the Cloudflare Edge).
This is an alias to an internal type.
type CloudflareTunnelTunType ¶
type CloudflareTunnelTunType = shared.CloudflareTunnelTunType
The type of tunnel.
This is an alias to an internal type.
type MemberParam ¶ added in v2.1.0
type MemberParam = shared.MemberParam
This is an alias to an internal type.
type MemberRoleParam ¶ added in v2.1.0
type MemberRoleParam = shared.MemberRoleParam
This is an alias to an internal type.
type MemberRolesPermissionsParam ¶ added in v2.1.0
type MemberRolesPermissionsParam = shared.MemberRolesPermissionsParam
This is an alias to an internal type.
type MemberStatus ¶ added in v2.3.0
type MemberStatus = shared.MemberStatus
A member's status in the account.
This is an alias to an internal type.
type MemberUserParam ¶ added in v2.1.0
type MemberUserParam = shared.MemberUserParam
Details of the user associated to the membership.
This is an alias to an internal type.
type PermissionGrant ¶
type PermissionGrant = shared.PermissionGrant
This is an alias to an internal type.
type PermissionGrantParam ¶
type PermissionGrantParam = shared.PermissionGrantParam
This is an alias to an internal type.
type RequestTracerService ¶
type RequestTracerService struct { Options []option.RequestOption Traces *TraceService }
RequestTracerService contains methods and other services that help with interacting with the cloudflare API.
Note, unlike clients, this service does not read variables from the environment automatically. You should not instantiate this service directly, and instead use the NewRequestTracerService method instead.
func NewRequestTracerService ¶
func NewRequestTracerService(opts ...option.RequestOption) (r *RequestTracerService)
NewRequestTracerService generates a new service that applies the given options to each request. These options are applied after the parent client's options (if there is one), and before any request-specific options.
type SortDirection ¶ added in v2.2.0
type SortDirection = shared.SortDirection
Direction to order DNS records in.
This is an alias to an internal type.
type TraceItem ¶
type TraceItem struct { // If step type is rule, then action performed by this rule Action string `json:"action"` // If step type is rule, then action parameters of this rule as JSON ActionParameters interface{} `json:"action_parameters"` // If step type is rule or ruleset, the description of this entity Description string `json:"description"` // If step type is rule, then expression used to match for this rule Expression string `json:"expression"` // If step type is ruleset, then kind of this ruleset Kind string `json:"kind"` // Whether tracing step affected tracing request/response Matched bool `json:"matched"` // If step type is ruleset, then name of this ruleset Name string `json:"name"` // Tracing step identifying name StepName string `json:"step_name"` Trace Trace `json:"trace"` // Tracing step type Type string `json:"type"` JSON traceItemJSON `json:"-"` }
List of steps acting on request/response
func (*TraceItem) UnmarshalJSON ¶
type TraceNewParams ¶
type TraceNewParams struct { // Identifier AccountID param.Field[string] `path:"account_id,required"` // HTTP Method of tracing request Method param.Field[string] `json:"method,required"` // URL to which perform tracing request URL param.Field[string] `json:"url,required"` Body param.Field[TraceNewParamsBody] `json:"body"` // Additional request parameters Context param.Field[TraceNewParamsContext] `json:"context"` // Cookies added to tracing request Cookies param.Field[map[string]string] `json:"cookies"` // Headers added to tracing request Headers param.Field[map[string]string] `json:"headers"` // HTTP Protocol of tracing request Protocol param.Field[string] `json:"protocol"` // Skip sending the request to the Origin server after all rules evaluation SkipResponse param.Field[bool] `json:"skip_response"` }
func (TraceNewParams) MarshalJSON ¶
func (r TraceNewParams) MarshalJSON() (data []byte, err error)
type TraceNewParamsBody ¶
type TraceNewParamsBody struct { // Base64 encoded request body Base64 param.Field[string] `json:"base64"` // Arbitrary json as request body Json param.Field[interface{}] `json:"json"` // Request body as plain text PlainText param.Field[string] `json:"plain_text"` }
func (TraceNewParamsBody) MarshalJSON ¶
func (r TraceNewParamsBody) MarshalJSON() (data []byte, err error)
type TraceNewParamsContext ¶
type TraceNewParamsContext struct { // Bot score used for evaluating tracing request processing BotScore param.Field[int64] `json:"bot_score"` // Geodata for tracing request Geoloc param.Field[TraceNewParamsContextGeoloc] `json:"geoloc"` // Whether to skip any challenges for tracing request (e.g.: captcha) SkipChallenge param.Field[bool] `json:"skip_challenge"` // Threat score used for evaluating tracing request processing ThreatScore param.Field[int64] `json:"threat_score"` }
Additional request parameters
func (TraceNewParamsContext) MarshalJSON ¶
func (r TraceNewParamsContext) MarshalJSON() (data []byte, err error)
type TraceNewParamsContextGeoloc ¶
type TraceNewParamsContextGeoloc struct { City param.Field[string] `json:"city"` Continent param.Field[string] `json:"continent"` IsEuCountry param.Field[bool] `json:"is_eu_country"` ISOCode param.Field[string] `json:"iso_code"` Latitude param.Field[float64] `json:"latitude"` Longitude param.Field[float64] `json:"longitude"` PostalCode param.Field[string] `json:"postal_code"` RegionCode param.Field[string] `json:"region_code"` Subdivision2ISOCode param.Field[string] `json:"subdivision_2_iso_code"` Timezone param.Field[string] `json:"timezone"` }
Geodata for tracing request
func (TraceNewParamsContextGeoloc) MarshalJSON ¶
func (r TraceNewParamsContextGeoloc) MarshalJSON() (data []byte, err error)
type TraceNewResponse ¶
type TraceNewResponse struct { // HTTP Status code of zone response StatusCode int64 `json:"status_code"` Trace Trace `json:"trace"` JSON traceNewResponseJSON `json:"-"` }
Trace result with an origin status code
func (*TraceNewResponse) UnmarshalJSON ¶
func (r *TraceNewResponse) UnmarshalJSON(data []byte) (err error)
type TraceNewResponseEnvelope ¶
type TraceNewResponseEnvelope struct { Errors []shared.ResponseInfo `json:"errors,required"` Messages []shared.ResponseInfo `json:"messages,required"` // Whether the API call was successful Success TraceNewResponseEnvelopeSuccess `json:"success,required"` // Trace result with an origin status code Result TraceNewResponse `json:"result"` JSON traceNewResponseEnvelopeJSON `json:"-"` }
func (*TraceNewResponseEnvelope) UnmarshalJSON ¶
func (r *TraceNewResponseEnvelope) UnmarshalJSON(data []byte) (err error)
type TraceNewResponseEnvelopeSuccess ¶
type TraceNewResponseEnvelopeSuccess bool
Whether the API call was successful
const (
TraceNewResponseEnvelopeSuccessTrue TraceNewResponseEnvelopeSuccess = true
)
func (TraceNewResponseEnvelopeSuccess) IsKnown ¶
func (r TraceNewResponseEnvelopeSuccess) IsKnown() bool
type TraceService ¶
type TraceService struct {
Options []option.RequestOption
}
TraceService contains methods and other services that help with interacting with the cloudflare API.
Note, unlike clients, this service does not read variables from the environment automatically. You should not instantiate this service directly, and instead use the NewTraceService method instead.
func NewTraceService ¶
func NewTraceService(opts ...option.RequestOption) (r *TraceService)
NewTraceService generates a new service that applies the given options to each request. These options are applied after the parent client's options (if there is one), and before any request-specific options.
func (*TraceService) New ¶
func (r *TraceService) New(ctx context.Context, params TraceNewParams, opts ...option.RequestOption) (res *TraceNewResponse, err error)
Request Trace