Megosztás a következőn keresztül:


ResourceFile Osztály

Egy vagy több fájl, amely egy számítási csomópontra tölthető le.

Öröklődés
ResourceFile

Konstruktor

ResourceFile(*, auto_storage_container_name: str = None, storage_container_url: str = None, http_url: str = None, blob_prefix: str = None, file_path: str = None, file_mode: str = None, identity_reference=None, **kwargs)

Paraméterek

auto_storage_container_name
str
Kötelező

Az autoStorageContainerName, storageContainerUrl és httpUrl tulajdonságok kölcsönösen kizárják egymást, és meg kell adni közülük egyet.

storage_container_url
str
Kötelező

Az autoStorageContainerName, storageContainerUrl és httpUrl tulajdonságok kölcsönösen kizárják egymást, és meg kell adni közülük egyet. Ennek az URL-címnek olvashatónak és listázhatónak kell lennie a számítási csomópontokról. Az Azure Storage-tárolókhoz háromféleképpen lehet ilyen URL-címet beszerezni: tartalmazzon egy közös hozzáférésű jogosultságkódot (SAS), amely olvasási és listázási engedélyeket ad a tárolóhoz, használjon olvasási és listázási engedélyekkel rendelkező felügyelt identitást, vagy állítsa be a tároló ACL-ét a nyilvános hozzáférés engedélyezéséhez.

http_url
str
Kötelező

Az autoStorageContainerName, storageContainerUrl és httpUrl tulajdonságok kölcsönösen kizárják egymást, és meg kell adni közülük egyet. Ha az URL-cím Azure Blob Storage mutat, akkor olvashatónak kell lennie a számítási csomópontokról. Egy blob ilyen URL-címének lekérése háromféleképpen lehetséges az Azure Storage-ban: tartalmazzon egy közös hozzáférésű jogosultságkódot (SAS), amely olvasási engedélyeket ad a blobhoz, használjon olvasási engedéllyel rendelkező felügyelt identitást, vagy állítsa be a blob vagy a tároló ACL-jét a nyilvános hozzáférés engedélyezéséhez.

blob_prefix
str
Kötelező

A tulajdonság csak az autoStorageContainerName vagy storageContainerUrl használatakor érvényes. Ez az előtag lehet részleges fájlnév vagy alkönyvtár. Ha nincs megadva előtag, a tárolóban lévő összes fájl le lesz töltve.

file_path
str
Kötelező

Ha a httpUrl tulajdonság meg van adva, a filePath megadása kötelező, és leírja a fájl letöltési útvonalát, beleértve a fájlnevet is. Ellenkező esetben, ha az autoStorageContainerName vagy storageContainerUrl tulajdonság meg van adva, a filePath nem kötelező, és az a könyvtár, amelyre a fájlokat le szeretné tölteni. Abban az esetben, ha a filePath könyvtárként van használatban, a bemeneti adatokhoz már társított könyvtárstruktúrát a rendszer teljes egészében megőrzi, és hozzáfűzi a megadott filePath könyvtárhoz. A megadott relatív elérési út nem bontható ki a tevékenység munkakönyvtárából (például a ".." használatával).

file_mode
str
Kötelező

Ez a tulajdonság csak a Linux számítási csomópontokra letöltött fájlokra vonatkozik. A rendszer figyelmen kívül hagyja, ha meg van adva egy erőforrásfájlhoz, amely egy Windows számítási csomópontra lesz letöltve. Ha ez a tulajdonság nincs megadva linuxos számítási csomóponthoz, akkor a rendszer egy alapértelmezett 0770-es értéket alkalmaz a fájlra.

identity_reference
ComputeNodeIdentityReference
Kötelező

A storageContainerUrl vagy a httpUrl által megadott Azure Blob Storage eléréséhez használandó felhasználó által hozzárendelt identitásra mutató hivatkozás.

Metódusok

as_dict

Adjon vissza egy JSONify típusú diktáltot a json.dump használatával.

A speciális használat opcionálisan visszahívást is használhat paraméterként:

