Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Bainistigh do chuid comhad: liostaigh, faigh, scrios

Ceacht 3 as 16 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Cad a tharlaíonn tar éis an céadú uaslódáil
  2. Déan fardal
  3. Fíoraigh comhad sonrach
  4. Scrios, agus cad le seiceáil roimhe
  5. Coinnigh do stóráil glan
  6. Príomhphointí

Cad a tharlaíonn tar éis an céadú uaslódáil

Tógann uaslódáil comhaid trí shoicind; tógann sé i bhfad níos faide an ceann a sheol tú sé seachtaine ó shin a aimsiú mura ndearna tú pleanáil roimh ré. Tar éis na chéad tástálacha, carnann cuntas doiciméid de dhusáin agus ansin de chéadta. Tá roinnt acu as dáta, tá cinn eile dúbailte, agus tá cinn eile fós in úsáid ag feidhmchláir atá ag rith. Nochtann an API Comhad trí oibríocht chun an fardal seo a bhainistiú: liostú, aisghabháil, agus scriosadh. Dealraíonn siad tánaisteach agus an toirt íseal, ach éiríonn siad dodhéanta ina dhiaidh sin.

Déan fardal

Filleann GET /v1/files gach comhad a uaslódáil chuig do chuntas:

curl https://api.x.ai/v1/files \
  -H "Authorization: Bearer $XAI_API_KEY"

Is liosta leathanaithe é an freagra, agus déanann gach iontráil athrá ar na meiteashonraí a chonaic tú ag am an uaslódaithe:

{
  "object": "list",
  "data": [
    {
      "id": "file_abc123",
      "object": "file",
      "bytes": 2458901,
      "created_at": 1710000000,
      "filename": "rapport-annuel.pdf",
      "purpose": "assistants"
    },
    {
      "id": "file_def456",
      "object": "file",
      "bytes": 15230,
      "created_at": 1710100000,
      "filename": "données-clients.csv",
      "purpose": "assistants"
    }
  ]
}

Réitíonn an t-amharc seo trí chás an-chruinn: file_id a ghnóthú nár shábháil tú ag am an uaslódaithe, fíorú ar mhéid iarbhír doiciméid a bhfuil cuma an-trom air, agus iarrthóirí le scriosadh a aimsiú trí shórtáil de réir created_at. Is é seo freisin an t-aon áit a fheicfidh tú ar an gcéad amharc gur seoladh an tuarascáil chéanna trí huaire faoi thrí ainm éagsúla.

Fíoraigh comhad sonrach

Nuair atá an t-aitheantóir ar eolas agat cheana, déanann GET /v1/files/{file_id} ceist ar dhoiciméad amháin:

curl https://api.x.ai/v1/files/file_abc123 \
  -H "Authorization: Bearer $XAI_API_KEY"

Faigheann tú an t-eolas céanna agus a fuair tú ag am an uaslódaithe: an t-aithneoir, an t-ainm, an méid, an dáta cruthaithe, agus an cuspóir. Is é an úsáid is úsáidí den ghlao seo ná cosaint. Sula seolann tú próiseas a thagraíonn do file_id atá stóráilte i do bhunachar sonraí le fada, sábhálann seiceáil a mhaireann cúpla milleasoicind tú ó earráid i lathair slabhra d’iarratais íoctha.

Scrios, agus cad le seiceáil roimhe

Déantar an scriosadh le DELETE /v1/files/{file_id} agus deimhníonn an freagra an oibríocht:

curl -X DELETE https://api.x.ai/v1/files/file_abc123 \
  -H "Authorization: Bearer $XAI_API_KEY"
{
  "id": "file_abc123",
  "object": "file",
  "deleted": true
}

Tá dhá sheiceáil riachtanach sula mbuaileann tú an sparán. Ar an gcéad dul síos, d’fhéadfadh an comhad a bheith tagartha i mbailiúchán – coincheap a mhínímid go mion i gcúrsaí atá le teacht. Ní bhaineann an scriosadh tríd an API Comhad é go huathoibríoch ón mbailiúchán, rud a fhágann tagairt mharbh in do innéacs agat: bain é ón mbailiúchán ar dtús, agus ansin ón stóráil. Ina theannta sin, d’fhéadfadh sreabha oibre gníomhacha a bheith ag úsáid an chomhaid; gheobhaidh aon fheidhmchlár a choinníonn an file_id seo ina bhunachar sonraí earráidí chomh luath agus a dhéantar an scriosadh, go minic sa táirgeadh agus go hannamh agus tú ag faire ar na logaí.

Coinnigh do stóráil glan

Is é an t-ainmniú do chéad uirlis bhainistíochta, toisc go gcoinnítear an bunainm sna meiteashonraí agus gurb é an t-aon mharcóir inléite é i liosta de chéad iontráil. Ciallóidh rapport-q1-2026.pdf rud éigin duit i gceann ocht mí; ní chiallóidh document.pdf riamh. Baineann an réasúnaíocht chéanna le api-specs-v2.json i gcomparáid le data.json. Déan cleachtas de seo agus tú ag ullmhú an chomhaid ar do dhiosca, ní ag am an uaslódaithe: is é an t-ainm áitiúil a tharchuirtear.

Fanann comhaid uaslódáilte stóráilte go deo, gan aon éag uathoibríoch. Tá gnáthamh glantacháin gach ráithe leordhóthanach chun claonadh a sheachaint, i dtrí chéim:

  1. Liostaigh do chuid comhad le GET /v1/files
  2. Aimsigh na cinn nach bhfuil in úsáid a thuilleadh, de réir dáta cruthaithe nó ainm
  3. Scrios iad le DELETE /v1/files/{file_id}

Tagann trí chód earráide chun cinn sna hoibríochtaí seo agus déantar diagnóis orthu láithreach. Léiríonn 404 comhad nach bhfuil ann nó a scriosadh cheana, cás tipiciúil de script glantacháin a ritheadh faoi dhó. Tagann 401 ó eochair API atá in easnamh nó neamhbhailí, minic athróg timpeallachta nach bhfuil lódáilte sa sceall reatha. Léiríonn 413 go sáraíonn an comhad an teorainn cheadaithe 48 MB agus tarlaíonn sé ag am an uaslódaithe, ní le linn na bainistíochta.

Príomhphointí

  • Liostaíonn GET /v1/files do chuid comhad go léir lena meiteashonraí
  • Faigheann GET /v1/files/{id} comhad sonrach
  • Scriosann DELETE /v1/files/{id} comhad go buan
  • Ainmnigh do chuid comhad go sainráite chun bainistiú a éascú
  • Seiceáil spleáchais (bailiúcháin, sreabha oibre) sula ndéanann tú scriosadh