Scaleway logo
Edge Services API

google.type.Money

currency_code
​string
units
​integer · int64
nanos
​integer · int32

scaleway.edge_services.v1beta1.AddRouteRulesResponse

List of rules to be checked against every HTTP request. The first matching rule will forward the request to its specified backend stage. If no rules are matched, the request is forwarded to the stage defined by waf_stage_id or backend_stage_id.

scaleway.edge_services.v1beta1.BackendStage

id
​string

ID of the backend stage.

pipeline_id
​string

Pipeline ID the backend stage belongs to.

status
​scaleway.edge_services.v1beta1.StageStatus · enum

Current status of the stage.

Enum values:
unknown_status
inactive
active
Default: unknown_status
created_at
​string | null · date-time

Date the backend stage was created. (RFC 3339 format)

updated_at
​string | null · date-time

Date the backend stage was last updated. (RFC 3339 format)

​

Scaleway Object Storage origin bucket (S3) linked to the backend stage.

​

Scaleway Load Balancer origin linked to the backend stage.

​

Scaleway Serverless container origin linked to the backend stage.

​

Scaleway Serverless function origin linked to the backend stage.

scaleway.edge_services.v1beta1.CacheStage

id
​string

ID of the cache stage.

pipeline_id
​string

Pipeline ID the cache stage belongs to.

fallback_ttl
​string | null

Time To Live (TTL) in seconds. Defines how long content is cached. (in seconds)

include_cookies
​boolean

Defines whether responses to requests with cookies must be stored in the cache.

status
​scaleway.edge_services.v1beta1.StageStatus · enum

Current status of the stage.

Enum values:
unknown_status
inactive
active
Default: unknown_status
created_at
​string | null · date-time

Date the cache stage was created. (RFC 3339 format)

updated_at
​string | null · date-time

Date the cache stage was last updated. (RFC 3339 format)

waf_stage_id
​string | null

(UUID format)

backend_stage_id
​string | null

Backend stage ID the cache stage is linked to. (UUID format)

route_stage_id
​string | null

(UUID format)

scaleway.edge_services.v1beta1.DNSStage

id
​string

ID of the DNS stage.

default_fqdn
​string

Default Fully Qualified Domain Name provided for the Pipeline.

fqdns
​string[]

Custom Fully Qualified Domain Names configured (only the first one is valid).

Type of the stage.

Enum values:
unknown_type
auto
managed
custom
Default: unknown_type
pipeline_id
​string

Pipeline ID the DNS stage belongs to.

status
​scaleway.edge_services.v1beta1.StageStatus · enum

Current status of the stage.

Enum values:
unknown_status
inactive
active
Default: unknown_status
created_at
​string | null · date-time

Date the DNS stage was created. (RFC 3339 format)

updated_at
​string | null · date-time

Date the DNS stage was last updated. (RFC 3339 format)

tls_stage_id
​string | null

TLS stage ID the DNS stage is linked to. (UUID format)

cache_stage_id
​string | null

Cache stage ID the DNS stage is linked to. (UUID format)

backend_stage_id
​string | null

Backend stage ID the DNS stage is linked to. (UUID format)

wildcard_domain
​boolean

Support of wildcard (subdomains) for the given domain (a wildcard certificate is required to make it work).

scaleway.edge_services.v1beta1.DNSStage.Type

string · enum
Enum values:
unknown_type
auto
managed
custom
Default: unknown_type

scaleway.edge_services.v1beta1.GetBillingResponse

Information on the currently-selected, active Edge Services subscription plan.

​google.type.Money

Cost to date (this month) for Edge Service subscription plans. This comprises the pro-rata cost of the current subscription plan, and any previous subscription plans that were active earlier in the month.

pipeline_number
​integer · uint32

Total number of pipelines currently configured.

​google.type.Money

Cost to date (this month) of pipelines not included in the subscription plans.

current_plan_cache_usage
​integer · uint64

Total amount of data egressed from the cache in gigabytes from the beginning of the month, for the active subscription plan.

extra_cache_usage
​integer · uint64

Total amount of extra data egressed from cache in gigabytes from the beginning of the month, not included in the subscription plans.

​google.type.Money

Cost to date (this month) of the data egressed from the cache that is not included in the subscription plans.

