AWS Telco Network Builder Update: This release adds tagging support to the following Network Instance APIs : Instantiate, Update, Terminate.

Author: AWS

.changes/next-release/feature-AWSTelcoNetworkBuilder-ee04b8b.json

@@ -0,0 +1,6 @@
+{
+    "type": "feature",
+    "category": "AWS Telco Network Builder",
+    "contributor": "",
+    "description": "This release adds tagging support to the following Network Instance APIs : Instantiate, Update, Terminate."
+}

services/tnb/src/main/resources/codegen-resources/service-2.json

@@ -45,7 +45,7 @@
         {"shape":"ValidationException"},
         {"shape":"AccessDeniedException"}
       ],
-      "documentation":"<p>Creates a function package.</p> <p>A function package is a .zip file in CSAR (Cloud Service Archive) format that contains a network function (an ETSI standard telecommunication application) and function package descriptor that uses the TOSCA standard to describe how the network functions should run on your network. For more information, see <a href=\"https://docs.aws.amazon.com/tnb/latest/ug/function-packages.html\">Function packages</a> in the <i>Amazon Web Services Telco Network Builder User Guide</i>. </p> <p>Creating a function package is the first step for creating a network in AWS TNB. This request creates an empty container with an ID. The next step is to upload the actual CSAR zip file into that empty container. To upload function package content, see <a href=\"https://docs.aws.amazon.com/TNB/latest/APIReference/API_PutSolFunctionPackageContent.html\">PutSolFunctionPackageContent</a>.</p>"
+      "documentation":"<p>Creates a function package.</p> <p>A function package is a .zip file in CSAR (Cloud Service Archive) format that contains a network function (an ETSI standard telecommunication application) and function package descriptor that uses the TOSCA standard to describe how the network functions should run on your network. For more information, see <a href=\"https://docs.aws.amazon.com/tnb/latest/ug/function-packages.html\">Function packages</a> in the <i>Amazon Web Services Telco Network Builder User Guide</i>. </p> <p>Creating a function package is the first step for creating a network in AWS TNB. This request creates an empty container with an ID. The next step is to upload the actual CSAR zip file into that empty container. To upload function package content, see <a href=\"https://docs.aws.amazon.com/tnb/latest/APIReference/API_PutSolFunctionPackageContent.html\">PutSolFunctionPackageContent</a>.</p>"
     },
     "CreateSolNetworkInstance":{
       "name":"CreateSolNetworkInstance",
@@ -64,7 +64,7 @@
         {"shape":"ResourceNotFoundException"},
         {"shape":"AccessDeniedException"}
       ],
-      "documentation":"<p>Creates a network instance.</p> <p>A network instance is a single network created in Amazon Web Services TNB that can be deployed and on which life-cycle operations (like terminate, update, and delete) can be performed. Creating a network instance is the third step after creating a network package. For more information about network instances, <a href=\"https://docs.aws.amazon.com/tnb/latest/ug/network-instances.html\">Network instances</a> in the <i>Amazon Web Services Telco Network Builder User Guide</i>.</p> <p>Once you create a network instance, you can instantiate it. To instantiate a network, see <a href=\"https://docs.aws.amazon.com/TNB/latest/APIReference/API_InstantiateSolNetworkInstance.html\">InstantiateSolNetworkInstance</a>.</p>"
+      "documentation":"<p>Creates a network instance.</p> <p>A network instance is a single network created in Amazon Web Services TNB that can be deployed and on which life-cycle operations (like terminate, update, and delete) can be performed. Creating a network instance is the third step after creating a network package. For more information about network instances, <a href=\"https://docs.aws.amazon.com/tnb/latest/ug/network-instances.html\">Network instances</a> in the <i>Amazon Web Services Telco Network Builder User Guide</i>.</p> <p>Once you create a network instance, you can instantiate it. To instantiate a network, see <a href=\"https://docs.aws.amazon.com/tnb/latest/APIReference/API_InstantiateSolNetworkInstance.html\">InstantiateSolNetworkInstance</a>.</p>"
     },
     "CreateSolNetworkPackage":{
       "name":"CreateSolNetworkPackage",
@@ -82,7 +82,7 @@
         {"shape":"ValidationException"},
         {"shape":"AccessDeniedException"}
       ],
