"description":"The general form represented is:\n\n[scheme:][//[userinfo@]host][/]path[?query][#fragment]\n\nURLs that do not start with a slash after the scheme are interpreted as:\n\nscheme:opaque[?query][#fragment]\n\nThe Host field contains the host and port subcomponents of the URL.\nWhen the port is present, it is separated from the host with a colon.\nWhen the host is an IPv6 address, it must be enclosed in square brackets:\n\"[fe80::1]:80\". The [net.JoinHostPort] function combines a host and port\ninto a string suitable for the Host field, adding square brackets to\nthe host when necessary.\n\nNote that the Path field is stored in decoded form: /%47%6f%2f becomes /Go/.\nA consequence is that it is impossible to tell which slashes in the Path were\nslashes in the raw URL and which were %2f. This distinction is rarely important,\nbut when it is, the code should use the [URL.EscapedPath] method, which preserves\nthe original encoding of Path.\n\nThe RawPath field is an optional field which is only set when the default\nencoding of Path is different from the escaped path. See the EscapedPath method\nfor more details.\n\nURL's String method uses the EscapedPath method to obtain the path.",
"properties":{
"ForceQuery":{
"type":"boolean"
@ -4273,7 +4272,7 @@
"$ref":"#/definitions/Userinfo"
}
},
"title":"A URL represents a parsed URL (technically, a URI reference).",
"title":"URL is a custom URL type that allows validation at configuration load time.",
"type":"object"
},
"UpdateRuleGroupResponse":{
@ -4738,31 +4737,6 @@
},
"type":"array"
},
"gettableGrafanaSilence":{
"properties":{
"accessControl":{
"additionalProperties":{
"type":"boolean"
},
"example":{
"create":false,
"read":true,
"write":false
},
"type":"object"
},
"metadata":{
"$ref":"#/definitions/SilenceMetadata"
}
},
"type":"object"
},
"gettableGrafanaSilences":{
"items":{
"$ref":"#/definitions/gettableGrafanaSilence"
},
"type":"array"
},
"gettableSilence":{
"description":"GettableSilence gettable silence",
"properties":{
@ -4891,14 +4865,6 @@
},
"type":"array"
},
"overrideLabels":{
"additionalProperties":{
"type":"string"
},
"description":"The custom marshaling for labels.Labels ends up doing this anyways.",
"title":"override the labels type with a map for generation.",
"description":"The general form represented is:\n\n[scheme:][//[userinfo@]host][/]path[?query][#fragment]\n\nURLs that do not start with a slash after the scheme are interpreted as:\n\nscheme:opaque[?query][#fragment]\n\nThe Host field contains the host and port subcomponents of the URL.\nWhen the port is present, it is separated from the host with a colon.\nWhen the host is an IPv6 address, it must be enclosed in square brackets:\n\"[fe80::1]:80\". The [net.JoinHostPort] function combines a host and port\ninto a string suitable for the Host field, adding square brackets to\nthe host when necessary.\n\nNote that the Path field is stored in decoded form: /%47%6f%2f becomes /Go/.\nA consequence is that it is impossible to tell which slashes in the Path were\nslashes in the raw URL and which were %2f. This distinction is rarely important,\nbut when it is, the code should use the [URL.EscapedPath] method, which preserves\nthe original encoding of Path.\n\nThe RawPath field is an optional field which is only set when the default\nencoding of Path is different from the escaped path. See the EscapedPath method\nfor more details.\n\nURL's String method uses the EscapedPath method to obtain the path.",
"properties":{
"ForceQuery":{
"type":"boolean"
@ -4269,7 +4273,7 @@
"$ref":"#/definitions/Userinfo"
}
},
"title":"URL is a custom URL type that allows validation at configuration load time.",
"title":"A URL represents a parsed URL (technically, a URI reference).",
"description":"The custom marshaling for labels.Labels ends up doing this anyways.",
"title":"override the labels type with a map for generation.",
"type":"object"
},
"peerStatus":{
"description":"PeerStatus peer status",
"properties":{
@ -8586,13 +8582,74 @@
},
"/v1/rules/history":{
"get":{
"description":"Allows to query alerting state history.\nIn addition to defined query parameters it accepts filter by labels. The query parameter name must start with 'labels_'\nExample: /v1/rules/history?labels_myKey1=myValue1\u0026labels_myKey2=myValue2",
"operationId":"RouteGetStateHistory",
"parameters":[
{
"description":"The timestamp of the start point of the time range the history is obtained.",
"format":"int64",
"in":"query",
"name":"from",
"type":"integer"
},
{
"description":"The timestamp of the end point of the time range the history is obtained.",
"format":"int64",
"in":"query",
"name":"to",
"type":"integer"
},
{
"description":"Limits the number of records that needs to be returned.",
"format":"int64",
"in":"query",
"name":"limit",
"type":"integer"
},
{
"description":"Filter by rule UID. Required the state history is configured to use annotations for storage.",
"in":"query",
"name":"ruleUID",
"type":"string"
},
{
"description":"Filter by rules that are or were assigned to the specific dashboard.",
"in":"query",
"name":"DashboardUID",
"type":"string"
},
{
"description":"Filter by dashboard's panel ID. Requires Dashboard UID to be specified.",
"description":"Allows to query alerting state history.\nIn addition to defined query parameters it accepts filter by labels. The query parameter name must start with 'labels_'\nExample: /v1/rules/history?labels_myKey1=myValue1\u0026labels_myKey2=myValue2",
"produces":[
"application/json"
],
@ -3547,9 +3548,69 @@
],
"summary":"Query state history.",
"operationId":"RouteGetStateHistory",
"parameters":[
{
"type":"integer",
"format":"int64",
"description":"The timestamp of the start point of the time range the history is obtained.",
"name":"from",
"in":"query"
},
{
"type":"integer",
"format":"int64",
"description":"The timestamp of the end point of the time range the history is obtained.",
"name":"to",
"in":"query"
},
{
"type":"integer",
"format":"int64",
"description":"Limits the number of records that needs to be returned.",
"name":"limit",
"in":"query"
},
{
"type":"string",
"description":"Filter by rule UID. Required the state history is configured to use annotations for storage.",
"name":"ruleUID",
"in":"query"
},
{
"type":"string",
"description":"Filter by rules that are or were assigned to the specific dashboard.",
"name":"DashboardUID",
"in":"query"
},
{
"type":"integer",
"format":"int64",
"description":"Filter by dashboard's panel ID. Requires Dashboard UID to be specified.",
"name":"PanelID",
"in":"query"
}
],
"responses":{
"200":{
"$ref":"#/responses/StateHistory"
},
"403":{
"description":"ForbiddenError",
"schema":{
"$ref":"#/definitions/ForbiddenError"
}
},
"404":{
"description":"NotFound",
"schema":{
"$ref":"#/definitions/NotFound"
}
},
"500":{
"description":"Failure",
"schema":{
"$ref":"#/definitions/Failure"
}
}
}
}
@ -3574,10 +3635,10 @@
"format":"date-time"
},
"annotations":{
"$ref":"#/definitions/overrideLabels"
"$ref":"#/definitions/Labels"
},
"labels":{
"$ref":"#/definitions/overrideLabels"
"$ref":"#/definitions/Labels"
},
"state":{
"type":"string"
@ -3992,7 +4053,7 @@
}
},
"annotations":{
"$ref":"#/definitions/overrideLabels"
"$ref":"#/definitions/Labels"
},
"duration":{
"type":"number",
@ -4006,7 +4067,7 @@
"type":"string"
},
"labels":{
"$ref":"#/definitions/overrideLabels"
"$ref":"#/definitions/Labels"
},
"lastError":{
"type":"string"
@ -5269,6 +5330,9 @@
"items":{
"$ref":"#/definitions/TimeIntervalItem"
}
},
"version":{
"type":"string"
}
}
},
@ -7021,7 +7085,7 @@
"type":"string"
},
"labels":{
"$ref":"#/definitions/overrideLabels"
"$ref":"#/definitions/Labels"
},
"lastError":{
"type":"string"
@ -7788,8 +7852,9 @@
}
},
"URL":{
"description":"The general form represented is:\n\n[scheme:][//[userinfo@]host][/]path[?query][#fragment]\n\nURLs that do not start with a slash after the scheme are interpreted as:\n\nscheme:opaque[?query][#fragment]\n\nThe Host field contains the host and port subcomponents of the URL.\nWhen the port is present, it is separated from the host with a colon.\nWhen the host is an IPv6 address, it must be enclosed in square brackets:\n\"[fe80::1]:80\". The [net.JoinHostPort] function combines a host and port\ninto a string suitable for the Host field, adding square brackets to\nthe host when necessary.\n\nNote that the Path field is stored in decoded form: /%47%6f%2f becomes /Go/.\nA consequence is that it is impossible to tell which slashes in the Path were\nslashes in the raw URL and which were %2f. This distinction is rarely important,\nbut when it is, the code should use the [URL.EscapedPath] method, which preserves\nthe original encoding of Path.\n\nThe RawPath field is an optional field which is only set when the default\nencoding of Path is different from the escaped path. See the EscapedPath method\nfor more details.\n\nURL's String method uses the EscapedPath method to obtain the path.",
"type":"object",
"title":"URL is a custom URL type that allows validation at configuration load time.",
"title":"A URL represents a parsed URL (technically, a URI reference).",
Yuri Tseretyan
1 year ago
committed by