Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. DevOps
  5. Connection
Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
pulumi/pulumi-oci

oci.DevOps.Connection

Explore with Pulumi AI

oci logo
Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
pulumi/pulumi-oci

    This resource provides the Connection resource in Oracle Cloud Infrastructure Devops service.

    Creates a new connection.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";

const testConnection = new oci.devops.Connection("test_connection", {
    connectionType: connectionConnectionType,
    projectId: testProject.id,
    accessToken: connectionAccessToken,
    appPassword: connectionAppPassword,
    baseUrl: connectionBaseUrl,
    definedTags: {
        "foo-namespace.bar-key": "value",
    },
    description: connectionDescription,
    displayName: connectionDisplayName,
    freeformTags: {
        "bar-key": "value",
    },
    tlsVerifyConfig: {
        caCertificateBundleId: testCaCertificateBundle.id,
        tlsVerifyMode: connectionTlsVerifyConfigTlsVerifyMode,
    },
    username: connectionUsername,
});

    import pulumi
import pulumi_oci as oci

test_connection = oci.dev_ops.Connection("test_connection",
    connection_type=connection_connection_type,
    project_id=test_project["id"],
    access_token=connection_access_token,
    app_password=connection_app_password,
    base_url=connection_base_url,
    defined_tags={
        "foo-namespace.bar-key": "value",
    },
    description=connection_description,
    display_name=connection_display_name,
    freeform_tags={
        "bar-key": "value",
    },
    tls_verify_config={
        "ca_certificate_bundle_id": test_ca_certificate_bundle["id"],
        "tls_verify_mode": connection_tls_verify_config_tls_verify_mode,
    },
    username=connection_username)

    package main

