> ## 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.

# create

<div>
  <h2>Name</h2>

  <p style={{ paddingLeft: "4ch" }}>
    <code>nebius dns record create</code>
  </p>

  <p style={{ paddingLeft: "7ch" }}>
    Creates a DNS record.
  </p>
</div>

<div>
  <h2>Synopsis</h2>

  <p style={{ paddingLeft: "4ch" }}>
    ```
    nebius dns record create
      --data [required]
      --deletion-protection
      --labels
      --name
      --parent-id [required]
      --relative-name [required]
      --resource-version
      --ttl
      --type [required]
      --async
      -i, --interactive
    ```
  </p>
</div>

<div>
  <h2>Options</h2>

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

    <p style={{ paddingLeft: "4ch" }}>
      Record data in text format<br />

      <br />

      This should be the RDATA part of this Resource Record's<br />
      [presentation (zonefile) format](https://datatracker.ietf.org/doc/html/rfc9499#name-resource-records).<br />
      E.g., `10 xyz.tuv` for a `@ 600 IN MX 10 xyz.tuv.` resource record in a zonefile.
    </p>
  </div>

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

    <p style={{ paddingLeft: "4ch" }}>
      Mark this record as delete-protected<br />
      Delete-protected records can *only* be deleted by explicitly calling `RecordService/Delete` API with `force` flag set to `true`.
    </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>
      `--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>
      `--relative-name` (string)<em> \[required]</em>
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Zone-relative name of this record (e.g., `www` for `www.<parent zone's domain name>`)<br />
      Use `@` for records in zone apex (that is, records that have the same domain name as the zone itself)<br />
      To see the resolved absolute domain name, see `Record.status.effective_fqdn`.
    </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>
      `--ttl` (int64)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Record TTL. If absent or negative, will be assumed to be the default value (`600`).
    </p>
  </div>

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

    <p style={{ paddingLeft: "4ch" }}>
      Record type.
    </p>

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

    <ul style={{ paddingLeft: "8ch" }}>
      <li>
        <code>a</code>
      </li>

      <li>
        <code>aaaa</code>
      </li>

      <li>
        <code>ptr</code>
      </li>

      <li>
        <code>cname</code>
      </li>

      <li>
        <code>mx</code>
      </li>

      <li>
        <code>txt</code>
      </li>

      <li>
        <code>srv</code>
      </li>

      <li>
        <code>ns</code>
      </li>

      <li>
        <code>soa</code>
      </li>

      <li>
        <code>caa</code>
      </li>

      <li>
        <code>svcb</code>
      </li>

      <li>
        <code>https</code>
      </li>
    </ul>
  </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 style={{ paddingLeft: "4ch" }}>
    <p>
      `-i, --interactive` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      If set, suggests to insert field values in interactive mode.
    </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": {                // [required]
                                     // Metadata for the DNS record to create
                                     // The only required field is `metadata.parent_id`, which must be set to the ID of this record's parent DNS zone.
          "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": {                      // [required]
                                       // Specification for the DNS record to create.
          "data": string,              // [required]
                                       // Record data in text format
                                       // 
                                       // This should be the RDATA part of this Resource Record's
                                       // [presentation (zonefile) format](https://datatracker.ietf.org/doc/html/rfc9499#name-resource-records).
                                       // E.g., `10 xyz.tuv` for a `@ 600 IN MX 10 xyz.tuv.` resource record in a zonefile.
          "deletion_protection": bool, // Mark this record as delete-protected
                                       // Delete-protected records can *only* be deleted by explicitly calling `RecordService/Delete` API with `force` flag set to `true`.
          "relative_name": string,     // [required] [immutable]
                                       // Zone-relative name of this record (e.g., `www` for `www.<parent zone's domain name>`)
                                       // Use `@` for records in zone apex (that is, records that have the same domain name as the zone itself)
                                       // To see the resolved absolute domain name, see `Record.status.effective_fqdn`.
          "ttl": int64,                // Record TTL. If absent or negative, will be assumed to be the default value (`600`).
          "type": enum(                // [required] [immutable]
                                       // Record type.
            "RECORD_TYPE_UNSPECIFIED", // Record type is not specified.
            "A",                       // `A` record: IPv4 address.
            "AAAA",                    // `AAAA` record: IPv6 address.
            "PTR",                     // `PTR` record: mapping from IP address to a domain name.
            "CNAME",                   // `CNAME` record: an alias for a *canonical domain name*.
            "MX",                      // `MX` record: mail server information (domain name, priority).
            "TXT",                     // `TXT` record: text data, typically used to verify e-mail addresses, websites and TLS certificates.
            "SRV",                     // `SRV` record: information about a network service (domain name, port, weight).
            "NS",                      // `NS` record: domain name of an authoritative nameserver for this DNS zone, or one of its subzones.
            "SOA",                     // `SOA` record: administrative information about this DNS zone.
            "CAA",                     // `CAA` record: certificate issuance settings for this DNS zone and its subzones.
            "SVCB",                    // `SVCB` record: service binding. See [RFC 9460, section 2.3](https://www.rfc-editor.org/rfc/rfc9460.html#section-2.3).
            "HTTPS"                    // `HTTPS` record: service binding with HTTPS protocol configuration.
                                       // See [RFC 9460, section 9.1](https://www.rfc-editor.org/rfc/rfc9460.html#section-9.1).
          )
        }
      }
      ```
    </Tab>

    <Tab title="CopyPaste Friendly">
      ```json theme={null}
      nebius dns record create '
      {              
        "metadata": {           
          "labels": {           
            "": ""                  
          },
          "name": "",           
          "parent_id": "",      
          "resource_version": 0 
        },
        "spec": {                                                                                                    
          "data": "",                                                                                                
          "deletion_protection": false,                                                                              
          "relative_name": "",                                                                                       
          "ttl": 0,                                                                                                  
          "type": "record_type_unspecified"|"a"|"aaaa"|"ptr"|"cname"|"mx"|"txt"|"srv"|"ns"|"soa"|"caa"|"svcb"|"https"
        }
      }
      '
      ```
    </Tab>
  </Tabs>
</Expandable>

<strong>Auto generated on 11-Jun-2026</strong>