1. Packages
  2. stackit
  3. API Docs
  4. LogsInstance
Viewing docs for stackit v0.0.4
published on Friday, Feb 20, 2026 by stackitcloud
stackit logo
Viewing docs for stackit v0.0.4
published on Friday, Feb 20, 2026 by stackitcloud

    Logs instance resource schema. Uses the default_region specified in the provider configuration as a fallback in case no region is defined on resource level.

    Example Usage

    resource "stackit_logs_instance" "logs" {
      project_id     = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      region         = "eu01"
      display_name   = "logs-instance-example"
      retention_days = 30
    }
    
    resource "stackit_logs_instance" "logs2" {
      project_id     = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      region         = "eu01"
      display_name   = "logs-instance-example"
      retention_days = 30
      acl = [
        "0.0.0.0/0"
      ]
      description = "Example description"
    }
    
    # Only use the import statement, if you want to import an existing logs instance
    import {
      to = stackit_logs_instance.import-example
      id = "${var.project_id},${var.region},${var.logs_instance_id}"
    }
    

    Create LogsInstance Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new LogsInstance(name: string, args: LogsInstanceArgs, opts?: CustomResourceOptions);
    @overload
    def LogsInstance(resource_name: str,
                     args: LogsInstanceArgs,
                     opts: Optional[ResourceOptions] = None)
    
    @overload
    def LogsInstance(resource_name: str,
                     opts: Optional[ResourceOptions] = None,
                     display_name: Optional[str] = None,
                     project_id: Optional[str] = None,
                     retention_days: Optional[int] = None,
                     acls: Optional[Sequence[str]] = None,
                     description: Optional[str] = None,
                     region: Optional[str] = None)
    func NewLogsInstance(ctx *Context, name string, args LogsInstanceArgs, opts ...ResourceOption) (*LogsInstance, error)
    public LogsInstance(string name, LogsInstanceArgs args, CustomResourceOptions? opts = null)
    public LogsInstance(String name, LogsInstanceArgs args)
    public LogsInstance(String name, LogsInstanceArgs args, CustomResourceOptions options)
    
    type: stackit:LogsInstance
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args LogsInstanceArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args LogsInstanceArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args LogsInstanceArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args LogsInstanceArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args LogsInstanceArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var logsInstanceResource = new Stackit.LogsInstance("logsInstanceResource", new()
    {
        DisplayName = "string",
        ProjectId = "string",
        RetentionDays = 0,
        Acls = new[]
        {
            "string",
        },
        Description = "string",
        Region = "string",
    });
    
    example, err := stackit.NewLogsInstance(ctx, "logsInstanceResource", &stackit.LogsInstanceArgs{
    	DisplayName:   pulumi.String("string"),
    	ProjectId:     pulumi.String("string"),
    	RetentionDays: pulumi.Int(0),
    	Acls: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	Description: pulumi.String("string"),
    	Region:      pulumi.String("string"),
    })
    
    var logsInstanceResource = new LogsInstance("logsInstanceResource", LogsInstanceArgs.builder()
        .displayName("string")
        .projectId("string")
        .retentionDays(0)
        .acls("string")
        .description("string")
        .region("string")
        .build());
    
    logs_instance_resource = stackit.LogsInstance("logsInstanceResource",
        display_name="string",
        project_id="string",
        retention_days=0,
        acls=["string"],
        description="string",
        region="string")
    
    const logsInstanceResource = new stackit.LogsInstance("logsInstanceResource", {
        displayName: "string",
        projectId: "string",
        retentionDays: 0,
        acls: ["string"],
        description: "string",
        region: "string",
    });
    
    type: stackit:LogsInstance
    properties:
        acls:
            - string
        description: string
        displayName: string
        projectId: string
        region: string
        retentionDays: 0
    

    LogsInstance Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The LogsInstance resource accepts the following input properties:

    DisplayName string
    The displayed name of the Logs instance
    ProjectId string
    STACKIT project ID associated with the Logs instance
    RetentionDays int
    The log retention time in days
    Acls List<string>
    The access control list entries for the Logs instance
    Description string
    The description of the Logs instance
    Region string
    STACKIT region name the resource is located in. If not defined, the provider region is used.
    DisplayName string
    The displayed name of the Logs instance
    ProjectId string
    STACKIT project ID associated with the Logs instance
    RetentionDays int
    The log retention time in days
    Acls []string
    The access control list entries for the Logs instance
    Description string
    The description of the Logs instance
    Region string
    STACKIT region name the resource is located in. If not defined, the provider region is used.
    displayName String
    The displayed name of the Logs instance
    projectId String
    STACKIT project ID associated with the Logs instance
    retentionDays Integer
    The log retention time in days
    acls List<String>
    The access control list entries for the Logs instance
    description String
    The description of the Logs instance
    region String
    STACKIT region name the resource is located in. If not defined, the provider region is used.
    displayName string
    The displayed name of the Logs instance
    projectId string
    STACKIT project ID associated with the Logs instance
    retentionDays number
    The log retention time in days
    acls string[]
    The access control list entries for the Logs instance
    description string
    The description of the Logs instance
    region string
    STACKIT region name the resource is located in. If not defined, the provider region is used.
    display_name str
    The displayed name of the Logs instance
    project_id str
    STACKIT project ID associated with the Logs instance
    retention_days int
    The log retention time in days
    acls Sequence[str]
    The access control list entries for the Logs instance
    description str
    The description of the Logs instance
    region str
    STACKIT region name the resource is located in. If not defined, the provider region is used.
    displayName String
    The displayed name of the Logs instance
    projectId String
    STACKIT project ID associated with the Logs instance
    retentionDays Number
    The log retention time in days
    acls List<String>
    The access control list entries for the Logs instance
    description String
    The description of the Logs instance
    region String
    STACKIT region name the resource is located in. If not defined, the provider region is used.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the LogsInstance resource produces the following output properties:

    Created string
    The date and time the creation of the Logs instance was initiated
    DatasourceUrl string
    Logs instance datasource URL, can be used in Grafana as datasource URL
    Id string
    The provider-assigned unique ID for this managed resource.
    IngestOtlpUrl string
    The Logs instance's ingest logs via OTLP URL
    IngestUrl string
    The logs instance's ingest logs URL
    InstanceId string
    The Logs instance ID
    QueryRangeUrl string
    The Logs instance's query range URL
    QueryUrl string
    The Logs instance's query URL
    Status string
    The status of the Logs instance, possible values: Possible values are: active, deleting, reconciling.
    Created string
    The date and time the creation of the Logs instance was initiated
    DatasourceUrl string
    Logs instance datasource URL, can be used in Grafana as datasource URL
    Id string
    The provider-assigned unique ID for this managed resource.
    IngestOtlpUrl string
    The Logs instance's ingest logs via OTLP URL
    IngestUrl string
    The logs instance's ingest logs URL
    InstanceId string
    The Logs instance ID
    QueryRangeUrl string
    The Logs instance's query range URL
    QueryUrl string
    The Logs instance's query URL
    Status string
    The status of the Logs instance, possible values: Possible values are: active, deleting, reconciling.
    created String
    The date and time the creation of the Logs instance was initiated
    datasourceUrl String
    Logs instance datasource URL, can be used in Grafana as datasource URL
    id String
    The provider-assigned unique ID for this managed resource.
    ingestOtlpUrl String
    The Logs instance's ingest logs via OTLP URL
    ingestUrl String
    The logs instance's ingest logs URL
    instanceId String
    The Logs instance ID
    queryRangeUrl String
    The Logs instance's query range URL
    queryUrl String
    The Logs instance's query URL
    status String
    The status of the Logs instance, possible values: Possible values are: active, deleting, reconciling.
    created string
    The date and time the creation of the Logs instance was initiated
    datasourceUrl string
    Logs instance datasource URL, can be used in Grafana as datasource URL
    id string
    The provider-assigned unique ID for this managed resource.
    ingestOtlpUrl string
    The Logs instance's ingest logs via OTLP URL
    ingestUrl string
    The logs instance's ingest logs URL
    instanceId string
    The Logs instance ID
    queryRangeUrl string
    The Logs instance's query range URL
    queryUrl string
    The Logs instance's query URL
    status string
    The status of the Logs instance, possible values: Possible values are: active, deleting, reconciling.
    created str
    The date and time the creation of the Logs instance was initiated
    datasource_url str
    Logs instance datasource URL, can be used in Grafana as datasource URL
    id str
    The provider-assigned unique ID for this managed resource.
    ingest_otlp_url str
    The Logs instance's ingest logs via OTLP URL
    ingest_url str
    The logs instance's ingest logs URL
    instance_id str
    The Logs instance ID
    query_range_url str
    The Logs instance's query range URL
    query_url str
    The Logs instance's query URL
    status str
    The status of the Logs instance, possible values: Possible values are: active, deleting, reconciling.
    created String
    The date and time the creation of the Logs instance was initiated
    datasourceUrl String
    Logs instance datasource URL, can be used in Grafana as datasource URL
    id String
    The provider-assigned unique ID for this managed resource.
    ingestOtlpUrl String
    The Logs instance's ingest logs via OTLP URL
    ingestUrl String
    The logs instance's ingest logs URL
    instanceId String
    The Logs instance ID
    queryRangeUrl String
    The Logs instance's query range URL
    queryUrl String
    The Logs instance's query URL
    status String
    The status of the Logs instance, possible values: Possible values are: active, deleting, reconciling.

    Look up Existing LogsInstance Resource

    Get an existing LogsInstance resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: LogsInstanceState, opts?: CustomResourceOptions): LogsInstance
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            acls: Optional[Sequence[str]] = None,
            created: Optional[str] = None,
            datasource_url: Optional[str] = None,
            description: Optional[str] = None,
            display_name: Optional[str] = None,
            ingest_otlp_url: Optional[str] = None,
            ingest_url: Optional[str] = None,
            instance_id: Optional[str] = None,
            project_id: Optional[str] = None,
            query_range_url: Optional[str] = None,
            query_url: Optional[str] = None,
            region: Optional[str] = None,
            retention_days: Optional[int] = None,
            status: Optional[str] = None) -> LogsInstance
    func GetLogsInstance(ctx *Context, name string, id IDInput, state *LogsInstanceState, opts ...ResourceOption) (*LogsInstance, error)
    public static LogsInstance Get(string name, Input<string> id, LogsInstanceState? state, CustomResourceOptions? opts = null)
    public static LogsInstance get(String name, Output<String> id, LogsInstanceState state, CustomResourceOptions options)
    resources:  _:    type: stackit:LogsInstance    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    Acls List<string>
    The access control list entries for the Logs instance
    Created string
    The date and time the creation of the Logs instance was initiated
    DatasourceUrl string
    Logs instance datasource URL, can be used in Grafana as datasource URL
    Description string
    The description of the Logs instance
    DisplayName string
    The displayed name of the Logs instance
    IngestOtlpUrl string
    The Logs instance's ingest logs via OTLP URL
    IngestUrl string
    The logs instance's ingest logs URL
    InstanceId string
    The Logs instance ID
    ProjectId string
    STACKIT project ID associated with the Logs instance
    QueryRangeUrl string
    The Logs instance's query range URL
    QueryUrl string
    The Logs instance's query URL
    Region string
    STACKIT region name the resource is located in. If not defined, the provider region is used.
    RetentionDays int
    The log retention time in days
    Status string
    The status of the Logs instance, possible values: Possible values are: active, deleting, reconciling.
    Acls []string
    The access control list entries for the Logs instance
    Created string
    The date and time the creation of the Logs instance was initiated
    DatasourceUrl string
    Logs instance datasource URL, can be used in Grafana as datasource URL
    Description string
    The description of the Logs instance
    DisplayName string
    The displayed name of the Logs instance
    IngestOtlpUrl string
    The Logs instance's ingest logs via OTLP URL
    IngestUrl string
    The logs instance's ingest logs URL
    InstanceId string
    The Logs instance ID
    ProjectId string
    STACKIT project ID associated with the Logs instance
    QueryRangeUrl string
    The Logs instance's query range URL
    QueryUrl string
    The Logs instance's query URL
    Region string
    STACKIT region name the resource is located in. If not defined, the provider region is used.
    RetentionDays int
    The log retention time in days
    Status string
    The status of the Logs instance, possible values: Possible values are: active, deleting, reconciling.
    acls List<String>
    The access control list entries for the Logs instance
    created String
    The date and time the creation of the Logs instance was initiated
    datasourceUrl String
    Logs instance datasource URL, can be used in Grafana as datasource URL
    description String
    The description of the Logs instance
    displayName String
    The displayed name of the Logs instance
    ingestOtlpUrl String
    The Logs instance's ingest logs via OTLP URL
    ingestUrl String
    The logs instance's ingest logs URL
    instanceId String
    The Logs instance ID
    projectId String
    STACKIT project ID associated with the Logs instance
    queryRangeUrl String
    The Logs instance's query range URL
    queryUrl String
    The Logs instance's query URL
    region String
    STACKIT region name the resource is located in. If not defined, the provider region is used.
    retentionDays Integer
    The log retention time in days
    status String
    The status of the Logs instance, possible values: Possible values are: active, deleting, reconciling.
    acls string[]
    The access control list entries for the Logs instance
    created string
    The date and time the creation of the Logs instance was initiated
    datasourceUrl string
    Logs instance datasource URL, can be used in Grafana as datasource URL
    description string
    The description of the Logs instance
    displayName string
    The displayed name of the Logs instance
    ingestOtlpUrl string
    The Logs instance's ingest logs via OTLP URL
    ingestUrl string
    The logs instance's ingest logs URL
    instanceId string
    The Logs instance ID
    projectId string
    STACKIT project ID associated with the Logs instance
    queryRangeUrl string
    The Logs instance's query range URL
    queryUrl string
    The Logs instance's query URL
    region string
    STACKIT region name the resource is located in. If not defined, the provider region is used.
    retentionDays number
    The log retention time in days
    status string
    The status of the Logs instance, possible values: Possible values are: active, deleting, reconciling.
    acls Sequence[str]
    The access control list entries for the Logs instance
    created str
    The date and time the creation of the Logs instance was initiated
    datasource_url str
    Logs instance datasource URL, can be used in Grafana as datasource URL
    description str
    The description of the Logs instance
    display_name str
    The displayed name of the Logs instance
    ingest_otlp_url str
    The Logs instance's ingest logs via OTLP URL
    ingest_url str
    The logs instance's ingest logs URL
    instance_id str
    The Logs instance ID
    project_id str
    STACKIT project ID associated with the Logs instance
    query_range_url str
    The Logs instance's query range URL
    query_url str
    The Logs instance's query URL
    region str
    STACKIT region name the resource is located in. If not defined, the provider region is used.
    retention_days int
    The log retention time in days
    status str
    The status of the Logs instance, possible values: Possible values are: active, deleting, reconciling.
    acls List<String>
    The access control list entries for the Logs instance
    created String
    The date and time the creation of the Logs instance was initiated
    datasourceUrl String
    Logs instance datasource URL, can be used in Grafana as datasource URL
    description String
    The description of the Logs instance
    displayName String
    The displayed name of the Logs instance
    ingestOtlpUrl String
    The Logs instance's ingest logs via OTLP URL
    ingestUrl String
    The logs instance's ingest logs URL
    instanceId String
    The Logs instance ID
    projectId String
    STACKIT project ID associated with the Logs instance
    queryRangeUrl String
    The Logs instance's query range URL
    queryUrl String
    The Logs instance's query URL
    region String
    STACKIT region name the resource is located in. If not defined, the provider region is used.
    retentionDays Number
    The log retention time in days
    status String
    The status of the Logs instance, possible values: Possible values are: active, deleting, reconciling.

    Package Details

    Repository
    stackit stackitcloud/pulumi-stackit
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the stackit Terraform Provider.
    stackit logo
    Viewing docs for stackit v0.0.4
    published on Friday, Feb 20, 2026 by stackitcloud
      Try Pulumi Cloud free. Your team will thank you.