feat(cdn): add cdn client, config, list command

docs/stackit_beta.md

@@ -42,6 +42,7 @@ stackit beta [flags]
 
 * [stackit](./stackit.md)	 - Manage STACKIT resources using the command line
 * [stackit beta alb](./stackit_beta_alb.md)	 - Manages application loadbalancers
+* [stackit beta cdn](./stackit_beta_cdn.md)	 - Manage CDN resources
 * [stackit beta intake](./stackit_beta_intake.md)	 - Provides functionality for intake
 * [stackit beta kms](./stackit_beta_kms.md)	 - Provides functionality for KMS
 * [stackit beta sqlserverflex](./stackit_beta_sqlserverflex.md)	 - Provides functionality for SQLServer Flex

docs/stackit_beta_cdn.md

@@ -0,0 +1,34 @@
+## stackit beta cdn
+
+Manage CDN resources
+
+### Synopsis
+
+Manage the lifecycle of CDN resources.
+
+```
+stackit beta cdn [flags]
+```
+
+### Options
+
+```
+  -h, --help   Help for "stackit beta cdn"
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none" "yaml"]
+  -p, --project-id string      Project ID
+      --region string          Target region for region-specific requests
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit beta](./stackit_beta.md)	 - Contains beta STACKIT CLI commands
+* [stackit beta cdn distribution](./stackit_beta_cdn_distribution.md)	 - Manage CDN distributions
+

docs/stackit_beta_cdn_distribution.md

@@ -0,0 +1,38 @@
+## stackit beta cdn distribution
+
+Manage CDN distributions
+
+### Synopsis
+
+Manage the lifecycle of CDN distributions.
+
+```
+stackit beta cdn distribution [flags]
+```
+
+### Options
+
+```
+  -h, --help   Help for "stackit beta cdn distribution"
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none" "yaml"]
+  -p, --project-id string      Project ID
+      --region string          Target region for region-specific requests
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit beta cdn](./stackit_beta_cdn.md)	 - Manage CDN resources
+* [stackit beta cdn distribution create](./stackit_beta_cdn_distribution_create.md)	 - Create a CDN distribution
+* [stackit beta cdn distribution delete](./stackit_beta_cdn_distribution_delete.md)	 - Delete a CDN distribution
+* [stackit beta cdn distribution describe](./stackit_beta_cdn_distribution_describe.md)	 - Describe a CDN distribution
+* [stackit beta cdn distribution list](./stackit_beta_cdn_distribution_list.md)	 - List CDN distributions
+* [stackit beta cdn distribution update](./stackit_beta_cdn_distribution_update.md)	 - Update a CDN distribution
+

docs/stackit_beta_cdn_distribution_create.md

