diff --git a/src/SOL012/PolicyManagement/PolicyManagement.yaml b/src/SOL012/PolicyManagement/PolicyManagement.yaml index c616dbc70e98362a492b371e910ef3fae618e7e4..bd2e51787dfd3616d42645209ab5d9b89f8243cc 100644 --- a/src/SOL012/PolicyManagement/PolicyManagement.yaml +++ b/src/SOL012/PolicyManagement/PolicyManagement.yaml @@ -575,9 +575,18 @@ components: type: string pfId: description: > - Identifier of the Policy Function (PF) which enforces the policy. The PF is either a VNFM or a VIM. - Cardinality of zero indicates that the PF is the API producer itself. + Identifier of the Policy Function (PF) which enforces the policy. Shall be present when the + PF is not the API producer and shall be absent otherwise. + For example, the PF can be a VNFM or VIM when the API producer is an NFVO. $ref: "../components/SOL012_schemas.yaml#/components/schemas/Identifier" + associations: + description: > + Initial value of the “associations” attribute in the “Policy” data structure which represents the policy. + How the PF determines the scope of applicability of the policy when this attribute + is absent is outside the scope of the present document. + type: array + items: + $ref: "../components/SOL012_schemas.yaml#/components/schemas/Identifier" required: - designer - name @@ -601,8 +610,9 @@ components: type: string pfId: description: > - Identifier of the Policy Function (PF) which enforces the policy. The PF is either a VNFM or a VIM. - Cardinality of zero indicates that the PF is the API producer itself. + Identifier of the Policy Function (PF) which enforces the policy. Shall be present when the PF is not + the API producer and shall be absent otherwise. + For example, the PF can be a VNFM or VIM when the API producer is an NFVO. $ref: "../components/SOL012_schemas.yaml#/components/schemas/Identifier" versions: description: > @@ -614,16 +624,18 @@ components: description: > Selected version of the policy. Shall be present if one or more versions of the policy have been transferred. $ref: "../components/SOL012_schemas.yaml#/components/schemas/Version" - policy: - description: > - Content of the policy. activationStatus: description: > Status of the policy on whether it is activated or deactivated. $ref: "../components/SOL012_schemas.yaml#/components/schemas/ActivationStatus" associations: description: > - Identifiers of the entities that the API producer manages and to which the policy associates to. + Identifiers of the entities that the PF manages and to which the policy associates to. + The associations refer to identifiers of entities that the PF manages. + E.g., if the PF is a VNFM, the policy can associate to VNF instances; if the PF is NFVO, the policy can + associate to an NS instances. + How the PF determines the scope of applicability of the policy when this attribute is absent is + outside the scope of the present document. type: array items: $ref: "../components/SOL012_schemas.yaml#/components/schemas/Identifier" diff --git a/src/SOL012/components/SOL012_schemas.yaml b/src/SOL012/components/SOL012_schemas.yaml index c0b7d4d022fd5f6f75365030fcd8f5c5efbfb38f..941c6da442b42f1691fb5a7dad84f2d4bd638392 100644 --- a/src/SOL012/components/SOL012_schemas.yaml +++ b/src/SOL012/components/SOL012_schemas.yaml @@ -305,13 +305,32 @@ components: description: > New version of the policy to be selected. $ref: "../components/SOL012_schemas.yaml#/components/schemas/Version" - associations: + addAssociations: description: > - Modified associations of the policy, includes the identifiers of the entities that the API - producer manages and to which the policy associates to. + Identifiers of entities to be added to the “associations” attribute in the “Policy” + data structure which represents the policy. + The API producer shall ignore the identifiers that already exist in the "associations" + attribute in the “Policy” data structure. type: array items: $ref: "../components/SOL012_schemas.yaml#/components/schemas/Identifier" + removeAssociations: + description: > + Identifiers of entities to be removed from the “associations” attribute in the “Policy” data structure + which represents the policy. + The API producer shall ignore the identifiers that do not exist in the "associations" + attribute in the “Policy” data structure + type: array + items: + $ref: "../components/SOL012_schemas.yaml#/components/schemas/Identifier" + removeAllAssociations: + description: > + Shall be set to TRUE if the policy is no longer associated to any specific entities managed by the PF.ù + If "removeAllAssociations" is set to TRUE, neither "addAssociations" nor “removeAssociations” attributes + shall be present. + Once all associations have been removed, how the PF determines the scope of applicability of + the policy is outside the scope of the present document. + type: boolean PolicyOperationType: description: >