current_plan_waf_usage
​integer · uint64

Total number of requests processed by the WAF since the beginning of the current month, for the active subscription plan.

extra_waf_usage
​integer · uint64

Total number of extra requests processed by the WAF from the beginning of the month, not included in the subscription plans.

​google.type.Money

Cost to date (this month) of the extra requests processed by the WAF that were not included in the subscription plans.

​google.type.Money

Cost of activating WAF add-on (where subscription plan does not include WAF).

​object

Detailed costs and usage for all Edge Services subscription plans that were activated during the month.

​google.type.Money

Total cost to date (this month) of all Edge Services resources including active subscription plan, previously active plans, extra pipelines and extra egress cache data.

scaleway.edge_services.v1beta1.HeadStageResponse

Modified or created head stage.

scaleway.edge_services.v1beta1.HeadStageResponse.HeadStage

dns_stage_id
​string | null

(UUID format)

scaleway.edge_services.v1beta1.ListBackendStagesRequest.OrderBy

string · enum
Enum values:
created_at_asc
created_at_desc
Default: created_at_asc

scaleway.edge_services.v1beta1.ListBackendStagesResponse

Paginated list of backend stages.

total_count
​integer · uint64

Count of all backend stages matching the requested criteria.

scaleway.edge_services.v1beta1.ListCacheStagesRequest.OrderBy

string · enum
Enum values:
created_at_asc
created_at_desc
Default: created_at_asc

scaleway.edge_services.v1beta1.ListCacheStagesResponse

Paginated list of cache stages.

total_count
​integer · uint64

Count of all cache stages matching the requested criteria.

scaleway.edge_services.v1beta1.ListDNSStagesRequest.OrderBy

string · enum
Enum values:
created_at_asc
created_at_desc
Default: created_at_asc

scaleway.edge_services.v1beta1.ListDNSStagesResponse

Paginated list of DNS stages.

total_count
​integer · uint64

Count of all DNS stages matching the requested criteria.

scaleway.edge_services.v1beta1.ListHeadStagesResponse

Number of head stages to return per page.

total_count
​integer · uint64

Count of all head stages matching the requested pipeline_id.

scaleway.edge_services.v1beta1.ListHeadStagesResponse.HeadStage

dns_stage_id
​string | null

(UUID format)

scaleway.edge_services.v1beta1.ListNodesResponse

total_count
​integer · uint64

scaleway.edge_services.v1beta1.ListPipelinesRequest.OrderBy

string · enum
Enum values:
created_at_asc
created_at_desc
name_asc
name_desc
Default: created_at_asc

scaleway.edge_services.v1beta1.ListPipelinesResponse

Paginated list of pipelines.

total_count
​integer · uint64

Count of all pipelines matching the requested criteria.

scaleway.edge_services.v1beta1.ListPlansResponse

total_count
​integer · uint64

scaleway.edge_services.v1beta1.ListPurgeRequestsRequest.OrderBy

string · enum
Enum values:
created_at_asc
created_at_desc
Default: created_at_asc

scaleway.edge_services.v1beta1.ListPurgeRequestsResponse

Paginated list of purge requests.

total_count
​integer · uint64

Count of all purge requests matching the requested criteria.

scaleway.edge_services.v1beta1.ListRouteRulesResponse

List of rules to be checked against every HTTP request. The first matching rule will forward the request to its specified backend stage. If no rules are matched, the request is forwarded to the stage defined by waf_stage_id or backend_stage_id.

total_count
​integer · uint64

Count of all route rules matching the requested criteria.

scaleway.edge_services.v1beta1.ListRouteStagesRequest.OrderBy

string · enum
Enum values:
created_at_asc
created_at_desc
Default: created_at_asc

scaleway.edge_services.v1beta1.ListRouteStagesResponse

Paginated list of summarized route stages.

total_count
​integer · uint64

Count of all route stages matching the requested criteria.

scaleway.edge_services.v1beta1.ListTLSStagesRequest.OrderBy

string · enum
Enum values:
created_at_asc
created_at_desc
Default: created_at_asc

scaleway.edge_services.v1beta1.ListTLSStagesResponse

Paginated list of TLS stages.

total_count
​integer · uint64

Count of all TLS stages matching the requested criteria.

