1. Packages
  2. MongoDB Atlas
  3. API Docs
  4. getOnlineArchive
MongoDB Atlas v3.14.2 published on Monday, Mar 18, 2024 by Pulumi

mongodbatlas.getOnlineArchive

Explore with Pulumi AI

mongodbatlas logo
MongoDB Atlas v3.14.2 published on Monday, Mar 18, 2024 by Pulumi

    mongodbatlas.OnlineArchive describes an Online Archive

    NOTE: Groups and projects are synonymous terms. You may find group_id in the official documentation.

    Example Usage

    
    data "mongodbatlas_online_archive" "test" {
        project_id   = var.project_id
        cluster_name = var.cluster_name
        archive_id     = "5ebad3c1fe9c0ab8d37d61e1"
    }
    

    Attributes reference

    • db_name - Name of the database that contains the collection.
    • coll_name - Name of the collection.
    • collection_type - Type of MongoDB collection that you want to return. This value can be “TIMESERIES” or “STANDARD”. Default is “STANDARD”.
    • criteria - Criteria to use for archiving data. See criteria.
    • data_expiration_rule - Rule for specifying when data should be deleted from the archive. See data expiration rule.
    • data_process_region - Settings to configure the region where you wish to store your archived data. See data process region.
    • schedule - Regular frequency and duration when archiving process occurs. See schedule.
    • partition_fields - Fields to use to partition data. You can specify up to two frequently queried fields to use for partitioning data. Queries that don’t contain the specified fields require a full collection scan of all archived documents, which takes longer and increases your costs. To learn more about how partition improves query performance, see Data Structure in S3. The value of a partition field can be up to a maximum of 700 characters. Documents with values exceeding 700 characters are not archived. See partition fields.
    • paused - State of the online archive. This is required for pausing an active online archive or resuming a paused online archive. If the collection has another active online archive, the resume request fails.
    • state - Status of the online archive. Valid values are: Pending, Archiving, Idle, Pausing, Paused, Orphaned and Deleted

    Criteria

    • type - Type of criteria (DATE, CUSTOM)
    • date_field - Indexed database parameter that stores the date that determines when data moves to the online archive. MongoDB Cloud archives the data when the current date exceeds the date in this database parameter plus the number of days specified through the expireAfterDays parameter. Set this parameter when type is DATE.
    • date_format - Syntax used to write the date after which data moves to the online archive. Date can be expressed as ISO 8601 or Epoch timestamps. The Epoch timestamp can be expressed as nanoseconds, milliseconds, or seconds. Set this parameter when type is DATE. You must set type to DATE if collectionType is TIMESERIES. Valid values: ISODATE (default), EPOCH_SECONDS, EPOCH_MILLIS, EPOCH_NANOSECONDS.
    • expire_after_days - Number of days after the value in the criteria.dateField when MongoDB Cloud archives data in the specified cluster. Set this parameter when type is DATE.
    • query - JSON query to use to select documents for archiving. Atlas uses the specified query with the db.collection.find(query) command. The empty document {} to return all documents is not supported. Set this parameter when type is CUSTOM.

    Data Expiration Rule

    • expire_after_days - Number of days used in the date criteria for nominating documents for deletion. Value must be between 7 and 9215.

    Data Process Region

    • cloud_provider - Human-readable label that identifies the Cloud service provider where you wish to store your archived data.
    • region - Human-readable label that identifies the geographic location of the region where you wish to store your archived data. For allowed values, see MongoDB Atlas API documentation

    Schedule

    • type - Type of schedule. Valid values: DEFAULT, DAILY, MONTHLY, WEEKLY.
    • start_hour - Hour of the day when the when the scheduled window to run one online archive starts.
    • end_hour - Hour of the day when the scheduled window to run one online archive ends.
    • start_minute - Minute of the hour when the scheduled window to run one online archive starts.
    • end_minute - Minute of the hour when the scheduled window to run one online archive ends.
    • day_of_month - Day of the month when the scheduled archive starts. Set this parameter when type is MONTHLY.
    • day_of_week - Day of the week when the scheduled archive starts. The week starts with Monday (1) and ends with Sunday (7).Set this parameter when type is WEEKLY.

    Partition

    • field_name - Human-readable label that identifies the parameter that MongoDB Cloud uses to partition data. To specify a nested parameter, use the dot notation.
    • order - Sequence in which MongoDB Cloud slices the collection data to create partitions. The resource expresses this sequence starting with zero. The value of the criteria.dateField parameter defaults as the first item in the partition sequence.
    • field_type - Data type of the parameter that that MongoDB Cloud uses to partition data. Partition parameters of type UUID must be of binary subtype 4. MongoDB Cloud skips partition parameters of type UUID with subtype 3. Valid values: date, int, long, objectId, string, uuid.

    See MongoDB Atlas API Documentation for more information.

    Using getOnlineArchive

    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 getOnlineArchive(args: GetOnlineArchiveArgs, opts?: InvokeOptions): Promise<GetOnlineArchiveResult>
    function getOnlineArchiveOutput(args: GetOnlineArchiveOutputArgs, opts?: InvokeOptions): Output<GetOnlineArchiveResult>
    def get_online_archive(archive_id: Optional[str] = None,
                           cluster_name: Optional[str] = None,
                           project_id: Optional[str] = None,
                           opts: Optional[InvokeOptions] = None) -> GetOnlineArchiveResult
    def get_online_archive_output(archive_id: Optional[pulumi.Input[str]] = None,
                           cluster_name: Optional[pulumi.Input[str]] = None,
                           project_id: Optional[pulumi.Input[str]] = None,
                           opts: Optional[InvokeOptions] = None) -> Output[GetOnlineArchiveResult]
    func LookupOnlineArchive(ctx *Context, args *LookupOnlineArchiveArgs, opts ...InvokeOption) (*LookupOnlineArchiveResult, error)
    func LookupOnlineArchiveOutput(ctx *Context, args *LookupOnlineArchiveOutputArgs, opts ...InvokeOption) LookupOnlineArchiveResultOutput

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

    public static class GetOnlineArchive 
    {
        public static Task<GetOnlineArchiveResult> InvokeAsync(GetOnlineArchiveArgs args, InvokeOptions? opts = null)
        public static Output<GetOnlineArchiveResult> Invoke(GetOnlineArchiveInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetOnlineArchiveResult> getOnlineArchive(GetOnlineArchiveArgs args, InvokeOptions options)
    // Output-based functions aren't available in Java yet
    
    fn::invoke:
      function: mongodbatlas:index/getOnlineArchive:getOnlineArchive
      arguments:
        # arguments dictionary

    The following arguments are supported:

    ArchiveId string
    ID of the online archive.
    ClusterName string
    Name of the cluster that contains the collection.
    ProjectId string
    The unique ID for the project.
    ArchiveId string
    ID of the online archive.
    ClusterName string
    Name of the cluster that contains the collection.
    ProjectId string
    The unique ID for the project.
    archiveId String
    ID of the online archive.
    clusterName String
    Name of the cluster that contains the collection.
    projectId String
    The unique ID for the project.
    archiveId string
    ID of the online archive.
    clusterName string
    Name of the cluster that contains the collection.
    projectId string
    The unique ID for the project.
    archive_id str
    ID of the online archive.
    cluster_name str
    Name of the cluster that contains the collection.
    project_id str
    The unique ID for the project.
    archiveId String
    ID of the online archive.
    clusterName String
    Name of the cluster that contains the collection.
    projectId String
    The unique ID for the project.

    getOnlineArchive Result

    The following output properties are available:

    Supporting Types

    GetOnlineArchiveCriteria

    DateField string
    DateFormat string
    ExpireAfterDays int
    Query string
    Type string
    DateField string
    DateFormat string
    ExpireAfterDays int
    Query string
    Type string
    dateField String
    dateFormat String
    expireAfterDays Integer
    query String
    type String
    dateField string
    dateFormat string
    expireAfterDays number
    query string
    type string
    dateField String
    dateFormat String
    expireAfterDays Number
    query String
    type String

    GetOnlineArchiveDataExpirationRule

    GetOnlineArchiveDataProcessRegion

    CloudProvider string
    Region string
    CloudProvider string
    Region string
    cloudProvider String
    region String
    cloudProvider string
    region string
    cloudProvider String
    region String

    GetOnlineArchivePartitionField

    FieldName string
    FieldType string
    Order int
    FieldName string
    FieldType string
    Order int
    fieldName String
    fieldType String
    order Integer
    fieldName string
    fieldType string
    order number
    fieldName String
    fieldType String
    order Number

    GetOnlineArchiveSchedule

    endHour Integer
    endMinute Integer
    startHour Integer
    startMinute Integer
    type String
    dayOfMonth Integer
    dayOfWeek Integer
    endHour number
    endMinute number
    startHour number
    startMinute number
    type string
    dayOfMonth number
    dayOfWeek number
    endHour Number
    endMinute Number
    startHour Number
    startMinute Number
    type String
    dayOfMonth Number
    dayOfWeek Number

    Package Details

    Repository
    MongoDB Atlas pulumi/pulumi-mongodbatlas
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the mongodbatlas Terraform Provider.
    mongodbatlas logo
    MongoDB Atlas v3.14.2 published on Monday, Mar 18, 2024 by Pulumi