Imported from
registry/profiles/status/resource.md
at commit
76a4a0c89924.
IRI Status Resource Profile
Profile URI: https://iri.science/profiles/status/resource
OpenAPI type: Resource
Status: Draft
Version: 1.0.0
1. Purpose
This document defines the semantic profile for an IRI Status Resource representation.
The canonical identifier for this profile is:
https://iri.science/profiles/status/resource
An IRI Resource represents physical, logical, virtual, or service-oriented infrastructure exposed through an IRI Facility API.
Resources may represent, for example:
- compute systems;
- compute nodes;
- CPUs or GPUs;
- storage systems;
- filesystems;
- network infrastructure;
- facility-hosted services;
- data-transfer services;
- inference services;
- websites or portals;
- other registered IRI resource types.
A Resource is distinct from:
- a Facility, which represents the organization providing the IRI Facility API;
- a Site, which represents the physical site associated with Resources;
- an Event, which records a timestamped occurrence involving a Resource;
- an Incident, which groups related Events and identifies Resources that may be affected;
- a Capability, which identifies an allocatable or otherwise distinguished capability associated with a Resource.
The normative structural definition of a Resource representation is provided by the IRI Facility API OpenAPI specification.
This profile supplements that schema with application-level semantics, resource-type interpretation rules, relationship conventions, and interoperability requirements.
2. Profile Semantics
An IRI Resource is an independently identifiable entity exposed by a participating Facility.
A Resource representation describes:
- the identity of the Resource;
- the semantic type of the Resource;
- descriptive metadata;
- the Site associated with the Resource;
- current reported status when available;
- Capabilities associated with the Resource;
- type-specific attributes where applicable;
- relationships to other IRI Resources;
- applicable operation entry points when advertised.
A Resource representation SHOULD provide sufficient hypermedia information for clients to discover related resources and applicable operations without requiring clients to infer API paths.
Clients MUST NOT infer related-resource URLs or operation entry points from:
- Resource identifiers;
- Resource Type URNs;
- Site identifiers;
- naming conventions;
- known Facility routing conventions;
- previously observed API paths.
When a relationship or operation entry point is advertised through _links, clients SHOULD use the advertised target.
3. Structural Contract
The structural definition of the Resource representation is defined by the IRI Facility API OpenAPI Resource schema.
The V2 Resource schema defines the following conceptual properties:
| Property | Required | Semantic purpose |
|---|---|---|
id |
Yes | Stable identifier for the Resource. |
name |
No | Human-readable long name of the Resource. |
description |
No | Human-readable description of the Resource. |
last_modified |
Yes | Time at which the Resource representation was last modified. |
group |
No | Logical grouping associated with the Resource. |
current_status |
No | Current status reported for the Resource. |
resource_type |
Yes | IRI Resource Type URN identifying the semantic type of the Resource. |
supported_endpoints |
No | Broad endpoint categories supported by the Resource. |
attributes |
No | Optional type-specific metadata whose semantics are defined by the applicable Resource Definition Profile selected by resource_type. |
self_uri |
Yes | Canonical API URI of the Resource representation. |
site_uri |
Yes | URI identifying the authoritative Site associated with the Resource. |
capability_uris |
Yes | URIs identifying Capabilities associated with the Resource. |
During the Phase 1 operation-affordance migration, supported_endpoints
remains an optional array of broad endpoint categories under the existing
OpenAPI contract. It is not a list of relation names, operation identifiers,
or URLs, and this profile does not deprecate or remove it.
The OpenAPI schema is authoritative for:
- property names;
- JSON data types and structure;
- required and optional properties;
- nullable properties;
additionalPropertiesbehavior;- formats;
- structural validation;
- read-only properties.
The DOE-IRI URN specification and DOE-IRI URN Registry are authoritative for:
- Resource Type URN syntax;
- registered Resource Type values;
- Resource Type hierarchy;
- registered parent-child relationships;
- delegated extension rules.
This profile is authoritative for additional semantic and interoperability conventions associated with the Resource representation.
4. Resource Identity
The id property identifies the Resource instance.
The identifier MUST be stable within the identifier scope established by the IRI Facility API.
Clients MUST treat id as an opaque Resource identifier unless another IRI specification explicitly defines additional semantics for that identifier.
The Resource instance identifier and the Resource Type URN serve different purposes.
For example:
{
"id": "pioneer-compute",
"resource_type": "urn:doe-iri:resource:compute:system"
}
means:
pioneer-compute
↓
identifies WHICH Resource instance
urn:doe-iri:resource:compute:system
↓
identifies WHAT KIND of Resource it is
Clients MUST NOT construct API URLs by combining the Resource identifier with assumed path templates.
For example, a client discovering:
{
"id": "pioneer-compute"
}
MUST NOT assume the Resource is available at:
/api/v2/status/resources/pioneer-compute
or that job submission is available at:
/api/v2/compute/job/pioneer-compute
The canonical Resource URI and applicable operation entry points MUST instead be obtained from advertised URIs or hypermedia links.
5. Resource Classification
The resource_type property identifies the semantic type of the Resource.
The V2 resource_type property is structurally a string.
Its value MUST be an IRI Resource Type URN conforming to the DOE-IRI URN specification.
For example:
{
"resource_type": "urn:doe-iri:resource:compute:system"
}
Resource types are not defined as a closed OpenAPI enumeration.
This allows the Resource taxonomy to evolve through the DOE-IRI URN Registry without requiring an OpenAPI schema revision whenever a new Resource subtype is introduced.
5.1 Resource Type Namespace
Shared Resource Type URNs are rooted at:
urn:doe-iri:resource
Examples include:
urn:doe-iri:resource:website
urn:doe-iri:resource:service
urn:doe-iri:resource:compute
urn:doe-iri:resource:system
urn:doe-iri:resource:storage
urn:doe-iri:resource:network
urn:doe-iri:resource:unknown
More-specific registered types narrow these classifications.
Examples include:
urn:doe-iri:resource:compute:system
urn:doe-iri:resource:compute:node
urn:doe-iri:resource:compute:cpu
urn:doe-iri:resource:compute:gpu
urn:doe-iri:resource:storage:system
urn:doe-iri:resource:storage:filesystem
urn:doe-iri:resource:service:dtn
urn:doe-iri:resource:service:inference
5.2 Hierarchical Semantics
Each additional semantic segment in a Resource Type URN narrows the meaning of the Resource type.
For example:
urn:doe-iri:resource:storage
│
└── filesystem
corresponds to:
urn:doe-iri:resource:storage
urn:doe-iri:resource:storage:filesystem
A Resource classified as:
urn:doe-iri:resource:storage:filesystem
is therefore also within the semantic hierarchy rooted at:
urn:doe-iri:resource:storage
because that parent hierarchy level is registered and semantically defined.
5.3 Producer Requirements
A producer SHOULD emit the most specific registered Resource Type URN that accurately describes the Resource.
For example, a scratch filesystem SHOULD use the registered filesystem Resource Type and identify its scratch tier through the applicable type-specific attributes:
{
"resource_type": "urn:doe-iri:resource:storage:filesystem",
"attributes": {
"tier": "urn:doe-iri:storage:tier:scratch"
}
}
The Resource Type identifies the Resource as a filesystem; the tier attribute
identifies its intended scratch lifecycle or usage tier.
A producer MAY emit a recognized parent Resource Type when:
- a more-specific subtype is unavailable;
- a more-specific subtype is not applicable;
- disclosure of the subtype is restricted;
- the implementation intentionally exposes only a broader classification.
A producer MUST NOT invent an unregistered shared Resource Type URN and present it as a canonical DOE-IRI type.
Facility- or project-specific Resource types MUST use the DOE-IRI delegated-extension mechanism when an appropriate delegated scope exists.
5.4 Consumer Requirements
A generic client MUST NOT reject an otherwise syntactically valid IRI Resource Type URN solely because the specific type is not known to the client’s local implementation.
A hierarchy-aware client SHOULD fall back to the nearest recognized semantic parent.
For example, if a client does not understand:
urn:doe-iri:resource:storage:filesystem
but understands:
urn:doe-iri:resource:storage
it SHOULD fall back to generic storage behavior where that behavior is applicable.
A client that does not implement DOE-IRI hierarchy parsing MUST treat an unfamiliar Resource Type URN as an opaque semantic identifier.
5.5 Hierarchy Matching
Hierarchy-aware matching MUST operate on complete colon-delimited semantic segments.
For example:
urn:doe-iri:resource:storage
is a semantic parent of:
urn:doe-iri:resource:storage:filesystem
but:
urn:doe-iri:resource:stor
is not a semantic parent.
Clients MUST NOT use arbitrary string-prefix comparison as a substitute for DOE-IRI hierarchy-aware matching.
5.6 Extension Resource Types
DOE-IRI extension Resource Type URNs use the explicit ext delegation form.
For example:
urn:doe-iri:resource:compute:ext:nersc:fpga
An extension marker and authority code express delegation structure rather than additional shared semantic hierarchy.
For hierarchy-aware fallback, clients stop at the nearest recognized shared semantic parent before ext.
For example:
urn:doe-iri:resource:compute:ext:nersc:fpga
may fall back to:
urn:doe-iri:resource:compute
A producer claiming an assigned DOE-IRI extension MUST satisfy the applicable syntax, scope-authorization, and local-definition requirements of the DOE-IRI URN specification.
6. Current Status
The current_status property represents the current status reported for the Resource.
The IRI Status model defines the following status values:
up
down
degraded
unknown
For example:
{
"current_status": "degraded"
}
current_status provides a current-state summary associated with the Resource.
It is distinct from Event history.
An Event records a Resource condition at the Event’s occurred_at time, while current_status describes the current reported condition of the Resource representation.
The existence of:
{
"current_status": "up"
}
does not imply that:
- the Resource has never experienced an Incident;
- every operation associated with the Resource is currently usable;
- every dependent Resource is available;
- every endpoint associated with the Resource is reachable.
Clients requiring historical information SHOULD inspect applicable Event and Incident representations.
7. Site Association
Each Resource has one authoritative Site association under the current V2 contract.
The representation exposes this relationship through:
site_uri
The registered IRI hypermedia relation is:
iri:located-at
with canonical relation URI:
https://iri.science/rels/located-at
Conceptually:
Resource -- iri:located-at --> Site
1 1
iri:located-at identifies the relatively stable physical and administrative Site associated with the Resource.
It MUST NOT be interpreted as asserting:
- current process placement;
- compute hosting;
- service reachability;
- operational health;
- current availability;
- ownership;
- live network routing.
The target Site representation MAY advertise:
https://iri.science/profiles/facility/site
as its representation profile.
8. Capabilities and Type-Specific Behavior
8.1 Capabilities
The Resource representation exposes associated Capabilities through:
capability_uris
The registered IRI hypermedia relation is:
iri:has-capability
with canonical relation URI:
https://iri.science/rels/has-capability
Conceptually:
Resource -- iri:has-capability --> Capability
1 0..*
A Capability identifies a capability associated with the Resource.
The existence of a Capability relationship MUST NOT itself be interpreted as:
- an authorization grant;
- an allocation;
- current availability;
- permission to invoke an operation;
- a guarantee that the Capability can currently be consumed.
8.2 Resource Definition Profiles
The common Resource profile defines semantics applicable to every IRI Resource
representation. When the Resource Type Registry associates the exact
resource_type with a Resource Definition Profile, that registered mapping
selects the additional type-specific semantics that apply.
A Resource Definition Profile supplements this common profile. It defines
type-specific semantics and MAY define attributes, relationships, and operation
affordances applicable to the Resource type. When attributes is non-null, its
members are interpreted according to the applicable Resource Definition
Profile.
For example:
{
"resource_type":
"urn:doe-iri:resource:compute:system"
}
is mapped by the Resource Type Registry to:
https://iri.science/profiles/resource-definition/compute/system
The registered mapping in Resource Type URNs is authoritative; clients MUST NOT construct a Resource Definition Profile URI by transforming the Resource Type URN.
A Resource Definition Profile specializes the existing IRI v2 Resource representation. It does not replace the common Resource representation and does not create a separate IRI v2 Resource Definition API object or endpoint.
A generic client MUST remain capable of processing the common Resource
representation even when it does not understand the Resource’s most-specific
type or applicable Resource Definition Profile. Such a client MAY treat
unfamiliar attributes content as opaque JSON data.
8.3 Resource Type Does Not Define URLs
A Resource Type URN identifies what the Resource is.
It does not identify where related resources or operations are located.
For example:
urn:doe-iri:resource:compute:system
does not imply that job submission is located at:
/api/v2/compute/job/{resource_id}
The applicable operation MUST be discovered through an advertised operation relation when such a relation is available.
9. Hypermedia Representation
When represented using HAL, a Resource SHOULD advertise its identity, relationships, and applicable operation entry points through _links.
For example:
{
"id": "pioneer-compute",
"name": "Pioneer Compute System",
"last_modified": "2026-08-17T18:12:00Z",
"resource_type": "urn:doe-iri:resource:compute:system",
"current_status": "up",
"supported_endpoints": ["compute"],
"_links": {
"self": {
"href":
"https://api.example.org/api/v2/status/resources/pioneer-compute",
"type": "application/hal+json",
"profile": "https://iri.science/profiles/status/resource"
},
"curies": [
{
"name": "iri",
"href": "https://iri.science/rels/{rel}",
"templated": true
}
],
"iri:located-at": {
"href":
"https://api.example.org/api/v2/facility/sites/example-site",
"title": "Example Facility Site",
"type": "application/hal+json",
"profile": "https://iri.science/profiles/facility/site"
},
"iri:has-capability": [
{
"href":
"https://api.example.org/api/v2/account/capabilities/pioneer-gpu",
"title": "Pioneer GPU Capability",
"type": "application/hal+json",
"profile": "https://iri.science/profiles/account/capability"
}
],
"iri:submit-job": {
"href":
"https://api.example.org/api/v2/compute/job/pioneer-compute"
},
"service-desc": {
"href": "https://api.example.org/openapi.json",
"type": "application/vnd.oai.openapi+json;version=3.1"
}
}
}
In this representation:
resource_typeidentifies what the Resource is;selfidentifies the Resource representation;iri:located-atidentifies the associated Site;iri:has-capabilityidentifies associated Capabilities;iri:submit-jobidentifies an applicable operation entry point;service-descidentifies the applicable deployed OpenAPI description, which bindshttps://iri.science/rels/submit-jobto its Operation Object throughx-iri-relation;profileidentifies the semantic profile of a target representation.
These identifiers serve different purposes and MUST NOT be treated as interchangeable.
10. Relationship URIs and Operation Affordances
IRI-specific relations use the IRI CURIE namespace.
For example:
{
"name": "iri",
"href": "https://iri.science/rels/{rel}",
"templated": true
}
The CURIE:
iri:located-at
expands to:
https://iri.science/rels/located-at
and:
iri:has-capability
expands to:
https://iri.science/rels/has-capability
The applicable canonical relation documents define the normative semantics of those relationships.
This Resource profile MUST NOT redefine those link-relation semantics.
10.1 Operation Discovery
A Resource MAY advertise operation entry points applicable to that Resource.
For example, a Resource classified as:
urn:doe-iri:resource:compute:system
may advertise:
{
"_links": {
"iri:submit-job": {
"href":
"https://api.example.org/api/v2/compute/job/pioneer-compute"
},
"service-desc": {
"href": "https://api.example.org/openapi.json",
"type": "application/vnd.oai.openapi+json;version=3.1"
}
}
}
The Resource Type URN and operation relation answer different questions:
resource_type
↓
WHAT is this Resource?
urn:doe-iri:resource:compute:system
iri:submit-job
↓
WHAT operation is applicable and WHERE?
service-desc
↓
HOW is that operation invoked?
An operation link does not itself define:
- HTTP method;
- request body;
- response body;
- authentication;
- authorization;
- scheduling policy;
- operational success.
Those invocation semantics remain defined by the applicable machine-readable API contract, such as OpenAPI.
When a Resource advertises an operation-affordance relation adopted by the
operation-affordance RFC, it MUST also advertise at least one applicable
service-desc link. The deployed OpenAPI description identified by that link
MUST contain an x-iri-relation binding from the operation’s canonical
relation URI to the applicable Operation Object.
Clients use the registered relation to determine why the operation applies,
the advertised href to locate it, and the bound deployed OpenAPI Operation
Object to determine the method, parameters, request body, responses, errors,
and security requirements. Clients MUST NOT infer those details from the
relation name or probe a mutation to discover them.
An operation-affordance link targets an operation entry point rather than an
IRI representation. It MUST NOT carry an IRI representation profile.
Clients MUST NOT infer an operation URI solely from resource_type.
10.2 Phase 1 Coexistence with supported_endpoints
Phase 1 retains supported_endpoints with its existing optional category
semantics. When that property is present on a Resource:
- advertising a registered compute-family operation relation requires
"compute"in the array; - advertising a registered filesystem-family operation relation requires
"filesystem"in the array; - storage-discovery relations have no legacy category mapping.
The reverse implication does not apply. A retained category does not require any individual operation link, including when a link is authorization-filtered or its adapter operation is not implemented for the represented context. Authorization-suppressed links therefore do not make a retained category inconsistent.
Producers MUST NOT replace category values with relation names, operation
identifiers, or URLs. Clients MUST NOT construct or infer an operation link
from a category. Deprecation or removal of supported_endpoints requires a
separately approved later compatibility revision.
10.3 Generic Compute and Storage Resource Types
The exact generic Resource Types:
urn:doe-iri:resource:compute
urn:doe-iri:resource:storage
are governed by this common Resource profile; this profile does not create generic compute or storage Resource Definition Profiles.
Generic compute and storage Resources are conditionally eligible only for the filesystem and storage-location relations whose registered definitions permit the exact generic type, and only when the actual adapter semantics and operation context are explicit and unambiguous. Generic storage may also advertise registered storage-access-endpoint discovery where implemented. Generic compute is not eligible for compute-job relations.
Operation eligibility is exact-type-based. Eligibility of a generic or parent type MUST NOT be inherited automatically by descendants such as compute CPU or GPU Resources, storage systems, block storage, or object storage. Each registered relation definition remains authoritative for its complete source matrix and context requirements.
11. Relationship to Existing URI Properties
The current V2 Resource schema defines:
self_uri
site_uri
capability_uris
These properties expose Resource and related-resource URIs directly.
When the IRI HAL hypermedia model is used, the corresponding relationships SHOULD be represented through _links:
self_uri
↓
_links.self
site_uri
↓
_links["iri:located-at"]
capability_uris
↓
_links["iri:has-capability"]
For example:
{
"self_uri":
"https://api.example.org/api/v2/status/resources/pioneer-compute",
"site_uri":
"https://api.example.org/api/v2/facility/sites/example-site",
"capability_uris": [
"https://api.example.org/api/v2/account/capabilities/pioneer-gpu"
],
"_links": {
"self": {
"href":
"https://api.example.org/api/v2/status/resources/pioneer-compute",
"profile": "https://iri.science/profiles/status/resource"
},
"iri:located-at": {
"href":
"https://api.example.org/api/v2/facility/sites/example-site",
"profile": "https://iri.science/profiles/facility/site"
},
"iri:has-capability": [
{
"href":
"https://api.example.org/api/v2/account/capabilities/pioneer-gpu",
"profile": "https://iri.science/profiles/account/capability"
}
]
}
}
During the compatibility period:
- Producers retain the required
self_uri,site_uri, andcapability_urisproperties. - Producers MAY additionally expose corresponding HAL relationships.
- Whenever
site_uriand_links["iri:located-at"]are both present, the linkhrefMUST exactly equalsite_uri. - Whenever
capability_urisand_links["iri:has-capability"]are both present, they MUST identify the same targets, disregarding order. - Consumers SHOULD prefer advertised hypermedia relations and MAY fall back to corresponding URI-valued properties.
- Removing or changing existing URI properties requires a separate OpenAPI schema revision.
self_uriremains authoritative under the current OpenAPI contract until changed by an approved schema revision.
Clients implementing the HAL representation SHOULD use advertised _links for navigation rather than constructing URLs from identifiers or Resource Type URNs.
12. Media Type
This profile identifies the semantics of the Resource representation independently of a particular serialization.
When a Resource is represented using HAL JSON, the representation SHOULD use:
application/hal+json
and MAY identify this profile where appropriate:
https://iri.science/profiles/status/resource
The profile URI does not replace the media type or Resource Type URN.
The three identifiers have distinct roles:
application/hal+json
↓
HOW the representation is encoded
https://iri.science/profiles/status/resource
↓
WHAT semantic representation contract applies
urn:doe-iri:resource:storage:filesystem
↓
WHAT KIND of IRI Resource is represented
These identifiers MUST NOT be treated as interchangeable.
13. Static and Dynamic Semantics
A Resource representation may contain both relatively stable descriptive information and dynamic status information.
Relatively stable information typically includes:
id
name
description
group
resource_type
site_uri
capability_uris
supported_endpoints
Dynamic information includes:
current_status
last_modified
The attributes object is not categorically static or dynamic. The applicable
Resource Definition Profile defines whether each type-specific value represents
configuration, capability, descriptive metadata, a measured or quantitative
value, a time-varying observation, or another type-specific concept.
Type-specific attributes MUST NOT duplicate or override current_status, which
remains the common top-level property for the current reported Resource
condition.
Relationships such as:
iri:located-at
iri:has-capability
generally describe relatively stable topology or administrative association.
Their existence MUST NOT be interpreted as proof of current availability or operational health.
Operation affordances MAY be more dynamic.
The presence of an operation link indicates that the operation is applicable and discoverable in the current representation context.
It does not guarantee that invocation will succeed.
Clients SHOULD consult the current Resource representation before acting on an operation affordance rather than relying on cached, indexed, or previously observed links.
14. Authorization and Visibility
Authorization MAY affect information and relationships visible through a Resource representation.
A provider MAY omit:
- Capabilities;
- operation affordances;
- topology relationships;
- type-specific attributes;
- descriptive information;
- other optional links
when the requester is not authorized to discover that information, subject to requirements imposed by the applicable OpenAPI schema and relation definitions.
A producer MAY expose a broader parent Resource Type when disclosure of a more-specific subtype is intentionally restricted.
For example:
urn:doe-iri:resource:storage
may be exposed instead of:
urn:doe-iri:resource:storage:filesystem
when policy permits disclosure of the broad Resource class but not the more-specific subtype.
The absence of an operation link MUST NOT necessarily be interpreted as proof that the underlying Resource has no such operation.
It indicates only that the operation is not advertised in the current representation context.
Where legacy URI properties and corresponding HAL relationships are both returned, they MUST remain consistent.
15. Conformance
A representation conforms to the IRI Status Resource Profile when:
- it conforms to the applicable IRI Facility API
Resourceschema; - its properties are interpreted according to the IRI Facility API and this profile;
resource_typeis structurally represented as a string;resource_typecontains a Resource Type URN conforming to the DOE-IRI URN specification;- Resource Type URNs are interpreted according to the applicable DOE-IRI registry semantics;
- unfamiliar but syntactically valid Resource Type URNs are not rejected solely because they are absent from local client code or generated models;
- hierarchy-aware Resource Type matching operates on complete semantic segments;
- clients use nearest-recognized-parent or opaque fallback behavior where appropriate;
- Resource identifiers are treated as identifiers rather than URL templates;
- Resource Type URNs are treated as semantic classifications rather than URL or operation templates;
current_statusis distinguished from historical Event state;- the authoritative Site is discoverable through
site_urioriri:located-at; - associated Capabilities are discoverable through
capability_urisoriri:has-capability; - IRI-specific link relations use the canonical IRI relation namespace;
- representation profile URIs are not used as substitutes for Resource Type URNs or link-relation identifiers;
- when both
site_uriand_links["iri:located-at"]are present, they identify the same target; - when both
capability_urisand_links["iri:has-capability"]are present, they identify the same targets; - applicable operation entry points are discovered through advertised links rather than inferred from Resource identifiers or Resource Type URNs;
- clients are not required to infer or construct related-resource or operation URLs;
- when a Resource Definition profile applies, it supplements this common profile and does not replace it;
- every advertised adopted operation-affordance relation has an applicable
service-descwhose deployed OpenAPI contains the matching canonicalx-iri-relationbinding; - operation-affordance links do not carry IRI representation profiles;
- when
supported_endpointsis present, visible compute-family and filesystem-family links have the corresponding category, without requiring the reverse implication; - storage-discovery relations are not assigned a
supported_endpointscategory; and - generic compute and storage operation eligibility is applied only to exact types under the applicable registered relation and explicit adapter-context rules, never inferred through the Resource Type hierarchy.
A conforming representation MAY contain additional properties and links where permitted by the applicable IRI API specification.
16. Profile Identification
The canonical identifier for this profile is:
https://iri.science/profiles/status/resource
The profile URI is a stable semantic identifier.
Repository paths, GitHub URLs, OpenAPI document locations, Resource Type URNs, and documentation-generation URLs MUST NOT be substituted for this canonical identifier.
The canonical URI SHOULD resolve to documentation describing this profile.
17. Versioning
The profile version identifies the revision of this profile document.
Compatible editorial clarifications, new registered Resource Type URNs, and backward-compatible semantic additions MAY retain the same profile URI.
Adding a new Resource Type URN to the DOE-IRI URN Registry does not require a new version of this Resource representation profile merely because the taxonomy has expanded.
Changes that materially alter the interpretation or processing semantics of the common Resource representation SHOULD be evaluated for compatibility before incorporation into the existing profile.
The canonical profile URI SHOULD remain stable across compatible revisions.
DOE Integrated Research Infrastructure — Status Resource Profile