scaleway.edge_services.v1beta1.ListWafStagesRequest.OrderBy

string · enum
Enum values:
created_at_asc
created_at_desc
Default: created_at_asc

scaleway.edge_services.v1beta1.ListWafStagesResponse

Paginated list of WAF stages.

total_count
​integer · uint64

Count of all WAF stages matching the requested criteria.

scaleway.edge_services.v1beta1.Node

ip
​string

(IP address)

scaleway.edge_services.v1beta1.Pipeline

id
​string

ID of the pipeline.

name
​string

Name of the pipeline.

description
​string

Description of the pipeline.

Status of the pipeline.

Enum values:
unknown_status
ready
error
pending
warning
locked
Default: unknown_status

Errors of the pipeline.

project_id
​string

Project ID of the pipeline. (UUID format)

organization_id
​string

Organization ID of the pipeline.

created_at
​string | null · date-time

Date the pipeline was created. (RFC 3339 format)

updated_at
​string | null · date-time

Date the pipeline was last updated. (RFC 3339 format)

scaleway.edge_services.v1beta1.Pipeline.Error

Enum values:
unknown_stage
dns
tls
cache
backend
Default: unknown_stage
Enum values:
unknown_code
dns_invalid_format
dns_invalid_tld
dns_forbidden_root_domain
dns_forbidden_scw_cloud
dns_domain_dont_exist
dns_cname_dont_exist
dns_cname_resolve
Default: unknown_code
Enum values:
unknown_severity
warning
critical
Default: unknown_severity
message
​string
Enum values:
unknown_type
runtime
config
Default: unknown_type

scaleway.edge_services.v1beta1.Pipeline.Error.Code

string · enum
Enum values:
unknown_code
dns_invalid_format
dns_invalid_tld
dns_forbidden_root_domain
dns_forbidden_scw_cloud
dns_domain_dont_exist
dns_cname_dont_exist
dns_cname_resolve
Default: unknown_code

scaleway.edge_services.v1beta1.Pipeline.Error.Severity

string · enum
Enum values:
unknown_severity
warning
critical
Default: unknown_severity

scaleway.edge_services.v1beta1.Pipeline.Error.Stage

string · enum
Enum values:
unknown_stage
dns
tls
cache
backend
Default: unknown_stage

scaleway.edge_services.v1beta1.Pipeline.Error.Type

string · enum
Enum values:
unknown_type
runtime
config
Default: unknown_type

scaleway.edge_services.v1beta1.Pipeline.Status

string · enum
Enum values:
unknown_status
ready
error
pending
warning
locked
Default: unknown_status

scaleway.edge_services.v1beta1.Plan

plan_name
​scaleway.edge_services.v1beta1.Plan.Name · enum
Enum values:
unknown_name
starter
professional
advanced
Default: unknown_name

scaleway.edge_services.v1beta1.Plan.Name

string · enum
Enum values:
unknown_name
starter
professional
advanced
Default: unknown_name

scaleway.edge_services.v1beta1.PlanDetails

plan_name
​scaleway.edge_services.v1beta1.Plan.Name · enum

Subscription plan name.

Enum values:
unknown_name
starter
professional
advanced
Default: unknown_name
package_gb
​integer · uint64

Amount of egress data from cache included in subscription plan.

pipeline_limit
​integer · uint32

Number of pipelines included in subscription plan.

waf_requests
​integer · uint64

Number of WAF requests included in subscription plan.

backend_limit
​integer · uint64

Number of backends per pipeline included in subscription plan.

wildcard_domain
​boolean

Support of wildcard subdomains for the customized domain.

scaleway.edge_services.v1beta1.PlanUsageDetails

​google.type.Money

Cost to date (this month) for the corresponding Edge Services subscription plan.

scaleway.edge_services.v1beta1.PurgeRequest

id
​string

ID of the purge request. (UUID format)

pipeline_id
​string

Pipeline ID the purge request belongs to. (UUID format)

Status of the purge request.

Enum values:
unknown_status
done
error
pending
Default: unknown_status
assets
​array | null

List of asserts to purge.

all
​boolean | null

Defines whether to purge all content.

created_at
​string | null · date-time

Date the purge request was created. (RFC 3339 format)

updated_at
​string | null · date-time

