1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. DevOps
  5. Connection
Oracle Cloud Infrastructure v2.17.0 published on Friday, Nov 15, 2024 by Pulumi

oci.DevOps.Connection

Explore with Pulumi AI

oci logo
Oracle Cloud Infrastructure v2.17.0 published on Friday, Nov 15, 2024 by Pulumi

    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[_devops.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 Connection("exampleconnectionResourceResourceFromDevOpsconnection", 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 devops.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[devops.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[_devops.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[_devops.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)
    Resource lookup is not supported in YAML
    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[devops.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 devops.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.17.0 published on Friday, Nov 15, 2024 by Pulumi