Oracle Cloud Infrastructure v0.12.0, Mar 17 23

oci.Mysql.getChannel

This data source provides details about a specific Channel resource in Oracle Cloud Infrastructure MySQL Database service.

Gets the full details of the specified Channel, including the user-specified configuration parameters (passwords are omitted), as well as information about the state of the Channel, its sources and targets.

Example Usage

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

return await Deployment.RunAsync(() => 
{
    var testChannel = Oci.Mysql.GetChannel.Invoke(new()
    {
        ChannelId = oci_mysql_channel.Test_channel.Id,
    });

});

package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := Mysql.GetChannel(ctx, &mysql.GetChannelArgs{
			ChannelId: oci_mysql_channel.Test_channel.Id,
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.Mysql.MysqlFunctions;
import com.pulumi.oci.Mysql.inputs.GetChannelArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var testChannel = MysqlFunctions.getChannel(GetChannelArgs.builder()
            .channelId(oci_mysql_channel.test_channel().id())
            .build());

    }
}

import pulumi
import pulumi_oci as oci

test_channel = oci.Mysql.get_channel(channel_id=oci_mysql_channel["test_channel"]["id"])

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

const testChannel = oci.Mysql.getChannel({
    channelId: oci_mysql_channel.test_channel.id,
});

variables:
  testChannel:
    fn::invoke:
      Function: oci:Mysql:getChannel
      Arguments:
        channelId: ${oci_mysql_channel.test_channel.id}

Using getChannel

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 getChannel(args: GetChannelArgs, opts?: InvokeOptions): Promise<GetChannelResult>
function getChannelOutput(args: GetChannelOutputArgs, opts?: InvokeOptions): Output<GetChannelResult>

def get_channel(channel_id: Optional[str] = None,
                opts: Optional[InvokeOptions] = None) -> GetChannelResult
def get_channel_output(channel_id: Optional[pulumi.Input[str]] = None,
                opts: Optional[InvokeOptions] = None) -> Output[GetChannelResult]

func GetChannel(ctx *Context, args *GetChannelArgs, opts ...InvokeOption) (*GetChannelResult, error)
func GetChannelOutput(ctx *Context, args *GetChannelOutputArgs, opts ...InvokeOption) GetChannelResultOutput

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

