共用方式為

CorsRule 類別

  • 參考

CORS 是一項 HTTP 功能，可讓 Web 應用程式在某個網域下執行，以存取其他網域中的資源。 網頁瀏覽器會實作稱為同源原則的安全性限制，其可防止網頁呼叫不同網域中的 API；CORS 則提供了一個安全的方式，可讓一個網域 (原始網域) 能夠呼叫其他網域中的 API。

必須填入所有必要的參數，才能傳送至 Azure。

繼承
azure.storage.queue._generated.models._models_py3.CorsRule
CorsRule

建構函式

CorsRule(allowed_origins: List[str], allowed_methods: List[str], **kwargs: Any)

參數

allowed_origins
List[str]
必要

可透過 CORS 或 「*」 允許所有網域的原始網域清單。 清單至少必須包含一個專案。 限制為 64 個原始網域。 每個允許的原始網域最多可以有 256 個字元。

allowed_methods
List[str]
必要

來源允許執行的 HTTP 方法清單。 清單至少必須包含一個專案。 就 Azure 儲存體而言，允許的方法為 DELETE、GET、HEAD、MERGE、POST、OPTIONS 或 PUT。

max_age_in_seconds
int

用戶端/瀏覽器應該快取正式發行前小眾測試版回應的秒數。

exposed_headers
List[str]

預設為空白清單。 要公開給 CORS 用戶端的回應標頭清單。 限制為 64 個定義的標頭和兩個帶有前置詞的標頭。 每個標頭最多可以有 256 個字元。

allowed_headers
List[str]

預設為空白清單。 允許成為跨原始來源要求一部分的標頭清單。 限制為 64 個定義的標頭和 2 個帶有前置詞的標頭。 每個標頭最多可以有 256 個字元。

方法

as_dict

傳回可使用 json.dump 序列化的聽寫。

進階用法可以選擇性地使用回呼作為參數：

索引鍵是 Python 中使用的屬性名稱。 Attr_desc是中繼資料的聽寫。 目前包含具有 msrest 類型的 'type'，以及具有 RestAPI 編碼金鑰的 'key'。 Value 是這個 物件中的目前值。

傳回的字串將用來序列化索引鍵。 如果傳回類型是清單，則會將此視為階層式結果聽寫。

請參閱此檔案中的三個範例：

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

如果您想要 XML 序列化，您可以傳遞 kwargs is_xml=True。
deserialize

使用 RestAPI 語法剖析 str 並傳回模型。
enable_additional_properties_sending
from_dict

使用指定的金鑰擷取器剖析聽寫會傳回模型。

根據預設，請考慮金鑰擷取器 (rest_key_case_insensitive_extractor、attribute_key_case_insensitive_extractor和last_rest_key_case_insensitive_extractor)

is_xml_model
serialize

傳回會從此模型傳送至 Azure 的 JSON。

這是 as_dict (full_restapi_key_transformer別名，keep_readonly=False) 。

如果您想要 XML 序列化，您可以傳遞 kwargs is_xml=True。

as_dict

傳回可使用 json.dump 序列化的聽寫。

進階用法可以選擇性地使用回呼作為參數：

索引鍵是 Python 中使用的屬性名稱。 Attr_desc是中繼資料的聽寫。 目前包含具有 msrest 類型的 'type'，以及具有 RestAPI 編碼金鑰的 'key'。 Value 是這個 物件中的目前值。

傳回的字串將用來序列化索引鍵。 如果傳回類型是清單，則會將此視為階層式結果聽寫。

請參閱此檔案中的三個範例：

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

如果您想要 XML 序列化，您可以傳遞 kwargs is_xml=True。

as_dict(keep_readonly: bool = True, key_transformer: ~typing.Callable[[str, ~typing.Dict[str, ~typing.Any], ~typing.Any], ~typing.Any] = <function attribute_transformer>, **kwargs: ~typing.Any) -> MutableMapping[str, Any]

參數

key_transformer
<xref:function>

金鑰轉換器函式。

keep_readonly
預設值: True

傳回

與聽寫 JSON 相容的物件

傳回類型

dict

deserialize

使用 RestAPI 語法剖析 str 並傳回模型。

deserialize(data: Any, content_type: str | None = None) -> ModelType

參數

data
str
必要

使用 RestAPI 結構的 str。 JSON 預設為 。

content_type
str
預設值: None

JSON 預設會設定 application/xml if XML。

傳回

此模型的實例

例外狀況

DeserializationError if something went wrong

enable_additional_properties_sending 

enable_additional_properties_sending() -> None

from_dict

使用指定的金鑰擷取器剖析聽寫會傳回模型。

根據預設，請考慮金鑰擷取器 (rest_key_case_insensitive_extractor、attribute_key_case_insensitive_extractor和last_rest_key_case_insensitive_extractor) 

from_dict(data: Any, key_extractors: Callable[[str, Dict[str, Any], Any], Any] | None = None, content_type: str | None = None) -> ModelType

參數

data
dict
必要

使用 RestAPI 結構的聽寫

content_type
str
預設值: None

JSON 預設會設定 application/xml if XML。

key_extractors
預設值: None

傳回

此模型的實例

例外狀況

DeserializationError if something went wrong

is_xml_model 

is_xml_model() -> bool

serialize

傳回會從此模型傳送至 Azure 的 JSON。

這是 as_dict (full_restapi_key_transformer別名，keep_readonly=False) 。

如果您想要 XML 序列化，您可以傳遞 kwargs is_xml=True。

serialize(keep_readonly: bool = False, **kwargs: Any) -> MutableMapping[str, Any]

參數

keep_readonly
bool
預設值: False

如果您想要序列化唯讀屬性

傳回

與聽寫 JSON 相容的物件

傳回類型

dict

屬性

allowed_headers

允許做為跨原始來源要求一部分之標頭清單的逗號分隔字串表示。

allowed_headers: str

allowed_methods

允許來源執行之清單 HTTP 方法的逗號分隔字串表示。

allowed_methods: str

allowed_origins

允許透過 CORS 或 「*」 允許所有網域之來源網域清單的逗號分隔字串表示。

allowed_origins: str

exposed_headers

要公開給 CORS 用戶端之回應標頭清單的逗號分隔字串表示。

exposed_headers: str

max_age_in_seconds

用戶端/瀏覽器應該快取正式發行前小眾測試版回應的秒數。

max_age_in_seconds: int