Documentation ¶
Index ¶
- Constants
- type ASN
- type ASNParam
- type AuditLog
- type AuditLogAction
- type AuditLogActor
- type AuditLogActorType
- type AuditLogOwner
- type AuditLogResource
- type CertificateCA
- type CertificateRequestType
- type ClientCertificate
- type ClientCertificateCertificateAuthority
- type ClientCertificateDeleteParams
- type ClientCertificateDeleteResponseEnvelope
- type ClientCertificateDeleteResponseEnvelopeSuccess
- type ClientCertificateEditParams
- type ClientCertificateEditResponseEnvelope
- type ClientCertificateEditResponseEnvelopeSuccess
- type ClientCertificateGetParams
- type ClientCertificateGetResponseEnvelope
- type ClientCertificateGetResponseEnvelopeSuccess
- type ClientCertificateListParams
- type ClientCertificateListParamsStatus
- type ClientCertificateNewParams
- type ClientCertificateNewResponseEnvelope
- type ClientCertificateNewResponseEnvelopeSuccess
- type ClientCertificateService
- func (r *ClientCertificateService) Delete(ctx context.Context, clientCertificateID string, ...) (res *ClientCertificate, err error)
- func (r *ClientCertificateService) Edit(ctx context.Context, clientCertificateID string, ...) (res *ClientCertificate, err error)
- func (r *ClientCertificateService) Get(ctx context.Context, clientCertificateID string, ...) (res *ClientCertificate, err error)
- func (r *ClientCertificateService) List(ctx context.Context, params ClientCertificateListParams, ...) (res *pagination.V4PagePaginationArray[ClientCertificate], err error)
- func (r *ClientCertificateService) ListAutoPaging(ctx context.Context, params ClientCertificateListParams, ...) *pagination.V4PagePaginationArrayAutoPager[ClientCertificate]
- func (r *ClientCertificateService) New(ctx context.Context, params ClientCertificateNewParams, ...) (res *ClientCertificate, err error)
- 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 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 ClientCertificate ¶
type ClientCertificate struct { // Identifier ID string `json:"id"` // The Client Certificate PEM Certificate string `json:"certificate"` // Certificate Authority used to issue the Client Certificate CertificateAuthority ClientCertificateCertificateAuthority `json:"certificate_authority"` // Common Name of the Client Certificate CommonName string `json:"common_name"` // Country, provided by the CSR Country string `json:"country"` // The Certificate Signing Request (CSR). Must be newline-encoded. Csr string `json:"csr"` // Date that the Client Certificate expires ExpiresOn string `json:"expires_on"` // Unique identifier of the Client Certificate FingerprintSha256 string `json:"fingerprint_sha256"` // Date that the Client Certificate was issued by the Certificate Authority IssuedOn string `json:"issued_on"` // Location, provided by the CSR Location string `json:"location"` // Organization, provided by the CSR Organization string `json:"organization"` // Organizational Unit, provided by the CSR OrganizationalUnit string `json:"organizational_unit"` // The serial number on the created Client Certificate. SerialNumber string `json:"serial_number"` // The type of hash used for the Client Certificate.. Signature string `json:"signature"` // Subject Key Identifier Ski string `json:"ski"` // State, provided by the CSR State string `json:"state"` // Client Certificates may be active or revoked, and the pending_reactivation or // pending_revocation represent in-progress asynchronous transitions Status custom_certificates.Status `json:"status"` // The number of days the Client Certificate will be valid after the issued_on date ValidityDays int64 `json:"validity_days"` JSON clientCertificateJSON `json:"-"` }
func (*ClientCertificate) UnmarshalJSON ¶
func (r *ClientCertificate) UnmarshalJSON(data []byte) (err error)
type ClientCertificateCertificateAuthority ¶
type ClientCertificateCertificateAuthority struct { ID string `json:"id"` Name string `json:"name"` JSON clientCertificateCertificateAuthorityJSON `json:"-"` }
Certificate Authority used to issue the Client Certificate
func (*ClientCertificateCertificateAuthority) UnmarshalJSON ¶
func (r *ClientCertificateCertificateAuthority) UnmarshalJSON(data []byte) (err error)
type ClientCertificateDeleteResponseEnvelope ¶
type ClientCertificateDeleteResponseEnvelope struct { Errors []shared.ResponseInfo `json:"errors,required"` Messages []shared.ResponseInfo `json:"messages,required"` // Whether the API call was successful Success ClientCertificateDeleteResponseEnvelopeSuccess `json:"success,required"` Result ClientCertificate `json:"result"` JSON clientCertificateDeleteResponseEnvelopeJSON `json:"-"` }
func (*ClientCertificateDeleteResponseEnvelope) UnmarshalJSON ¶
func (r *ClientCertificateDeleteResponseEnvelope) UnmarshalJSON(data []byte) (err error)
type ClientCertificateDeleteResponseEnvelopeSuccess ¶
type ClientCertificateDeleteResponseEnvelopeSuccess bool
Whether the API call was successful
const (
ClientCertificateDeleteResponseEnvelopeSuccessTrue ClientCertificateDeleteResponseEnvelopeSuccess = true
)
func (ClientCertificateDeleteResponseEnvelopeSuccess) IsKnown ¶
func (r ClientCertificateDeleteResponseEnvelopeSuccess) IsKnown() bool
type ClientCertificateEditResponseEnvelope ¶
type ClientCertificateEditResponseEnvelope struct { Errors []shared.ResponseInfo `json:"errors,required"` Messages []shared.ResponseInfo `json:"messages,required"` // Whether the API call was successful Success ClientCertificateEditResponseEnvelopeSuccess `json:"success,required"` Result ClientCertificate `json:"result"` JSON clientCertificateEditResponseEnvelopeJSON `json:"-"` }
func (*ClientCertificateEditResponseEnvelope) UnmarshalJSON ¶
func (r *ClientCertificateEditResponseEnvelope) UnmarshalJSON(data []byte) (err error)
type ClientCertificateEditResponseEnvelopeSuccess ¶
type ClientCertificateEditResponseEnvelopeSuccess bool
Whether the API call was successful
const (
ClientCertificateEditResponseEnvelopeSuccessTrue ClientCertificateEditResponseEnvelopeSuccess = true
)
func (ClientCertificateEditResponseEnvelopeSuccess) IsKnown ¶
func (r ClientCertificateEditResponseEnvelopeSuccess) IsKnown() bool
type ClientCertificateGetResponseEnvelope ¶
type ClientCertificateGetResponseEnvelope struct { Errors []shared.ResponseInfo `json:"errors,required"` Messages []shared.ResponseInfo `json:"messages,required"` // Whether the API call was successful Success ClientCertificateGetResponseEnvelopeSuccess `json:"success,required"` Result ClientCertificate `json:"result"` JSON clientCertificateGetResponseEnvelopeJSON `json:"-"` }
func (*ClientCertificateGetResponseEnvelope) UnmarshalJSON ¶
func (r *ClientCertificateGetResponseEnvelope) UnmarshalJSON(data []byte) (err error)
type ClientCertificateGetResponseEnvelopeSuccess ¶
type ClientCertificateGetResponseEnvelopeSuccess bool
Whether the API call was successful
const (
ClientCertificateGetResponseEnvelopeSuccessTrue ClientCertificateGetResponseEnvelopeSuccess = true
)
func (ClientCertificateGetResponseEnvelopeSuccess) IsKnown ¶
func (r ClientCertificateGetResponseEnvelopeSuccess) IsKnown() bool
type ClientCertificateListParams ¶
type ClientCertificateListParams struct { // Identifier ZoneID param.Field[string] `path:"zone_id,required"` // Limit to the number of records returned. Limit param.Field[int64] `query:"limit"` // Offset the results Offset param.Field[int64] `query:"offset"` // Page number of paginated results. Page param.Field[float64] `query:"page"` // Number of records per page. PerPage param.Field[float64] `query:"per_page"` // Client Certitifcate Status to filter results by. Status param.Field[ClientCertificateListParamsStatus] `query:"status"` }
func (ClientCertificateListParams) URLQuery ¶
func (r ClientCertificateListParams) URLQuery() (v url.Values)
URLQuery serializes ClientCertificateListParams's query parameters as `url.Values`.
type ClientCertificateListParamsStatus ¶
type ClientCertificateListParamsStatus string
Client Certitifcate Status to filter results by.
const ( ClientCertificateListParamsStatusAll ClientCertificateListParamsStatus = "all" ClientCertificateListParamsStatusActive ClientCertificateListParamsStatus = "active" ClientCertificateListParamsStatusPendingReactivation ClientCertificateListParamsStatus = "pending_reactivation" ClientCertificateListParamsStatusPendingRevocation ClientCertificateListParamsStatus = "pending_revocation" ClientCertificateListParamsStatusRevoked ClientCertificateListParamsStatus = "revoked" )
func (ClientCertificateListParamsStatus) IsKnown ¶
func (r ClientCertificateListParamsStatus) IsKnown() bool
type ClientCertificateNewParams ¶
type ClientCertificateNewParams struct { // Identifier ZoneID param.Field[string] `path:"zone_id,required"` // The Certificate Signing Request (CSR). Must be newline-encoded. Csr param.Field[string] `json:"csr,required"` // The number of days the Client Certificate will be valid after the issued_on date ValidityDays param.Field[int64] `json:"validity_days,required"` }
func (ClientCertificateNewParams) MarshalJSON ¶
func (r ClientCertificateNewParams) MarshalJSON() (data []byte, err error)
type ClientCertificateNewResponseEnvelope ¶
type ClientCertificateNewResponseEnvelope struct { Errors []shared.ResponseInfo `json:"errors,required"` Messages []shared.ResponseInfo `json:"messages,required"` // Whether the API call was successful Success ClientCertificateNewResponseEnvelopeSuccess `json:"success,required"` Result ClientCertificate `json:"result"` JSON clientCertificateNewResponseEnvelopeJSON `json:"-"` }
func (*ClientCertificateNewResponseEnvelope) UnmarshalJSON ¶
func (r *ClientCertificateNewResponseEnvelope) UnmarshalJSON(data []byte) (err error)
type ClientCertificateNewResponseEnvelopeSuccess ¶
type ClientCertificateNewResponseEnvelopeSuccess bool
Whether the API call was successful
const (
ClientCertificateNewResponseEnvelopeSuccessTrue ClientCertificateNewResponseEnvelopeSuccess = true
)
func (ClientCertificateNewResponseEnvelopeSuccess) IsKnown ¶
func (r ClientCertificateNewResponseEnvelopeSuccess) IsKnown() bool
type ClientCertificateService ¶
type ClientCertificateService struct {
Options []option.RequestOption
}
ClientCertificateService 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 NewClientCertificateService method instead.
func NewClientCertificateService ¶
func NewClientCertificateService(opts ...option.RequestOption) (r *ClientCertificateService)
NewClientCertificateService 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 (*ClientCertificateService) Delete ¶
func (r *ClientCertificateService) Delete(ctx context.Context, clientCertificateID string, body ClientCertificateDeleteParams, opts ...option.RequestOption) (res *ClientCertificate, err error)
Set a API Shield mTLS Client Certificate to pending_revocation status for processing to revoked status.
func (*ClientCertificateService) Edit ¶
func (r *ClientCertificateService) Edit(ctx context.Context, clientCertificateID string, body ClientCertificateEditParams, opts ...option.RequestOption) (res *ClientCertificate, err error)
If a API Shield mTLS Client Certificate is in a pending_revocation state, you may reactivate it with this endpoint.
func (*ClientCertificateService) Get ¶
func (r *ClientCertificateService) Get(ctx context.Context, clientCertificateID string, query ClientCertificateGetParams, opts ...option.RequestOption) (res *ClientCertificate, err error)
Get Details for a single mTLS API Shield Client Certificate
func (*ClientCertificateService) List ¶
func (r *ClientCertificateService) List(ctx context.Context, params ClientCertificateListParams, opts ...option.RequestOption) (res *pagination.V4PagePaginationArray[ClientCertificate], err error)
List all of your Zone's API Shield mTLS Client Certificates by Status and/or using Pagination
func (*ClientCertificateService) ListAutoPaging ¶
func (r *ClientCertificateService) ListAutoPaging(ctx context.Context, params ClientCertificateListParams, opts ...option.RequestOption) *pagination.V4PagePaginationArrayAutoPager[ClientCertificate]
List all of your Zone's API Shield mTLS Client Certificates by Status and/or using Pagination
func (*ClientCertificateService) New ¶
func (r *ClientCertificateService) New(ctx context.Context, params ClientCertificateNewParams, opts ...option.RequestOption) (res *ClientCertificate, err error)
Create a new API Shield mTLS Client Certificate
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 SortDirection ¶ added in v2.2.0
type SortDirection = shared.SortDirection
Direction to order DNS records in.
This is an alias to an internal type.