Elenka u mmodifika ċ-ċwievet tiegħek
F'din il-paġna
Inventarju taċ-ċwievet API tiegħek
Maż-żmien, it-tim tiegħek jakkumula ċwievet API għal ambjenti, proġetti u membri tat-tim differenti. L-API tal-Ġestjoni (Management API) tippermettilek telenka ċ-ċwievet attivi kollha, tiffiltrahom skont il-permessi, u timmodifika l-konfigurazzjonijiet tagħhom mingħajr ma terġa’ toħloqhom.
Elenka ċ-ċwievet
Dan l-endpoint huwa l-punt tat-tluq għal kwalunkwe awditu tal-aċċess, u spiss huwa fejn tiskopri l-inventarju reali: ċwievet maħluqa għal test tmien xhur ilu, ċavetta f’isem membru tat-tim li telaq, żewġ ċwievet tal-produzzjoni li ħadd ma jaf liema qed tintuża. Iċċekkja l-lista qabel ma toħloq xi ħaġa ġdida—iċ-ċavetta li għandek bżonn tista’ diġà teżisti.
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Parametri tat-talba
- pageSize: numru ta’ ċwievet għal kull paġna (b’mod default, jiġu rritornati ċ-ċwievet kollha)
- paginationToken: token biex tirrikupra l-paġna li jmiss jekk in-numru ta’ ċwievet jaqbeż id-daqs tal-paġna
- aclFilters: iffiltra ċ-ċwievet skont permessi speċifiċi
Iffiltra skont l-ACL
Tista’ tirrikupra biss ċ-ċwievet b’livell ta’ aċċess partikolari:
# Elenka biss iċ-ċwievet b'aċċess għaċ-chat
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?aclFilters=api-key:endpoint:chat" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Dan il-filtru huwa dak li jagħmel awditu ġestibbli anke meta jkollok aktar minn għaxar ċwievet. Fil-prattika, jitqajmu żewġ mistoqsijiet li jiġu mwieġba b’talba waħda: min jista’ jsejjaħ l-aktar mudell għali, u liema ċwievet għadhom iġorru wildcard. It-tieni waħda hija l-aktar utli—wildcard minsija fil-produzzjoni hija l-iżball ta’ konfigurazzjoni l-aktar komuni, u l-aktar wieħed silenzjuż.
Paġinazzjoni
Għal timijiet b’ħafna ċwievet, uża l-paġinazzjoni:
# L-ewwel paġna ta' 10 ċwievet
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?pageSize=10" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
# Il-paġna li jmiss bit-token irċevut
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/api-keys?pageSize=10&paginationToken=TOKEN_RECU" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Immodifika ċavetta eżistenti
Il-modifika minflok il-ħolqien mill-ġdid mhix sempliċiment konvenjenza: iċ-ċavetta sigrieta tibqa’ l-istess, allura m’hemmx bżonn ta’ deploy. Dan jippermettilek taġġusta l-limiti jew tirrestrinġi l-permessi mingħajr interruzzjoni tas-servizz—u, f’każ ta’ suspett, tnaqqas id-drittijiet ta’ ċavetta f’sekondi waqt li tħejji r-rotazzjoni tagħha.
curl -X PUT "https://management-api.x.ai/auth/api-keys/$API_KEY_ID" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "prod-backend-v3",
"acls": [
"api-key:endpoint:chat",
"api-key:endpoint:embed",
"api-key:model:grok-4.20-0309-reasoning"
],
"qps": 30,
"qpm": 1000,
"tpm": 3000000
}'
X’tista’ timmodifika
- name: ibdel isem iċ-ċavetta biex tirrifletti bidla fl-użu
- acls: żid jew neħħi permessi (endpoints, mudelli)
- qps / qpm / tpm: aġġusta l-limiti tar-rata (rate limits)
- expireTime: estendi jew qassar il-perjodu ta’ validità
X’ma tistax timmodifika
- L-identifikatur taċ-ċavetta (
api_key_id) jibqa’ fiss - Iċ-ċavetta sigrieta ma tinbidilx waqt il-modifika (uża r-rotazzjoni għal dan)
- It-tim sid ma jistax jiġi ttrasferit
Iċċekkja l-propagazzjoni
Hawnhekk tidħol id-dettall li jispjega nofs il-”bugs” irrappurtati wara modifika ta’ ċavetta: il-bidla mhix istantanja fuq is-servers kollha. Ċavetta maħluqa reċentement tista’ tirritorna 401 għal ftit mumenti, ACL espans tista’ ma tkunx attiva għada—u inti tfittex l-iżball fil-kodiċi tiegħek stess meta kollok biss bżonn tistenna. L-endpoint tal-propagazzjoni jeżisti preċiżament biex ineħħi dan id-dubju:
curl "https://management-api.x.ai/auth/api-keys/$API_KEY_ID/propagation" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Dan l-endpoint jirritorna l-istatus tal-propagazzjoni taċ-ċavetta. Stenna sakemm titlesta l-propagazzjoni qabel ma tuża ċ-ċavetta fil-produzzjoni, speċjalment wara li timmodifika l-ACLs.
Xenarji komuni
Aġġorna ċavetta ta’ dev għal prod
Il-passaġġ lejn il-produzzjoni huwa l-aktar xenarju komuni ta’ modifika, u r-rifless li toħloq ċavetta ġdida f’din l-okkażjoni huwa għali: trid tiddeployjah kullimkien, taġġorna l-vaults, u dik antika tibqa’ hemm għal żmien indefinit. Li tgħolli l-limiti fuq iċ-ċavetta eżistenti jevita dan kollu.
curl -X PUT "https://management-api.x.ai/auth/api-keys/$API_KEY_ID" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "prod-chatbot",
"qps": 50,
"qpm": 2000,
"tpm": 5000000
}'
Irrestrinġi ċavetta ssuspettata li ġiet kompromessa
F’każ ta’ suspett, l-ordni tal-operazzjonijiet hija importanti. Irrestrinġi l-ewwel—ACLs vojta, limiti ta’ rata żero—iwaqqaf it-telf f’talba waħda, mingħajr ma tkisser xi ħaġa b’mod irreversibbli. Ir-rotazzjoni tiġi wara, offline, ladarba tkun identifikajt fejn intużat iċ-ċavetta. Ir-reverse iħallik bil-produzzjoni waqfa u investigazzjoni li trid twettaq taħt pressjoni.
curl -X PUT "https://management-api.x.ai/auth/api-keys/$API_KEY_ID" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"acls": [],
"qps": 0,
"qpm": 0
}'
Punti Ewlenin
GET /auth/teams/{teamId}/api-keysjelenka ċ-ċwievet kollha bil-paġinazzjoni u l-filtru ACLPUT /auth/api-keys/{apiKeyId}jimmodifika l-parametri mingħajr ma jbiddel iċ-ċavetta sigrietaGET /auth/api-keys/{apiKeyId}/propagationjivverifika li l-bidliet huma effettivi- Uża l-filtru ACL biex tagħmel awditu regolari tal-aċċess tat-tim tiegħek
- Wara kwalunkwe modifika, iċċekkja l-propagazzjoni qabel ma tuża ċ-ċavetta fil-produzzjoni