Data Source: oci_file_storage_snapshot

This data source provides details about a specific Snapshot resource in Oracle Cloud Infrastructure File Storage service.

Gets the specified snapshot’s information.

Example Usage

data "oci_file_storage_snapshot" "test_snapshot" {
	#Required
	snapshot_id = oci_file_storage_snapshot.test_snapshot.id
}

Argument Reference

The following arguments are supported:

• snapshot_id - (Required) The OCID of the snapshot.

Attributes Reference

The following attributes are exported:

• defined_tags - Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

• expiration_time - The time when this snapshot will be deleted.

• file_system_id - The OCID of the file system from which the snapshot was created.

• filesystem_snapshot_policy_id - The OCID of the file system snapshot policy that created this snapshot.

• freeform_tags - 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 - The OCID of the snapshot.

• is_clone_source - Specifies whether the snapshot has been cloned. See Cloning a File System.

• lifecycle_details - Additional information about the current lifecycleState.

• lock_duration_details - Details for setting a retention date or legal hold.

  • cool_off_duration - For snapshots in compliance mode, a cooling-off period (measured in days) begins. During this time, you can still edit or remove the lock. Once this period ends, the snapshot becomes immutable until the specified retention date expires, permanently preventing any deletion or modification. The cool off duration can be set for a minimum of 0 days and a maximum of 365. It defaults to 14 days if not set.
  • lock_duration - The retention period (measured in days) defines how long a snapshot remains locked, preventing user modifications or deletions. In governance mode this period can be adjusted, but in compliance mode it becomes permanent after a cool-off period. Snapshots can be locked for a minimum of 0 days and a maximum of 36,500 days. A value of 0 days stands for an indefinite retention period and it is used for a legal hold.
  • lock_mode - Can be GOVERNANCE or COMPLIANCE. GOVERNANCE MODE: locks snapshots based on either a retention period or a legal hold. COMPLIANCE MODE: the customer can only remove the snapshot during its cooling-off period. Once that time ends, the snapshot becomes immutable; customers cannot delete or modify it until its set retention date passes. After the snapshot is locked, customers can only increase its retention period.

• locks - Locks associated with this resource.

  • message - A message added by the creator of the lock. This is typically used to give an indication of why the resource is locked.
  • related_resource_id - The ID of the resource that is locking this resource. Indicates that deleting this resource will remove the lock.
  • time_created - When the lock was created.
  • type - Type of the lock.

• name - Name of the snapshot. This value is immutable.

  Avoid entering confidential information.

  Example: Sunday

• provenance_id - An OCID identifying the parent from which this snapshot was cloned. If this snapshot was not cloned, then the provenanceId is the same as the snapshot id value. If this snapshot was cloned, then the provenanceId value is the parent’s provenanceId. See Cloning a File System.

• snapshot_time - The date and time the snapshot was taken, expressed in RFC 3339 timestamp format. This value might be the same or different from timeCreated depending on the following factors:

  • If the snapshot is created in the original file system directory.
  • If the snapshot is cloned from a file system.
  • If the snapshot is replicated from a file system.

  Example: 2020-08-25T21:10:29.600Z

• snapshot_type - Specifies the generation type of the snapshot.

• state - The current state of the snapshot.

• system_tags - System tags for this resource. System tags are applied to resources by internal Oracle Cloud Infrastructure services.

• time_created - The date and time the snapshot was created, expressed in RFC 3339 timestamp format. Example: 2016-08-25T21:10:29.600Z

• time_locked - The date and time as per RFC 3339 when this snapshot was locked. It is a read-only property because the user should not be able to set it, it is set by our service.