常見參數 - Amazon DocumentDB

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

常見參數

以下清單內含所有動作用來簽署 Signature 第 4 版請求的參數以及查詢字串。任何專屬於特定動作的參數則列於該動作的主題中。如需簽名版本 4 的詳細資訊,請參閱 IAM 使用者指南中的簽署AWS API 請求

Action

要執行的動作。

類型:字串

必要:是

Version

編寫請求所憑藉的 API 版本,以 YYYY-MM-DD 格式表示。

類型:字串

必要:是

X-Amz-Algorithm

建立請求簽章時所使用的雜湊演算法。

條件:當您在查詢字串中而非 HTTP 授權標頭中納入驗證資訊時,應指定此參數。

類型:字串

有效值: AWS4-HMAC-SHA256

必要:有條件

X-Amz-Credential

憑證範圍值,此為一個字串,其中包含您的存取金鑰、日期、您的目標區域、您請求的服務,以及終止字串 (“aws4_request”)。值以下列格式表示:access_key/YYYYMMDD/region/service/aws4_request。

如需詳細資訊,請參閱 IAM 使用者指南中的建立已簽署的AWS API 請求

條件:當您在查詢字串中而非 HTTP 授權標頭中納入驗證資訊時,應指定此參數。

類型:字串

必要:有條件

X-Amz-Date

用來建立簽署的日期。格式必須是 ISO 8601 基本格式 (YYYYMMDD'T'HHMMSS'Z')。例如,以下日期時間是有效的 X-Amz-Date 值:20120325T120000Z

條件: 對所有請求而言,X-Amz-Date 皆為選用,可用來覆寫用於簽署請求的日期。如果規定日期標頭採用 ISO 8601 基本格式,則不需要 X-Amz-Date。當使用 X-Amz-Date 時,其一律會覆寫日期標頭的值。如需詳細資訊,請參閱 IAM 使用者指南中的 AWSAPI 請求簽名元素

類型:字串

必要:有條件

X-Amz-Security-Token

透過呼叫AWS Security Token Service (AWS STS) 所取得的臨時安全字符。如需支援 IAM 使用者指南中的臨時安全憑證的服務清單AWS STS AWS 服務,請前往 IAM 使用者指南中的《可搭配 IAM 運作

條件:如果您使用安全憑證AWS STS,則必須納入安全字符。

類型:字串

必要:有條件

X-Amz-Signature

指定從要簽署的字串和衍生的簽署金鑰中計算出的十六進位編碼簽章。

條件:當您在查詢字串中而非 HTTP 授權標頭中納入驗證資訊時,應指定此參數。

類型:字串

必要:有條件

X-Amz-SignedHeaders

指定納入作為標準請求一部分的所有 HTTP 標頭。如需有關指定已簽署標頭的詳細資訊,請參閱 IAM 使用者指南中的建立已簽署AWS API 請求

條件:當您在查詢字串中而非 HTTP 授權標頭中納入驗證資訊時,應指定此參數。

類型:字串

必要:有條件