-      "documentation":"<p>Creates a network package.</p> <p>A network package is a .zip file in CSAR (Cloud Service Archive) format defines the function packages you want to deploy and the Amazon Web Services infrastructure you want to deploy them on. For more information, see <a href=\"https://docs.aws.amazon.com/tnb/latest/ug/network-instances.html\">Network instances</a> in the <i>Amazon Web Services Telco Network Builder User Guide</i>. </p> <p>A network package consists of a network service descriptor (NSD) file (required) and any additional files (optional), such as scripts specific to your needs. For example, if you have multiple function packages in your network package, you can use the NSD to define which network functions should run in certain VPCs, subnets, or EKS clusters.</p> <p>This request creates an empty network package container with an ID. Once you create a network package, you can upload the network package content using <a href=\"https://docs.aws.amazon.com/TNB/latest/APIReference/API_PutSolNetworkPackageContent.html\">PutSolNetworkPackageContent</a>.</p>"
+      "documentation":"<p>Creates a network package.</p> <p>A network package is a .zip file in CSAR (Cloud Service Archive) format defines the function packages you want to deploy and the Amazon Web Services infrastructure you want to deploy them on. For more information, see <a href=\"https://docs.aws.amazon.com/tnb/latest/ug/network-instances.html\">Network instances</a> in the <i>Amazon Web Services Telco Network Builder User Guide</i>. </p> <p>A network package consists of a network service descriptor (NSD) file (required) and any additional files (optional), such as scripts specific to your needs. For example, if you have multiple function packages in your network package, you can use the NSD to define which network functions should run in certain VPCs, subnets, or EKS clusters.</p> <p>This request creates an empty network package container with an ID. Once you create a network package, you can upload the network package content using <a href=\"https://docs.aws.amazon.com/tnb/latest/APIReference/API_PutSolNetworkPackageContent.html\">PutSolNetworkPackageContent</a>.</p>"
     },
     "DeleteSolFunctionPackage":{
       "name":"DeleteSolFunctionPackage",
@@ -99,7 +99,7 @@
         {"shape":"ResourceNotFoundException"},
         {"shape":"AccessDeniedException"}
       ],
-      "documentation":"<p>Deletes a function package.</p> <p>A function package is a .zip file in CSAR (Cloud Service Archive) format that contains a network function (an ETSI standard telecommunication application) and function package descriptor that uses the TOSCA standard to describe how the network functions should run on your network.</p> <p>To delete a function package, the package must be in a disabled state. To disable a function package, see <a href=\"https://docs.aws.amazon.com/TNB/latest/APIReference/API_UpdateSolFunctionPackage.html\">UpdateSolFunctionPackage</a>. </p>",
+      "documentation":"<p>Deletes a function package.</p> <p>A function package is a .zip file in CSAR (Cloud Service Archive) format that contains a network function (an ETSI standard telecommunication application) and function package descriptor that uses the TOSCA standard to describe how the network functions should run on your network.</p> <p>To delete a function package, the package must be in a disabled state. To disable a function package, see <a href=\"https://docs.aws.amazon.com/tnb/latest/APIReference/API_UpdateSolFunctionPackage.html\">UpdateSolFunctionPackage</a>. </p>",
       "idempotent":true
     },
     "DeleteSolNetworkInstance":{
@@ -117,7 +117,7 @@
         {"shape":"ResourceNotFoundException"},
         {"shape":"AccessDeniedException"}
       ],
-      "documentation":"<p>Deletes a network instance.</p> <p>A network instance is a single network created in Amazon Web Services TNB that can be deployed and on which life-cycle operations (like terminate, update, and delete) can be performed.</p> <p>To delete a network instance, the instance must be in a stopped or terminated state. To terminate a network instance, see <a href=\"https://docs.aws.amazon.com/TNB/latest/APIReference/API_TerminateSolNetworkInstance.html\">TerminateSolNetworkInstance</a>.</p>",
+      "documentation":"<p>Deletes a network instance.</p> <p>A network instance is a single network created in Amazon Web Services TNB that can be deployed and on which life-cycle operations (like terminate, update, and delete) can be performed.</p> <p>To delete a network instance, the instance must be in a stopped or terminated state. To terminate a network instance, see <a href=\"https://docs.aws.amazon.com/tnb/latest/APIReference/API_TerminateSolNetworkInstance.html\">TerminateSolNetworkInstance</a>.</p>",
       "idempotent":true
     },
     "DeleteSolNetworkPackage":{
@@ -135,7 +135,7 @@
         {"shape":"ResourceNotFoundException"},
         {"shape":"AccessDeniedException"}
       ],
-      "documentation":"<p>Deletes network package.</p> <p>A network package is a .zip file in CSAR (Cloud Service Archive) format defines the function packages you want to deploy and the Amazon Web Services infrastructure you want to deploy them on.</p> <p>To delete a network package, the package must be in a disable state. To disable a network package, see <a href=\"https://docs.aws.amazon.com/TNB/latest/APIReference/API_UpdateSolNetworkPackage.html\">UpdateSolNetworkPackage</a>.</p>",
+      "documentation":"<p>Deletes network package.</p> <p>A network package is a .zip file in CSAR (Cloud Service Archive) format defines the function packages you want to deploy and the Amazon Web Services infrastructure you want to deploy them on.</p> <p>To delete a network package, the package must be in a disable state. To disable a network package, see <a href=\"https://docs.aws.amazon.com/tnb/latest/APIReference/API_UpdateSolNetworkPackage.html\">UpdateSolNetworkPackage</a>.</p>",
       "idempotent":true
     },
     "GetSolFunctionInstance":{
@@ -317,7 +317,7 @@
         {"shape":"ResourceNotFoundException"},
         {"shape":"AccessDeniedException"}
       ],
