1. Packages
  2. Packages
  3. Gcore Provider
  4. API Docs
  5. getCdnOriginGroup
Viewing docs for gcore 2.0.0-alpha.6
published on Monday, Apr 27, 2026 by g-core
Viewing docs for gcore 2.0.0-alpha.6
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 dictionary

    The following arguments are supported:

    getCdnOriginGroup Result

    The following output properties are available:

    Auth GetCdnOriginGroupAuth
    Deprecated. To create S3 origins, configure them directly in sources with origin_type and config instead.

    Deprecated: Deprecated

    AuthType string

    Deprecated: Deprecated

    HasRelatedResources bool
    Id double
    Name string
    OriginGroupId double
    Path string

    Deprecated: Deprecated

    ProxyNextUpstreams List<string>
    Sources List<GetCdnOriginGroupSource>
    UseNext bool
    Auth GetCdnOriginGroupAuth
    Deprecated. To create S3 origins, configure them directly in sources with origin_type and config instead.

    Deprecated: Deprecated

    AuthType string

    Deprecated: Deprecated

    HasRelatedResources bool
    Id float64
    Name string
    OriginGroupId float64
    Path string

    Deprecated: Deprecated

    ProxyNextUpstreams []string
    Sources []GetCdnOriginGroupSource
    UseNext bool
    auth GetCdnOriginGroupAuth
    Deprecated. To create S3 origins, configure them directly in sources with origin_type and config instead.

    Deprecated: Deprecated

    authType String

    Deprecated: Deprecated

    hasRelatedResources Boolean
    id Double
    name String
    originGroupId Double
    path String

    Deprecated: Deprecated

    proxyNextUpstreams List<String>
    sources List<GetCdnOriginGroupSource>
    useNext Boolean
    auth GetCdnOriginGroupAuth
    Deprecated. To create S3 origins, configure them directly in sources with origin_type and config instead.

    Deprecated: Deprecated

    authType string

    Deprecated: Deprecated

    hasRelatedResources boolean
    id number
    name string
    originGroupId number
    path string

    Deprecated: Deprecated

    proxyNextUpstreams string[]
    sources GetCdnOriginGroupSource[]
    useNext boolean
    auth GetCdnOriginGroupAuth
    Deprecated. To create S3 origins, configure them directly in sources with origin_type and config instead.

    Deprecated: Deprecated

    auth_type str

    Deprecated: Deprecated

    has_related_resources bool
    id float
    name str
    origin_group_id float
    path str

    Deprecated: Deprecated

    proxy_next_upstreams Sequence[str]
    sources Sequence[GetCdnOriginGroupSource]
    use_next bool
    auth Property Map
    Deprecated. To create S3 origins, configure them directly in sources with origin_type and config instead.

    Deprecated: Deprecated

    authType String

    Deprecated: Deprecated

    hasRelatedResources Boolean
    id Number
    name String
    originGroupId Number
    path String

    Deprecated: Deprecated

    proxyNextUpstreams List<String>
    sources List<Property Map>
    useNext Boolean

    Supporting Types

    GetCdnOriginGroupAuth

    S3AccessKeyId string
    Access key ID for the S3 account.
    S3BucketName string
    S3 bucket name.
    S3Region string

    S3 storage region.

    The parameter is required, if "s3_type": amazon.

    S3SecretAccessKey string

    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.
    S3StorageHostname 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.
    S3AccessKeyId string
    Access key ID for the S3 account.
    S3BucketName string
    S3 bucket name.
    S3Region string

    S3 storage region.

    The parameter is required, if "s3_type": amazon.

    S3SecretAccessKey string

    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.
    S3StorageHostname 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.
    s3AccessKeyId String
    Access key ID for the S3 account.
    s3BucketName String
    S3 bucket name.
    s3Region String

    S3 storage region.

    The parameter is required, if "s3_type": amazon.

    s3SecretAccessKey String

    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.
    s3StorageHostname 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.
    s3AccessKeyId string
    Access key ID for the S3 account.
    s3BucketName string
    S3 bucket name.
    s3Region string

    S3 storage region.

    The parameter is required, if "s3_type": amazon.

    s3SecretAccessKey string

    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.
    s3StorageHostname 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_key_id str
    Access key ID for the S3 account.
    s3_bucket_name str
    S3 bucket name.
    s3_region str

    S3 storage region.

    The parameter is required, if "s3_type": amazon.

    s3_secret_access_key str

    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_hostname str

    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.
    s3AccessKeyId String
    Access key ID for the S3 account.
    s3BucketName String
    S3 bucket name.
    s3Region String

    S3 storage region.

    The parameter is required, if "s3_type": amazon.

    s3SecretAccessKey String

    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.
    s3StorageHostname 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 GetCdnOriginGroupSourceConfig
    S3 storage configuration. Required when origin_type is s3.
    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.

    HostHeaderOverride string
    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.
    OriginType 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 GetCdnOriginGroupSourceConfig
    S3 storage configuration. Required when origin_type is s3.
    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.

    HostHeaderOverride string
    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.
    OriginType 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 GetCdnOriginGroupSourceConfig
    S3 storage configuration. Required when origin_type is s3.
    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.

    hostHeaderOverride String
    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.
    originType 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 GetCdnOriginGroupSourceConfig
    S3 storage configuration. Required when origin_type is s3.
    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.

    hostHeaderOverride string
    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.
    originType 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 GetCdnOriginGroupSourceConfig
    S3 storage configuration. Required when origin_type is s3.
    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_override str
    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_type is s3.
    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.

    hostHeaderOverride String
    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.
    originType 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

    S3AccessKeyId string
    Access key ID for the S3 account. Masked as SECRET_VALUE in responses.
    S3AuthType string
    S3 authentication type.
    S3BucketName string
    S3 bucket name.
    S3Region string

    S3 storage region.

    The parameter is required if s3_type is amazon.

    S3SecretAccessKey string

    Secret access key for the S3 account. Masked as SECRET_VALUE in responses.

    Restrictions:

    • Latin letters (A-Z, a-z), numbers (0-9), pluses, slashes, dashes, colons and underscores.
    • From 16 to 255 characters.
    S3StorageHostname string

    S3 storage hostname.

    The parameter is required if s3_type is other.

    S3Type string

    Storage type compatible with S3.

    Possible values:

    • amazon - AWS S3 storage.
    • other - Other (not AWS) S3 compatible storage. Available values: "amazon", "other".
    S3AccessKeyId string
    Access key ID for the S3 account. Masked as SECRET_VALUE in responses.
    S3AuthType string
    S3 authentication type.
    S3BucketName string
    S3 bucket name.
    S3Region string

    S3 storage region.

    The parameter is required if s3_type is amazon.

    S3SecretAccessKey string

    Secret access key for the S3 account. Masked as SECRET_VALUE in responses.

    Restrictions:

    • Latin letters (A-Z, a-z), numbers (0-9), pluses, slashes, dashes, colons and underscores.
    • From 16 to 255 characters.
    S3StorageHostname string

    S3 storage hostname.

    The parameter is required if s3_type is other.

    S3Type string

    Storage type compatible with S3.

    Possible values:

    • amazon - AWS S3 storage.
    • other - Other (not AWS) S3 compatible storage. Available values: "amazon", "other".
    s3AccessKeyId String
    Access key ID for the S3 account. Masked as SECRET_VALUE in responses.
    s3AuthType String
    S3 authentication type.
    s3BucketName String
    S3 bucket name.
    s3Region String

    S3 storage region.

    The parameter is required if s3_type is amazon.

    s3SecretAccessKey String

    Secret access key for the S3 account. Masked as SECRET_VALUE in responses.

    Restrictions:

    • Latin letters (A-Z, a-z), numbers (0-9), pluses, slashes, dashes, colons and underscores.
    • From 16 to 255 characters.
    s3StorageHostname String

    S3 storage hostname.

    The parameter is required if s3_type is other.

    s3Type String

    Storage type compatible with S3.

    Possible values:

    • amazon - AWS S3 storage.
    • other - Other (not AWS) S3 compatible storage. Available values: "amazon", "other".
    s3AccessKeyId string
    Access key ID for the S3 account. Masked as SECRET_VALUE in responses.
    s3AuthType string
    S3 authentication type.
    s3BucketName string
    S3 bucket name.
    s3Region string

    S3 storage region.

    The parameter is required if s3_type is amazon.

    s3SecretAccessKey string

    Secret access key for the S3 account. Masked as SECRET_VALUE in responses.

    Restrictions:

    • Latin letters (A-Z, a-z), numbers (0-9), pluses, slashes, dashes, colons and underscores.
    • From 16 to 255 characters.
    s3StorageHostname string

    S3 storage hostname.

    The parameter is required if s3_type is other.

    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_key_id str
    Access key ID for the S3 account. Masked as SECRET_VALUE in responses.
    s3_auth_type str
    S3 authentication type.
    s3_bucket_name str
    S3 bucket name.
    s3_region str

    S3 storage region.

    The parameter is required if s3_type is amazon.

    s3_secret_access_key str

    Secret access key for the S3 account. Masked as SECRET_VALUE in responses.

    Restrictions:

    • Latin letters (A-Z, a-z), numbers (0-9), pluses, slashes, dashes, colons and underscores.
    • From 16 to 255 characters.
    s3_storage_hostname str

    S3 storage hostname.

    The parameter is required if s3_type is other.

    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".
    s3AccessKeyId String
    Access key ID for the S3 account. Masked as SECRET_VALUE in responses.
    s3AuthType String
    S3 authentication type.
    s3BucketName String
    S3 bucket name.
    s3Region String

    S3 storage region.

    The parameter is required if s3_type is amazon.

    s3SecretAccessKey String

    Secret access key for the S3 account. Masked as SECRET_VALUE in responses.

    Restrictions:

    • Latin letters (A-Z, a-z), numbers (0-9), pluses, slashes, dashes, colons and underscores.
    • From 16 to 255 characters.
    s3StorageHostname String

    S3 storage hostname.

    The parameter is required if s3_type is other.

    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 gcore Terraform Provider.
    Viewing docs for gcore 2.0.0-alpha.6
    published on Monday, Apr 27, 2026 by g-core
      Try Pulumi Cloud free. Your team will thank you.