@@ -0,0 +1,63 @@
+## stackit beta cdn distribution create
+
+Create a CDN distribution
+
+### Synopsis
+
+Create a CDN distribution for a given originUrl in multiple regions.
+
+```
+stackit beta cdn distribution create [flags]
+```
+
+### Examples
+
+```
+  Create a CDN distribution with an HTTP backend
+  $ stackit beta cdn create --http  --http-origin-url https://example.com \
+--regions AF,EU
+
+  Create a CDN distribution with an Object Storage backend
+  $ stackit beta cdn create --bucket --bucket-url https://bucket.example.com \
+--bucket-credentials-access-key-id yyyy --bucket-region EU \
+--regions AF,EU
+```
+
+### Options
+
+```
+      --blocked-countries strings                 Comma-separated list of ISO 3166-1 alpha-2 country codes to block (e.g., 'US,DE,FR')
+      --blocked-ips strings                       Comma-separated list of IPv4 addresses to block (e.g., '10.0.0.8,127.0.0.1')
+      --bucket                                    Use Object Storage backend
+      --bucket-credentials-access-key-id string   Access Key ID for Object Storage backend
+      --bucket-region string                      Region for Object Storage backend
+      --bucket-url string                         Bucket URL for Object Storage backend
+      --default-cache-duration string             ISO8601 duration string for default cache duration (e.g., 'PT1H30M' for 1 hour and 30 minutes)
+  -h, --help                                      Help for "stackit beta cdn distribution create"
+      --http                                      Use HTTP backend
+      --http-geofencing stringArray               Geofencing rules for HTTP backend in the format 'https://example.com US,DE'. URL and countries have to be quoted. Repeatable.
+      --http-origin-request-headers strings       Origin request headers for HTTP backend in the format 'HeaderName: HeaderValue', repeatable. WARNING: do not store sensitive values in the headers!
+      --http-origin-url string                    Origin URL for HTTP backend
+      --loki                                      Enable Loki log sink for the CDN distribution
+      --loki-push-url string                      Push URL for log sink
+      --loki-username string                      Username for log sink
+      --monthly-limit-bytes int                   Monthly limit in bytes for the CDN distribution
+      --optimizer                                 Enable optimizer for the CDN distribution (paid feature).
+      --regions strings                           Regions in which content should be cached, multiple of: ["EU" "US" "AF" "SA" "ASIA"] (default [])
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none" "yaml"]
+  -p, --project-id string      Project ID
+      --region string          Target region for region-specific requests
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit beta cdn distribution](./stackit_beta_cdn_distribution.md)	 - Manage CDN distributions
+

docs/stackit_beta_cdn_distribution_delete.md

@@ -0,0 +1,40 @@
+## stackit beta cdn distribution delete
+
+Delete a CDN distribution
+
+### Synopsis
+
+Delete a CDN distribution by its ID.
+
+```
+stackit beta cdn distribution delete [flags]
+```
+
+### Examples
+
+```
+  Delete a CDN distribution with ID "xxx"
+  $ stackit beta cdn distribution delete xxx
+```
+
+### Options
+
+```
+  -h, --help   Help for "stackit beta cdn distribution delete"
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none" "yaml"]
+  -p, --project-id string      Project ID
+      --region string          Target region for region-specific requests
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit beta cdn distribution](./stackit_beta_cdn_distribution.md)	 - Manage CDN distributions
+

docs/stackit_beta_cdn_distribution_describe.md

@@ -0,0 +1,44 @@
+## stackit beta cdn distribution describe
+
+Describe a CDN distribution
+
+### Synopsis
+
+Describe a CDN distribution by its ID.
+
+```
+stackit beta cdn distribution describe [flags]
+```
+
+### Examples
+
+```
+  Get details of a CDN distribution with ID "xxx"
+  $ stackit beta cdn distribution describe xxx
+
+  Get details of a CDN, including WAF details, for ID "xxx"
+  $ stackit beta cdn distribution describe xxx --with-waf
+```
+
+### Options
+
+```
+  -h, --help       Help for "stackit beta cdn distribution describe"
+      --with-waf   Include WAF details in the distribution description
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none" "yaml"]
+  -p, --project-id string      Project ID
+      --region string          Target region for region-specific requests
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit beta cdn distribution](./stackit_beta_cdn_distribution.md)	 - Manage CDN distributions
+

docs/stackit_beta_cdn_distribution_list.md

@@ -0,0 +1,45 @@
+## stackit beta cdn distribution list
+
+List CDN distributions
+
+### Synopsis
+
+List all CDN distributions in your account.
+
+```
+stackit beta cdn distribution list [flags]
+```
+
+### Examples
+
+```
+  List all CDN distributions
+  $ stackit beta cdn distribution list
+
+  List all CDN distributions sorted by id
+  $ stackit beta cdn distribution list --sort-by=id
+```
+
+### Options
+
+```
+      -- int             Limit the output to the first n elements
+  -h, --help             Help for "stackit beta cdn distribution list"
+      --sort-by string   Sort entries by a specific field, one of ["id" "createdAt" "updatedAt" "originUrl" "status" "originUrlRelated"] (default "createdAt")
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none" "yaml"]
+  -p, --project-id string      Project ID
+      --region string          Target region for region-specific requests
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit beta cdn distribution](./stackit_beta_cdn_distribution.md)	 - Manage CDN distributions
+

docs/stackit_beta_cdn_distribution_update.md

