Vai alla navigazione

Aggiorna chiave API

Aggiorna una chiave API esistente per un account di servizio

Parametri di percorso

service_account_user_idstringObbligatorio
api_key_idstringObbligatorio

Header

xi-api-keystringOpzionale

Richiesta

This endpoint expects an object.
is_enabledboolean or "no_update"OpzionalePredefinito a no_update
Indica se abilitare o disabilitare la chiave API.
namestring or nullOpzionale

Il nome della chiave API XI da usare (solo a scopo identificativo).

permissionslist of enums or enumOpzionalePredefinito a no_update
Le autorizzazioni dell'API XI.
character_limitinteger or enum or nullOpzionalePredefinito a no_update

Il limite di caratteri della chiave API XI. Se specificato, limiterà l’uso di questa chiave API a n caratteri al mese, dove n è il valore scelto. Le richieste che comportano addebiti non andranno a buon fine dopo il raggiungimento di questo limite mensile.

allowed_ipslist of strings or enumOpzionalePredefinito a no_update

Elenco degli indirizzi IP o degli intervalli CIDR autorizzati a usare questa chiave API. Ogni voce può essere un intervallo CIDR (ad esempio ‘10.0.0.0/24’) o un indirizzo IP senza prefisso, normalizzato a /32 o /128. Alla creazione, ometti il valore o passa null per consentire tutti gli IP. All’aggiornamento, omettilo per non modificare la allowlist oppure passa “clear” per rimuoverla.

third_party_disable_allowedboolean or enumOpzionalePredefinito a no_update

Se il titolare di questa chiave può disabilitarla tramite l’endpoint self-disable. Durante la creazione, ometti o passa null per usare il valore predefinito del workspace (abilitato per i piani non Enterprise, disabilitato per i piani Enterprise). Durante l’aggiornamento, ometti per lasciarlo invariato oppure passa “clear” per ripristinare il valore predefinito del workspace. Rispettato solo per i workspace con accesso self-disable abilitato.

tts_concurrency_limitinteger or enum or nullOpzionalePredefinito a no_update

Numero massimo di richieste simultanee text-to-speech/speech-to-speech per questa chiave API. Disponibile solo per i clienti enterprise.

dubbing_concurrency_limitinteger or enum or nullOpzionalePredefinito a no_update
Numero massimo di richieste di doppiaggio simultanee per questa chiave API. Disponibile solo per i clienti enterprise.
music_concurrency_limitinteger or enum or nullOpzionalePredefinito a no_update
Numero massimo di richieste simultanee di generazione musicale per questa chiave API. Disponibile solo per i clienti enterprise.
expires_at_unixinteger or enumOpzionalePredefinito a no_update

Timestamp Unix, in secondi, dopo il quale questa chiave API smette di funzionare. Se impostato, deve essere compreso tra almeno 15 minuti e al massimo 90 giorni nel futuro. In fase di creazione, omettilo o passa null per una chiave senza scadenza. In fase di aggiornamento, omettilo per non apportare modifiche oppure passa “clear” per rimuovere la scadenza, rendendo la chiave senza scadenza. Un workspace può non consentire chiavi senza scadenza oppure consentirle solo per le chiavi API degli account di servizio; in tal caso, la creazione di una chiave o la rimozione di una scadenza non riesce.

Risposta

Risposta riuscita

Errori

422
Unprocessable Entity Error