Responses

• 201 application/json

  The role aggregate that was just created.

  Hide response attributes Show response attributes object

  • id string Required

    The unique id of this role

  • role object Required

    The role data with metadata

    Hide role attributes Show role attributes object

    • value object Required

      The pending stages

      Hide value attributes Show value attributes object

      • id string Required

        The unique id of this role

      • auto_blessed boolean Required

        Whether runners are automatically allowed to be assigned the containers of this role.

      • containers array[object] Required

        The containers that are part of this role

        Represents the association between a Role and a Container Set

        Hide containers attributes Show containers attributes object

        • name string Required

          Name of the association

        • container_set_name string Required

          The container set name (id)

        • kind string Required

          The kind of container set, should be one of 'docker', 'elasticsearch', 'kibana', or 'apm'

        • options object Required

          The container options

          Hide options attributes Show options attributes object

          • enabled boolean Required

            Whether this allocation is active and should be created.

          • auths array[object] Required

            ZooKeeper Auths associated with this allocation

            ZooKeeper Authentication information.

            Hide auths attributes Show auths attributes object

            • scheme string Required

              Scheme identifier, usually "digest"

            • auth string Required

              Plain-text auth. For the "digest" scheme

          • acls array[object] Required

            ZooKeeper ACLs associated with this allocation

            ZooKeeper ACL information.

            Hide acls attributes Show acls attributes object

            • id string Required

              Identity within the provided scheme.

            • perms integer(int32) Required

              Permissions

            • scheme string Required

              Auth scheme, in Elastic Cloud this is usually "digest"

          • runners_secret string

            Secret shared between the runners that have containers in this container set allocated.

          • container_set_secret string

            Secret shared between the containers that are part of this container set.

          • enabled_by_named_feature_flag string

            A named feature flag to check whether this container is enabled or not

          • overrides object

            Allocation-specific overrides for the allocated containers

            Hide overrides attribute Show overrides attribute object

            • container_config object

              Overrides for the container allocation.

              Hide container_config attributes Show container_config attributes object

              • env array[string] Required

                List of environment variables on the form KEY=value

              • host_config object

                Docker host config

                Hide host_config attributes Show host_config attributes object

                • extra_hosts array[string] Required

                  Ports that are exposed by the container.

                • network_mode string

                  Sets the networking mode for the container.

                • cpu_period integer(int32)

                  The length of a CPU period in microsecond

                • restart_policy object

                  Docker behavior to apply when a container exits

                  Hide restart_policy attributes Show restart_policy attributes object

                  • name string Required

                    Identifier for the policy.

                  • maximum_retry_count integer(int32)

                    Maximum number of times to re-try before giving up

                • port_bindings object Required

                  Map of ports that should be exposed on the host.

                  Hide port_bindings attribute Show port_bindings attribute object

                  • * array[object] Additional properties

                    Value used to bind to a port on the host.

                    Hide * attributes Show * attributes object

                    • host_port string Required

                      Port as observed by the host.

                    • host_ip string

                      IP to bind to on the host. I.e {@code 0.0.0.0}

                • binds array[string] Required

                  Volume bindings for the container.

                • privileged boolean Required

                  List of environment variables on the form KEY=value

    • meta object Required

      The metadata

      Hide meta attributes Show meta attributes object

      • created_time string(date-time) Required

        Creation time

      • modified_time string(date-time) Required

        Modification time

      • version string Required

        Version

  • blessings object

    The blessings data associated with the role

    Hide blessings attributes Show blessings attributes object

    • value object Required

      The blessings

      Hide value attribute Show value attribute object

      • runner_ids_to_blessing object Required

        A mapping of Runner Ids to whether or not they are blessed to run the associated role

        Hide runner_ids_to_blessing attribute Show runner_ids_to_blessing attribute object

        • * object Additional properties

          Whether something is blessed or not

          Hide * attribute Show * attribute object

          • value boolean Required

            Whether something is blessed or not

    • meta object Required

      The metadata

      Hide meta attributes Show meta attributes object

      • created_time string(date-time) Required

        Creation time

      • modified_time string(date-time) Required

        Modification time

      • version string Required

        Version

  • pending object

    The pending states data associated with the role

    Hide pending attributes Show pending attributes object

    • value object Required

      The pending stages

      Hide value attribute Show value attribute object

      • runner_ids_to_pending_state object Required

        A mapping of Runner Ids to whether or not they are waiting to be blessed to run the associated role

        Hide runner_ids_to_pending_state attribute Show runner_ids_to_pending_state attribute object

        • * object Additional properties

          Pending state

          Hide * attribute Show * attribute object

          • value boolean Required

            Whether a runner is pending blessings or not

    • meta object Required

      The metadata

      Hide meta attributes Show meta attributes object

      • created_time string(date-time) Required

        Creation time

      • modified_time string(date-time) Required

        Modification time

      • version string Required

        Version

• 409 application/json

  The role ID you specified is already in use. (code: roles.already_exists)

  Hide headers attribute Show headers attribute

  • x-cloud-error-codes string

    The error codes associated with the response

    Value is roles.already_exists.

  Hide response attribute Show response attribute object

  • errors array[object] Required

    A list of errors that occurred in the failing request

    Hide errors attributes Show errors attributes object

    • code string Required

      A structured code representing the error type that occurred

    • message string Required

      A human readable message describing the error that occurred

    • fields array[string]

      If the error can be tied to a specific field or fields in the user request, this lists those fields