取得保存庫鎖定 (GET 鎖定政策) - Amazon Glacier
說明請求回應範例相關章節另請參閱

此頁面僅適用於使用 Vaults 和 2012 年原始 REST API 的 Amazon Glacier 服務的現有客戶。

如果您要尋找封存儲存解決方案，建議您在 Amazon Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 中使用 Amazon Glacier 儲存類別。 Amazon S3 若要進一步了解這些儲存選項，請參閱 Amazon Glacier 儲存類別。

自 2025 年 12 月 15 日起，Amazon Glacier （原始獨立保存庫型服務） 將不再接受新客戶，不會影響現有客戶。Amazon Glacier 是一項獨立服務，具有自己的 APIs，可將資料存放在保存庫中，並與 Amazon S3 和 Amazon S3 Glacier 儲存類別不同。您現有的資料將在 Amazon Glacier 中無限期保持安全且可存取。不需要遷移。對於低成本、長期的封存儲存， AWS 建議採用 Amazon S3 Glacier 儲存類別，透過 S3 儲存貯體型 APIs、完整 AWS 區域 可用性、降低成本 AWS 和服務整合，提供卓越的客戶體驗。如果您想要增強功能，請考慮使用我們的解決方案指南，將資料從 Amazon S3 Glacier 保存庫傳輸至 Amazon S3 Glacier 儲存類別，以遷移至 Amazon S3 Glacier 儲存類別。 AWS Amazon Glacier Amazon S3

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

取得保存庫鎖定 (GET 鎖定政策)

說明

此操作從指定的保存的 lock-policy 子資源集中擷取以下屬性：

  • 保存庫上設定的保存庫鎖定政策。

  • 保存庫鎖定的狀態，它是 InProgess 或 Locked。

  • 當鎖定 ID 過期時。鎖定 ID 用於完成保存庫鎖定程序。

  • 當保存庫鎖定啟動並進入 InProgress 狀態時。

透過呼叫 InProgress，保存庫鎖定進入 啟動保存庫鎖定 (POST 鎖定政策) 狀態。透過呼叫 Locked，保存庫鎖定進入 完成保存庫鎖定 (POST lockId) 狀態。您可呼叫 「中止保存庫鎖定」(DELETE 鎖定政策)，停止保存庫鎖定程序。如需保存庫鎖定程序的詳細資訊，請參閱Amazon Glacier 保存庫鎖定。

如果在保存庫沒有設定保存庫鎖定政策，則該作業將傳回 404 Not found 錯誤。如需保存庫鎖定政策的詳細資訊，請參閱保存庫鎖定政策。

請求

若要傳回目前保存庫鎖定政策和其他屬性，請將 HTTP GET 請求傳送到保存庫的 lock-policy 子資源的 URI，如以下語法範例所示。

語法

GET /AccountId/vaults/vaultName/lock-policy HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

注意

AccountId 值是擁有保存庫的帳戶 AWS 帳戶 ID。您可以指定 AWS 帳戶 ID 或選擇性地指定單一 '-' （連字號），在這種情況下，Amazon Glacier 會使用與用來簽署請求之登入資料相關聯的 AWS 帳戶 ID。如果您使用帳號 ID，請勿在 ID 中包含任何連字號 ('-')。

請求參數

此操作不使用請求參數。

請求標頭

此操作僅使用所有操作常見的請求標頭。如需常見請求標頭的資訊，請參閱 常見請求標題。

請求主體

此操作沒有請求內文。

回應

為了回應，Amazon Glacier (Amazon Glacier) 會在回應內文中傳回 JSON 格式的保存庫存取政策。

語法

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: length
				
{
  "Policy": "string",
  "State": "string",
  "ExpirationDate": "string",
  "CreationDate":"string"
}

回應標頭

此操作僅使用大部分回應常見的回應標頭。如需常見回應標頭的資訊，請參閱 常見回應標頭。

回應內文

回應內文包含以下 JSON 欄位。

政策

保存庫鎖定政策做為 JSON 字串，使用 "\" 做為逸出字元。

類型：字串

州

保存庫鎖定的狀態。

類型：字串

有效值：InProgress|Locked

ExpirationDate

鎖定 ID 過期的 UTC 日期和時間。如果保存庫鎖定處於 null 狀態，則此值可以為 Locked。

類型：ISO 8601 日期格式的字串表示法，例如，2013-03-20T17:03:43.221Z。

CreationDate

保存庫鎖定進入 InProgress 狀態的 UTC 日期和時間。

類型：ISO 8601 日期格式的字串表示法，例如，2013-03-20T17:03:43.221Z。

錯誤

如需 Amazon Glacier 例外狀況和錯誤訊息的相關資訊，請參閱 錯誤回應。

範例

以下範例示範如何取得保存庫鎖定政策。

範例請求

在這個範例中，將 GET 請求傳送到保存庫的 lock-policy 子資源的 URI。

GET /-/vaults/examplevault/lock-policy HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

回應範例

如果請求成功，Amazon Glacier 會在回應內文中以 JSON 字串的形式傳回保存庫存取政策。傳回的 JSON 字串使用 "\" 做為逸出字元，如 啟動保存庫鎖定 (POST 鎖定政策) 範例請求所示。不過，以下範例顯示傳回的 JSON 字串，無需逸出字元即可讀取。

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/json
Content-Length: length

{
  "Policy": "
    {
      "Version": "2012-10-17",		 	 	 
      "Statement": [
        {
          "Sid": "Define-vault-lock",
          "Principal": {
            "AWS": "arn:aws:iam::999999999999:root"
          },
          "Effect": "Deny",
          "Action": "glacier:DeleteArchive",
          "Resource": [
            "arn:aws:glacier:us-west-2:999999999999:vaults/examplevault"
          ],
          "Condition": {
            "NumericLessThanEquals": {
              "glacier:ArchiveAgeInDays": "365"
            }
          }
        }
      ]
    }
  ",
  "State": "InProgress",
  "ExpirationDate": "exampledate",
  "CreationDate": "exampledate"  
}

另請參閱

如需在語言特定的 Amazon 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明：