public static class GetChannel 
{
    public static Task<GetChannelResult> InvokeAsync(GetChannelArgs args, InvokeOptions? opts = null)
    public static Output<GetChannelResult> Invoke(GetChannelInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetChannelResult> getChannel(GetChannelArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet

fn::invoke:
  function: oci:Mysql/getChannel:getChannel
  arguments:
    # arguments dictionary

The following arguments are supported:

ChannelId string: The Channel OCID.

ChannelId string: The Channel OCID.

channelId String: The Channel OCID.

channelId string: The Channel OCID.

channel_id str: The Channel OCID.

channelId String: The Channel OCID.

getChannel Result

The following output properties are available:

ChannelId string
CompartmentId string: The OCID of the compartment.
DefinedTags Dictionary<string, object>: Usage of predefined tag keys. These predefined keys are scoped to namespaces. Example: {"foo-namespace.bar-key": "value"}
Description string: User provided description of the Channel.
DisplayName string: The user-friendly name for the Channel. It does not have to be unique.
FreeformTags Dictionary<string, object>: Simple key-value pair applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
Id string
IsEnabled bool: Whether the Channel has been enabled by the user.
LifecycleDetails string: A message describing the state of the Channel.
Sources List<GetChannelSource>: Parameters detailing how to provision the source for the given Channel.
State string: The state of the Channel.
Targets List<GetChannelTarget>: Details about the Channel target.
TimeCreated string: The date and time the Channel was created, as described by RFC 3339.
TimeUpdated string: The time the Channel was last updated, as described by RFC 3339.

ChannelId string
CompartmentId string: The OCID of the compartment.
DefinedTags map[string]interface{}: Usage of predefined tag keys. These predefined keys are scoped to namespaces. Example: {"foo-namespace.bar-key": "value"}
Description string: User provided description of the Channel.
DisplayName string: The user-friendly name for the Channel. It does not have to be unique.
FreeformTags map[string]interface{}: Simple key-value pair applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
Id string
IsEnabled bool: Whether the Channel has been enabled by the user.
LifecycleDetails string: A message describing the state of the Channel.
Sources []GetChannelSource: Parameters detailing how to provision the source for the given Channel.
State string: The state of the Channel.
Targets []GetChannelTarget: Details about the Channel target.
TimeCreated string: The date and time the Channel was created, as described by RFC 3339.
TimeUpdated string: The time the Channel was last updated, as described by RFC 3339.

channelId String
compartmentId String: The OCID of the compartment.
definedTags Map<String,Object>: Usage of predefined tag keys. These predefined keys are scoped to namespaces. Example: {"foo-namespace.bar-key": "value"}
description String: User provided description of the Channel.
displayName String: The user-friendly name for the Channel. It does not have to be unique.
freeformTags Map<String,Object>: Simple key-value pair applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
id String
isEnabled Boolean: Whether the Channel has been enabled by the user.
lifecycleDetails String: A message describing the state of the Channel.
sources List<GetChannelSource>: Parameters detailing how to provision the source for the given Channel.
state String: The state of the Channel.
targets List<GetChannelTarget>: Details about the Channel target.
timeCreated String: The date and time the Channel was created, as described by RFC 3339.
timeUpdated String: The time the Channel was last updated, as described by RFC 3339.

channelId string
compartmentId string: The OCID of the compartment.
definedTags {[key: string]: any}: Usage of predefined tag keys. These predefined keys are scoped to namespaces. Example: {"foo-namespace.bar-key": "value"}
description string: User provided description of the Channel.
displayName string: The user-friendly name for the Channel. It does not have to be unique.
freeformTags {[key: string]: any}: Simple key-value pair applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
id string
isEnabled boolean: Whether the Channel has been enabled by the user.
lifecycleDetails string: A message describing the state of the Channel.
sources GetChannelSource[]: Parameters detailing how to provision the source for the given Channel.
state string: The state of the Channel.
targets GetChannelTarget[]: Details about the Channel target.
timeCreated string: The date and time the Channel was created, as described by RFC 3339.
timeUpdated string: The time the Channel was last updated, as described by RFC 3339.

channel_id str
compartment_id str: The OCID of the compartment.
defined_tags Mapping[str, Any]: Usage of predefined tag keys. These predefined keys are scoped to namespaces. Example: {"foo-namespace.bar-key": "value"}
description str: User provided description of the Channel.
display_name str: The user-friendly name for the Channel. It does not have to be unique.
freeform_tags Mapping[str, Any]: Simple key-value pair applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
id str
is_enabled bool: Whether the Channel has been enabled by the user.
lifecycle_details str: A message describing the state of the Channel.
sources GetChannelSource]: Parameters detailing how to provision the source for the given Channel.
state str: The state of the Channel.
targets GetChannelTarget]: Details about the Channel target.
time_created str: The date and time the Channel was created, as described by RFC 3339.
time_updated str: The time the Channel was last updated, as described by RFC 3339.

channelId String
compartmentId String: The OCID of the compartment.
definedTags Map<Any>: Usage of predefined tag keys. These predefined keys are scoped to namespaces. Example: {"foo-namespace.bar-key": "value"}
description String: User provided description of the Channel.
displayName String: The user-friendly name for the Channel. It does not have to be unique.
freeformTags Map<Any>: Simple key-value pair applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: {"bar-key": "value"}
id String
isEnabled Boolean: Whether the Channel has been enabled by the user.
lifecycleDetails String: A message describing the state of the Channel.
sources List<Property Map>: Parameters detailing how to provision the source for the given Channel.
state String: The state of the Channel.
targets List<Property Map>: Details about the Channel target.
timeCreated String: The date and time the Channel was created, as described by RFC 3339.
timeUpdated String: The time the Channel was last updated, as described by RFC 3339.

Supporting Types

GetChannelSource

AnonymousTransactionsHandlings List<GetChannelSourceAnonymousTransactionsHandling>: Specifies how the replication channel handles replicated transactions without an identifier, enabling replication from a source that does not use transaction-id-based replication to a replica that does.
Hostname string: The network address of the MySQL instance.
Password string
Port int: The port the source MySQL instance listens on.
SourceType string: The specific source identifier.
SslCaCertificates List<GetChannelSourceSslCaCertificate>: The CA certificate of the server used for VERIFY_IDENTITY and VERIFY_CA ssl modes.
SslMode string: The SSL mode of the Channel.
Username string: The name of the replication user on the source MySQL instance. The username has a maximum length of 96 characters. For more information, please see the MySQL documentation

AnonymousTransactionsHandlings []GetChannelSourceAnonymousTransactionsHandling: Specifies how the replication channel handles replicated transactions without an identifier, enabling replication from a source that does not use transaction-id-based replication to a replica that does.
Hostname string: The network address of the MySQL instance.
Password string
Port int: The port the source MySQL instance listens on.
SourceType string: The specific source identifier.
SslCaCertificates []GetChannelSourceSslCaCertificate: The CA certificate of the server used for VERIFY_IDENTITY and VERIFY_CA ssl modes.
SslMode string: The SSL mode of the Channel.
Username string: The name of the replication user on the source MySQL instance. The username has a maximum length of 96 characters. For more information, please see the MySQL documentation

anonymousTransactionsHandlings List<GetChannelSourceAnonymousTransactionsHandling>: Specifies how the replication channel handles replicated transactions without an identifier, enabling replication from a source that does not use transaction-id-based replication to a replica that does.
hostname String: The network address of the MySQL instance.
password String
port Integer: The port the source MySQL instance listens on.
sourceType String: The specific source identifier.
sslCaCertificates List<GetChannelSourceSslCaCertificate>: The CA certificate of the server used for VERIFY_IDENTITY and VERIFY_CA ssl modes.
sslMode String: The SSL mode of the Channel.
username String: The name of the replication user on the source MySQL instance. The username has a maximum length of 96 characters. For more information, please see the MySQL documentation

anonymousTransactionsHandlings GetChannelSourceAnonymousTransactionsHandling[]: Specifies how the replication channel handles replicated transactions without an identifier, enabling replication from a source that does not use transaction-id-based replication to a replica that does.
hostname string: The network address of the MySQL instance.
password string
port number: The port the source MySQL instance listens on.
sourceType string: The specific source identifier.
sslCaCertificates GetChannelSourceSslCaCertificate[]: The CA certificate of the server used for VERIFY_IDENTITY and VERIFY_CA ssl modes.
sslMode string: The SSL mode of the Channel.
username string: The name of the replication user on the source MySQL instance. The username has a maximum length of 96 characters. For more information, please see the MySQL documentation

anonymous_transactions_handlings GetChannelSourceAnonymousTransactionsHandling]: Specifies how the replication channel handles replicated transactions without an identifier, enabling replication from a source that does not use transaction-id-based replication to a replica that does.
hostname str: The network address of the MySQL instance.
password str
port int: The port the source MySQL instance listens on.
source_type str: The specific source identifier.
ssl_ca_certificates GetChannelSourceSslCaCertificate]: The CA certificate of the server used for VERIFY_IDENTITY and VERIFY_CA ssl modes.
ssl_mode str: The SSL mode of the Channel.
username str: The name of the replication user on the source MySQL instance. The username has a maximum length of 96 characters. For more information, please see the MySQL documentation

