diff --git a/website/content/api-docs/agent/check.mdx b/website/content/api-docs/agent/check.mdx index e332a435e0..0af557663f 100644 --- a/website/content/api-docs/agent/check.mdx +++ b/website/content/api-docs/agent/check.mdx @@ -40,6 +40,12 @@ The table below shows this endpoint's support for - `filter` `(string: "")` - Specifies the expression used to filter the queries results prior to returning the data. +- `ns` `(string: "")` - Specifies the namespace in + which to list checks. This value can be specified as the `ns` URL query + parameter or the `X-Consul-Namespace` header. If not provided by either, + the namespace will be inherited from the request's ACL token or will default + to the `default` namespace. Added in Consul 1.7.0. + ### Sample Request ```shell-session @@ -60,7 +66,13 @@ $ curl \ "Output": "", "ServiceID": "redis", "ServiceName": "redis", - "ServiceTags": ["primary"] + "ServiceTags": ["primary"], + "Type": "tcp", + "ExposedPort": 0, + "Definition": {}, + "Namespace": "default", + "CreateIndex": 0, + "ModifyIndex": 0 } } ``` @@ -110,6 +122,13 @@ The table below shows this endpoint's support for This defaults to the `"Name"` parameter, but it may be necessary to provide an ID for uniqueness. This value will return in the response as `"CheckId"`. +- `Namespace` `(string: "")` - Specifies the namespace in + which to register the check. This parameter is only valid for service checks. + If not provided in the JSON body, the value of the `ns` URL query parameter or + in the `X-Consul-Namespace` header will be used. If not provided by either, + the namespace will be inherited from the request's ACL token or will default + to the `default` namespace. Added in Consul 1.7.0. + - `Interval` `(string: "")` - Specifies the frequency at which to run this check. This is required for HTTP and TCP checks. @@ -208,8 +227,9 @@ The table below shows this endpoint's support for made to both addresses, and the first successful connection attempt will result in a successful check. -- `TTL` `(string: "")` - Specifies this is a TTL check, and the TTL endpoint - must be used periodically to update the state of the check. +- `TTL` `(duration: 10s)` - Specifies this is a TTL check, and the TTL endpoint + must be used periodically to update the state of the check. If the check is not + set to passing within the specified duration, then the check will be set to the failed state. - `ServiceID` `(string: "")` - Specifies the ID of a service to associate the registered check with an existing service provided by the agent. @@ -230,6 +250,7 @@ The table below shows this endpoint's support for { "ID": "mem", "Name": "Memory utilization", + "Namespace": "default", "Notes": "Ensure we don't oversubscribe memory", "DeregisterCriticalServiceAfter": "90m", "Args": ["/usr/local/bin/check_mem.py"], @@ -280,6 +301,12 @@ The table below shows this endpoint's support for - `check_id` `(string: "")` - Specifies the unique ID of the check to deregister. This is specified as part of the URL. +- `ns` `(string: "")` - Specifies the namespace in + which to deregister the check. This value can be specified as the `ns` URL query + parameter or the `X-Consul-Namespace` header. If not provided by either, + the namespace will be inherited from the request's ACL token or will default + to the `default` namespace. Added in Consul 1.7.0. + ### Sample Request ```shell-session @@ -315,6 +342,12 @@ The table below shows this endpoint's support for - `note` `(string: "")` - Specifies a human-readable message. This will be passed through to the check's `Output` field. +- `ns` `(string: "")` - Specifies the namespace in + which to update the check. This value can be specified as the `ns` URL query + parameter or the `X-Consul-Namespace` header. If not provided by either, + the namespace will be inherited from the request's ACL token or will default + to the `default` namespace. Added in Consul 1.7.0. + ### Sample Request ```shell-session @@ -350,6 +383,12 @@ The table below shows this endpoint's support for - `note` `(string: "")` - Specifies a human-readable message. This will be passed through to the check's `Output` field. +- `ns` `(string: "")` - Specifies the namespace in + which to update the check. This value can be specified as the `ns` URL query + parameter or the `X-Consul-Namespace` header. If not provided by either, + the namespace will be inherited from the request's ACL token or will default + to the `default` namespace. Added in Consul 1.7.0. + ### Sample Request ```shell-session @@ -384,6 +423,12 @@ The table below shows this endpoint's support for - `note` `(string: "")` - Specifies a human-readable message. This will be passed through to the check's `Output` field. +- `ns` `(string: "")` - Specifies the namespace in + which to update the check. This value can be specified as the `ns` URL query + parameter or the `X-Consul-Namespace` header. If not provided by either, + the namespace will be inherited from the request's ACL token or will default + to the `default` namespace. Added in Consul 1.7.0. + ### Sample Request ```shell-session @@ -421,6 +466,12 @@ The table below shows this endpoint's support for - `Output` `(string: "")` - Specifies a human-readable message. This will be passed through to the check's `Output` field. +- `ns` `(string: "")` - Specifies the namespace in + which to update the check. This value can be specified as the `ns` URL query + parameter or the `X-Consul-Namespace` header. If not provided by either, + the namespace will be inherited from the request's ACL token or will default + to the `default` namespace. Added in Consul 1.7.0. + ### Sample Payload ```json diff --git a/website/content/api-docs/agent/connect.mdx b/website/content/api-docs/agent/connect.mdx index e319c60319..2e31ac1254 100644 --- a/website/content/api-docs/agent/connect.mdx +++ b/website/content/api-docs/agent/connect.mdx @@ -194,6 +194,12 @@ The table below shows this endpoint's support for certificate. This is specified in the URL. The service does not need to exist in the catalog, but the proper ACL permissions must be available. +- `ns` `(string: "")` - Specifies the namespace in + which to request the leaf certificate. This value can be specified as the `ns` + URL query parameter or the `X-Consul-Namespace` header. If not provided by either, + the namespace will be inherited from the request's ACL token or will default + to the `default` namespace. Added in Consul 1.7.0. + ### Sample Request ```shell-session @@ -212,6 +218,7 @@ $ curl \ "ServiceURI": "spiffe://11111111-2222-3333-4444-555555555555.consul/ns/default/dc/dc1/svc/web", "ValidAfter": "2018-05-21T16:33:28Z", "ValidBefore": "2018-05-24T16:33:28Z", + "Namespace": "default", "CreateIndex": 5, "ModifyIndex": 5 } diff --git a/website/content/api-docs/discovery-chain.mdx b/website/content/api-docs/discovery-chain.mdx index 909a1d605b..bc1d1b00b9 100644 --- a/website/content/api-docs/discovery-chain.mdx +++ b/website/content/api-docs/discovery-chain.mdx @@ -61,6 +61,12 @@ The table below shows this endpoint's support for [`datacenter`](/docs/connect/registration/service-registration#datacenter) parameter. +- `ns` `(string: "")` - Specifies the source namespace + to use as the basis of compilation. This value can be specified as the `ns` + URL query parameter or the `X-Consul-Namespace` header. If not provided by either, + the namespace will be inherited from the request's ACL token or will default + to the `default` namespace. Added in Consul 1.7.0. + ### POST Body Parameters - `OverrideConnectTimeout` `(duration: 0s)` - Overrides the final [connect