import (
	"github.com/pulumi/pulumi-oci/sdk/v2/go/oci/devops"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := devops.NewConnection(ctx, "test_connection", &devops.ConnectionArgs{
			ConnectionType: pulumi.Any(connectionConnectionType),
			ProjectId:      pulumi.Any(testProject.Id),
			AccessToken:    pulumi.Any(connectionAccessToken),
			AppPassword:    pulumi.Any(connectionAppPassword),
			BaseUrl:        pulumi.Any(connectionBaseUrl),
			DefinedTags: pulumi.StringMap{
				"foo-namespace.bar-key": pulumi.String("value"),
			},
			Description: pulumi.Any(connectionDescription),
			DisplayName: pulumi.Any(connectionDisplayName),
			FreeformTags: pulumi.StringMap{
				"bar-key": pulumi.String("value"),
			},
			TlsVerifyConfig: &devops.ConnectionTlsVerifyConfigArgs{
				CaCertificateBundleId: pulumi.Any(testCaCertificateBundle.Id),
				TlsVerifyMode:         pulumi.Any(connectionTlsVerifyConfigTlsVerifyMode),
			},
			Username: pulumi.Any(connectionUsername),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Oci = Pulumi.Oci;

return await Deployment.RunAsync(() => 
{
    var testConnection = new Oci.DevOps.Connection("test_connection", new()
    {
        ConnectionType = connectionConnectionType,
        ProjectId = testProject.Id,
        AccessToken = connectionAccessToken,
        AppPassword = connectionAppPassword,
        BaseUrl = connectionBaseUrl,
        DefinedTags = 
        {
            { "foo-namespace.bar-key", "value" },
        },
        Description = connectionDescription,
        DisplayName = connectionDisplayName,
        FreeformTags = 
        {
            { "bar-key", "value" },
        },
        TlsVerifyConfig = new Oci.DevOps.Inputs.ConnectionTlsVerifyConfigArgs
        {
            CaCertificateBundleId = testCaCertificateBundle.Id,
            TlsVerifyMode = connectionTlsVerifyConfigTlsVerifyMode,
        },
        Username = connectionUsername,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.DevOps.Connection;
import com.pulumi.oci.DevOps.ConnectionArgs;
import com.pulumi.oci.DevOps.inputs.ConnectionTlsVerifyConfigArgs;
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) {
        var testConnection = new Connection("testConnection", ConnectionArgs.builder()
            .connectionType(connectionConnectionType)
            .projectId(testProject.id())
            .accessToken(connectionAccessToken)
            .appPassword(connectionAppPassword)
            .baseUrl(connectionBaseUrl)
            .definedTags(Map.of("foo-namespace.bar-key", "value"))
            .description(connectionDescription)
            .displayName(connectionDisplayName)
            .freeformTags(Map.of("bar-key", "value"))
            .tlsVerifyConfig(ConnectionTlsVerifyConfigArgs.builder()
                .caCertificateBundleId(testCaCertificateBundle.id())
                .tlsVerifyMode(connectionTlsVerifyConfigTlsVerifyMode)
                .build())
            .username(connectionUsername)
            .build());

    }
}

    resources:
  testConnection:
    type: oci:DevOps:Connection
    name: test_connection
    properties:
      connectionType: ${connectionConnectionType}
      projectId: ${testProject.id}
      accessToken: ${connectionAccessToken}
      appPassword: ${connectionAppPassword}
      baseUrl: ${connectionBaseUrl}
      definedTags:
        foo-namespace.bar-key: value
      description: ${connectionDescription}
      displayName: ${connectionDisplayName}
      freeformTags:
        bar-key: value
      tlsVerifyConfig:
        caCertificateBundleId: ${testCaCertificateBundle.id}
        tlsVerifyMode: ${connectionTlsVerifyConfigTlsVerifyMode}
      username: ${connectionUsername}

    Create Connection Resource

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

    Constructor syntax

    new Connection(name: string, args: ConnectionArgs, opts?: CustomResourceOptions);
    @overload
def Connection(resource_name: str,
               args: ConnectionArgs,
               opts: Optional[ResourceOptions] = None)

@overload
def Connection(resource_name: str,
               opts: Optional[ResourceOptions] = None,
               connection_type: Optional[str] = None,
               project_id: Optional[str] = None,
               access_token: Optional[str] = None,
               app_password: Optional[str] = None,
               base_url: Optional[str] = None,
               defined_tags: Optional[Mapping[str, str]] = None,
               description: Optional[str] = None,
               display_name: Optional[str] = None,
               freeform_tags: Optional[Mapping[str, str]] = None,
               tls_verify_config: Optional[ConnectionTlsVerifyConfigArgs] = None,
               username: Optional[str] = None)
    func NewConnection(ctx *Context, name string, args ConnectionArgs, opts ...ResourceOption) (*Connection, error)
    public Connection(string name, ConnectionArgs args, CustomResourceOptions? opts = null)
    public Connection(String name, ConnectionArgs args)
public Connection(String name, ConnectionArgs args, CustomResourceOptions options)

    type: oci:DevOps:Connection
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 ConnectionArgs
    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 ConnectionArgs
    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 ConnectionArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ConnectionArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ConnectionArgs
    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 exampleconnectionResourceResourceFromDevOpsconnection = new Oci.DevOps.Connection("exampleconnectionResourceResourceFromDevOpsconnection", new()
{
    ConnectionType = "string",
    ProjectId = "string",
    AccessToken = "string",
    AppPassword = "string",
    BaseUrl = "string",
    DefinedTags = 
    {
        { "string", "string" },
    },
    Description = "string",
    DisplayName = "string",
    FreeformTags = 
    {
        { "string", "string" },
    },
    TlsVerifyConfig = new Oci.DevOps.Inputs.ConnectionTlsVerifyConfigArgs
    {
        CaCertificateBundleId = "string",
        TlsVerifyMode = "string",
    },
    Username = "string",
});

    example, err := devops.NewConnection(ctx, "exampleconnectionResourceResourceFromDevOpsconnection", &devops.ConnectionArgs{
	ConnectionType: pulumi.String("string"),
	ProjectId:      pulumi.String("string"),
	AccessToken:    pulumi.String("string"),
	AppPassword:    pulumi.String("string"),
	BaseUrl:        pulumi.String("string"),
	DefinedTags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	Description: pulumi.String("string"),
	DisplayName: pulumi.String("string"),
	FreeformTags: pulumi.StringMap{
		"string": pulumi.String("string"),
	},
	TlsVerifyConfig: &devops.ConnectionTlsVerifyConfigArgs{
		CaCertificateBundleId: pulumi.String("string"),
		TlsVerifyMode:         pulumi.String("string"),
	},
	Username: pulumi.String("string"),
})

    var exampleconnectionResourceResourceFromDevOpsconnection = new com.pulumi.oci.DevOps.Connection("exampleconnectionResourceResourceFromDevOpsconnection", com.pulumi.oci.DevOps.ConnectionArgs.builder()
    .connectionType("string")
    .projectId("string")
    .accessToken("string")
    .appPassword("string")
    .baseUrl("string")
    .definedTags(Map.of("string", "string"))
    .description("string")
    .displayName("string")
    .freeformTags(Map.of("string", "string"))
    .tlsVerifyConfig(ConnectionTlsVerifyConfigArgs.builder()
        .caCertificateBundleId("string")
        .tlsVerifyMode("string")
        .build())
    .username("string")
    .build());

    exampleconnection_resource_resource_from_dev_opsconnection = oci.dev_ops.Connection("exampleconnectionResourceResourceFromDevOpsconnection",
    connection_type="string",
    project_id="string",
    access_token="string",
    app_password="string",
    base_url="string",
    defined_tags={
        "string": "string",
    },
    description="string",
    display_name="string",
    freeform_tags={
        "string": "string",
    },
    tls_verify_config={
        "ca_certificate_bundle_id": "string",
        "tls_verify_mode": "string",
    },
    username="string")

    const exampleconnectionResourceResourceFromDevOpsconnection = new oci.devops.Connection("exampleconnectionResourceResourceFromDevOpsconnection", {
    connectionType: "string",
    projectId: "string",
    accessToken: "string",
    appPassword: "string",
    baseUrl: "string",
    definedTags: {
        string: "string",
    },
    description: "string",
    displayName: "string",
    freeformTags: {
        string: "string",
    },
    tlsVerifyConfig: {
        caCertificateBundleId: "string",
        tlsVerifyMode: "string",
    },
    username: "string",
});

    type: oci:DevOps:Connection
properties:
    accessToken: string
    appPassword: string
    baseUrl: string
    connectionType: string
    definedTags:
        string: string
    description: string
    displayName: string
    freeformTags:
        string: string
    projectId: string
    tlsVerifyConfig:
        caCertificateBundleId: string
        tlsVerifyMode: string
    username: string

    Connection 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 Connection resource accepts the following input properties:

    ConnectionType string
    (Updatable) The type of connection.
    ProjectId string
    The OCID of the DevOps project.
    AccessToken string
    (Updatable) The OCID of personal access token saved in secret store.
    AppPassword string
    (Updatable) OCID of personal Bitbucket Cloud AppPassword saved in secret store
    BaseUrl string
    (Updatable) The Base URL of the hosted BitbucketServer.
    DefinedTags Dictionary<string, string>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. See Resource Tags. Example: {"foo-namespace.bar-key": "value"}
    Description string
    (Updatable) Optional description about the connection.
    DisplayName string
    (Updatable) Optional connection display name. Avoid entering confidential information.
    FreeformTags Dictionary<string, string>
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. See Resource Tags. Example: {"bar-key": "value"}
    TlsVerifyConfig ConnectionTlsVerifyConfig
    (Updatable) TLS configuration used by build service to verify TLS connection.
    Username string

    (Updatable) Public Bitbucket Cloud Username in plain text(not more than 30 characters)

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    ConnectionType string
    (Updatable) The type of connection.
    ProjectId string
    The OCID of the DevOps project.
    AccessToken string
    (Updatable) The OCID of personal access token saved in secret store.
    AppPassword string
    (Updatable) OCID of personal Bitbucket Cloud AppPassword saved in secret store
    BaseUrl string
    (Updatable) The Base URL of the hosted BitbucketServer.
    DefinedTags map[string]string
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. See Resource Tags. Example: {"foo-namespace.bar-key": "value"}
    Description string
    (Updatable) Optional description about the connection.
    DisplayName string
    (Updatable) Optional connection display name. Avoid entering confidential information.
    FreeformTags map[string]string
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. See Resource Tags. Example: {"bar-key": "value"}
    TlsVerifyConfig ConnectionTlsVerifyConfigArgs
    (Updatable) TLS configuration used by build service to verify TLS connection.
    Username string

    (Updatable) Public Bitbucket Cloud Username in plain text(not more than 30 characters)

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    connectionType String
    (Updatable) The type of connection.
    projectId String
    The OCID of the DevOps project.
    accessToken String
    (Updatable) The OCID of personal access token saved in secret store.
    appPassword String
    (Updatable) OCID of personal Bitbucket Cloud AppPassword saved in secret store
    baseUrl String
    (Updatable) The Base URL of the hosted BitbucketServer.
    definedTags Map<String,String>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. See Resource Tags. Example: {"foo-namespace.bar-key": "value"}
    description String
    (Updatable) Optional description about the connection.
    displayName String
    (Updatable) Optional connection display name. Avoid entering confidential information.
    freeformTags Map<String,String>
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. See Resource Tags. Example: {"bar-key": "value"}
    tlsVerifyConfig ConnectionTlsVerifyConfig
    (Updatable) TLS configuration used by build service to verify TLS connection.
    username String

    (Updatable) Public Bitbucket Cloud Username in plain text(not more than 30 characters)

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    connectionType string
    (Updatable) The type of connection.
    projectId string
    The OCID of the DevOps project.
    accessToken string
    (Updatable) The OCID of personal access token saved in secret store.
    appPassword string
    (Updatable) OCID of personal Bitbucket Cloud AppPassword saved in secret store
    baseUrl string
    (Updatable) The Base URL of the hosted BitbucketServer.
    definedTags {[key: string]: string}
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. See Resource Tags. Example: {"foo-namespace.bar-key": "value"}
    description string
    (Updatable) Optional description about the connection.
    displayName string
    (Updatable) Optional connection display name. Avoid entering confidential information.
    freeformTags {[key: string]: string}
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. See Resource Tags. Example: {"bar-key": "value"}
    tlsVerifyConfig ConnectionTlsVerifyConfig
    (Updatable) TLS configuration used by build service to verify TLS connection.
    username string

    (Updatable) Public Bitbucket Cloud Username in plain text(not more than 30 characters)

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    connection_type str
    (Updatable) The type of connection.
    project_id str
    The OCID of the DevOps project.
    access_token str
    (Updatable) The OCID of personal access token saved in secret store.
    app_password str
    (Updatable) OCID of personal Bitbucket Cloud AppPassword saved in secret store
    base_url str
    (Updatable) The Base URL of the hosted BitbucketServer.
    defined_tags Mapping[str, str]
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. See Resource Tags. Example: {"foo-namespace.bar-key": "value"}
    description str
    (Updatable) Optional description about the connection.
    display_name str
    (Updatable) Optional connection display name. Avoid entering confidential information.
    freeform_tags Mapping[str, str]
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. See Resource Tags. Example: {"bar-key": "value"}
    tls_verify_config ConnectionTlsVerifyConfigArgs
    (Updatable) TLS configuration used by build service to verify TLS connection.
    username str

    (Updatable) Public Bitbucket Cloud Username in plain text(not more than 30 characters)

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    connectionType String
    (Updatable) The type of connection.
    projectId String
    The OCID of the DevOps project.
    accessToken String
    (Updatable) The OCID of personal access token saved in secret store.
    appPassword String
    (Updatable) OCID of personal Bitbucket Cloud AppPassword saved in secret store
    baseUrl String
    (Updatable) The Base URL of the hosted BitbucketServer.
    definedTags Map<String>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. See Resource Tags. Example: {"foo-namespace.bar-key": "value"}
    description String
    (Updatable) Optional description about the connection.
    displayName String
    (Updatable) Optional connection display name. Avoid entering confidential information.
    freeformTags Map<String>
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. See Resource Tags. Example: {"bar-key": "value"}
    tlsVerifyConfig Property Map
    (Updatable) TLS configuration used by build service to verify TLS connection.
    username String

    (Updatable) Public Bitbucket Cloud Username in plain text(not more than 30 characters)

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    Outputs

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

    CompartmentId string
    The OCID of the compartment containing the connection.
    Id string
    The provider-assigned unique ID for this managed resource.
    LastConnectionValidationResults List<ConnectionLastConnectionValidationResult>
    The result of validating the credentials of a connection.
    State string
    The current state of the connection.
    SystemTags Dictionary<string, string>
    Usage of system tag keys. These predefined keys are scoped to namespaces. See Resource Tags. Example: {"orcl-cloud.free-tier-retained": "true"}
    TimeCreated string
    The time the connection was created. Format defined by RFC3339.
    TimeUpdated string
    The time the connection was updated. Format defined by RFC3339.
    CompartmentId string
    The OCID of the compartment containing the connection.
    Id string
    The provider-assigned unique ID for this managed resource.
    LastConnectionValidationResults []ConnectionLastConnectionValidationResult
    The result of validating the credentials of a connection.
    State string
    The current state of the connection.
    SystemTags map[string]string
    Usage of system tag keys. These predefined keys are scoped to namespaces. See Resource Tags. Example: {"orcl-cloud.free-tier-retained": "true"}
    TimeCreated string
    The time the connection was created. Format defined by RFC3339.
    TimeUpdated string
    The time the connection was updated. Format defined by RFC3339.
    compartmentId String
    The OCID of the compartment containing the connection.
    id String
    The provider-assigned unique ID for this managed resource.
    lastConnectionValidationResults List<ConnectionLastConnectionValidationResult>
    The result of validating the credentials of a connection.
    state String
    The current state of the connection.
    systemTags Map<String,String>
    Usage of system tag keys. These predefined keys are scoped to namespaces. See Resource Tags. Example: {"orcl-cloud.free-tier-retained": "true"}
    timeCreated String
    The time the connection was created. Format defined by RFC3339.
    timeUpdated String
    The time the connection was updated. Format defined by RFC3339.
    compartmentId string
    The OCID of the compartment containing the connection.
    id string
    The provider-assigned unique ID for this managed resource.
    lastConnectionValidationResults ConnectionLastConnectionValidationResult[]
    The result of validating the credentials of a connection.
    state string
    The current state of the connection.
    systemTags {[key: string]: string}
    Usage of system tag keys. These predefined keys are scoped to namespaces. See Resource Tags. Example: {"orcl-cloud.free-tier-retained": "true"}
    timeCreated string
    The time the connection was created. Format defined by RFC3339.
    timeUpdated string
    The time the connection was updated. Format defined by RFC3339.
    compartment_id str
    The OCID of the compartment containing the connection.
    id str
    The provider-assigned unique ID for this managed resource.
    last_connection_validation_results Sequence[ConnectionLastConnectionValidationResult]
    The result of validating the credentials of a connection.
    state str
    The current state of the connection.
    system_tags Mapping[str, str]
    Usage of system tag keys. These predefined keys are scoped to namespaces. See Resource Tags. Example: {"orcl-cloud.free-tier-retained": "true"}
    time_created str
    The time the connection was created. Format defined by RFC3339.
    time_updated str
    The time the connection was updated. Format defined by RFC3339.
    compartmentId String
    The OCID of the compartment containing the connection.
    id String
    The provider-assigned unique ID for this managed resource.
    lastConnectionValidationResults List<Property Map>
    The result of validating the credentials of a connection.
    state String
    The current state of the connection.
    systemTags Map<String>
    Usage of system tag keys. These predefined keys are scoped to namespaces. See Resource Tags. Example: {"orcl-cloud.free-tier-retained": "true"}
    timeCreated String
    The time the connection was created. Format defined by RFC3339.
    timeUpdated String
    The time the connection was updated. Format defined by RFC3339.

    Look up Existing Connection Resource

    Get an existing Connection 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?: ConnectionState, opts?: CustomResourceOptions): Connection
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        access_token: Optional[str] = None,
        app_password: Optional[str] = None,
        base_url: Optional[str] = None,
        compartment_id: Optional[str] = None,
        connection_type: Optional[str] = None,
        defined_tags: Optional[Mapping[str, str]] = None,
        description: Optional[str] = None,
        display_name: Optional[str] = None,
        freeform_tags: Optional[Mapping[str, str]] = None,
        last_connection_validation_results: Optional[Sequence[ConnectionLastConnectionValidationResultArgs]] = None,
        project_id: Optional[str] = None,
        state: Optional[str] = None,
        system_tags: Optional[Mapping[str, str]] = None,
        time_created: Optional[str] = None,
        time_updated: Optional[str] = None,
        tls_verify_config: Optional[ConnectionTlsVerifyConfigArgs] = None,
        username: Optional[str] = None) -> Connection
    func GetConnection(ctx *Context, name string, id IDInput, state *ConnectionState, opts ...ResourceOption) (*Connection, error)
    public static Connection Get(string name, Input<string> id, ConnectionState? state, CustomResourceOptions? opts = null)
    public static Connection get(String name, Output<String> id, ConnectionState state, CustomResourceOptions options)
    resources:  _:    type: oci:DevOps:Connection    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:
    AccessToken string
    (Updatable) The OCID of personal access token saved in secret store.
    AppPassword string
    (Updatable) OCID of personal Bitbucket Cloud AppPassword saved in secret store
    BaseUrl string
    (Updatable) The Base URL of the hosted BitbucketServer.
    CompartmentId string
    The OCID of the compartment containing the connection.
    ConnectionType string
    (Updatable) The type of connection.
    DefinedTags Dictionary<string, string>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. See Resource Tags. Example: {"foo-namespace.bar-key": "value"}
    Description string
    (Updatable) Optional description about the connection.
    DisplayName string
    (Updatable) Optional connection display name. Avoid entering confidential information.
    FreeformTags Dictionary<string, string>
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. See Resource Tags. Example: {"bar-key": "value"}
    LastConnectionValidationResults List<ConnectionLastConnectionValidationResult>
    The result of validating the credentials of a connection.
    ProjectId string
    The OCID of the DevOps project.
    State string
    The current state of the connection.
    SystemTags Dictionary<string, string>
    Usage of system tag keys. These predefined keys are scoped to namespaces. See Resource Tags. Example: {"orcl-cloud.free-tier-retained": "true"}
    TimeCreated string
    The time the connection was created. Format defined by RFC3339.
    TimeUpdated string
    The time the connection was updated. Format defined by RFC3339.
    TlsVerifyConfig ConnectionTlsVerifyConfig
    (Updatable) TLS configuration used by build service to verify TLS connection.
    Username string

    (Updatable) Public Bitbucket Cloud Username in plain text(not more than 30 characters)

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    AccessToken string
    (Updatable) The OCID of personal access token saved in secret store.
    AppPassword string
    (Updatable) OCID of personal Bitbucket Cloud AppPassword saved in secret store
    BaseUrl string
    (Updatable) The Base URL of the hosted BitbucketServer.
    CompartmentId string
    The OCID of the compartment containing the connection.
    ConnectionType string
    (Updatable) The type of connection.
    DefinedTags map[string]string
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. See Resource Tags. Example: {"foo-namespace.bar-key": "value"}
    Description string
    (Updatable) Optional description about the connection.
    DisplayName string
    (Updatable) Optional connection display name. Avoid entering confidential information.
    FreeformTags map[string]string
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. See Resource Tags. Example: {"bar-key": "value"}
    LastConnectionValidationResults []ConnectionLastConnectionValidationResultArgs
    The result of validating the credentials of a connection.
    ProjectId string
    The OCID of the DevOps project.
    State string
    The current state of the connection.
    SystemTags map[string]string
    Usage of system tag keys. These predefined keys are scoped to namespaces. See Resource Tags. Example: {"orcl-cloud.free-tier-retained": "true"}
    TimeCreated string
    The time the connection was created. Format defined by RFC3339.
    TimeUpdated string
    The time the connection was updated. Format defined by RFC3339.
    TlsVerifyConfig ConnectionTlsVerifyConfigArgs
    (Updatable) TLS configuration used by build service to verify TLS connection.
    Username string

    (Updatable) Public Bitbucket Cloud Username in plain text(not more than 30 characters)

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    accessToken String
    (Updatable) The OCID of personal access token saved in secret store.
    appPassword String
    (Updatable) OCID of personal Bitbucket Cloud AppPassword saved in secret store
    baseUrl String
    (Updatable) The Base URL of the hosted BitbucketServer.
    compartmentId String
    The OCID of the compartment containing the connection.
    connectionType String
    (Updatable) The type of connection.
    definedTags Map<String,String>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. See Resource Tags. Example: {"foo-namespace.bar-key": "value"}
    description String
    (Updatable) Optional description about the connection.
    displayName String
    (Updatable) Optional connection display name. Avoid entering confidential information.
    freeformTags Map<String,String>
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. See Resource Tags. Example: {"bar-key": "value"}
    lastConnectionValidationResults List<ConnectionLastConnectionValidationResult>
    The result of validating the credentials of a connection.
    projectId String
    The OCID of the DevOps project.
    state String
    The current state of the connection.
    systemTags Map<String,String>
    Usage of system tag keys. These predefined keys are scoped to namespaces. See Resource Tags. Example: {"orcl-cloud.free-tier-retained": "true"}
    timeCreated String
    The time the connection was created. Format defined by RFC3339.
    timeUpdated String
    The time the connection was updated. Format defined by RFC3339.
    tlsVerifyConfig ConnectionTlsVerifyConfig
    (Updatable) TLS configuration used by build service to verify TLS connection.
    username String

    (Updatable) Public Bitbucket Cloud Username in plain text(not more than 30 characters)

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    accessToken string
    (Updatable) The OCID of personal access token saved in secret store.
    appPassword string
    (Updatable) OCID of personal Bitbucket Cloud AppPassword saved in secret store
    baseUrl string
    (Updatable) The Base URL of the hosted BitbucketServer.
    compartmentId string
    The OCID of the compartment containing the connection.
    connectionType string
    (Updatable) The type of connection.
    definedTags {[key: string]: string}
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. See Resource Tags. Example: {"foo-namespace.bar-key": "value"}
    description string
    (Updatable) Optional description about the connection.
    displayName string
    (Updatable) Optional connection display name. Avoid entering confidential information.
    freeformTags {[key: string]: string}
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. See Resource Tags. Example: {"bar-key": "value"}
    lastConnectionValidationResults ConnectionLastConnectionValidationResult[]
    The result of validating the credentials of a connection.
    projectId string
    The OCID of the DevOps project.
    state string
    The current state of the connection.
    systemTags {[key: string]: string}
    Usage of system tag keys. These predefined keys are scoped to namespaces. See Resource Tags. Example: {"orcl-cloud.free-tier-retained": "true"}
    timeCreated string
    The time the connection was created. Format defined by RFC3339.
    timeUpdated string
    The time the connection was updated. Format defined by RFC3339.
    tlsVerifyConfig ConnectionTlsVerifyConfig
    (Updatable) TLS configuration used by build service to verify TLS connection.
    username string

    (Updatable) Public Bitbucket Cloud Username in plain text(not more than 30 characters)

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    access_token str
    (Updatable) The OCID of personal access token saved in secret store.
    app_password str
    (Updatable) OCID of personal Bitbucket Cloud AppPassword saved in secret store
    base_url str
    (Updatable) The Base URL of the hosted BitbucketServer.
    compartment_id str
    The OCID of the compartment containing the connection.
    connection_type str
    (Updatable) The type of connection.
    defined_tags Mapping[str, str]
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. See Resource Tags. Example: {"foo-namespace.bar-key": "value"}
    description str
    (Updatable) Optional description about the connection.
    display_name str
    (Updatable) Optional connection display name. Avoid entering confidential information.
    freeform_tags Mapping[str, str]
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. See Resource Tags. Example: {"bar-key": "value"}
    last_connection_validation_results Sequence[ConnectionLastConnectionValidationResultArgs]
    The result of validating the credentials of a connection.
    project_id str
    The OCID of the DevOps project.
    state str
    The current state of the connection.
    system_tags Mapping[str, str]
    Usage of system tag keys. These predefined keys are scoped to namespaces. See Resource Tags. Example: {"orcl-cloud.free-tier-retained": "true"}
    time_created str
    The time the connection was created. Format defined by RFC3339.
    time_updated str
    The time the connection was updated. Format defined by RFC3339.
    tls_verify_config ConnectionTlsVerifyConfigArgs
    (Updatable) TLS configuration used by build service to verify TLS connection.
    username str

    (Updatable) Public Bitbucket Cloud Username in plain text(not more than 30 characters)

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    accessToken String
    (Updatable) The OCID of personal access token saved in secret store.
    appPassword String
    (Updatable) OCID of personal Bitbucket Cloud AppPassword saved in secret store
    baseUrl String
    (Updatable) The Base URL of the hosted BitbucketServer.
    compartmentId String
    The OCID of the compartment containing the connection.
    connectionType String
    (Updatable) The type of connection.
    definedTags Map<String>
    (Updatable) Defined tags for this resource. Each key is predefined and scoped to a namespace. See Resource Tags. Example: {"foo-namespace.bar-key": "value"}
    description String
    (Updatable) Optional description about the connection.
    displayName String
    (Updatable) Optional connection display name. Avoid entering confidential information.
    freeformTags Map<String>
    (Updatable) Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. See Resource Tags. Example: {"bar-key": "value"}
    lastConnectionValidationResults List<Property Map>
    The result of validating the credentials of a connection.
    projectId String
    The OCID of the DevOps project.
    state String
    The current state of the connection.
    systemTags Map<String>
    Usage of system tag keys. These predefined keys are scoped to namespaces. See Resource Tags. Example: {"orcl-cloud.free-tier-retained": "true"}
    timeCreated String
    The time the connection was created. Format defined by RFC3339.
    timeUpdated String
    The time the connection was updated. Format defined by RFC3339.
    tlsVerifyConfig Property Map
    (Updatable) TLS configuration used by build service to verify TLS connection.
    username String

    (Updatable) Public Bitbucket Cloud Username in plain text(not more than 30 characters)

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    Supporting Types

    ConnectionLastConnectionValidationResult, ConnectionLastConnectionValidationResultArgs

    Message string
    A message describing the result of connection validation in more detail.
    Result string
    The latest result of whether the credentials pass the validation.
    TimeValidated string
    The latest timestamp when the connection was validated. Format defined by RFC3339.
    Message string
    A message describing the result of connection validation in more detail.
    Result string
    The latest result of whether the credentials pass the validation.
    TimeValidated string
    The latest timestamp when the connection was validated. Format defined by RFC3339.
    message String
    A message describing the result of connection validation in more detail.
    result String
    The latest result of whether the credentials pass the validation.
    timeValidated String
    The latest timestamp when the connection was validated. Format defined by RFC3339.
    message string
    A message describing the result of connection validation in more detail.
    result string
    The latest result of whether the credentials pass the validation.
    timeValidated string
    The latest timestamp when the connection was validated. Format defined by RFC3339.
    message str
    A message describing the result of connection validation in more detail.
    result str
    The latest result of whether the credentials pass the validation.
    time_validated str
    The latest timestamp when the connection was validated. Format defined by RFC3339.
    message String
    A message describing the result of connection validation in more detail.
    result String
    The latest result of whether the credentials pass the validation.
    timeValidated String
    The latest timestamp when the connection was validated. Format defined by RFC3339.

    ConnectionTlsVerifyConfig, ConnectionTlsVerifyConfigArgs

    CaCertificateBundleId string
    (Updatable) The OCID of Oracle Cloud Infrastructure certificate service CA bundle.
    TlsVerifyMode string
    (Updatable) The type of TLS verification.
    CaCertificateBundleId string
    (Updatable) The OCID of Oracle Cloud Infrastructure certificate service CA bundle.
    TlsVerifyMode string
    (Updatable) The type of TLS verification.
    caCertificateBundleId String
    (Updatable) The OCID of Oracle Cloud Infrastructure certificate service CA bundle.
    tlsVerifyMode String
    (Updatable) The type of TLS verification.
    caCertificateBundleId string
    (Updatable) The OCID of Oracle Cloud Infrastructure certificate service CA bundle.
    tlsVerifyMode string
    (Updatable) The type of TLS verification.
    ca_certificate_bundle_id str
    (Updatable) The OCID of Oracle Cloud Infrastructure certificate service CA bundle.
    tls_verify_mode str
    (Updatable) The type of TLS verification.
    caCertificateBundleId String
    (Updatable) The OCID of Oracle Cloud Infrastructure certificate service CA bundle.
    tlsVerifyMode String
    (Updatable) The type of TLS verification.

    Import

    Connections can be imported using the id, e.g.

    $ pulumi import oci:DevOps/connection:Connection test_connection "id"

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    oci pulumi/pulumi-oci
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the oci Terraform Provider.
    oci logo
    Oracle Cloud Infrastructure v2.33.0 published on Thursday, May 1, 2025 by Pulumi
    pulumi/pulumi-oci