Gestione delle credenziali delle attività

Ultimo aggiornamento: 09 lug 2025

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 Cloud Pak for Data as a Service, le chiavi API IBM Cloud sono 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 il prodotto 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 dei servizi hanno la responsabilità di definire una strategia per revocare le credenziali delle attività quando non sono più necessarie.

Accesso alle credenziali dell'attività

Per accedere alle credenziali dell'attività:

Una volta effettuato l'accesso a qualsiasi esperienza, fare clic sul proprio avatar, quindi su Profilo e impostazioni.
Fare clic sulla scheda Chiave API utente. Se si dispone di una chiave, questa viene visualizzata. Se non si dispone di una chiave, è possibile crearne una.

Creazione di credenziali di attività dall'interfaccia utente

Per creare nuove credenziali per le attività:

Dalla scheda Chiave API utente del proprio profilo, fare clic su Crea una chiave :

Crea chiave API

La nuova chiave API apparirà nell'elenco delle chiavi.

Creazione di credenziali di attività a livello di programmazione

È possibile creare credenziali per le attività con chiamate API REST.

Scenario 1: Creazione di credenziali di attività per un ID di servizio esistente

Se si utilizza serviceIDs,, non è possibile utilizzare il Percorso UI per creare le credenziali dell'attività. È necessario eseguire una richiesta cURL per creare una credenziale dell'attività per il sito serviceID specificato. Questa credenziale verrà utilizzata per creare distribuzioni, lavori di distribuzione e altre operazioni correlate.

Creare un token per la chiave API dell'ID del servizio:

API_KEY="your service ID API key"
TOKEN=$(curl -X POST "https://iam.cloud.ibm.com/identity/token?grant_type=urn:ibm:params:oauth:grant-type:apikey&apikey=$API_KEY" | jq -r .access_token)

Creare una credenziale dell'attività:

curl -X POST "https://<your cloud URL>/v1/task_credentials" \
  -H "accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "SERVICE_ID_TASK_CREDENTIALS",
    "type": "iam_api_key",
    "secret": {
      "api_key": "<your service ID API key>"
    }
  }'

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)

Se non si ha accesso all'interfaccia utente, è possibile creare le credenziali dei task in modo programmatico.

Se non si dispone di una chiave API, è necessario crearne una. Vedere Creazione delle credenziali dell'attività.
Creare un token per la chiave API:

API_KEY="your API key"
TOKEN=$(curl -X POST "https://iam.cloud.ibm.com/identity/token?grant_type=urn:ibm:params:oauth:grant-type:apikey&apikey=$API_KEY" | jq -r .access_token)

Creare una credenziale dell'attività:

curl -X POST "https://<your cloud URL>/v1/task_credentials" \
  -H "accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "USER_TASK_CREDENTIALS",
    "type": "iam_api_key",
    "secret": {
      "api_key": "<your API key>"
    }
  }'

Ripetere l'operazione per ogni altro centro dati a cui si deve accedere.

Per i dettagli, fare riferimento agli URL delle località geografiche disponibili.