Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Cloud Container Engine/ Referência de API/ APIs/ Gerenciamento de complementos/ Atualização de uma instância de complemento

Atualizado em 2024-09-10 GMT+08:00

Ver PDF

Atualização de uma instância de complemento

Função

Essa API é usada para atualizar uma instância de complemento.

URI

PUT /api/v3/addons/{id}

**Tabela 1** Parâmetros de caminho
Parâmetro	Obrigatório	Tipo	Descrição
id	Sim	String	ID da instância do complemento.

Parâmetros de solicitação

**Tabela 2** Parâmetros de cabeçalho de solicitação
Parâmetro	Obrigatório	Tipo	Descrição
Content-Type	Sim	String	Tipo de corpo da mensagem (formato).
X-Auth-Token	Sim	String	As solicitações para chamar uma API podem ser autenticadas usando um token ou AK/SK. Se a autenticação baseada em token for usada, esse parâmetro é obrigatório e deve ser definido como um token de usuário. Para obter detalhes, consulte Obtenção de um token de usuário.

**Tabela 3** Parâmetros do corpo da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
kind	Sim	String	Tipo de API. O valor é fixado em Addon e não pode ser alterado. Qualquer valor definido pelo usuário é inválido.
apiVersion	Sim	String	Versão da API. O valor é fixado em v3 e não pode ser alterado. Qualquer valor definido pelo usuário é inválido.
metadata	Sim	AddonMetadata object	Informações básicas sobre o objeto. Metadados são uma coleção de atributos.
spec	Sim	InstanceRequestSpec object	Descrição detalhada da instalação ou atualização do complemento.

**Tabela 4** AddonMetadata
Parâmetro	Obrigatório	Tipo	Descrição
uid	Não	String	ID único
name	Não	String	Nome do complemento
alias	Não	String	Alias do complemento
labels	Não	Map<String,String>	Rótulos do complemento em pares chave-valor. Este é um campo reservado e não tem efeito.
annotations	Não	Map<String,String>	Anotações do complemento, no formato de pares chave-valor. Para instalação do complemento, o valor é fixado em {"addon.install/type":"install"}. Para a atualização do complemento, o valor é fixado em {"addon.upgrade/type":"upgrade"}.
updateTimestamp	Não	String	Atualizado em
creationTimestamp	Não	String	Criado em

**Tabela 5** InstanceRequestSpec
Parâmetro	Obrigatório	Tipo	Descrição
version	Não	String	Versão do complemento para instalar ou atualizar, por exemplo, 1.0.0. Installation: este parâmetro é opcional. Se não for especificada, será utilizada a versão mais recente suportada pelo cluster. Upgrade: este parâmetro é obrigatório. O número da versão deve ser especificado.
clusterID	Sim	String	ID do cluster.
values	Sim	Map<String,Object>	Parâmetros de instalação do modelo de complemento (variando dependendo do complemento). Durante a atualização do complemento, você precisa especificar todos os parâmetros de instalação. Se os parâmetros não forem especificados, os valores padrão no modelo de complemento serão usados. Os parâmetros atuais de instalação do complemento podem ser obtidos por meio da API para consulta de instâncias do complemento.
addonTemplateName	Sim	String	Nome do modelo de complemento a ser instalado, por exemplo, coredns.

Parâmetros de resposta

Código de status: 200

**Tabela 6** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
kind	String	Tipo de API. O valor é fixado em Addon e não pode ser alterado.
apiVersion	String	Versão da API. O valor é fixado em v3 e não pode ser alterado.
metadata	AddonMetadata object	Informações básicas sobre o objeto. Metadados são uma coleção de atributos.
spec	InstanceSpec object	Descrição detalhada da instância do complemento.
status	AddonInstanceStatus object	Status da instância do complemento.

**Tabela 7** AddonMetadata
Parâmetro	Tipo	Descrição
uid	String	ID único
name	String	Nome do complemento
alias	String	Alias do complemento
labels	Map<String,String>	Rótulos do complemento em pares chave-valor. Este é um campo reservado e não tem efeito.
annotations	Map<String,String>	Anotações do complemento, no formato de pares chave-valor. Para instalação do complemento, o valor é fixado em {"addon.install/type":"install"}. Para a atualização do complemento, o valor é fixado em {"addon.upgrade/type":"upgrade"}.
updateTimestamp	String	Atualizado em
creationTimestamp	String	Criado em