@@ -0,0 +1,57 @@
+## stackit beta cdn distribution update
+
+Update a CDN distribution
+
+### Synopsis
+
+Update a CDN distribution by its ID, allowing replacement of its regions.
+
+```
+stackit beta cdn distribution update [flags]
+```
+
+### Examples
+
+```
+  update a CDN distribution with ID "123e4567-e89b-12d3-a456-426614174000" to not use optimizer
+  $ stackit beta cdn update 123e4567-e89b-12d3-a456-426614174000 --optimizer=false
+```
+
+### Options
+
+```
+      --blocked-countries strings                 Comma-separated list of ISO 3166-1 alpha-2 country codes to block (e.g., 'US,DE,FR')
+      --blocked-ips strings                       Comma-separated list of IPv4 addresses to block (e.g., '10.0.0.8,127.0.0.1')
+      --bucket                                    Use Object Storage backend
+      --bucket-credentials-access-key-id string   Access Key ID for Object Storage backend
+      --bucket-region string                      Region for Object Storage backend
+      --bucket-url string                         Bucket URL for Object Storage backend
+      --default-cache-duration string             ISO8601 duration string for default cache duration (e.g., 'PT1H30M' for 1 hour and 30 minutes)
+  -h, --help                                      Help for "stackit beta cdn distribution update"
+      --http                                      Use HTTP backend
+      --http-geofencing stringArray               Geofencing rules for HTTP backend in the format 'https://example.com US,DE'. URL and countries have to be quoted. Repeatable.
+      --http-origin-request-headers strings       Origin request headers for HTTP backend in the format 'HeaderName: HeaderValue', repeatable. WARNING: do not store sensitive values in the headers!
+      --http-origin-url string                    Origin URL for HTTP backend
+      --loki                                      Enable Loki log sink for the CDN distribution
+      --loki-push-url string                      Push URL for log sink
+      --loki-username string                      Username for log sink
+      --monthly-limit-bytes int                   Monthly limit in bytes for the CDN distribution
+      --optimizer                                 Enable optimizer for the CDN distribution (paid feature).
+      --regions strings                           Regions in which content should be cached, multiple of: ["EU" "US" "AF" "SA" "ASIA"] (default [])
+```
+
+### Options inherited from parent commands
+
+```
+  -y, --assume-yes             If set, skips all confirmation prompts
+      --async                  If set, runs the command asynchronously
+  -o, --output-format string   Output format, one of ["json" "pretty" "none" "yaml"]
+  -p, --project-id string      Project ID
+      --region string          Target region for region-specific requests
+      --verbosity string       Verbosity of the CLI, one of ["debug" "info" "warning" "error"] (default "info")
+```
+
+### SEE ALSO
+
+* [stackit beta cdn distribution](./stackit_beta_cdn_distribution.md)	 - Manage CDN distributions
+

docs/stackit_config_set.md

