Viewing docs for DigitalOcean v4.85.0
published on Saturday, Nov 7, 2026 by Pulumi
published on Saturday, Nov 7, 2026 by Pulumi
Viewing docs for DigitalOcean v4.85.0
published on Saturday, Nov 7, 2026 by Pulumi
published on Saturday, Nov 7, 2026 by Pulumi
Get information about an Action Gateway
connection, such as one created in the control panel. Look a connection up by
its id, or by its toolProvider and userId.
The lookup finds only connections visible to the DigitalOcean user who owns Terraform’s API token. Revoked connections are never returned.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as digitalocean from "@pulumi/digitalocean";
const github = digitalocean.getActionGatewayConnection({
toolProvider: "github",
userId: "user-123",
});
export const githubConnectionStatus = github.then(github => github.status);
import pulumi
import pulumi_digitalocean as digitalocean
github = digitalocean.get_action_gateway_connection(tool_provider="github",
user_id="user-123")
pulumi.export("githubConnectionStatus", github.status)
package main
import (
"github.com/pulumi/pulumi-digitalocean/sdk/v4/go/digitalocean"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
github, err := digitalocean.GetActionGatewayConnection(ctx, &digitalocean.LookupActionGatewayConnectionArgs{
ToolProvider: pulumi.StringRef("github"),
UserId: pulumi.StringRef("user-123"),
}, nil)
if err != nil {
return err
}
ctx.Export("githubConnectionStatus", github.Status)
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using DigitalOcean = Pulumi.DigitalOcean;
return await Deployment.RunAsync(() =>
{
var github = DigitalOcean.GetActionGatewayConnection.Invoke(new()
{
ToolProvider = "github",
UserId = "user-123",
});
return new Dictionary<string, object?>
{
["githubConnectionStatus"] = github.Apply(getActionGatewayConnectionResult => getActionGatewayConnectionResult.Status),
};
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.digitalocean.DigitaloceanFunctions;
import com.pulumi.digitalocean.inputs.GetActionGatewayConnectionArgs;
import java.util.ArrayList;
import java.util.Arrays;
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 github = DigitaloceanFunctions.getActionGatewayConnection(GetActionGatewayConnectionArgs.builder()
.toolProvider("github")
.userId("user-123")
.build());
ctx.export("githubConnectionStatus", github.status());
}
}
variables:
github:
fn::invoke:
function: digitalocean:getActionGatewayConnection
arguments:
toolProvider: github
userId: user-123
outputs:
githubConnectionStatus: ${github.status}
terraform {
required_providers {
digitalocean = {
source = "pulumi/digitalocean"
}
}
}
data "digitalocean_action_gateway_connection" "github" {
tool_provider = "github"
user_id = "user-123"
}
output "githubConnectionStatus" {
value = data.digitalocean_action_gateway_connection.github.status
}
Using getActionGatewayConnection
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 getActionGatewayConnection(args: GetActionGatewayConnectionArgs, opts?: InvokeOptions): Promise<GetActionGatewayConnectionResult>
function getActionGatewayConnectionOutput(args: GetActionGatewayConnectionOutputArgs, opts?: InvokeOutputOptions): Output<GetActionGatewayConnectionResult>def get_action_gateway_connection(id: Optional[str] = None,
tool_provider: Optional[str] = None,
user_id: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetActionGatewayConnectionResult
def get_action_gateway_connection_output(id: pulumi.Input[Optional[str]] = None,
tool_provider: pulumi.Input[Optional[str]] = None,
user_id: pulumi.Input[Optional[str]] = None,
opts: Optional[InvokeOutputOptions] = None) -> Output[GetActionGatewayConnectionResult]func LookupActionGatewayConnection(ctx *Context, args *LookupActionGatewayConnectionArgs, opts ...InvokeOption) (*LookupActionGatewayConnectionResult, error)
func LookupActionGatewayConnectionOutput(ctx *Context, args *LookupActionGatewayConnectionOutputArgs, opts ...InvokeOption) LookupActionGatewayConnectionResultOutput> Note: This function is named LookupActionGatewayConnection in the Go SDK.
public static class GetActionGatewayConnection
{
public static Task<GetActionGatewayConnectionResult> InvokeAsync(GetActionGatewayConnectionArgs args, InvokeOptions? opts = null)
public static Output<GetActionGatewayConnectionResult> Invoke(GetActionGatewayConnectionInvokeArgs args, InvokeOptions? opts = null)
public static Output<GetActionGatewayConnectionResult> Invoke(GetActionGatewayConnectionInvokeArgs args, InvokeOutputOptions opts)
}public static CompletableFuture<GetActionGatewayConnectionResult> getActionGatewayConnection(GetActionGatewayConnectionArgs args, InvokeOptions options)
public static Output<GetActionGatewayConnectionResult> getActionGatewayConnection(GetActionGatewayConnectionArgs args, InvokeOptions options)
public static Output<GetActionGatewayConnectionResult> getActionGatewayConnection(GetActionGatewayConnectionArgs args, InvokeOutputOptions options)
fn::invoke:
function: digitalocean:index/getActionGatewayConnection:getActionGatewayConnection
arguments:
# arguments dictionarydata "digitalocean_get_action_gateway_connection" "name" {
# arguments
}The following arguments are supported:
- Id string
- The ID of the connection.
- Tool
Provider string - and
userId- (Optional) The slug of the connection's tool provider and the actor ID it acts for. Both must be set, anduserIdmust match exactly. - User
Id string - The actor ID the connection acts for.
- Id string
- The ID of the connection.
- Tool
Provider string - and
userId- (Optional) The slug of the connection's tool provider and the actor ID it acts for. Both must be set, anduserIdmust match exactly. - User
Id string - The actor ID the connection acts for.
- id string
- The ID of the connection.
- tool_
provider string - and
userId- (Optional) The slug of the connection's tool provider and the actor ID it acts for. Both must be set, anduserIdmust match exactly. - user_
id string - The actor ID the connection acts for.
- id String
- The ID of the connection.
- tool
Provider String - and
userId- (Optional) The slug of the connection's tool provider and the actor ID it acts for. Both must be set, anduserIdmust match exactly. - user
Id String - The actor ID the connection acts for.
- id string
- The ID of the connection.
- tool
Provider string - and
userId- (Optional) The slug of the connection's tool provider and the actor ID it acts for. Both must be set, anduserIdmust match exactly. - user
Id string - The actor ID the connection acts for.
- id str
- The ID of the connection.
- tool_
provider str - and
userId- (Optional) The slug of the connection's tool provider and the actor ID it acts for. Both must be set, anduserIdmust match exactly. - user_
id str - The actor ID the connection acts for.
- id String
- The ID of the connection.
- tool
Provider String - and
userId- (Optional) The slug of the connection's tool provider and the actor ID it acts for. Both must be set, anduserIdmust match exactly. - user
Id String - The actor ID the connection acts for.
getActionGatewayConnection Result
The following output properties are available:
-
List<Pulumi.
Digital Ocean. Outputs. Get Action Gateway Connection Authorization> - The authorization the account holder still has to complete. Set only while the connection is pending.
- Connection
Parameters Dictionary<string, string> - The provider's connection parameters.
- Created
At string - When the connection was created.
- Credential
Id string - The ID of the team provider credential the connection uses, empty for
digitaloceanOauth. - Credential
Kind string - The kind of credential the connection uses:
digitaloceanOauth,privateOauth, orteamApiKey. - Granted
At string - When the account holder completed authorization.
- Id string
- The ID of the connection.
- Owning
User stringId - The DigitalOcean user ID of the user who created the connection.
- Scopes List<string>
- The OAuth scopes granted, or requested while pending.
- Status string
- The status of the authorization.
- Tool
Provider string - The slug of the tool provider.
- Tool
Provider stringDisplay Name - The human-readable name of the tool provider.
- Updated
At string - When the connection was last modified.
- User
Id string - The actor ID the connection acts for.
- Vpcs
List<Pulumi.
Digital Ocean. Outputs. Get Action Gateway Connection Vpc> - The private network the connection's calls use, when configured.
-
[]Get
Action Gateway Connection Authorization - The authorization the account holder still has to complete. Set only while the connection is pending.
- Connection
Parameters map[string]string - The provider's connection parameters.
- Created
At string - When the connection was created.
- Credential
Id string - The ID of the team provider credential the connection uses, empty for
digitaloceanOauth. - Credential
Kind string - The kind of credential the connection uses:
digitaloceanOauth,privateOauth, orteamApiKey. - Granted
At string - When the account holder completed authorization.
- Id string
- The ID of the connection.
- Owning
User stringId - The DigitalOcean user ID of the user who created the connection.
- Scopes []string
- The OAuth scopes granted, or requested while pending.
- Status string
- The status of the authorization.
- Tool
Provider string - The slug of the tool provider.
- Tool
Provider stringDisplay Name - The human-readable name of the tool provider.
- Updated
At string - When the connection was last modified.
- User
Id string - The actor ID the connection acts for.
- Vpcs
[]Get
Action Gateway Connection Vpc - The private network the connection's calls use, when configured.
- list(object)
- The authorization the account holder still has to complete. Set only while the connection is pending.
- connection_
parameters map(string) - The provider's connection parameters.
- created_
at string - When the connection was created.
- credential_
id string - The ID of the team provider credential the connection uses, empty for
digitaloceanOauth. - credential_
kind string - The kind of credential the connection uses:
digitaloceanOauth,privateOauth, orteamApiKey. - granted_
at string - When the account holder completed authorization.
- id string
- The ID of the connection.
- owning_
user_ stringid - The DigitalOcean user ID of the user who created the connection.
- scopes list(string)
- The OAuth scopes granted, or requested while pending.
- status string
- The status of the authorization.
- tool_
provider string - The slug of the tool provider.
- tool_
provider_ stringdisplay_ name - The human-readable name of the tool provider.
- updated_
at string - When the connection was last modified.
- user_
id string - The actor ID the connection acts for.
- vpcs list(object)
- The private network the connection's calls use, when configured.
-
List<Get
Action Gateway Connection Authorization> - The authorization the account holder still has to complete. Set only while the connection is pending.
- connection
Parameters Map<String,String> - The provider's connection parameters.
- created
At String - When the connection was created.
- credential
Id String - The ID of the team provider credential the connection uses, empty for
digitaloceanOauth. - credential
Kind String - The kind of credential the connection uses:
digitaloceanOauth,privateOauth, orteamApiKey. - granted
At String - When the account holder completed authorization.
- id String
- The ID of the connection.
- owning
User StringId - The DigitalOcean user ID of the user who created the connection.
- scopes List<String>
- The OAuth scopes granted, or requested while pending.
- status String
- The status of the authorization.
- tool
Provider String - The slug of the tool provider.
- tool
Provider StringDisplay Name - The human-readable name of the tool provider.
- updated
At String - When the connection was last modified.
- user
Id String - The actor ID the connection acts for.
- vpcs
List<Get
Action Gateway Connection Vpc> - The private network the connection's calls use, when configured.
-
Get
Action Gateway Connection Authorization[] - The authorization the account holder still has to complete. Set only while the connection is pending.
- connection
Parameters {[key: string]: string} - The provider's connection parameters.
- created
At string - When the connection was created.
- credential
Id string - The ID of the team provider credential the connection uses, empty for
digitaloceanOauth. - credential
Kind string - The kind of credential the connection uses:
digitaloceanOauth,privateOauth, orteamApiKey. - granted
At string - When the account holder completed authorization.
- id string
- The ID of the connection.
- owning
User stringId - The DigitalOcean user ID of the user who created the connection.
- scopes string[]
- The OAuth scopes granted, or requested while pending.
- status string
- The status of the authorization.
- tool
Provider string - The slug of the tool provider.
- tool
Provider stringDisplay Name - The human-readable name of the tool provider.
- updated
At string - When the connection was last modified.
- user
Id string - The actor ID the connection acts for.
- vpcs
Get
Action Gateway Connection Vpc[] - The private network the connection's calls use, when configured.
-
Sequence[Get
Action Gateway Connection Authorization] - The authorization the account holder still has to complete. Set only while the connection is pending.
- connection_
parameters Mapping[str, str] - The provider's connection parameters.
- created_
at str - When the connection was created.
- credential_
id str - The ID of the team provider credential the connection uses, empty for
digitaloceanOauth. - credential_
kind str - The kind of credential the connection uses:
digitaloceanOauth,privateOauth, orteamApiKey. - granted_
at str - When the account holder completed authorization.
- id str
- The ID of the connection.
- owning_
user_ strid - The DigitalOcean user ID of the user who created the connection.
- scopes Sequence[str]
- The OAuth scopes granted, or requested while pending.
- status str
- The status of the authorization.
- tool_
provider str - The slug of the tool provider.
- tool_
provider_ strdisplay_ name - The human-readable name of the tool provider.
- updated_
at str - When the connection was last modified.
- user_
id str - The actor ID the connection acts for.
- vpcs
Sequence[Get
Action Gateway Connection Vpc] - The private network the connection's calls use, when configured.
- List<Property Map>
- The authorization the account holder still has to complete. Set only while the connection is pending.
- connection
Parameters Map<String> - The provider's connection parameters.
- created
At String - When the connection was created.
- credential
Id String - The ID of the team provider credential the connection uses, empty for
digitaloceanOauth. - credential
Kind String - The kind of credential the connection uses:
digitaloceanOauth,privateOauth, orteamApiKey. - granted
At String - When the account holder completed authorization.
- id String
- The ID of the connection.
- owning
User StringId - The DigitalOcean user ID of the user who created the connection.
- scopes List<String>
- The OAuth scopes granted, or requested while pending.
- status String
- The status of the authorization.
- tool
Provider String - The slug of the tool provider.
- tool
Provider StringDisplay Name - The human-readable name of the tool provider.
- updated
At String - When the connection was last modified.
- user
Id String - The actor ID the connection acts for.
- vpcs List<Property Map>
- The private network the connection's calls use, when configured.
Supporting Types
GetActionGatewayConnectionAuthorization
- Connect
Url string - (Sensitive) The URL the account holder opens to authorize the provider.
- Expires
At string - When the authorization link expires.
- Status string
- The status of the authorization.
- Verification
Code string - (Sensitive) The code the account holder confirms during authorization.
- Connect
Url string - (Sensitive) The URL the account holder opens to authorize the provider.
- Expires
At string - When the authorization link expires.
- Status string
- The status of the authorization.
- Verification
Code string - (Sensitive) The code the account holder confirms during authorization.
- connect_
url string - (Sensitive) The URL the account holder opens to authorize the provider.
- expires_
at string - When the authorization link expires.
- status string
- The status of the authorization.
- verification_
code string - (Sensitive) The code the account holder confirms during authorization.
- connect
Url String - (Sensitive) The URL the account holder opens to authorize the provider.
- expires
At String - When the authorization link expires.
- status String
- The status of the authorization.
- verification
Code String - (Sensitive) The code the account holder confirms during authorization.
- connect
Url string - (Sensitive) The URL the account holder opens to authorize the provider.
- expires
At string - When the authorization link expires.
- status string
- The status of the authorization.
- verification
Code string - (Sensitive) The code the account holder confirms during authorization.
- connect_
url str - (Sensitive) The URL the account holder opens to authorize the provider.
- expires_
at str - When the authorization link expires.
- status str
- The status of the authorization.
- verification_
code str - (Sensitive) The code the account holder confirms during authorization.
- connect
Url String - (Sensitive) The URL the account holder opens to authorize the provider.
- expires
At String - When the authorization link expires.
- status String
- The status of the authorization.
- verification
Code String - (Sensitive) The code the account holder confirms during authorization.
GetActionGatewayConnectionVpc
- Destinations
List<Pulumi.
Digital Ocean. Inputs. Get Action Gateway Connection Vpc Destination> - The private hosts the connection's calls may reach, each with
host,port, andallowedIpCidrs. - Region string
- The region of the VPC.
- Vpc
Uuid string - The UUID of the VPC.
- Destinations
[]Get
Action Gateway Connection Vpc Destination - The private hosts the connection's calls may reach, each with
host,port, andallowedIpCidrs. - Region string
- The region of the VPC.
- Vpc
Uuid string - The UUID of the VPC.
- destinations list(object)
- The private hosts the connection's calls may reach, each with
host,port, andallowedIpCidrs. - region string
- The region of the VPC.
- vpc_
uuid string - The UUID of the VPC.
- destinations
List<Get
Action Gateway Connection Vpc Destination> - The private hosts the connection's calls may reach, each with
host,port, andallowedIpCidrs. - region String
- The region of the VPC.
- vpc
Uuid String - The UUID of the VPC.
- destinations
Get
Action Gateway Connection Vpc Destination[] - The private hosts the connection's calls may reach, each with
host,port, andallowedIpCidrs. - region string
- The region of the VPC.
- vpc
Uuid string - The UUID of the VPC.
- destinations
Sequence[Get
Action Gateway Connection Vpc Destination] - The private hosts the connection's calls may reach, each with
host,port, andallowedIpCidrs. - region str
- The region of the VPC.
- vpc_
uuid str - The UUID of the VPC.
- destinations List<Property Map>
- The private hosts the connection's calls may reach, each with
host,port, andallowedIpCidrs. - region String
- The region of the VPC.
- vpc
Uuid String - The UUID of the VPC.
GetActionGatewayConnectionVpcDestination
- Allowed
Ip List<string>Cidrs - CIDR ranges that every address the host resolves to must fall within
- Host string
- Host name or IP address that resolves only to private addresses
- Port int
- Destination port
- Allowed
Ip []stringCidrs - CIDR ranges that every address the host resolves to must fall within
- Host string
- Host name or IP address that resolves only to private addresses
- Port int
- Destination port
- allowed_
ip_ list(string)cidrs - CIDR ranges that every address the host resolves to must fall within
- host string
- Host name or IP address that resolves only to private addresses
- port number
- Destination port
- allowed
Ip List<String>Cidrs - CIDR ranges that every address the host resolves to must fall within
- host String
- Host name or IP address that resolves only to private addresses
- port Integer
- Destination port
- allowed
Ip string[]Cidrs - CIDR ranges that every address the host resolves to must fall within
- host string
- Host name or IP address that resolves only to private addresses
- port number
- Destination port
- allowed_
ip_ Sequence[str]cidrs - CIDR ranges that every address the host resolves to must fall within
- host str
- Host name or IP address that resolves only to private addresses
- port int
- Destination port
- allowed
Ip List<String>Cidrs - CIDR ranges that every address the host resolves to must fall within
- host String
- Host name or IP address that resolves only to private addresses
- port Number
- Destination port
Package Details
- Repository
- DigitalOcean pulumi/pulumi-digitalocean
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
digitaloceanTerraform Provider.
Viewing docs for DigitalOcean v4.85.0
published on Saturday, Nov 7, 2026 by Pulumi
published on Saturday, Nov 7, 2026 by Pulumi