- release_tracks: [ALPHA, BETA, GA]

  help_text:
    brief: |
      Create a new Memorystore for Redis Cluster instance.
    description: |
      Create a new Memorystore for Redis Cluster instance, and uses Private Service Connect service connectivity automation to automate connectivity for instances.

      This command can fail for the following reasons:
        * A cluster with the same name already exists.
        * The active account does not have permission to create clusters.
        * Some required APIs not enabled yet.
        * No connection policy defined yet on the network and in the region a cluster will be created.
        * Miss the steps for creating and configuring a service account (to grant permissions) in both host project and service project, if a shared VPC network is used.

      Refer to https://cloud.google.com/memorystore/docs/cluster/networking#prerequisites_required_before_creating_a_cluster for prerequisites.
    examples: |
      To create a cluster with name `my-redis-cluster` in region `us-central1`
      with 3 shards and with a discovery endpoint created on network "default", run:

        $ {command} my-redis-cluster --region=us-central1 --shard-count=3 \
            --network=projects/NETWORK_PROJECT_ID/global/networks/default

  arguments:
    resource:
      spec: !REF googlecloudsdk.command_lib.redis.resources:cluster
      help_text: |
        Arguments and flags that specify the cluster you want to create.
        Your cluster ID must be 1 to 63 characters and use only lowercase letters, numbers, or
        hyphens. It must start with a lowercase letter and end with a lowercase letter or number.
    params:
    - arg_name: node-type
      api_field: cluster.nodeType
      help_text: Node Type of the redis cluster Node.
      choices:
      - enum_value: REDIS_HIGHMEM_MEDIUM
        arg_value: redis-highmem-medium
      - enum_value: REDIS_HIGHMEM_XLARGE
        arg_value: redis-highmem-xlarge
      - enum_value: REDIS_STANDARD_SMALL
        arg_value: redis-standard-small
      - enum_value: REDIS_SHARED_CORE_NANO
        arg_value: redis-shared-core-nano
    - arg_name: network
      api_field: cluster.pscConfigs.network
      help_text: |
         The network used to create your instance. It must use the format:
         projects/NETWORK_PROJECT_ID/global/networks/NETWORK_ID.
         The network ID used here must match the network ID used by the service connection policy.
         Otherwise, the create operation fails
    - arg_name: auth-mode
      api_field: cluster.authorizationMode
      help_text: |
        Available authorization mode of a Redis cluster.
      choices:
      - enum_value: AUTH_MODE_DISABLED
        arg_value: disabled
        help_text: |
            Authorization is disabled for the cluster.
      - enum_value: AUTH_MODE_IAM_AUTH
        arg_value: iam-auth
        help_text: |
            IAM basic authorization is enabled for the cluster.
    - arg_name: replica-count
      api_field: cluster.replicaCount
      type: int
      help_text: |
        The replica count of each shard.
    - arg_name: shard-count
      api_field: cluster.shardCount
      type: int
      help_text: |
        The shard count of the cluster.
    - arg_name: transit-encryption-mode
      api_field: cluster.transitEncryptionMode
      help_text: |
        Transit encryption mode used for the Redis cluster.
        If not provided, encryption is disabled for the cluster.
      choices:
      - enum_value: TRANSIT_ENCRYPTION_MODE_DISABLED
        arg_value: disabled
        help_text: |
          In-transit encryption is disabled for the cluster.
      - enum_value: TRANSIT_ENCRYPTION_MODE_SERVER_AUTHENTICATION
        arg_value: server-authentication
        help_text: |
          The cluster uses server managed encryption for in-transit encryption.
    - arg_name: deletion-protection
      api_field: cluster.deletionProtectionEnabled
      type: bool
      # To distinguish b/w unset and default value. Otherwise, the request is always sent with
      # deletionProtectionEnabled=false.
      default: null
      help_text: |
        Enable deletion protection for the Redis Cluster. Use
        `--deletion-protection`/`--no-deletion-protection` to enable/disable it.
    - arg_name: redis-config
      api_field: cluster.redisConfigs.additionalProperties
      metavar: KEY=VALUE
      help_text: |
        A list of Redis config KEY=VALUE pairs to set on the Redis Cluster according to
        http://redis.io/topics/config. Currently the supported Redis configs are:

          maxmemory-clients, maxmemory, maxmemory-policy, notify-keyspace-events,
          slowlog-log-slower-than, maxclients.
      type:
        arg_dict:
          flatten: true
          spec:
          - api_field: key
          - api_field: value
    - arg_name: zone-distribution-mode
      api_field: cluster.zoneDistributionConfig.mode
      help_text: |
        Determines how the cluster nodes are distributed across zones.
      choices:
      - enum_value: MULTI_ZONE
        arg_value: multi-zone
        help_text: |
          Allocate cluster nodes across multiple zones.
      - enum_value: SINGLE_ZONE
        arg_value: single-zone
        help_text: |
          Allocate cluster nodes in a single zone.
    - arg_name: zone
      api_field: cluster.zoneDistributionConfig.zone
      help_text: |
        The zone used to allocate the cluster nodes. Applicable only if the zone-distribution-mode
        is set to single-zone.
    - arg_name: persistence-mode
      api_field: cluster.persistenceConfig.mode
      help_text: |
        Operation mode for persistence.
      choices:
      - enum_value: DISABLED
        arg_value: disabled
        help_text: Persistence mode is disabled
      - enum_value: RDB
        arg_value: RDB
        help_text: RDB-based persistence
      - enum_value: AOF
        arg_value: AOF
        help_text: AOF-based persistence
    - arg_name: rdb-snapshot-period
      api_field: cluster.persistenceConfig.rdbConfig.rdbSnapshotPeriod
      help_text: |
        Attempted period between RDB snapshots.
      choices:
      - enum_value: ONE_HOUR
        arg_value: 1h
        help_text: 1 hour
      - enum_value: SIX_HOURS
        arg_value: 6h
        help_text: 6 hours
      - enum_value: TWELVE_HOURS
        arg_value: 12h
        help_text: 12 hours
      - enum_value: TWENTY_FOUR_HOURS
        arg_value: 24h
        help_text: (default) 24 hours
    - arg_name: rdb-snapshot-start-time
      api_field: cluster.persistenceConfig.rdbConfig.rdbSnapshotStartTime
      help_text: |
        Date and time of the first snapshot in the ISO 1801 format, and alignment time for future snapshots. For example, 2024-01-01T01:00:00Z.
        If not specified, the current time will be used.
    - arg_name: aof-append-fsync
      api_field: cluster.persistenceConfig.aofConfig.appendFsync
      help_text: |
        Fsync configuration.
      choices:
      - enum_value: NO  # yamllint disable-line rule:truthy
        arg_value: no  # yamllint disable-line rule:truthy
        help_text: |
          Redis will not explicitly call fsync.
      - enum_value: EVERYSEC
        arg_value: everysec
        help_text: |
          (default) Redis explicitly calls fsync every second.
      - enum_value: ALWAYS
        arg_value: always
        help_text: |
          Redis explicitly calls fsync for every write command.
    - arg_name: maintenance-window-day
      api_field: cluster.maintenancePolicy.weeklyMaintenanceWindow.day
      choices:
      - arg_value: monday
        enum_value: MONDAY
      - arg_value: tuesday
        enum_value: TUESDAY
      - arg_value: wednesday
        enum_value: WEDNESDAY
      - arg_value: thursday
        enum_value: THURSDAY
      - arg_value: friday
        enum_value: FRIDAY
      - arg_value: saturday
        enum_value: SATURDAY
      - arg_value: sunday
        enum_value: SUNDAY
      help_text: |
          Day of week when the window starts, e.g. `sunday`.
    - arg_name: maintenance-window-hour
      api_field: cluster.maintenancePolicy.weeklyMaintenanceWindow.startTime.hours
      help_text: |
        Hour of day (`0` to `23`) for the start of maintenance window, in UTC time zone.
      processor: googlecloudsdk.command_lib.redis.clusters_update_util:CheckMaintenanceWindowStartTimeField
    - arg_name: cross-cluster-replication-role
      api_field: cluster.crossClusterReplicationConfig.clusterRole
      help_text: |
        The role of the cluster in cross cluster replication.
      choices:
      - enum_value: SECONDARY
        arg_value: secondary
        help_text: |
         Create a secondary cluster.
    - arg_name: primary-cluster
      api_field: cluster.crossClusterReplicationConfig.primaryCluster.cluster
      help_text: |
        The primary cluster that the secondary cluster will replicate from. It must use the format:
        projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID. It must refer to an existing cluster. Otherwise, the create operation fails.


  async:
    collection: redis.projects.locations.operations

  request:
    ALPHA:
      api_version: v1alpha1
    BETA:
      api_version: v1beta1
    GA:
      api_version: v1
    collection: redis.projects.locations.clusters

  output:
    format: yaml