Update security deployment

PUT /platform/configuration/security/deployment

Updates an existing security deployment configuration.

Body Required

The update request

  • version string

    The version of Elasticsearch to upgrade to. When not included, no upgrade is performed.

  • topology object

    The cluster topology used to create the security deployment cluster

    Additional properties are allowed.

    Hide topology attributes Show topology attributes object
    • size object

      Measured by the amount of a resource. The final cluster size is calculated using multipliers from the topology instance configuration.

      Additional properties are allowed.

      Hide size attributes Show size attributes object
      • value integer(int32) Required

        Amount of resource

      • resource string Required

        Type of resource

        Values are memory or storage.

    • zone_count integer(int32)

      The number of zones in which data nodes will be placed

Responses

  • 200

    The security deployment was successfully updated

    Hide headers attributes Show headers attributes
    Hide response attribute Show response attribute object
    • id string Required

      The ID
  • 404

    The security deployment was not found. (code: security_deployment.not_found)

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

      The error codes associated with the response

      Value is security_deployment.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
    • There is a version conflict. (code: security_deployment.version_conflict)
    • There is a version conflict. (code: security_deployment.already_exists)
    Hide headers attribute Show headers attribute
    • x-cloud-error-codes string

      The error codes associated with the response

      Values are security_deployment.version_conflict or security_deployment.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
PUT /platform/configuration/security/deployment 
curl \
 -X PUT https://{{hostname}}/api/v1/platform/configuration/security/deployment \
 -d '{"version":"string","topology":{"size":{"value":42,"resource":"memory"},"zone_count":42}}'
Request examples 
{
  "version": "string",
  "topology": {
    "size": {
      "value": 42,
      "resource": "memory"
    },
    "zone_count": 42
  }
}
Response examples (200) 
# Headers
x-cloud-resource-version: string
x-cloud-resource-created: string
x-cloud-resource-last-modified: string

# Payload
{
  "id": "string"
}
Response examples (404) 
# Headers
x-cloud-error-codes: security_deployment.not_found

# Payload
{
  "errors": [
    {
      "code": "string",
      "message": "string",
      "fields": [
        "string"
      ]
    }
  ]
}
Response examples (409) 
# Headers
x-cloud-error-codes: security_deployment.version_conflict

# Payload
{
  "errors": [
    {
      "code": "string",
      "message": "string",
      "fields": [
        "string"
      ]
    }
  ]
}