tacker/api-ref/source/v2/parameters_vnffm.yaml
Yasufumi Ogawa 5587b8e17d Enhanced VNF FM and VNF PM Documentation
Added notifications sent to API consumers by the VNF Fault Management
and VNF Performance Management features to the API Reference.

Added the following APIs:
- alarm notification
- AlarmClearedNotification
- PerformanceInformationAvailableNotification
- ThresholdCrossedNotification
- Test the notification endpoint

Change-Id: I5f169809c14bc980c8e2b37f1b49299cfa62086f
Signed-off-by: Yasufumi Ogawa <yasufum.o@gmail.com>
Co-Authored-By: Yoshiro Watanabe <fj3838ct@fujitsu.com>
2024-09-06 08:36:45 +00:00

555 lines
15 KiB
YAML

# variables in header
alarm_id_path:
description: |
Identifier of this Alarm information element.
in: path
required: true
type: string
subscription_id_path:
description: |
Identifier of this subscription.
in: path
required: true
type: string
# variables in body
ack_state:
description: |
Acknowledgement state of the alarm. Permitted values: UNACKNOWLEDGED,
ACKNOWLEDGED.
in: body
required: true
type: string
alarm:
description: |
Information about an alarm including AlarmId, affected VNF identifier,
and FaultDetails.
in: body
required: true
type: object
alarm_acknowledged_time:
description: |
Time stamp indicating when the alarm was acknowledged. It shall be present
if the alarm has been acknowledged.
in: body
required: false
type: string
alarm_changed_time:
description: |
Time stamp indicating when the alarm was last changed. It shall be present
if the alarm has been updated.
in: body
required: false
type: string
alarm_cleared_notification_alarm_cleared_time:
description: |
The time stamp indicating when the alarm was cleared.
in: body
required: true
type: string
alarm_cleared_notification_alarm_id:
description: |
Alarm identifier.
in: body
required: true
type: string
alarm_cleared_notification_type:
description: |
Discriminator for the different notification types.
Set to "AlarmClearedNotification" for this notification type.
in: body
required: true
type: string
alarm_cleared_time:
description: |
Time stamp indicating when the alarm was cleared. It shall be present if
the alarm has been cleared.
in: body
required: false
type: string
alarm_faulty_resource_vim_connection_id:
description: |
Identifier of the VIM connection to manage the resource. This attribute
shall only be supported and present if VNFrelated resource management in
direct mode is applicable.
in: body
required: false
type: string
alarm_id:
description: |
Identifier of this Alarm information element.
in: body
required: true
type: string
alarm_links:
description: |
Links for this resource.
in: body
required: true
type: object
alarm_notification_type:
description: |
Discriminator for the different notification types.
Set to "AlarmNotification" for this notification type.
in: body
required: true
type: string
alarm_perceived_severity:
description: |
Perceived severity of the managed object failure.
in: body
required: true
type: object
alarm_raised_time:
description: |
Time stamp indicating when the alarm is raised by the managed object.
in: body
required: true
type: string
alarm_self:
description: |
URI of this resource.
in: body
required: true
type: object
authentication:
description: |
Authentication parameters to configure the use of Authorization when
sending notifications corresponding to this subscription.
in: body
required: false
type: string
authentication_auth_type:
description: |
Defines the types of Authentication/Authorization which
the API consumer is willing to accept when receiving a
notification.
Permitted values:
BASIC: In every HTTP request to the
notification endpoint, use HTTP Basic
authentication with the client credentials.
OAUTH2_CLIENT_CREDENTIALS: In every HTTP request
to the notification endpoint, use an OAuth 2.0 token,
obtained using the client credentials grant type
after authenticating using client identifier and
client password towards the token endpoint.
OAUTH2_CLIENT_CERT: In every HTTP request to
the notification endpoint, use an OAuth 2.0 token,
obtained using the client credentials grant type
after mutually authenticating using client identifier
and X.509 certificates towards the token endpoint.
TLS_CERT is not supported.
in: body
required: true
type: array
authentication_params_basic:
description: |
Parameters for authentication/authorization using BASIC.
Shall be present if authType is "BASIC" and the
contained information has not been provisioned out of
band. Shall be absent otherwise.
in: body
required: false
type: object
authentication_params_oauth2_client_cert:
description: |
Parameters for authentication/authorization using
OAUTH2_CLIENT_CERT.
Shall be present if authType is "OAUTH2_CLIENT_CERT" and the
contained information has not been provisioned out of band.
Shall be absent otherwise.
in: body
required: false
type: object
authentication_params_oauth2_client_credentials:
description: |
Parameters for authentication/authorization using
OAUTH2_CLIENT_CREDENTIALS.
Shall be present if authType is
"OAUTH2_CLIENT_CREDENTIALS" and the contained
information has not been provisioned out of band.
Shall be absent otherwise.
in: body
required: false
type: object
callback_uri:
description: |
The URI of the endpoint to send the notification to.
in: body
required: true
type: string
correlated_alarm_ids:
description: |
List of identifiers of other alarms correlated to this fault.
in: body
required: false
type: array
event_time:
description: |
Time stamp indicating when the fault was observed.
in: body
required: true
type: string
event_type:
description: |
Type of event.
in: body
required: true
type: object
fault_details:
description: |
Provides additional information about the fault.
in: body
required: false
type: array
fault_type:
description: |
Additional information to clarify the type of the fault.
in: body
required: false
type: string
faulty_resource:
description: |
Information that identifies the faulty resource instance and its managing
entity.
in: body
required: true
type: object
faulty_resource_id:
description: |
Identifier of the resource in the scope of the VIM or the resource provider.
in: body
required: true
type: string
faulty_resource_info:
description: |
The virtualised resources that are causing the VNF fault. Shall be present
if the alarm affects virtualised resources.
in: body
required: false
type: object
faulty_resource_provider_id:
description: |
Identifier of the entity responsible for the management of the resource.
This attribute shall only be supported and present when VNF-related
resource management in indirect mode is applicable. The identification
scheme is outside the scope of the present document.
in: body
required: false
type: string
faulty_resource_type:
description: |
Type of the faulty resource. COMPUTE: Virtual compute resource, STORAGE:
Virtual storage resource, NETWORK: Virtual network resource.
in: body
required: true
type: object
faulty_resource_vim_connection_id:
description: |
Identifier of the VIM connection to manage the resource. This attribute
shall only be supported and present if VNFrelated resource management in
direct mode is applicable. The applicable “VimConnectionInfo” structure,
which is referenced by vimConnectionId, can be obtained from the
“vimConnectionInfo” attribute of the “VnfInstance” structure.
in: body
required: false
type: string
faulty_resource_vim_level_resource_type:
description: |
Type of the resource in the scope of the VIM or the resource provider.
in: body
required: false
type: string
filter_event_types:
description: |
Match VNF alarms with an event type. COMMUNICATIONS_ALARM,
PROCESSING_ERROR_ALARM, ENVIRONMENTAL_ALARM, QOS_ALARM, EQUIPMENT_ALARM.
in: body
required: false
type: array
filter_faulty_resource_types:
description: |
Match VNF alarms with a faulty resource type. COMPUTE, STORAGE, NETWORK.
in: body
required: false
type: array
filter_notification_types:
description: |
Match particular notification types. Permitted values: AlarmNotification,
AlarmClearedNotification, AlarmListRebuiltNotification.
in: body
required: false
type: array
filter_perceived_severities:
description: |
Match VNF alarms with a perceived severity. CRITICAL,MAJOR,MINOR,WARNING,
INDETERMINATE,CLEARED.
in: body
required: false
type: array
filter_probable_causes:
description: |
Match VNF alarms with a probable cause listed in this attribute.
in: body
required: false
type: array
filter_subscription_filter:
description: |
Filter criteria to select VNF instances about which to notify.
in: body
required: false
type: object
fm_notification_filter:
description: |
Filter settings for this subscription, to define the subset of all
notifications this subscription relates to. A particular notification is
sent to the subscriber if the filter matches, or if there is no filter.
in: body
required: false
type: object
is_root_cause:
description: |
Attribute indicating if this fault is the root of other correlated alarms.
If true, then the alarms listed in the attribute “correlatedAlarmIds” are
caused by this fault.
in: body
required: true
type: bool
managed_object_id:
description: |
Identifier of the affected VNF instance.
in: body
required: true
type: string
notification_id:
description: |
Identifier of this notification.
in: body
required: true
type: string
notification_links:
description: |
Links to resources related to this notification.
in: body
required: true
type: object
notification_time_stamp:
description: |
Date-time of the generation of the notification.
in: body
required: true
type: string
object_instance:
description: |
Link to the resource representing the VNF instance to which the notified
alarm is correlated. Shall be present if the VNF instance information is
accessible as a resource.
in: body
required: false
type: object
params_oauth2_client_cert_certificate_ref:
description: |
Fingerprint of the client certificate. The hash function
shall use SHA256 or higher. Shall be present if it has not
been provisioned out of band.
in: body
required: true
type: object
params_oauth2_client_cert_client_id:
description: |
Client identifier to be used in the access token request
of the OAuth 2.0 client credentials grant type. Shall be
present if it has not been provisioned out of band.
in: body
required: true
type: string
params_oauth2_client_cert_token_endpoint:
description: |
The token endpoint from which the access token can be
obtained. Shall be present if it has not been provisioned
out of band.
in: body
required: true
type: string
params_oauth2_client_cert_type:
description: |
The type of fingerprint.
Permitted values:
x5t#S256: The SHA-256 thumbprint of the X.509 certificate
as defined in section 4.1.8 of IETF RFC 7515.
in: body
required: true
type: string
params_oauth2_client_cert_value:
description: |
The fingerprint value as defined by the type. Shall be
present if it has not been provisioned out of band.
in: body
required: true
type: string
params_oauth2_client_credentials_client_id:
description: |
Client identifier to be used in the access token request
of the OAuth 2.0 client credentials grant type. Shall be
present if it has not been provisioned out of band.
in: body
required: false
type: string
params_oauth2_client_credentials_client_password:
description: |
Client password to be used in the access token request
of the OAuth 2.0 client credentials grant type. Shall be
present if it has not been provisioned out of band.
in: body
required: false
type: string
params_oauth2_client_credentials_token_endpoint:
description: |
The token endpoint from which the access token can be
obtained. Shall be present if it has not been provisioned
out of band.
in: body
required: false
type: string
paramsBasic_password:
description: |
Password to be used in HTTP Basic authentication.
Shall be present if it has not been provisioned out of band.
in: body
required: false
type: string
paramsBasic_userName:
description: |
Username to be used in HTTP Basic authentication.
Shall be present if it has not been provisioned out of band.
in: body
required: false
type: string
perceived_severity:
description: |
Perceived severity of the managed object failure. CRITICAL,MAJOR,MINOR,
WARNING,INDETERMINATE,CLEARED.
in: body
required: true
type: object
probable_cause:
description: |
Information about the probable cause of the fault.
in: body
required: true
type: string
products_versions:
description: |
If present, match VNF instances that belong to VNF products with certain
versions and a certain product name, from one particular provider.
in: body
required: false
type: array
products_vnf_product_name:
description: |
Name of the VNF product to match.
in: body
required: true
type: string
related_alarm_links:
description: |
Link to the resource that represents the related alarm.
in: body
required: true
type: object
related_subscription_id:
description: |
Identifier of the subscription that this notification relates to.
in: body
required: true
type: string
related_subscription_links:
description: |
Link to the related subscription.
in: body
required: true
type: object
subscription_filter_vnf_instance_ids:
description: |
If present, match VNF instances with an instance identifier listed in this
attribute.
in: body
required: false
type: array
subscription_filter_vnf_instance_names:
description: |
If present, match VNF instances with a VNF Instance Name listed in this
attribute.
in: body
required: false
type: array
subscription_filter_vnf_products_from_providers:
description: |
If present, match VNF instances that belong to VNF products from certain
providers.
in: body
required: false
type: array
subscription_filter_vnfd_ids:
description: |
If present, match VNF instances that were created based on a VNFD
identified by one of the vnfdId values listed in this attribute.
in: body
required: false
type: array
subscription_id:
description: |
Identifier of this subscription.
in: body
required: true
type: string
subscription_links:
description: |
Links for this resource.
in: body
required: true
type: object
subscription_self:
description: |
URI of this resource.
in: body
required: true
type: object
versions_vnf_software_version:
description: |
Software version to match.
in: body
required: true
type: object
versions_vnfd_versions:
description: |
Software version to match.
in: body
required: false
type: array
vnf_products_from_providers_vnf_products:
description: |
If present, match VNF instances that belong to VNF products from certain
providers.
in: body
required: false
type: array
vnf_products_from_providers_vnf_provider:
description: |
If present, match VNF instances that belong to VNF products from certain
providers.
in: body
required: true
type: string
vnfc_instance_ids:
description: |
Identifiers of the affected VNFC instances.
in: body
required: false
type: array