@@ -31,6 +31,7 @@ stackit config set [flags]
 ```
       --allowed-url-domain string                                  Domain name, used for the verification of the URLs that are given in the custom identity provider endpoint and "STACKIT curl" command
       --authorization-custom-endpoint string                       Authorization API base URL, used in calls to this API
+      --cdn-custom-endpoint string                                 CDN API base URL, used in calls to this API
       --dns-custom-endpoint string                                 DNS API base URL, used in calls to this API
   -h, --help                                                       Help for "stackit config set"
       --iaas-custom-endpoint string                                IaaS API base URL, used in calls to this API

docs/stackit_config_unset.md

@@ -29,6 +29,7 @@ stackit config unset [flags]
       --allowed-url-domain                                  Domain name, used for the verification of the URLs that are given in the IDP endpoint and curl commands. If unset, defaults to stackit.cloud
       --async                                               Configuration option to run commands asynchronously
       --authorization-custom-endpoint                       Authorization API base URL. If unset, uses the default base URL
+      --cdn-custom-endpoint                                 Custom CDN endpoint URL. If unset, uses the default base URL
       --dns-custom-endpoint                                 DNS API base URL. If unset, uses the default base URL
   -h, --help                                                Help for "stackit config unset"
       --iaas-custom-endpoint                                IaaS API base URL. If unset, uses the default base URL

go.mod

@@ -18,6 +18,7 @@ require (
 	github.com/stackitcloud/stackit-sdk-go/core v0.20.0
 	github.com/stackitcloud/stackit-sdk-go/services/alb v0.7.2
 	github.com/stackitcloud/stackit-sdk-go/services/authorization v0.10.0
+	github.com/stackitcloud/stackit-sdk-go/services/cdn v1.8.1
 	github.com/stackitcloud/stackit-sdk-go/services/dns v0.17.2
 	github.com/stackitcloud/stackit-sdk-go/services/git v0.9.1
 	github.com/stackitcloud/stackit-sdk-go/services/iaas v1.2.2
@@ -35,6 +36,7 @@ require (
 	github.com/stackitcloud/stackit-sdk-go/services/ske v1.5.0
 	github.com/stackitcloud/stackit-sdk-go/services/sqlserverflex v1.3.3
 	github.com/zalando/go-keyring v0.2.6
+	golang.org/x/exp v0.0.0-20240909161429-701f63a606c0
 	golang.org/x/mod v0.30.0
 	golang.org/x/oauth2 v0.33.0
 	golang.org/x/term v0.37.0
@@ -257,7 +259,7 @@ require (
 	gopkg.in/yaml.v3 v3.0.1 // indirect
 	k8s.io/api v0.34.2 // indirect
 	k8s.io/klog/v2 v2.130.1 // indirect
-	k8s.io/utils v0.0.0-20250604170112-4c0f3b243397 // indirect
+	k8s.io/utils v0.0.0-20250604170112-4c0f3b243397
 	sigs.k8s.io/json v0.0.0-20241014173422-cfa47c3a1cc8 // indirect
 	sigs.k8s.io/yaml v1.6.0 // indirect
 )

go.sum

@@ -565,6 +565,8 @@ github.com/stackitcloud/stackit-sdk-go/core v0.20.0 h1:4rrUk6uT1g4nOn5/g1uXukP07
 github.com/stackitcloud/stackit-sdk-go/core v0.20.0/go.mod h1:fqto7M82ynGhEnpZU6VkQKYWYoFG5goC076JWXTUPRQ=
 github.com/stackitcloud/stackit-sdk-go/services/alb v0.7.2 h1:x7ndqw6yaOw+TmThNeAkI+eN9vK5hWgjIJlFZrYPREo=
 github.com/stackitcloud/stackit-sdk-go/services/alb v0.7.2/go.mod h1:wbPNu6e5r/5xhzznCKbC7fEJahrAOb89gmaIm+0w2/s=
+github.com/stackitcloud/stackit-sdk-go/services/cdn v1.8.1 h1:CiOlfCsCDwHP0kas7qyhfp5XtL2kVmn9e4wjtc3LO10=
+github.com/stackitcloud/stackit-sdk-go/services/cdn v1.8.1/go.mod h1:PyZ6g9JsGZZyeISAF+5E7L1lAlMnmbl2YbPj5Teu8to=
 github.com/stackitcloud/stackit-sdk-go/services/authorization v0.10.0 h1:6Buzw5CuPb5ixdMHx4tKjmsQkMn0Hpj0xJ+aNDimKnk=
 github.com/stackitcloud/stackit-sdk-go/services/authorization v0.10.0/go.mod h1:40XVgsSOcVCjoIAsbSycDh8Ikp2y88AdAeqwqIIHvZE=
 github.com/stackitcloud/stackit-sdk-go/services/dns v0.17.2 h1:x1i5rqhEVuUPq5M0eb68ZD2KL1C8OFD8RG2sWMQGL6o=

internal/cmd/beta/beta.go

@@ -4,6 +4,7 @@ import (
 	"fmt"
 
 	"github.com/stackitcloud/stackit-cli/internal/cmd/beta/alb"
+	"github.com/stackitcloud/stackit-cli/internal/cmd/beta/cdn"
 	"github.com/stackitcloud/stackit-cli/internal/cmd/beta/intake"
 	"github.com/stackitcloud/stackit-cli/internal/cmd/beta/kms"
 	"github.com/stackitcloud/stackit-cli/internal/cmd/beta/sqlserverflex"
@@ -42,4 +43,5 @@ func addSubcommands(cmd *cobra.Command, params *params.CmdParams) {
 	cmd.AddCommand(alb.NewCmd(params))
 	cmd.AddCommand(intake.NewCmd(params))
 	cmd.AddCommand(kms.NewCmd(params))
+	cmd.AddCommand(cdn.NewCmd(params))
 }