Zoznam projektov a nasadení
Každý workspace, ktorý účet vlastní, a potom každá skutočne bežiaca aplikácia, ako dve čítania pohľadov CouchDB.
„Projekty“ a „nasadenia“ odpovedajú na dve rôzne otázky. Projekt je workspace v účte, to, čo by
ste videli v prepínači projektov, bez ohľadu na to, či sa niečo v ňom niekedy sprevádzkovalo.
Nasadenie je jedna aplikácia, ktorá skutočne niekde beží, is_deployment: true na jej vlastnom
dokumente. Zoznam účtu zvyčajne znamená oboje: najprv workspace a potom to, čo má každý z nich
spustené.
Methods
Get Account Projects
Returns the projects owned by the account (or all projects for superuser and support accounts) from the user_projects master view.
Get Account Deployments
Returns the deployments associated with the account from the user_deployments master view.
Walkthrough
List the account's projects
Žiadne polia okrem vášho kľúča: obe metódy priraďujú pohľad CouchDB k uid, na ktoré sa vaše poverenie už rozlišuje.
2. List what is actually deployed
Rovnaký tvar, iný pohľad: user_deployments vydá dokument len vtedy, keď je is_deployment
pravdivé, takže tento zoznam je podmnožinou každej aplikácie, ktorú účet kedy vytvoril, tých so
živou prístupovou URL.
The response
Obe metódy odovzdávajú výsledok pohľadu CouchDB priamo, nezabalený: code je 871 (pevný kód
úspechu, ktorý get_couch_view vždy vracia, nie obvyklé 1) a data je surová odpoveď pohľadu
nano, total_rows, offset a pole rows s prvkami { id, key, value }. id je _id projektu
(alebo nasadenia), hodnota, ktorú posielate ako app_id pri každom ďalšom volaní v tejto sekcii.
Riadky get_account_deployments nesú tie isté polia plus app_hosting_server,
app_datacenter_id, app_hosting a is_deployment: true, pretože user_deployments ich vydáva
navyše k spoločnej sade. app_status_code < 4 je jediný stav, ktorý vám tento pohľad alebo
user_projects kedy ukáže: obe mapovacie funkcie odfiltrujú všetko od 4 vyššie, takže vymazaný
projekt jednoducho prestane byť viditeľný a neobjaví sa so stavom na kontrolu.
get_account_projects pridá main_profile_name k riadku vlastného workspace účtu, keď má tento
workspace pomenovaný profil, takže riadok, ktorý zobrazíte ako „váš“ projekt, sa môže čítať inak
ako jeho uložený app_name. Ak je prítomné main_profile_name, uprednostnite ho.
Errors
Obe metódy môžu zlyhať len tak, ako každé volanie: chýbajúci alebo neoprávnený api_key (-401,
pozri Errors). Ani jedna sa nevetví podľa app_id ani iného vstupu, keďže žiadny
neberie, prázdne pole rows je skutočná úspešná odpoveď pre účet, ktorý v tomto zozname zatiaľ
nič nemá, nie chyba.