Enumerar claves HMAC

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

A fin de recuperar una lista de claves HMAC para la cuenta de servicio especificada, realiza una solicitud GET con alcance a un proyecto. El usuario autenticado debe tener el permiso storage.hmacKeys.list para el proyecto en el que existe la clave.

Para obtener información general sobre las claves HMAC en Cloud Storage, consulta Claves HMAC.

Solicitud HTTP

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

Parámetros de string de consulta

Parámetro Descripción Obligatorio
Action La operación de clave HMAC que se va a realizar.
MaxItems Cantidad máxima de claves que se muestran en una sola respuesta. El servicio puede limitar la cantidad máxima de resultados que se pueden mostrar en una sola solicitud. Busca un Marker en el resultado y pagina si es necesario. No
Marker Un token de página que se mostró antes y que representa parte del conjunto más grande de resultados para ver. Esto es un token opaco y el formato puede cambiar en cualquier momento. No se admite la compilación de una compilación en lugar de una que muestre una solicitud list anterior.

Si inicias una ficha y, luego, creas una clave HMAC nueva antes de usar, en Marker para continuar con la lista, no verás la nueva clave HMAC en los resultados posteriores de la lista, si ya forma parte del espacio de nombres de la clave HMAC que ya está en la lista.
No
UserName Es la dirección de correo electrónico de una cuenta de servicio en el proyecto. Si especificas este parámetro, se filtrarán los resultados de la lista para que solo se muestren las claves de esta cuenta de servicio. No

Solicita encabezados

A continuación, se muestran encabezados de solicitud de clave GET para la clave HMAC.

Header Descripción Obligatorio
Authorization La string de autenticación para la solicitud.
Date La fecha y la hora de la solicitud.
Host El URI para Cloud Storage. Para obtener más información, consulta Solicita extremos.
x-goog-user-project El proyecto al que se facturarán los cargos asociados con la solicitud. No

Respuesta

Si se ejecuta correctamente, este método muestra un cuerpo de respuesta con la siguiente estructura:

<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>
Nombre del parámetro Valor Descripción
UserName string La dirección de correo electrónico de la cuenta de servicio.
AccessKeyId string Es el ID de la clave de acceso para esta clave HMAC.
Status string El estado de esta clave HMAC. Los valores válidos son los siguientes:
  • Active: Esta clave se puede usar para firmar solicitudes.
  • Inactive: Se rechazarán las solicitudes firmadas con esta clave.
  • Deleted: Se rechazarán las solicitudes firmadas con esta clave.
CreateDate datetime La hora de creación de la clave HMAC en formato RFC 3339.
IsTruncated boolean true si hay páginas adicionales de claves. En caso contrario, false.
Marker string El token de continuación que se usa para desplazarse por los conjuntos de resultados grandes. Solo se incluye en la respuesta si IsTruncated es true. Proporciona este valor en las solicitudes list posteriores hasta que IsTruncated sea false.