A kulcs a Pythonban használt attribútumnév. Attr_desc a metaadatok diktálása. Jelenleg a "type" az msrest típussal, a "key" pedig a RestAPI kódolású kulccsal. Az érték az objektum aktuális értéke.

A visszaadott sztring a kulcs szerializálására szolgál. Ha a visszatérési típus lista, akkor a rendszer hierarchikus eredménydiktátumnak tekinti.

Tekintse meg a fájl három példáját:

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

Ha XML-szerializálást szeretne, átadhatja a kwargs is_xml=True értéket.

deserialize

Elemezhet egy str-t a RestAPI szintaxissal, és visszaad egy modellt.

enable_additional_properties_sending
from_dict

A diktálás adott kulcselszívóval történő elemzése modell visszaadása.

Alapértelmezés szerint vegye figyelembe a kulcselszívókat (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor és last_rest_key_case_insensitive_extractor)

is_xml_model
serialize

A modellből az Azure-ba küldendő JSON-t adja vissza.

Ez a as_dict(full_restapi_key_transformer, keep_readonly=Hamis) alias.

Ha XML-szerializálást szeretne, átadhatja a kwargs is_xml=True értéket.

validate

Ellenőrizze a modellt rekurzív módon, és adja vissza a ValidationError listáját.

as_dict

Adjon vissza egy JSONify típusú diktáltot a json.dump használatával.

A speciális használat opcionálisan visszahívást is használhat paraméterként:

A kulcs a Pythonban használt attribútumnév. Attr_desc a metaadatok diktálása. Jelenleg a "type" az msrest típussal, a "key" pedig a RestAPI kódolású kulccsal. Az érték az objektum aktuális értéke.

A visszaadott sztring a kulcs szerializálására szolgál. Ha a visszatérési típus lista, akkor a rendszer hierarchikus eredménydiktátumnak tekinti.

Tekintse meg a fájl három példáját:

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

Ha XML-szerializálást szeretne, átadhatja a kwargs is_xml=True értéket.

as_dict(keep_readonly=True, key_transformer=<function attribute_transformer>, **kwargs)

Paraméterek

key_transformer
<xref:function>

Egy kulcsátalakító függvény.

keep_readonly
alapértelmezett érték: True

Válaszok

A dict JSON-kompatibilis objektum

Visszatérési típus

deserialize

Elemezhet egy str-t a RestAPI szintaxissal, és visszaad egy modellt.

deserialize(data, content_type=None)

Paraméterek

data
str
Kötelező

RestAPI-struktúrát használó struktúra. JSON alapértelmezés szerint.

content_type
str
alapértelmezett érték: None

A JSON alapértelmezés szerint az alkalmazás/xml beállítása XML esetén.

Válaszok

A modell egy példánya

Kivételek

DeserializationError if something went wrong

enable_additional_properties_sending

enable_additional_properties_sending()

from_dict

A diktálás adott kulcselszívóval történő elemzése modell visszaadása.

Alapértelmezés szerint vegye figyelembe a kulcselszívókat (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor és last_rest_key_case_insensitive_extractor)

from_dict(data, key_extractors=None, content_type=None)

Paraméterek

data
dict
Kötelező

Egy restAPI-struktúrát használó diktálás

content_type
str
alapértelmezett érték: None

A JSON alapértelmezés szerint az alkalmazás/xml beállítása XML esetén.

key_extractors
alapértelmezett érték: None

Válaszok

A modell egy példánya

Kivételek

DeserializationError if something went wrong

is_xml_model

is_xml_model()

serialize

A modellből az Azure-ba küldendő JSON-t adja vissza.

Ez a as_dict(full_restapi_key_transformer, keep_readonly=Hamis) alias.

Ha XML-szerializálást szeretne, átadhatja a kwargs is_xml=True értéket.

serialize(keep_readonly=False, **kwargs)

Paraméterek

keep_readonly
bool
alapértelmezett érték: False

Ha szerializálni szeretné az olvasható attribútumokat

Válaszok

A dict JSON-kompatibilis objektum

Visszatérési típus

validate

Ellenőrizze a modellt rekurzív módon, és adja vissza a ValidationError listáját.

validate()

Válaszok

Az érvényesítési hiba listája

Visszatérési típus