本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
常見參數
以下清單內含所有動作用來簽署 Signature 第 4 版請求的參數以及查詢字串。任何專屬於特定動作的參數則列於該動作的主題中。如需有關 Signature 第 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 使用者指南》中的 AWS API 請求簽章的元素。
類型:字串
必要:有條件
- X-Amz-Security-Token
-
透過呼叫 AWS Security Token Service (AWS STS) 所取得的臨時安全字符。如需支援 AWS STS 的臨時安全憑證的服務清單,請參閱《IAM 使用者指南》中的可搭配 IAM 運作的 AWS 服務。
條件:如果您使用 AWS STS 的臨時安全憑證,則必須納入安全字符。
類型:字串
必要:有條件
- X-Amz-Signature
-
指定從要簽署的字串和衍生的簽署金鑰中計算出的十六進位編碼簽章。
條件:當您在查詢字串中而非 HTTP 授權標頭中納入驗證資訊時,應指定此參數。
類型:字串
必要:有條件
- X-Amz-SignedHeaders
-
指定納入作為標準請求一部分的所有 HTTP 標頭。如需有關指定已簽署的標頭之詳細資訊,請參閱《IAM 使用者指南》中的建立已簽署的 AWS API 請求。
條件:當您在查詢字串中而非 HTTP 授權標頭中納入驗證資訊時,應指定此參數。
類型:字串
必要:有條件