NFV URN Namespace

From NFVwiki
Revision as of 16:10, 6 June 2019 by Worndle (talk | contribs) (Added new URN entries from NFV000039r1)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Introduction

ETSI ISG NFV is maintaining a namespace registry as a sub tree of the ETSI root urn:etsi namespace. A description of the top level ETSI URN namespace can be found on the ETSI webpage [1].

The NFV URN namespace has the following structure:

urn:etsi:nfv:<NFV sub-tree>

The following sections describe the basic structure of the sub-tree and how a entry in the registry can be requested.

NFV sub-tree

NFV sub-tree Full Namespace Type Description
yang:etsi-nfv-descriptors
urn:etsi:nfv:yang:etsi-nfv-descriptors
string The namespace for YANG modules specified in ETSI GS NFV-SOL 006, available for download as ETSI GS NFV-SOL 006 v2.6.1 and as a YANG specification in etsi-nfv-descriptors.yang.
yang:etsi-nfv-vnfd
urn:etsi:nfv:yang:etsi-nfv-vnfd
string Namespace for the YANG module that is used to model a single VNFD, according to the YANG specification available in etsi-nfv-vnfd.yang file and specified in ETSI GS NFV-SOL 006 v2.6.1.
yang:etsi-nfv-nsd
urn:etsi:nfv:yang:etsi-nfv-nsd
string Namespace for the YANG module that is used to model a single NSD, according to the YANG specification available in etsi-nfv-nsd.yang file and specified in ETSI GS NFV-SOL 006 v2.6.1.
yang:etsi-nfv-pnfd
urn:etsi:nfv:yang:etsi-nfv-pnfd
string Namespace for the YANG module that is used to model a single PNFD, according to the YANG specification available in etsi-nfv-pnfd.yang file and specified in ETSI GS NFV-SOL 006 v2.6.1.
webfinger urn:etsi:nfv:webfinger string This node is a namespace for webfinger services.

Related specification ETSI GS NFV-SEC 022 (latest draft)

webfinger:rel urn:etsi:nfv:webfinger:rel string This node is a namespace for "rel" value of the webfinger services used for the dynamic discovery of servers.

Related specification ETSI GS NFV-SEC 022 (latest draft)

webfinger:rel:api-oauth-server urn:etsi:nfv:webfinger:rel:api-oauth-server string Value of Webfinger service for the discovery of authorization server identifier for API access control using OAuth2.0.

Related specification ETSI GS NFV-SEC 022 (latest draft)

Type definitions

string = (ALPHA)0*(ALPHANUMERIC/-/_)
# a string starts with an upper- or lower-case letter followed by zero or more upper- or lower-case letters, integer numbers, hyphens or underscores

ALPHA = {a-zA-Z}
ALPHANUMERIC = {a-zA-Z0-9}

Requesting an entry (for ETSI technical groups only)

A new NFV sub-tree can only be requested by an ETSI technical group (i.e., Technical Bodies, Industry Specification Groups, Open Source Groups and Special Communities), and their working groups (if applicable).

To request a sub-tree please follow the guidelines below.

  • Pre-condition: a work item running in the ETSI technical group has identified the need to enable a URN namespace. A contact person to formalize the request has been identified (e.g., a technical group official such as a WG Chair, the work item rapporteur).
  • Step #1: Download the "URN namespace application template" in contribution NFVTSC(19)000003
  • Step #2: Fill in the template and submit it as a contribution under the "NFV TSC" workspace of the ETSI Portal.
  • Step #3: The ETSI NFV TSC will review the application.
    • If the application is accepted, a new entry in the "NFV URN Namespace" will be enabled.
    • If the application cannot be accepted, it will be communicated to the contact person together with any additional information to be considered for resolving the "non-acceptance".