{ "opencollection": "1.0.0", "info": { "name": "Emissary-Ingress Configuration AuthService Mapping API", "version": "3.9.0" }, "items": [ { "info": { "name": "Mapping", "type": "folder" }, "items": [ { "info": { "name": "Emissary-Ingress List Mapping resources in a namespace", "type": "http" }, "http": { "method": "GET", "url": "https://{kubernetes-api-server}/apis/getambassador.io/v3alpha1/namespaces/:namespace/mappings", "params": [ { "name": "namespace", "value": "", "type": "path", "description": "The Kubernetes namespace of the resource." }, { "name": "labelSelector", "value": "", "type": "query", "description": "A selector to restrict the list of returned resources by their labels. Defaults to everything." }, { "name": "fieldSelector", "value": "", "type": "query", "description": "A selector to restrict the list of returned resources by their fields." }, { "name": "limit", "value": "", "type": "query", "description": "Maximum number of responses to return per page. If there are additional results, a continue token is returned." }, { "name": "continue", "value": "", "type": "query", "description": "A continuation token for paginating through large result sets, returned from a previous list call." } ] }, "docs": "Returns a list of all Mapping custom resources in the specified Kubernetes namespace. Mappings define how inbound HTTP/HTTPS requests are routed to backend services based on URL prefix, headers, and other match criteria." }, { "info": { "name": "Emissary-Ingress Create a Mapping resource", "type": "http" }, "http": { "method": "POST", "url": "https://{kubernetes-api-server}/apis/getambassador.io/v3alpha1/namespaces/:namespace/mappings", "params": [ { "name": "namespace", "value": "", "type": "path", "description": "The Kubernetes namespace of the resource." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Creates a new Mapping custom resource in the specified namespace. The Mapping defines routing rules including the URL prefix, target service, rewrite rules, timeout policies, retry policies, CORS settings, and traffic weighting for canary or A/B deployments." }, { "info": { "name": "Emissary-Ingress Get a specific Mapping resource", "type": "http" }, "http": { "method": "GET", "url": "https://{kubernetes-api-server}/apis/getambassador.io/v3alpha1/namespaces/:namespace/mappings/:name", "params": [ { "name": "namespace", "value": "", "type": "path", "description": "The Kubernetes namespace of the resource." }, { "name": "name", "value": "", "type": "path", "description": "The name of the resource." } ] }, "docs": "Returns the specified Mapping custom resource from the given namespace, including its current status, route configuration, and observed generation information." }, { "info": { "name": "Emissary-Ingress Replace a Mapping resource", "type": "http" }, "http": { "method": "PUT", "url": "https://{kubernetes-api-server}/apis/getambassador.io/v3alpha1/namespaces/:namespace/mappings/:name", "params": [ { "name": "namespace", "value": "", "type": "path", "description": "The Kubernetes namespace of the resource." }, { "name": "name", "value": "", "type": "path", "description": "The name of the resource." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Replaces the entire Mapping resource with the provided specification. The resourceVersion in the metadata must match the current version to prevent conflicting concurrent updates." }, { "info": { "name": "Emissary-Ingress Partially update a Mapping resource", "type": "http" }, "http": { "method": "PATCH", "url": "https://{kubernetes-api-server}/apis/getambassador.io/v3alpha1/namespaces/:namespace/mappings/:name", "params": [ { "name": "namespace", "value": "", "type": "path", "description": "The Kubernetes namespace of the resource." }, { "name": "name", "value": "", "type": "path", "description": "The name of the resource." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Applies a partial update to the specified Mapping resource using JSON Merge Patch or Strategic Merge Patch format." }, { "info": { "name": "Emissary-Ingress Delete a Mapping resource", "type": "http" }, "http": { "method": "DELETE", "url": "https://{kubernetes-api-server}/apis/getambassador.io/v3alpha1/namespaces/:namespace/mappings/:name", "params": [ { "name": "namespace", "value": "", "type": "path", "description": "The Kubernetes namespace of the resource." }, { "name": "name", "value": "", "type": "path", "description": "The name of the resource." } ] }, "docs": "Deletes the specified Mapping resource. Emissary-Ingress will remove the corresponding routing rule from Envoy configuration after the resource is deleted." }, { "info": { "name": "Emissary-Ingress List Mapping resources across all namespaces", "type": "http" }, "http": { "method": "GET", "url": "https://{kubernetes-api-server}/apis/getambassador.io/v3alpha1/mappings", "params": [ { "name": "labelSelector", "value": "", "type": "query", "description": "A selector to restrict the list of returned resources by their labels. Defaults to everything." }, { "name": "fieldSelector", "value": "", "type": "query", "description": "A selector to restrict the list of returned resources by their fields." }, { "name": "limit", "value": "", "type": "query", "description": "Maximum number of responses to return per page. If there are additional results, a continue token is returned." }, { "name": "continue", "value": "", "type": "query", "description": "A continuation token for paginating through large result sets, returned from a previous list call." } ] }, "docs": "Returns all Mapping custom resources across all namespaces in the cluster. Useful for cluster-wide visibility into all routing configurations managed by Emissary-Ingress." } ] } ], "bundled": true }