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.<br />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.<br />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.<br />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`<br />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}}\"}}"
```

------