Gestione delle credenziali delle attività
Le credenziali dell'attività sono una chiave API generata dall'utente, archiviata in modo sicuro nel Vault, che facilita l'autenticazione per le richieste ai servizi IBM Cloud. Le credenziali delle attività sono utilizzate per eseguire determinate attività in un servizio o per consentire l'esecuzione di operazioni lunghe, come i lavori pianificati, senza interruzioni.
In IBM watsonx, le chiavi API di IBM Cloud vengono utilizzate come credenziali dell'attività. Puoi fornire una chiave API IBM Cloud esistente oppure puoi generare una nuova chiave. È possibile memorizzare una sola credenziale di attività per utente, per account IBM Cloud.
Le credenziali per le attività rendono disponibili le chiavi API per i carichi di lavoro asincroni e di lunga durata che vengono attivati da azioni eseguite dall'utente nell'interfaccia del prodotto. Non si utilizzano le credenziali dell'attività quando si interagisce con IBM watsonx in modo programmatico.
Se il servizio richiede una credenziale per eseguire un'operazione, viene richiesto di fornirla sotto forma di chiave API (esistente o generata ex novo).
Qualsiasi utente con un account IBM Cloud può creare una chiave API. Gli amministratori del servizio sono responsabili della definizione di una strategia per la revoca delle credenziali delle attività quando queste non sono più necessarie.
Accesso alle credenziali dell'attività
Per accedere alle credenziali dell'attività, procedere come segue:
Effettuare il login a watsonx (
https://dataplatform.cloud.ibm.com/wx/
Scegliere Profilo e impostazioni: "
Scegliere la scheda Chiave API utente:
Creazione di credenziali di attività dall'interfaccia utente
Per creare nuove credenziali per le attività:
Dalla scheda Chiave API utente, fare clic su Crea chiave. La nuova chiave API apparirà nell'elenco delle chiavi: 
Creazione di credenziali di attività a livello di programmazione
Scenario 1: Creazione di credenziali di attività per un ID di servizio esistente
Se si utilizza serviceIDs, non è possibile utilizzare UI Path per creare credenziali di attività. È necessario eseguire la seguente richiesta cURL per creare una credenziale di attività per l' serviceID
curl -X POST "https://<your cloud URL>/v1/task_credentials?owner.user_id=<your IBM user ID>&owner.account_id=<your IBM account ID>" \
-H "accept: application/json" \
-H "Authorization: Bearer <your service id api key token>" \
-H "Content-Type: application/json" \
-d '{
"name": "SERVICE_ID_TASK_CREDENTIALS",
"description": "string",
"type": "iam_api_key",
"secret": {
"api_key": "<your service id apikey>"
}
}'
Ripetere l'operazione per tutte le località geografiche. Per i dettagli, fare riferimento agli URL delle località geografiche disponibili.
Dopo aver creato le credenziali dell'attività, attendere 15-20 minuti prima di riattivare i lavori o le distribuzioni non riusciti (misura precauzionale) in modo che i dati vengano sincronizzati per le credenziali dell'attività appena create.
Scenario 2: Creazione di credenziali di attività per utenti regolari (utilizzando API)
Esegui la seguente richiesta di credenziali ( cURL ) per creare un'attività:
curl -X POST "https://<your cloud URL>/v1/task_credentials?owner.user_id=<your IBM user ID>&owner.account_id=<your IBM account ID>" \
-H "accept: application/json" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "USER_TASK_CREDENTIALS",
"description": "string",
"type": "iam_api_key",
"secret": {
"api_key": "<your api key>"
}
}'
Ripetere l'operazione per ogni altra posizione. Per i dettagli, fare riferimento agli URL delle località geografiche disponibili.
URL delle località geografiche disponibili
Gestione delle credenziali delle attività esistenti
Per rigenerare la chiave, dalla scheda Chiave API utente, fare clic su Ruota chiave. La nuova chiave API apparirà nell'elenco delle chiavi.
Per eliminare la chiave, dalla scheda Chiave API utente, fare clic sull'icona Elimina. 
Ulteriori informazioni
Argomento principale: Amministrazione di progetti