1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. Email
  5. getEmailIpPool
Viewing docs for Oracle Cloud Infrastructure v4.2.0
published on Friday, Mar 6, 2026 by Pulumi
oci logo
Viewing docs for Oracle Cloud Infrastructure v4.2.0
published on Friday, Mar 6, 2026 by Pulumi

    This data source provides details about a specific Email Ip Pool resource in Oracle Cloud Infrastructure Email service.

    Retrieves the specified IpPool by identifier

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as oci from "@pulumi/oci";
    
    const testEmailIpPool = oci.Email.getEmailIpPool({
        emailIpPoolId: testEmailIpPoolOciEmailEmailIpPool.id,
    });
    
    import pulumi
    import pulumi_oci as oci
    
    test_email_ip_pool = oci.Email.get_email_ip_pool(email_ip_pool_id=test_email_ip_pool_oci_email_email_ip_pool["id"])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-oci/sdk/v4/go/oci/email"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := email.GetEmailIpPool(ctx, &email.GetEmailIpPoolArgs{
    			EmailIpPoolId: testEmailIpPoolOciEmailEmailIpPool.Id,
    		}, nil)
    		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 testEmailIpPool = Oci.Email.GetEmailIpPool.Invoke(new()
        {
            EmailIpPoolId = testEmailIpPoolOciEmailEmailIpPool.Id,
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.oci.Email.EmailFunctions;
    import com.pulumi.oci.Email.inputs.GetEmailIpPoolArgs;
    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 testEmailIpPool = EmailFunctions.getEmailIpPool(GetEmailIpPoolArgs.builder()
                .emailIpPoolId(testEmailIpPoolOciEmailEmailIpPool.id())
                .build());
    
        }
    }
    
    variables:
      testEmailIpPool:
        fn::invoke:
          function: oci:Email:getEmailIpPool
          arguments:
            emailIpPoolId: ${testEmailIpPoolOciEmailEmailIpPool.id}
    

    Using getEmailIpPool

    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 getEmailIpPool(args: GetEmailIpPoolArgs, opts?: InvokeOptions): Promise<GetEmailIpPoolResult>
    function getEmailIpPoolOutput(args: GetEmailIpPoolOutputArgs, opts?: InvokeOptions): Output<GetEmailIpPoolResult>
    def get_email_ip_pool(email_ip_pool_id: Optional[str] = None,
                          opts: Optional[InvokeOptions] = None) -> GetEmailIpPoolResult
    def get_email_ip_pool_output(email_ip_pool_id: Optional[pulumi.Input[str]] = None,
                          opts: Optional[InvokeOptions] = None) -> Output[GetEmailIpPoolResult]
    func LookupEmailIpPool(ctx *Context, args *LookupEmailIpPoolArgs, opts ...InvokeOption) (*LookupEmailIpPoolResult, error)
    func LookupEmailIpPoolOutput(ctx *Context, args *LookupEmailIpPoolOutputArgs, opts ...InvokeOption) LookupEmailIpPoolResultOutput

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

    public static class GetEmailIpPool 
    {
        public static Task<GetEmailIpPoolResult> InvokeAsync(GetEmailIpPoolArgs args, InvokeOptions? opts = null)
        public static Output<GetEmailIpPoolResult> Invoke(GetEmailIpPoolInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetEmailIpPoolResult> getEmailIpPool(GetEmailIpPoolArgs args, InvokeOptions options)
    public static Output<GetEmailIpPoolResult> getEmailIpPool(GetEmailIpPoolArgs args, InvokeOptions options)
    
    fn::invoke:
      function: oci:Email/getEmailIpPool:getEmailIpPool
      arguments:
        # arguments dictionary

    The following arguments are supported:

    EmailIpPoolId string
    The OCID of the IpPool.
    EmailIpPoolId string
    The OCID of the IpPool.
    emailIpPoolId String
    The OCID of the IpPool.
    emailIpPoolId string
    The OCID of the IpPool.
    email_ip_pool_id str
    The OCID of the IpPool.
    emailIpPoolId String
    The OCID of the IpPool.

    getEmailIpPool Result

    The following output properties are available:

    CompartmentId string
    The lock compartment ID.
    DefinedTags Dictionary<string, string>
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    Description string
    The description of the IpPool. Avoid entering confidential information.
    EmailIpPoolId string
    FreeformTags Dictionary<string, string>
    Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    Id string
    The unique OCID of the IpPool resource that is immutable on creation.
    LifecycleDetails string
    A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in 'DRAINING' state.
    Locks List<GetEmailIpPoolLock>
    Locks associated with this resource.
    Name string
    The name of the IpPool. The name must be unique within a region. The name is case sensitive and supported characters include alphanumeric, hyphens ("-") and underscore ("_") characters. Example: green_pool-1
    OutboundIps List<string>
    Summary of outbound IPs assigned to the IpPool.
    OutboundIpsResponses List<GetEmailIpPoolOutboundIpsResponse>
    State string
    The current state of the IpPool.
    SystemTags Dictionary<string, string>
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    TimeCreated string
    The time the IpPool was created. Times are expressed in RFC 3339 timestamp format, "YYYY-MM-ddThh:mmZ". Example: 2021-02-12T22:47:12.613Z
    TimeUpdated string
    The time of the last change to the IpPool, due to a state change or an update operation. Times are expressed in RFC 3339 timestamp format, "YYYY-MM-ddThh:mmZ".
    CompartmentId string
    The lock compartment ID.
    DefinedTags map[string]string
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    Description string
    The description of the IpPool. Avoid entering confidential information.
    EmailIpPoolId string
    FreeformTags map[string]string
    Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    Id string
    The unique OCID of the IpPool resource that is immutable on creation.
    LifecycleDetails string
    A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in 'DRAINING' state.
    Locks []GetEmailIpPoolLock
    Locks associated with this resource.
    Name string
    The name of the IpPool. The name must be unique within a region. The name is case sensitive and supported characters include alphanumeric, hyphens ("-") and underscore ("_") characters. Example: green_pool-1
    OutboundIps []string
    Summary of outbound IPs assigned to the IpPool.
    OutboundIpsResponses []GetEmailIpPoolOutboundIpsResponse
    State string
    The current state of the IpPool.
    SystemTags map[string]string
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    TimeCreated string
    The time the IpPool was created. Times are expressed in RFC 3339 timestamp format, "YYYY-MM-ddThh:mmZ". Example: 2021-02-12T22:47:12.613Z
    TimeUpdated string
    The time of the last change to the IpPool, due to a state change or an update operation. Times are expressed in RFC 3339 timestamp format, "YYYY-MM-ddThh:mmZ".
    compartmentId String
    The lock compartment ID.
    definedTags Map<String,String>
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    description String
    The description of the IpPool. Avoid entering confidential information.
    emailIpPoolId String
    freeformTags Map<String,String>
    Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    id String
    The unique OCID of the IpPool resource that is immutable on creation.
    lifecycleDetails String
    A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in 'DRAINING' state.
    locks List<GetIpPoolLock>
    Locks associated with this resource.
    name String
    The name of the IpPool. The name must be unique within a region. The name is case sensitive and supported characters include alphanumeric, hyphens ("-") and underscore ("_") characters. Example: green_pool-1
    outboundIps List<String>
    Summary of outbound IPs assigned to the IpPool.
    outboundIpsResponses List<GetIpPoolOutboundIpsResponse>
    state String
    The current state of the IpPool.
    systemTags Map<String,String>
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    timeCreated String
    The time the IpPool was created. Times are expressed in RFC 3339 timestamp format, "YYYY-MM-ddThh:mmZ". Example: 2021-02-12T22:47:12.613Z
    timeUpdated String
    The time of the last change to the IpPool, due to a state change or an update operation. Times are expressed in RFC 3339 timestamp format, "YYYY-MM-ddThh:mmZ".
    compartmentId string
    The lock compartment ID.
    definedTags {[key: string]: string}
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    description string
    The description of the IpPool. Avoid entering confidential information.
    emailIpPoolId string
    freeformTags {[key: string]: string}
    Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    id string
    The unique OCID of the IpPool resource that is immutable on creation.
    lifecycleDetails string
    A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in 'DRAINING' state.
    locks GetEmailIpPoolLock[]
    Locks associated with this resource.
    name string
    The name of the IpPool. The name must be unique within a region. The name is case sensitive and supported characters include alphanumeric, hyphens ("-") and underscore ("_") characters. Example: green_pool-1
    outboundIps string[]
    Summary of outbound IPs assigned to the IpPool.
    outboundIpsResponses GetEmailIpPoolOutboundIpsResponse[]
    state string
    The current state of the IpPool.
    systemTags {[key: string]: string}
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    timeCreated string
    The time the IpPool was created. Times are expressed in RFC 3339 timestamp format, "YYYY-MM-ddThh:mmZ". Example: 2021-02-12T22:47:12.613Z
    timeUpdated string
    The time of the last change to the IpPool, due to a state change or an update operation. Times are expressed in RFC 3339 timestamp format, "YYYY-MM-ddThh:mmZ".
    compartment_id str
    The lock compartment ID.
    defined_tags Mapping[str, str]
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    description str
    The description of the IpPool. Avoid entering confidential information.
    email_ip_pool_id str
    freeform_tags Mapping[str, str]
    Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    id str
    The unique OCID of the IpPool resource that is immutable on creation.
    lifecycle_details str
    A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in 'DRAINING' state.
    locks Sequence[GetEmailIpPoolLock]
    Locks associated with this resource.
    name str
    The name of the IpPool. The name must be unique within a region. The name is case sensitive and supported characters include alphanumeric, hyphens ("-") and underscore ("_") characters. Example: green_pool-1
    outbound_ips Sequence[str]
    Summary of outbound IPs assigned to the IpPool.
    outbound_ips_responses Sequence[GetEmailIpPoolOutboundIpsResponse]
    state str
    The current state of the IpPool.
    system_tags Mapping[str, str]
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    time_created str
    The time the IpPool was created. Times are expressed in RFC 3339 timestamp format, "YYYY-MM-ddThh:mmZ". Example: 2021-02-12T22:47:12.613Z
    time_updated str
    The time of the last change to the IpPool, due to a state change or an update operation. Times are expressed in RFC 3339 timestamp format, "YYYY-MM-ddThh:mmZ".
    compartmentId String
    The lock compartment ID.
    definedTags Map<String>
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    description String
    The description of the IpPool. Avoid entering confidential information.
    emailIpPoolId String
    freeformTags Map<String>
    Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}
    id String
    The unique OCID of the IpPool resource that is immutable on creation.
    lifecycleDetails String
    A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in 'DRAINING' state.
    locks List<Property Map>
    Locks associated with this resource.
    name String
    The name of the IpPool. The name must be unique within a region. The name is case sensitive and supported characters include alphanumeric, hyphens ("-") and underscore ("_") characters. Example: green_pool-1
    outboundIps List<String>
    Summary of outbound IPs assigned to the IpPool.
    outboundIpsResponses List<Property Map>
    state String
    The current state of the IpPool.
    systemTags Map<String>
    Usage of system tag keys. These predefined keys are scoped to namespaces. Example: {"orcl-cloud.free-tier-retained": "true"}
    timeCreated String
    The time the IpPool was created. Times are expressed in RFC 3339 timestamp format, "YYYY-MM-ddThh:mmZ". Example: 2021-02-12T22:47:12.613Z
    timeUpdated String
    The time of the last change to the IpPool, due to a state change or an update operation. Times are expressed in RFC 3339 timestamp format, "YYYY-MM-ddThh:mmZ".

    Supporting Types

    GetEmailIpPoolLock

    CompartmentId string
    The lock compartment ID.
    Message string
    A message added by the lock creator. The message typically gives an indication of why the resource is locked.
    RelatedResourceId string
    The resource ID that is locking this resource. Indicates that deleting this resource removes the lock.
    TimeCreated string
    The time the IpPool was created. Times are expressed in RFC 3339 timestamp format, "YYYY-MM-ddThh:mmZ". Example: 2021-02-12T22:47:12.613Z
    Type string
    Lock type.
    CompartmentId string
    The lock compartment ID.
    Message string
    A message added by the lock creator. The message typically gives an indication of why the resource is locked.
    RelatedResourceId string
    The resource ID that is locking this resource. Indicates that deleting this resource removes the lock.
    TimeCreated string
    The time the IpPool was created. Times are expressed in RFC 3339 timestamp format, "YYYY-MM-ddThh:mmZ". Example: 2021-02-12T22:47:12.613Z
    Type string
    Lock type.
    compartmentId String
    The lock compartment ID.
    message String
    A message added by the lock creator. The message typically gives an indication of why the resource is locked.
    relatedResourceId String
    The resource ID that is locking this resource. Indicates that deleting this resource removes the lock.
    timeCreated String
    The time the IpPool was created. Times are expressed in RFC 3339 timestamp format, "YYYY-MM-ddThh:mmZ". Example: 2021-02-12T22:47:12.613Z
    type String
    Lock type.
    compartmentId string
    The lock compartment ID.
    message string
    A message added by the lock creator. The message typically gives an indication of why the resource is locked.
    relatedResourceId string
    The resource ID that is locking this resource. Indicates that deleting this resource removes the lock.
    timeCreated string
    The time the IpPool was created. Times are expressed in RFC 3339 timestamp format, "YYYY-MM-ddThh:mmZ". Example: 2021-02-12T22:47:12.613Z
    type string
    Lock type.
    compartment_id str
    The lock compartment ID.
    message str
    A message added by the lock creator. The message typically gives an indication of why the resource is locked.
    related_resource_id str
    The resource ID that is locking this resource. Indicates that deleting this resource removes the lock.
    time_created str
    The time the IpPool was created. Times are expressed in RFC 3339 timestamp format, "YYYY-MM-ddThh:mmZ". Example: 2021-02-12T22:47:12.613Z
    type str
    Lock type.
    compartmentId String
    The lock compartment ID.
    message String
    A message added by the lock creator. The message typically gives an indication of why the resource is locked.
    relatedResourceId String
    The resource ID that is locking this resource. Indicates that deleting this resource removes the lock.
    timeCreated String
    The time the IpPool was created. Times are expressed in RFC 3339 timestamp format, "YYYY-MM-ddThh:mmZ". Example: 2021-02-12T22:47:12.613Z
    type String
    Lock type.

    GetEmailIpPoolOutboundIpsResponse

    AssignmentState string
    The assignment state of the public IP address.
    LifecycleDetails string
    A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in 'DRAINING' state.
    OutboundIp string
    The public IP address assigned to the tenancy.
    State string
    The current state of the IpPool.
    AssignmentState string
    The assignment state of the public IP address.
    LifecycleDetails string
    A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in 'DRAINING' state.
    OutboundIp string
    The public IP address assigned to the tenancy.
    State string
    The current state of the IpPool.
    assignmentState String
    The assignment state of the public IP address.
    lifecycleDetails String
    A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in 'DRAINING' state.
    outboundIp String
    The public IP address assigned to the tenancy.
    state String
    The current state of the IpPool.
    assignmentState string
    The assignment state of the public IP address.
    lifecycleDetails string
    A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in 'DRAINING' state.
    outboundIp string
    The public IP address assigned to the tenancy.
    state string
    The current state of the IpPool.
    assignment_state str
    The assignment state of the public IP address.
    lifecycle_details str
    A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in 'DRAINING' state.
    outbound_ip str
    The public IP address assigned to the tenancy.
    state str
    The current state of the IpPool.
    assignmentState String
    The assignment state of the public IP address.
    lifecycleDetails String
    A message describing the current state in more detail. For example, can be used to provide actionable information for a resource in 'DRAINING' state.
    outboundIp String
    The public IP address assigned to the tenancy.
    state String
    The current state of the IpPool.

    Package Details

    Repository
    oci pulumi/pulumi-oci
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the oci Terraform Provider.
    oci logo
    Viewing docs for Oracle Cloud Infrastructure v4.2.0
    published on Friday, Mar 6, 2026 by Pulumi
      Try Pulumi Cloud free. Your team will thank you.