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 FilterDeleteResponseEnvelope
- type FilterDeleteResponseEnvelopeSuccess
- type FilterGetResponseEnvelope
- type FilterGetResponseEnvelopeSuccess
- type FilterListParams
- type FilterNewParams
- type FilterNewResponseEnvelope
- type FilterNewResponseEnvelopeResultInfo
- type FilterNewResponseEnvelopeSuccess
- type FilterService
- func (r *FilterService) Delete(ctx context.Context, zoneIdentifier string, id string, ...) (res *FirewallFilter, err error)deprecated
- func (r *FilterService) Get(ctx context.Context, zoneIdentifier string, id string, ...) (res *FirewallFilter, err error)deprecated
- func (r *FilterService) List(ctx context.Context, zoneIdentifier string, query FilterListParams, ...) (res *pagination.V4PagePaginationArray[FirewallFilter], err error)deprecated
- func (r *FilterService) ListAutoPaging(ctx context.Context, zoneIdentifier string, query FilterListParams, ...) *pagination.V4PagePaginationArrayAutoPager[FirewallFilter]deprecated
- func (r *FilterService) New(ctx context.Context, zoneIdentifier string, body FilterNewParams, ...) (res *[]FirewallFilter, err error)deprecated
- func (r *FilterService) Update(ctx context.Context, zoneIdentifier string, id string, body FilterUpdateParams, ...) (res *FirewallFilter, err error)deprecated
- type FilterUpdateParams
- type FilterUpdateResponseEnvelope
- type FilterUpdateResponseEnvelopeSuccess
- type FirewallFilter
- type MemberParam
- type MemberRoleParam
- type MemberRolesPermissionsParam
- type MemberStatus
- type MemberUserParam
- type Permission
- type PermissionGrant
- type PermissionGrantParam
- type ResponseInfo
- type Role
- type SortDirection
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 FilterDeleteResponseEnvelope ¶
type FilterDeleteResponseEnvelope struct { Errors []shared.ResponseInfo `json:"errors,required"` Messages []shared.ResponseInfo `json:"messages,required"` Result FirewallFilter `json:"result,required"` // Whether the API call was successful Success FilterDeleteResponseEnvelopeSuccess `json:"success,required"` JSON filterDeleteResponseEnvelopeJSON `json:"-"` }
func (*FilterDeleteResponseEnvelope) UnmarshalJSON ¶
func (r *FilterDeleteResponseEnvelope) UnmarshalJSON(data []byte) (err error)
type FilterDeleteResponseEnvelopeSuccess ¶
type FilterDeleteResponseEnvelopeSuccess bool
Whether the API call was successful
const (
FilterDeleteResponseEnvelopeSuccessTrue FilterDeleteResponseEnvelopeSuccess = true
)
func (FilterDeleteResponseEnvelopeSuccess) IsKnown ¶
func (r FilterDeleteResponseEnvelopeSuccess) IsKnown() bool
type FilterGetResponseEnvelope ¶
type FilterGetResponseEnvelope struct { Errors []shared.ResponseInfo `json:"errors,required"` Messages []shared.ResponseInfo `json:"messages,required"` Result FirewallFilter `json:"result,required"` // Whether the API call was successful Success FilterGetResponseEnvelopeSuccess `json:"success,required"` JSON filterGetResponseEnvelopeJSON `json:"-"` }
func (*FilterGetResponseEnvelope) UnmarshalJSON ¶
func (r *FilterGetResponseEnvelope) UnmarshalJSON(data []byte) (err error)
type FilterGetResponseEnvelopeSuccess ¶
type FilterGetResponseEnvelopeSuccess bool
Whether the API call was successful
const (
FilterGetResponseEnvelopeSuccessTrue FilterGetResponseEnvelopeSuccess = true
)
func (FilterGetResponseEnvelopeSuccess) IsKnown ¶
func (r FilterGetResponseEnvelopeSuccess) IsKnown() bool
type FilterListParams ¶
type FilterListParams struct { // The unique identifier of the filter. ID param.Field[string] `query:"id"` // A case-insensitive string to find in the description. Description param.Field[string] `query:"description"` // A case-insensitive string to find in the expression. Expression param.Field[string] `query:"expression"` // Page number of paginated results. Page param.Field[float64] `query:"page"` // When true, indicates that the filter is currently paused. Paused param.Field[bool] `query:"paused"` // Number of filters per page. PerPage param.Field[float64] `query:"per_page"` // The filter ref (a short reference tag) to search for. Must be an exact match. Ref param.Field[string] `query:"ref"` }
func (FilterListParams) URLQuery ¶
func (r FilterListParams) URLQuery() (v url.Values)
URLQuery serializes FilterListParams's query parameters as `url.Values`.
type FilterNewParams ¶
type FilterNewParams struct {
Body interface{} `json:"body,required"`
}
func (FilterNewParams) MarshalJSON ¶
func (r FilterNewParams) MarshalJSON() (data []byte, err error)
type FilterNewResponseEnvelope ¶
type FilterNewResponseEnvelope struct { Errors []shared.ResponseInfo `json:"errors,required"` Messages []shared.ResponseInfo `json:"messages,required"` Result []FirewallFilter `json:"result,required,nullable"` // Whether the API call was successful Success FilterNewResponseEnvelopeSuccess `json:"success,required"` ResultInfo FilterNewResponseEnvelopeResultInfo `json:"result_info"` JSON filterNewResponseEnvelopeJSON `json:"-"` }
func (*FilterNewResponseEnvelope) UnmarshalJSON ¶
func (r *FilterNewResponseEnvelope) UnmarshalJSON(data []byte) (err error)
type FilterNewResponseEnvelopeResultInfo ¶
type FilterNewResponseEnvelopeResultInfo struct { // Total number of results for the requested service Count float64 `json:"count"` // Current page within paginated list of results Page float64 `json:"page"` // Number of results per page of results PerPage float64 `json:"per_page"` // Total results available without any search parameters TotalCount float64 `json:"total_count"` JSON filterNewResponseEnvelopeResultInfoJSON `json:"-"` }
func (*FilterNewResponseEnvelopeResultInfo) UnmarshalJSON ¶
func (r *FilterNewResponseEnvelopeResultInfo) UnmarshalJSON(data []byte) (err error)
type FilterNewResponseEnvelopeSuccess ¶
type FilterNewResponseEnvelopeSuccess bool
Whether the API call was successful
const (
FilterNewResponseEnvelopeSuccessTrue FilterNewResponseEnvelopeSuccess = true
)
func (FilterNewResponseEnvelopeSuccess) IsKnown ¶
func (r FilterNewResponseEnvelopeSuccess) IsKnown() bool
type FilterService ¶
type FilterService struct {
Options []option.RequestOption
}
FilterService 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 NewFilterService method instead.
func NewFilterService ¶
func NewFilterService(opts ...option.RequestOption) (r *FilterService)
NewFilterService 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 (*FilterService) Delete
deprecated
func (r *FilterService) Delete(ctx context.Context, zoneIdentifier string, id string, opts ...option.RequestOption) (res *FirewallFilter, err error)
Deletes an existing filter.
Deprecated: The Filters API is deprecated in favour of using the Ruleset Engine. See https://developers.cloudflare.com/fundamentals/api/reference/deprecations/#firewall-rules-api-and-filters-api for full details.
func (*FilterService) Get
deprecated
func (r *FilterService) Get(ctx context.Context, zoneIdentifier string, id string, opts ...option.RequestOption) (res *FirewallFilter, err error)
Fetches the details of a filter.
Deprecated: The Filters API is deprecated in favour of using the Ruleset Engine. See https://developers.cloudflare.com/fundamentals/api/reference/deprecations/#firewall-rules-api-and-filters-api for full details.
func (*FilterService) List
deprecated
func (r *FilterService) List(ctx context.Context, zoneIdentifier string, query FilterListParams, opts ...option.RequestOption) (res *pagination.V4PagePaginationArray[FirewallFilter], err error)
Fetches filters in a zone. You can filter the results using several optional parameters.
Deprecated: The Filters API is deprecated in favour of using the Ruleset Engine. See https://developers.cloudflare.com/fundamentals/api/reference/deprecations/#firewall-rules-api-and-filters-api for full details.
func (*FilterService) ListAutoPaging
deprecated
func (r *FilterService) ListAutoPaging(ctx context.Context, zoneIdentifier string, query FilterListParams, opts ...option.RequestOption) *pagination.V4PagePaginationArrayAutoPager[FirewallFilter]
Fetches filters in a zone. You can filter the results using several optional parameters.
Deprecated: The Filters API is deprecated in favour of using the Ruleset Engine. See https://developers.cloudflare.com/fundamentals/api/reference/deprecations/#firewall-rules-api-and-filters-api for full details.
func (*FilterService) New
deprecated
func (r *FilterService) New(ctx context.Context, zoneIdentifier string, body FilterNewParams, opts ...option.RequestOption) (res *[]FirewallFilter, err error)
Creates one or more filters.
Deprecated: The Filters API is deprecated in favour of using the Ruleset Engine. See https://developers.cloudflare.com/fundamentals/api/reference/deprecations/#firewall-rules-api-and-filters-api for full details.
func (*FilterService) Update
deprecated
func (r *FilterService) Update(ctx context.Context, zoneIdentifier string, id string, body FilterUpdateParams, opts ...option.RequestOption) (res *FirewallFilter, err error)
Updates an existing filter.
Deprecated: The Filters API is deprecated in favour of using the Ruleset Engine. See https://developers.cloudflare.com/fundamentals/api/reference/deprecations/#firewall-rules-api-and-filters-api for full details.
type FilterUpdateParams ¶
type FilterUpdateParams struct {
Body interface{} `json:"body,required"`
}
func (FilterUpdateParams) MarshalJSON ¶
func (r FilterUpdateParams) MarshalJSON() (data []byte, err error)
type FilterUpdateResponseEnvelope ¶
type FilterUpdateResponseEnvelope struct { Errors []shared.ResponseInfo `json:"errors,required"` Messages []shared.ResponseInfo `json:"messages,required"` Result FirewallFilter `json:"result,required"` // Whether the API call was successful Success FilterUpdateResponseEnvelopeSuccess `json:"success,required"` JSON filterUpdateResponseEnvelopeJSON `json:"-"` }
func (*FilterUpdateResponseEnvelope) UnmarshalJSON ¶
func (r *FilterUpdateResponseEnvelope) UnmarshalJSON(data []byte) (err error)
type FilterUpdateResponseEnvelopeSuccess ¶
type FilterUpdateResponseEnvelopeSuccess bool
Whether the API call was successful
const (
FilterUpdateResponseEnvelopeSuccessTrue FilterUpdateResponseEnvelopeSuccess = true
)
func (FilterUpdateResponseEnvelopeSuccess) IsKnown ¶
func (r FilterUpdateResponseEnvelopeSuccess) IsKnown() bool
type FirewallFilter ¶
type FirewallFilter struct { // The unique identifier of the filter. ID string `json:"id"` // An informative summary of the filter. Description string `json:"description"` // The filter expression. For more information, refer to // [Expressions](https://developers.cloudflare.com/ruleset-engine/rules-language/expressions/). Expression string `json:"expression"` // When true, indicates that the filter is currently paused. Paused bool `json:"paused"` // A short reference tag. Allows you to select related filters. Ref string `json:"ref"` JSON firewallFilterJSON `json:"-"` }
func (FirewallFilter) ImplementsFirewallFirewallRuleFilter ¶ added in v2.2.0
func (r FirewallFilter) ImplementsFirewallFirewallRuleFilter()
func (*FirewallFilter) UnmarshalJSON ¶
func (r *FirewallFilter) UnmarshalJSON(data []byte) (err error)
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 SortDirection ¶ added in v2.2.0
type SortDirection = shared.SortDirection
Direction to order DNS records in.
This is an alias to an internal type.