published on Monday, Apr 27, 2026 by g-core
published on Monday, Apr 27, 2026 by g-core
CDN origin groups aggregate one or more origin servers with failover and load balancing for content delivery.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as gcore from "@pulumi/gcore";
const exampleCdnOriginGroup = gcore.getCdnOriginGroup({
originGroupId: 0,
});
import pulumi
import pulumi_gcore as gcore
example_cdn_origin_group = gcore.get_cdn_origin_group(origin_group_id=0)
package main
import (
"github.com/pulumi/pulumi-terraform-provider/sdks/go/gcore/v2/gcore"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := gcore.LookupCdnOriginGroup(ctx, &gcore.LookupCdnOriginGroupArgs{
OriginGroupId: 0,
}, nil)
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcore = Pulumi.Gcore;
return await Deployment.RunAsync(() =>
{
var exampleCdnOriginGroup = Gcore.GetCdnOriginGroup.Invoke(new()
{
OriginGroupId = 0,
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcore.GcoreFunctions;
import com.pulumi.gcore.inputs.GetCdnOriginGroupArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
final var exampleCdnOriginGroup = GcoreFunctions.getCdnOriginGroup(GetCdnOriginGroupArgs.builder()
.originGroupId(0)
.build());
}
}
variables:
exampleCdnOriginGroup:
fn::invoke:
function: gcore:getCdnOriginGroup
arguments:
originGroupId: 0
Using getCdnOriginGroup
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getCdnOriginGroup(args: GetCdnOriginGroupArgs, opts?: InvokeOptions): Promise<GetCdnOriginGroupResult>
function getCdnOriginGroupOutput(args: GetCdnOriginGroupOutputArgs, opts?: InvokeOptions): Output<GetCdnOriginGroupResult>def get_cdn_origin_group(origin_group_id: Optional[float] = None,
opts: Optional[InvokeOptions] = None) -> GetCdnOriginGroupResult
def get_cdn_origin_group_output(origin_group_id: pulumi.Input[Optional[float]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetCdnOriginGroupResult]func LookupCdnOriginGroup(ctx *Context, args *LookupCdnOriginGroupArgs, opts ...InvokeOption) (*LookupCdnOriginGroupResult, error)
func LookupCdnOriginGroupOutput(ctx *Context, args *LookupCdnOriginGroupOutputArgs, opts ...InvokeOption) LookupCdnOriginGroupResultOutput> Note: This function is named LookupCdnOriginGroup in the Go SDK.
public static class GetCdnOriginGroup
{
public static Task<GetCdnOriginGroupResult> InvokeAsync(GetCdnOriginGroupArgs args, InvokeOptions? opts = null)
public static Output<GetCdnOriginGroupResult> Invoke(GetCdnOriginGroupInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetCdnOriginGroupResult> getCdnOriginGroup(GetCdnOriginGroupArgs args, InvokeOptions options)
public static Output<GetCdnOriginGroupResult> getCdnOriginGroup(GetCdnOriginGroupArgs args, InvokeOptions options)
fn::invoke:
function: gcore:index/getCdnOriginGroup:getCdnOriginGroup
arguments:
# arguments dictionaryThe following arguments are supported:
- Origin
Group doubleId
- Origin
Group float64Id
- origin
Group DoubleId
- origin
Group numberId
- origin_
group_ floatid
- origin
Group NumberId
getCdnOriginGroup Result
The following output properties are available:
- Auth
Get
Cdn Origin Group Auth - Deprecated. To create S3 origins, configure them directly in sources with
origin_typeandconfiginstead. - Auth
Type string - bool
- Id double
- Name string
- Origin
Group doubleId - Path string
- Proxy
Next List<string>Upstreams - Sources
List<Get
Cdn Origin Group Source> - Use
Next bool
- Auth
Get
Cdn Origin Group Auth - Deprecated. To create S3 origins, configure them directly in sources with
origin_typeandconfiginstead. - Auth
Type string - bool
- Id float64
- Name string
- Origin
Group float64Id - Path string
- Proxy
Next []stringUpstreams - Sources
[]Get
Cdn Origin Group Source - Use
Next bool
- auth
Get
Cdn Origin Group Auth - Deprecated. To create S3 origins, configure them directly in sources with
origin_typeandconfiginstead. - auth
Type String - Boolean
- id Double
- name String
- origin
Group DoubleId - path String
- proxy
Next List<String>Upstreams - sources
List<Get
Cdn Origin Group Source> - use
Next Boolean
- auth
Get
Cdn Origin Group Auth - Deprecated. To create S3 origins, configure them directly in sources with
origin_typeandconfiginstead. - auth
Type string - boolean
- id number
- name string
- origin
Group numberId - path string
- proxy
Next string[]Upstreams - sources
Get
Cdn Origin Group Source[] - use
Next boolean
- auth
Get
Cdn Origin Group Auth - Deprecated. To create S3 origins, configure them directly in sources with
origin_typeandconfiginstead. - auth_
type str - bool
- id float
- name str
- origin_
group_ floatid - path str
- proxy_
next_ Sequence[str]upstreams - sources
Sequence[Get
Cdn Origin Group Source] - use_
next bool
- auth Property Map
- Deprecated. To create S3 origins, configure them directly in sources with
origin_typeandconfiginstead. - auth
Type String - Boolean
- id Number
- name String
- origin
Group NumberId - path String
- proxy
Next List<String>Upstreams - sources List<Property Map>
- use
Next Boolean
Supporting Types
GetCdnOriginGroupAuth
- S3Access
Key stringId - Access key ID for the S3 account.
- S3Bucket
Name string - S3 bucket name.
- S3Region string
S3 storage region.
The parameter is required, if "s3_type": amazon.
- S3Secret
Access stringKey Secret access key for the S3 account.
Restrictions:
- Latin letters (A-Z, a-z), numbers (0-9), pluses, slashes, dashes, colons and underscores.
- If "s3_type": amazon, length should be 40 characters.
- If "s3_type": other, length should be from 16 to 255 characters.
- S3Storage
Hostname string S3 storage hostname.
The parameter is required, if "s3_type": other.
- S3Type string
Storage type compatible with S3.
Possible values:
- amazon – AWS S3 storage.
- other – Other (not AWS) S3 compatible storage.
- S3Access
Key stringId - Access key ID for the S3 account.
- S3Bucket
Name string - S3 bucket name.
- S3Region string
S3 storage region.
The parameter is required, if "s3_type": amazon.
- S3Secret
Access stringKey Secret access key for the S3 account.
Restrictions:
- Latin letters (A-Z, a-z), numbers (0-9), pluses, slashes, dashes, colons and underscores.
- If "s3_type": amazon, length should be 40 characters.
- If "s3_type": other, length should be from 16 to 255 characters.
- S3Storage
Hostname string S3 storage hostname.
The parameter is required, if "s3_type": other.
- S3Type string
Storage type compatible with S3.
Possible values:
- amazon – AWS S3 storage.
- other – Other (not AWS) S3 compatible storage.
- s3Access
Key StringId - Access key ID for the S3 account.
- s3Bucket
Name String - S3 bucket name.
- s3Region String
S3 storage region.
The parameter is required, if "s3_type": amazon.
- s3Secret
Access StringKey Secret access key for the S3 account.
Restrictions:
- Latin letters (A-Z, a-z), numbers (0-9), pluses, slashes, dashes, colons and underscores.
- If "s3_type": amazon, length should be 40 characters.
- If "s3_type": other, length should be from 16 to 255 characters.
- s3Storage
Hostname String S3 storage hostname.
The parameter is required, if "s3_type": other.
- s3Type String
Storage type compatible with S3.
Possible values:
- amazon – AWS S3 storage.
- other – Other (not AWS) S3 compatible storage.
- s3Access
Key stringId - Access key ID for the S3 account.
- s3Bucket
Name string - S3 bucket name.
- s3Region string
S3 storage region.
The parameter is required, if "s3_type": amazon.
- s3Secret
Access stringKey Secret access key for the S3 account.
Restrictions:
- Latin letters (A-Z, a-z), numbers (0-9), pluses, slashes, dashes, colons and underscores.
- If "s3_type": amazon, length should be 40 characters.
- If "s3_type": other, length should be from 16 to 255 characters.
- s3Storage
Hostname string S3 storage hostname.
The parameter is required, if "s3_type": other.
- s3Type string
Storage type compatible with S3.
Possible values:
- amazon – AWS S3 storage.
- other – Other (not AWS) S3 compatible storage.
- s3_
access_ strkey_ id - Access key ID for the S3 account.
- s3_
bucket_ strname - S3 bucket name.
- s3_
region str S3 storage region.
The parameter is required, if "s3_type": amazon.
- s3_
secret_ straccess_ key Secret access key for the S3 account.
Restrictions:
- Latin letters (A-Z, a-z), numbers (0-9), pluses, slashes, dashes, colons and underscores.
- If "s3_type": amazon, length should be 40 characters.
- If "s3_type": other, length should be from 16 to 255 characters.
- s3_
storage_ strhostname S3 storage hostname.
The parameter is required, if "s3_type": other.
- s3_
type str Storage type compatible with S3.
Possible values:
- amazon – AWS S3 storage.
- other – Other (not AWS) S3 compatible storage.
- s3Access
Key StringId - Access key ID for the S3 account.
- s3Bucket
Name String - S3 bucket name.
- s3Region String
S3 storage region.
The parameter is required, if "s3_type": amazon.
- s3Secret
Access StringKey Secret access key for the S3 account.
Restrictions:
- Latin letters (A-Z, a-z), numbers (0-9), pluses, slashes, dashes, colons and underscores.
- If "s3_type": amazon, length should be 40 characters.
- If "s3_type": other, length should be from 16 to 255 characters.
- s3Storage
Hostname String S3 storage hostname.
The parameter is required, if "s3_type": other.
- s3Type String
Storage type compatible with S3.
Possible values:
- amazon – AWS S3 storage.
- other – Other (not AWS) S3 compatible storage.
GetCdnOriginGroupSource
- Backup bool
- Defines whether the origin is a backup, meaning that it will not be used until one of active origins become unavailable.
- Config
Get
Cdn Origin Group Source Config - S3 storage configuration. Required when
origin_typeiss3. - Enabled bool
Enables or disables an origin source in the origin group.
Possible values:
- true - Origin is enabled and the CDN uses it to pull content.
- false - Origin is disabled and the CDN does not use it to pull content.
Origin group must contain at least one enabled origin.
- Host
Header stringOverride - Per-origin Host header override. When set, the CDN sends this value as the Host header when requesting content from this origin instead of the default.
- Origin
Type string Origin type. Present in responses only for S3 sources.
Possible values:
- host - A source server or endpoint from which content is fetched.
- s3 - S3 storage with either AWS v4 authentication or public access. Available values: "host", "s3".
- Source string
- IP address or domain name of the origin and the port, if custom port is used.
- Tag string
- Tag for the origin source.
- Backup bool
- Defines whether the origin is a backup, meaning that it will not be used until one of active origins become unavailable.
- Config
Get
Cdn Origin Group Source Config - S3 storage configuration. Required when
origin_typeiss3. - Enabled bool
Enables or disables an origin source in the origin group.
Possible values:
- true - Origin is enabled and the CDN uses it to pull content.
- false - Origin is disabled and the CDN does not use it to pull content.
Origin group must contain at least one enabled origin.
- Host
Header stringOverride - Per-origin Host header override. When set, the CDN sends this value as the Host header when requesting content from this origin instead of the default.
- Origin
Type string Origin type. Present in responses only for S3 sources.
Possible values:
- host - A source server or endpoint from which content is fetched.
- s3 - S3 storage with either AWS v4 authentication or public access. Available values: "host", "s3".
- Source string
- IP address or domain name of the origin and the port, if custom port is used.
- Tag string
- Tag for the origin source.
- backup Boolean
- Defines whether the origin is a backup, meaning that it will not be used until one of active origins become unavailable.
- config
Get
Cdn Origin Group Source Config - S3 storage configuration. Required when
origin_typeiss3. - enabled Boolean
Enables or disables an origin source in the origin group.
Possible values:
- true - Origin is enabled and the CDN uses it to pull content.
- false - Origin is disabled and the CDN does not use it to pull content.
Origin group must contain at least one enabled origin.
- host
Header StringOverride - Per-origin Host header override. When set, the CDN sends this value as the Host header when requesting content from this origin instead of the default.
- origin
Type String Origin type. Present in responses only for S3 sources.
Possible values:
- host - A source server or endpoint from which content is fetched.
- s3 - S3 storage with either AWS v4 authentication or public access. Available values: "host", "s3".
- source String
- IP address or domain name of the origin and the port, if custom port is used.
- tag String
- Tag for the origin source.
- backup boolean
- Defines whether the origin is a backup, meaning that it will not be used until one of active origins become unavailable.
- config
Get
Cdn Origin Group Source Config - S3 storage configuration. Required when
origin_typeiss3. - enabled boolean
Enables or disables an origin source in the origin group.
Possible values:
- true - Origin is enabled and the CDN uses it to pull content.
- false - Origin is disabled and the CDN does not use it to pull content.
Origin group must contain at least one enabled origin.
- host
Header stringOverride - Per-origin Host header override. When set, the CDN sends this value as the Host header when requesting content from this origin instead of the default.
- origin
Type string Origin type. Present in responses only for S3 sources.
Possible values:
- host - A source server or endpoint from which content is fetched.
- s3 - S3 storage with either AWS v4 authentication or public access. Available values: "host", "s3".
- source string
- IP address or domain name of the origin and the port, if custom port is used.
- tag string
- Tag for the origin source.
- backup bool
- Defines whether the origin is a backup, meaning that it will not be used until one of active origins become unavailable.
- config
Get
Cdn Origin Group Source Config - S3 storage configuration. Required when
origin_typeiss3. - enabled bool
Enables or disables an origin source in the origin group.
Possible values:
- true - Origin is enabled and the CDN uses it to pull content.
- false - Origin is disabled and the CDN does not use it to pull content.
Origin group must contain at least one enabled origin.
- host_
header_ stroverride - Per-origin Host header override. When set, the CDN sends this value as the Host header when requesting content from this origin instead of the default.
- origin_
type str Origin type. Present in responses only for S3 sources.
Possible values:
- host - A source server or endpoint from which content is fetched.
- s3 - S3 storage with either AWS v4 authentication or public access. Available values: "host", "s3".
- source str
- IP address or domain name of the origin and the port, if custom port is used.
- tag str
- Tag for the origin source.
- backup Boolean
- Defines whether the origin is a backup, meaning that it will not be used until one of active origins become unavailable.
- config Property Map
- S3 storage configuration. Required when
origin_typeiss3. - enabled Boolean
Enables or disables an origin source in the origin group.
Possible values:
- true - Origin is enabled and the CDN uses it to pull content.
- false - Origin is disabled and the CDN does not use it to pull content.
Origin group must contain at least one enabled origin.
- host
Header StringOverride - Per-origin Host header override. When set, the CDN sends this value as the Host header when requesting content from this origin instead of the default.
- origin
Type String Origin type. Present in responses only for S3 sources.
Possible values:
- host - A source server or endpoint from which content is fetched.
- s3 - S3 storage with either AWS v4 authentication or public access. Available values: "host", "s3".
- source String
- IP address or domain name of the origin and the port, if custom port is used.
- tag String
- Tag for the origin source.
GetCdnOriginGroupSourceConfig
- S3Access
Key stringId - Access key ID for the S3 account. Masked as
SECRET_VALUEin responses. - S3Auth
Type string - S3 authentication type.
- S3Bucket
Name string - S3 bucket name.
- S3Region string
S3 storage region.
The parameter is required if
s3_typeisamazon.- S3Secret
Access stringKey Secret access key for the S3 account. Masked as
SECRET_VALUEin responses.Restrictions:
- Latin letters (A-Z, a-z), numbers (0-9), pluses, slashes, dashes, colons and underscores.
- From 16 to 255 characters.
- S3Storage
Hostname string S3 storage hostname.
The parameter is required if
s3_typeisother.- S3Type string
Storage type compatible with S3.
Possible values:
- amazon - AWS S3 storage.
- other - Other (not AWS) S3 compatible storage. Available values: "amazon", "other".
- S3Access
Key stringId - Access key ID for the S3 account. Masked as
SECRET_VALUEin responses. - S3Auth
Type string - S3 authentication type.
- S3Bucket
Name string - S3 bucket name.
- S3Region string
S3 storage region.
The parameter is required if
s3_typeisamazon.- S3Secret
Access stringKey Secret access key for the S3 account. Masked as
SECRET_VALUEin responses.Restrictions:
- Latin letters (A-Z, a-z), numbers (0-9), pluses, slashes, dashes, colons and underscores.
- From 16 to 255 characters.
- S3Storage
Hostname string S3 storage hostname.
The parameter is required if
s3_typeisother.- S3Type string
Storage type compatible with S3.
Possible values:
- amazon - AWS S3 storage.
- other - Other (not AWS) S3 compatible storage. Available values: "amazon", "other".
- s3Access
Key StringId - Access key ID for the S3 account. Masked as
SECRET_VALUEin responses. - s3Auth
Type String - S3 authentication type.
- s3Bucket
Name String - S3 bucket name.
- s3Region String
S3 storage region.
The parameter is required if
s3_typeisamazon.- s3Secret
Access StringKey Secret access key for the S3 account. Masked as
SECRET_VALUEin responses.Restrictions:
- Latin letters (A-Z, a-z), numbers (0-9), pluses, slashes, dashes, colons and underscores.
- From 16 to 255 characters.
- s3Storage
Hostname String S3 storage hostname.
The parameter is required if
s3_typeisother.- s3Type String
Storage type compatible with S3.
Possible values:
- amazon - AWS S3 storage.
- other - Other (not AWS) S3 compatible storage. Available values: "amazon", "other".
- s3Access
Key stringId - Access key ID for the S3 account. Masked as
SECRET_VALUEin responses. - s3Auth
Type string - S3 authentication type.
- s3Bucket
Name string - S3 bucket name.
- s3Region string
S3 storage region.
The parameter is required if
s3_typeisamazon.- s3Secret
Access stringKey Secret access key for the S3 account. Masked as
SECRET_VALUEin responses.Restrictions:
- Latin letters (A-Z, a-z), numbers (0-9), pluses, slashes, dashes, colons and underscores.
- From 16 to 255 characters.
- s3Storage
Hostname string S3 storage hostname.
The parameter is required if
s3_typeisother.- s3Type string
Storage type compatible with S3.
Possible values:
- amazon - AWS S3 storage.
- other - Other (not AWS) S3 compatible storage. Available values: "amazon", "other".
- s3_
access_ strkey_ id - Access key ID for the S3 account. Masked as
SECRET_VALUEin responses. - s3_
auth_ strtype - S3 authentication type.
- s3_
bucket_ strname - S3 bucket name.
- s3_
region str S3 storage region.
The parameter is required if
s3_typeisamazon.- s3_
secret_ straccess_ key Secret access key for the S3 account. Masked as
SECRET_VALUEin responses.Restrictions:
- Latin letters (A-Z, a-z), numbers (0-9), pluses, slashes, dashes, colons and underscores.
- From 16 to 255 characters.
- s3_
storage_ strhostname S3 storage hostname.
The parameter is required if
s3_typeisother.- s3_
type str Storage type compatible with S3.
Possible values:
- amazon - AWS S3 storage.
- other - Other (not AWS) S3 compatible storage. Available values: "amazon", "other".
- s3Access
Key StringId - Access key ID for the S3 account. Masked as
SECRET_VALUEin responses. - s3Auth
Type String - S3 authentication type.
- s3Bucket
Name String - S3 bucket name.
- s3Region String
S3 storage region.
The parameter is required if
s3_typeisamazon.- s3Secret
Access StringKey Secret access key for the S3 account. Masked as
SECRET_VALUEin responses.Restrictions:
- Latin letters (A-Z, a-z), numbers (0-9), pluses, slashes, dashes, colons and underscores.
- From 16 to 255 characters.
- s3Storage
Hostname String S3 storage hostname.
The parameter is required if
s3_typeisother.- s3Type String
Storage type compatible with S3.
Possible values:
- amazon - AWS S3 storage.
- other - Other (not AWS) S3 compatible storage. Available values: "amazon", "other".
Package Details
- Repository
- gcore g-core/terraform-provider-gcore
- License
- Notes
- This Pulumi package is based on the
gcoreTerraform Provider.
published on Monday, Apr 27, 2026 by g-core
