列出 HMAC 密钥

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

如需检索指定服务帐号的 HMAC 密钥列表，请发出一个范围限定为项目的 GET 请求。经过身份验证的用户必须对密钥所在的项目拥有 storage.hmacKeys.list 权限。

如需了解 Cloud Storage 中的 HMAC 密钥的一般信息，请参阅 HMAC 密钥。

HTTP 请求

GET https://storage.googleapis.com/?Action=ListAccessKeys&UserName=ServiceAccountEmail

查询字符串参数

参数 说明 必需
Action 要执行的 HMAC 密钥操作。 是
MaxItems 单个响应中可返回的键数上限。该服务可能会限制单个请求中可返回的最大结果数。 检查结果中是否存在 Marker 并根据需要进行分页。 否
Marker 以前返回的页面标记，表示要查看的较大部分结果。 这表示不透明，格式随时可能更改。 不支持自行构建，而不是使用先前 list 请求返回的密钥。

如果您在创建列表后先创建新的 HMAC 密钥，然后再使用Marker 以继续列出，如果新的 HMAC 密钥已存在于 HMAC 密钥命名空间内，则它将不会在后续列出结果中显示。		 否
UserName 项目中服务帐号的电子邮件地址。指定此参数将过滤列表结果，仅返回此服务帐号的密钥。 否

请求标头

以下是 GET HMAC 密钥的请求标头。

标题 说明 必需
Authorization 请求的身份验证字符串。 是
Date 请求的日期和时间。 是
Host Cloud Storage 的 URI。如需了解详情，请参阅请求端点。 是
x-goog-user-project 与请求关联的费用需要收取的项目费用。 否

响应

如果成功，此方法将返回以下结构的响应正文：

<ListAccessKeysResponse>
  <ListAccessKeysResult>
    <UserName>serviceAcc@proj.iam.gserviceaccount.com</UserName>
    <AccessKeyMetadata>
       <member>
          <UserName>serviceAccount@proj.gserviceaccount.com</UserName>
          <AccessKeyId>GOOG1EXAMPLE12345</AccessKeyId>
          <Status>Active</Status>
        <CreateDate>2019-09-03T18:53:41Z</CreateDate>
       </member>
       <member>
          <UserName>serviceAccount@proj.gserviceaccount.com</UserName>
          <AccessKeyId>GOOG1EXAMPLE54321</AccessKeyId>
          <Status>Inactive</Status>
        <CreateDate>2019-03-25T20:38:14Z</CreateDate>
       </member>
    </AccessKeyMetadata>
    <IsTruncated>true</IsTruncated>
    <Marker>AERPALERN/NEXT/TOKEN</Marker>
  </ListAccessKeysResult>
</ListAccessKeysResponse>
参数名称 值 说明
UserName string 服务帐号的电子邮件地址。
AccessKeyId string 此 HMAC 密钥的访问密钥 ID。
Status string 此 HMAC 密钥的状态。有效值包括：
  • Active：此密钥可用于对请求进行签名。
  • Inactive：使用此密钥签名的请求将被拒绝。
  • Deleted：使用此密钥签名的请求将被拒绝。
CreateDate datetime HMAC 密钥的创建时间，采用 RFC 3339 格式。
IsTruncated boolean true。 否则为 false。
Marker string 用于对大型结果集进行分页的延续令牌。 仅当 IsTruncated 为 true 时包含在响应中。在后续的 list 请求中提供此值，直到 IsTruncated 为 false。