ListLegalHolds - AWS Backup
请求语法URI 请求参数请求体响应语法响应元素错误另请参阅

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

ListLegalHolds

此操作会返回有关有效和先前法定保留的元数据。

请求语法

GET /legal-holds/?maxResults=MaxResults&nextToken=NextToken HTTP/1.1

URI 请求参数

请求使用以下 URI 参数。

MaxResults

要返回的资源列表项的最大数量。

有效范围：最小值为 1。最大值为 1000。

NextToken

所返回资源的部分列表的后续下一个项目。例如，如果请求返回 MaxResults 数量的资源，则 NextToken 允许您从下一个令牌指向的位置开始返回列表中的更多项目。

请求体

该请求没有请求正文。

响应语法

HTTP/1.1 200
Content-type: application/json

{
   "LegalHolds": [ 
      { 
         "CancellationDate": number,
         "CreationDate": number,
         "Description": "string",
         "LegalHoldArn": "string",
         "LegalHoldId": "string",
         "Status": "string",
         "Title": "string"
      }
   ],
   "NextToken": "string"
}

响应元素

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

LegalHolds

这是返回的法定保留（包括有效和先前保留）的数组。

类型：LegalHold 对象数组

NextToken

所返回资源的部分列表的后续下一个项目。例如，如果请求返回 MaxResults 数量的资源，则 NextToken 允许您从下一个令牌指向的位置开始返回列表中的更多项目。

类型：字符串

错误

有关所有操作返回的常见错误的信息，请参阅常见错误。

InvalidParameterValueException

表示参数的值有问题。例如，该值超出了范围。

HTTP 状态代码：400

ServiceUnavailableException

由于服务器发生临时故障而导致请求失败。

HTTP 状态代码：500

另请参阅

有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容：