tables 套件
套件
aio |
類別
AccountSasPermissions |
AccountSasPermissions 要與generate_account_sas搭配使用的類別 |
EntityProperty |
實體屬性。 用來在必要時明確設定 EdmType 。 需要明確輸入的值是 GUID、INT64 和 BINARY。 其他 EdmTypes 可能會明確建立為 EntityProperty 物件,但不需要。 例如,下列兩者都會在實體上建立 STRING 類型屬性:
|
RequestTooLargeError |
狀態碼為 413 的錯誤回應 - 要求實體太大 |
ResourceTypes |
指定帳戶 SAS 可存取的資源類型。 |
TableAccessPolicy |
集合所使用的存取原則類別,並取得存取原則方法。 儲存的存取原則可以指定其相關聯之共用存取簽章的開始時間、到期時間及權限。 根據您想要如何控制資源的存取權,您可以在預存存取原則內指定所有這些參數,並從共用存取簽章的 URL 中省略這些參數。 這樣做可讓您隨時修改相關聯的簽章行為,以及將它撤銷。 您也可以在儲存的存取原則中指定一個或多個存取原則參數,然後在 URL 上指定其他參數。 最後,您可以在 URL 上指定所有參數。 在此情況下,您可以使用儲存的存取原則撤銷簽章,但不修改其行為。 共用存取簽章和預存存取原則必須包含驗證簽章所需的所有欄位。 如果遺漏任何必要的欄位,要求將會失敗。 同樣地,如果同時在共用存取簽章 URL 和預存存取原則中指定某個欄位,則要求會失敗,並顯示狀態碼 400 (不正確的要求)。 |
TableAnalyticsLogging |
Azure 分析記錄設定。 必須填入所有必要的參數,才能傳送至 Azure。 |
TableClient |
要與 Azure 資料表帳戶中特定資料表互動的用戶端。 從認證建立 TableClient。 |
TableCorsRule |
CORS 是一項 HTTP 功能,可讓 Web 應用程式在某個網域下執行,以存取其他網域中的資源。 網頁瀏覽器會實作稱為同源原則的安全性限制,其可防止網頁呼叫不同網域中的 API;CORS 則提供了一個安全的方式,可讓一個網域 (原始網域) 能夠呼叫其他網域中的 API。 必須填入所有必要的參數,才能傳送至 Azure。 |
TableEntity |
具有其他中繼資料的實體字典 |
TableItem |
代表 Azure TableItem。 由 TableServiceClient.list_tables 和 TableServiceClient.query_tables 傳回。 |
TableMetrics |
依 API 分組的要求統計資料摘要,以小時或分鐘匯總為單位。 必須填入所有必要的參數,才能傳送至 Azure。 |
TableRetentionPolicy |
決定相關聯資料應保存多久的保留原則。 必須填入所有必要的參數,才能傳送至 Azure。 |
TableSasPermissions | |
TableServiceClient |
在帳戶層級與資料表服務互動的用戶端。 此用戶端提供作業來擷取和設定帳戶屬性,以及列出、建立和刪除帳戶內的資料表。 對於與特定資料表相關的作業,可以使用 函式擷取此實體的 get_table_client 用戶端。 從認證建立 TablesBaseClient。 |
TableTransactionError |
交易作業發生失敗。 |
列舉
EdmType |
EntityProperty用來表示資料表服務所要儲存之實體屬性的類型。 |
SASProtocol | |
TableErrorCode | |
TransactionOperation | |
UpdateMode |
函數
generate_account_sas
產生資料表服務的共用存取簽章。 使用傳回的簽章搭配 TableService 的 sas_token 參數。
generate_account_sas(credential: AzureNamedKeyCredential, resource_types: ResourceTypes, permission: str | AccountSasPermissions, expiry: datetime | str, **kwargs) -> str
參數
- permission
- str 或 AccountSasPermissions
這些權限與共用存取簽章相關聯。 使用者只能執行這些權限允許的作業。 除非指定參考包含此欄位之預存存取原則的識別碼,否則為必要專案。 如果已在相關聯的預存存取原則中指定,則必須省略此欄位。
共用存取簽章變成不正確時間。 除非指定參考包含此欄位之預存存取原則的識別碼,否則為必要專案。 如果已在相關聯的預存存取原則中指定,則必須省略此欄位。 Azure 一律會將值轉換成 UTC。 如果在沒有時區資訊的情況下傳入日期,則會假設為 UTC。
共用存取簽章生效的時間。 如果省略,此呼叫的開始時間會假設為儲存體服務收到要求的時間。 Azure 一律會將值轉換成 UTC。 如果在沒有時區資訊的情況下傳入日期,則會假設為 UTC。
- ip_address_or_range
- str
指定要接受要求的 IP 位址或 IP 位址範圍。 如果要求的來源 IP 位址不符合 SAS 權杖上指定的 IP 位址或位址範圍,則不會驗證要求。 例如,在 SAS 上指定 sip=168.1.5.65 或 sip=168.1.5.60-168.1.5.70 會限制這些 IP 位址的要求。
- protocol
- str 或 SASProtocol
指定要求允許的通訊協定。
傳回
共用存取簽章 (sas) 權杖。
傳回類型
generate_table_sas
產生資料表服務的共用存取簽章。 使用傳回的簽章搭配 TableService 的 sas_token 參數。
generate_table_sas(credential: AzureNamedKeyCredential, table_name: str, **kwargs) -> str
參數
- permission
- TableSasPermissions
這些權限與共用存取簽章相關聯。 使用者只能執行這些權限允許的作業。 除非指定參考包含此欄位之預存存取原則的識別碼,否則為必要專案。 如果已在相關聯的預存存取原則中指定,則必須省略此欄位。
共用存取簽章變成不正確時間。 除非指定參考包含此欄位之預存存取原則的識別碼,否則為必要專案。 如果已在相關聯的預存存取原則中指定,則必須省略此欄位。 Azure 一律會將值轉換成 UTC。 如果在沒有時區資訊的情況下傳入日期,則會假設為 UTC。
共用存取簽章生效的時間。 如果省略,此呼叫的開始時間會假設為儲存體服務收到要求的時間。 Azure 一律會將值轉換成 UTC。 如果在沒有時區資訊的情況下傳入日期,則會假設為 UTC。
- ip_address_or_range
- str
指定要接受要求的 IP 位址或 IP 位址範圍。 如果要求的來源 IP 位址不符合 SAS 權杖上指定的 IP 位址或位址範圍,則不會驗證要求。 例如,在 SAS 上指定 sip=168.1.5.65 或 sip=168.1.5.60-168.1.5.70 會限制這些 IP 位址的要求。
- policy_id
- str
存取原則識別碼。
- protocol
- str 或 SASProtocol
指定要求允許的通訊協定。
- start_rk
- str
啟動資料列索引鍵
- start_pk
- str
啟動分割區索引鍵
- end_rk
- str
結束資料列索引鍵
- end_pk
- str
結束分割區索引鍵
傳回
共用存取簽章 (sas) 權杖。