**Tabela 8** InstanceSpec
Parâmetro	Tipo	Descrição
clusterID	String	ID do cluster.
version	String	Versão do modelo de complemento, por exemplo, 1.0.0.
addonTemplateName	String	Nome do modelo de complemento, por exemplo, coredns.
addonTemplateType	String	Tipo de modelo de complemento.
addonTemplateLogo	String	URL para obter o logotipo do modelo de complemento.
addonTemplateLabels	Array of strings	Rótulos do modelo de complemento.
description	String	Descrição do modelo de complemento.
values	Map<String,Object>	Parâmetros de instalação do modelo de complemento (variando dependendo do complemento). Defina os parâmetros de acordo.

**Tabela 9** AddonInstanceStatus
Parâmetro	Tipo	Descrição
status	String	Status de instâncias do complemento. Opções: running: todas as instâncias do complemento estão em execução e o complemento está em execução corretamente. abnormal: as instâncias do complemento são anormais e o complemento não pode ser usado. Clique no nome do complemento para ver as exceções. installing: o complemento está sendo instalado. installFailed: falhou ao instalar o complemento. Nesse caso, desinstale o complemento e reinstale-o. upgrading: o complemento está sendo atualizado. upgradeFailed: falhou ao atualizar o complemento. Nesse caso, atualize o complemento novamente ou desinstale o complemento e reinstale-o. deleting: o complemento está sendo excluído. deleteFailed: falhou ao excluir o complemento. Nesse caso, desinstale o complemento novamente. deleteSuccess: a exclusão do complemento foi bem-sucedida. available: apenas algumas instâncias do complemento estão em execução. Isso indica que algumas funções do complemento estão disponíveis. rollbacking: o complemento está sendo revertido. rollbackFailed: falhou ao reverter o complemento. Nesse caso, reverta o complemento novamente ou desinstale o complemento e reinstale-o. unknown: a instância do gráfico de complemento não existe.
Reason	String	Causa da falha na instalação do complemento.
message	String	Detalhes do erro de instalação.
targetVersions	Array of strings	Versões para as quais a versão atual do complemento pode ser atualizada.
currentVersion	Versions object	Informações sobre a versão atual do complemento.
isRollbackable	Boolean	Se a versão do complemento pode ser revertida para a versão de origem.
previousVersion	String	A versão do complemento antes da atualização ou reversão

**Tabela 10** Versions
Parâmetro	Tipo	Descrição
version	String	Versão do complemento.
input	Object	Parâmetros de instalação do complemento.
stable	Boolean	Se a versão do complemento é uma versão estável.
translate	Object	Informações de tradução usadas pela GUI.
supportVersions	Array of SupportVersions objects	Versões de cluster que suportam o complemento.
creationTimestamp	String	Hora da criação.
updateTimestamp	String	Hora da atualização.

**Tabela 11** SupportVersions
Parâmetro	Tipo	Descrição
clusterType	String	Tipo de cluster que suporta o complemento.
clusterVersion	Array of strings	Versões de cluster que suportam o complemento. O valor é uma expressão regular.

Exemplo de solicitações

Atualize o complemento everest para a versão 2.1.30.

