Set blessings

PUT /platform/infrastructure/blueprinter/roles/{blueprinter_role_id}/blessings
Basic auth Api key

Set blessings for a role.

Path parameters

  • blueprinter_role_id string Required

    User-specified Blueprinter role ID.

Query parameters

  • version integer

    When specified, checks for conflicts against the version stored in the persistent store (returned in 'x-cloud-resource-version' of the GET request)

application/json

Body Required

The blessings to set.

  • 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

Responses

  • 200 application/json

    The blessings were successfully set.

    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
  • 404 application/json

    The role can't be found. (code: roles.not_found)

    Hide headers attribute Show headers attribute
    • x-cloud-error-codes string

      The error codes associated with the response

      Value is roles.not_found.

    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
  • 409 application/json

    Your request failed because the specified version does not match the persisted version. (code: roles.version_conflict)

    Hide headers attribute Show headers attribute
    • x-cloud-error-codes string

      The error codes associated with the response

      Value is roles.version_conflict.

    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
PUT /platform/infrastructure/blueprinter/roles/{blueprinter_role_id}/blessings 
curl \
 --request PUT 'https://{{hostname}}/api/v1/platform/infrastructure/blueprinter/roles/{blueprinter_role_id}/blessings' \
 --user "username:password" \
 --header "Content-Type: application/json" \
 --data '{"runner_ids_to_blessing":{"additionalProperty1":{"value":true},"additionalProperty2":{"value":true}}}'