anonymousTransactionsHandlings List<Property Map>: Specifies how the replication channel handles replicated transactions without an identifier, enabling replication from a source that does not use transaction-id-based replication to a replica that does.
hostname String: The network address of the MySQL instance.
password String
port Number: The port the source MySQL instance listens on.
sourceType String: The specific source identifier.
sslCaCertificates List<Property Map>: The CA certificate of the server used for VERIFY_IDENTITY and VERIFY_CA ssl modes.
sslMode String: The SSL mode of the Channel.
username String: The name of the replication user on the source MySQL instance. The username has a maximum length of 96 characters. For more information, please see the MySQL documentation

GetChannelSourceAnonymousTransactionsHandling

LastConfiguredLogFilename string: Specifies one of the coordinates (file) at which the replica should begin reading the source's log. As this value specifies the point where replication starts from, it is only used once, when it starts. It is never used again, unless a new UpdateChannel operation modifies it.
LastConfiguredLogOffset string: Specifies one of the coordinates (offset) at which the replica should begin reading the source's log. As this value specifies the point where replication starts from, it is only used once, when it starts. It is never used again, unless a new UpdateChannel operation modifies it.
Policy string: Specifies how the replication channel handles anonymous transactions.
Uuid string: The UUID that is used as a prefix when generating transaction identifiers for anonymous transactions coming from the source. You can change the UUID later.