-      "documentation":"<p>Instantiates a network instance.</p> <p>A network instance is a single network created in Amazon Web Services TNB that can be deployed and on which life-cycle operations (like terminate, update, and delete) can be performed.</p> <p>Before you can instantiate a network instance, you have to create a network instance. For more information, see <a href=\"https://docs.aws.amazon.com/TNB/latest/APIReference/API_CreateSolNetworkInstance.html\">CreateSolNetworkInstance</a>.</p>"
+      "documentation":"<p>Instantiates a network instance.</p> <p>A network instance is a single network created in Amazon Web Services TNB that can be deployed and on which life-cycle operations (like terminate, update, and delete) can be performed.</p> <p>Before you can instantiate a network instance, you have to create a network instance. For more information, see <a href=\"https://docs.aws.amazon.com/tnb/latest/APIReference/API_CreateSolNetworkInstance.html\">CreateSolNetworkInstance</a>.</p>"
     },
     "ListSolFunctionInstances":{
       "name":"ListSolFunctionInstances",
@@ -588,7 +588,7 @@
         {"shape":"ResourceNotFoundException"},
         {"shape":"AccessDeniedException"}
       ],
-      "documentation":"<p>Validates function package content. This can be used as a dry run before uploading function package content with <a href=\"https://docs.aws.amazon.com/TNB/latest/APIReference/API_PutSolFunctionPackageContent.html\">PutSolFunctionPackageContent</a>.</p> <p>A function package is a .zip file in CSAR (Cloud Service Archive) format that contains a network function (an ETSI standard telecommunication application) and function package descriptor that uses the TOSCA standard to describe how the network functions should run on your network.</p>",
+      "documentation":"<p>Validates function package content. This can be used as a dry run before uploading function package content with <a href=\"https://docs.aws.amazon.com/tnb/latest/APIReference/API_PutSolFunctionPackageContent.html\">PutSolFunctionPackageContent</a>.</p> <p>A function package is a .zip file in CSAR (Cloud Service Archive) format that contains a network function (an ETSI standard telecommunication application) and function package descriptor that uses the TOSCA standard to describe how the network functions should run on your network.</p>",
       "idempotent":true
     },
     "ValidateSolNetworkPackageContent":{
@@ -607,7 +607,7 @@
         {"shape":"ResourceNotFoundException"},
         {"shape":"AccessDeniedException"}
       ],
-      "documentation":"<p>Validates network package content. This can be used as a dry run before uploading network package content with <a href=\"https://docs.aws.amazon.com/TNB/latest/APIReference/API_PutSolNetworkPackageContent.html\">PutSolNetworkPackageContent</a>.</p> <p>A network package is a .zip file in CSAR (Cloud Service Archive) format defines the function packages you want to deploy and the Amazon Web Services infrastructure you want to deploy them on.</p>",
+      "documentation":"<p>Validates network package content. This can be used as a dry run before uploading network package content with <a href=\"https://docs.aws.amazon.com/tnb/latest/APIReference/API_PutSolNetworkPackageContent.html\">PutSolNetworkPackageContent</a>.</p> <p>A network package is a .zip file in CSAR (Cloud Service Archive) format defines the function packages you want to deploy and the Amazon Web Services infrastructure you want to deploy them on.</p>",
       "idempotent":true
     }
   },
@@ -636,7 +636,7 @@
       "members":{
         "nsLcmOpOccId":{
           "shape":"NsLcmOpOccId",
-          "documentation":"<p>The ID of a network operation occurrence.</p>",
+          "documentation":"<p>The identifier of the network operation.</p>",
           "location":"uri",
           "locationName":"nsLcmOpOccId"
         }
@@ -714,12 +714,12 @@
     },
     "CreateSolNetworkInstanceInputNsDescriptionString":{
       "type":"string",
-      "max":124,
-      "min":1
+      "max":255,
+      "min":0
     },
     "CreateSolNetworkInstanceInputNsNameString":{
       "type":"string",
-      "max":80,
+      "max":100,
       "min":1
     },
     "CreateSolNetworkInstanceOutput":{
@@ -1219,7 +1219,7 @@
       "members":{
         "nsLcmOpOccId":{
           "shape":"NsLcmOpOccId",
-          "documentation":"<p>The identifier of the operation occurrence.</p>",
+          "documentation":"<p>The identifier of the network operation.</p>",
           "location":"uri",
           "locationName":"nsLcmOpOccId"
         }
@@ -1241,7 +1241,7 @@
           "documentation":"<p>The date that the resource was last modified.</p>"
         }
       },
