Element Description
The direct distribution information main element allows data providers to provide users information on getting direct access to data products that are stored in the Amazon Web Service (AWS) S3 buckets when they are initially looking at a collection. The end users get information such as the S3 credentials end point, a credential documentation URL, as well as bucket prefix names, and an AWS region.
Best Practices
There are multiple sub-elements that comprise Direct Distribution Information:
Region: Defines the possible values for the Amazon Web Service US Regions where the data product resides. The current valid values are: us-east-1, us-east-2, us-west-1, and us-west-2.
S3BucketAndObjectPrefixNames: Defines the possible values for the Amazon Web Service US S3 bucket and/or object prefix names.
S3CredentialsAPIEndpoint: Defines the URL where the credentials are stored.
S3CredentialsAPIDocumentationURL: Defines the URL where the credential documentation are stored.
Each of these elements describes the information that is necessary to pull out data products that are stored in the AWS cloud using a s3 URL that is located inside each granule's (data product file's) metadata.
Examples:
Format: "us-east-1"
S3BucketAndObjectPrefixNames: "Bucket 1"
S3CredentialsAPIEndpoint: "https://some-data-product-credentials-api.com/api.html"
S3CredentialsAPIDocumentationURL: "https://some-data-product-credentials-api.com/docs.html"
Element Specification
Cardinality of Archive and Distribution Information:
Model | Element | Type | Usable Valid Values | Constraints | Required? | Cardinality | Notes |
---|---|---|---|---|---|---|---|
UMM-C | ArchiveAndDistributionInformation/ FileArchiveInformation/ Format | String | GCMD Granule Data Format vocabulary list | 1 - 80 characters | Yes | 1 | To ensure consistency, it is highly recommended that the format be selected from the GCMD Granule Data Format vocabulary list. |
UMM-C | ArchiveAndDistributionInformation/ FileArchiveInformation/FormatType | String | Native Supported | n/a | No | 0..1 | |
UMM-C | ArchiveAndDistributionInformation/ FileArchiveInformation/FormatDescription | String | 1 - 80 characters | No | 0..1 | ||
UMM-C | ArchiveAndDistributionInformation/ FileArchiveInformation/ AverageFileSize | Decimal | Yes, if TotalCollectionFileSizeBeginDate is used. | 0..1 | |||
UMM-C | ArchiveAndDistributionInformation/ FileArchiveInformation/ AverageFileSizeUnit | String | KB MB GB TB PB NA | n/a | Yes, if AverageFileSize is used. | 0..1 | |
UMM-C | ArchiveAndDistributionInformation/ FileArchiveInformation/ TotalCollectionFileSize | Decimal | No | 0..1 | Either use TotalCollectionFileSize or TotalCollectiopnFileSizeBeginDate | ||
UMM-C | ArchiveAndDistributionInformation/ FileArchiveInformation/ TotalCollectionFileSizeUnit | Enumeration | KB MB GB TB PB NA | n/a | Yes, if TotalCollectionFileSize is used | 0..1 | |
UMM-C | ArchiveAndDistributionInformation/ FileArchiveInformation/ TotalCollectionFileSizeBeginDate | Date | No | 0..1 | Either use TotalCollectionFileSize or TotalCollectiopnFileSizeBeginDate | ||
UMM-C | ArchiveAndDistributionInformation/ FileArchiveInformation/ Description | String | n/a | 1 - 1024 characters | No | 0..1 | |
UMM-C | ArchiveAndDistributionInformation/ FileDistributionInformation/Format | String | GCMD Granule Data Format vocabulary list | 1 - 80 characters | Yes | 1 | To ensure consistency, it is highly recommended that the format be selected from the GCMD Granule Data Format vocabulary list. |
UMM-C | ArchiveAndDistributionInformation/ FileDistributionInformation/ FormatType | String | Native Supported | No | 0..1 | ||
UMM-C | ArchiveAndDistributionInformation/ FileDistributionInformation/ FormatDescription | String | 1 - 80 characters | No | 0..1 | ||
UMM-C | ArchiveAndDistributionInformation/ FileDistributionInformation/ Media | String | n/a | 1 - 80 characters | No | 0..1 | |
UMM-C | ArchiveAndDistributionInformation/ FileDistributionInformation/ AverageFileSize | Decimal | n/a | n/a | Yes, if TotalCollectionFileSizeBeginDate is used. | 0..1 | |
UMM-C | ArchiveAndDistributionInformation/ FileDistributionInformation/ AverageFileSizeUnit | Enumeration | KB MB GB TB PB NA | Yes, if AverageFileSize is used. | 0..1 | ||
UMM-C | ArchiveAndDistributionInformation/ FileDistributionInformation/ TotalCollectionFileSize | Decimal | n/a | No | 0..1 | Either use TotalCollectionFileSize or TotalCollectiopnFileSizeBeginDate | |
UMM-C | ArchiveAndDistributionInformation/ FileDistributionInformation/ TotalCollectionFileSizeUnit | Enumeration | KB MB GB TB PB NA | n/a | Yes, if TotalCollectionFileSize is used | 0..1 | |
UMM-C | ArchiveAndDistributionInformation/ FileDistributionInformation/ TotalCollectionFileSizeBeginDate | Date | No | 0..1 | Either use TotalCollectionFileSize or TotalCollectiopnFileSizeBeginDate | ||
UMM-C | ArchiveAndDistributionInformation/ FileDistributionInformation/ Description | String | n/a | 1 - 1024 characters | No | 0..1 | |
UMM-C | Fees | String | n/a | 1 - 255 characters | No | 0..1 |
Metadata Validation and QA/QC
All metadata entering the CMR goes through the below process to ensure metadata quality requirements are met. All records undergo CMR validation before entering the system. The process of QA/QC is slightly different for NASA and non-NASA data providers. Non-NASA providers include interagency and international data providers and are referred to as the International Directory Network (IDN).
Please see the expandable sections below for flowchart details.
Dialect Mappings
UMM Migration
None
History
UMM Versioning
Version | Date | What Changed |
---|---|---|
1.15.5 | 12/3/2020 | The description of the format elements now includes text about the controlled vocabulary for this field coming from KMS. |
1.15.4 | 9/18/2020 | No changes were made for Archive and Distribution Information during the transition from version 1.15.3 to 1.15.4 |
1.15.3 | 7/1/2020 | FormatDescription was added to FileArchive and FileDistribution Information types to version 1.15.3 |
1.15.2 | 5/20/2020 | No changes were made for Archive and Distribution Information during the transition from version 1.15.1 to 1.15.2 |
1.15.1 | 3/25/2020 | No changes were made for Archive and Distribution Information during the transition from version 1.15.0 to 1.15.1 |
1.15.0 | 2/26/2020 | No changes were made for Archive and Distribution Information during the transition from version 1.14.0 to 1.15.0 |
1.14.0 | 10/21/2019 | No changes were made for Archive and Distribution Information during the transition from version 1.13.0 to 1.14.0 |
1.13.0 | 04/11/2019 | This element was added to the UMM-C specification. |
ARC Documentation
Version | Date | What Changed | Author |
---|---|---|---|
1.0 | 05/16/18 | Recommendations/priority matrix transferred from internal ARC documentation to wiki space |