You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 4
Next »
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.
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:
Region: "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"
Cardinality of Archive and Distribution Information:
Model | Element | Type | Usable Valid Values | Constraints | Required? | Cardinality | Notes |
---|
UMM-C | | String | us-east-1 us-east-2 us-west-1 us-west-2 | n/a
| Yes | 1 |
|
UMM-C | DirectDistributionInformation/ S3BucketAndObjectPrefixNames | String | n/a | 1 - 1024 characters | No | 0..* |
|
UMM-C | DirectDistributionInformation/ S3CredentialsAPIEndpoint | URI | n/a | 1 - 1024 characters | Yes | 1 |
|
UMM-C | DirectDistributionInformation/ S3CredentialsAPIDocumentationURL | URI | n/a | 1 - 1024 characters | Yes | 1 |
|
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.
GCMD Metadata QA/QC
- Manual Review
- Automated Review
ARC Metadata QA/QC
ARC Priority Matrix
Priority Categorization | Justification |
---|
| This element is categorized as highest priority when: |
| This element is categorized as medium priority when: |
| This element is categorized as low priority when: |
| The element is provided, and follows all applicable criteria specified in the best practices section above. |
ARC Automated Checks
DIF 10
The definitions are the same between UMM-C and ECHO 10.
UMM-C Element | Path | Type | Usable Valid Values | Constraints | Required in DIF 10? | Cardinality | Notes |
---|
| /DIF/DirectDistributionInformation/ Region | String | us-east-1 us-east-2 us-west-1 us-west-2 | n/a | Yes | 1 |
|
DirectDistributionInformation/ S3BucketAndObjectPrefixNames | /DIF/DirectDistributionInformation/ S3BucketAndObjectPrefixNames | String | n/a | 1 - 1024 characters | No | 0..* |
|
DirectDistributionInformation/ S3CredentialsAPIEndpoint | /DIF/DirectDistributionInformation/ S3CredentialsAPIEndpoint | URI | n/a | 1 - 1024 characters | Yes | 1 |
|
DirectDistributionInformation/ S3CredentialsAPIDocumentationURL | /DIF/DirectDistributionInformation/ S3CredentialsAPIDocumentationURL | URI | n/a | 1 - 1024 characters | Yes | 1 |
|
Example Mapping
ECHO 10
The definitions are the same between UMM-C and ECHO 10.
UMM-C Element | Path | Type | Usable Valid Values | Constraints | Required in DIF 10? | Cardinality | Notes |
---|
| /Collection/ DirectDistributionInformation/ Region | String | us-east-1 us-east-2 us-west-1 us-west-2 | n/a | Yes | 1 |
|
DirectDistributionInformation/ S3BucketAndObjectPrefixNames | /Collection/ DirectDistributionInformation/ S3BucketAndObjectPrefixNames | String | n/a | 1 - 1024 characters | No | 0..* |
|
DirectDistributionInformation/ S3CredentialsAPIEndpoint | /Collection/ DirectDistributionInformation/ S3CredentialsAPIEndpoint | URI | n/a | 1 - 1024 characters | Yes | 1 |
|
DirectDistributionInformation/ S3CredentialsAPIDocumentationURL | /Collection/ DirectDistributionInformation/ S3CredentialsAPIDocumentationURL | URI | n/a | 1 - 1024 characters | Yes | 1 |
|
Example Mapping
ISO 19115-2 MENDS
Archive and Distribution Information is an optional metadata element in ISO 19115-2 MENDS.
UMM-C Element | Path | Type | Notes |
---|
DirectDistributionInformation/ | /gmi:MI_Metadata/gmd:distributionInfo/gmd:MD_Distribution/gmd:distributor xlink:href="DirectDistributionInformation" [=> |
|
|
DirectDistributionInformation/ Region | [=>/gmd:MD_Distributor/gmd:distributionOrderProcess/gmd:MD_StandardOrderProcess/gmd:orderingInstructions/gmd:CharacterString = Region: <region such as us-east-2> | String |
|
DirectDistributionInformation/ S3BucketAndObjectPrefixNames | [=>/gmd:MD_Distributor/gmd:distributionOrderProcess/gmd:MD_StandardOrderProcess/gmd:orderingInstructions/gmd:CharacterString = S3BucketAndObjectPrefixNames: <such as BucketPrefix1 BucketPrefix2 > | String |
|
DirectDistributionInformation/ S3CredentialsAPIEndpoint | [=>/gmd:MD_Distributor/gmd:distributorTransferOptions xlink:href="DirectDistributionInformation_S3CredentialsAPIEndpoint"/gmd:MD_DigitalTransferOptions/gmd:onLine/gmd:CI_OnlineResource/gmd:linkage/gmd:URL | URI |
|
DirectDistributionInformation/ S3CredentialsAPIDocumentationURL | [=>/gmd:MD_Distributor/gmd:distributorTransferOptions xlink:href="DirectDistributionInformation_S3CredentialsAPIDocumentationURL"/gmd:MD_DigitalTransferOptions/gmd:onLine/gmd:CI_OnlineResource/gmd:linkage/gmd:URL | URI |
|
Example Mapping
ISO 19115-2 SMAP
UMM-C Element | Path | Type | Notes |
---|
DirectDistributionInformation/ | /gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:distributionInfo/gmd:MD_Distribution/gmd:distributor xlink:href="DirectDistributionInformation" [=> |
|
|
DirectDistributionInformation/ Region | [=>/gmd:MD_Distributor/gmd:distributionOrderProcess/gmd:MD_StandardOrderProcess/gmd:orderingInstructions/gmd:CharacterString = Region: <region such as us-east-2> | String |
|
DirectDistributionInformation/ S3BucketAndObjectPrefixNames | [=>/gmd:MD_Distributor/gmd:distributionOrderProcess/gmd:MD_StandardOrderProcess/gmd:orderingInstructions/gmd:CharacterString = S3BucketAndObjectPrefixNames: <such as BucketPrefix1 BucketPrefix2 > | String |
|
DirectDistributionInformation/ S3CredentialsAPIEndpoint | [=>/gmd:MD_Distributor/gmd:distributorTransferOptions xlink:href="DirectDistributionInformation_S3CredentialsAPIEndpoint"/gmd:MD_DigitalTransferOptions/gmd:onLine/gmd:CI_OnlineResource/gmd:linkage/gmd:URL | URI |
|
DirectDistributionInformation/ S3CredentialsAPIDocumentationURL | [=>/gmd:MD_Distributor/gmd:distributorTransferOptions xlink:href="DirectDistributionInformation_S3CredentialsAPIDocumentationURL"/gmd:MD_DigitalTransferOptions/gmd:onLine/gmd:CI_OnlineResource/gmd:linkage/gmd:URL | URI |
|
History
Version | Date | What Changed |
---|
1.16.1 | 2/26/2020 | No changes were made for Direct Distribution Information during the transition from version 1.16.0 to 1.16.1 |
1.16.0 | 04/11/2021 | This element was added to the UMM-C specification. |
Version | Date | What Changed | Author |
---|
1.0 | N/A | Recommendations/priority matrix transferred from internal ARC documentation to wiki space | |