Skip to main content

diagrid configuration update

Update a Dapr configuration

Description​

Update a Dapr configuration resource in a project.

Inline spec flags are merged into the existing configuration section-by-section: a section is only touched when at least one of its flags is set, and unset fields keep their current value. The full inline flag surface is identical to 'diagrid configuration create'.

To replace a configuration wholesale, use --file or 'diagrid apply -f'.

diagrid configuration update <configuration> [flags]

Examples​


  # Update a configuration's default action
  diagrid configuration update my-config --project my-project --default-action allow

  # Update a configuration's policies
  diagrid configuration update my-config --project my-project --policy app1:deny --policy app2:allow

  # Update tracing settings (merged into the existing spec)
  diagrid configuration update my-config --project my-project --tracing-sampling-rate 0.5

  # Point tracing at an OpenTelemetry collector
  diagrid configuration update my-config --project my-project --tracing-otel-endpoint otel-collector:4317 --tracing-otel-protocol grpc

  # Send an auth header to an OpenTelemetry collector
  diagrid configuration update my-config --project my-project --tracing-otel-endpoint otel-collector:4317 --tracing-otel-secure --tracing-otel-header 'Authorization:Bearer <token>'

  # Update workflow state retention
  diagrid configuration update my-config --project my-project --workflow-retention-completed 2h --workflow-retention-failed 24h

  # Set an HTTP middleware pipeline
  diagrid configuration update my-config --project my-project --http-pipeline-handler ratelimit:middleware.http.ratelimit

  # Replace a configuration with the contents of a YAML manifest
  diagrid configuration update my-config --project my-project --file my-config.yaml

  # To replace an existing configuration in place, you can also use 'diagrid apply':
  diagrid apply --project my-project -f my-config.yaml

Options​

  -p, --project string                             Name of existing project
      --default-action string                      Default access control action (allow or deny)
      --policy stringArray                         Access control policies in format 'appId:action' (e.g. --policy app1:allow --policy app2:deny)
      --tracing-sampling-rate string               Tracing sampling rate, e.g. '1' (all) or '0.5'
      --tracing-otel-endpoint string               OpenTelemetry collector endpoint address (host:port)
      --tracing-otel-protocol string               OpenTelemetry export protocol (grpc or http)
      --tracing-otel-secure                        Use a secure (TLS) connection to the OpenTelemetry endpoint
      --tracing-otel-header stringArray            Header added to every OTLP exporter request in format 'name:value', e.g. --tracing-otel-header 'Authorization:Bearer <token>' (repeatable; value may contain ':')
      --workflow-max-concurrent-workflows int32    Max concurrent workflow invocations per Dapr instance (honored in private regions only)
      --workflow-max-concurrent-activities int32   Max concurrent activity invocations per Dapr instance (honored in private regions only)
      --workflow-retention-completed string        TTL before purging Completed workflow instances, e.g. '1h', '30m'
      --workflow-retention-failed string           TTL before purging Failed workflow instances, e.g. '24h'
      --workflow-retention-terminated string       TTL before purging Terminated workflow instances
      --workflow-retention-any-terminal string     TTL before purging workflow instances in any terminal state
      --http-pipeline-handler stringArray          Inbound HTTP middleware handler in format 'name:type' (repeatable, order significant)
      --app-http-pipeline-handler stringArray      App-channel HTTP middleware handler in format 'name:type' (repeatable, order significant)
  -f, --file string                                Path to a YAML manifest describing the Configuration. Mutually exclusive with the inline spec flags.
  -w, --wait                                       Wait for long-running resource update to finish
  -h, --help                                       help for update

Options inherited from parent commands​

      --api-key string   Diagrid Cloud API key

SEE ALSO​

Last updated on