portainer/portainer-mcp

portainer/portainer-mcp

от portainer
Официальный MCP-сервер для Portainer. Через инструменты MCP вы можете инспектировать окружения, управлять Docker и Kubernetes, настраивать GitOps. Подходит для администраторов и DevOps.

Portainer MCP

Official MCP server for Portainer, generated from the Portainer OpenAPI spec via FastMCP.

Overview

This MCP server exposes the Portainer REST API as MCP tools: list and inspect environments, manage GitOps workflows, troubleshoot Docker and Kubernetes resources. It also supports proxying requests to the underlying Docker and K8s APIs of each environment.

Match the MCP server's minor version to your Portainer instance's minor — e.g. MCP server 2.43.x with Portainer 2.43.x. See Version compatibility for details.

Getting started

The MCP server supports different deployment scenarios:

  • execute it locally via uvx
  • install it as a MCP bundle
  • deploy it as a container

Use the uvx approach or the MCP bundle to explore the MCP capabilities locally and deploy it inside your infrastructure as a container for a team based deployment setup.

[!NOTE] Before using the MCP, make sure to generate an API key in Portainer under My Account → Access tokens first as both paths need it.

MCP bundle (one-click install)
Инструменты были проиндексированы:
AgentVersionsтолько чтение

Выводит список всех версий агента на основе текущих разрешений пользователя и параметров запроса. Политика доступа: restricted

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

AuthenticateUser

Политика доступа: publicИспользуйте это окружение (конечную точку) для аутентификации в Portainer с помощью имени пользователя и пароля.

Параметры
  • apiKeystringобязательный

    API Key

  • passwordstringобязательный

    Password

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • usernamestringобязательный

    Username

containerImageStatusтолько чтение

Политика доступа

Параметры
  • containerIdintegerобязательный

    Container identifier

  • environmentIdintegerобязательный

    Environment identifier

  • refreshboolean

    Refresh will force a refresh of the image status cache

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

containersImageStatusClear

Очищает кэш статуса образов для всех контейнеров в окруженииПолитика доступа:

Параметры
  • environmentIdintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

CreateKubernetesIngress

Создайте Ingress для указанного окружения.Политика доступа: Аутентифицированный пользователь.

Параметры
  • Annotationsobject
  • ClassNamestring
  • CreationDatestring
  • Hostsstring[]
  • idintegerобязательный

    Environment identifier

  • Labelsobject
  • Namestring
  • namespacestringобязательный

    Namespace name

  • Namespacestring
  • Pathsobject[]
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • TLSobject[]
  • Typestring
  • UIDstring
CreateKubernetesNamespace

Создаёт пространство имён в указанной среде. Политика доступа: Аутентифицированный пользователь.

Параметры
  • Annotationsobject
  • idintegerобязательный

    Environment identifier

  • LoadBalancerQuotaobject
  • Namestring
  • Ownerstring
  • ResourceQuotaobject
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • StorageQuotasobject
CreateKubernetesService

Создаёт сервис в указанном пространстве имён Политика доступа: Аутентифицированный пользователь.

Параметры
  • AllocateLoadBalancerNodePortsboolean
  • Annotationsobject
  • Applicationsobject[]

    serviceList screen

  • ClusterIPsstring[]
  • CreationDatestring
  • ExternalIPsstring[]
  • ExternalNamestring
  • idintegerобязательный

    Environment identifier

  • IngressStatusobject[]
  • Labelsobject
  • Namestring
  • namespacestringобязательный

    Namespace name

  • Namespacestring
  • Portsobject[]
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • Selectorobject
  • Typestring
  • UIDstring
DefaultRegistryUpdate

Обновляет настройки реестра по умолчанию в Portainer. Политика доступа: администратор

Параметры
  • Hideboolean
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

DeleteClusterRoleBindings

Удаляет предоставленный список cluster role bindings. Access policy: Authenticated user.

Параметры
  • bodystring[]обязательный

    A list of cluster role bindings to delete

  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

DeleteClusterRoles

Удаляет указанный список кластерных ролей. Политика доступа: Аутентифицированный пользователь.

Параметры
  • bodystring[]обязательный

    A list of cluster roles to delete

  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

DeleteCronJobs

Удаляет предоставленный список Cron Jobs. Политика доступа: аутентифицированный пользователь.

Параметры
  • bodyobjectобязательный

    A map where the key is the namespace and the value is an array of Cron Jobs to delete

  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

DeleteJobs

Удаляет указанный список задач.Политика доступа: Аутентифицированный пользователь.

Параметры
  • bodyobjectобязательный

    A map where the key is the namespace and the value is an array of Jobs to delete

  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

deleteKubernetesClusterScopedCustomResource

Удаляет кластерный Custom Resource Kubernetes, к которому у пользователя есть доступ. Политика доступа: Аутентифицированный пользователь.

Параметры
  • definitionstringобязательный

    The CustomResourceDefinition name of the custom resource, e.g. 'clusters.postgresql.cnpg.io'

  • idintegerобязательный

    Environment identifier

  • namestringобязательный

    The name of the custom resource, e.g. 'pg-cluster'

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

deleteKubernetesCustomResourceDefinition

Удаляет Kubernetes Custom Resource Definition. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • namestringобязательный

    The name of the Custom Resource Definition to delete.

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

DeleteKubernetesIngresses

Удаляет один или несколько Ingresses в указанном окружении. Политика доступа: Аутентифицированный пользователь.

Параметры
  • bodyobjectобязательный

    Ingress details

  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

DeleteKubernetesNamespace

Удаляет namespace Kubernetes в заданном окружении. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

deleteKubernetesNamespacedCustomResource

Удаляет namespaced Custom Resource Kubernetes, к которому у пользователя есть доступ. Политика доступа: Аутентифицированный пользователь.

Параметры
  • definitionstringобязательный

    The CustomResourceDefinition name of the custom resource, e.g. 'clusters.postgresql.cnpg.io'

  • idintegerобязательный

    Environment identifier

  • namestringобязательный

    The name of the custom resource, e.g. 'pg-cluster'

  • namespacestringобязательный

    The namespace name to delete the custom resource from

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

DeleteKubernetesPersistentVolumeClaims

Удаляет предоставленный список PersistentVolumeClaims. Политика доступа: Аутентифицированный пользователь.

Параметры
  • bodyobject[]обязательный

    List of PVCs to delete (namespace + name)

  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

DeleteKubernetesPersistentVolumes

Удаляет предоставленный список PersistentVolumes. Политика доступа: Аутентифицированный пользователь.

Параметры
  • bodystring[]обязательный

    List of PV names to delete

  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

DeleteKubernetesPod

Удаляет один под Kubernetes в указанном пространстве имен. Отвечающий контроллер (Deployment, StatefulSet, DaemonSet, ...) отвечает за воссоздание пода. Для голых подов под удаляется навсегда.Политика доступа: аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • namestringобязательный

    Pod name

  • namespacestringобязательный

    Namespace

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

DeleteKubernetesServices

Удаляет предоставленный список служб. Политика доступа: Аутентифицированный пользователь.

Параметры
  • bodyobjectобязательный

    A map where the key is the namespace and the value is an array of services to delete

  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

DeleteKubernetesStorageClasses

Удаляет предоставленный список StorageClasses.Access policy: Аутентифицированный пользователь.

Параметры
  • bodystring[]обязательный

    List of StorageClass names to delete

  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

DeleteRoleBindings

Удаляет предоставленный список связываний ролей.Политика доступа: аутентифицированный пользователь.

Параметры
  • bodyobjectобязательный

    A map where the key is the namespace and the value is an array of role bindings to delete

  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

DeleteRoles

Удаляет предоставленный список ролей. Политика доступа: аутентифицированный пользователь.

Параметры
  • bodyobjectобязательный

    A map where the key is the namespace and the value is an array of roles to delete

  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

DeleteServiceAccounts

Удаляет предоставленный список сервисных аккаунтов. Политика доступа: Аутентифицированный пользователь.

Параметры
  • bodyobjectобязательный

    A map where the key is the namespace and the value is an array of service accounts to delete

  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

DescribeResourceтолько чтение

Получает описание ресурса Kubernetes. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • kindstringобязательный

    Resource kind

  • namestringобязательный

    Resource name

  • namespacestring

    Namespace

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

dockerContainerGpusInspectтолько чтение

Политика доступа

Параметры
  • containerIdintegerобязательный

    Container identifier

  • environmentIdintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

dockerDashboardтолько чтение

Политика доступа: ограничена

Параметры
  • environmentIdintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

dockerImagesListтолько чтение

Политика доступа:

Параметры
  • environmentIdintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • withUsageboolean

    Include image usage information

docker_proxy

Проксирует запрос к Docker Engine API через Portainer для указанной среды. path передаётся демону Docker без изменений (например, /containers/json, /images/json, /containers/{id}/json). Передайте JMESPath select, чтобы выбрать только нужные поля — сырые ответы Docker очень объёмные. Пример для /containers/json: [].{id:Id,name:Names[0],state:State,image:Image}.

Параметры
  • bodystring | null

    Raw request body string (e.g. JSON for POST)

  • environment_idintegerобязательный

    Portainer environment ID

  • headersobject | null

    Extra request headers

  • methodstring

    HTTP method

  • pathstringобязательный

    Docker API path with leading slash, e.g. /containers/json

  • query_paramsobject | null

    Query parameters

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

drainNode

Опустошает узел Kubernetes, безопасно вытесняя все поды с узла, подготавливая его к обслуживанию или удалению. Политика доступа: аутентифицированные.

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • namestringобязательный

    Name of the node to drain

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

EdgeStackWebhookInvoke

