回滚AddonInstance

功能介绍

将插件实例回滚到升级前的版本。只有在当前插件实例版本支持回滚到升级前的版本（status.isRollbackable为true），且插件实例状态为running（运行中）、available（可用）、abnormal（不可用）、upgradeFailed（升级失败）、rollbackFailed（回滚失败）时支持回滚。

调用方法

请参见如何调用API。

URI

POST /autopilot/v3/addons/{id}/operation/rollback

请求参数

响应参数

状态码： 200

请求示例

{
  "clusterID" : "******"
}

响应示例

状态码： 200

插件实例回滚成功

{
  "kind" : "Addon",
  "apiVersion" : "v3",
  "metadata" : {
    "uid" : "4eba2678-330f-430b-aefc-821e1bbeff34",
    "name" : "coredns",
    "alias" : "coredns",
    "creationTimestamp" : "2024-07-18T03:03:17Z",
    "updateTimestamp" : "2024-07-18T03:04:44Z"
  },
  "spec" : {
    "clusterID" : "597f2d95-44ab-11ef-9e39-0255ac100115",
    "version" : "1.28.4",
    "addonTemplateName" : "coredns",
    "addonTemplateType" : "helm",
    "addonTemplateLogo" : "",
    "addonTemplateLabels" : [ "ContainerNetwork" ],
    "description" : "CoreDNS is a DNS server that chains plugins and provides Kubernetes DNS Services",
    "values" : {
      "basic" : {
        "cluster_ip" : "10.247.3.10",
        "cluster_version" : "v1.28",
        "image_version" : "1.28.4",
        "platform" : "linux-amd64",
        "rbac_enabled" : true,
        "swr_addr" : "swr.cn-north-7.myhuaweicloud.com",
        "swr_user" : "autopilot-official"
      },
      "custom" : {
        "extraConfig" : { },
        "multiAZBalance" : false,
        "multiAZEnabled" : false,
        "nodeSelector" : { },
        "node_match_expressions" : [ ],
        "parameterSyncStrategy" : "ensureConsistent",
        "servers" : [ {
          "plugins" : [ {
            "name" : "bind",
            "parameters" : "{$POD_IP}"
          }, {
            "configBlock" : "servfail 5s",
            "name" : "cache",
            "parameters" : 30
          }, {
            "name" : "errors"
          }, {
            "name" : "health",
            "parameters" : "{$POD_IP}:8080"
          }, {
            "name" : "ready",
            "parameters" : "{$POD_IP}:8081"
          }, {
            "configBlock" : "pods insecure\nfallthrough in-addr.arpa ip6.arpa",
            "name" : "kubernetes",
            "parameters" : "cluster.local in-addr.arpa ip6.arpa"
          }, {
            "name" : "loadbalance",
            "parameters" : "round_robin"
          }, {
            "name" : "prometheus",
            "parameters" : "{$POD_IP}:9153"
          }, {
            "configBlock" : "policy random",
            "name" : "forward",
            "parameters" : ". /etc/resolv.conf"
          }, {
            "name" : "reload"
          } ],
          "port" : 5353,
          "zones" : [ {
            "zone" : "."
          } ]
        } ],
        "stub_domains" : { },
        "tolerations" : [ {
          "effect" : "NoExecute",
          "key" : "node.kubernetes.io/not-ready",
          "operator" : "Exists",
          "tolerationSeconds" : 60
        }, {
          "effect" : "NoExecute",
          "key" : "node.kubernetes.io/unreachable",
          "operator" : "Exists",
          "tolerationSeconds" : 60
        } ],
        "upstream_nameservers" : [ ]
      },
      "flavor" : {
        "category" : [ "Autopilot" ],
        "is_default" : true,
        "name" : "autopilot-flavor1",
        "replicas" : 2,
        "resources" : [ {
          "id" : "coredns",
          "limitsCpu" : "1000m",
          "limitsMem" : "1024Mi",
          "name" : "coredns",
          "requestsCpu" : "1000m",
          "requestsMem" : "1024Mi"
        } ]
      },
      "image" : {
        "pullPolicy" : "Always"
      },
      "isClusterService" : true,
      "multiAZPreferred" : {
        "podAntiAffinity" : {
          "preferredDuringSchedulingIgnoredDuringExecution" : [ {
            "podAffinityTerm" : {
              "labelSelector" : {
                "matchExpressions" : [ {
                  "key" : "app",
                  "operator" : "In",
                  "values" : [ "coredns" ]
                } ]
              },
              "topologyKey" : "topology.kubernetes.io/zone"
            },
            "weight" : 100
          } ]
        }
      },
      "multiAZRequired" : {
        "podAntiAffinity" : {
          "requiredDuringSchedulingIgnoredDuringExecution" : [ {
            "labelSelector" : {
              "matchExpressions" : [ {
                "key" : "az-antiaffinity-app",
                "operator" : "In",
                "values" : [ "coredns" ]
              } ]
            },
            "topologyKey" : "topology.kubernetes.io/zone"
          } ]
        }
      },
      "nodeSelector" : { },
      "rbac" : {
        "create" : true,
        "serviceAccountName" : "default"
      },
      "service" : {
        "annotations" : {
          "prometheus.io/port" : "9153",
          "prometheus.io/scrape" : "true"
        },
        "clusterIP" : "10.247.3.10",
        "type" : "ClusterIP"
      },
      "systemAutoInject" : {
        "cluster" : {
          "clusterID" : "597f2d95-44ab-11ef-9e39-0255ac100115",
          "clusterNetworkMode" : "eni",
          "clusterVersion" : "v1.28.5-r0"
        },
        "user" : {
          "projectID" : "47eb1d64cbeb45cfa01ae20af4f4b563"
        }
      },
      "topologySpreadConstraints" : [ {
        "labelSelector" : {
          "matchLabels" : {
            "app" : "coredns"
          }
        },
        "maxSkew" : 1,
        "topologyKey" : "topology.kubernetes.io/zone",
        "whenUnsatisfiable" : "DoNotSchedule"
      } ],
      "zoneFiles" : [ ]
    }
  },
  "status" : {
    "status" : "rollbacking",
    "Reason" : "Rollback to 1",
    "message" : "",
    "targetVersions" : [ "1.28.6" ],
    "isRollbackable" : false,
    "previousVersion" : "1.28.6",
    "currentVersion" : {
      "version" : "1.28.4",
      "input" : {
        "basic" : {
          "cluster_ip" : "10.247.3.10",
          "image_version" : "1.28.4",
          "swr_addr" : "swr.cn-north-7.myhuaweicloud.com",
          "swr_user" : "autopilot-official"
        },
        "parameters" : {
          "autopilot-flavor1" : {
            "category" : [ "Autopilot" ],
            "is_default" : true,
            "name" : "autopilot-flavor1",
            "replicas" : 2,
            "resources" : [ {
              "limitsCpu" : 1,
              "limitsMem" : "1Gi",
              "name" : "coredns",
              "requestsCpu" : 1,
              "requestsMem" : "1Gi"
            } ]
          },
          "custom" : {
            "multiAZBalance" : false,
            "multiAZEnabled" : false,
            "node_match_expressions" : [ ],
            "parameterSyncStrategy" : "ensureConsistent",
            "servers" : [ {
              "plugins" : [ {
                "name" : "bind",
                "parameters" : "{$POD_IP}"
              }, {
                "configBlock" : "servfail 5s",
                "name" : "cache",
                "parameters" : 30
              }, {
                "name" : "errors"
              }, {
                "name" : "health",
                "parameters" : "{$POD_IP}:8080"
              }, {
                "name" : "ready",
                "parameters" : "{$POD_IP}:8081"
              }, {
                "configBlock" : "pods insecure\nfallthrough in-addr.arpa ip6.arpa",
                "name" : "kubernetes",
                "parameters" : "cluster.local in-addr.arpa ip6.arpa"
              }, {
                "name" : "loadbalance",
                "parameters" : "round_robin"
              }, {
                "name" : "prometheus",
                "parameters" : "{$POD_IP}:9153"
              }, {
                "configBlock" : "policy random",
                "name" : "forward",
                "parameters" : ". /etc/resolv.conf"
              }, {
                "name" : "reload"
              } ],
              "port" : 5353,
              "zones" : [ {
                "zone" : "."
              } ]
            } ],
            "stub_domains" : { },
            "tolerations" : [ {
              "effect" : "NoExecute",
              "key" : "node.kubernetes.io/not-ready",
              "operator" : "Exists",
              "tolerationSeconds" : 60
            }, {
              "effect" : "NoExecute",
              "key" : "node.kubernetes.io/unreachable",
              "operator" : "Exists",
              "tolerationSeconds" : 60
            } ],
            "upstream_nameservers" : [ ]
          },
          "flavor1" : {
            "is_default" : true,
            "name" : 2500,
            "recommend_cluster_flavor_types" : [ "small" ],
            "replicas" : 2,
            "resources" : [ {
              "limitsCpu" : "500m",
              "limitsMem" : "512Mi",
              "name" : "coredns",
              "requestsCpu" : "500m",
              "requestsMem" : "512Mi"
            } ]
          },
          "flavor2" : {
            "name" : 5000,
            "recommend_cluster_flavor_types" : [ "medium" ],
            "replicas" : 2,
            "resources" : [ {
              "limitsCpu" : "1000m",
              "limitsMem" : "1024Mi",
              "name" : "coredns",
              "requestsCpu" : "1000m",
              "requestsMem" : "1024Mi"
            } ]
          },
          "flavor3" : {
            "name" : 10000,
            "recommend_cluster_flavor_types" : [ "large" ],
            "replicas" : 2,
            "resources" : [ {
              "limitsCpu" : "2000m",
              "limitsMem" : "2048Mi",
              "name" : "coredns",
              "requestsCpu" : "2000m",
              "requestsMem" : "2048Mi"
            } ]
          },
          "flavor4" : {
            "name" : 20000,
            "recommend_cluster_flavor_types" : [ "xlarge" ],
            "replicas" : 4,
            "resources" : [ {
              "limitsCpu" : "2000m",
              "limitsMem" : "2048Mi",
              "name" : "coredns",
              "requestsCpu" : "2000m",
              "requestsMem" : "2048Mi"
            } ]
          }
        }
      },
      "stable" : true,
      "translate" : {
        "en_US" : {
          "addon" : {
            "changeLog" : "plugin specifications can be associated with cluster specifications. The time zone of the plug-in is the same as that of the node",
            "description" : "CoreDNS is a DNS server that chains plugins and provides Kubernetes DNS Services"
          },
          "description" : {
            "Parameters.custom.stub_domains" : "The target nameserver may itself be a Kubernetes service. For instance, you can run your own copy of dnsmasq to export custom DNS names into the ClusterDNS namespace, a JSON map using a DNS suffix key (e.g. “acme.local”) and a value consisting of a JSON array of DNS IPs.",
            "Parameters.custom.upstream_nameservers" : "If specified, then the values specified replace the nameservers taken by default from the node’s /etc/resolv.conf. Limits:a maximum of three upstream nameservers can be specified, A JSON array of DNS IPs.",
            "Parameters.flavor1.description" : "Concurrent domain name resolution ability  -  External domain name：2500 qps,  Internal domain name：10000 qps",
            "Parameters.flavor1.name" : 2500,
            "Parameters.flavor2.description" : "Concurrent domain name resolution ability  -  External domain name：5000 qps, Internal domain name：20000 qps",
            "Parameters.flavor2.name" : 5000,
            "Parameters.flavor3.description" : "Concurrent domain name resolution ability  -  External domain name：10000 qps, Internal domain name：40000 qps",
            "Parameters.flavor3.name" : 10000,
            "Parameters.flavor4.description" : "Concurrent domain name resolution ability  -  External domain name：20000 qps, Internal domain name：80000 qps",
            "Parameters.flavor4.name" : 20000
          },
          "key" : {
            "Parameters.custom.stub_domains" : "stub domain",
            "Parameters.custom.upstream_nameservers" : "upstream nameservers"
          }
        },
        "fr_FR" : {
          "addon" : {
            "changeLog" : "les spécifications du plugin peuvent être associées aux spécifications du cluster. le fuseau horaire du plug-in est le même que celui du noeud",
            "description" : "Un serveur DNS qui enchaîne les plug-ins et fournit des services DNS Kubernetes."
          },
          "description" : {
            "Parameters.custom.stub_domains" : "Le serveur de noms cible peut lui-même être un service Kubernetes. Par exemple, vous pouvez exécuter votre propre copie de dnsmasq pour exporter des noms DNS personnalisés dans l'espace de noms ClusterDNS, une carte JSON à l'aide d'une clé de suffixe DNS (par exemple, «acme.local») et une valeur constituée d'un tableau JSON d'adresses IP DNS.",
            "Parameters.custom.upstream_nameservers" : "Si spécifié, les valeurs spécifiées remplacent les serveurs de noms pris par défaut dans le fichier /etc/resolv.conf du nœud. Limites: un maximum de trois serveurs de noms en amont peuvent être spécifiés, un tableau JSON d'adresses IP DNS.",
            "Parameters.flavor1.description" : "Capacité de résolution de nom de domaine simultanée - Nom de domaine externe: 2500 qps, Nom de domaine interne: 10000 qp",
            "Parameters.flavor1.name" : 2500,
            "Parameters.flavor2.description" : "Capacité de résolution de nom de domaine simultanée - Nom de domaine externe: 5000 qps, Nom de domaine interne: 20000 qp",
            "Parameters.flavor2.name" : 5000,
            "Parameters.flavor3.description" : "Capacité de résolution de nom de domaine simultanée - Nom de domaine externe: 10000 qps, Nom de domaine interne: 40000 qp",
            "Parameters.flavor3.name" : 10000,
            "Parameters.flavor4.description" : "Capacité de résolution de nom de domaine simultanée - Nom de domaine externe: 20000 qps, Nom de domaine interne: 80000 qp",
            "Parameters.flavor4.name" : 20000
          },
          "key" : {
            "Parameters.custom.stub_domains" : "domaine stub",
            "Parameters.custom.upstream_nameservers" : "serveurs de noms en amont"
          }
        },
        "zh_CN" : {
          "addon" : {
            "changeLog" : "支持插件规格与集群规格联动; 插件与节点时区一致",
            "description" : "CoreDNS是一款通过链式插件的方式给Kubernetes提供DNS解析服务的DNS服务器"
          },
          "description" : {
            "Parameters.custom.stub_domains" : "用户可对自定义的域名配置域名服务器，格式为一个键值对，键为DNS后缀域名，值为一个或一组DNS IP地址，如\"acme.local -- 1.2.3.4,6.7.8.9\"。",
            "Parameters.custom.upstream_nameservers" : "解析除集群内服务域名以及自定义域名之外的域名地址，格式为一个或一组DNS IP地址，如\"8.8.8.8\",\"8.8.4.4\"。",
            "Parameters.flavor1.description" : "并发域名解析能力 - 外部域名：2500 qps，内部域名：10000 qps",
            "Parameters.flavor1.name" : 2500,
            "Parameters.flavor2.description" : "并发域名解析能力 - 外部域名：5000 qps，内部域名：20000 qps",
            "Parameters.flavor2.name" : 5000,
            "Parameters.flavor3.description" : "并发域名解析能力 - 外部域名：10000 qps，内部域名：40000 qps",
            "Parameters.flavor3.name" : 10000,
            "Parameters.flavor4.description" : "并发域名解析能力 - 外部域名：20000 qps，内部域名：80000 qps",
            "Parameters.flavor4.name" : 20000
          },
          "key" : {
            "Parameters.custom.stub_domains" : "存根域",
            "Parameters.custom.upstream_nameservers" : "上游域名服务器"
          }
        }
      },
      "supportVersions" : null,
      "creationTimestamp" : "2024-01-22T11:05:45Z",
      "updateTimestamp" : "2024-01-22T11:05:45Z"
    }
  }
}

SDK代码示例

SDK代码示例如下。

状态码

错误码

请参见错误码。