LastConfiguredLogFilename string: Specifies one of the coordinates (file) at which the replica should begin reading the source's log. As this value specifies the point where replication starts from, it is only used once, when it starts. It is never used again, unless a new UpdateChannel operation modifies it.
LastConfiguredLogOffset string: Specifies one of the coordinates (offset) at which the replica should begin reading the source's log. As this value specifies the point where replication starts from, it is only used once, when it starts. It is never used again, unless a new UpdateChannel operation modifies it.
Policy string: Specifies how the replication channel handles anonymous transactions.
Uuid string: The UUID that is used as a prefix when generating transaction identifiers for anonymous transactions coming from the source. You can change the UUID later.

lastConfiguredLogFilename String: Specifies one of the coordinates (file) at which the replica should begin reading the source's log. As this value specifies the point where replication starts from, it is only used once, when it starts. It is never used again, unless a new UpdateChannel operation modifies it.
lastConfiguredLogOffset String: Specifies one of the coordinates (offset) at which the replica should begin reading the source's log. As this value specifies the point where replication starts from, it is only used once, when it starts. It is never used again, unless a new UpdateChannel operation modifies it.
policy String: Specifies how the replication channel handles anonymous transactions.
uuid String: The UUID that is used as a prefix when generating transaction identifiers for anonymous transactions coming from the source. You can change the UUID later.

lastConfiguredLogFilename string: Specifies one of the coordinates (file) at which the replica should begin reading the source's log. As this value specifies the point where replication starts from, it is only used once, when it starts. It is never used again, unless a new UpdateChannel operation modifies it.
lastConfiguredLogOffset string: Specifies one of the coordinates (offset) at which the replica should begin reading the source's log. As this value specifies the point where replication starts from, it is only used once, when it starts. It is never used again, unless a new UpdateChannel operation modifies it.
policy string: Specifies how the replication channel handles anonymous transactions.
uuid string: The UUID that is used as a prefix when generating transaction identifiers for anonymous transactions coming from the source. You can change the UUID later.

last_configured_log_filename str: Specifies one of the coordinates (file) at which the replica should begin reading the source's log. As this value specifies the point where replication starts from, it is only used once, when it starts. It is never used again, unless a new UpdateChannel operation modifies it.
last_configured_log_offset str: Specifies one of the coordinates (offset) at which the replica should begin reading the source's log. As this value specifies the point where replication starts from, it is only used once, when it starts. It is never used again, unless a new UpdateChannel operation modifies it.
policy str: Specifies how the replication channel handles anonymous transactions.
uuid str: The UUID that is used as a prefix when generating transaction identifiers for anonymous transactions coming from the source. You can change the UUID later.

lastConfiguredLogFilename String: Specifies one of the coordinates (file) at which the replica should begin reading the source's log. As this value specifies the point where replication starts from, it is only used once, when it starts. It is never used again, unless a new UpdateChannel operation modifies it.
lastConfiguredLogOffset String: Specifies one of the coordinates (offset) at which the replica should begin reading the source's log. As this value specifies the point where replication starts from, it is only used once, when it starts. It is never used again, unless a new UpdateChannel operation modifies it.
policy String: Specifies how the replication channel handles anonymous transactions.
uuid String: The UUID that is used as a prefix when generating transaction identifiers for anonymous transactions coming from the source. You can change the UUID later.

GetChannelSourceSslCaCertificate

CertificateType string: The type of CA certificate.
Contents string: The string containing the CA certificate in PEM format.

CertificateType string: The type of CA certificate.
Contents string: The string containing the CA certificate in PEM format.