Политика доступа: публичная

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • webhookIDstringобязательный

    Stack identifier

EndpointAssociationDelete

Отвязывает периферийную среду (конечную точку).Политика доступа: администратор

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

EndpointCreate

Создаёт новое окружение (endpoint), которое будет использоваться для управления окружением (endpoint). Политика доступа: администратор

Параметры
  • AzureApplicationIDstring

    Azure application ID. Required if environment(endpoint) type is set to 3

  • AzureAuthenticationKeystring

    Azure authentication key. Required if environment(endpoint) type is set to 3

  • AzureTenantIDstring

    Azure tenant ID. Required if environment(endpoint) type is set to 3

  • ContainerEnginestring

    Container engine used by the environment(endpoint). Value must be one of: 'docker' or 'podman'

  • CustomTemplateContentstring

    KaaS: custom template content to deploy on environment creation

  • CustomTemplateIDinteger

    KaaS: custom template identifier to deploy on environment creation

  • EdgeAsyncModeboolean

    Enable async mode for edge agent

  • EdgeCheckinIntervalinteger

    The check in interval for edge agent (in seconds)

  • EdgeCommandIntervalinteger

    The command interval for edge agent (in seconds)

  • EdgePingIntervalinteger

    The ping interval for edge agent (in seconds)

  • EdgeSnapshotIntervalinteger

    The snapshot interval for edge agent (in seconds)

  • EdgeTunnelServerAddressstring

    URL or IP address that will be used to establish a reverse tunnel. Required when settings.EnableEdgeComputeFeatures is set to false or when settings.Edge.TunnelServerAddress is not set

  • EndpointCreationTypeenumобязательный

    Environment(Endpoint) type. Value must be one of: 1 (Local Docker environment), 2 (Agent environment), 3 (Azure environment), 4 (Edge agent environment) or 5 (Local Kubernetes Environment)

  • Gpusstring

    List of GPUs - json stringified array of {name, value} structs

  • GroupIDinteger

    Environment(Endpoint) group identifier. If not specified will default to 1 (unassigned).

  • KubeConfigstring

    Kubernetes configuration file content (base64 encoded). Required when EndpointCreationType is set to 6 (KubeConfigEnvironment)

  • Namestringобязательный

    Name that will be used to identify this environment(endpoint) (example: my-environment)

  • PublicURLstring

    URL or IP address where exposed containers will be reachable. Defaults to URL if not specified (example: docker.mydomain.tld:2375)

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • StackNamestring

    KaaS: stack name for the custom template deployment

  • TagIdsstring

    JSON-parsable array of tag identifiers to which this environment(endpoint) is associated

  • TLSboolean

    Require TLS to connect against this environment(endpoint). Must be true if EndpointCreationType is set to 2 (Agent environment)

  • TLSCACertFilestring

    TLS CA certificate file

  • TLSCertFilestring

    TLS client certificate file

  • TLSKeyFilestring

    TLS client key file

  • TLSSkipClientVerifyboolean

    Skip client verification when using TLS. Must be true if EndpointCreationType is set to 2 (Agent environment)

  • TLSSkipVerifyboolean

    Skip server verification when using TLS. Must be true if EndpointCreationType is set to 2 (Agent environment)

  • URLstring

    URL or IP address of a Docker host (example: docker.mydomain.tld:2375). Defaults to local if not specified (Linux: /var/run/docker.sock, Windows: //./pipe/docker_engine). Cannot be empty if EndpointCreationType is set to 4 (Edge agent environment)

EndpointCreateGlobalKey

Создаёт или получает конечную точку для EdgeID.

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

EndpointDelete

Удаляет среду, связанную с указанным идентификатором, и опционально очищает связанные ресурсы. Политика доступа: Только администратор.

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

EndpointDeleteBatch

Удаляет несколько окружений и при необходимости очищает связанные ресурсы. Политика доступа: только администратор.

Параметры
  • endpointsobject[]
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

EndpointDeleteBatchDeprecated

Устарело: используйте конечную точку POST. Удаляет несколько сред и опционально очищает связанные ресурсы.Политика доступа: только администратор.

Параметры
  • endpointsobject[]
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

EndpointDockerBrowsePut

Использует эту среду (endpoint) для загрузки TLS-файлов. Политика доступа: администратор

Параметры
  • filestringобязательный

    The file to upload

  • idintegerобязательный

    Environment(Endpoint) identifier

  • Pathstringобязательный

    The destination path to upload the file to

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • volumeIDstring

    Optional volume identifier to upload the file

endpointDockerhubStatusтолько чтение

Получает лимиты на pull для реестра Docker Hub в окружении Access policy:

Параметры
  • idintegerобязательный

    endpoint ID

  • registryIdintegerобязательный

    registry ID

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

endpointForceUpdateService

Принудительно обновляет службу Docker Политика доступа: аутентифицированный

Параметры
  • idintegerобязательный

    endpoint identifier

  • PullImageboolean

    PullImage if true will pull the image

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • ServiceIDstring

    ServiceId to update

EndpointInspectтолько чтение

Получает сведения об окружении (конечной точке). Политика доступа: ограничена.

Параметры
  • excludeSnapshotboolean

    if true, the snapshot data won't be retrieved

  • idintegerобязательный

    Environment(Endpoint) identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

EndpointListтолько чтение

Перечисляет все окружения (конечные точки) на основе авторизации текущего пользователя. Возвращает все окружения (конечные точки), если используется учетная запись администратора или руководителя группы, в противном случае возвращает только авторизованные окружения (конечные точки).Политика доступа: restricted

Параметры
  • agentVersionsstring[]

    will return only environments with on of these agent versions

  • edgeAsyncboolean

    if exists true show only edge async agents, false show only standard edge agents. if missing, will show both types (relevant only for edge agents)

  • edgeCheckInPassedSecondsnumber

    if bigger then zero, show only edge agents that checked-in in the last provided seconds (relevant only for edge agents)

  • edgeDeviceUntrustedboolean

    if true, show only untrusted edge agents, if false show only trusted edge agents (relevant only for edge agents)

  • edgeGroupIdsinteger[]

    List environments(endpoints) of these edge groups

  • edgeStackIdinteger

    will return the environments of the specified edge stack

  • edgeStackStatusenum

    only applied when edgeStackId exists. Filter the returned environments based on their deployment status in the stack (not the environment status!)

  • endpointIdsinteger[]

    will return only these environments(endpoints)

  • excludeEdgeGroupIdsinteger[]

    Exclude environments(endpoints) of these edge groups

  • excludeGroupIdsinteger[]

    Exclude environments of these groups

  • excludeIdsinteger[]

    will exclude these environments(endpoints)

  • excludeSnapshotsboolean

    if true, the snapshot data won't be retrieved

  • groupIdsinteger[]

    List environments(endpoints) of these groups

  • k8sEnvAdminboolean

    If true, an X-K8S-Env-Admin header will be added to the response to indicate if the user is a K8S environment admin for any of the returned environments

  • limitinteger

    Limit results to this value

  • namestring

    will return only environments(endpoints) with this name

  • nameFilterstring

    Filter environments by partial name match (case-insensitive, searches name only)

  • orderstring

    Order sorted results by desc/asc

  • outdatedboolean

    If true, return only environments with an outdated agent

  • platformTypesenum[]

    Filter environments by platform type

  • policyboolean

    If true, will apply policy data to the returned environments(endpoints)

  • policyIdsinteger[]

    List environments(endpoints) associated with these policies

  • policyStatusenum[]

    Filter environments by policy status (applied, failed, in_progress, warning, not_supported). Only applies when policyIds is specified.

  • provisionedboolean

    If true, will return environment(endpoint) that were provisioned

  • searchstring

    Search query

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • sortenum

    Sort results by this value

  • startinteger

    Start searching from

  • statusinteger[]

    List environments(endpoints) by this status

  • tagIdsinteger[]

    search environments(endpoints) with these tags (depends on tagsPartialMatch)

  • tagsPartialMatchboolean

    If true, will return environment(endpoint) which has one of tagIds, if false (or missing) will return only environments(endpoints) that has all the tags

  • typesenum[]

    List environments(endpoints) of this type

  • updateInformationboolean

    If true, an X-Update-Available header will be added to the response to indicate if an update is available

EndpointMTLSAgentCertificateErrorтолько чтение

Получает mTLS-сертификат среды (конечной точки). Политика доступа: администратор

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

EndpointMTLSCertificateтолько чтение

Получает mTLS-сертификат среды (endpoint).Политика доступа: администратор

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

endpointRegistriesListтолько чтение

Перечисляет все реестры на основе прав доступа текущего пользователя в текущем окружении. Политика доступа: аутентифицированный.

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • namespacestring

    required if kubernetes environment, will show registries by namespace

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

endpointRegistryAccess

Политика доступа: аутентифицированный

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • Namespacesstring[]
  • registryIdintegerобязательный

    Registry identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • TeamAccessPoliciesobject
  • UserAccessPoliciesobject
EndpointSetPolicyStatuses

Окружение (endpoint) для edge-агента, чтобы сообщать о статусах сверки по каждой политике. Политика доступа: доступно только для Edge-окружений (endpoints).

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • statusesobject[]
EndpointSettingsUpdate

Обновляет настройки для окружения (endpoint).Политика доступа: только для аутентифицированных

Параметры
  • changeWindowany

    Whether GitOps update time restrictions are enabled

  • deploymentOptionsany

    Hide manual deployment forms for an environment

  • enableGPUManagementboolean
  • enableImageNotificationboolean
  • gpusobject[]
  • idintegerобязательный

    Environment(Endpoint) identifier

  • securitySettingsobject

    Security settings updates

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

EndpointSnapshot

Создаёт снимок окружения (конечной точки) Политика доступа: аутентифицированный

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

EndpointSnapshots

Создаёт снимки всех сред (конечных точек)Политика доступа: администратор

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

EndpointSummaryCountsтолько чтение

Возвращает количество окружений по статусу (работает, не работает, устаревшая) и несгруппированные окружения (не назначенные), а также разбивку по группе, типу и состоянию. Политика доступа: ограниченный.

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

EndpointUpdate

Обновляет окружение (endpoint). Политика доступа: аутентифицированный

Параметры
  • AzureApplicationIDstring

    Azure application ID

  • AzureAuthenticationKeystring

    Azure authentication key

  • AzureTenantIDstring

    Azure tenant ID

  • ChangeWindowany

    Whether GitOps update time restrictions are enabled

  • DeploymentOptionsany

    Hide manual deployment forms for an environment

  • Edgeobject
  • EdgeCheckinIntervalinteger

    The check in interval for edge agent (in seconds)

  • Gpusobject[]

    GPUs information

  • GroupIDinteger

    Group identifier

  • idintegerобязательный

    Environment(Endpoint) identifier

  • IsSetStatusMessageboolean
  • Kubernetesany

    Associated Kubernetes data

  • Namestring

    Name that will be used to identify this environment(endpoint)

  • PublicURLstring

    URL or IP address where exposed containers will be reachable. Defaults to URL if not specified

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • Statusinteger

    The status of the environment(endpoint) (1 - up, 2 - down)

  • StatusMessageobject
  • TagIDsinteger[]

    List of tag identifiers to which this environment(endpoint) is associated

  • TeamAccessPoliciesobject
  • TLSboolean

    Require TLS to connect against this environment(endpoint)

  • TLSSkipClientVerifyboolean

    Skip client verification when using TLS

  • TLSSkipVerifyboolean

    Skip server verification when using TLS

  • URLstring

    URL or IP address of a Docker host

  • UserAccessPoliciesobject
EndpointUpdateRelations

Обновляет связи для списка окружений Группы граничных узлов, теги и группа окружений обновляются. Политика доступа: administrator

Параметры
  • Relationsobject
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetAllKubernetesApplicationтолько чтение

Получает приложение по имени в определённом пространстве имён Политика доступа: аутентифицированный

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • namestringобязательный

    Application name

  • namespacestringобязательный

    The namespace

  • resourceTypestring

    The resource type to get the application for

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetAllKubernetesApplicationsтолько чтение

Получает список приложений во всех пространствах имён в кластере. Если указано nodeName, возвращает приложения, запущенные на этом узле. Политика доступа: authenticated

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • namespacestringобязательный

    Namespace name

  • nodeNamestringобязательный

    Node name

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

getAllKubernetesApplicationsCountтолько чтение

Получает количество приложений по всем пространствам имён в кластере. Если указан nodeName, возвращает количество приложений, запущенных на этом узле. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetAllKubernetesClusterIngressesтолько чтение

Получает Kubernetes Ingress на уровне кластера для указанного окружения. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • withServicesboolean

    Lookup services associated with each ingress

GetAllKubernetesClusterIngressesCountтолько чтение

Получает количество kubernetes ingresses в указанной среде. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetAllKubernetesClusterRoleBindingsтолько чтение

Получает список привязок ролей кластера Kubernetes в заданном окружении на уровне кластера. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetAllKubernetesClusterRolesтолько чтение

Получает список ролей кластера Kubernetes в указанной среде на уровне кластера. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetAllKubernetesConfigMapsтолько чтение

Возвращает список ConfigMaps во всех namespace кластера. Для неадминистративных пользователей возвращает только те ConfigMaps, которые находятся в namespaces, к которым у них есть доступ.Политика доступа: аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • isUsedbooleanобязательный

    Set to true to include information about applications that use the ConfigMaps in the response

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetAllKubernetesConfigMapsCountтолько чтение

Получает количество ConfigMaps во всех пространствах имён в кластере. Для пользователей без прав администратора возвращает только количество ConfigMaps на основе пространств имён, к которым у них есть доступ. Политика доступа: аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

getAllKubernetesEventsтолько чтение

Получает события по параметру запроса resourceId Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • resourceIdstring

    The resource id of the involved kubernetes object

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetAllKubernetesIngressControllersтолько чтение

Получает список ingress-контроллеров для заданного окружения. Если установлен параметр запроса allowedOnly, будут возвращены только те ingress-контроллеры, которые разрешены конфигурацией ingress данного окружения. Политика доступа: Аутентифицированный пользователь.

Параметры
  • allowedOnlyboolean

    Only return allowed ingress controllers

  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetAllKubernetesIngressesтолько чтение

Получает список Ingresses. Если указан namespace, возвращает список Ingresses в указанном namespace. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • namespacestringобязательный

    Namespace name

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetAllKubernetesPersistentVolumeClaimsтолько чтение

Получает список всех PersistentVolumeClaims в заданной среде. Ограничено пространством имен для неадминистративных пользователей. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetAllKubernetesPersistentVolumesтолько чтение

Получает список всех PersistentVolumes в указанной среде. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetAllKubernetesServicesCountтолько чтение

Получает количество сервисов, к которым у пользователя есть доступ. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetAllKubernetesStorageClassesтолько чтение

Получает список всех StorageClasses в заданной среде. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetAllKubernetesVolumesтолько чтение

Получает список всех томов Kubernetes в указанной среде (Endpoint). Идентификатор Endpoint должен быть действительным идентификатором среды Portainer. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • withApplicationsboolean

    When set to True, include the applications that are using the volumes. It is set to false by default

getAllKubernetesVolumesCountтолько чтение

Получает общее количество томов Kubernetes в заданной среде (Endpoint). Общее количество зависит от роли и разрешений пользователя. Идентификатор Endpoint должен быть допустимым идентификатором среды Portainer. Политика доступа: аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetApplicationsResourcesтолько чтение

Получает суммарные запросы и лимиты CPU (ядер) и памяти (байт) всех приложений во всех пространствах имён.Политика доступа: аутентифицирован

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • nodestringобязательный

    Node name

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

get_guidanceтолько чтение

Руководство по эксплуатации этого сервера Portainer MCP: проецирование ответов с помощью select, где находятся тяжелые поля, результаты, которые легко неверно истолковать (например: здоровье среды Edge определяется по его heartbeat, а не по полю Status; типизированные инструменты K8s используют другие имена полей, чем сырой прокси), и как безопасно развертывать/масштабировать/удалять. Вызовите его один раз в начале любой задачи Portainer, прежде чем интерпретировать ответы или планировать многошаговые изменения. Это существенно повышает корректность и экономит контекст.

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

getKubernetesAllCustomResourcesтолько чтение

Получает список пользовательских ресурсов Kubernetes, к которым у пользователя есть доступ. Политика доступа: аутентифицированный пользователь.

Параметры
  • definitionstringобязательный

    The CustomResourceDefinition name of the custom resource, e.g. 'clusters.postgresql.cnpg.io'

  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

getKubernetesClusterScopedCustomResourceтолько чтение

Получает кластерный Custom Resource Kubernetes, к которому у пользователя есть доступ.Политика доступа: аутентифицированный пользователь.

Параметры
  • definitionstringобязательный

    The CustomResourceDefinition name of the custom resource, e.g. 'clusters.postgresql.cnpg.io'

  • formatstring

    The format of the custom resource, e.g. 'yaml' or 'json'

  • idintegerобязательный

    Environment identifier

  • namestringобязательный

    The name of the custom resource, e.g. 'pg-cluster'

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesConfigMapтолько чтение

Получает ConfigMap по имени для заданного namespace.Политика доступа: Аутентифицированный пользователь.

Параметры
  • configmapstringобязательный

    The configmap name to get details for

  • idintegerобязательный

    Environment identifier

  • namespacestringобязательный

    The namespace name where the configmap is located

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesCronJobsтолько чтение

Получает список Kubernetes Cron Jobs, к которым у пользователя есть доступ. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

getKubernetesCustomResourceDefinitionтолько чтение

Получает Custom Resource Definition в Kubernetes.Политика доступа: аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • namestringобязательный

    The name of the Custom Resource Definition to get.

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

getKubernetesCustomResourceDefinitionsтолько чтение

Получает список определений пользовательских ресурсов Kubernetes, к которым у пользователя есть доступ. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesDashboardтолько чтение

Получает сводные данные панели мониторинга, которые содержат просто подсчет диапазона различных часто используемых ресурсов Kubernetes. Политика доступа: аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment (Endpoint) identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

getKubernetesEventsForNamespaceтолько чтение

Получает события по необязательному параметру запроса resourceId для заданного пространства имён. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • namespacestringобязательный

    The namespace name the events are associated to

  • resourceIdstring

    The resource id of the involved kubernetes object

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesIngressтолько чтение

Получает Ingress по имени для указанного окружения. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • ingressstringобязательный

    Ingress name

  • namespacestringобязательный

    Namespace name

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesIngressControllersByNamespaceтолько чтение

Получает список ingress-контроллеров для указанной среды в заданном пространстве имён.Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • namespacestringобязательный

    Namespace

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesJobsтолько чтение

Получает список Kubernetes Jobs, к которым у пользователя есть доступ. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • includeCronJobChildrenboolean

    Whether to include Jobs that have a cronjob owner

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesMaxResourceLimitsтолько чтение

Получает максимальные лимиты CPU и памяти (неиспользуемые ресурсы) всех узлов в кластере k8s. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesMetricsForAllNodesтолько чтение

Получает список метрик, связанных со всеми узлами кластера. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesMetricsForAllPodsтолько чтение

Получает список подов с их текущими метриками для указанного пространства имён. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • namespacestringобязательный

    Namespace

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesMetricsForNodeтолько чтение

Получает актуальные метрики для указанного узла. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • namestringобязательный

    Node identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesMetricsForPodтолько чтение

Получает живые метрики для указанного пода. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • namestringобязательный

    Pod identifier

  • namespacestringобязательный

    Namespace

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesNamespaceтолько чтение

Получает сведения о неймспейсе для указанного неймспейса в заданном окружении. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • namespacestringобязательный

    The namespace name to get details for

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • withResourceQuotabooleanобязательный

    When set to true, include the resource quota information as part of the Namespace information. Default is false

getKubernetesNamespacedCustomResourceтолько чтение

Получает список Custom Resources Kubernetes, к которым у пользователя есть доступ. Политика доступа: Аутентифицированный пользователь.

Параметры
  • definitionstringобязательный

    The CustomResourceDefinition name of the custom resource, e.g. 'clusters.postgresql.cnpg.io'

  • formatstring

    The format of the custom resource, e.g. 'yaml' or 'json'

  • idintegerобязательный

    Environment identifier

  • namestringобязательный

    The name of the custom resource, e.g. 'pg-cluster'

  • namespacestringобязательный

    The namespace name to get details for

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesNamespacesтолько чтение

Получает список всех пространств имён в заданной среде на основе роли пользователя и его разрешений. Если пользователь — администратор, ему доступны все пространства имён. Если пользователь не администратор, ему доступны только те пространства имён, к которым у него есть доступ. Политика доступа: аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • withResourceQuotabooleanобязательный

    When set to true, include the resource quota information as part of the Namespace information. Default is false

  • withUnhealthyEventsbooleanобязательный

    When set to true, include the unhealthy events information as part of the Namespace information. Default is false

GetKubernetesNamespacesCountтолько чтение

Получает общее количество пространств имён kubernetes в заданном окружении, включая системные пространства имён. Общее количество зависит от роли и разрешений пользователя.Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesNodesтолько чтение

Возвращает список узлов Kubernetes для выбранной среды. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesNodesLimitsтолько чтение

Получает ограничения CPU и памяти всех узлов в кластере k8s. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesPersistentVolumeтолько чтение

Получает PersistentVolume по имени в указанной среде. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • namestringобязательный

    PersistentVolume name

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesPersistentVolumeClaimтолько чтение

Получает PersistentVolumeClaim по имени в пространстве имён. Политика доступа: Authenticated user.

Параметры
  • idintegerобязательный

    Environment identifier

  • namestringобязательный

    PVC name

  • namespacestringобязательный

    Namespace name

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesPersistentVolumeClaimsInNamespaceтолько чтение

Получает список PersistentVolumeClaims в указанном namespace. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • namespacestringобязательный

    Namespace name

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

getKubernetesPodSecurityRuleтолько чтение

Получает правило безопасности Pod внутри кластера k8s. Политика доступа: аутентифицирован

Параметры
  • environmentIdintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesRBACStatusтолько чтение

Проверяет, включен ли RBAC в указанном кластере Kubernetes. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesRoleBindingsтолько чтение

Получает список привязок ролей Kubernetes, к которым у пользователя есть доступ. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesRolesтолько чтение

Получает список ролей Kubernetes, к которым у пользователя есть доступ. Политика доступа: аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesSecretтолько чтение

Получает секрет по имени для заданного пространства имён. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • namespacestringобязательный

    The namespace name where the secret is located

  • secretstringобязательный

    The secret name to get details for

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesSecretsтолько чтение

Получает список Secrets для заданного namespace. Если isUsed установлен в true, также возвращается информация о приложениях, использующих эти Secrets. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • isUsedbooleanобязательный

    When set to true, associate the Secrets with the applications that use them

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesSecretsCountтолько чтение

Получает количество Secrets во всех пространствах имен, к которым у пользователя есть доступ. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesServiceAccountтолько чтение

Получает учётную запись kubernetes в заданном namespace. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • namestringобязательный

    Service account name

  • namespacestringобязательный

    Namespace

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesServiceAccountsтолько чтение

Получает список сервисных аккаунтов Kubernetes, к которым у пользователя есть доступ. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesServicesтолько чтение

Получает список сервисов, к которым у пользователя есть доступ. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • withApplicationsboolean

    Lookup applications associated with each service

GetKubernetesServicesByNamespaceтолько чтение

Получает список сервисов для указанного пространства имён. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • namespacestringобязательный

    Namespace name

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesStorageClassтолько чтение

Получает StorageClass по имени в указанном окружении.Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • namestringобязательный

    StorageClass name

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesVersionтолько чтение

Получает версию кластера Kubernetes (major, minor, gitVersion, …) по данным API обнаружения кластера, дополненную флагами возможностей, которые Portainer использует для управления функциями интерфейса (например, supportsPodRestart). Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GetKubernetesVolumeтолько чтение

Получает том Kubernetes в указанной среде (Endpoint). Endpoint ID должен быть допустимым идентификатором среды Portainer. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • namespacestringобязательный

    Namespace identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • volumestringобязательный

    Volume name

GetKubernetesVolumesInNamespaceтолько чтение

Получает список томов Kubernetes в указанном пространстве имён (namespace) в заданной среде (Endpoint). Идентификатор Endpoint должен быть допустимым идентификатором среды Portainer. Политика доступа: Аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • namespacestringобязательный

    Namespace identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • withApplicationsboolean

    When set to True, include the applications that are using the volumes. It is set to false by default

GitOperationRepoFilePreview

Извлекает содержимое файла compose на основе конфигурации git-репозиторияПолитика доступа: только для аутентифицированных

Параметры
  • authorizationTypeany

    Deprecated: use SourceID instead

  • createdFromCustomTemplateIDinteger

    CreatedFromCustomTemplateID will fetch auth from this custom template's git settings

  • fromEdgeStackboolean
  • passwordstring

    Deprecated: use SourceID instead

  • providerany

    Deprecated: use SourceID instead

  • referencestring
  • repositorystring

    Deprecated: use SourceID instead

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • sourceIdinteger

    SourceID resolves URL and auth from the stored source record

  • stackIdinteger

    StackID will fetch auth from this stack's git settings (edge stack if FromEdgeStack is true)

  • targetFilestring

    Path to file whose content will be read

  • TLSSkipVerifyboolean

    TLSSkipVerify skips SSL verification when cloning the Git repository Deprecated: use SourceID instead

  • usernamestring

    Deprecated: use SourceID instead

GitOperationRepoFilesSearch

Ищет путь к файлу в git-репозитории по частичному или полному имени файла Политика доступа: аутентифицированный пользователь

Параметры
  • authorizationTypeany

    Deprecated: use SourceID instead

  • createdFromCustomTemplateIDinteger

    CreatedFromCustomTemplateID will fetch auth from this custom template's git settings

  • dirOnlyboolean

    DirOnly List directories only

  • forceboolean

    list the results without using cache

  • fromEdgeStackboolean
  • includestring

    Allow to provide specific file extension as the search result. If empty, the file extensions yml,yaml,hcl,json will be set by default

  • keywordstring

    Partial or completed file name. If empty, all filenames with included extensions will be returned

  • passwordstring

    Deprecated: use SourceID instead

  • providerany

    Deprecated: use SourceID instead

  • referencestring

    Specific Git repository reference. If empty, the reference ref/heads/main will be set by default

  • repositorystring

    Deprecated: use SourceID instead

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • sourceIdinteger

    SourceID resolves URL and auth from the stored source record

  • stackIdinteger

    StackID will fetch auth from this stack's git settings (edge stack if FromEdgeStack is true)

  • TLSSkipVerifyboolean

    TLSSkipVerify skips SSL verification when cloning the Git repository Deprecated: use SourceID instead

  • usernamestring

    Deprecated: use SourceID instead

GitOperationRepoHelmValues

Загружает и объединяет несколько файлов значений Helm из Git-репозитория, имитируя поведение CLI Helm Политика доступа: аутентифицированный

Параметры
  • authorizationTypeany

    Deprecated: use SourceID instead

  • createdFromCustomTemplateIDinteger

    CreatedFromCustomTemplateID will fetch auth from this custom template's git settings

  • fromEdgeStackboolean
  • passwordstring

    Deprecated: use SourceID instead

  • providerany

    Deprecated: use SourceID instead

  • referencestring
  • repositorystring

    Deprecated: use SourceID instead

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • sourceIdinteger

    SourceID resolves URL and auth from the stored source record

  • stackIdinteger

    StackID will fetch auth from this stack's git settings (edge stack if FromEdgeStack is true)

  • TLSSkipVerifyboolean

    TLSSkipVerify skips SSL verification when cloning the Git repository Deprecated: use SourceID instead

  • usernamestring

    Deprecated: use SourceID instead

  • valuesFilesstring[]обязательный

    ValuesFiles is an array of paths to Helm values files (matches Stack.HelmValuesFiles)

GitOperationRepoRefs

Перечисляет все ссылки git-репозитория Возвращает все ссылки git-репозитория Политика доступа: аутентифицированный

Параметры
  • authorizationTypeany

    Deprecated: use SourceID instead

  • createdFromCustomTemplateIDinteger

    CreatedFromCustomTemplateID will fetch auth from this custom template's git settings

  • forceboolean

    list the results without using cache

  • fromEdgeStackboolean
  • passwordstring

    Deprecated: use SourceID instead

  • providerany

    Deprecated: use SourceID instead

  • repositorystring

    Deprecated: use SourceID instead

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • sourceIdinteger

    SourceID resolves URL and auth from the stored source record

  • stackIdinteger

    StackID will fetch auth from this stack's git settings (edge stack if FromEdgeStack is true)

  • TLSSkipVerifyboolean

    TLSSkipVerify skips SSL verification when cloning the Git repository Deprecated: use SourceID instead

  • usernamestring

    Deprecated: use SourceID instead

GitOpsSourceGetтолько чтение

Возвращает один источник GitOps с его настройками подключения и связанными рабочими процессами. Политика доступа: аутентифицированные

Параметры
  • idintegerобязательный

    Source identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GitOpsSourcesCreateGit

Создаёт новый источник GitOps на основе Git-репозитория. Политика доступа: аутентифицированный

Параметры
  • administratorsOnlyboolean
  • authenticationobject
  • namestring
  • publicboolean
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • teamAccessesinteger[]
  • tlsSkipVerifyboolean
  • urlstringобязательный
  • userAccessesinteger[]
GitOpsSourcesDelete

Удаляет существующий источник GitOps. Возвращает 409, если источник используется в каком-либо workflow или пользовательском шаблоне. Политика доступа: аутентифицированный

Параметры
  • idintegerобязательный

    Source identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GitOpsSourcesListтолько чтение

Возвращает дедуплицированный список git-репозиториев, используемых во всех GitOps-рабочих процессах. Политика доступа: аутентифицированные

Параметры
  • limitinteger

    Pagination limit (0 = unlimited)

  • orderstring

    Sort order: asc or desc

  • searchstring

    Search term (matches URL)

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • sortstring

    Sort field: name | status | type

  • startinteger

    Pagination start index

  • statusstring

    Filter by status: healthy | syncing | error | paused | unknown

  • typeenum

    Filter by source type: git | oci | helm

GitOpsSourcesSummaryтолько чтение

Возвращает количество источников по статусу. Политика доступа: аутентифицирован

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

GitOpsSourcesTest

Проверяет подключение для ещё не сохранённых реквизитов Git-соединения. Политика доступа: аутентифицированный

Параметры
  • administratorsOnlyboolean
  • authenticationobject
  • namestring
  • publicboolean
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • teamAccessesinteger[]
  • tlsSkipVerifyboolean
  • urlstringобязательный
  • userAccessesinteger[]
GitOpsSourcesTestById

Проверяет подключение для источника GitOps, применяя необязательные переопределения к сохранённой конфигурации. Политика доступа: аутентифицированный

Параметры
  • authenticationobject
  • idintegerобязательный

    Source identifier

  • namestring
  • referenceNamestring
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • tlsSkipVerifyboolean
  • urlstring
GitOpsSourcesUpdateAccess

Обновляет настройки контроля доступа для существующего источника GitOps. Access policy: administrator

Параметры
  • idintegerобязательный

    Source identifier

  • publicboolean
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • teamsinteger[]
  • usersinteger[]
GitOpsSourcesUpdateGit

Обновляет существующий GitOps-источник на базе Git-репозитория. Политика доступа: аутентифицированный

Параметры
  • authenticationobject
  • idintegerобязательный

    Source identifier

  • namestring
  • referenceNamestring
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • tlsSkipVerifyboolean
  • urlstring
GitOpsWorkflowsListтолько чтение

Возвращает единый список всех стэков и граничных стэков, для которых настроен GitOps (GitConfig). Политика доступа: аутентифицирован

Параметры
  • endpointIdsinteger[]

    Filter by environment IDs (e.g. endpointIds[]=1&endpointIds[]=2)

  • limitinteger

    Pagination limit (0 = unlimited)

  • orderstring

    Sort order: asc or desc

  • platformstring

    Filter by platform: dockerStandalone | dockerSwarm | kubernetes

  • searchstring

    Search term (matches name or repository URL)

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • sortstring

    Sort field: name | type | status | platform | creationDate | lastSyncDate

  • startinteger

    Pagination start index

  • statusstring

    Filter by status: healthy | syncing | error | paused | unknown

  • typestring

    Filter by type: stack | edgeStack

GitOpsWorkflowsSummaryтолько чтение

Возвращает количество рабочих процессов по статусу для рабочих процессов, доступных запрашивающему пользователю. Политика доступа: аутентифицированный

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

HelmDelete

Политика доступа: аутентифицированный

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • namespacestring

    An optional namespace

  • releasestringобязательный

    The name of the release/application to uninstall

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

HelmGetтолько чтение

Получает сведения о релизе Helm по его имени. Политика доступа: аутентифицированный

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • namespacestring

    specify an optional namespace

  • releasestringобязательный

    Helm release name

  • revisioninteger

    specify an optional revision

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • showResourcesboolean

    show resources of the release

HelmGetHistoryтолько чтение

Получает исторический список релизов по имени релиза Политика доступа: аутентифицированный

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • namespacestring

    specify an optional namespace

  • releasestringобязательный

    Helm release name

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

HelmGitDryRun

Политика доступа: аутентифицированный

Параметры
  • helmChartPathstring
  • helmValuesFilesstring[]
  • idintegerобязательный

    Environment(Endpoint) identifier

  • namestring
  • namespacestring
  • repositoryAuthenticationboolean
  • repositoryAuthorizationTypeenum
  • repositoryPasswordstring
  • repositoryProviderany
  • repositoryReferenceNamestring
  • repositoryURLstring
  • repositoryUsernamestring
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • sourceIdinteger

    SourceID resolves URL and auth from the stored Source record. When set, the inline Repository/auth/tls fields are ignored.

  • tlsSkipVerifyboolean
HelmInstall

Политика доступа: требуется аутентификация

Параметры
  • atomicboolean
  • chartstring
  • dryRunboolean

    Dry run

  • idintegerобязательный

    Environment(Endpoint) identifier

  • namestring
  • namespacestring
  • registryIdinteger
  • repostring
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • valuesstring
  • versionstring
HelmListтолько чтение

Политика доступа: требуется аутентификация

Параметры
  • filterstring

    specify an optional filter

  • idintegerобязательный

    Environment(Endpoint) identifier

  • namespacestring

    specify an optional namespace

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • selectorstring

    specify an optional selector

HelmRepoSearchтолько чтение

Политика доступа: аутентификация

Параметры
  • chartstring

    Helm chart name

  • registryIdstring

    Helm registry ID (required if repo not provided)

  • repostring

    Helm repository URL (required if registryId not provided)

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • useCachestring

    If true will use cache to search

HelmRollback

Откатывает helm-релиз до предыдущей ревизии. Политика доступа: требуется аутентификация.

Параметры
  • forceboolean

    force resource update through delete/recreate if needed (default: false)

  • idintegerобязательный

    Environment(Endpoint) identifier

  • namespacestring

    specify an optional namespace

  • recreateboolean

    performs pods restart for the resource if applicable (default: true)

  • releasestringобязательный

    Helm release name

  • revisioninteger

    specify the revision to rollback to (defaults to previous revision if not specified)

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • timeoutinteger

    time to wait for any individual Kubernetes operation in seconds (default: 300)

  • waitboolean

    wait for resources to be ready (default: false)

  • waitForJobsboolean

    wait for jobs to complete before marking the release as successful (default: false)

HelmShowтолько чтение

Политика доступа: требуется аутентификация Требуется указать либо параметр repo, либо registryId (но не оба).

Параметры
  • chartstringобязательный

    Chart name

  • commandstringобязательный

    chart/values/readme

  • environmentIdstring

    Environment ID (required if registryId is provided and user is not an admin)

  • registryIdstring

    Helm registry ID (required if repo not provided)

  • repostring

    Helm repository URL (required if registryId not provided)

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • versionstring

    Chart version

HelmUserRepositoriesListтолько чтение

Инспектирует репозитории helm пользователя. Политика доступа: только для аутентифицированных

Параметры
  • idintegerобязательный

    User identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

HelmUserRepositoryCreate

Создаёт пользовательский репозиторий Helm. Политика доступа: аутентифицированные пользователи

Параметры
  • idintegerобязательный

    User identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • urlstring
HelmUserRepositoryDelete

Политика доступа: аутентификация

Параметры
  • idintegerобязательный

    User identifier

  • repositoryIDintegerобязательный

    Repository identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

KubernetesNamespacesToggleSystem

Переключает состояние системы для namespace Политика доступа: администратор или администратор окружения.

Параметры
  • idintegerобязательный

    Environment identifier

  • namespacestringобязательный

    Namespace name

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • Systemboolean

    Toggle the system state of this namespace to true or false

kubernetes_proxy

Проксирует запрос к Kubernetes API через Portainer для указанного окружения. Путь path передаётся как есть на сервер K8s API (например, /api/v1/pods, /apis/apps/v1/namespaces/default/deployments). Полезная нагрузка K8s содержит много лишнего: один metadata.managedFields часто занимает 30-70% объекта, поэтому передавайте JMESPath select, чтобы спроецировать только то, что нужно. Пример для /api/v1/pods: items[].{name:metadata.name,ns:metadata.namespace,phase:status.phase,node:spec.nodeName}.

Параметры
  • bodystring | null

    Raw request body string (e.g. JSON manifest for POST)

  • environment_idintegerобязательный

    Portainer environment ID

  • headersobject | null

    Extra request headers

  • methodstring

    HTTP method

  • pathstringобязательный

    Kubernetes API path with leading slash

  • query_paramsobject | null

    Query parameters (labelSelector, fieldSelector, ...)

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

Logout

Политика доступа: публичная

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

MOTDтолько чтение

Политика доступа: ограничена

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

namespacesAccessUpdate

Обновляет права доступа к namespace в указанном окружении. Этот endpoint позволяет добавлять или удалять пользователей и команды, у которых есть доступ к указанному namespace. Учтите: пользователей и команды нужно сначала добавить в окружение, прежде чем добавлять их в namespace. Политика доступа: Ограниченная. Пользователь должен быть администратором или иметь соответствующие права на изменение доступа к namespace.

Параметры
  • idintegerобязательный

    Environment identifier

  • rpnintegerобязательный

    Namespace identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • TeamsToAddinteger[]
  • TeamsToRemoveinteger[]
  • UsersToAddinteger[]
  • UsersToRemoveinteger[]
ResizeKubernetesPersistentVolumeClaim

Изменяет размер PVC до нового размера. StorageClass должен поддерживать расширение томов. Политика доступа: аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • namestring
  • namespacestring
  • newSizestring
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

restartKubernetesApplication

Перезапускает приложения Kubernetes (deployment, statefulset и daemonset) с помощью kubectl rollout-restart. Политика доступа: требуется аутентификация.

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • kindstringобязательный

    deployment, statefulset or daemonset

  • namestringобязательный

    name of the application

  • namespacestringобязательный

    The namespace

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

RestartKubernetesPod

Перезапускает все контейнеры в одном поде Kubernetes на месте с помощью альфа-субресурса pod-restart из Kubernetes 1.35. Сам под при этом сохраняется. Требует, чтобы кластер предоставлял соответствующий субресурс (и чтобы был включён соответствующий feature gate). Политика доступа: аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment(Endpoint) identifier

  • namestringобязательный

    Pod name

  • namespacestringобязательный

    Namespace

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

ServiceImageStatusтолько чтение

Политика доступа:

Параметры
  • environmentIdintegerобязательный

    Environment identifier

  • refreshboolean

    Refresh will force a refresh of the image status cache

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • serviceIdintegerобязательный

    Service identifier

serviceImageStatusClear

Очищает кеш статуса изображений для всех сервисов в окружении Политика доступа

Параметры
  • environmentIdintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

SetDefaultKubernetesStorageClass

Устанавливает указанный StorageClass как класс хранения по умолчанию для кластера, снимая признак «по умолчанию» с любого другого.Политика доступа: аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • namestringобязательный

    StorageClass name

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

SettingsAdditionalFunctionalityInspectтолько чтение

Получает настройки дополнительных функций Portainer. Политика доступа: требуется аутентификация.

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

SettingsAdditionalFunctionalityUpdate

Обновляет настройки дополнительных функций Portainer. Политика доступа: администратор

Параметры
  • Observabilitybooleanобязательный
  • Policiesbooleanобязательный
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

SettingsEdgeMTLSCACertificatesтолько чтение

Получает сертификаты CA Portainer Edge MTLS. Политика доступа: администратор

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

SettingsEdgeMTLSCertificatesтолько чтение

Получает сертификаты Portainer Edge MTLS. Политика доступа: администратор

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

SettingsExperimentalInspectтолько чтение

Получает экспериментальные настройки Portainer. Политика доступа: аутентифицирован

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

SettingsExperimentalUpdate

Обновляет экспериментальные настройки Portainer. Политика доступа: администратор

Параметры
  • fleetManagementboolean
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

SettingsInspectтолько чтение

Возвращает настройки Portainer. Политика доступа: администратор

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

SettingsPublicтолько чтение

Получает публичные настройки. Возвращает небольшой набор настроек, которые не зарезервированы только для администраторов. Политика доступа: публичная.

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

SettingsUpdate

Обновляет настройки Portainer. Политика доступа: администратор

Параметры
  • AuthenticationMethodinteger

    Active authentication method for the Portainer instance. Valid values are: 1 for internal, 2 for LDAP, or 3 for oauth

  • AutoPatchSettingsany

    Whether to enable automatic patches

  • BlackListedLabelsobject[]

    A list of label name & value that will be used to hide containers when querying containers

  • CustomLoginBannerstring

    The content in plaintext used to display in the login page. Will hide when value is empty string

  • DisableKubeconfigDownloadboolean

    Whether to disable kubeconfig download for non-admin users

  • DisableKubeRolesSyncboolean

    Whether to disable kube roles sync for all built-in roles

  • DisableKubeShellboolean

    Whether to disable kubeshell access for non-admin users

  • Edgeobject
  • EdgeAgentCheckinIntervalinteger

    The default check in interval for edge agent (in seconds)

  • EdgePortainerURLstring

    EdgePortainerURL is the URL that is exposed to edge agents

  • EnableEdgeComputeFeaturesboolean

    Whether edge compute features are enabled

  • EnforceEdgeIDboolean

    EnforceEdgeID makes Portainer store the Edge ID instead of accepting anyone

  • ForceSecureCookiesboolean

    ForceSecureCookies forces the Secure attribute on auth cookies regardless of the detected scheme

  • GlobalDeploymentOptionsany

    Deployment options for encouraging deployment as code

  • HelmRepositoryURLstring

    Helm repository URL

  • InternalAuthSettingsobject
  • KubeconfigExpirystring

    The expiry of a Kubeconfig

  • KubectlShellImagestring

    Kubectl Shell Image Name/Tag

  • LDAPSettingsobject
  • LogoURLstring

    URL to a logo that will be displayed on the login page as well as on top of the sidebar. Will use default Portainer logo when value is empty string

  • OAuthSettingsobject
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • SnapshotIntervalstring

    The interval in which environment(endpoint) snapshots are created

  • TemplatesURLstring

    URL to the templates that will be displayed in the UI when navigating to App Templates

  • TrustOnFirstConnectboolean

    TrustOnFirstConnect makes Portainer accepting edge agent connection by default

  • UserSessionTimeoutstring

    The duration of a user session

snapshotContainerInspectтолько чтение

Политика доступа:

Параметры
  • containerIdintegerобязательный

    Container identifier

  • environmentIdintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

snapshotContainersListтолько чтение

Политика доступа:

Параметры
  • edgeStackIdinteger

    Edge stack identifier, will return only containers for this edge stack

  • environmentIdintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

snapshotInspectтолько чтение

Политика доступа:

Параметры
  • environmentIdintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

StackAssociate

Политика доступа: администратор

Параметры
  • endpointIdintegerобязательный

    Environment identifier

  • idintegerобязательный

    Stack identifier

  • orphanedRunningbooleanобязательный

    Indicates whether the stack is orphaned

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • swarmIdintegerобязательный

    Swarm identifier

StackConvert

Преобразует стек Docker Compose или Docker Swarm в манифесты Kubernetes или Helm chart и возвращает результаты для предпросмотра. Access policy: authenticated

Параметры
  • idintegerобязательный

    Stack identifier

  • namespacestring

    Namespace for the Kubernetes stack

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • targetFormatstringобязательный

    Target format: "kubernetes" for manifests or "helm" for helm chart

StackCreateDockerStandaloneFile

Разворачивает новый стек в среде Docker, заданной через идентификатор среды. Политика доступа: требуется аутентификация

Параметры
  • endpointIdintegerобязательный

    Identifier of the environment that will be used to deploy the stack

  • Envstring

    Environment variables passed during deployment, represented as a JSON array [{'name': 'name', 'value': 'value'}].

  • filestring

    Stack file

  • Namestringобязательный

    Name of the stack

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

StackCreateDockerStandaloneRepository

Развёртывает новый stack в Docker-окружение, определяемое идентификатором окружения. Политика доступа: требуется аутентификация

Параметры
  • AdditionalFilesstring[]

    Applicable when deploying with multiple stack files

  • AutoUpdateany

    Optional GitOps update configuration

  • ComposeFilestring

    Path to the Stack file inside the Git repository

  • endpointIdintegerобязательный

    Identifier of the environment that will be used to deploy the stack

  • Envobject[]

    A list of environment variables used during stack deployment

  • FilesystemPathstring

    Local filesystem path

  • FromAppTemplateboolean

    Whether the stack is from a app template

  • Namestringобязательный

    Name of the stack

  • Registriesinteger[]

    List of Registries to use for this stack

  • RepositoryAuthenticationboolean

    Deprecated: use SourceID instead. Use basic authentication to clone the Git repository.

  • RepositoryAuthorizationTypeany

    Deprecated: use SourceID instead. RepositoryAuthorizationType is the authorization type to use.

  • RepositoryPasswordstring

    Deprecated: use SourceID instead. Password used in basic authentication. Required when RepositoryAuthentication is true

  • RepositoryProviderany

    Deprecated: use SourceID instead. RepositoryProvider is the provider to use.

  • RepositoryReferenceNamestring

    Reference name of a Git repository hosting the Stack file

  • RepositoryURLstring

    Deprecated: use SourceID instead. URL of a Git repository hosting the Stack file.

  • RepositoryUsernamestring

    Deprecated: use SourceID instead. Username used in basic authentication. Required when RepositoryAuthentication is true

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • SourceIDinteger

    SourceID references an existing Source for git credentials/URL. When set, the inline URL and authentication fields are ignored.

  • SupportRelativePathboolean

    Whether the stack supports relative path volume

  • TLSSkipVerifyboolean

    Deprecated: use SourceID instead. TLSSkipVerify skips SSL verification when cloning the Git repository.

StackCreateDockerStandaloneString

Развёртывает новый стек в Docker-среду, заданную через идентификатор окружения. Политика доступа: аутентифицированный

Параметры
  • endpointIdintegerобязательный

    Identifier of the environment that will be used to deploy the stack

  • Envobject[]

    A list of environment variables used during stack deployment

  • FromAppTemplateboolean

    Whether the stack is from a app template

  • Namestringобязательный

    Name of the stack

  • Registriesinteger[]

    List of Registries to use for this stack

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • StackFileContentstringобязательный

    Content of the Stack file

  • Webhookstring

    A UUID to identify a webhook. The stack will be force updated and pull the latest image when the webhook was invoked.

StackCreateDockerSwarmFile

Разворачивает новый стек в среде Docker, указанной по идентификатору среды. Политика доступа: аутентифицированный

Параметры
  • endpointIdintegerобязательный

    Identifier of the environment that will be used to deploy the stack

  • Envstring

    Environment variables passed during deployment, represented as a JSON array [{'name': 'name', 'value': 'value'}]. Optional

  • filestring

    Stack file

  • Namestring

    Name of the stack

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • SwarmIDstring

    Swarm cluster identifier.

StackCreateDockerSwarmRepository

Разворачивает новый стек в среде Docker, заданной идентификатором среды. Политика доступа: аутентифицированные.

Параметры
  • AdditionalFilesstring[]

    Applicable when deploying with multiple stack files

  • AutoUpdateany

    Optional GitOps update configuration

  • ComposeFilestring

    Path to the Stack file inside the Git repository

  • endpointIdintegerобязательный

    Identifier of the environment that will be used to deploy the stack

  • Envobject[]

    A list of environment variables used during stack deployment

  • FilesystemPathstring

    Network filesystem path

  • FromAppTemplateboolean

    Whether the stack is from a app template

  • Namestringобязательный

    Name of the stack

  • Registriesinteger[]

    List of Registries to use for this stack

  • RepositoryAuthenticationboolean

    Deprecated: use SourceID instead. Use basic authentication to clone the Git repository.

  • RepositoryAuthorizationTypeany

    Deprecated: use SourceID instead. RepositoryAuthorizationType is the authorization type to use.

  • RepositoryPasswordstring

    Deprecated: use SourceID instead. Password used in basic authentication. Required when RepositoryAuthentication is true

  • RepositoryProviderany

    Deprecated: use SourceID instead. RepositoryProvider is the provider to use.

  • RepositoryReferenceNamestring

    Reference name of a Git repository hosting the Stack file

  • RepositoryURLstring

    Deprecated: use SourceID instead. URL of a Git repository hosting the Stack file.

  • RepositoryUsernamestring

    Deprecated: use SourceID instead. Username used in basic authentication. Required when RepositoryAuthentication is true

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • SourceIDinteger

    SourceID references an existing Source for git credentials/URL. When set, the inline URL and authentication fields are ignored.

  • SupportRelativePathboolean

    Whether the stack suppors relative path volume

  • SwarmIDstringобязательный

    Swarm cluster identifier

  • TLSSkipVerifyboolean

    Deprecated: use SourceID instead. TLSSkipVerify skips SSL verification when cloning the Git repository.

StackCreateDockerSwarmString

Разворачивает новый стек в среду Docker, указанную по идентификатору среды. Политика доступа: только для аутентифицированных.

Параметры
  • endpointIdintegerобязательный

    Identifier of the environment that will be used to deploy the stack

  • Envobject[]

    A list of environment variables used during stack deployment

  • FromAppTemplateboolean

    Whether the stack is from a app template

  • Namestringобязательный

    Name of the stack

  • Registriesinteger[]

    List of Registries to use for this stack

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • StackFileContentstringобязательный

    Content of the Stack file

  • SwarmIDstringобязательный

    Swarm cluster identifier

  • Webhookstring

    A UUID to identify a webhook. The stack will be force updated and pull the latest image when the webhook was invoked.

StackCreateKubernetesFile

Разворачивает новый стек в Docker-окружении, указанном через идентификатор окружения. Политика доступа: аутентифицированный пользователь

Параметры
  • ComposeFormatboolean
  • endpointIdintegerобязательный

    Identifier of the environment that will be used to deploy the stack

  • FromAppTemplateboolean

    Whether the stack is from a app template

  • Namespacestring
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • StackFileContentstring
  • StackNamestring
StackCreateKubernetesGit

Развертывает новый стек в Docker-среду, заданную через идентификатор окружения. Политика доступа: требуется аутентификация

Параметры
  • AdditionalFilesstring[]
  • AutoUpdateobject
  • ComposeFormatboolean
  • endpointIdintegerобязательный

    Identifier of the environment that will be used to deploy the stack

  • HelmChartPathstring

    Helm-specific fields

  • HelmValuesFilesstring[]

    Array of paths to values YAML files in Git repo

  • ManifestFilestring
  • Namespacestring
  • RepositoryAuthenticationboolean

    Deprecated: use SourceID instead. Use authentication to clone the Git repository.

  • RepositoryAuthorizationTypeany

    Deprecated: use SourceID instead. Authorization type used to clone the Git repository.

  • RepositoryPasswordstring

    Deprecated: use SourceID instead. Password used in authentication.

  • RepositoryProviderany

    Deprecated: use SourceID instead. Provider used to clone the Git repository.

  • RepositoryReferenceNamestring

    Deprecated: use SourceID instead. Reference name of a Git repository hosting the Stack file.

  • RepositoryURLstring

    Deprecated: use SourceID instead. URL of a Git repository hosting the Stack file.

  • RepositoryUsernamestring

    Deprecated: use SourceID instead. Username used in authentication.

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • SourceIDinteger

    SourceID references an existing Source for git credentials/URL. When set, the inline URL and authentication fields are ignored.

  • StackNamestring
  • TLSSkipVerifyboolean

    Deprecated: use SourceID instead. TLSSkipVerify skips SSL verification when cloning the Git repository.

StackCreateKubernetesUrl

Развёртывает новый стек в Docker-среде, заданной через идентификатор среды. Политика доступа: аутентифицированный

Параметры
  • ComposeFormatboolean
  • endpointIdintegerобязательный

    Identifier of the environment that will be used to deploy the stack

  • ManifestURLstring
  • Namespacestring
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • StackNamestring
StackDelete

Удаляет стек. Политика доступа: restricted

Параметры
  • endpointIdintegerобязательный

    Environment identifier

  • externalboolean

    Set to true to delete an external stack. Only external Swarm stacks are supported

  • idintegerобязательный

    Stack identifier

  • removeVolumesboolean

    Set to true to delete named volumes declared in the stack file and anonymous volumes attached to containers. Only affects Docker Standalone stacks.

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

StackDeleteKubernetesByName

Удаляет стек. Политика доступа: ограниченная

Параметры
  • endpointIdintegerобязательный

    Environment identifier

  • externalboolean

    Set to true to delete an external stack. Only external Swarm stacks are supported

  • namestringобязательный

    Stack name

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

StackFileInspectтолько чтение

Получает содержимое файла Stack. Политика доступа: ограничена

Параметры
  • commitHashstring

    Git repository commit hash. If both version and commitHash are provided, the commitHash will be used

  • idintegerобязательный

    Stack identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • versioninteger

    Stack file version maintained by Portainer. If both version and commitHash are provided, the commitHash will be used

StackGitRedeploy

Получает и повторно разворачивает стек через Git Политика доступа: только для аутентифицированных

Параметры
  • endpointIdinteger

    Stacks created before version 1.18.0 might not have an associated environment(endpoint) identifier. Use this optional parameter to set the environment(endpoint) identifier used by the stack.

  • Envobject[]
  • idintegerобязательный

    Stack identifier

  • Pruneboolean
  • PullImageboolean

    Deprecated(2.36): use RepullImageAndRedeploy instead for cleaner responsibility Force a pulling to current image with the original tag though the image is already the latest

  • RepositoryAuthenticationboolean
  • RepositoryAuthorizationTypeenum
  • RepositoryPasswordstring
  • RepositoryProviderenum
  • RepositoryReferenceNamestring
  • RepositoryUsernamestring
  • RepullImageAndRedeployboolean

    RepullImageAndRedeploy indicates whether to force repulling images and redeploying the stack

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • StackNamestring
stackImagesStatusтолько чтение

Политика доступа:

Параметры
  • idintegerобязательный

    Stack identifier

  • refreshboolean

    Refresh will force a refresh of the image status cache

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

StackInspectтолько чтение

Получает сведения о стеке. Политика доступа: ограниченная

Параметры
  • idintegerобязательный

    Stack identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

StackListтолько чтение

Выводит список всех стеков на основе авторизаций текущего пользователя. Возвращает все стеки, если используется учётная запись администратора, иначе возвращает только список стеков, к которым у пользователя есть доступ. Ограниченные стеки этот эндпоинт не возвращает. Политика доступа: аутентифицированный

Параметры
  • filtersstring

    Filters to process on the stack list. Encoded as JSON (a map[string]string). For example, {'SwarmID': 'jpofkc0i9uo9wtx1zesuk649w'} will only return stacks that are part of the specified Swarm cluster. Available filters: EndpointID, SwarmID.

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

StackMigrate

Переносит стек из одной среды (endpoint) в другую среду (endpoint). Пересоздаёт стек в целевой среде (endpoint) перед удалением исходного стека. Политика доступа: аутентифицированный

Параметры
  • endpointIdinteger

    Stacks created before version 1.18.0 might not have an associated environment(endpoint) identifier. Use this optional parameter to set the environment(endpoint) identifier used by the stack.

  • EndpointIDintegerобязательный
  • idintegerобязательный

    Stack identifier

  • IsHelmboolean
  • Namestring
  • Namespacestring
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • SwarmIDstring
stacksImageStatusClear

Очищает кэш статуса образов для всех стеков в окружении Политика доступа:

Параметры
  • environmentIdinteger

    Identifier of the environment(endpoint) that will be used to filter the stacks to clear the image status cache for

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • swarmIdstring

    Identifier of the swarm cluster that will be used to filter the stacks to clear the image status cache for

StackStart

Запускает остановленный Stack. Политика доступа: authenticated

Параметры
  • endpointIdintegerобязательный

    Environment identifier

  • idintegerобязательный

    Stack identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

StackStop

Останавливает запущенный Stack. Политика доступа: аутентифицированный

Параметры
  • endpointIdintegerобязательный

    Environment identifier

  • idintegerобязательный

    Stack identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

StacksWebhookInvoke

Политика доступа: public

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • webhookIDstringобязательный

    Stack identifier

StackUpdate

Обновляет стек, только для стеков на основе файлов. Политика доступа: аутентифицированный

Параметры
  • endpointIdintegerобязательный

    Environment identifier

  • Envobject[]

    A list of environment(endpoint) variables used during stack deployment

  • idintegerобязательный

    Stack identifier

  • Pruneboolean

    Prune services that are no longer referenced (only available for Swarm stacks)

  • PullImageboolean

    Deprecated(2.36): use RepullImageAndRedeploy instead for cleaner responsibility Force a pulling to current image with the original tag though the image is already the latest

  • Registriesinteger[]

    List of Registries to use for this stack

  • RepullImageAndRedeployboolean

    RepullImageAndRedeploy indicates whether to force repulling images and redeploying the stack

  • RollbackTointeger

    RollbackTo specifies the stack file version to rollback to (only support to rollback to the last version currently)

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • StackFileContentstring

    New content of the Stack file

  • Webhookstring

    A UUID to identify a webhook. The stack will be force updated and pull the latest image when the webhook was invoked.

StackUpdateGit

Обновляет настройки Git в стеке, например, RepositoryReferenceName и AutoUpdate. Когда задан SourceID, URL/авторизация/TLS берутся из указанного Source. Политика доступа: только для аутентифицированных

Параметры
  • AdditionalFilesstring[]
  • Atomicboolean

    Enable atomic rollback on failure (Helm --atomic flag)

  • AutoUpdateobject
  • ConfigFilePathstring
  • endpointIdinteger

    Stacks created before version 1.18.0 might not have an associated environment(endpoint) identifier. Use this optional parameter to set the environment(endpoint) identifier used by the stack.

  • Envobject[]
  • HelmChartPathstring

    Helm chart folder path in Git repo (for Helm stacks)

  • HelmValuesFilesstring[]

    Helm values files paths in Git repo (for Helm stacks)

  • idintegerобязательный

    Stack identifier

  • Pruneboolean
  • Registriesinteger[]
  • RepositoryAuthenticationboolean

    Deprecated: use SourceID instead. Use basic authentication to clone the Git repository.

  • RepositoryAuthorizationTypeany

    Deprecated: use SourceID instead. Authorization type for git authentication.

  • RepositoryPasswordstring

    Deprecated: use SourceID instead. Password used in basic authentication.

  • RepositoryProviderany

    Deprecated: use SourceID instead. Git provider for OAuth-based authentication.

  • RepositoryReferenceNamestring
  • RepositoryURLstring

    Deprecated: use SourceID instead. URL of a Git repository hosting the Stack file.

  • RepositoryUsernamestring

    Deprecated: use SourceID instead. Username used in basic authentication.

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • SourceIDinteger

    SourceID references an existing Source for git credentials/URL. When set, the inline URL and authentication fields are ignored.

  • TLSSkipVerifyboolean
StatusInspectтолько чтение

Устарело: используйте вместо него endpoint /system/status. Получает статус Portainer Политика доступа: public

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

systemInfoтолько чтение

Политика доступа: требуется аутентификация

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

systemNodesCountтолько чтение

Политика доступа: аутентифицированным пользователям

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

systemStatusтолько чтение

Возвращает статус Portainer Политика доступа: публичная

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

systemUpdate

Обновляет Portainer до последней версииПолитика доступа: administrator

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

systemVersionтолько чтение

Проверяет, доступно ли обновление для Portainer. Политика доступа: требуется аутентификация.

Параметры
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

TrustEdgeEndpoints

Связывает одно или несколько Edge-окружений, в настоящее время находящихся в комнате ожидания, с окружениями Portainer. Это действие фактически предоставляет доверие этим окружениям. Политика доступа: только администратор.

Параметры
  • EndpointIDsinteger[]
  • Relationsobject
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

updateK8sPodSecurityRule

Обновляет Pod Security Rule в кластере k8s Политика доступа: аутентифицированный

Параметры
  • environmentIdintegerобязательный

    Environment(Endpoint) identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

UpdateKubernetesIngress

Обновляет Ingress для указанного окружения. Политика доступа: аутентифицированный пользователь.

Параметры
  • Annotationsobject
  • ClassNamestring
  • CreationDatestring
  • Hostsstring[]
  • idintegerобязательный

    Environment identifier

  • Labelsobject
  • Namestring
  • namespacestringобязательный

    Namespace name

  • Namespacestring
  • Pathsobject[]
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • TLSobject[]
  • Typestring
  • UIDstring
UpdateKubernetesIngressControllers

Обновляет (блокирует/разблокирует) ingress controllers для указанного окружения. Политика доступа: аутентифицированный пользователь.

Параметры
  • bodyobject[]обязательный

    Ingress controllers

  • idintegerобязательный

    Environment identifier

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

UpdateKubernetesIngressControllersByNamespace

Обновляет (блокирует/разблокирует) ingress-контроллеры по namespace для указанного окружения. Политика доступа: аутентифицированный пользователь.

Параметры
  • bodyobject[]обязательный

    Ingress controllers

  • idintegerобязательный

    Environment identifier

  • namespacestringобязательный

    Namespace name

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

UpdateKubernetesNamespace

Обновляет namespace в указанном окружении. Политика доступа: аутентифицированный пользователь.

Параметры
  • Annotationsobject
  • idintegerобязательный

    Environment identifier

  • LoadBalancerQuotaobject
  • Namestring
  • namespacestringобязательный

    Namespace

  • Ownerstring
  • ResourceQuotaobject
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • StorageQuotasobject
UpdateKubernetesPersistentVolumeReclaimPolicy

Обновляет политику повторного использования PersistentVolume. Политика доступа: аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • namestring
  • reclaimPolicyenum
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

UpdateKubernetesService

Обновляет сервис в указанном пространстве имён. Политика доступа: аутентифицированный пользователь.

Параметры
  • AllocateLoadBalancerNodePortsboolean
  • Annotationsobject
  • Applicationsobject[]

    serviceList screen

  • ClusterIPsstring[]
  • CreationDatestring
  • ExternalIPsstring[]
  • ExternalNamestring
  • idintegerобязательный

    Environment identifier

  • IngressStatusobject[]
  • Labelsobject
  • Namestring
  • namespacestringобязательный

    Namespace name

  • Namespacestring
  • Portsobject[]
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

  • Selectorobject
  • Typestring
  • UIDstring
UpdateKubernetesServiceAccountImagePullSecrets

Заменяет список imagePullSecrets в сервисном аккаунте на предоставленный список. Политика доступа: аутентифицированный пользователь.

Параметры
  • idintegerобязательный

    Environment identifier

  • namestringобязательный

    Service account name

  • namespacestringобязательный

    Namespace

  • secretNamesstring[]
  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

ValidateOAuth

Политика доступа: публичная

Параметры
  • Codestring

    OAuth code returned from OAuth Provided

  • selectstring | null

    Optional JMESPath expression to project the response server-side. Use it on noisy endpoints to drop fields you don't need — e.g. [].{id:Id,name:Name,type:Type} for a list of environments, or {kind:Kind,name:metadata.name,phase:status.phase} for a single K8s object. Omit to receive the full response (subject to the global size cap).

Похожие MCP-сервера

silenceper/mcp-k8s

silenceper/mcp-k8s

MCP сервер для Kubernetes: управляйте кластерами через LLM-запросы - выполняйте CRUD-операции с ресурсами, управляйте Helm-релизами и репозиториями. Полезен DevOps и разработчикам для автоматизации...

Go151
ckreiling/mcp-server-docker

ckreiling/mcp-server-docker

MCP-сервер для управления Docker через естественный язык: запускает и отлаживает контейнеры, управляет томами и сетями. Идеален для администраторов удалённых серверов и разработчиков, автоматизирую...

Python743
strowk/mcp-k8s-go

strowk/mcp-k8s-go

MCP сервер на Go для управления Kubernetes через Claude Desktop. Позволяет просматривать контексты и ресурсы (поды, сервисы, деплои), получать логи, запускать команды в подах. Полезен DevOps-инжене...

Go384
mrostamii/rancher-mcp-server

mrostamii/rancher-mcp-server

MCP-сервер для управления Rancher, Harvester HCI и Fleet GitOps через единый API. Работает с мультикластерным Kubernetes, виртуальными машинами, Helm-релизами и GitOps-репозиториями. По умолчанию т...

Go12
astandrik/local-ydb-toolkit

astandrik/local-ydb-toolkit

MCP-сервер для управления Docker-инстансами local-ydb: создание тестовых YDB баз, управление схемами, дамп и восстановление. Полезен разработчикам для локального тестирования и CI на GitHub Actions.

TypeScript4
LucasHild/mcp-server-bigquery

LucasHild/mcp-server-bigquery

MCP-сервер для BigQuery: ИИ-ассистенты могут инспектировать схемы БД и выполнять SQL-запросы. Применяется для аналитики данных, создания отчетов и автоматизации запросов через языковые модели.

Python130
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин