Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Aggiorna un'istanza di rete in AWS TNB
<a name="update-network-instance"></a>

Dopo aver creato un'istanza di rete, potrebbe essere necessario aggiornare l'infrastruttura o l'applicazione. A tale scopo, si aggiornano il pacchetto di rete e i valori dei parametri per l'istanza di rete e si distribuisce l'operazione di aggiornamento per applicare le modifiche.

## Considerazioni
<a name="update-considerations"></a>
+ È possibile aggiornare un'istanza di rete che si trova nello `Updated` stato `Instantiated` or.
+ Quando si aggiorna un'istanza di rete, l'`UpdateSolNetworkService`API utilizza il nuovo pacchetto di rete e i valori dei parametri per aggiornare la topologia dell'istanza di rete.
+ AWS TNB verifica che il numero di parametri NSD e VNFD nell'istanza di rete non superi 200. Questo limite viene applicato per proteggere i malintenzionati dal trasferimento di payload errati o ingenti che influiscono sul servizio.

## Parametri che è possibile aggiornare
<a name="update-parameters"></a>

È possibile aggiornare i seguenti parametri quando si aggiorna un'istanza di rete istanziata:


| Parametro | Description | Esempio: Prima | Esempio: dopo | 
| --- | --- | --- | --- | 
|  Versione del cluster Amazon EKS  |  Puoi aggiornare il valore per il `version` parametro del piano di controllo del cluster Amazon EKS alla versione secondaria successiva. Non è possibile effettuare il downgrade della versione.  |  <pre>EKSCluster:<br />    type: tosca.nodes.AWS.Compute.EKS<br />    properties:<br />      version: "1.28"</pre> |  <pre>EKSCluster:<br />    type: tosca.nodes.AWS.Compute.EKS<br />    properties:<br />      version: "1.29"</pre> | 
|  Nodi di lavoro Amazon EKS  |  Puoi aggiornare il valore del `EKSManagedNode kubernetes_version` parametro per aggiornare il tuo gruppo di nodi a una versione più recente di Amazon EKS oppure puoi aggiornare il `ami_id` parametro per aggiornare il tuo gruppo di nodi all'ultima AMI ottimizzata per EKS. Puoi aggiornare l'ID AMI per`EKSSelfManagedNode`. La versione Amazon EKS dell'AMI deve essere uguale o inferiore a due versioni rispetto alla versione del cluster Amazon EKS. Ad esempio, se la versione del cluster Amazon EKS è 1.31, la versione dell'AMI Amazon EKS deve essere 1.31, 1.30 o 1.29.  |  <pre>EKSManagedNodeGroup01:<br />    ...<br />    properties:<br />      kubernetes_version: "1.28"<br />    EKSSelfManagedNode01:<br />      compute:<br />        compute:<br />          properties:<br />            ami_id: "ami-123123OLD"</pre> |  <pre>EKSManagedNodeGroup01:<br />    ...<br />    properties:<br />      kubernetes_version: "1.29"<br />    EKSSelfManagedNode01:<br />      compute:<br />        compute:<br />          properties:<br />            ami_id: "ami-123123NEW"</pre> | 
|  Gruppi di nodi Amazon EKS  |  Puoi aggiungere o rimuovere gruppi di nodi in base alle tue esigenze di elaborazione. Quando eliminate gruppi di nodi esistenti e ne aggiungete di nuovi, assicuratevi che i nuovi gruppi IDs di nodi siano diversi da quelli eliminati, altrimenti l'operazione verrà considerata come una modifica del gruppo di nodi anziché un'eliminazione e un'aggiunta. Nota che per i gruppi di nodi esistenti, è possibile aggiornare solo un set limitato di parametri. Scorri questa tabella per vedere quali parametri puoi aggiornare.  |  <pre>Free5GCEKSNode01:<br />  type: tosca.nodes.AWS.Compute.EKSManagedNode<br />  ...<br />    scaling:<br />      properties:<br />        desired_size: 1<br />        min_size: 1<br />        max_size: 1<br />  ...<br />Free5GCEKSNode02: # Deleted Nodegroup<br />  type: tosca.nodes.AWS.Compute.EKSManagedNode<br />  ...<br />    scaling:<br />      properties:<br />        desired_size: 1<br />        min_size: 1<br />        max_size: 1<br />  ...<br />Free5GCEKSNode03: # Deleted Nodegroup  <br />  type: tosca.nodes.AWS.Compute.EKSSelfManagedNode<br />  ...<br />    scaling:<br />      properties:<br />        desired_size: 1<br />        min_size: 1<br />        max_size: 1<br />  ...</pre> | <pre>Free5GCEKSNode01:<br />  type: tosca.nodes.AWS.Compute.EKSManagedNode<br />  ...<br />    scaling:<br />      properties:<br />        desired_size: 1<br />        min_size: 1<br />        max_size: 1<br />  ...<br />Free5GCEKSNode04: # New Nodegroup<br />  type: tosca.nodes.AWS.Compute.EKSSelfManagedNode<br />  ...<br />    scaling:<br />      properties:<br />        desired_size: 1<br />        min_size: 1<br />        max_size: 1<br />  ...<br />Free5GCEKSNode05: # New Nodegroup  <br />  type: tosca.nodes.AWS.Compute.EKSManagedNode<br />  ...<br />    scaling:<br />      properties:<br />        desired_size: 1<br />        min_size: 1<br />        max_size: 1<br />  ...</pre> | 
|  Proprietà di ridimensionamento  |  È possibile aggiornare le proprietà di scala dei nodi `EKSManagedNode` e `EKSSelfManagedNode` TOSCA.  |  <pre>EKSNodeGroup01:<br />    ...<br />    scaling:<br />        properties:<br />            desired_size: 1<br />            min_size: 1<br />            max_size: 1</pre>  |  <pre>EKSNodeGroup01:<br />    ...<br />    scaling:<br />        properties:<br />            desired_size: 2<br />            min_size: 0<br />            max_size: 2</pre>  | 
|  Proprietà del plug-in Amazon EBS CSI  |  Puoi abilitare o disabilitare il plug-in Amazon EBS CSI sui tuoi cluster Amazon EKS. Puoi anche modificare la versione del plugin.  |  <pre>EKSCluster:<br />  capabilities:<br />   ...<br />    ebs_csi:<br />      properties:<br />        enabled: false</pre>  |  <pre>EKSCluster:<br />  capabilities:<br />   ...<br />    ebs_csi:<br />      properties:<br />        enabled: true<br />        version: "v1.30.0-eksbuild.1"</pre>  | 
|  Dimensione del volume root  |  È possibile aggiungere, rimuovere o aggiornare la proprietà della dimensione del volume principale dei nodi EKSManaged Node e EKSSelf ManagedNode TOSCA.  |  <pre>Free5GCEKSNode01:<br />      ...<br />      capabilities:        <br />        compute:<br />          properties:<br />            root_volume_size: 50</pre>  |  <pre>Free5GCEKSNode01:<br />      ...<br />      capabilities:<br />        compute:<br />          properties:            <br />            root_volume_size: 100</pre>  | 
|  VNF  |  È possibile fare riferimento a essi VNFs nell'NSD e distribuirli nel cluster creato in NSD utilizzando il nodo TOSCA. VNFDeployment Come parte dell'aggiornamento, potrai aggiungere, aggiornare ed eliminare VNFs dalla rete.  |  <pre>vnfds:<br />  - descriptor_id: "43c012fa-2616-41a8-a833-0dfd4c5a049e"<br />    namespace: "vnf1"<br />  - descriptor_id: "64222f98-ecd6-4871-bf94-7354b53f3ee5"<br />    namespace: "vnf2" // Deleted VNF<br />...<br />SampleVNF1HelmDeploy:<br />      type: tosca.nodes.AWS.Deployment.VNFDeployment<br />      requirements:<br />        cluster: EKSCluster<br />        vnfs:<br />          - vnf1.SampleVNF1<br />          - vnf2.SampleVNF2</pre>  |  <pre>vnfds:<br />  - descriptor_id: "59f77222-79e9-4dc1-be53-5712ad06e31b"<br />    namespace: "vnf1" // Updated VNF<br />  - descriptor_id: "b7e072dc-839d-4fac-916c-561a166da1fc"<br />    namespace: "vnf3" // Added VNFn<br />....<br />SampleVNF1HelmDeploy:<br />      type: tosca.nodes.AWS.Deployment.VNFDeployment<br />      requirements:<br />        cluster: EKSCluster<br />        vnfs:<br />          - vnf1.SampleVNF1<br />          - vnf3.SampleVNF3</pre>  | 
|  Hook  |  Per eseguire le operazioni del ciclo di vita prima e dopo la creazione di una funzione di rete, aggiungi gli `post_create` hook `pre_create` and al `VNFDeployment` nodo. In questo esempio, l'`PreCreateHook`hook verrà eseguito prima dell'`vnf3.SampleVNF3`istanziazione e l'`PostCreateHook`hook verrà eseguito dopo `vnf3.SampleVNF3` l'istanza.  |  <pre>vnfds:<br />  - descriptor_id: "43c012fa-2616-41a8-a833-0dfd4c5a049e"<br />    namespace: "vnf1"<br />  - descriptor_id: "64222f98-ecd6-4871-bf94-7354b53f3ee5"<br />    namespace: "vnf2"<br />...<br />SampleVNF1HelmDeploy:<br />  type: tosca.nodes.AWS.Deployment.VNFDeployment<br />  requirements:<br />    cluster: EKSCluster<br />    vnfs:<br />      - vnf1.SampleVNF1<br />      - vnf2.SampleVNF2 // Removed during update</pre>  |  <pre>vnfds:<br />  - descriptor_id: "43c012fa-2616-41a8-a833-0dfd4c5a049e"<br />    namespace: "vnf1"<br />  - descriptor_id: "b7e072dc-839d-4fac-916c-561a166da1fc"<br />    namespace: "vnf3"<br />....<br /><br />SampleVNF1HelmDeploy:<br />  type: tosca.nodes.AWS.Deployment.VNFDeployment<br />  requirements:<br />    cluster: EKSCluster<br />    vnfs:<br />      - vnf1.SampleVNF1 // No change to this function, as the namespace and uuid remain the same<br />      - vnf3.SampleVNF3 // New VNF as the namespace, vnf3, was not previously present<br />  interfaces:<br />    Hook:<br />      post_create: PostCreateHook<br />      pre_create: PreCreateHook</pre>  | 
|  Hook  |  Per eseguire le operazioni del ciclo di vita prima e dopo l'aggiornamento di una funzione di rete, è possibile aggiungere l'`pre_update`hook e l'`post_update`hook al nodo. `VNFDeployment` In questo esempio, `PreUpdateHook` verrà eseguito prima dell'`vnf1.SampleVNF1`aggiornamento e `PostUpdateHook` verrà eseguito dopo l'`vnf1.SampleVNF1`aggiornamento al `vnf` pacchetto indicato dall'aggiornamento `uuid` per il namespace vnf1.  |  <pre>vnfds:<br />  - descriptor_id: "43c012fa-2616-41a8-a833-0dfd4c5a049e"<br />    namespace: "vnf1"<br />  - descriptor_id: "64222f98-ecd6-4871-bf94-7354b53f3ee5"<br />    namespace: "vnf2"<br />...<br /><br />SampleVNF1HelmDeploy:<br />  type: tosca.nodes.AWS.Deployment.VNFDeployment<br />  requirements:<br />    cluster: EKSCluster<br />    vnfs:<br />      - vnf1.SampleVNF1<br />      - vnf2.SampleVNF2 <br /></pre>  |  <pre>vnfds:<br />  - descriptor_id: "0ebe4e95-bd87-44bd-b8a1-918466606a14"<br />    namespace: "vnf1"<br />  - descriptor_id: "64222f98-ecd6-4871-bf94-7354b53f3ee5"<br />    namespace: "vnf2"<br /><br />...<br /><br />SampleVNF1HelmDeploy:<br />  type: tosca.nodes.AWS.Deployment.VNFDeployment<br />  requirements:<br />    cluster: EKSCluster<br />    vnfs:<br />      - vnf1.SampleVNF1 // A VNF update as the uuid changed for namespace "vnf1"<br />      - vnf2.SampleVNF2 // No change to this function as namespace and uuid remain the same<br />  interfaces:<br />    Hook:<br />      pre_update: PreUpdateHook<br />      post_update: PostUpdateHook</pre>  | 
|  Sottoreti  |  È possibile aggiungere ed eliminare sottoreti dalla rete. Prima di eliminare una sottorete, verificate che la sottorete non venga utilizzata da alcuna risorsa della rete.  |  <pre>Free5GCSubnet01: #Deleted Subnet<br />  type: tosca.nodes.AWS.Networking.Subnet<br />  properties:<br />    type: "PUBLIC"<br />    availability_zone: { get_input: subnet_01_az }<br />    cidr_block: { get_input: subnet_01_cidr_block }<br />  requirements:<br />    route_table: Free5GCRouteTable<br />    vpc: Free5GCVPC</pre>  |  <pre>Free5GCSubnet02: #New Subnet<br />  type: tosca.nodes.AWS.Networking.Subnet<br />  properties:<br />    type: "PUBLIC"<br />    availability_zone: { get_input: subnet_02_az }<br />    cidr_block: { get_input: subnet_02_cidr_block }<br />  requirements:<br />    route_table: Free5GCRouteTable<br />    vpc: Free5GCVPC</pre>  | 
|  Gruppi di sicurezza  |  È possibile aggiungere ed eliminare gruppi di sicurezza dalla rete. Prima di eliminare un gruppo di sicurezza, verifica che il gruppo di sicurezza non venga utilizzato da alcuna risorsa della rete.  |  <pre>Free5GCSecurityGroup01: #Deleted Security Group<br />  type: tosca.nodes.AWS.Networking.SecurityGroup<br />  properties:<br />    description: "SecurityGroup for Free5GC cluster"<br />    name: "Free5GCSecurityGroup01"<br />    tags:<br />      - "Name=Free5GCEKSAdditionalSecurityGroup"<br />  requirements:<br />    vpc: Free5GCVPC<br /><br />Free5GCSecurityGroupEgressRule01: #Deleted Security Group Egress Node<br />  type: tosca.nodes.AWS.Networking.SecurityGroupEgressRule<br />  properties:<br />    ip_protocol: "tcp"<br />    from_port: 8000<br />    to_port: 9000<br />    description: "Egress Rule for free5GC cluster"<br />    cidr_ip : "172.10.10.1/24"<br />  requirements:<br />    security_group: Free5GCSecurityGroup01<br /><br />Free5GCSecurityGroupIngressRule01: #Deleted Security Group Ingress Node<br />  type: tosca.nodes.AWS.Networking.SecurityGroupIngressRule<br />  properties:<br />    ip_protocol: "tcp"<br />    from_port: 8000<br />    to_port: 9000<br />    description: "Ingress Rule for free5GC cluster"<br />    cidr_ip: "172.10.10.1/24"<br />  requirements:<br />    security_group: Free5GCSecurityGroup01</pre>  |  <pre>Free5GCSecurityGroup02: #New Security Group<br />  type: tosca.nodes.AWS.Networking.SecurityGroup<br />  properties:<br />    description: "SecurityGroup for Free5GC cluster"<br />    name: "Free5GCSecurityGroup02"<br />    tags:<br />      - "Name=Free5GCEKSAdditionalSecurityGroup"<br />  requirements:<br />    vpc: Free5GCVPC<br />   <br />Free5GCSecurityGroupEgressRule02: #New Security Group Egress Node<br />  type: tosca.nodes.AWS.Networking.SecurityGroupEgressRule<br />  properties:<br />    ip_protocol: "tcp"<br />    from_port: 8000<br />    to_port: 9000<br />    description: "Egress Rule for free5GC cluster"<br />    cidr_ip: "172.10.10.1/24"<br />  requirements:<br />    security_group: Free5GCSecurityGroup02<br />   <br />Free5GCSecurityGroupIngressRule02: #New Security Group Ingress Node<br />  type: tosca.nodes.AWS.Networking.SecurityGroupIngressRule<br />  properties:<br />    ip_protocol: "tcp"<br />    from_port: 8000<br />    to_port: 9000<br />    description: "Ingress Rule for free5GC cluster"<br />    cidr_ip: "172.10.10.1/24"<br />  requirements:<br />    security_group: Free5GCSecurityGroup02</pre>  | 
|  Interfacce di rete  |  È possibile aggiungere, modificare ed eliminare ENIs dalla rete.  |  <pre>Free5GCENI01: #Modified ENI<br />  type: tosca.nodes.AWS.Networking.ENI<br />  properties:<br />    device_index: 2<br />  requirements:<br />    subnet: Free5GCENISubnet01<br />    security_groups:<br />      - Free5GCSecurityGroup01<br /><br />Free5GCENI02: #Modified ENI<br />  type: tosca.nodes.AWS.Networking.ENI<br />  properties:<br />    device_index: 3<br />    source_dest_check: true<br />  requirements:<br />    subnet: Free5GCENISubnet01<br /><br />Free5GCENI04: #Deleted ENI<br />  type: tosca.nodes.AWS.Networking.ENI<br />  properties:<br />    device_index: 4<br />    source_dest_check: true<br />  requirements:<br />    subnet: Free5GCENISubnet01<br /></pre>  |  <pre>Free5GCENI01: #Modified ENI<br />  type: tosca.nodes.AWS.Networking.ENI<br />  properties:<br />    device_index: 2<br />  requirements:<br />    subnet: Free5GCENISubnet02<br />    security_groups:<br />      - Free5GCSecurityGroup01<br /><br />Free5GCENI02: #Modified ENI<br />  type: tosca.nodes.AWS.Networking.ENI<br />  properties:<br />    device_index: 3<br />    source_dest_check: true<br />  requirements:<br />    subnet: Free5GCENISubnet01<br />    security_groups:<br />      - Free5GCSecurityGroup01<br /><br />Free5GCENI03: #New ENI<br />  type: tosca.nodes.AWS.Networking.ENI<br />  properties:<br />    device_index: 3<br />  requirements:<br />    subnet: Free5GCSubnet01<br />    security_groups:<br />      - Free5GCSecurityGroup01</pre>  | 

