Difference between revisions of "NFV URN Namespace"

From NFVwiki
Jump to: navigation, search
(Moving "NFVURN Page" from private wiki to public wiki.)
 
(Added new URN entries from NFV000039r1)
 
(6 intermediate revisions by 3 users not shown)
Line 18: Line 18:
 
  <nowiki>urn:etsi:nfv:yang:etsi-nfv-descriptors</nowiki>
 
  <nowiki>urn:etsi:nfv:yang:etsi-nfv-descriptors</nowiki>
 
|string
 
|string
|Namespace for YANG modules specified in ETSI GS NFV-SOL 006.
+
|The namespace for YANG modules specified in ETSI GS NFV-SOL 006, available for download as [https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/006/02.06.01_60/gs_nfv-sol006v020601p.pdf ETSI GS NFV-SOL 006 v2.6.1] and as a YANG specification in [https://forge.etsi.org/gitlab/nfv/SOL006/blob/master/src/yang/etsi-nfv-descriptors.yang etsi-nfv-descriptors.yang].
[https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL006_YANG_based_NFV_Descriptors_spec Latest draft of SOL006]
+
|-
 +
|yang:etsi-nfv-vnfd
 +
|
 +
<nowiki>urn:etsi:nfv:yang:etsi-nfv-vnfd</nowiki>
 +
|string
 +
|Namespace for the YANG module that is used to model a single VNFD, according to the YANG specification available in [https://forge.etsi.org/rep/nfv/SOL006/blob/v2.6.1/src/yang/etsi-nfv-vnfd.yang etsi-nfv-vnfd.yang] file and specified in [https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/006/02.06.01_60/gs_nfv-sol006v020601p.pdf ETSI GS NFV-SOL 006 v2.6.1].
 +
|-
 +
|yang:etsi-nfv-nsd
 +
|
 +
<nowiki>urn:etsi:nfv:yang:etsi-nfv-nsd</nowiki>
 +
|string
 +
|Namespace for the YANG module that is used to model a single NSD, according to the YANG specification available in [https://forge.etsi.org/rep/nfv/SOL006/blob/v2.6.1/src/yang/etsi-nfv-nsd.yang etsi-nfv-nsd.yang] file and specified in [https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/006/02.06.01_60/gs_nfv-sol006v020601p.pdf ETSI GS NFV-SOL 006 v2.6.1].
 +
|-
 +
|yang:etsi-nfv-pnfd
 +
|
 +
<nowiki>urn:etsi:nfv:yang:etsi-nfv-pnfd</nowiki>
 +
|string
 +
|Namespace for the YANG module that is used to model a single PNFD, according to the YANG specification available in [https://forge.etsi.org/rep/nfv/SOL006/blob/v2.6.1/src/yang/etsi-nfv-pnfd.yang etsi-nfv-pnfd.yang] file and specified in [https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/006/02.06.01_60/gs_nfv-sol006v020601p.pdf ETSI GS NFV-SOL 006 v2.6.1].
 +
|-
 +
|webfinger
 +
|<code><nowiki>urn:etsi:nfv:webfinger</nowiki></code>
 +
|string
 +
|This node is a namespace for webfinger services.
 +
Related specification [https://docbox.etsi.org/ISG/NFV/Open/Drafts/SEC022_API_Access_Token_Spec/NFV-SEC022v010.zip ETSI GS NFV-SEC 022 (latest draft)]
 +
|-
 +
|webfinger:rel
 +
|<code><nowiki>urn:etsi:nfv:webfinger:rel</nowiki></code>
 +
|string
 +
|This node is a namespace for "rel" value of the webfinger services used for the dynamic discovery of servers.
 +
Related specification [https://docbox.etsi.org/ISG/NFV/Open/Drafts/SEC022_API_Access_Token_Spec/NFV-SEC022v010.zip ETSI GS NFV-SEC 022 (latest draft)]
 +
|-
 +
|webfinger:rel:api-oauth-server
 +
|<code><nowiki>urn:etsi:nfv:webfinger:rel:api-oauth-server</nowiki></code>
 +
|string
 +
|Value of Webfinger service for the discovery of authorization server identifier for API access control using OAuth2.0.
 +
Related specification [https://docbox.etsi.org/ISG/NFV/Open/Drafts/SEC022_API_Access_Token_Spec/NFV-SEC022v010.zip ETSI GS NFV-SEC 022 (latest draft)]
 
|}
 
|}
  
Line 29: Line 64:
 
  ALPHANUMERIC = {a-zA-Z0-9}
 
  ALPHANUMERIC = {a-zA-Z0-9}
  
=== Requesting an entry (for ETSI technical bodies only) ===
+
=== Requesting an entry (for ETSI technical groups only) ===
A new NFV sub-tree can only be requested by a ETSI technical body.
+
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 guide below.
+
To request a sub-tree please follow the guidelines below.
  
* '''Pre-condition:''' a work item running in the WG has identified the need to enable a URN namespace. A contact person to formalize the request has been identified (e.g., a WG official such as the WG Chair, the work item rapporteur).
+
* '''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 [https://portal.etsi.org/ngppapp/ContributionCreation.aspx?primarykeys=168857&source=QIGSBIKSHQAZ NFVTSC(19)000003]
+
* ''Step #1:'' Download the "URN namespace application template" in contribution [https://docbox.etsi.org/ISG/NFV/TSC/05-CONTRIBUTIONS/2019//NFVTSC(19)000003r2_Template_for_URN_namespace_applications.docx 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 #2:'' Fill in the template and submit it as a contribution under the "NFV TSC" workspace of the ETSI Portal.
* ''Step #3:'' The TSC will review the application.
+
* ''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 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".
 
** 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".

Latest revision as of 16:10, 6 June 2019

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".