Registro de auditoría de API Gateway
En este documento, se describe el registro de auditoría de API Gateway. Los servicios de Google Cloud generan registros de auditoría que registran las actividades administrativas y de acceso dentro de tus recursos de Google Cloud. Para obtener más información sobre los Registros de auditoría de Cloud, consulta los siguientes recursos:
- Tipos de registros de auditoría
- Estructura de entradas de registro de auditoría
- Almacena y enruta registros de auditoría
- Resumen de precios de Cloud Logging
- Habilita los registros de auditoría de acceso a los datos
Nombre del servicio
Los registros de auditoría de API Gateway usan el nombre de servicio apigateway.googleapis.com
.
Filtra este servicio:
protoPayload.serviceName="apigateway.googleapis.com"
Métodos por tipo de permiso
Cada permiso de IAM tiene una propiedad type
, cuyo valor es una enumeración que puede ser uno de cuatro valores: ADMIN_READ
, ADMIN_WRITE
, DATA_READ
o DATA_WRITE
. Cuando llamas a un método, API Gateway genera un registro de auditoría cuya categoría depende de la propiedad type
del permiso necesario para realizar el método.
Los métodos que requieren un permiso de IAM con el valor de propiedad type
de DATA_READ
, DATA_WRITE
o ADMIN_READ
generan registros de auditoría de acceso a los datos.
Los métodos que requieren un permiso de IAM con el valor de propiedad type
de ADMIN_WRITE
generan registros de auditoría de actividad del administrador.
Tipo de permiso | Métodos |
---|---|
ADMIN_READ |
GetIamPolicy google.cloud.apigateway.v1.ApiGatewayService.GetApi google.cloud.apigateway.v1.ApiGatewayService.GetApiConfig google.cloud.apigateway.v1.ApiGatewayService.GetGateway google.cloud.apigateway.v1.ApiGatewayService.ListApiConfigs google.cloud.apigateway.v1.ApiGatewayService.ListApis google.cloud.apigateway.v1.ApiGatewayService.ListGateways google.cloud.apigateway.v1beta.ApiGatewayService.GetApi google.cloud.apigateway.v1beta.ApiGatewayService.GetApiConfig google.cloud.apigateway.v1beta.ApiGatewayService.GetGateway google.cloud.apigateway.v1beta.ApiGatewayService.ListApiConfigs google.cloud.apigateway.v1beta.ApiGatewayService.ListApis google.cloud.apigateway.v1beta.ApiGatewayService.ListGateways google.longrunning.Operations.GetOperation google.longrunning.Operations.ListOperations |
ADMIN_WRITE |
SetIamPolicy google.cloud.apigateway.v1.ApiGatewayService.CreateApi google.cloud.apigateway.v1.ApiGatewayService.CreateApiConfig google.cloud.apigateway.v1.ApiGatewayService.CreateGateway google.cloud.apigateway.v1.ApiGatewayService.DeleteApi google.cloud.apigateway.v1.ApiGatewayService.DeleteApiConfig google.cloud.apigateway.v1.ApiGatewayService.DeleteGateway google.cloud.apigateway.v1.ApiGatewayService.UpdateApi google.cloud.apigateway.v1.ApiGatewayService.UpdateApiConfig google.cloud.apigateway.v1.ApiGatewayService.UpdateGateway google.cloud.apigateway.v1beta.ApiGatewayService.CreateApi google.cloud.apigateway.v1beta.ApiGatewayService.CreateApiConfig google.cloud.apigateway.v1beta.ApiGatewayService.CreateGateway google.cloud.apigateway.v1beta.ApiGatewayService.DeleteApi google.cloud.apigateway.v1beta.ApiGatewayService.DeleteApiConfig google.cloud.apigateway.v1beta.ApiGatewayService.DeleteGateway google.cloud.apigateway.v1beta.ApiGatewayService.UpdateApi google.cloud.apigateway.v1beta.ApiGatewayService.UpdateApiConfig google.cloud.apigateway.v1beta.ApiGatewayService.UpdateGateway google.longrunning.Operations.CancelOperation google.longrunning.Operations.DeleteOperation |
Registros de auditoría de la interfaz de la API
Si quieres obtener información sobre cómo y qué permisos se evalúan para cada método, consulta la documentación de Identity and Access Management para API Gateway.
google.cloud.apigateway.v1.ApiGatewayService
Los siguientes registros de auditoría están asociados con métodos que pertenecen a
google.cloud.apigateway.v1.ApiGatewayService
.
CreateApi
- Método:
google.cloud.apigateway.v1.ApiGatewayService.CreateApi
- Tipo de registro de auditoría: actividad del administrador
- Permisos:
apigateway.apis.create - ADMIN_WRITE
- El método es una operación de larga duración o de transmisión:
operación de larga duración
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.CreateApi"
CreateApiConfig
- Método:
google.cloud.apigateway.v1.ApiGatewayService.CreateApiConfig
- Tipo de registro de auditoría: actividad del administrador
- Permisos:
apigateway.apiconfigs.create - ADMIN_WRITE
- El método es una operación de larga duración o de transmisión:
operación de larga duración
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.CreateApiConfig"
CreateGateway
- Método:
google.cloud.apigateway.v1.ApiGatewayService.CreateGateway
- Tipo de registro de auditoría: actividad del administrador
- Permisos:
apigateway.gateways.create - ADMIN_WRITE
- El método es una operación de larga duración o de transmisión:
operación de larga duración
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.CreateGateway"
DeleteApi
- Método:
google.cloud.apigateway.v1.ApiGatewayService.DeleteApi
- Tipo de registro de auditoría: actividad del administrador
- Permisos:
apigateway.apis.delete - ADMIN_WRITE
- El método es una operación de larga duración o de transmisión:
operación de larga duración
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.DeleteApi"
DeleteApiConfig
- Método:
google.cloud.apigateway.v1.ApiGatewayService.DeleteApiConfig
- Tipo de registro de auditoría: actividad del administrador
- Permisos:
apigateway.apiconfigs.delete - ADMIN_WRITE
- El método es una operación de larga duración o de transmisión:
operación de larga duración
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.DeleteApiConfig"
DeleteGateway
- Método:
google.cloud.apigateway.v1.ApiGatewayService.DeleteGateway
- Tipo de registro de auditoría: actividad del administrador
- Permisos:
apigateway.gateways.delete - ADMIN_WRITE
- El método es una operación de larga duración o de transmisión:
operación de larga duración
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.DeleteGateway"
GetApi
- Método:
google.cloud.apigateway.v1.ApiGatewayService.GetApi
- Tipo de registro de auditoría: acceso a los datos
- Permisos:
apigateway.apis.get - ADMIN_READ
- El método es una operación de larga duración o de transmisión:
no.
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.GetApi"
GetApiConfig
- Método:
google.cloud.apigateway.v1.ApiGatewayService.GetApiConfig
- Tipo de registro de auditoría: acceso a los datos
- Permisos:
apigateway.apiconfigs.get - ADMIN_READ
- El método es una operación de larga duración o de transmisión:
no.
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.GetApiConfig"
GetGateway
- Método:
google.cloud.apigateway.v1.ApiGatewayService.GetGateway
- Tipo de registro de auditoría: acceso a los datos
- Permisos:
apigateway.gateways.get - ADMIN_READ
- El método es una operación de larga duración o de transmisión:
no.
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.GetGateway"
ListApiConfigs
- Método:
google.cloud.apigateway.v1.ApiGatewayService.ListApiConfigs
- Tipo de registro de auditoría: acceso a los datos
- Permisos:
apigateway.apiconfigs.list - ADMIN_READ
- El método es una operación de larga duración o de transmisión:
no.
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.ListApiConfigs"
ListApis
- Método:
google.cloud.apigateway.v1.ApiGatewayService.ListApis
- Tipo de registro de auditoría: acceso a los datos
- Permisos:
apigateway.apis.list - ADMIN_READ
- El método es una operación de larga duración o de transmisión:
no.
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.ListApis"
ListGateways
- Método:
google.cloud.apigateway.v1.ApiGatewayService.ListGateways
- Tipo de registro de auditoría: acceso a los datos
- Permisos:
apigateway.gateways.list - ADMIN_READ
- El método es una operación de larga duración o de transmisión:
no.
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.ListGateways"
UpdateApi
- Método:
google.cloud.apigateway.v1.ApiGatewayService.UpdateApi
- Tipo de registro de auditoría: actividad del administrador
- Permisos:
apigateway.apis.update - ADMIN_WRITE
- El método es una operación de larga duración o de transmisión:
operación de larga duración
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.UpdateApi"
UpdateApiConfig
- Método:
google.cloud.apigateway.v1.ApiGatewayService.UpdateApiConfig
- Tipo de registro de auditoría: actividad del administrador
- Permisos:
apigateway.apiconfigs.update - ADMIN_WRITE
- El método es una operación de larga duración o de transmisión:
operación de larga duración
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.UpdateApiConfig"
UpdateGateway
- Método:
google.cloud.apigateway.v1.ApiGatewayService.UpdateGateway
- Tipo de registro de auditoría: actividad del administrador
- Permisos:
apigateway.gateways.update - ADMIN_WRITE
- El método es una operación de larga duración o de transmisión:
operación de larga duración
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1.ApiGatewayService.UpdateGateway"
google.cloud.apigateway.v1beta.ApiGatewayService
Los siguientes registros de auditoría están asociados con métodos que pertenecen a
google.cloud.apigateway.v1beta.ApiGatewayService
.
CreateApi
- Método:
google.cloud.apigateway.v1beta.ApiGatewayService.CreateApi
- Tipo de registro de auditoría: actividad del administrador
- Permisos:
apigateway.apis.create - ADMIN_WRITE
- El método es una operación de larga duración o de transmisión:
operación de larga duración
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.CreateApi"
CreateApiConfig
- Método:
google.cloud.apigateway.v1beta.ApiGatewayService.CreateApiConfig
- Tipo de registro de auditoría: actividad del administrador
- Permisos:
apigateway.apiconfigs.create - ADMIN_WRITE
- El método es una operación de larga duración o de transmisión:
operación de larga duración
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.CreateApiConfig"
CreateGateway
- Método:
google.cloud.apigateway.v1beta.ApiGatewayService.CreateGateway
- Tipo de registro de auditoría: actividad del administrador
- Permisos:
apigateway.gateways.create - ADMIN_WRITE
- El método es una operación de larga duración o de transmisión:
operación de larga duración
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.CreateGateway"
DeleteApi
- Método:
google.cloud.apigateway.v1beta.ApiGatewayService.DeleteApi
- Tipo de registro de auditoría: actividad del administrador
- Permisos:
apigateway.apis.delete - ADMIN_WRITE
- El método es una operación de larga duración o de transmisión:
operación de larga duración
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.DeleteApi"
DeleteApiConfig
- Método:
google.cloud.apigateway.v1beta.ApiGatewayService.DeleteApiConfig
- Tipo de registro de auditoría: actividad del administrador
- Permisos:
apigateway.apiconfigs.delete - ADMIN_WRITE
- El método es una operación de larga duración o de transmisión:
operación de larga duración
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.DeleteApiConfig"
DeleteGateway
- Método:
google.cloud.apigateway.v1beta.ApiGatewayService.DeleteGateway
- Tipo de registro de auditoría: actividad del administrador
- Permisos:
apigateway.gateways.delete - ADMIN_WRITE
- El método es una operación de larga duración o de transmisión:
operación de larga duración
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.DeleteGateway"
GetApi
- Método:
google.cloud.apigateway.v1beta.ApiGatewayService.GetApi
- Tipo de registro de auditoría: acceso a los datos
- Permisos:
apigateway.apis.get - ADMIN_READ
- El método es una operación de larga duración o de transmisión:
no.
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.GetApi"
GetApiConfig
- Método:
google.cloud.apigateway.v1beta.ApiGatewayService.GetApiConfig
- Tipo de registro de auditoría: acceso a los datos
- Permisos:
apigateway.apiconfigs.get - ADMIN_READ
- El método es una operación de larga duración o de transmisión:
no.
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.GetApiConfig"
GetGateway
- Método:
google.cloud.apigateway.v1beta.ApiGatewayService.GetGateway
- Tipo de registro de auditoría: acceso a los datos
- Permisos:
apigateway.gateways.get - ADMIN_READ
- El método es una operación de larga duración o de transmisión:
no.
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.GetGateway"
ListApiConfigs
- Método:
google.cloud.apigateway.v1beta.ApiGatewayService.ListApiConfigs
- Tipo de registro de auditoría: acceso a los datos
- Permisos:
apigateway.apiconfigs.list - ADMIN_READ
- El método es una operación de larga duración o de transmisión:
no.
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.ListApiConfigs"
ListApis
- Método:
google.cloud.apigateway.v1beta.ApiGatewayService.ListApis
- Tipo de registro de auditoría: acceso a los datos
- Permisos:
apigateway.apis.list - ADMIN_READ
- El método es una operación de larga duración o de transmisión:
no.
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.ListApis"
ListGateways
- Método:
google.cloud.apigateway.v1beta.ApiGatewayService.ListGateways
- Tipo de registro de auditoría: acceso a los datos
- Permisos:
apigateway.gateways.list - ADMIN_READ
- El método es una operación de larga duración o de transmisión:
no.
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.ListGateways"
UpdateApi
- Método:
google.cloud.apigateway.v1beta.ApiGatewayService.UpdateApi
- Tipo de registro de auditoría: actividad del administrador
- Permisos:
apigateway.apis.update - ADMIN_WRITE
- El método es una operación de larga duración o de transmisión:
operación de larga duración
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.UpdateApi"
UpdateApiConfig
- Método:
google.cloud.apigateway.v1beta.ApiGatewayService.UpdateApiConfig
- Tipo de registro de auditoría: actividad del administrador
- Permisos:
apigateway.apiconfigs.update - ADMIN_WRITE
- El método es una operación de larga duración o de transmisión:
operación de larga duración
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.UpdateApiConfig"
UpdateGateway
- Método:
google.cloud.apigateway.v1beta.ApiGatewayService.UpdateGateway
- Tipo de registro de auditoría: actividad del administrador
- Permisos:
apigateway.gateways.update - ADMIN_WRITE
- El método es una operación de larga duración o de transmisión:
operación de larga duración
- Filtra para este método:
protoPayload.methodName="google.cloud.apigateway.v1beta.ApiGatewayService.UpdateGateway"
google.iam.v1.IAMPolicy
Los siguientes registros de auditoría están asociados con métodos que pertenecen a
google.iam.v1.IAMPolicy
.
GetIamPolicy
- Método:
GetIamPolicy
- Tipo de registro de auditoría: acceso a los datos
- Permisos:
apigateway.apis.getIamPolicy - ADMIN_READ
apigateway.gateways.getIamPolicy - ADMIN_READ
- El método es una operación de larga duración o de transmisión:
no.
- Filtra para este método:
protoPayload.methodName="GetIamPolicy"
SetIamPolicy
- Método:
SetIamPolicy
- Tipo de registro de auditoría: actividad del administrador
- Permisos:
apigateway.apiconfigs.setIamPolicy - ADMIN_WRITE
apigateway.apis.setIamPolicy - ADMIN_WRITE
apigateway.gateways.setIamPolicy - ADMIN_WRITE
- El método es una operación de larga duración o de transmisión:
no.
- Filtra para este método:
protoPayload.methodName="SetIamPolicy"
google.longrunning.Operations
Los siguientes registros de auditoría están asociados con métodos que pertenecen a
google.longrunning.Operations
.
CancelOperation
- Método:
google.longrunning.Operations.CancelOperation
- Tipo de registro de auditoría: actividad del administrador
- Permisos:
apigateway.operations.cancel - ADMIN_WRITE
- El método es una operación de larga duración o de transmisión:
no.
- Filtra para este método:
protoPayload.methodName="google.longrunning.Operations.CancelOperation"
DeleteOperation
- Método:
google.longrunning.Operations.DeleteOperation
- Tipo de registro de auditoría: actividad del administrador
- Permisos:
apigateway.operations.delete - ADMIN_WRITE
- El método es una operación de larga duración o de transmisión:
no.
- Filtra para este método:
protoPayload.methodName="google.longrunning.Operations.DeleteOperation"
GetOperation
- Método:
google.longrunning.Operations.GetOperation
- Tipo de registro de auditoría: acceso a los datos
- Permisos:
apigateway.operations.get - ADMIN_READ
- El método es una operación de larga duración o de transmisión:
no.
- Filtra para este método:
protoPayload.methodName="google.longrunning.Operations.GetOperation"
ListOperations
- Método:
google.longrunning.Operations.ListOperations
- Tipo de registro de auditoría: acceso a los datos
- Permisos:
apigateway.operations.list - ADMIN_READ
- El método es una operación de larga duración o de transmisión:
no.
- Filtra para este método:
protoPayload.methodName="google.longrunning.Operations.ListOperations"
Métodos que no producen registros de auditoría
Es posible que un método no produzca registros de auditoría por uno o más de los siguientes motivos:
- Es un método de gran volumen que implica costos significativos de generación y almacenamiento de registros.
- Tiene un valor de auditoría bajo.
- Otro registro de auditoría o de plataforma ya proporciona cobertura del método.
Los siguientes métodos no producen registros de auditoría:
google.cloud.location.Locations.GetLocation
google.cloud.location.Locations.ListLocations
google.longrunning.Operations.WaitOperation