certificateType String: The type of CA certificate.
contents String: The string containing the CA certificate in PEM format.

certificateType string: The type of CA certificate.
contents string: The string containing the CA certificate in PEM format.

certificate_type str: The type of CA certificate.
contents str: The string containing the CA certificate in PEM format.

certificateType String: The type of CA certificate.
contents String: The string containing the CA certificate in PEM format.

GetChannelTarget

ApplierUsername string: The username for the replication applier of the target MySQL DB System.
ChannelName string: The case-insensitive name that identifies the replication channel. Channel names must follow the rules defined for MySQL identifiers. The names of non-Deleted Channels must be unique for each DB System.
DbSystemId string: The OCID of the source DB System.
Filters List<GetChannelTargetFilter>: Replication filter rules to be applied at the DB System Channel target.
TargetType string: The specific target identifier.

ApplierUsername string: The username for the replication applier of the target MySQL DB System.
ChannelName string: The case-insensitive name that identifies the replication channel. Channel names must follow the rules defined for MySQL identifiers. The names of non-Deleted Channels must be unique for each DB System.
DbSystemId string: The OCID of the source DB System.
Filters []GetChannelTargetFilter: Replication filter rules to be applied at the DB System Channel target.
TargetType string: The specific target identifier.

applierUsername String: The username for the replication applier of the target MySQL DB System.
channelName String: The case-insensitive name that identifies the replication channel. Channel names must follow the rules defined for MySQL identifiers. The names of non-Deleted Channels must be unique for each DB System.
dbSystemId String: The OCID of the source DB System.
filters List<GetChannelTargetFilter>: Replication filter rules to be applied at the DB System Channel target.
targetType String: The specific target identifier.

applierUsername string: The username for the replication applier of the target MySQL DB System.
channelName string: The case-insensitive name that identifies the replication channel. Channel names must follow the rules defined for MySQL identifiers. The names of non-Deleted Channels must be unique for each DB System.
dbSystemId string: The OCID of the source DB System.
filters GetChannelTargetFilter[]: Replication filter rules to be applied at the DB System Channel target.
targetType string: The specific target identifier.

applier_username str: The username for the replication applier of the target MySQL DB System.
channel_name str: The case-insensitive name that identifies the replication channel. Channel names must follow the rules defined for MySQL identifiers. The names of non-Deleted Channels must be unique for each DB System.
db_system_id str: The OCID of the source DB System.
filters GetChannelTargetFilter]: Replication filter rules to be applied at the DB System Channel target.
target_type str: The specific target identifier.

applierUsername String: The username for the replication applier of the target MySQL DB System.
channelName String: The case-insensitive name that identifies the replication channel. Channel names must follow the rules defined for MySQL identifiers. The names of non-Deleted Channels must be unique for each DB System.
dbSystemId String: The OCID of the source DB System.
filters List<Property Map>: Replication filter rules to be applied at the DB System Channel target.
targetType String: The specific target identifier.

GetChannelTargetFilter

Type string: The type of the filter rule.
Value string: The body of the filter rule. This can represent a database, a table, or a database pair (represented as "db1->db2"). For more information, see Replication Filtering Rules.

Type string: The type of the filter rule.
Value string: The body of the filter rule. This can represent a database, a table, or a database pair (represented as "db1->db2"). For more information, see Replication Filtering Rules.

type String: The type of the filter rule.
value String: The body of the filter rule. This can represent a database, a table, or a database pair (represented as "db1->db2"). For more information, see Replication Filtering Rules.

type string: The type of the filter rule.
value string: The body of the filter rule. This can represent a database, a table, or a database pair (represented as "db1->db2"). For more information, see Replication Filtering Rules.

type str: The type of the filter rule.
value str: The body of the filter rule. This can represent a database, a table, or a database pair (represented as "db1->db2"). For more information, see Replication Filtering Rules.

type String: The type of the filter rule.
value String: The body of the filter rule. This can represent a database, a table, or a database pair (represented as "db1->db2"). For more information, see Replication Filtering Rules.

Package Details

Repository: oci pulumi/pulumi-oci
License: Apache-2.0
Notes: This Pulumi package is based on the oci Terraform Provider.