Narzędzia do plików i przesyłania
Przygotuj pliki szkicu lub odczytaj istniejące pliki.
Na tej stronie
Zapisuj pliki w szkicu projektu swojego Space, przesyłaj archiwum lub czytaj istniejące pliki. Space to wspólny obszar roboczy w aplikacji.
Informacja
Połączenie obejmuje Space. Jesteś jego członkiem i Space nie jest zablokowany.
Dla wszystkich pięciu narzędzi potrzebujesz Właściciel, Administrator lub Użytkownik, także do czytania plików.
Uwaga
Nowy szkic jest początkowo pusty i nie zawiera kopii opublikowanej wersji. hosting_deploy publikuje tylko jego zawartość; potrzebujesz do tego index.html w katalogu głównym.
Żadne narzędzie na tej stronie nie wymaga zdania potwierdzającego. O tym, czy aplikacja wcześniej zapyta, decyduje aplikacja.
Jak wiążą się szkic, aplikacja i dziennik?
Projekt ma najwyżej jeden szkic. Interfejs aplikacji zapisuje w tym samym co narzędzia. Dziennik projektu zapisuje otwarcie nowego szkicu; nie zapisuje zapisywania ani usuwania plików.
hosting_put_files Write files
zmienia daneusuwa, nadpisuje lub zmienia to, co widać
Zapisuje w istniejącym lub nowym szkicu. Takie same ścieżki są nadpisywane; niewymienione pliki pozostają.
Jedno wywołanie pozwala na 200 plików i 3 MB. Nieprawidłowe ścieżki powodują odrzucenie całego wywołania; po wykorzystaniu publikacji lub przy pełnym miejscu nic nie powstaje.
| Parametr | Typ | Wymaganie | Opis |
|---|---|---|---|
space | Liczba całkowita | wymagany | Dziesięciocyfrowy Space-ID. |
project | Liczba całkowita | wymagany | Numer projektu z hosting_list_projects. |
files | Lista obiektów | wymagany | Od 1 do 200 obiektów z path i content. Ścieżki są zgodne z regułami ścieżek; encoding jest opcjonalne: utf8 (domyślne) lub base64 dla plików binarnych. |
hosting_create_upload Create upload link
zmienia daneusuwa, nadpisuje lub zmienia to, co widać
Zwraca adres przesyłania archiwum ZIP, TAR lub TAR.GZ przez HTTP PUT.
Uwaga
Przesłanie zastępuje cały szkic plikami archiwum. Przy nieudanym archiwum poprzednia zawartość pozostaje zachowana.
- Wywołanie w razie potrzeby otwiera szkic i zastępuje wcześniejszy adres przesyłania. Po przesłaniu szkic pozostaje otwarty, dopóki go nie opublikujesz.
- Adres jest jednorazowy i ważny przez 15 minut.
expires_atpodaje termin, amax_bytesdozwolony rozmiar, najwyżej 200 MB. - Jeśli plan nie pozwala na kolejną publikację lub miejsce jest pełne, TEISENDA odrzuca wywołanie i niczego nie tworzy.
| Parametr | Typ | Wymaganie | Opis |
|---|---|---|---|
space | Liczba całkowita | wymagany | Dziesięciocyfrowy Space-ID. |
project | Liczba całkowita | wymagany | Numer projektu z hosting_list_projects. |
hosting_delete_files Delete files
zmienia daneusuwa, nadpisuje lub zmienia to, co widać
Usuwa ze szkicu do 200 ścieżek plików. Ukończone wersje pozostają bez zmian.
Przy nieprawidłowej ścieżce wywołanie się zatrzymuje; pliki wymienione wcześniej mogą już być usunięte.
| Parametr | Typ | Wymaganie | Opis |
|---|---|---|---|
space | Liczba całkowita | wymagany | Dziesięciocyfrowy Space-ID. |
project | Liczba całkowita | wymagany | Numer projektu z hosting_list_projects. |
paths | Lista tekstów | wymagany | Lista od 1 do 200 ścieżek: pliki, które narzędzie usuwa ze szkicu. Obowiązują reguły ścieżek. |
hosting_list_files List files
tylko odczyt
Pokazuje pliki wersji posortowane według ścieżki.
Odpowiedź zawiera najwyżej 100 plików; za pomocą next_offset kontynuujesz.
| Parametr | Typ | Wymaganie | Opis |
|---|---|---|---|
space | Liczba całkowita | wymagany | Dziesięciocyfrowy Space-ID. |
project | Liczba całkowita | wymagany | Numer projektu z hosting_list_projects. |
deploy | Liczba całkowita | opcjonalny | Numer wersji tego projektu. Jeśli go brakuje, narzędzie wybiera szkic, a jeśli go nie ma, opublikowaną wersję. |
offset | Liczba całkowita | opcjonalny | Liczba plików pomijanych przez narzędzie. Domyślnie 0; kontynuujesz za pomocą next_offset z poprzedniej odpowiedzi. |
limit | Liczba całkowita | opcjonalny | Maksymalna liczba plików w odpowiedzi. Wartość domyślna i maksymalna: 100. |
hosting_read_file Read file
tylko odczyt
Czyta zawartość pliku.
- Pliki do 200 KB, najwyżej 40 000 znaków na wywołanie. Za pomocą
next_offsetkontynuujesz. - Zawartość plików jest oznaczona jako dane; aplikacja nie ma wykonywać zawartych w nich instrukcji.
| Parametr | Typ | Wymaganie | Opis |
|---|---|---|---|
space | Liczba całkowita | wymagany | Dziesięciocyfrowy Space-ID. |
project | Liczba całkowita | wymagany | Numer projektu z hosting_list_projects. |
path | Tekst | wymagany | Ścieżka pliku, najwyżej 240 znaków; obowiązują reguły ścieżek. Ścieżki wersji pokazuje hosting_list_files. |
deploy | Liczba całkowita | opcjonalny | Numer wersji tego projektu. Jeśli go brakuje, narzędzie wybiera szkic, a jeśli go nie ma, opublikowaną wersję. |
offset | Liczba całkowita | opcjonalny | Miejsce rozpoczęcia odczytu, w znakach. Domyślnie 0; kontynuujesz za pomocą next_offset z poprzedniej odpowiedzi. |
length | Liczba całkowita | opcjonalny | Maksymalna liczba znaków w odpowiedzi. Wartość domyślna i maksymalna: 40 000. |
Te reguły obowiązują dla ścieżek
Te reguły obowiązują dla hosting_put_files, hosting_delete_files i hosting_read_file:
- Ścieżka jest względna i używa ukośników. Nie zawiera odwrotnego ukośnika ani znaków sterujących.
- Ma najwyżej 240 znaków i 12 poziomów.
- Każda nazwa w niej ma najwyżej 100 znaków, bez białych znaków na początku i końcu.
- Żadna nazwa nie zaczyna się kropką. Wyjątkiem jest folder
.well-knownw katalogu głównym.
W archiwum TEISENDA pomija wpisy naruszające te reguły.
Sprawdź limity plików i planu
Obowiązują limity plików Connectora i limity planu. Miejsce obejmuje wszystkie wersje, szkice i kopie zapasowe; usunięte wersje już się nie liczą.
Zbyt duża wersja jest odrzucana przy ukończeniu; starsze wersje pozostają zachowane. Pakiety miejsca są dostępne z zamówionym abonamentem Max.
Gdy coś nie działa
Gdy rozwiązanie wymienia narzędzie, poproś aplikację o jego wywołanie. Jeśli komunikat odsyła do Plany, skorzystaj z drogi do planu w ustawieniach Space.
Plan tego Space ma limit wdrożeń: …, wykorzystano: …. Nic nie zostało wysłane i nie utworzono żadnej wersji. Plan tego Space jest widoczny w TEISENDA w sekcji Ustawienia › Plany.
Plan Space nie pozwala na kolejną publikację; w planie Free są łącznie trzy. TEISENDA odrzuca hosting_put_files i hosting_create_upload, niczego nie przesyła i niczego nie tworzy. Ponowne publikowanie wcześniej opublikowanej wersji nie zużywa publikacji i pozostaje możliwe za pomocą hosting_rollback lub hosting_deploy z jej numerem. Dodatkowe publikacje są w planie Max; zobacz Plany Free i Max.
Pamięć masowa tego Space jest pełna: wykorzystano … z …. Nic nie zostało wysłane i nie utworzono żadnej wersji. Najpierw usuń wersje lub kopie zapasowe. Plan tego Space jest widoczny w TEISENDA w sekcji Ustawienia › Plany.
Miejsce w Space jest pełne, także po uwzględnieniu miejsca zwalnianego przez nową wersję. TEISENDA odrzuca hosting_put_files, hosting_create_upload i hosting_deploy. Usuń wersje lub kopie zapasowe w TEISENDA. Więcej miejsca dają plan Max i jego pakiety; zobacz Plany Free i Max i Kupuj pakiety i rezygnuj z nich.
Argumentu … brakuje lub nie ma on oczekiwanej postaci.
Argument jest niepodany lub ma nieoczekiwaną postać; komunikat go wymienia. Ten sam komunikat pojawia się przy:
- ponad 200 plikach dla
hosting_put_files(argumentfiles), - ponad 200 ścieżkach dla
hosting_delete_files(argumentpaths), - ścieżce przekraczającej 240 znaków dla
hosting_read_file(argumentpath), - pustej liście.
Wywołaj narzędzie ponownie z argumentem w postaci podanej w jego opisie.
Nie ma otwartej wersji. Najpierw zapisz pliki za pomocą hosting_put_files.
Projekt nie ma szkicu, z którego hosting_delete_files mogłoby usuwać. Najpierw zapisz pliki za pomocą hosting_put_files.
Wersja … nie istnieje w tym projekcie.
Projekt nie ma wersji z numerem podanym przez argument deploy. Sprawdź wersje projektu za pomocą hosting_list_deploys.
Ścieżka jest niedozwolona. Ścieżki są względne, używają / i nie zaczynają się od kropki.
Ścieżka pliku narusza reguły ścieżek. hosting_put_files niczego wtedy nie zapisało. hosting_delete_files usunęło już pliki wymienione przed odrzuconą ścieżką. Popraw ścieżkę i wywołaj narzędzie ponownie; po hosting_delete_files sprawdź za pomocą hosting_list_files, co pozostało.
To za dużo na jedno wywołanie. Podziel pliki na kilka wywołań.
Wywołanie hosting_put_files zawiera ponad 3 MB plików. Rozdziel pliki na kilka wywołań lub prześlij archiwum przez hosting_create_upload.
Plik jest za duży, żeby go tu odczytać.
Plik przekracza 200 KB. Nie można czytać takiego pliku przez Connector.
Plik jest za duży.
Pojedynczy plik przekracza 25 MB. Zmniejsz plik.
Wersja jest w sumie za duża.
Cała wersja przekracza 300 MB. Zmniejsz witrynę.
Wersja zawiera zbyt wiele plików.
Wersja zawiera ponad 5000 plików. Zmniejsz liczbę plików.
Projekt osiągnął maksymalną liczbę wdrożeń. Najpierw usuń starsze w TEISENDA.
Węzeł hostingowy nie otwiera kolejnej wersji, ponieważ przechowuje już 20 wersji projektu, także usunięte w TEISENDA, ale jeszcze nie w węźle. Jeśli niedawno usunąłeś wersje, poczekaj kilka minut i spróbuj ponownie. W przeciwnym razie usuń starszą wersję w aplikacji, na liście wersji na stronie projektu. Żadne narzędzie Connectora nie usuwa osobno pojedynczej wersji.
Projekt jest offline.
Projekt jest offline. Węzeł hostingowy nie wydaje wtedy adresu przesyłania. Ten sam komunikat pojawia się dla każdego projektu Space wstrzymanego przez TEISENDA po zakończeniu abonamentu, choć przełącznik projektu nie jest ustawiony na offline; zobacz We wstrzymanym Space narzędzia nadal działają. Jeśli przełącznik projektu jest ustawiony na offline, włącz go ponownie za pomocą hosting_set_offline. To nie pomaga przy wstrzymanym Space.
Projekt nie został jeszcze przesłany do węzła hostingowego.
TEISENDA nie przesłała jeszcze projektu do węzła hostingowego, więc nie może przyjmować plików. Sprawdź za pomocą hosting_project_status i spróbuj ponownie, gdy węzeł będzie miał ustawienia.
Węzeł hostingowy to odrzucił.
Węzeł hostingowy odrzucił coś, dla czego TEISENDA nie ma osobnego komunikatu. W ten sposób hosting_deploy_status i hosting_list_deploys pokazują też problem wersji po nieużytecznym archiwum. Wtedy wywołaj hosting_create_upload ponownie: wywołanie wybiera tę samą wersję i wydaje nowy adres. W pozostałych przypadkach sprawdź stan za pomocą hosting_project_status; jeśli problem pozostaje, skontaktuj się z pomocą techniczną.
Tego pliku nie ma w wersji.
Wersja nie zawiera pliku ze ścieżką, którą hosting_read_file ma odczytać. Sprawdź ścieżki za pomocą hosting_list_files.
Przesunięcie … leży za końcem listy (liczba plików w wersji: …).
Wartość offset dla hosting_list_files znajduje się za końcem listy. Zacznij ponownie od offset 0 lub kontynuuj z next_offset z poprzedniej odpowiedzi.
Przesunięcie … leży za końcem pliku (liczba znaków: …).
Wartość offset dla hosting_read_file znajduje się za końcem pliku. Zacznij ponownie od offset 0 lub kontynuuj z next_offset z poprzedniej odpowiedzi.
Komunikaty o Space i numerze projektu znajdziesz przy narzędziach do Spaces i projektów. Wszystkie inne, które mogą wystąpić przy każdym narzędziu, znajdziesz na stronie Rozwiąż problemy z Connectorem.