> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nebius.com/llms.txt
> Use this file to discover all available pages before exploring further.

# start

<div>
  <h2>Name</h2>

  <p style={{ paddingLeft: "4ch" }}>
    <code>nebius audit v2 audit-event-export start</code>
  </p>

  <p style={{ paddingLeft: "7ch" }}>
    Start audit events export to s3 bucket for specific period.
  </p>
</div>

<div>
  <h2>Synopsis</h2>

  <p style={{ paddingLeft: "4ch" }}>
    ```
    nebius audit v2 audit-event-export start [id]
      --id
      --labels
      --name
      --nebius-object-storage-bucket-by-id-id [required]
      --nebius-object-storage-object-prefix
      --params-event-type [required]
      --params-filter
      --params-from [required]
      --params-to [required]
      --parent-id [required]
      --resource-version
      --async
    ```
  </p>
</div>

<div>
  <h2>Positional Arguments</h2>

  <p style={{ paddingLeft: "4ch" }}>
    <code>id</code>
  </p>

  <p style={{ paddingLeft: "8ch" }}>
    Identifier for the resource, unique for its resource type.
  </p>
</div>

<div>
  <h2>Options</h2>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--id` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Identifier for the resource, unique for its resource type.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--labels` (string->string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Labels associated with the resource.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--name` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Human readable name for the resource.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--nebius-object-storage-bucket-by-id-id` (string)<em> \[required]</em>
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      The id of the bucket in the tenant where the logs will be exported.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--nebius-object-storage-object-prefix` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Prefix for export objects.<br />
      Default value is `auditlogs`.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--params-event-type` (string)<em> \[required]</em>
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Type of audit event to filter by.
    </p>

    <p style={{ paddingLeft: "4ch" }}>A value must be one of:</p>

    <ul style={{ paddingLeft: "8ch" }}>
      <li>
        <code>control\_plane</code>
      </li>

      <li>
        <code>data\_plane</code>
      </li>
    </ul>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--params-filter` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Example:<br />
      service.name = 'iam' AND resource.hierarchy.id:'container-e0t' AND regex(resource.metadata.name, '^.*test.*\$')<br />

      <br />

      Supported filters:<br />
      "=" - equals<br />
      "!=" - not equals<br />
      ":" - contains<br />
      regex - regular expression<br />

      <br />

      Fields that can be used for filtering:<br />
      action<br />
      authentication.static\_key\_credential.id<br />
      authentication.subject.service\_account\_id<br />
      authentication.subject.tenant\_user\_id<br />
      authentication.token\_credential.masked\_token<br />
      project\_region.name<br />
      resource.hierarchy.id<br />
      resource.hierarchy.name<br />
      resource.metadata.id<br />
      resource.metadata.name<br />
      resource.metadata.type<br />
      service.name<br />
      type<br />
      status.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--params-from` (timestamp: 1970-01-31T02:30:59Z)<em> \[required]</em>
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Returns results with a timestamp greater than or equal to this value.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--params-to` (timestamp: 1970-01-31T02:30:59Z)<em> \[required]</em>
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Returns results with a timestamp lower than this value.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--parent-id` (string)<em> \[required]</em>
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Identifier of the parent resource to which the resource belongs.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--resource-version` (int64)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Version of the resource for safe concurrent modifications and consistent reads.<br />
      Positive and monotonically increases on each resource spec change (but *not* on each change of the<br />
      resource's container(s) or status).<br />
      Service allows zero value or current.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--async` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      If set, returns operation id. Otherwise, waits for the operation to complete and returns its resource.
    </p>
  </div>
</div>

<div>
  <h2>Global Options</h2>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `-h, --help` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Show this message.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `-p, --profile` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Set a profile for interacting with the cloud.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--format` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Output format. Supported values: yaml|json|jsonpath|table|text.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `-f, --file` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Input file. For 'update' commands automatically set --full=true.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `-c, --config` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Provide path to config file.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--debug` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Enable debug logs.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--color` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Enable colored output.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--no-browser` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Do not open browser automatically on auth.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--insecure` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Disable transport security.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--auth-timeout` (duration: 2h30m10s)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Set the timeout for the request including authentication process, default is 15m0s.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--per-retry-timeout` (duration: 2h30m10s)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Set the timeout for each retry attempt, default is 20s.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--retries` (uint)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Set the number of retry attempts, 1 is disable retries, default is 3.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--timeout` (duration: 2h30m10s)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Set the timeout for the main request, default is 1m0s.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--no-check-update` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Suppress check for updates.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--no-progress` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Suppress progress indicators and spinners.
    </p>
  </div>
</div>

<Expandable title="Input argument JSON Schema">
  <Tabs>
    <Tab title="Full">
      ```json theme={null}
      {              
        "metadata": {                // Metadata associated with the new export.
          "id": string,              // [identifier]
                                     // Identifier for the resource, unique for its resource type.
          "labels": {                // [map]
                                     // Labels associated with the resource.
            string: string                  
          },
          "name": string,            // Human readable name for the resource.
          "parent_id": string,       // [required]
                                     // Identifier of the parent resource to which the resource belongs.
          "resource_version": int64  // Version of the resource for safe concurrent modifications and consistent reads.
                                     // Positive and monotonically increases on each resource spec change (but *not* on each change of the
                                     // resource's container(s) or status).
                                     // Service allows zero value or current.
        },
        "spec": {                    // Specification for the new export.
          "nebius_object_storage": { // An object storage bucket that will be used as the destination for audit logs.
                                     // You must have `storage.upload` permission for successful execution.
            "bucket_by_id": {
              "id": string    // [required]
                              // The id of the bucket in the tenant where the logs will be exported.
            },
            "object_prefix": string  // Prefix for export objects.
                                     // Default value is `auditlogs`.
          },
          "params": {                       // [required]
                                            // Filter based on which audit logs must be exported.
            "event_type": enum(         // [required]
                                        // Type of audit event to filter by.
              "EVENT_TYPE_UNSPECIFIED", // Unspecified event type.
              "CONTROL_PLANE",          // Control plane events.
              "DATA_PLANE"              // Data plane events (S3).
            ),
            "filter": string,               // [sensitive]
                                            // Example:
                                            // service.name = 'iam' AND resource.hierarchy.id:'container-e0t' AND regex(resource.metadata.name, '^.*test.*$')
                                            // 
                                            // Supported filters:
                                            // "=" - equals
                                            // "!=" - not equals
                                            // ":" - contains
                                            // regex - regular expression
                                            // 
                                            // Fields that can be used for filtering:
                                            // action
                                            // authentication.static_key_credential.id
                                            // authentication.subject.service_account_id
                                            // authentication.subject.tenant_user_id
                                            // authentication.token_credential.masked_token
                                            // project_region.name
                                            // resource.hierarchy.id
                                            // resource.hierarchy.name
                                            // resource.metadata.id
                                            // resource.metadata.name
                                            // resource.metadata.type
                                            // service.name
                                            // type
                                            // status.
            "from": "1970-01-31T02:30:59Z", // [required] [google.protobuf.Timestamp]
                                            // Returns results with a timestamp greater than or equal to this value.
            "to": "1970-01-31T02:30:59Z"    // [required] [google.protobuf.Timestamp]
                                            // Returns results with a timestamp lower than this value.
          }
        }
      }
      ```
    </Tab>

    <Tab title="CopyPaste Friendly">
      ```json theme={null}
      nebius audit v2 audit-event-export start '
      {              
        "metadata": {           
          "id": "",             
          "labels": {           
            "": ""                  
          },
          "name": "",           
          "parent_id": "",      
          "resource_version": 0 
        },
        "spec": {                   
          "nebius_object_storage": {
            "bucket_by_id": {
              "id": ""       
            },
            "object_prefix": ""     
          },
          "params": {                                                          
            "event_type": "event_type_unspecified"|"control_plane"|"data_plane",
            "filter": "",                                                      
            "from": "1970-01-31T02:30:59Z",                                    
            "to": "1970-01-31T02:30:59Z"                                       
          }
        }
      }
      '
      ```
    </Tab>
  </Tabs>
</Expandable>

<strong>Auto generated on 12-May-2026</strong>