本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
使用設定檔
使用情況設定檔 API 說明與中建立、更新或檢視使用情況設定檔相關的資料類型和 API AWS Glue。
資料類型
ProfileConfiguration 結構
指定管理員在 AWS Glue 使用情況設定檔中設定的工作和階段作業值。
欄位
-
SessionConfiguration– 金鑰值對的映射陣列。每個金鑰都是 UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。
每個值都是 ConfigurationObject 物件。
AWS Glue 階段作業組態參數的索引鍵值對應。
-
JobConfiguration– 金鑰值對的映射陣列。每個金鑰都是 UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。
每個值都是 ConfigurationObject 物件。
AWS Glue 工作組態參數的鍵值對應。
ConfigurationObject 結構
指定管理員為 AWS Glue 使用情況設定檔中設定的每個工作或工作階段參數設定的值。
欄位
-
DefaultValue– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組，且需符合 Custom string pattern #31。參數的預設值。
-
AllowedValues– UTF-8 字串陣列。允許的參數值清單。
-
MinValue– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組，且需符合 Custom string pattern #31。允許的參數的最小值。
-
MaxValue– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組，且需符合 Custom string pattern #31。允許的參數值上限。
UsageProfileDefinition 結構
描述 AWS Glue 使用情況設定檔。
欄位
-
Name– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。使用情況設定檔的名稱。
-
Description– 描述字串，長度不可超過 2048 個位元組，需符合URI address multi-line string pattern。使用情況設定檔的說明。
-
CreatedOn– 時間戳記。建立使用情況設定檔的日期和時間。
-
LastModifiedOn– 時間戳記。上次修改使用情況設定檔的日期和時間。
作業
CreateUsageProfile 行動（Python：創建 _ 使用 _ 配置文件）
建立 AWS Glue 使用情況設定檔。
請求
-
Name– 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。使用情況設定檔的名稱。
-
Description– 描述字串，長度不可超過 2048 個位元組，需符合URI address multi-line string pattern。使用情況設定檔的說明。
-
Configuration– 必要：ProfileConfiguration 物件。指定設定檔的工作和階段作業值的
ProfileConfiguration物件。 -
Tags– 金鑰值對的映射陣列，不超過 50 對。每個金鑰均為 UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 128 個位元組。
每個值都是 UTF-8 字串，長度不可超過 256 個位元組。
套用至使用情況設定檔的標籤清單。
回應
-
Name– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。已建立的使用情況設定檔名稱。
錯誤
InvalidInputExceptionInternalServiceExceptionAlreadyExistsExceptionOperationTimeoutExceptionResourceNumberLimitExceededExceptionOperationNotSupportedException
GetUsageProfile 行動（Python：獲取使用 _ 配置文件）
擷取有關指定 AWS Glue 使用情況設定檔的資訊。
請求
-
Name– 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。要擷取的使用情況設定檔名稱。
回應
-
Name– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。使用情況設定檔的名稱。
-
Description– 描述字串，長度不可超過 2048 個位元組，需符合URI address multi-line string pattern。使用情況設定檔的說明。
-
Configuration– ProfileConfiguration 物件。指定設定檔的工作和階段作業值的
ProfileConfiguration物件。 -
CreatedOn– 時間戳記。建立使用情況設定檔的日期和時間。
-
LastModifiedOn– 時間戳記。上次修改使用情況設定檔的日期和時間。
錯誤
InvalidInputExceptionInternalServiceExceptionEntityNotFoundExceptionOperationTimeoutExceptionOperationNotSupportedException
UpdateUsageProfile 行動（Python：更新 _ 使用 _ 配置文件）
更新 AWS Glue 使用情況設定檔。
請求
-
Name– 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。使用情況設定檔的名稱。
-
Description– 描述字串，長度不可超過 2048 個位元組，需符合URI address multi-line string pattern。使用情況設定檔的說明。
-
Configuration– 必要：ProfileConfiguration 物件。指定設定檔的工作和階段作業值的
ProfileConfiguration物件。
回應
-
Name– UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合Single-line string pattern。已更新的使用情況設定檔名稱。
錯誤
InvalidInputExceptionInternalServiceExceptionEntityNotFoundExceptionOperationTimeoutExceptionOperationNotSupportedExceptionConcurrentModificationException
DeleteUsageProfile 行動（Python：刪除使用 _ 配置文件）
刪除 AWS Glue 指定的使用情況設定檔。
請求
-
Name– 必要：UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，且需符合Single-line string pattern。要刪除的使用情況設定檔名稱。
回應
無回應參數。
錯誤
InvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionOperationNotSupportedException
ListUsageProfiles 行動（Python：列表使用 _ 配置文件）
列出所有 AWS Glue 使用情況設定檔。
請求
-
NextToken– UTF-8 字串，長度不可超過 400000 個位元組。接續符記，如果這是接續呼叫，將會包含在內。
-
MaxResults— 數字 (整數)，不小於 1 或大於 200。單一回應中要傳回的使用情況設定檔數目上限。
回應
-
Profiles– 一個 UsageProfileDefinition 物件陣列。使用情況設定檔 (
UsageProfileDefinition) 物件的清單。 -
NextToken– UTF-8 字串，長度不可超過 400000 個位元組。接續字元，如果目前清單區段不是最後一個，將會出現此接續字元。
錯誤
InternalServiceExceptionOperationTimeoutExceptionInvalidInputExceptionOperationNotSupportedException
