create

{              
  "metadata": {                // [required]
    "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]
    "after_n_empty_iterations": {           // Cannot be set together with: after_one_iteration, infinite
      "empty_iterations_threshold": uint32  // [required]
                                            // Number of consecutive iterations with zero transferred objects required to stop transfer.
    },
    "after_one_iteration": { // [meaningful_empty_value]
                             // Cannot be set together with: after_n_empty_iterations, infinite
    },
    "destination": {         // [required]
      "bucket_name": string, // [required] [immutable]
      "credentials": {        // [input_only]
                              // Credentials for accessing the destination bucket. These credentials must have head and write permissions.
                              // This parameter must be specified only during create operations.
        "access_key": {                // Cannot be set together with: anonymous, azure_access_key
          "access_key_id": string,     // [required] [sensitive]
          "secret_access_key": string  // [required] [sensitive]
        },
        "anonymous": { // [meaningful_empty_value]
                       // Cannot be set together with: access_key, azure_access_key
        },
        "azure_access_key": {     // Cannot be set together with: anonymous, access_key
          "access_key": string,   // [required] [sensitive]
          "account_name": string  // [required] [sensitive]
        }
      },
      "endpoint": string,    // [immutable]
                             // The endpoint must be in the form of a URL, starting with the protocol (https),
                             // followed by the endpoint address without a trailing slash.
                             // Example: https://storage.us-central1.nebius.cloud.
      "prefix": string,      // [immutable]
                             // Prefix to add to the beginning of each transferred object key in the destination bucket.
                             // During transfer, the resulting object key in the destination bucket is computed
                             // by removing source.prefix (if provided) from the original key and then prepending destination.prefix.
                             // Important: This transformation may result in an empty object key or one that exceeds allowed length limits.
                             // Use prefixes that guarantee valid resulting object keys for your objects after transformation.
      "region": string       // [immutable]
    },
    "infinite": { // [meaningful_empty_value]
                  // Cannot be set together with: after_one_iteration, after_n_empty_iterations
                  // Infinite transfers do not stop automatically and can be stopped manually by the user.
    },
    "inter_iteration_interval": "2h30m10s", // [google.protobuf.Duration] [non_empty_default]
                                            // Time to wait between transfer iterations. Default is 15 minutes if not specified.
    "overwrite_strategy": enum(         // [required]
                                        // Overwrite strategy set logic of overwrite already existed objects in destination bucket.
      "OVERWRITE_STRATEGY_UNSPECIFIED",
      "NEVER",                          // Never overwrite objects that exist in the destination.
                                        // If object exists in destination bucket, skip it.
                                        // Safest option to prevent data loss.
      "IF_NEWER",                       // Overwrite only if source object is newer than destination.
                                        // Comparison based on Last-Modified timestamp.
                                        // Recommended for incremental sync scenarios.
      "ALWAYS"                          // Always overwrite destination objects unconditionally.
                                        // Use with caution - may cause data loss in destination.
                                        // Suitable for full bucket synchronization.
    ),
    "source": {              // [required]
      "bucket_name": string, // [required] [immutable]
      "credentials": {        // [input_only]
                              // Credentials for accessing the source bucket. These credentials must have list and get permissions.
                              // This parameter must be specified only during create operations.
        "access_key": {                // Cannot be set together with: anonymous, azure_access_key
          "access_key_id": string,     // [required] [sensitive]
          "secret_access_key": string  // [required] [sensitive]
        },
        "anonymous": { // [meaningful_empty_value]
                       // Cannot be set together with: access_key, azure_access_key
        },
        "azure_access_key": {     // Cannot be set together with: anonymous, access_key
          "access_key": string,   // [required] [sensitive]
          "account_name": string  // [required] [sensitive]
        }
      },
      "endpoint": string,    // [required] [immutable]
                             // The endpoint must be in the form of a URL, starting with the protocol (https),
                             // followed by the endpoint address without a trailing slash.
                             // Example: https://storage.us-central1.nebius.cloud.
      "limiters": {                           // Limiters applied to source bucket operations. These limits include all operations
                                              // required for transfer (HeadObject, GetObject, ListObjects). For details about
                                              // which operations are used, see public documentation: http://docs.nebius.com/object-storage/transfer/quickstart#background.
                                              // 
                                              // Note: Since the service performs comparable request volumes and data transfers
                                              // to both source and destination, these limits will indirectly constrain
                                              // destination operations as well.
        "bandwidth_bytes_per_second": uint64, // Maximum bandwidth in bytes per second. If set to zero, default limit will be applied.
        "requests_per_second": uint64         // Maximum number of requests per second. If set to zero, default limit will be applied.
      },
      "prefix": string,      // [immutable]
                             // Prefix to filter objects in the source bucket. Only objects whose keys start with this prefix will be transferred.
                             // During transfer, the resulting object key in the destination bucket is computed
                             // by removing source.prefix from the original key and then prepending destination.prefix (if provided).
                             // Important: This transformation may result in an empty object key or one that exceeds allowed length limits.
                             // Use prefixes that guarantee valid resulting object keys for your objects after transformation.
      "region": string       // [required] [immutable]
    }
  }
}