authentication.subject.name filter is not available in exports because it can contain email addresses that are personally identifiable information (PII).
Prerequisites
- Web console
- CLI
- Go SDK
- Python SDK
- JavaScript SDK
- Make sure you are in a group that has the
adminorauditlogs.audit-event-viewerrole within your tenant to view events. To export events, use a group that has theadminorauditlogs.audit-event-exporterrole and make sure that you have thestorage.uploaderrole for the destination bucket. You can check group membership in the Administration → IAM section of the web console. - Identify the regions to search for the audit events you need and the regions to export audit events from.
- Install and configure the Nebius AI Cloud CLI.
- Make sure you are in a group that has the
adminorauditlogs.audit-event-viewerrole within your tenant to view events. To export events, use a group that has theadminorauditlogs.audit-event-exporterrole and make sure that you have thestorage.uploaderrole for the destination bucket. You can check group membership in the Administration → IAM section of the web console. - Identify the regions to search for the audit events you need and the regions to export audit events from.
- Install and initialize the Nebius SDK for Go.
- Make sure you are in a group that has the
adminorauditlogs.audit-event-viewerrole within your tenant to view events. To export events, use a group that has theadminorauditlogs.audit-event-exporterrole and make sure that you have thestorage.uploaderrole for the destination bucket. You can check group membership in the Administration → IAM section of the web console. - Identify the regions to search for the audit events you need and the regions to export audit events from.
- Install and initialize the Nebius SDK for Python.
- Make sure you are in a group that has the
adminorauditlogs.audit-event-viewerrole within your tenant to view events. To export events, use a group that has theadminorauditlogs.audit-event-exporterrole and make sure that you have thestorage.uploaderrole for the destination bucket. You can check group membership in the Administration → IAM section of the web console. - Identify the regions to search for the audit events you need and the regions to export audit events from.
- Install and initialize the Nebius SDK for JavaScript.
- Make sure you are in a group that has the
adminorauditlogs.audit-event-viewerrole within your tenant to view events. To export events, use a group that has theadminorauditlogs.audit-event-exporterrole and make sure that you have thestorage.uploaderrole for the destination bucket. You can check group membership in the Administration → IAM section of the web console. - Identify the regions to search for the audit events you need and the regions to export audit events from.
Filter operators
Supported operators include:=equals!=not equals:containsregexregular expression match
How to filter events in the web console
To narrow down the events, you can use the following filters:- Event JSONs: Search in JSON field values, but not a full-text search for a substring in the JSON event description. For example, if the JSON contains a
namefield with the valueTest User, this filter findsTest Userbut cannot find"name": "Test User". - Action: Standard actions are
CREATE,UPDATEorDELETE. Actions can differ by service. For example, for Compute resources, you can also specifySTOPandSTART. - Ancestor ID: ID of the resource ancestor, starting from the tenant.
- Ancestor name: Name of the resource ancestor, starting from the tenant.
- Masked token: Access token that was used to authorize the event. You can enter a part of the token here.
- Resource ID: ID of the resource on which actions were performed. For example, a Compute disk (
computedisk-***), a service account (serviceaccount-***), etc. - Resource name: Name of the resource on which actions were performed.
- Resource type: Type of the resource on which actions were performed. For example,
computediskormk8scluster. - Service: Service in which the actions were performed.
- Event class: String in the
ai.nebius.<service_name>.<resource_type>.<action>format. It includes theai.nebiusprefix and refers to a Nebius AI Cloud service, type of resource in it, and the action performed on this resource, for example,ai.nebius.compute.computeinstance.delete. - Static key ID: ID of the static key that was used to authorize the event.
- Status: Status of the operation associated with the event.
- Subject ID: ID of a user account or a service account that performed actions. The formats of user account IDs and service account IDs are
tenantuseraccount-***andserviceaccount-***. - Subject name: Name of a user account or a service account that performed actions. This filter is not available for exports.
= in a filter to choose if the events should contain or exclude the values you enter.
How to filter events by using the CLI or an SDK
To narrow down the events, you can use one or more of the following filters. For the other parameters of a list request, see Viewing events in Audit Logs. For the other parameters of an export, see How to export audit events to Object Storage.-
Resource ID or type
The type or ID of the resource on which actions were performed. ID formats include, for example, a
computeinstance-***for a Compute virtual machine,computedisk-***for a Compute disk,serviceaccount-***for a service account.- CLI
- Go SDK
- Python SDK
- JavaScript SDK
List events by resource type:List events for a resource ID:nebius audit v2 audit-event list \ --parent-id <tenant_ID> \ --start <time_in_ISO_8601> --end <time_in_ISO_8601> \ --filter "resource.metadata.type='computeinstance'" \ --region <region_ID>Start an export by resource type:nebius audit v2 audit-event list \ --parent-id <tenant_ID> \ --start <time_in_ISO_8601> --end <time_in_ISO_8601> \ --filter "resource.metadata.id='computeinstance-***'" \ --region <region_ID>Start an export for a resource ID:nebius audit v2 audit-event-export start \ --parent-id <tenant_ID> \ --params-from <time_in_ISO_8601> --params-to <time_in_ISO_8601> \ --params-event-type <control_plane|data_plane> \ --nebius-object-storage-bucket-by-id-id <bucket_ID> \ --nebius-object-storage-object-prefix <prefix> \ --params-filter "resource.metadata.type='computeinstance'" \ --region <region_ID>nebius audit v2 audit-event-export start \ --parent-id <tenant_ID> \ --params-from <time_in_ISO_8601> --params-to <time_in_ISO_8601> \ --params-event-type <control_plane|data_plane> \ --nebius-object-storage-bucket-by-id-id <bucket_ID> \ --nebius-object-storage-object-prefix <prefix> \ --params-filter "resource.metadata.id='computeinstance-***'" \ --region <region_ID>List events by resource type:List events for a resource ID:resourceTypeStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } resourceTypeEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } resourceTypeFilter := "resource.metadata.type='computeinstance'" resourceTypeService := sdk.Services().Audit().V2().AuditEvent() resourceTypeEvents, err := resourceTypeService.List( ctx, &audit.ListAuditEventRequest{ ParentId: "<tenant_ID>", Start: timestamppb.New(resourceTypeStart), End: timestamppb.New(resourceTypeEnd), Filter: resourceTypeFilter, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("list audit events: %w", err) } fmt.Println(resourceTypeEvents)Start an export by resource type:resourceIDStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } resourceIDEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } resourceIDFilter := "resource.metadata.id='" + "computeinstance-***" + "'" resourceIDService := sdk.Services().Audit().V2().AuditEvent() resourceIDEvents, err := resourceIDService.List( ctx, &audit.ListAuditEventRequest{ ParentId: "<tenant_ID>", Start: timestamppb.New(resourceIDStart), End: timestamppb.New(resourceIDEnd), Filter: resourceIDFilter, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("list audit events: %w", err) } fmt.Println(resourceIDEvents)Start an export for a resource ID:typeExportStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } typeExportEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } typeExportFilter := "resource.metadata.type='computeinstance'" typeExportBucket := &audit.NebiusObjectStorageDestination_BucketById{ BucketById: &audit.BucketById{Id: "<bucket_ID>"}, } typeExportStorage := &audit.NebiusObjectStorageDestination{ ObjectPrefix: "<prefix>", Bucket: typeExportBucket, } typeExportDestination := &audit.AuditEventExportSpec_NebiusObjectStorage{ NebiusObjectStorage: typeExportStorage, } typeExportService := sdk.Services().Audit().V2().AuditEventExport() typeExportOperation, err := typeExportService.Start( ctx, &audit.StartRequest{ Metadata: &common.ResourceMetadata{ ParentId: "<tenant_ID>", }, Spec: &audit.AuditEventExportSpec{ Params: &audit.AuditEventExportParams{ From: timestamppb.New(typeExportStart), To: timestamppb.New(typeExportEnd), EventType: audit.EventType_CONTROL_PLANE, Filter: typeExportFilter, }, ExportDestination: typeExportDestination, }, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("start audit export: %w", err) } typeExportOperation, err = typeExportOperation.Wait(ctx) if err != nil { return fmt.Errorf("wait for audit export: %w", err) }idExportStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } idExportEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } idExportFilter := "resource.metadata.id='" + "computeinstance-***" + "'" idExportBucket := &audit.NebiusObjectStorageDestination_BucketById{ BucketById: &audit.BucketById{Id: "<bucket_ID>"}, } idExportStorage := &audit.NebiusObjectStorageDestination{ ObjectPrefix: "<prefix>", Bucket: idExportBucket, } idExportDestination := &audit.AuditEventExportSpec_NebiusObjectStorage{ NebiusObjectStorage: idExportStorage, } idExportService := sdk.Services().Audit().V2().AuditEventExport() idExportOperation, err := idExportService.Start( ctx, &audit.StartRequest{ Metadata: &common.ResourceMetadata{ ParentId: "<tenant_ID>", }, Spec: &audit.AuditEventExportSpec{ Params: &audit.AuditEventExportParams{ From: timestamppb.New(idExportStart), To: timestamppb.New(idExportEnd), EventType: audit.EventType_CONTROL_PLANE, Filter: idExportFilter, }, ExportDestination: idExportDestination, }, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("start audit export: %w", err) } idExportOperation, err = idExportOperation.Wait(ctx) if err != nil { return fmt.Errorf("wait for audit export: %w", err) }List events by resource type:List events for a resource ID:event_service = AuditEventServiceClient(sdk) event_filter = ( "resource.metadata.type='computeinstance'" ) events = await event_service.list( ListAuditEventRequest( parent_id="<tenant_ID>", start=datetime.fromisoformat("<time_in_ISO_8601>"), end=datetime.fromisoformat("<time_in_ISO_8601>"), filter=event_filter, region="<region_ID>", ), ) print(events)Start an export by resource type:event_service = AuditEventServiceClient(sdk) event_filter = ( "resource.metadata.id='" + "computeinstance-***" + "'" ) events = await event_service.list( ListAuditEventRequest( parent_id="<tenant_ID>", start=datetime.fromisoformat("<time_in_ISO_8601>"), end=datetime.fromisoformat("<time_in_ISO_8601>"), filter=event_filter, region="<region_ID>", ), ) print(events)Start an export for a resource ID:export_service = AuditEventExportServiceClient(sdk) export_filter = ( "resource.metadata.type='computeinstance'" ) export_operation = await export_service.start( StartRequest( metadata=ResourceMetadata(parent_id="<tenant_ID>"), spec=AuditEventExportSpec( params=AuditEventExportParams( from_=datetime.fromisoformat("<time_in_ISO_8601>"), to=datetime.fromisoformat("<time_in_ISO_8601>"), event_type=EventType.CONTROL_PLANE, filter=export_filter, ), nebius_object_storage=NebiusObjectStorageDestination( object_prefix="<prefix>", bucket_by_id=BucketById(id="<bucket_ID>"), ), ), region="<region_ID>", ), ) await export_operation.wait()export_service = AuditEventExportServiceClient(sdk) export_filter = ( "resource.metadata.id='" + "computeinstance-***" + "'" ) export_operation = await export_service.start( StartRequest( metadata=ResourceMetadata(parent_id="<tenant_ID>"), spec=AuditEventExportSpec( params=AuditEventExportParams( from_=datetime.fromisoformat("<time_in_ISO_8601>"), to=datetime.fromisoformat("<time_in_ISO_8601>"), event_type=EventType.CONTROL_PLANE, filter=export_filter, ), nebius_object_storage=NebiusObjectStorageDestination( object_prefix="<prefix>", bucket_by_id=BucketById(id="<bucket_ID>"), ), ), region="<region_ID>", ), ) await export_operation.wait()List events by resource type:List events for a resource ID:const resourceTypeService = new AuditEventService(sdk); const resourceTypeFilter = "resource.metadata.type='computeinstance'"; const resourceTypeEvents = await resourceTypeService.list( ListAuditEventRequest.create({ parentId: "<tenant_ID>", start: dayjs("<time_in_ISO_8601>"), end: dayjs("<time_in_ISO_8601>"), filter: resourceTypeFilter, region: "<region_ID>", }), ).result; console.log(resourceTypeEvents);Start an export by resource type:const resourceIDService = new AuditEventService(sdk); const resourceIDFilter = "resource.metadata.id='" + "computeinstance-***" + "'"; const resourceIDEvents = await resourceIDService.list( ListAuditEventRequest.create({ parentId: "<tenant_ID>", start: dayjs("<time_in_ISO_8601>"), end: dayjs("<time_in_ISO_8601>"), filter: resourceIDFilter, region: "<region_ID>", }), ).result; console.log(resourceIDEvents);Start an export for a resource ID:const typeExportService = new AuditEventExportService(sdk); const typeExportFilter = "resource.metadata.type='computeinstance'"; const typeExportOperation = await typeExportService.start( StartRequest.create({ metadata: { parentId: "<tenant_ID>" }, spec: { params: { from: dayjs("<time_in_ISO_8601>"), to: dayjs("<time_in_ISO_8601>"), eventType: EventType.CONTROL_PLANE, filter: typeExportFilter, }, exportDestination: { $case: "nebiusObjectStorage", nebiusObjectStorage: { objectPrefix: "<prefix>", bucket: { $case: "bucketById", bucketById: { id: "<bucket_ID>" }, }, }, }, }, region: "<region_ID>", }), ).result; await typeExportOperation.wait();const idExportService = new AuditEventExportService(sdk); const idExportFilter = "resource.metadata.id='" + "computeinstance-***" + "'"; const idExportOperation = await idExportService.start( StartRequest.create({ metadata: { parentId: "<tenant_ID>" }, spec: { params: { from: dayjs("<time_in_ISO_8601>"), to: dayjs("<time_in_ISO_8601>"), eventType: EventType.CONTROL_PLANE, filter: idExportFilter, }, exportDestination: { $case: "nebiusObjectStorage", nebiusObjectStorage: { objectPrefix: "<prefix>", bucket: { $case: "bucketById", bucketById: { id: "<bucket_ID>" }, }, }, }, }, region: "<region_ID>", }), ).result; await idExportOperation.wait(); -
Resource ancestor ID or name
The ID or name of the resource ancestor, starting from the tenant. For example, you can check all the actions performed on virtual machines in one of your projects by specifying the project ID or name.
- CLI
- Go SDK
- Python SDK
- JavaScript SDK
List events by ancestor ID:List events by ancestor name:nebius audit v2 audit-event list \ --parent-id <tenant_ID> \ --start <time_in_ISO_8601> --end <time_in_ISO_8601> \ --filter "resource.hierarchy.id:'<ancestor_ID>'" \ --region <region_ID>Start an export by ancestor ID:nebius audit v2 audit-event list \ --parent-id <tenant_ID> \ --start <time_in_ISO_8601> --end <time_in_ISO_8601> \ --filter "resource.hierarchy.name:'<ancestor_name>'" \ --region <region_ID>Start an export by ancestor name:nebius audit v2 audit-event-export start \ --parent-id <tenant_ID> \ --params-from <time_in_ISO_8601> --params-to <time_in_ISO_8601> \ --params-event-type <control_plane|data_plane> \ --nebius-object-storage-bucket-by-id-id <bucket_ID> \ --nebius-object-storage-object-prefix <prefix> \ --params-filter "resource.hierarchy.id:'<ancestor_ID>'" \ --region <region_ID>nebius audit v2 audit-event-export start \ --parent-id <tenant_ID> \ --params-from <time_in_ISO_8601> --params-to <time_in_ISO_8601> \ --params-event-type <control_plane|data_plane> \ --nebius-object-storage-bucket-by-id-id <bucket_ID> \ --nebius-object-storage-object-prefix <prefix> \ --params-filter "resource.hierarchy.name:'<ancestor_name>'" \ --region <region_ID>List events by ancestor ID:List events by ancestor name:ancestorIDStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } ancestorIDEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } ancestorIDFilter := "resource.hierarchy.id:'" + "<ancestor_ID>" + "'" ancestorIDService := sdk.Services().Audit().V2().AuditEvent() ancestorIDEvents, err := ancestorIDService.List( ctx, &audit.ListAuditEventRequest{ ParentId: "<tenant_ID>", Start: timestamppb.New(ancestorIDStart), End: timestamppb.New(ancestorIDEnd), Filter: ancestorIDFilter, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("list audit events: %w", err) } fmt.Println(ancestorIDEvents)Start an export by ancestor ID:ancestorNameStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } ancestorNameEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } ancestorNameFilter := "resource.hierarchy.name:'" + "<ancestor_name>" + "'" ancestorNameService := sdk.Services().Audit().V2().AuditEvent() ancestorNameEvents, err := ancestorNameService.List( ctx, &audit.ListAuditEventRequest{ ParentId: "<tenant_ID>", Start: timestamppb.New(ancestorNameStart), End: timestamppb.New(ancestorNameEnd), Filter: ancestorNameFilter, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("list audit events: %w", err) } fmt.Println(ancestorNameEvents)Start an export by ancestor name:ancestorExportStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } ancestorExportEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } ancestorExportFilter := "resource.hierarchy.id:'" + "<ancestor_ID>" + "'" ancestorExportBucket := &audit.NebiusObjectStorageDestination_BucketById{ BucketById: &audit.BucketById{Id: "<bucket_ID>"}, } ancestorExportStorage := &audit.NebiusObjectStorageDestination{ ObjectPrefix: "<prefix>", Bucket: ancestorExportBucket, } ancestorExportDestination := &audit.AuditEventExportSpec_NebiusObjectStorage{ NebiusObjectStorage: ancestorExportStorage, } ancestorExportService := sdk.Services().Audit().V2(). AuditEventExport() ancestorExportOperation, err := ancestorExportService.Start( ctx, &audit.StartRequest{ Metadata: &common.ResourceMetadata{ ParentId: "<tenant_ID>", }, Spec: &audit.AuditEventExportSpec{ Params: &audit.AuditEventExportParams{ From: timestamppb.New(ancestorExportStart), To: timestamppb.New(ancestorExportEnd), EventType: audit.EventType_CONTROL_PLANE, Filter: ancestorExportFilter, }, ExportDestination: ancestorExportDestination, }, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("start audit export: %w", err) } ancestorExportOperation, err = ancestorExportOperation.Wait(ctx) if err != nil { return fmt.Errorf("wait for audit export: %w", err) }nameExportStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } nameExportEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } nameExportFilter := "resource.hierarchy.name:'" + "<ancestor_name>" + "'" nameExportBucket := &audit.NebiusObjectStorageDestination_BucketById{ BucketById: &audit.BucketById{Id: "<bucket_ID>"}, } nameExportStorage := &audit.NebiusObjectStorageDestination{ ObjectPrefix: "<prefix>", Bucket: nameExportBucket, } nameExportDestination := &audit.AuditEventExportSpec_NebiusObjectStorage{ NebiusObjectStorage: nameExportStorage, } nameExportService := sdk.Services().Audit().V2().AuditEventExport() nameExportOperation, err := nameExportService.Start( ctx, &audit.StartRequest{ Metadata: &common.ResourceMetadata{ ParentId: "<tenant_ID>", }, Spec: &audit.AuditEventExportSpec{ Params: &audit.AuditEventExportParams{ From: timestamppb.New(nameExportStart), To: timestamppb.New(nameExportEnd), EventType: audit.EventType_CONTROL_PLANE, Filter: nameExportFilter, }, ExportDestination: nameExportDestination, }, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("start audit export: %w", err) } nameExportOperation, err = nameExportOperation.Wait(ctx) if err != nil { return fmt.Errorf("wait for audit export: %w", err) }List events by ancestor ID:List events by ancestor name:event_service = AuditEventServiceClient(sdk) event_filter = ( "resource.hierarchy.id:'" + "<ancestor_ID>" + "'" ) events = await event_service.list( ListAuditEventRequest( parent_id="<tenant_ID>", start=datetime.fromisoformat("<time_in_ISO_8601>"), end=datetime.fromisoformat("<time_in_ISO_8601>"), filter=event_filter, region="<region_ID>", ), ) print(events)Start an export by ancestor ID:event_service = AuditEventServiceClient(sdk) event_filter = ( "resource.hierarchy.name:'" + "<ancestor_name>" + "'" ) events = await event_service.list( ListAuditEventRequest( parent_id="<tenant_ID>", start=datetime.fromisoformat("<time_in_ISO_8601>"), end=datetime.fromisoformat("<time_in_ISO_8601>"), filter=event_filter, region="<region_ID>", ), ) print(events)Start an export by ancestor name:export_service = AuditEventExportServiceClient(sdk) export_filter = ( "resource.hierarchy.id:'" + "<ancestor_ID>" + "'" ) export_operation = await export_service.start( StartRequest( metadata=ResourceMetadata(parent_id="<tenant_ID>"), spec=AuditEventExportSpec( params=AuditEventExportParams( from_=datetime.fromisoformat("<time_in_ISO_8601>"), to=datetime.fromisoformat("<time_in_ISO_8601>"), event_type=EventType.CONTROL_PLANE, filter=export_filter, ), nebius_object_storage=NebiusObjectStorageDestination( object_prefix="<prefix>", bucket_by_id=BucketById(id="<bucket_ID>"), ), ), region="<region_ID>", ), ) await export_operation.wait()export_service = AuditEventExportServiceClient(sdk) export_filter = ( "resource.hierarchy.name:'" + "<ancestor_name>" + "'" ) export_operation = await export_service.start( StartRequest( metadata=ResourceMetadata(parent_id="<tenant_ID>"), spec=AuditEventExportSpec( params=AuditEventExportParams( from_=datetime.fromisoformat("<time_in_ISO_8601>"), to=datetime.fromisoformat("<time_in_ISO_8601>"), event_type=EventType.CONTROL_PLANE, filter=export_filter, ), nebius_object_storage=NebiusObjectStorageDestination( object_prefix="<prefix>", bucket_by_id=BucketById(id="<bucket_ID>"), ), ), region="<region_ID>", ), ) await export_operation.wait()List events by ancestor ID:List events by ancestor name:const ancestorIDService = new AuditEventService(sdk); const ancestorIDFilter = "resource.hierarchy.id:'" + "<ancestor_ID>" + "'"; const ancestorIDEvents = await ancestorIDService.list( ListAuditEventRequest.create({ parentId: "<tenant_ID>", start: dayjs("<time_in_ISO_8601>"), end: dayjs("<time_in_ISO_8601>"), filter: ancestorIDFilter, region: "<region_ID>", }), ).result; console.log(ancestorIDEvents);Start an export by ancestor ID:const ancestorNameService = new AuditEventService(sdk); const ancestorNameFilter = "resource.hierarchy.name:'" + "<ancestor_name>" + "'"; const ancestorNameEvents = await ancestorNameService.list( ListAuditEventRequest.create({ parentId: "<tenant_ID>", start: dayjs("<time_in_ISO_8601>"), end: dayjs("<time_in_ISO_8601>"), filter: ancestorNameFilter, region: "<region_ID>", }), ).result; console.log(ancestorNameEvents);Start an export by ancestor name:const ancestorExportService = new AuditEventExportService(sdk); const ancestorExportFilter = "resource.hierarchy.id:'" + "<ancestor_ID>" + "'"; const ancestorExportOperation = await ancestorExportService.start( StartRequest.create({ metadata: { parentId: "<tenant_ID>" }, spec: { params: { from: dayjs("<time_in_ISO_8601>"), to: dayjs("<time_in_ISO_8601>"), eventType: EventType.CONTROL_PLANE, filter: ancestorExportFilter, }, exportDestination: { $case: "nebiusObjectStorage", nebiusObjectStorage: { objectPrefix: "<prefix>", bucket: { $case: "bucketById", bucketById: { id: "<bucket_ID>" }, }, }, }, }, region: "<region_ID>", }), ).result; await ancestorExportOperation.wait();const nameExportService = new AuditEventExportService(sdk); const nameExportFilter = "resource.hierarchy.name:'" + "<ancestor_name>" + "'"; const nameExportOperation = await nameExportService.start( StartRequest.create({ metadata: { parentId: "<tenant_ID>" }, spec: { params: { from: dayjs("<time_in_ISO_8601>"), to: dayjs("<time_in_ISO_8601>"), eventType: EventType.CONTROL_PLANE, filter: nameExportFilter, }, exportDestination: { $case: "nebiusObjectStorage", nebiusObjectStorage: { objectPrefix: "<prefix>", bucket: { $case: "bucketById", bucketById: { id: "<bucket_ID>" }, }, }, }, }, region: "<region_ID>", }), ).result; await nameExportOperation.wait(); -
Event action
Specify the action:
CREATE,UPDATEorDELETE. Actions can differ by service. For example, for Compute resources, you can also specifySTOPandSTART.- CLI
- Go SDK
- Python SDK
- JavaScript SDK
List events by action:Start an export by action:nebius audit v2 audit-event list \ --parent-id <tenant_ID> \ --start <time_in_ISO_8601> --end <time_in_ISO_8601> \ --filter "action='DELETE'" \ --region <region_ID>nebius audit v2 audit-event-export start \ --parent-id <tenant_ID> \ --params-from <time_in_ISO_8601> --params-to <time_in_ISO_8601> \ --params-event-type <control_plane|data_plane> \ --nebius-object-storage-bucket-by-id-id <bucket_ID> \ --nebius-object-storage-object-prefix <prefix> \ --params-filter "action='DELETE'" \ --region <region_ID>List events by action:Start an export by action:actionStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } actionEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } actionFilter := "action='DELETE'" actionService := sdk.Services().Audit().V2().AuditEvent() actionEvents, err := actionService.List( ctx, &audit.ListAuditEventRequest{ ParentId: "<tenant_ID>", Start: timestamppb.New(actionStart), End: timestamppb.New(actionEnd), Filter: actionFilter, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("list audit events: %w", err) } fmt.Println(actionEvents)actionExportStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } actionExportEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } actionExportFilter := "action='DELETE'" actionExportBucket := &audit.NebiusObjectStorageDestination_BucketById{ BucketById: &audit.BucketById{Id: "<bucket_ID>"}, } actionExportStorage := &audit.NebiusObjectStorageDestination{ ObjectPrefix: "<prefix>", Bucket: actionExportBucket, } actionExportDestination := &audit.AuditEventExportSpec_NebiusObjectStorage{ NebiusObjectStorage: actionExportStorage, } actionExportService := sdk.Services().Audit().V2().AuditEventExport() actionExportOperation, err := actionExportService.Start( ctx, &audit.StartRequest{ Metadata: &common.ResourceMetadata{ ParentId: "<tenant_ID>", }, Spec: &audit.AuditEventExportSpec{ Params: &audit.AuditEventExportParams{ From: timestamppb.New(actionExportStart), To: timestamppb.New(actionExportEnd), EventType: audit.EventType_CONTROL_PLANE, Filter: actionExportFilter, }, ExportDestination: actionExportDestination, }, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("start audit export: %w", err) } actionExportOperation, err = actionExportOperation.Wait(ctx) if err != nil { return fmt.Errorf("wait for audit export: %w", err) }List events by action:Start an export by action:event_service = AuditEventServiceClient(sdk) event_filter = ( "action='DELETE'" ) events = await event_service.list( ListAuditEventRequest( parent_id="<tenant_ID>", start=datetime.fromisoformat("<time_in_ISO_8601>"), end=datetime.fromisoformat("<time_in_ISO_8601>"), filter=event_filter, region="<region_ID>", ), ) print(events)export_service = AuditEventExportServiceClient(sdk) export_filter = ( "action='DELETE'" ) export_operation = await export_service.start( StartRequest( metadata=ResourceMetadata(parent_id="<tenant_ID>"), spec=AuditEventExportSpec( params=AuditEventExportParams( from_=datetime.fromisoformat("<time_in_ISO_8601>"), to=datetime.fromisoformat("<time_in_ISO_8601>"), event_type=EventType.CONTROL_PLANE, filter=export_filter, ), nebius_object_storage=NebiusObjectStorageDestination( object_prefix="<prefix>", bucket_by_id=BucketById(id="<bucket_ID>"), ), ), region="<region_ID>", ), ) await export_operation.wait()List events by action:Start an export by action:const actionService = new AuditEventService(sdk); const actionFilter = "action='DELETE'"; const actionEvents = await actionService.list( ListAuditEventRequest.create({ parentId: "<tenant_ID>", start: dayjs("<time_in_ISO_8601>"), end: dayjs("<time_in_ISO_8601>"), filter: actionFilter, region: "<region_ID>", }), ).result; console.log(actionEvents);const actionExportService = new AuditEventExportService(sdk); const actionExportFilter = "action='DELETE'"; const actionExportOperation = await actionExportService.start( StartRequest.create({ metadata: { parentId: "<tenant_ID>" }, spec: { params: { from: dayjs("<time_in_ISO_8601>"), to: dayjs("<time_in_ISO_8601>"), eventType: EventType.CONTROL_PLANE, filter: actionExportFilter, }, exportDestination: { $case: "nebiusObjectStorage", nebiusObjectStorage: { objectPrefix: "<prefix>", bucket: { $case: "bucketById", bucketById: { id: "<bucket_ID>" }, }, }, }, }, region: "<region_ID>", }), ).result; await actionExportOperation.wait(); -
Service in which the event occurred.
See the list of services.
- CLI
- Go SDK
- Python SDK
- JavaScript SDK
List events by service:Start an export by service:nebius audit v2 audit-event list \ --parent-id <tenant_ID> \ --start <time_in_ISO_8601> --end <time_in_ISO_8601> \ --filter "service.name='COMPUTE'" \ --region <region_ID>nebius audit v2 audit-event-export start \ --parent-id <tenant_ID> \ --params-from <time_in_ISO_8601> --params-to <time_in_ISO_8601> \ --params-event-type <control_plane|data_plane> \ --nebius-object-storage-bucket-by-id-id <bucket_ID> \ --nebius-object-storage-object-prefix <prefix> \ --params-filter "service.name='COMPUTE'" \ --region <region_ID>List events by service:Start an export by service:serviceNameStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } serviceNameEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } serviceNameFilter := "service.name='COMPUTE'" serviceNameService := sdk.Services().Audit().V2().AuditEvent() serviceNameEvents, err := serviceNameService.List( ctx, &audit.ListAuditEventRequest{ ParentId: "<tenant_ID>", Start: timestamppb.New(serviceNameStart), End: timestamppb.New(serviceNameEnd), Filter: serviceNameFilter, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("list audit events: %w", err) } fmt.Println(serviceNameEvents)serviceExportStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } serviceExportEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } serviceExportFilter := "service.name='COMPUTE'" serviceExportBucket := &audit.NebiusObjectStorageDestination_BucketById{ BucketById: &audit.BucketById{Id: "<bucket_ID>"}, } serviceExportStorage := &audit.NebiusObjectStorageDestination{ ObjectPrefix: "<prefix>", Bucket: serviceExportBucket, } serviceExportDestination := &audit.AuditEventExportSpec_NebiusObjectStorage{ NebiusObjectStorage: serviceExportStorage, } serviceExportService := sdk.Services().Audit().V2().AuditEventExport() serviceExportOperation, err := serviceExportService.Start( ctx, &audit.StartRequest{ Metadata: &common.ResourceMetadata{ ParentId: "<tenant_ID>", }, Spec: &audit.AuditEventExportSpec{ Params: &audit.AuditEventExportParams{ From: timestamppb.New(serviceExportStart), To: timestamppb.New(serviceExportEnd), EventType: audit.EventType_CONTROL_PLANE, Filter: serviceExportFilter, }, ExportDestination: serviceExportDestination, }, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("start audit export: %w", err) } serviceExportOperation, err = serviceExportOperation.Wait(ctx) if err != nil { return fmt.Errorf("wait for audit export: %w", err) }List events by service:Start an export by service:event_service = AuditEventServiceClient(sdk) event_filter = ( "service.name='COMPUTE'" ) events = await event_service.list( ListAuditEventRequest( parent_id="<tenant_ID>", start=datetime.fromisoformat("<time_in_ISO_8601>"), end=datetime.fromisoformat("<time_in_ISO_8601>"), filter=event_filter, region="<region_ID>", ), ) print(events)export_service = AuditEventExportServiceClient(sdk) export_filter = ( "service.name='COMPUTE'" ) export_operation = await export_service.start( StartRequest( metadata=ResourceMetadata(parent_id="<tenant_ID>"), spec=AuditEventExportSpec( params=AuditEventExportParams( from_=datetime.fromisoformat("<time_in_ISO_8601>"), to=datetime.fromisoformat("<time_in_ISO_8601>"), event_type=EventType.CONTROL_PLANE, filter=export_filter, ), nebius_object_storage=NebiusObjectStorageDestination( object_prefix="<prefix>", bucket_by_id=BucketById(id="<bucket_ID>"), ), ), region="<region_ID>", ), ) await export_operation.wait()List events by service:Start an export by service:const serviceNameService = new AuditEventService(sdk); const serviceNameFilter = "service.name='COMPUTE'"; const serviceNameEvents = await serviceNameService.list( ListAuditEventRequest.create({ parentId: "<tenant_ID>", start: dayjs("<time_in_ISO_8601>"), end: dayjs("<time_in_ISO_8601>"), filter: serviceNameFilter, region: "<region_ID>", }), ).result; console.log(serviceNameEvents);const serviceExportService = new AuditEventExportService(sdk); const serviceExportFilter = "service.name='COMPUTE'"; const serviceExportOperation = await serviceExportService.start( StartRequest.create({ metadata: { parentId: "<tenant_ID>" }, spec: { params: { from: dayjs("<time_in_ISO_8601>"), to: dayjs("<time_in_ISO_8601>"), eventType: EventType.CONTROL_PLANE, filter: serviceExportFilter, }, exportDestination: { $case: "nebiusObjectStorage", nebiusObjectStorage: { objectPrefix: "<prefix>", bucket: { $case: "bucketById", bucketById: { id: "<bucket_ID>" }, }, }, }, }, region: "<region_ID>", }), ).result; await serviceExportOperation.wait(); -
Event class
A string in the
ai.nebius.<service_name>.<resource_type>.<action>format. It includes theai.nebiusprefix and refers to a Nebius AI Cloud service, type of resource in it, and the action performed on this resource, for example,ai.nebius.compute.computeinstance.delete.- CLI
- Go SDK
- Python SDK
- JavaScript SDK
List events by event class:Start an export by event class:nebius audit v2 audit-event list \ --parent-id <tenant_ID> \ --start <time_in_ISO_8601> --end <time_in_ISO_8601> \ --filter "type='ai.nebius.compute.computeinstance.delete'" \ --region <region_ID>nebius audit v2 audit-event-export start \ --parent-id <tenant_ID> \ --params-from <time_in_ISO_8601> --params-to <time_in_ISO_8601> \ --params-event-type <control_plane|data_plane> \ --nebius-object-storage-bucket-by-id-id <bucket_ID> \ --nebius-object-storage-object-prefix <prefix> \ --params-filter "type='ai.nebius.compute.computeinstance.delete'" \ --region <region_ID>List events by event class:Start an export by event class:eventTypeStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } eventTypeEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } eventTypeFilter := "type='ai.nebius.compute.computeinstance.delete'" eventTypeService := sdk.Services().Audit().V2().AuditEvent() eventTypeEvents, err := eventTypeService.List( ctx, &audit.ListAuditEventRequest{ ParentId: "<tenant_ID>", Start: timestamppb.New(eventTypeStart), End: timestamppb.New(eventTypeEnd), Filter: eventTypeFilter, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("list audit events: %w", err) } fmt.Println(eventTypeEvents)eventExportStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } eventExportEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } eventExportFilter := "type='ai.nebius.compute.computeinstance.delete'" eventExportBucket := &audit.NebiusObjectStorageDestination_BucketById{ BucketById: &audit.BucketById{Id: "<bucket_ID>"}, } eventExportStorage := &audit.NebiusObjectStorageDestination{ ObjectPrefix: "<prefix>", Bucket: eventExportBucket, } eventExportDestination := &audit.AuditEventExportSpec_NebiusObjectStorage{ NebiusObjectStorage: eventExportStorage, } eventExportService := sdk.Services().Audit().V2().AuditEventExport() eventExportOperation, err := eventExportService.Start( ctx, &audit.StartRequest{ Metadata: &common.ResourceMetadata{ ParentId: "<tenant_ID>", }, Spec: &audit.AuditEventExportSpec{ Params: &audit.AuditEventExportParams{ From: timestamppb.New(eventExportStart), To: timestamppb.New(eventExportEnd), EventType: audit.EventType_CONTROL_PLANE, Filter: eventExportFilter, }, ExportDestination: eventExportDestination, }, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("start audit export: %w", err) } eventExportOperation, err = eventExportOperation.Wait(ctx) if err != nil { return fmt.Errorf("wait for audit export: %w", err) }List events by event class:Start an export by event class:event_service = AuditEventServiceClient(sdk) event_filter = ( "type='ai.nebius.compute.computeinstance.delete'" ) events = await event_service.list( ListAuditEventRequest( parent_id="<tenant_ID>", start=datetime.fromisoformat("<time_in_ISO_8601>"), end=datetime.fromisoformat("<time_in_ISO_8601>"), filter=event_filter, region="<region_ID>", ), ) print(events)export_service = AuditEventExportServiceClient(sdk) export_filter = ( "type='ai.nebius.compute.computeinstance.delete'" ) export_operation = await export_service.start( StartRequest( metadata=ResourceMetadata(parent_id="<tenant_ID>"), spec=AuditEventExportSpec( params=AuditEventExportParams( from_=datetime.fromisoformat("<time_in_ISO_8601>"), to=datetime.fromisoformat("<time_in_ISO_8601>"), event_type=EventType.CONTROL_PLANE, filter=export_filter, ), nebius_object_storage=NebiusObjectStorageDestination( object_prefix="<prefix>", bucket_by_id=BucketById(id="<bucket_ID>"), ), ), region="<region_ID>", ), ) await export_operation.wait()List events by event class:Start an export by event class:const eventTypeService = new AuditEventService(sdk); const eventTypeFilter = "type='ai.nebius.compute.computeinstance.delete'"; const eventTypeEvents = await eventTypeService.list( ListAuditEventRequest.create({ parentId: "<tenant_ID>", start: dayjs("<time_in_ISO_8601>"), end: dayjs("<time_in_ISO_8601>"), filter: eventTypeFilter, region: "<region_ID>", }), ).result; console.log(eventTypeEvents);const eventExportService = new AuditEventExportService(sdk); const eventExportFilter = "type='ai.nebius.compute.computeinstance.delete'"; const eventExportOperation = await eventExportService.start( StartRequest.create({ metadata: { parentId: "<tenant_ID>" }, spec: { params: { from: dayjs("<time_in_ISO_8601>"), to: dayjs("<time_in_ISO_8601>"), eventType: EventType.CONTROL_PLANE, filter: eventExportFilter, }, exportDestination: { $case: "nebiusObjectStorage", nebiusObjectStorage: { objectPrefix: "<prefix>", bucket: { $case: "bucketById", bucketById: { id: "<bucket_ID>" }, }, }, }, }, region: "<region_ID>", }), ).result; await eventExportOperation.wait(); -
Subject name or ID
The name or ID of a user account or a service account that performed actions. The formats of user account IDs and service account IDs are
tenantuseraccount-***andserviceaccount-***. Theauthentication.subject.namefilter is not available for exports.- CLI
- Go SDK
- Python SDK
- JavaScript SDK
List events by subject name:List events by user account ID:nebius audit v2 audit-event list \ --parent-id <tenant_ID> \ --start <time_in_ISO_8601> --end <time_in_ISO_8601> \ --filter "authentication.subject.name='<user_email>'" \ --region <region_ID>List events by service account ID:nebius audit v2 audit-event list \ --parent-id <tenant_ID> \ --start <time_in_ISO_8601> --end <time_in_ISO_8601> \ --filter "authentication.subject.tenant_user_id='tenantuseraccount-***'" \ --region <region_ID>Start an export by user account ID:nebius audit v2 audit-event list \ --parent-id <tenant_ID> \ --start <time_in_ISO_8601> --end <time_in_ISO_8601> \ --filter "authentication.subject.service_account_id='serviceaccount-***'" \ --region <region_ID>Start an export by service account ID:nebius audit v2 audit-event-export start \ --parent-id <tenant_ID> \ --params-from <time_in_ISO_8601> --params-to <time_in_ISO_8601> \ --params-event-type <control_plane|data_plane> \ --nebius-object-storage-bucket-by-id-id <bucket_ID> \ --nebius-object-storage-object-prefix <prefix> \ --params-filter "authentication.subject.tenant_user_id='tenantuseraccount-***'" \ --region <region_ID>nebius audit v2 audit-event-export start \ --parent-id <tenant_ID> \ --params-from <time_in_ISO_8601> --params-to <time_in_ISO_8601> \ --params-event-type <control_plane|data_plane> \ --nebius-object-storage-bucket-by-id-id <bucket_ID> \ --nebius-object-storage-object-prefix <prefix> \ --params-filter "authentication.subject.service_account_id='serviceaccount-***'" \ --region <region_ID>List events by subject name:List events by user account ID:emailStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } emailEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } emailFilter := "authentication.subject.name='" + "<user_email>" + "'" emailService := sdk.Services().Audit().V2().AuditEvent() emailEvents, err := emailService.List( ctx, &audit.ListAuditEventRequest{ ParentId: "<tenant_ID>", Start: timestamppb.New(emailStart), End: timestamppb.New(emailEnd), Filter: emailFilter, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("list audit events: %w", err) } fmt.Println(emailEvents)List events by service account ID:tenantUserStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } tenantUserEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } tenantUserFilter := "authentication.subject.tenant_user_id='" + "tenantuseraccount-***" + "'" tenantUserService := sdk.Services().Audit().V2().AuditEvent() tenantUserEvents, err := tenantUserService.List( ctx, &audit.ListAuditEventRequest{ ParentId: "<tenant_ID>", Start: timestamppb.New(tenantUserStart), End: timestamppb.New(tenantUserEnd), Filter: tenantUserFilter, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("list audit events: %w", err) } fmt.Println(tenantUserEvents)Start an export by user account ID:serviceAccountStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } serviceAccountEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } serviceAccountFilter := "authentication.subject.service_account_id='" + "serviceaccount-***" + "'" serviceAccountService := sdk.Services().Audit().V2().AuditEvent() serviceAccountEvents, err := serviceAccountService.List( ctx, &audit.ListAuditEventRequest{ ParentId: "<tenant_ID>", Start: timestamppb.New(serviceAccountStart), End: timestamppb.New(serviceAccountEnd), Filter: serviceAccountFilter, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("list audit events: %w", err) } fmt.Println(serviceAccountEvents)Start an export by service account ID:userExportStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } userExportEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } userExportFilter := "authentication.subject.tenant_user_id='" + "tenantuseraccount-***" + "'" userExportBucket := &audit.NebiusObjectStorageDestination_BucketById{ BucketById: &audit.BucketById{Id: "<bucket_ID>"}, } userExportStorage := &audit.NebiusObjectStorageDestination{ ObjectPrefix: "<prefix>", Bucket: userExportBucket, } userExportDestination := &audit.AuditEventExportSpec_NebiusObjectStorage{ NebiusObjectStorage: userExportStorage, } userExportService := sdk.Services().Audit().V2().AuditEventExport() userExportOperation, err := userExportService.Start( ctx, &audit.StartRequest{ Metadata: &common.ResourceMetadata{ ParentId: "<tenant_ID>", }, Spec: &audit.AuditEventExportSpec{ Params: &audit.AuditEventExportParams{ From: timestamppb.New(userExportStart), To: timestamppb.New(userExportEnd), EventType: audit.EventType_CONTROL_PLANE, Filter: userExportFilter, }, ExportDestination: userExportDestination, }, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("start audit export: %w", err) } userExportOperation, err = userExportOperation.Wait(ctx) if err != nil { return fmt.Errorf("wait for audit export: %w", err) }saExportStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } saExportEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } saExportFilter := "authentication.subject.service_account_id='" + "serviceaccount-***" + "'" saExportBucket := &audit.NebiusObjectStorageDestination_BucketById{ BucketById: &audit.BucketById{Id: "<bucket_ID>"}, } saExportStorage := &audit.NebiusObjectStorageDestination{ ObjectPrefix: "<prefix>", Bucket: saExportBucket, } saExportDestination := &audit.AuditEventExportSpec_NebiusObjectStorage{ NebiusObjectStorage: saExportStorage, } saExportService := sdk.Services().Audit().V2().AuditEventExport() saExportOperation, err := saExportService.Start( ctx, &audit.StartRequest{ Metadata: &common.ResourceMetadata{ ParentId: "<tenant_ID>", }, Spec: &audit.AuditEventExportSpec{ Params: &audit.AuditEventExportParams{ From: timestamppb.New(saExportStart), To: timestamppb.New(saExportEnd), EventType: audit.EventType_CONTROL_PLANE, Filter: saExportFilter, }, ExportDestination: saExportDestination, }, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("start audit export: %w", err) } saExportOperation, err = saExportOperation.Wait(ctx) if err != nil { return fmt.Errorf("wait for audit export: %w", err) }List events by subject name:List events by user account ID:event_service = AuditEventServiceClient(sdk) event_filter = ( "authentication.subject.name='" + "<user_email>" + "'" ) events = await event_service.list( ListAuditEventRequest( parent_id="<tenant_ID>", start=datetime.fromisoformat("<time_in_ISO_8601>"), end=datetime.fromisoformat("<time_in_ISO_8601>"), filter=event_filter, region="<region_ID>", ), ) print(events)List events by service account ID:event_service = AuditEventServiceClient(sdk) event_filter = ( "authentication.subject.tenant_user_id='" + "tenantuseraccount-***" + "'" ) events = await event_service.list( ListAuditEventRequest( parent_id="<tenant_ID>", start=datetime.fromisoformat("<time_in_ISO_8601>"), end=datetime.fromisoformat("<time_in_ISO_8601>"), filter=event_filter, region="<region_ID>", ), ) print(events)Start an export by user account ID:event_service = AuditEventServiceClient(sdk) event_filter = ( "authentication.subject.service_account_id='" + "serviceaccount-***" + "'" ) events = await event_service.list( ListAuditEventRequest( parent_id="<tenant_ID>", start=datetime.fromisoformat("<time_in_ISO_8601>"), end=datetime.fromisoformat("<time_in_ISO_8601>"), filter=event_filter, region="<region_ID>", ), ) print(events)Start an export by service account ID:export_service = AuditEventExportServiceClient(sdk) export_filter = ( "authentication.subject.tenant_user_id='" + "tenantuseraccount-***" + "'" ) export_operation = await export_service.start( StartRequest( metadata=ResourceMetadata(parent_id="<tenant_ID>"), spec=AuditEventExportSpec( params=AuditEventExportParams( from_=datetime.fromisoformat("<time_in_ISO_8601>"), to=datetime.fromisoformat("<time_in_ISO_8601>"), event_type=EventType.CONTROL_PLANE, filter=export_filter, ), nebius_object_storage=NebiusObjectStorageDestination( object_prefix="<prefix>", bucket_by_id=BucketById(id="<bucket_ID>"), ), ), region="<region_ID>", ), ) await export_operation.wait()export_service = AuditEventExportServiceClient(sdk) export_filter = ( "authentication.subject.service_account_id='" + "serviceaccount-***" + "'" ) export_operation = await export_service.start( StartRequest( metadata=ResourceMetadata(parent_id="<tenant_ID>"), spec=AuditEventExportSpec( params=AuditEventExportParams( from_=datetime.fromisoformat("<time_in_ISO_8601>"), to=datetime.fromisoformat("<time_in_ISO_8601>"), event_type=EventType.CONTROL_PLANE, filter=export_filter, ), nebius_object_storage=NebiusObjectStorageDestination( object_prefix="<prefix>", bucket_by_id=BucketById(id="<bucket_ID>"), ), ), region="<region_ID>", ), ) await export_operation.wait()List events by subject name:List events by user account ID:const emailService = new AuditEventService(sdk); const emailFilter = "authentication.subject.name='" + "<user_email>" + "'"; const emailEvents = await emailService.list( ListAuditEventRequest.create({ parentId: "<tenant_ID>", start: dayjs("<time_in_ISO_8601>"), end: dayjs("<time_in_ISO_8601>"), filter: emailFilter, region: "<region_ID>", }), ).result; console.log(emailEvents);List events by service account ID:const tenantUserService = new AuditEventService(sdk); const tenantUserFilter = "authentication.subject.tenant_user_id='" + "tenantuseraccount-***" + "'"; const tenantUserEvents = await tenantUserService.list( ListAuditEventRequest.create({ parentId: "<tenant_ID>", start: dayjs("<time_in_ISO_8601>"), end: dayjs("<time_in_ISO_8601>"), filter: tenantUserFilter, region: "<region_ID>", }), ).result; console.log(tenantUserEvents);Start an export by user account ID:const serviceAccountService = new AuditEventService(sdk); const serviceAccountFilter = "authentication.subject.service_account_id='" + "serviceaccount-***" + "'"; const serviceAccountEvents = await serviceAccountService.list( ListAuditEventRequest.create({ parentId: "<tenant_ID>", start: dayjs("<time_in_ISO_8601>"), end: dayjs("<time_in_ISO_8601>"), filter: serviceAccountFilter, region: "<region_ID>", }), ).result; console.log(serviceAccountEvents);Start an export by service account ID:const userExportService = new AuditEventExportService(sdk); const userExportFilter = "authentication.subject.tenant_user_id='" + "tenantuseraccount-***" + "'"; const userExportOperation = await userExportService.start( StartRequest.create({ metadata: { parentId: "<tenant_ID>" }, spec: { params: { from: dayjs("<time_in_ISO_8601>"), to: dayjs("<time_in_ISO_8601>"), eventType: EventType.CONTROL_PLANE, filter: userExportFilter, }, exportDestination: { $case: "nebiusObjectStorage", nebiusObjectStorage: { objectPrefix: "<prefix>", bucket: { $case: "bucketById", bucketById: { id: "<bucket_ID>" }, }, }, }, }, region: "<region_ID>", }), ).result; await userExportOperation.wait();const saExportService = new AuditEventExportService(sdk); const saExportFilter = "authentication.subject.service_account_id='" + "serviceaccount-***" + "'"; const saExportOperation = await saExportService.start( StartRequest.create({ metadata: { parentId: "<tenant_ID>" }, spec: { params: { from: dayjs("<time_in_ISO_8601>"), to: dayjs("<time_in_ISO_8601>"), eventType: EventType.CONTROL_PLANE, filter: saExportFilter, }, exportDestination: { $case: "nebiusObjectStorage", nebiusObjectStorage: { objectPrefix: "<prefix>", bucket: { $case: "bucketById", bucketById: { id: "<bucket_ID>" }, }, }, }, }, region: "<region_ID>", }), ).result; await saExportOperation.wait(); -
Subject credentials
For access tokens, use
authentication.token_credential.masked_tokenwithout a signature. For AWS-compatible access keys, useauthentication.static_key_credential.id.- CLI
- Go SDK
- Python SDK
- JavaScript SDK
List events by masked token:List events by static key ID:nebius audit v2 audit-event list \ --parent-id <tenant_ID> \ --start <time_in_ISO_8601> --end <time_in_ISO_8601> \ --filter "authentication.token_credential.masked_token='<token_without_signature>'" \ --region <region_ID>Start an export by masked token:nebius audit v2 audit-event list \ --parent-id <tenant_ID> \ --start <time_in_ISO_8601> --end <time_in_ISO_8601> \ --filter "authentication.static_key_credential.id='<access_key_ID>'" \ --region <region_ID>Start an export by static key ID:nebius audit v2 audit-event-export start \ --parent-id <tenant_ID> \ --params-from <time_in_ISO_8601> --params-to <time_in_ISO_8601> \ --params-event-type <control_plane|data_plane> \ --nebius-object-storage-bucket-by-id-id <bucket_ID> \ --nebius-object-storage-object-prefix <prefix> \ --params-filter "authentication.token_credential.masked_token='<token_without_signature>'" \ --region <region_ID>nebius audit v2 audit-event-export start \ --parent-id <tenant_ID> \ --params-from <time_in_ISO_8601> --params-to <time_in_ISO_8601> \ --params-event-type <control_plane|data_plane> \ --nebius-object-storage-bucket-by-id-id <bucket_ID> \ --nebius-object-storage-object-prefix <prefix> \ --params-filter "authentication.static_key_credential.id='<access_key_ID>'" \ --region <region_ID>List events by masked token:List events by static key ID:maskedTokenStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } maskedTokenEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } maskedTokenFilter := "authentication.token_credential.masked_token='" + "<token_without_signature>" + "'" maskedTokenService := sdk.Services().Audit().V2().AuditEvent() maskedTokenEvents, err := maskedTokenService.List( ctx, &audit.ListAuditEventRequest{ ParentId: "<tenant_ID>", Start: timestamppb.New(maskedTokenStart), End: timestamppb.New(maskedTokenEnd), Filter: maskedTokenFilter, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("list audit events: %w", err) } fmt.Println(maskedTokenEvents)Start an export by masked token:accessKeyStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } accessKeyEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } accessKeyFilter := "authentication.static_key_credential.id='" + "<access_key_ID>" + "'" accessKeyService := sdk.Services().Audit().V2().AuditEvent() accessKeyEvents, err := accessKeyService.List( ctx, &audit.ListAuditEventRequest{ ParentId: "<tenant_ID>", Start: timestamppb.New(accessKeyStart), End: timestamppb.New(accessKeyEnd), Filter: accessKeyFilter, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("list audit events: %w", err) } fmt.Println(accessKeyEvents)Start an export by static key ID:tokenExportStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } tokenExportEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } tokenExportFilter := "authentication.token_credential.masked_token='" + "<token_without_signature>" + "'" tokenExportBucket := &audit.NebiusObjectStorageDestination_BucketById{ BucketById: &audit.BucketById{Id: "<bucket_ID>"}, } tokenExportStorage := &audit.NebiusObjectStorageDestination{ ObjectPrefix: "<prefix>", Bucket: tokenExportBucket, } tokenExportDestination := &audit.AuditEventExportSpec_NebiusObjectStorage{ NebiusObjectStorage: tokenExportStorage, } tokenExportService := sdk.Services().Audit().V2().AuditEventExport() tokenExportOperation, err := tokenExportService.Start( ctx, &audit.StartRequest{ Metadata: &common.ResourceMetadata{ ParentId: "<tenant_ID>", }, Spec: &audit.AuditEventExportSpec{ Params: &audit.AuditEventExportParams{ From: timestamppb.New(tokenExportStart), To: timestamppb.New(tokenExportEnd), EventType: audit.EventType_CONTROL_PLANE, Filter: tokenExportFilter, }, ExportDestination: tokenExportDestination, }, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("start audit export: %w", err) } tokenExportOperation, err = tokenExportOperation.Wait(ctx) if err != nil { return fmt.Errorf("wait for audit export: %w", err) }keyExportStart, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse start time: %w", err) } keyExportEnd, err := time.Parse( time.RFC3339, "<time_in_ISO_8601>", ) if err != nil { return fmt.Errorf("parse end time: %w", err) } keyExportFilter := "authentication.static_key_credential.id='" + "<access_key_ID>" + "'" keyExportBucket := &audit.NebiusObjectStorageDestination_BucketById{ BucketById: &audit.BucketById{Id: "<bucket_ID>"}, } keyExportStorage := &audit.NebiusObjectStorageDestination{ ObjectPrefix: "<prefix>", Bucket: keyExportBucket, } keyExportDestination := &audit.AuditEventExportSpec_NebiusObjectStorage{ NebiusObjectStorage: keyExportStorage, } keyExportService := sdk.Services().Audit().V2().AuditEventExport() keyExportOperation, err := keyExportService.Start( ctx, &audit.StartRequest{ Metadata: &common.ResourceMetadata{ ParentId: "<tenant_ID>", }, Spec: &audit.AuditEventExportSpec{ Params: &audit.AuditEventExportParams{ From: timestamppb.New(keyExportStart), To: timestamppb.New(keyExportEnd), EventType: audit.EventType_CONTROL_PLANE, Filter: keyExportFilter, }, ExportDestination: keyExportDestination, }, Region: "<region_ID>", }, ) if err != nil { return fmt.Errorf("start audit export: %w", err) } keyExportOperation, err = keyExportOperation.Wait(ctx) if err != nil { return fmt.Errorf("wait for audit export: %w", err) }List events by masked token:List events by static key ID:event_service = AuditEventServiceClient(sdk) event_filter = ( "authentication.token_credential.masked_token='" + "<token_without_signature>" + "'" ) events = await event_service.list( ListAuditEventRequest( parent_id="<tenant_ID>", start=datetime.fromisoformat("<time_in_ISO_8601>"), end=datetime.fromisoformat("<time_in_ISO_8601>"), filter=event_filter, region="<region_ID>", ), ) print(events)Start an export by masked token:event_service = AuditEventServiceClient(sdk) event_filter = ( "authentication.static_key_credential.id='" + "<access_key_ID>" + "'" ) events = await event_service.list( ListAuditEventRequest( parent_id="<tenant_ID>", start=datetime.fromisoformat("<time_in_ISO_8601>"), end=datetime.fromisoformat("<time_in_ISO_8601>"), filter=event_filter, region="<region_ID>", ), ) print(events)Start an export by static key ID:export_service = AuditEventExportServiceClient(sdk) export_filter = ( "authentication.token_credential.masked_token='" + "<token_without_signature>" + "'" ) export_operation = await export_service.start( StartRequest( metadata=ResourceMetadata(parent_id="<tenant_ID>"), spec=AuditEventExportSpec( params=AuditEventExportParams( from_=datetime.fromisoformat("<time_in_ISO_8601>"), to=datetime.fromisoformat("<time_in_ISO_8601>"), event_type=EventType.CONTROL_PLANE, filter=export_filter, ), nebius_object_storage=NebiusObjectStorageDestination( object_prefix="<prefix>", bucket_by_id=BucketById(id="<bucket_ID>"), ), ), region="<region_ID>", ), ) await export_operation.wait()export_service = AuditEventExportServiceClient(sdk) export_filter = ( "authentication.static_key_credential.id='" + "<access_key_ID>" + "'" ) export_operation = await export_service.start( StartRequest( metadata=ResourceMetadata(parent_id="<tenant_ID>"), spec=AuditEventExportSpec( params=AuditEventExportParams( from_=datetime.fromisoformat("<time_in_ISO_8601>"), to=datetime.fromisoformat("<time_in_ISO_8601>"), event_type=EventType.CONTROL_PLANE, filter=export_filter, ), nebius_object_storage=NebiusObjectStorageDestination( object_prefix="<prefix>", bucket_by_id=BucketById(id="<bucket_ID>"), ), ), region="<region_ID>", ), ) await export_operation.wait()List events by masked token:List events by static key ID:const maskedTokenService = new AuditEventService(sdk); const maskedTokenFilter = "authentication.token_credential.masked_token='" + "<token_without_signature>" + "'"; const maskedTokenEvents = await maskedTokenService.list( ListAuditEventRequest.create({ parentId: "<tenant_ID>", start: dayjs("<time_in_ISO_8601>"), end: dayjs("<time_in_ISO_8601>"), filter: maskedTokenFilter, region: "<region_ID>", }), ).result; console.log(maskedTokenEvents);Start an export by masked token:const accessKeyService = new AuditEventService(sdk); const accessKeyFilter = "authentication.static_key_credential.id='" + "<access_key_ID>" + "'"; const accessKeyEvents = await accessKeyService.list( ListAuditEventRequest.create({ parentId: "<tenant_ID>", start: dayjs("<time_in_ISO_8601>"), end: dayjs("<time_in_ISO_8601>"), filter: accessKeyFilter, region: "<region_ID>", }), ).result; console.log(accessKeyEvents);Start an export by static key ID:const tokenExportService = new AuditEventExportService(sdk); const tokenExportFilter = "authentication.token_credential.masked_token='" + "<token_without_signature>" + "'"; const tokenExportOperation = await tokenExportService.start( StartRequest.create({ metadata: { parentId: "<tenant_ID>" }, spec: { params: { from: dayjs("<time_in_ISO_8601>"), to: dayjs("<time_in_ISO_8601>"), eventType: EventType.CONTROL_PLANE, filter: tokenExportFilter, }, exportDestination: { $case: "nebiusObjectStorage", nebiusObjectStorage: { objectPrefix: "<prefix>", bucket: { $case: "bucketById", bucketById: { id: "<bucket_ID>" }, }, }, }, }, region: "<region_ID>", }), ).result; await tokenExportOperation.wait();const keyExportService = new AuditEventExportService(sdk); const keyExportFilter = "authentication.static_key_credential.id='" + "<access_key_ID>" + "'"; const keyExportOperation = await keyExportService.start( StartRequest.create({ metadata: { parentId: "<tenant_ID>" }, spec: { params: { from: dayjs("<time_in_ISO_8601>"), to: dayjs("<time_in_ISO_8601>"), eventType: EventType.CONTROL_PLANE, filter: keyExportFilter, }, exportDestination: { $case: "nebiusObjectStorage", nebiusObjectStorage: { objectPrefix: "<prefix>", bucket: { $case: "bucketById", bucketById: { id: "<bucket_ID>" }, }, }, }, }, region: "<region_ID>", }), ).result; await keyExportOperation.wait();
How to combine filters
To combine filters, use the following options:ANDlogical operator.- Comparison operators:
=(equals),!=(not equals),:(contains). - Regular expressions (for example,
regex(resource.name, '^.*prod.*$')to show resources withprodin their names).
Examples
For example, to view events where the userexample@nebius.com deleted virtual machines:
- CLI
- Go SDK
- Python SDK
- JavaScript SDK
nebius audit v2 audit-event list \
--parent-id <tenant_ID> \
--start <time_in_ISO_8601> --end <time_in_ISO_8601> \
--filter "authentication.subject.name='example@nebius.com' \
AND action='DELETE' \
AND resource.metadata.type='computeinstance'" \
--region <region_ID>
--parent-id: Tenant ID.--start: Start time for the search, in the ISO 8601 format.--end: End time for the search, in the ISO 8601 format.--filter:authentication.subject.nameforexample@nebius.com,action='DELETE', andresource.metadata.type='computeinstance'.--region: Region where the events are stored.
combinedStart, err := time.Parse(
time.RFC3339, "<time_in_ISO_8601>",
)
if err != nil {
return fmt.Errorf("parse start time: %w", err)
}
combinedEnd, err := time.Parse(
time.RFC3339, "<time_in_ISO_8601>",
)
if err != nil {
return fmt.Errorf("parse end time: %w", err)
}
combinedFilter := "authentication.subject.name='" +
"example@nebius.com" +
"' " +
" AND action='DELETE' " +
" AND resource.metadata.type='computeinstance'"
combinedService := sdk.Services().Audit().V2().AuditEvent()
combinedEvents, err := combinedService.List(
ctx,
&audit.ListAuditEventRequest{
ParentId: "<tenant_ID>",
Start: timestamppb.New(combinedStart),
End: timestamppb.New(combinedEnd),
Filter: combinedFilter,
Region: "<region_ID>",
},
)
if err != nil {
return fmt.Errorf("list audit events: %w", err)
}
fmt.Println(combinedEvents)
ParentId: Tenant ID.Start: Start time for the search, in the ISO 8601 format with a timezone.End: End time for the search, in the ISO 8601 format with a timezone.Filter:authentication.subject.nameforexample@nebius.com,action='DELETE', andresource.metadata.type='computeinstance'.Region: Region to search for audit events.
event_service = AuditEventServiceClient(sdk)
event_filter = (
"authentication.subject.name='"
+ "example@nebius.com"
+ "' "
+ " AND action='DELETE' "
+ " AND resource.metadata.type='computeinstance'"
)
events = await event_service.list(
ListAuditEventRequest(
parent_id="<tenant_ID>",
start=datetime.fromisoformat("<time_in_ISO_8601>"),
end=datetime.fromisoformat("<time_in_ISO_8601>"),
filter=event_filter,
region="<region_ID>",
),
)
print(events)
parent_id: Tenant ID.start: Start time for the search, in the ISO 8601 format with a timezone, for example,2026-05-07T00:00:00Z. On Python 3.10, use+00:00instead ofZ.end: End time for the search, in the ISO 8601 format with a timezone, for example,2026-05-08T00:00:00Z. On Python 3.10, use+00:00instead ofZ.filter:authentication.subject.nameforexample@nebius.com,action='DELETE', andresource.metadata.type='computeinstance'.region: Region to search for audit events.
const combinedService = new AuditEventService(sdk);
const combinedFilter =
"authentication.subject.name='" +
"example@nebius.com" +
"' " +
" AND action='DELETE' " +
" AND resource.metadata.type='computeinstance'";
const combinedEvents = await combinedService.list(
ListAuditEventRequest.create({
parentId: "<tenant_ID>",
start: dayjs("<time_in_ISO_8601>"),
end: dayjs("<time_in_ISO_8601>"),
filter: combinedFilter,
region: "<region_ID>",
}),
).result;
console.log(combinedEvents);
- CLI
- Go SDK
- Python SDK
- JavaScript SDK
nebius audit v2 audit-event-export start \
--parent-id <tenant_ID> \
--params-from 2025-04-01T00:00:00Z --params-to 2025-04-06T00:00:00Z \
--params-event-type <control_plane|data_plane> \
--nebius-object-storage-bucket-by-id-id <bucket_ID> \
--nebius-object-storage-object-prefix <prefix> \
--params-filter "authentication.subject.tenant_user_id='<tenant_user_ID>' \
AND action='DELETE' \
AND resource.metadata.type='computeinstance'" \
--region <region_ID>
--parent-id: Tenant ID.--params-from:2025-04-01T00:00:00Z.--params-to:2025-04-06T00:00:00Z.--params-event-type:control_planeordata_plane.--nebius-object-storage-bucket-by-id-id: Destination bucket ID (metadata.id). See How to export audit events to Object Storage.--nebius-object-storage-object-prefix(optional): Object prefix. If you omit it, theauditlogsprefix is used.--params-filter:authentication.subject.tenant_user_id,action='DELETE', andresource.metadata.type='computeinstance'.--region: Region where the events are stored.
combinedExportStart, err := time.Parse(
time.RFC3339, "2025-04-01T00:00:00Z",
)
if err != nil {
return fmt.Errorf("parse start time: %w", err)
}
combinedExportEnd, err := time.Parse(
time.RFC3339, "2025-04-06T00:00:00Z",
)
if err != nil {
return fmt.Errorf("parse end time: %w", err)
}
combinedExportFilter := "authentication.subject.tenant_user_id='" +
"<tenant_user_ID>" +
"' " +
" AND action='DELETE' " +
" AND resource.metadata.type='computeinstance'"
combinedExportBucket :=
&audit.NebiusObjectStorageDestination_BucketById{
BucketById: &audit.BucketById{Id: "<bucket_ID>"},
}
combinedExportStorage := &audit.NebiusObjectStorageDestination{
ObjectPrefix: "<prefix>",
Bucket: combinedExportBucket,
}
combinedExportDestination :=
&audit.AuditEventExportSpec_NebiusObjectStorage{
NebiusObjectStorage: combinedExportStorage,
}
combinedExportService := sdk.Services().Audit().V2().
AuditEventExport()
combinedExportOperation, err := combinedExportService.Start(
ctx,
&audit.StartRequest{
Metadata: &common.ResourceMetadata{
ParentId: "<tenant_ID>",
},
Spec: &audit.AuditEventExportSpec{
Params: &audit.AuditEventExportParams{
From: timestamppb.New(combinedExportStart),
To: timestamppb.New(combinedExportEnd),
EventType: audit.EventType_CONTROL_PLANE,
Filter: combinedExportFilter,
},
ExportDestination: combinedExportDestination,
},
Region: "<region_ID>",
},
)
if err != nil {
return fmt.Errorf("start audit export: %w", err)
}
combinedExportOperation, err = combinedExportOperation.Wait(ctx)
if err != nil {
return fmt.Errorf("wait for audit export: %w", err)
}
Metadata.ParentId: Tenant ID.Spec.Params.From:2025-04-01T00:00:00Z.Spec.Params.To:2025-04-06T00:00:00Z.Spec.Params.EventType:audit.EventType_CONTROL_PLANE.Spec.Params.Filter:authentication.subject.tenant_user_id,action='DELETE', andresource.metadata.type='computeinstance'.ObjectPrefix(optional): Object prefix. If you remove it, theauditlogsprefix is used.BucketById.Id: Destination bucket ID (metadata.id). See How to export audit events to Object Storage. The bucket must be in the same region as the exported events.Region: Region to export audit events from.
export_service = AuditEventExportServiceClient(sdk)
export_filter = (
"authentication.subject.tenant_user_id='"
+ "<tenant_user_ID>"
+ "' "
+ " AND action='DELETE' "
+ " AND resource.metadata.type='computeinstance'"
)
export_operation = await export_service.start(
StartRequest(
metadata=ResourceMetadata(parent_id="<tenant_ID>"),
spec=AuditEventExportSpec(
params=AuditEventExportParams(
from_=datetime.fromisoformat("2025-04-01T00:00:00Z"),
to=datetime.fromisoformat("2025-04-06T00:00:00Z"),
event_type=EventType.CONTROL_PLANE,
filter=export_filter,
),
nebius_object_storage=NebiusObjectStorageDestination(
object_prefix="<prefix>",
bucket_by_id=BucketById(id="<bucket_ID>"),
),
),
region="<region_ID>",
),
)
await export_operation.wait()
metadata.parent_id: Tenant ID.spec.params.from_:2025-04-01T00:00:00Z. On Python 3.10, use+00:00instead ofZ.spec.params.to:2025-04-06T00:00:00Z. On Python 3.10, use+00:00instead ofZ.spec.params.event_type:EventType.CONTROL_PLANE.spec.params.filter:authentication.subject.tenant_user_id,action='DELETE', andresource.metadata.type='computeinstance'.spec.nebius_object_storage.object_prefix(optional): Object prefix. If you remove it, theauditlogsprefix is used.spec.nebius_object_storage.bucket_by_id.id: Destination bucket ID (metadata.id). See How to export audit events to Object Storage. The bucket must be in the same region as the exported events.region: Region to export audit events from.
const combinedExportService =
new AuditEventExportService(sdk);
const combinedExportFilter =
"authentication.subject.tenant_user_id='" +
"<tenant_user_ID>" +
"' " +
" AND action='DELETE' " +
" AND resource.metadata.type='computeinstance'";
const combinedExportOperation = await combinedExportService.start(
StartRequest.create({
metadata: { parentId: "<tenant_ID>" },
spec: {
params: {
from: dayjs("2025-04-01T00:00:00Z"),
to: dayjs("2025-04-06T00:00:00Z"),
eventType: EventType.CONTROL_PLANE,
filter: combinedExportFilter,
},
exportDestination: {
$case: "nebiusObjectStorage",
nebiusObjectStorage: {
objectPrefix: "<prefix>",
bucket: {
$case: "bucketById",
bucketById: { id: "<bucket_ID>" },
},
},
},
},
region: "<region_ID>",
}),
).result;
await combinedExportOperation.wait();
metadata.parentId: Tenant ID.spec.params.from:2025-04-01T00:00:00Z.spec.params.to:2025-04-06T00:00:00Z.spec.params.eventType:EventType.CONTROL_PLANE.spec.params.filter:authentication.subject.tenant_user_id,action='DELETE', andresource.metadata.type='computeinstance'.spec.exportDestination.nebiusObjectStorage.objectPrefix(optional): Object prefix. If you remove it, theauditlogsprefix is used.spec.exportDestination.nebiusObjectStorage.bucket.bucketById.id: Destination bucket ID (metadata.id). See How to export audit events to Object Storage. The bucket must be in the same region as the exported events.region: Region to export audit events from.