{
  "kind" : "Addon",
  "apiVersion" : "v3",
  "metadata" : {
    "annotations" : {
      "addon.upgrade/type" : "upgrade"
    }
  },
  "spec" : {
    "clusterID" : "*****",
    "version" : "2.1.30",
    "addonTemplateName" : "everest",
    "values" : {
      "basic" : {
        "bms_url" : "*****",
        "driver_init_image_version" : "2.1.30",
        "ecsEndpoint" : "*****",
        "everest_image_version" : "2.1.30",
        "evs_url" : "*****",
        "iam_url" : "*****",
        "ims_url" : "*****",
        "obs_url" : "*****",
        "platform" : "linux-amd64",
        "sfs30_url" : "*****",
        "sfs_turbo_url" : "*****",
        "sfs_url" : "*****",
        "supportHcs" : false,
        "swr_addr" : "*****",
        "swr_user" : "hwofficial",
        "rbac_enabled" : true,
        "cluster_version" : "v1.23"
      },
      "flavor" : {
        "description" : "High avaiable",
        "name" : "HA",
        "replicas" : 2,
        "resources" : [ {
          "limitsCpu" : "250m",
          "limitsMem" : "2000Mi",
          "name" : "everest-csi-controller",
          "requestsCpu" : "250m",
          "requestsMem" : "1500Mi"
        }, {
          "limitsCpu" : "500m",
          "limitsMem" : "300Mi",
          "name" : "everest-csi-driver",
          "requestsCpu" : "100m",
          "requestsMem" : "300Mi"
        } ],
        "category" : [ "CCE", "Turbo" ]
      },
      "custom" : {
        "cluster_id" : "*****",
        "csi_attacher_detach_worker_threads" : "60",
        "csi_attacher_worker_threads" : "60",
        "default_vpc_id" : "*****",
        "disable_auto_mount_secret" : false,
        "enable_node_attacher" : true,
        "flow_control" : { },
        "multiAZEnabled" : false,
        "over_subscription" : "80",
        "project_id" : "*****",
        "volume_attaching_flow_ctrl" : "0"
      }
    }
  }
}

Exemplo de respostas

Código de status: 200

