此页面由 Cloud Translation API 翻译。
Switch to English

列出 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 用于对大型结果集进行分页的延续令牌。 仅当 IsTruncatedtrue 时包含在响应中。在后续的 list 请求中提供此值,直到 IsTruncatedfalse