Date the purge request was last updated. (RFC 3339 format)

scaleway.edge_services.v1beta1.PurgeRequest.Status

string · enum
Enum values:
unknown_status
done
error
pending
Default: unknown_status

scaleway.edge_services.v1beta1.RouteRule

​

Rule condition to be matched. Requests matching the condition defined here will be directly forwarded to the backend specified by the backend_stage_id or waf_stage_id fields. Requests that do not match will be checked by the next rule's condition.

backend_stage_id
​string | null

ID of the backend stage that requests matching the rule should be forwarded to. (UUID format)

position
​integer · int32

Position of the rule which determines the order of processing within the route stage.

route_stage_id
​string

Route stage ID the route rule belongs to.

waf_stage_id
​string | null

ID of the WAF stage that requests matching the rule should be forwarded to. (UUID format)

scaleway.edge_services.v1beta1.RouteStage

id
​string

ID of the route stage.

pipeline_id
​string

Pipeline ID the route stage belongs to.

waf_stage_id
​string | null

ID of the WAF stage HTTP requests should be forwarded to when no rules are matched. (UUID format)

backend_stage_id
​string | null

ID of the backend stage HTTP requests should be forwarded to when no rules are matched. (UUID format)

status
​scaleway.edge_services.v1beta1.StageStatus · enum

Current status of the stage.

Enum values:
unknown_status
inactive
active
Default: unknown_status
created_at
​string | null · date-time

Date the route stage was created. (RFC 3339 format)

updated_at
​string | null · date-time

Date the route stage was last updated. (RFC 3339 format)

scaleway.edge_services.v1beta1.RuleHttpMatch

HTTP methods to filter for. A request using any of these methods will be considered to match the rule. Possible values are get, post, put, patch, delete, head, options. All methods will match if none is provided.

Enum values:
unknown_method_filter
get
post
put
patch
delete
head
options

HTTP URL path to filter for. A request whose path matches the given filter will be considered to match the rule. All paths will match if none is provided.

Host to filter for. A request whose host matches the given filter will be considered to match the rule. All hosts will match if none is provided.

scaleway.edge_services.v1beta1.RuleHttpMatch.HostFilter

Enum values:
unknown_host_filter
regex
Default: unknown_host_filter
value
​string

scaleway.edge_services.v1beta1.RuleHttpMatch.HostFilter.HostFilterType

string · enum
Enum values:
unknown_host_filter
regex
Default: unknown_host_filter

scaleway.edge_services.v1beta1.RuleHttpMatch.MethodFilter

string · enum
Enum values:
unknown_method_filter
get
post
put
patch
delete
head
options
Default: unknown_method_filter

scaleway.edge_services.v1beta1.RuleHttpMatch.PathFilter

Type of filter to match for the HTTP URL path. For now, all path filters must be written in regex and use the regex type.

Enum values:
unknown_path_filter
regex
Default: unknown_path_filter
value
​string

Value to be matched for the HTTP URL path.

scaleway.edge_services.v1beta1.RuleHttpMatch.PathFilter.PathFilterType

string · enum
Enum values:
unknown_path_filter
regex
Default: unknown_path_filter

scaleway.edge_services.v1beta1.ScalewayLb

id
​string · required

ID of the Load Balancer. (UUID format)

zone
​string · required

Zone of the Load Balancer.

frontend_id
​string · required

ID of the frontend linked to the Load Balancer. (UUID format)

is_ssl
​boolean | null

Defines whether the Load Balancer's frontend handles SSL connections.

domain_name
​string | null

Fully Qualified Domain Name (in the format subdomain.example.com) to use in HTTP requests sent towards your Load Balancer.

has_websocket
​boolean | null

Defines whether to forward websocket requests to the load balancer.

scaleway.edge_services.v1beta1.ScalewayLbBackendConfig

Load Balancer information.

scaleway.edge_services.v1beta1.ScalewayS3BackendConfig

bucket_name
​string | null

Name of the Bucket.

bucket_region
​string | null

Region of the Bucket.

is_website
​boolean | null

Defines whether the bucket website feature is enabled.

scaleway.edge_services.v1beta1.ScalewayServerlessContainerBackendConfig

region
​string · required

The region you want to target

container_id
​string · required

(UUID format)

