Aracılığıyla paylaş

Kutu

Box™, dosyalarınızı güvenli, eşitlenmiş ve kolayca paylaşabilen bir hizmettir. Dosyalarınızı yönetmek için Box'a bağlanın. Box'ta dosyaları karşıya yükleme, güncelleştirme, alma ve silme gibi çeşitli eylemler gerçekleştirebilirsiniz.

Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:

Hizmet Class Bölgeler
Copilot Studio Standart Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - 21Vianet tarafından işletilen Çin Bulutu
Logic Apps Standart Aşağıdakiler dışında tüm Logic Apps bölgeleri :
     - Azure Çin bölgeleri
     - ABD Savunma Bakanlığı (DoD)
Power Apps Standart Aşağıdakiler dışında tüm Power Apps bölgeleri :
     - 21Vianet tarafından işletilen Çin Bulutu
Power Automate Standart Aşağıdakiler dışında tüm Power Automate bölgeleri :
     - 21Vianet tarafından işletilen Çin Bulutu
İletişim
İsim Microsoft
URL Microsoft LogicApps Desteği
Microsoft Power Automate Desteği
Microsoft Power Apps Desteği
Bağlayıcı Meta Verileri
Publisher Microsoft
Web sitesi https://www.box.com/
Gizlilik ilkesi https://www.box.com/legal/privacypolicy

Box API Durumu

Box API kesintilerini izlemek için lütfen bu kaynağı kullanın

