1. Packages
  2. Packages
  3. Gitlab Provider
  4. API Docs
  5. getRunnerController
Viewing docs for GitLab v9.11.0
published on Tuesday, Apr 21, 2026 by Pulumi
gitlab logo
Viewing docs for GitLab v9.11.0
published on Tuesday, Apr 21, 2026 by Pulumi

    The gitlab.RunnerController data source retrieves details about a single runner controller.

    This data source is experimental and may change or be removed in future versions. Introduced in GitLab 18.9.

    This data source requires administration privileges.

    Upstream API: GitLab REST API docs

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as gitlab from "@pulumi/gitlab";
    
    const example = gitlab.getRunnerController({
        id: 1,
    });
    
    import pulumi
    import pulumi_gitlab as gitlab
    
    example = gitlab.get_runner_controller(id=1)
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-gitlab/sdk/v9/go/gitlab"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := gitlab.GetRunnerController(ctx, &gitlab.LookupRunnerControllerArgs{
    			Id: 1,
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using GitLab = Pulumi.GitLab;
    
    return await Deployment.RunAsync(() => 
    {
        var example = GitLab.Index.GetRunnerController.Invoke(new()
        {
            Id = 1,
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.gitlab.GitlabFunctions;
    import com.pulumi.gitlab.inputs.GetRunnerControllerArgs;
    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 example = GitlabFunctions.getRunnerController(GetRunnerControllerArgs.builder()
                .id(1)
                .build());
    
        }
    }
    
    variables:
      example:
        fn::invoke:
          function: gitlab:getRunnerController
          arguments:
            id: 1
    

    Using getRunnerController

    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 getRunnerController(args: GetRunnerControllerArgs, opts?: InvokeOptions): Promise<GetRunnerControllerResult>
    function getRunnerControllerOutput(args: GetRunnerControllerOutputArgs, opts?: InvokeOptions): Output<GetRunnerControllerResult>
    def get_runner_controller(id: Optional[int] = None,
                              opts: Optional[InvokeOptions] = None) -> GetRunnerControllerResult
    def get_runner_controller_output(id: Optional[pulumi.Input[int]] = None,
                              opts: Optional[InvokeOptions] = None) -> Output[GetRunnerControllerResult]
    func LookupRunnerController(ctx *Context, args *LookupRunnerControllerArgs, opts ...InvokeOption) (*LookupRunnerControllerResult, error)
    func LookupRunnerControllerOutput(ctx *Context, args *LookupRunnerControllerOutputArgs, opts ...InvokeOption) LookupRunnerControllerResultOutput

    > Note: This function is named LookupRunnerController in the Go SDK.

    public static class GetRunnerController 
    {
        public static Task<GetRunnerControllerResult> InvokeAsync(GetRunnerControllerArgs args, InvokeOptions? opts = null)
        public static Output<GetRunnerControllerResult> Invoke(GetRunnerControllerInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetRunnerControllerResult> getRunnerController(GetRunnerControllerArgs args, InvokeOptions options)
    public static Output<GetRunnerControllerResult> getRunnerController(GetRunnerControllerArgs args, InvokeOptions options)
    
    fn::invoke:
      function: gitlab:index/getRunnerController:getRunnerController
      arguments:
        # arguments dictionary

    The following arguments are supported:

    Id int
    The ID of the runner controller.
    Id int
    The ID of the runner controller.
    id Integer
    The ID of the runner controller.
    id number
    The ID of the runner controller.
    id int
    The ID of the runner controller.
    id Number
    The ID of the runner controller.

    getRunnerController Result

    The following output properties are available:

    CreatedAt string
    The time the runner controller was created.
    Description string
    The description of the runner controller.
    Id int
    The ID of the runner controller.
    State string
    The state of the runner controller. Valid values are: disabled, enabled, dryRun.
    UpdatedAt string
    The time the runner controller was last updated.
    CreatedAt string
    The time the runner controller was created.
    Description string
    The description of the runner controller.
    Id int
    The ID of the runner controller.
    State string
    The state of the runner controller. Valid values are: disabled, enabled, dryRun.
    UpdatedAt string
    The time the runner controller was last updated.
    createdAt String
    The time the runner controller was created.
    description String
    The description of the runner controller.
    id Integer
    The ID of the runner controller.
    state String
    The state of the runner controller. Valid values are: disabled, enabled, dryRun.
    updatedAt String
    The time the runner controller was last updated.
    createdAt string
    The time the runner controller was created.
    description string
    The description of the runner controller.
    id number
    The ID of the runner controller.
    state string
    The state of the runner controller. Valid values are: disabled, enabled, dryRun.
    updatedAt string
    The time the runner controller was last updated.
    created_at str
    The time the runner controller was created.
    description str
    The description of the runner controller.
    id int
    The ID of the runner controller.
    state str
    The state of the runner controller. Valid values are: disabled, enabled, dryRun.
    updated_at str
    The time the runner controller was last updated.
    createdAt String
    The time the runner controller was created.
    description String
    The description of the runner controller.
    id Number
    The ID of the runner controller.
    state String
    The state of the runner controller. Valid values are: disabled, enabled, dryRun.
    updatedAt String
    The time the runner controller was last updated.

    Package Details

    Repository
    GitLab pulumi/pulumi-gitlab
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the gitlab Terraform Provider.
    gitlab logo
    Viewing docs for GitLab v9.11.0
    published on Tuesday, Apr 21, 2026 by Pulumi
      Try Pulumi Cloud free. Your team will thank you.