scaleway.edge_services.v1beta1.ScalewayServerlessFunctionBackendConfig

region
​string · required

The region you want to target

function_id
​string · required

(UUID format)

scaleway.edge_services.v1beta1.SetHeadStageRequest.AddNewHeadStage

new_stage_id
​string

(UUID format)

scaleway.edge_services.v1beta1.SetHeadStageRequest.RemoveHeadStage

remove_stage_id
​string

(UUID format)

scaleway.edge_services.v1beta1.SetHeadStageRequest.SwapHeadStage

new_stage_id
​string

(UUID format)

current_stage_id
​string

(UUID format)

scaleway.edge_services.v1beta1.SetRouteRulesRequest.RouteRule

​

Rule condition to be matched. Requests matching the condition defined here will be directly forwarded to the backend specified by the backend_stage_id or waf_stage_id fields. Requests that do not match will be checked by the next rule's condition.

backend_stage_id
​string | null

ID of the backend stage that requests matching the rule should be forwarded to. (UUID format)

waf_stage_id
​string | null

ID of the WAF stage that requests matching the rule should be forwarded to. (UUID format)

scaleway.edge_services.v1beta1.SetRouteRulesResponse

List of rules to be checked against every HTTP request. The first matching rule will forward the request to its specified backend stage. If no rules are matched, the request is forwarded to the stage defined by waf_stage_id or backend_stage_id.

scaleway.edge_services.v1beta1.StageStatus

string · enum
Enum values:
unknown_status
inactive
active
Default: unknown_status

scaleway.edge_services.v1beta1.TLSSecret

secret_id
​string · required

ID of the Secret.

region
​string · required

Region of the Secret.

scaleway.edge_services.v1beta1.TLSSecretsConfig

Secret information (from Secret Manager).

scaleway.edge_services.v1beta1.TLSStage

id
​string

ID of the TLS stage.

Secret (from Scaleway Secret Manager) containing your custom certificate.

managed_certificate
​boolean

True when Scaleway generates and manages a Let's Encrypt certificate for the TLS stage/custom endpoint.

pipeline_id
​string

Pipeline ID the TLS stage belongs to.

certificate_expires_at
​string | null · date-time

Expiration date of the certificate. (RFC 3339 format)

status
​scaleway.edge_services.v1beta1.StageStatus · enum

Current status of the stage.

Enum values:
unknown_status
inactive
active
Default: unknown_status
created_at
​string | null · date-time

Date the TLS stage was created. (RFC 3339 format)

updated_at
​string | null · date-time

Date the TLS stage was last updated. (RFC 3339 format)

cache_stage_id
​string | null

Cache stage ID the TLS stage is linked to. (UUID format)

backend_stage_id
​string | null

Backend stage ID the TLS stage is linked to. (UUID format)

waf_stage_id
​string | null

(UUID format)

route_stage_id
​string | null

(UUID format)

scaleway.edge_services.v1beta1.WafExclusionRule

rule_id
​integer · uint32

scaleway.edge_services.v1beta1.WafExclusionRules

scaleway.edge_services.v1beta1.WafStage

id
​string

ID of the WAF stage.

pipeline_id
​string

Pipeline ID the WAF stage belongs to.

Mode defining WAF behavior (disable/log_only/enable).

Enum values:
unknown_mode
disable
log_only
enable
Default: unknown_mode
paranoia_level
​integer · uint32

Sensitivity level (1,2,3,4) to use when classifying requests as malicious. With a high level, requests are more likely to be classed as malicious, and false positives are expected. With a lower level, requests are more likely to be classed as benign.

status
​scaleway.edge_services.v1beta1.StageStatus · enum

Current status of the stage.

Enum values:
unknown_status
inactive
active
Default: unknown_status
created_at
​string | null · date-time

Date the WAF stage was created. (RFC 3339 format)

updated_at
​string | null · date-time

Date the WAF stage was last updated. (RFC 3339 format)

backend_stage_id
​string | null

ID of the backend stage to forward requests to after the WAF stage. (UUID format)

List of OWASP® CRS rule IDs excluded from WAF.

scaleway.edge_services.v1beta1.WafStage.Mode

string · enum
Enum values:
unknown_mode
disable
log_only
enable
Default: unknown_mode