Bilinen sorunlar ve sınırlamalar

  1. Bağlayıcı Çoklu Oturum Açma (SSO) bağlantılarını desteklemiyor, lütfen bunun yerine standart bağlantı kullanın.
  2. Dosya Tanımlayıcısı parametresini gerçek dosya adıyla karıştırmayın. Box REST API kısıtlamaları nedeniyle şu karakterlere sahip geçersiz dosya tanımlayıcıları - [\ { } " <>] bağlayıcı GetawayTimeout hatalarına yol açabilir.
  3. Kök klasör de dahil olmak üzere belirtilen yoldaki her klasör (Klasör Yolu veya Dosya Yolu) 10000'den fazla öğe içermemelidir.
  4. Dosya seçici kullanarak bir klasörün dosyasını seçerken, sonuçta elde edilen yol '//Tüm Dosyalar' ile başlayabilir, örneğin '//Tüm Dosyalar/Klasörüm/MyFile.txt'. Kökte yeni 'Tüm Dosyalar' klasörü oluşturulmasını önlemek için bu yol el ile '/Klasörüm/MyFile.txt' olarak değiştirilmelidir. Kök klasöre başvurmak için '//Tüm Dosyalar' -> '/' gibi tek bir eğik çizgi kullanın.
  5. Tetikleyiciler çoğu durumda ilgili olayın oluşumunda hemen tetiklenebilir, ancak tetikleyicinin tetiklenme gecikmesinin temel API sınırlamaları nedeniyle bir güne kadar sürebileceği nadir durumlar olabilir. Daha fazla bilgi edinmek için (Box Events API' sine) gidin. Bir dosyanın bu süre boyunca bir klasörde tutulması önerilir. Aksi takdirde, tetikleyici mantığı tarafından raporlanmaz.
  6. Bir klasörde zaten bir dosya varsa, aynı ada sahip dosyayı yeniden karşıya yükleme işlemi oluşturma olayı olarak kabul edilmez ancak olayı güncelleştirir.
  7. Bu bağlayıcı artık tablosal bağlayıcı değildir ve bu nedenle Excel bağlayıcısı için de dahil olmak üzere tablosal veri kaynağı olarak kullanılamaz.
  8. Bu bağlayıcı arka uçtan bir no-op isteği gönderebilir.

Genel Sınırlar

İsim Değer
En büyük dosya boyutu (MB cinsinden) 75
En fazla klasör öğesi sayısı 10000
Bir bant genişliği zaman aralığı içinde (bağlantı başına) bağlayıcıya/bağlayıcıdan aktarılan megabayt sayısı üst sınırı 1000
Bant genişliği zaman aralığı (milisaniye cinsinden) 60000

Azaltma Sınırları

Name Çağrılar Yenileme Dönemi
Bağlantı başına API çağrıları 100 60 saniye

Eylemler

Arşivi klasöre ayıkla

Bir arşiv dosyasını Box'taki bir klasöre ayıklar (örnek: .zip).
Dosya oluşturma

Box'a bir dosya yükler.
Dosyayı kopyalama

Box'ta bir dosyayı dosya yoluna kopyalayın.
Dosyayı sil

Mevcut bir dosyayı Box'tan siler.
JSON dosyasını güncelleştirme

Box'ta var olan bir dosyayı güncelleştirir.
Kimlik kullanarak dosya içeriği alma

Kimlik kullanarak Box'tan dosya içeriğini alır.
Kimlik kullanarak dosya meta verilerini alma

Dosya kimliğini kullanarak Box'tan dosya meta verilerini alır.
Klasördeki dosya ve klasörleri listeleme

Box klasöründeki dosya ve klasörleri listeler.
Kök klasördeki dosya ve klasörleri listeleme

Box kök klasöründeki dosya ve klasörleri listeler.
Yolu kullanarak dosya içeriği alma

Yolu kullanarak Box'tan dosya içeriğini alır.
Yolu kullanarak dosya meta verilerini alma

Yolu kullanarak Box'tan dosya meta verilerini alır.

Arşivi klasöre ayıkla

İşlem Kimliği:
ExtractFolderV2

Bir arşiv dosyasını Box'taki bir klasöre ayıklar (örnek: .zip).

Parametreler

Name Anahtar Gerekli Tür Description
Kaynak Arşiv Dosya Yolu
 source True string

Arşiv dosyasının yolu.
Hedef Klasör Yolu
 destination True string

Arşiv içeriğini ayıklamak için Box'taki yol.
Üzerine Yazmak
 overwrite boolean

'true' olarak ayarlanırsa hedef dosyaların üzerine yazar.

Döndürülenler

response
array of BlobMetadata

Dosya oluşturma

İşlem Kimliği:
CreateFile

Box'a bir dosya yükler.

Parametreler

Name Anahtar Gerekli Tür Description
Klasör Yolu
 folderPath True string

Dosyayı Box'a yüklemek için klasör yolu.
Dosya Adı
 name True string

Box'ta oluşturulacak dosyanın adı.
Dosya İçeriği
 body True binary

Box'a yüklenecek dosyanın içeriği.

Döndürülenler

Blob meta verileri

Body
BlobMetadata

Dosyayı kopyalama

İşlem Kimliği:
CopyFile

Box'ta bir dosyayı dosya yoluna kopyalayın.

Parametreler

Name Anahtar Gerekli Tür Description
Kaynak Url'si
 source True string

Kaynak dosyanın URL'si.
Hedef Dosya Yolu
 destination True string

Hedef dosya adı da dahil olmak üzere Box'taki hedef dosya yolu.
Üzerine Yazmak
 overwrite boolean

'true' olarak ayarlanırsa hedef dosyanın üzerine yazar.

Döndürülenler

Blob meta verileri

Body
BlobMetadata

Dosyayı sil

İşlem Kimliği:
DeleteFile

Mevcut bir dosyayı Box'tan siler.

Parametreler

Name Anahtar Gerekli Tür Description
Dosya Kimliği
 id True string

Box'tan silinecek dosyanın benzersiz tanımlayıcısı.

JSON dosyasını güncelleştirme

İşlem Kimliği:
UpdateFile

Box'ta var olan bir dosyayı güncelleştirir.

Parametreler

Name Anahtar Gerekli Tür Description
Dosya Kimliği
 id True string

Box'ta güncelleştirilecek dosyanın benzersiz tanımlayıcısı.
Dosya İçeriği
 body True binary

Box'ta güncelleştirilecek dosyanın içeriği.

Döndürülenler

Blob meta verileri

Body
BlobMetadata

Kimlik kullanarak dosya içeriği alma

İşlem Kimliği:
GetFileContent

Kimlik kullanarak Box'tan dosya içeriğini alır.

Parametreler

Name Anahtar Gerekli Tür Description
Dosya Kimliği
 id True string

Box'ta dosyanın benzersiz tanımlayıcısı.
İçerik Türü Çıkar
 inferContentType boolean

Uzantıya göre içerik türünü çıkarsamak için boole değeri (true, false).

Döndürülenler

Dosyanın içeriği.

Dosya İçeriği
binary

Kimlik kullanarak dosya meta verilerini alma

İşlem Kimliği:
GetFileMetadata

Dosya kimliğini kullanarak Box'tan dosya meta verilerini alır.

Parametreler

Name Anahtar Gerekli Tür Description
Dosya Kimliği
 id True string

Box'ta dosyanın benzersiz tanımlayıcısı.

Döndürülenler

Blob meta verileri

Body
BlobMetadata

Klasördeki dosya ve klasörleri listeleme

İşlem Kimliği:
ListFolder

Box klasöründeki dosya ve klasörleri listeler.

Parametreler

Name Anahtar Gerekli Tür Description
Klasör Kimliği
 id True string

Box'ta klasörün benzersiz tanımlayıcısı.

Döndürülenler

response
array of BlobMetadata

Kök klasördeki dosya ve klasörleri listeleme

İşlem Kimliği:
ListRootFolder

Box kök klasöründeki dosya ve klasörleri listeler.

Döndürülenler

response
array of BlobMetadata

Yolu kullanarak dosya içeriği alma

İşlem Kimliği:
GetFileContentByPath

Yolu kullanarak Box'tan dosya içeriğini alır.

Parametreler

Name Anahtar Gerekli Tür Description
Dosya Yolu
 path True string

Box'ta dosyanın benzersiz yolu.
İçerik Türü Çıkar
 inferContentType boolean

Uzantıya göre içerik türünü çıkarsamak için boole değeri (true, false).

Döndürülenler

Dosyanın içeriği.

Dosya İçeriği
binary

Yolu kullanarak dosya meta verilerini alma

İşlem Kimliği:
GetFileMetadataByPath

Yolu kullanarak Box'tan dosya meta verilerini alır.

Parametreler

Name Anahtar Gerekli Tür Description
Dosya Yolu
 path True string

Box'ta dosyanın benzersiz yolu.

Döndürülenler

Blob meta verileri

Body
BlobMetadata

Tetikleyiciler

Bir dosya değiştirildiğinde (yalnızca özellikler)

Bu işlem, bir klasörde bir dosya değiştirildiğinde bir akışı tetikler. Bir dosya bir alt klasöre eklendiğinde/güncelleştirildiğinde tetikleyici tetiklenmez. Alt klasörlerde tetiklenmesi gerekiyorsa, birden çok tetikleyici oluşturulmalıdır.
Bir dosya değiştirildiğinde (yalnızca özellikler) (V2) (Önizleme)

Bu işlem, bir klasörde bir dosya değiştirildiğinde bir akışı tetikler. Bir dosya bir alt klasöre eklendiğinde/güncelleştirildiğinde tetikleyici tetiklenmez. Alt klasörlerde tetiklenmesi gerekiyorsa, birden çok tetikleyici oluşturulmalıdır. Tetikleyici-Ayarlar> için 'Bölünmüş' seçeneğinin kapalı olması durumunda başarılı tetikleyici çalıştırmaları 'Dosya Listesi' çıkışı için boş bir dizi üretebilir.
Bir dosya değiştirildiğinde [KULLANIM DIŞI]

Box klasöründe bir dosya değiştirildiğinde akışı tetikler. Bir dosya bir alt klasöre eklendiğinde/güncelleştirildiğinde tetikleyici tetiklenmez. Alt klasörlerde tetiklenmesi gerekiyorsa, birden çok tetikleyici oluşturulmalıdır.
Bir dosya oluşturulduğunda (yalnızca özellikler) (V2)

Bu işlem, bir klasörde yeni bir dosya oluşturulduğunda bir akışı tetikler. Bir dosya bir alt klasöre eklendiğinde/güncelleştirildiğinde tetikleyici tetiklenmez. Alt klasörlerde tetiklenmesi gerekiyorsa, birden çok tetikleyici oluşturulmalıdır. Tetikleyici-Ayarlar> için 'Bölünmüş' seçeneğinin kapalı olması durumunda başarılı tetikleyici çalıştırmaları 'Dosya Listesi' çıkışı için boş bir dizi üretebilir.
Bir dosya oluşturulduğunda (yalnızca özellikler) [KULLANIM DIŞI]

Bu eylem kullanım dışı bırakıldı. Bunun yerine lütfen Bir dosya oluşturulduğunda (yalnızca özellikler) (V2) kullanın.

Bu işlem, bir klasörde yeni bir dosya oluşturulduğunda bir akışı tetikler. Bir dosya bir alt klasöre eklendiğinde/güncelleştirildiğinde tetikleyici tetiklenmez. Alt klasörlerde tetiklenmesi gerekiyorsa, birden çok tetikleyici oluşturulmalıdır.
Bir dosya oluşturulduğunda [KULLANIM DIŞI]

Box klasöründe yeni bir dosya oluşturulduğunda akışı tetikler. Bir dosya bir alt klasöre eklendiğinde/güncelleştirildiğinde tetikleyici tetiklenmez. Alt klasörlerde tetiklenmesi gerekiyorsa, birden çok tetikleyici oluşturulmalıdır.

Bir dosya değiştirildiğinde (yalnızca özellikler)

İşlem Kimliği:
OnUpdatedFiles

Bu işlem, bir klasörde bir dosya değiştirildiğinde bir akışı tetikler. Bir dosya bir alt klasöre eklendiğinde/güncelleştirildiğinde tetikleyici tetiklenmez. Alt klasörlerde tetiklenmesi gerekiyorsa, birden çok tetikleyici oluşturulmalıdır.

Parametreler

Name Anahtar Gerekli Tür Description
Klasör
 folderId True string

Klasör seçin
Döndürülecek dosya sayısı
 maxFileCount integer

Tek tetikleyici çalıştırması (1-100) ile döndürülecek en fazla dosya sayısı. 'Bölme Açık' ayarının tetikleyiciyi her öğeyi ayrı ayrı işlemeye zorlayabileceğini unutmayın.

Döndürülenler

Blob meta verileri

Dosya Listesi
BlobMetadata

Bir dosya değiştirildiğinde (yalnızca özellikler) (V2) (Önizleme)

İşlem Kimliği:
OnUpdatedFilesV2

Bu işlem, bir klasörde bir dosya değiştirildiğinde bir akışı tetikler. Bir dosya bir alt klasöre eklendiğinde/güncelleştirildiğinde tetikleyici tetiklenmez. Alt klasörlerde tetiklenmesi gerekiyorsa, birden çok tetikleyici oluşturulmalıdır. Tetikleyici-Ayarlar> için 'Bölünmüş' seçeneğinin kapalı olması durumunda başarılı tetikleyici çalıştırmaları 'Dosya Listesi' çıkışı için boş bir dizi üretebilir.

Parametreler

Name Anahtar Gerekli Tür Description
Klasör
 folderId True string

Klasör seçin
Döndürülecek dosya sayısı
 maxFileCount integer

Tek tetikleyici çalıştırması (1-100) ile döndürülecek en fazla dosya sayısı. 'Bölme Açık' ayarının tetikleyiciyi her öğeyi ayrı ayrı işlemeye zorlayabileceğini unutmayın.

Döndürülenler

Blob meta verileri

Dosya Listesi
BlobMetadata

Bir dosya değiştirildiğinde [KULLANIM DIŞI]

İşlem Kimliği:
OnUpdatedFile

Box klasöründe bir dosya değiştirildiğinde akışı tetikler. Bir dosya bir alt klasöre eklendiğinde/güncelleştirildiğinde tetikleyici tetiklenmez. Alt klasörlerde tetiklenmesi gerekiyorsa, birden çok tetikleyici oluşturulmalıdır.

Parametreler

Name Anahtar Gerekli Tür Description
Klasör Kimliği
 folderId True string

Box'ta klasörün benzersiz tanımlayıcısı.
İçerik Türü Çıkar
 inferContentType boolean

Uzantıya göre içerik türünü çıkarsamak için boole değeri (true, false).

Döndürülenler

Dosyanın içeriği.

Dosya İçeriği
binary

Bir dosya oluşturulduğunda (yalnızca özellikler) (V2)

İşlem Kimliği:
OnNewFilesV2

Bu işlem, bir klasörde yeni bir dosya oluşturulduğunda bir akışı tetikler. Bir dosya bir alt klasöre eklendiğinde/güncelleştirildiğinde tetikleyici tetiklenmez. Alt klasörlerde tetiklenmesi gerekiyorsa, birden çok tetikleyici oluşturulmalıdır. Tetikleyici-Ayarlar> için 'Bölünmüş' seçeneğinin kapalı olması durumunda başarılı tetikleyici çalıştırmaları 'Dosya Listesi' çıkışı için boş bir dizi üretebilir.

Parametreler

Name Anahtar Gerekli Tür Description
Klasör
 folderId True string

Klasörün benzersiz tanımlayıcısı.
Döndürülecek dosya sayısı
 maxFileCount integer

Tek tetikleyici çalıştırması (1-100) ile döndürülecek en fazla dosya sayısı. 'Bölme Açık' ayarının tetikleyiciyi her öğeyi ayrı ayrı işlemeye zorlayabileceğini unutmayın.

Döndürülenler

Blob meta verileri

Dosya Listesi
BlobMetadata

Bir dosya oluşturulduğunda (yalnızca özellikler) [KULLANIM DIŞI]

İşlem Kimliği:
OnNewFiles

Bu eylem kullanım dışı bırakıldı. Bunun yerine lütfen Bir dosya oluşturulduğunda (yalnızca özellikler) (V2) kullanın.

Bu işlem, bir klasörde yeni bir dosya oluşturulduğunda bir akışı tetikler. Bir dosya bir alt klasöre eklendiğinde/güncelleştirildiğinde tetikleyici tetiklenmez. Alt klasörlerde tetiklenmesi gerekiyorsa, birden çok tetikleyici oluşturulmalıdır.

Parametreler

Name Anahtar Gerekli Tür Description
Klasör
 folderId True string

Klasörün benzersiz tanımlayıcısı.
Döndürülecek dosya sayısı
 maxFileCount integer

Tek tetikleyici çalıştırması (1-100) ile döndürülecek en fazla dosya sayısı. 'Bölme Açık' ayarının tetikleyiciyi her öğeyi ayrı ayrı işlemeye zorlayabileceğini unutmayın.

Döndürülenler

Blob meta verileri

Dosya Listesi
BlobMetadata

Bir dosya oluşturulduğunda [KULLANIM DIŞI]

İşlem Kimliği:
OnNewFile

Box klasöründe yeni bir dosya oluşturulduğunda akışı tetikler. Bir dosya bir alt klasöre eklendiğinde/güncelleştirildiğinde tetikleyici tetiklenmez. Alt klasörlerde tetiklenmesi gerekiyorsa, birden çok tetikleyici oluşturulmalıdır.

Parametreler

Name Anahtar Gerekli Tür Description
Klasör Kimliği
 folderId True string

Box'ta klasörün benzersiz tanımlayıcısı.
İçerik Türü Çıkar
 inferContentType boolean

Uzantıya göre içerik türünü çıkarsamak için boole değeri (true, false).

Döndürülenler

Dosyanın içeriği.

Dosya İçeriği
binary

Tanımlar

BlobMetadata

Blob meta verileri

Name Yol Tür Description
Kimlik
 Id string

Dosya veya klasörün benzersiz kimliği.
İsim
 Name string

Dosya veya klasörün adı.
Gösterim Adı
 DisplayName string

Dosya veya klasörün görünen adı.
Yol
 Path string

Dosya veya klasörün yolu.
SonDeğiştirildi
 LastModified date-time

Dosya veya klasörün son değiştirildiği tarih ve saat.
Boyut
 Size integer

Dosya veya klasörün boyutu.
Medya Türü
 MediaType string

Dosya veya klasörün medya türü.
IsFolder
 IsFolder boolean

Blob'un bir klasör olup olmadığını belirten boole değeri (true, false).
ETag (İngilizce)
 ETag string

Dosya veya klasörün etiketi.
FileLocator
 FileLocator string

Dosya veya klasörün dosya bulucu.
SonDeğiştiren
 LastModifiedBy string

Dosya veya klasörü son değiştiren kullanıcı.

ikili

Bu, 'ikili' temel veri türüdür.