

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à.

# Esempi di configurazione di un costrutto di staging
<a name="model-registry-staging-construct-set-up"></a>

Per configurare i costrutti di fase per il tuo Amazon SageMaker Model Registry, l'amministratore dovrà concedere le autorizzazioni pertinenti ai ruoli previsti. Di seguito vengono forniti esempi su come configurare i costrutti di staging per vari ruoli.

**Nota**  
Gli utenti all'interno di un dominio Amazon SageMaker AI saranno in grado di visualizzare tutte le fasi definite all'interno del dominio, ma potranno utilizzare solo quelle per cui dispongono delle autorizzazioni.

Le fasi sono definite dal parametro `ModelLifeCycle` e hanno la seguente struttura. L’amministratore configura le autorizzazioni per i valori `stage` e `stageStatus` accessibili dai ruoli specificati. Gli utenti che assumono un ruolo possono utilizzare i valori `stage` e `stageStatus` appropriati e includere il proprio `stageDescription`.

```
ModelLifeCycle {
    stage: String # Required (e.g., Development/QA/Production)
    stageStatus: String # Required (e.g., PendingApproval/Approved/Rejected)  
    stageDescription: String # Optional
}
```

La tabella seguente contiene i modelli del costrutto di staging predefinito del registro dei modelli. Puoi definire i costrutti di staging in base ai tuoi casi d’uso. Per poterli utilizzare, è necessario configurare prima le autorizzazioni pertinenti.


| Stage | Stato della fase | 
| --- | --- | 
|  Proposta  |  PendingApproval  | 
|  Sviluppo  |  InProgress  | 
|  QA  |  OnHold  | 
|  PreProduction  |  Approvato  | 
|  Produzione  |  Rifiutato  | 
|  Archiviato  |  Ritirata  | 

Il `ModelLifeCycle` parametro può essere richiamato nei modi seguenti: APIs
+ [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateModelPackage.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateModelPackage.html)
+ [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateModelPackage.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateModelPackage.html)
+ [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeModelPackage.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeModelPackage.html)

------
#### [ Policy for a data scientist role ]

Di seguito è riportato un esempio di policy IAM che utilizza le chiavi di condizione del ciclo di vita del modello. Puoi modificarle in base alle tue esigenze. In questo esempio, le autorizzazioni del ruolo sono limitate all’impostazione o alla definizione della fase del ciclo di vita del modello per:
+ Creare o aggiornare un modello con la fase `"Development"` e lo stato `"Approved"`.
+ Aggiornare un pacchetto di modelli con la fase del controllo di qualità `"QA"` e lo stato `"PendingApproval"`.

```
{
    "Action" : [
        "sagemaker:UpdateModelPackage",
        "sagemaker:CreateModelPackage"
    ],
    "Resource": [
        "*"
    ],
    "Condition": {
        "StringEquals": {
            "sagemaker:ModelLifeCycle:stage" : "Development"
            "sagemaker:ModelLifeCycle:stageStatus" : "Approved"       
        }
    }
},
{
    "Action" : [
        "sagemaker:UpdateModelPackage"
    ],
    "Resource": [
        "*"
    ],
    "Condition": {
        "StringEquals": {
            "sagemaker:ModelLifeCycle:stage" : "Staging"
            "sagemaker:ModelLifeCycle:stageStatus" : "PendingApproval"       
        }
    }
}
```

------
#### [ Policy for a quality assurance specialist ]

Di seguito è riportato un esempio di policy IAM che utilizza le chiavi di condizione del ciclo di vita del modello. Puoi modificarle in base alle tue esigenze. In questo esempio, le autorizzazioni del ruolo sono limitate all’impostazione o alla definizione della fase del ciclo di vita del modello per:
+ Aggiorna un pacchetto di modelli con:
  + La fase `"QA"` e lo stato `"Approved"` o `"Rejected"`.
  + La fase `"Production"` e lo stato `"PendingApproval"`.

```
{
    "Action": [
        "sagemaker:UpdateModelPackage"
    ],
    "Resource": [
        "*"
    ],
    "Condition": {
        "StringEquals": {
            "sagemaker:ModelLifeCycle:stage": "Staging",
            "sagemaker:ModelLifeCycle:stageStatus": "Approved"
        }
    }
}, {
    "Action": [
        "sagemaker:UpdateModelPackage"
    ],
    "Resource": [
        "*"
    ],
    "Condition": {
        "StringEquals": {
            "sagemaker:ModelLifeCycle:stage": "Staging",
            "sagemaker:ModelLifeCycle:stageStatus": "Rejected"
        }
    }
}, {
    "Action": [
        "sagemaker:UpdateModelPackage"
    ],
    "Resource": [
        "*"
    ],
    "Condition": {
        "StringEquals": {
            "sagemaker:ModelLifeCycle:stage": "Production",
            "sagemaker:ModelLifeCycle:stageStatus": "PendingApproval"
        }
    }
}
```

------
#### [ Policy for lead engineer role ]

Di seguito è riportato un esempio di policy IAM che utilizza le chiavi di condizione del ciclo di vita del modello. Puoi modificarle in base alle tue esigenze. In questo esempio, le autorizzazioni del ruolo sono limitate all’impostazione o alla definizione della fase del ciclo di vita del modello per:
+ Aggiorna un pacchetto di modelli con:
  + La fase `"Production"` e lo stato `"Approved"` o `"Rejected"`.
  + La fase `"Development"` e lo stato `"PendingApproval"`.

```
{
    "Action" : [
        "sagemaker:UpdateModelPackage"
    ],
    "Resource": [
        "*"
    ],
    "Condition": {
        "ForAnyvalue:StringEquals" : {
            "sagemaker:ModelLifeCycle:stage" : "Production",
            "sagemaker:ModelLifeCycle:stageStatus" : "Approved"
        }
    }
},
{
    "Action" : [
        "sagemaker:UpdateModelPackage"
    ],
    "Resource": [
        "*"
    ],
    "Condition": {
        "StringEquals:" {
            "sagemaker:ModelLifeCycle:stage" : "Production"
            "sagemaker:ModelLifeCycle:stageStatus" : "Rejected"
        }
    }
},
{
    "Action" : [
        "sagemaker:UpdateModelPackage"
    ],
    "Resource": [
        "*"
    ],
    "Condition": {
        "StringEquals": {
            "sagemaker:ModelLifeCycle:stage" : "Development"
            "sagemaker:ModelLifeCycle:stageStatus" : "PendingApproval"
        }
    }
}
```

------

Per ricevere EventBridge notifiche Amazon su qualsiasi aggiornamento dello stato del modello, consulta l'esempio in[Ricevi notifiche sugli eventi per ModelLifeCycle](model-registry-staging-construct-event-bridge.md). Per un esempio di EventBridge payload che potresti ricevere, consulta[SageMaker modifica dello stato del pacchetto del modello](automating-sagemaker-with-eventbridge.md#eventbridge-model-package).