## Aggiornamento di un'istanza di rete
<a name="update-network-instance-steps"></a>

------
#### [ Console ]

**Per aggiornare un'istanza di rete utilizzando la console**

1. Apri la console AWS TNB all'indirizzo [https://console.aws.amazon.com/tnb/](https://console.aws.amazon.com/tnb/).

1. Nel riquadro di navigazione, scegli **Reti**.

1. Seleziona l'istanza di rete. È possibile aggiornare un'istanza di rete solo se il relativo stato è `Instantiated` o`Updated`.

1. Scegli **Azioni** e **aggiorna**.

   Viene visualizzata la pagina **Aggiorna istanza** con i dettagli della rete e un elenco di parametri nell'infrastruttura corrente.

1. Scegli un nuovo pacchetto di rete.

   I parametri del nuovo pacchetto di rete vengono visualizzati nella sezione **Parametri aggiornati**.

1. Facoltativamente, aggiorna i valori dei parametri nella sezione **Parametri aggiornati**. Per l'elenco dei valori dei parametri che è possibile aggiornare, vedere[Parametri che è possibile aggiornare](#update-parameters).

1. Scegli **Aggiorna rete**.

   AWS TNB convalida la richiesta e avvia la distribuzione. Viene visualizzata la pagina **di stato della distribuzione**.