-      "documentation":"<p>Metadata related to a network operation occurence.</p> <p>A network operation is any operation that is done to your network, such as network instance instantiation or termination.</p>"
+      "documentation":"<p>Metadata related to a network operation occurrence.</p> <p>A network operation is any operation that is done to your network, such as network instance instantiation or termination.</p>"
     },
     "GetSolNetworkOperationOutput":{
       "type":"structure",
@@ -1253,7 +1253,7 @@
         },
         "error":{
           "shape":"ProblemDetails",
-          "documentation":"<p>Error related to this specific network operation occurence.</p>"
+          "documentation":"<p>Error related to this specific network operation occurrence.</p>"
         },
         "id":{
           "shape":"NsLcmOpOccId",
@@ -1541,6 +1541,10 @@
           "documentation":"<p>ID of the network instance.</p>",
           "location":"uri",
           "locationName":"nsInstanceId"
+        },
+        "tags":{
+          "shape":"TagMap",
+          "documentation":"<p>A tag is a label that you assign to an Amazon Web Services resource. Each tag consists of a key and an optional value. When you use this API, the tags are transferred to the network operation that is created. Use tags to search and filter your resources or track your Amazon Web Services costs.</p>"
         }
       }
     },
@@ -1550,7 +1554,11 @@
       "members":{
         "nsLcmOpOccId":{
           "shape":"NsLcmOpOccId",
-          "documentation":"<p>The identifier of the network instance.</p>"
+          "documentation":"<p>The identifier of the network operation.</p>"
+        },
+        "tags":{
+          "shape":"TagMap",
+          "documentation":"<p>A tag is a label that you assign to an Amazon Web Services resource. Each tag consists of a key and an optional value. When you use this API, the tags are transferred to the network operation that is created. Use tags to search and filter your resources or track your Amazon Web Services costs.</p>"
         }
       }
     },
@@ -1571,7 +1579,7 @@
       "members":{
         "nsLcmOpOccId":{
           "shape":"NsLcmOpOccId",
-          "documentation":"<p>The identifier of the latest network lifecycle management operation occurrence.</p>"
+          "documentation":"<p>The identifier of the network operation.</p>"
         }
       },
       "documentation":"<p>Lifecycle management operation details on the network instance.</p> <p>Lifecycle management operations are deploy, update, or delete operations.</p>"
@@ -2520,6 +2528,10 @@
           "documentation":"<p>ID of the network instance.</p>",
           "location":"uri",
           "locationName":"nsInstanceId"
+        },
+        "tags":{
+          "shape":"TagMap",
+          "documentation":"<p>A tag is a label that you assign to an Amazon Web Services resource. Each tag consists of a key and an optional value. When you use this API, the tags are transferred to the network operation that is created. Use tags to search and filter your resources or track your Amazon Web Services costs.</p>"
         }
       }
     },
@@ -2528,7 +2540,11 @@
       "members":{
         "nsLcmOpOccId":{
           "shape":"NsLcmOpOccId",
-          "documentation":"<p>The identifier of the operation occurrence.</p>"
+          "documentation":"<p>The identifier of the network operation.</p>"
+        },
+        "tags":{
+          "shape":"TagMap",
+          "documentation":"<p>A tag is a label that you assign to an Amazon Web Services resource. Each tag consists of a key and an optional value. When you use this API, the tags are transferred to the network operation that is created. Use tags to search and filter your resources or track your Amazon Web Services costs.</p>"
         }
       }
     },
@@ -2631,6 +2647,10 @@
           "location":"uri",
           "locationName":"nsInstanceId"
         },
+        "tags":{
+          "shape":"TagMap",
+          "documentation":"<p>A tag is a label that you assign to an Amazon Web Services resource. Each tag consists of a key and an optional value. When you use this API, the tags are transferred to the network operation that is created. Use tags to search and filter your resources or track your Amazon Web Services costs.</p>"
+        },
         "updateType":{
           "shape":"UpdateSolNetworkType",
           "documentation":"<p>The type of update.</p>"
@@ -2642,7 +2662,11 @@
       "members":{
         "nsLcmOpOccId":{
           "shape":"NsLcmOpOccId",
-          "documentation":"<p>The identifier of the network instance operation occurrence.</p>"
+          "documentation":"<p>The identifier of the network operation.</p>"
+        },
+        "tags":{
+          "shape":"TagMap",
+          "documentation":"<p>A tag is a label that you assign to an Amazon Web Services resource. Each tag consists of a key and an optional value. When you use this API, the tags are transferred to the network operation that is created. Use tags to search and filter your resources or track your Amazon Web Services costs.</p>"
         }
       }
     },