{
  "kind" : "Addon",
  "apiVersion" : "v3",
  "metadata" : {
    "uid" : "******",
    "name" : "everest",
    "alias" : "everest",
    "creationTimestamp" : "2023-07-03T10:57:43Z",
    "updateTimestamp" : "2023-07-03T11:24:05Z"
  },
  "spec" : {
    "clusterID" : "******",
    "version" : "2.1.30",
    "addonTemplateName" : "everest",
    "addonTemplateType" : "helm",
    "addonTemplateLogo" : "******",
    "addonTemplateLabels" : [ "Storage" ],
    "description" : "",
    "values" : {
      "basic" : {
        "bms_url" : "******",
        "cluster_version" : "v1.23",
        "driver_init_image_version" : "2.1.30",
        "ecsEndpoint" : "******",
        "everest_image_version" : "2.1.30",
        "evs_url" : "******",
        "iam_url" : "******",
        "ims_url" : "******",
        "obs_url" : "******",
        "platform" : "linux-amd64",
        "rbac_enabled" : true,
        "sfs30_url" : "******",
        "sfs_turbo_url" : "******",
        "sfs_url" : "******",
        "supportHcs" : false,
        "swr_addr" : "******",
        "swr_user" : "hwofficial"
      },
      "custom" : {
        "cluster_id" : "******",
        "cluster_version" : "v1.23.8-r0",
        "csi_attacher_detach_worker_threads" : "60",
        "csi_attacher_worker_threads" : "60",
        "default_vpc_id" : "******",
        "disable_auto_mount_secret" : false,
        "enable_node_attacher" : false,
        "flow_control" : { },
        "multiAZEnabled" : false,
        "over_subscription" : "80",
        "project_id" : "******",
        "volume_attaching_flow_ctrl" : "0"
      },
      "flavor" : {
        "category" : [ "CCE", "Turbo" ],
        "description" : "Has only one instance",
        "name" : "Single",
        "replicas" : 1,
        "resources" : [ {
          "limitsCpu" : "250m",
          "limitsMem" : "600Mi",
          "name" : "everest-csi-controller",
          "requestsCpu" : "250m",
          "requestsMem" : "600Mi"
        }, {
          "limitsCpu" : "100m",
          "limitsMem" : "300Mi",
          "name" : "everest-csi-driver",
          "requestsCpu" : "100m",
          "requestsMem" : "300Mi"
        } ]
      },
      "systemAutoInject" : {
        "cluster" : {
          "clusterID" : "******",
          "clusterNetworkMode" : "vpc-router",
          "clusterVersion" : "v1.23.8-r0"
        },
        "user" : {
          "projectID" : "******"
        }
      }
    }
  },
  "status" : {
    "status" : "upgrading",
    "Reason" : "addon upgrading",
    "message" : "",
    "targetVersions" : null,
    "isRollbackable" : false,
    "currentVersion" : {
      "version" : "2.1.30",
      "input" : {
        "basic" : {
          "bms_url" : "******",
          "driver_init_image_version" : "2.1.30",
          "ecsEndpoint" : "******",
          "everest_image_version" : "2.1.30",
          "evs_url" : "******",
          "iam_url" : "******",
          "ims_url" : "******",
          "obs_url" : "******",
          "platform" : "******",
          "sfs30_url" : "******",
          "sfs_turbo_url" : "******",
          "sfs_url" : "******",
          "supportHcs" : false,
          "swr_addr" : "******",
          "swr_user" : "hwofficial"
        },
        "parameters" : {
          "common" : {
            "defaultVPCId" : 1234567
          },
          "custom" : {
            "cluster_id" : "",
            "csi_attacher_detach_worker_threads" : "60",
            "csi_attacher_worker_threads" : "60",
            "default_vpc_id" : "",
            "disable_auto_mount_secret" : false,
            "enable_node_attacher" : false,
            "flow_control" : { },
            "multiAZEnabled" : false,
            "over_subscription" : "80",
            "project_id" : "",
            "volume_attaching_flow_ctrl" : "0"
          },
          "flavor1" : {
            "description" : "High avaiable",
            "name" : "HA",
            "replicas" : 2,
            "resources" : [ {
              "limitsCpu" : "250m",
              "limitsMem" : "1500Mi",
              "name" : "everest-csi-controller",
              "requestsCpu" : "250m",
              "requestsMem" : "600Mi"
            }, {
              "limitsCpu" : "500m",
              "limitsMem" : "300Mi",
              "name" : "everest-csi-driver",
              "requestsCpu" : "100m",
              "requestsMem" : "300Mi"
            } ]
          },
          "flavor2" : {
            "description" : "Has only one instance",
            "name" : "Single",
            "replicas" : 1,
            "resources" : [ {
              "limitsCpu" : "250m",
              "limitsMem" : "600Mi",
              "name" : "everest-csi-controller",
              "requestsCpu" : "250m",
              "requestsMem" : "600Mi"
            }, {
              "limitsCpu" : "100m",
              "limitsMem" : "300Mi",
              "name" : "everest-csi-driver",
              "requestsCpu" : "100m",
              "requestsMem" : "300Mi"
            } ]
          },
          "flavor3" : {
            "description" : "custom resources",
            "name" : "custom-resources",
            "replicas" : 2,
            "resources" : [ {
              "limitsCpu" : "250m",
              "limitsMem" : "2000Mi",
              "name" : "everest-csi-controller",
              "requestsCpu" : "250m",
              "requestsMem" : "1500Mi"
            }, {
              "limitsCpu" : "500m",
              "limitsMem" : "300Mi",
              "name" : "everest-csi-driver",
              "requestsCpu" : "100m",
              "requestsMem" : "300Mi"
            } ]
          }
        }
      },
      "stable" : true,
      "translate" : {
        "en_US" : {
          "addon" : {
            "changeLog" : "",
            "description" : ""
          },
          "description" : {
            "Parameters.flavor1.description" : "Deploy the add-on with two instances, delivering high availability but requiring more compute resources.",
            "Parameters.flavor1.name" : "HA",
            "Parameters.flavor2.description" : "Deploy the add-on with one instance.",
            "Parameters.flavor2.name" : "Standalone",
            "Parameters.flavor3.name" : "Custom"
          }
        },
        "fr_FR" : {
          "addon" : {
            "changeLog" : "",
            "description" : ""
          },
          "description" : {
            "Parameters.flavor1.description" : "Déployez avec deux instances, haute disponibilité.",
            "Parameters.flavor1.name" : "HA",
            "Parameters.flavor2.description" : "Déployez avec une seule instance.",
            "Parameters.flavor2.name" : "Célibataire",
            "Parameters.flavor3.name" : "Douane"
          }
        },
        "zh_CN" : {
          "addon" : {
            "changeLog" : "",
            "description" : ""
          },
          "description" : {
            "Parameters.flavor1.description" : "Dual-instance deployment features high availability but requires more compute resources.",
            "Parameters.flavor1.name" : "High availability",
            "Parameters.flavor2.description" : "Single-instance deployment",
            "Parameters.flavor2.name" : "Single instance",
            "Parameters.flavor3.description" : "Custom resource specifications for deployment",
            "Parameters.flavor3.name" : "Custom"
          }
        }
      },
      "supportVersions" : null,
      "creationTimestamp" : "2023-05-12T16:10:05Z",
      "updateTimestamp" : "2023-05-12T16:10:05Z"
    }
  }
}