1. Utilizza l'icona **Aggiorna** per tenere traccia dello stato di distribuzione dell'istanza di rete. È inoltre possibile abilitare l'**aggiornamento automatico** nella sezione **Attività di distribuzione** per tenere traccia dell'avanzamento di ciascuna attività.

   Quando lo stato di distribuzione cambia in`Completed`, l'istanza di rete viene aggiornata.

1. 
   + Se la convalida fallisce, l'istanza di rete rimane nello stesso stato in cui si trovava prima della richiesta dell'aggiornamento, `Instantiated` oppure`Updated`.
   + Se l'aggiornamento fallisce, viene visualizzato `Update failed` lo stato dell'istanza di rete. Scegli il link per ogni operazione non riuscita per determinarne il motivo.
   + Se l'aggiornamento ha esito positivo, viene visualizzato `Updated` lo stato dell'istanza di rete.

------
#### [ AWS CLI ]

**Usa la CLI per aggiornare un'istanza di rete**  
Usa il [update-sol-network-instance](https://docs.aws.amazon.com/cli/latest/reference/tnb/update-sol-network-instance.html)comando con il tipo di `UPDATE_NS` aggiornamento per aggiornare un'istanza di rete.

```
aws tnb update-sol-network-instance --ns-instance-id ^ni-[a-f0-9]{17}$ --update-type UPDATE_NS --update-ns "{\"nsdInfoId\":\"^np-[a-f0-9]{17}$\", \"additionalParamsForNs\": {\"param1\": \"value1\"}}"
```

------