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 cluster/ Vinculação/desvinculação endereço do servidor da API público

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

Ver PDF

Vinculação/desvinculação endereço do servidor da API público

Função

Essa API é usada para vincular ou desvincular o endereço público do servidor da API do cluster por ID do cluster.

O URL para gerenciamento de cluster está no formato https://Endpoint/uri. No URL, uri indica o caminho do recurso, ou seja, o caminho para o acesso à API.

URI

PUT /api/v3/projects/{project_id}/clusters/{cluster_id}/mastereip

**Tabela 1** Parâmetros de caminho
Parâmetro	Obrigatório	Tipo	Descrição
project_id	Sim	String	ID do projeto. Para obter detalhes sobre como obter o valor, consulte Como obter parâmetros no URI da API.
cluster_id	Sim	String	ID do cluster. Para obter detalhes sobre como obter o valor, consulte Como obter parâmetros no URI da API.

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
spec	Sim	MasterEIPRequestSpec object	Parâmetros na solicitação de vinculação ou desvinculação do endereço APIServer público de um cluster

**Tabela 4** MasterEIPRequestSpec
Parâmetro	Obrigatório	Tipo	Descrição
action	Não	String	Vinculação ou desvinculação. Obrigatório. Vinculação: o valor é fixado em {"action":"bind"}. Desvinculação: o valor é fixado em {"action":"unbind"}.
spec	Não	spec object	Atributos de configuração do endereço IP elástico a ser vinculado
bandwidth	Não	String	Largura de banda (Este campo expirou e não é recomendado.)
elasticIp	Não	String	IP da ENI (Este campo expirou e não é recomendado.)

**Tabela 5** spec
Parâmetro	Obrigatório	Tipo	Descrição
id	Não	String	Especifica o ID de ENI. Este parâmetro é obrigatório para vincular uma ENI e é inválido para desvincular uma ENI.

Parâmetros de resposta

Código de status: 200

**Tabela 6** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
metadata	Metadata object	Informações básicas sobre o objeto. Metadados são uma coleção de atributos.
spec	MasterEIPResponseSpec object	Configuração do endereço APIServer público vinculado de um cluster
status	status object	Informações de status

**Tabela 7** Metadata
Parâmetro	Tipo	Descrição
uid	String	ID único.
name	String	Nome do recurso
labels	Map<String,String>	Rótulos de recursos em pares chave-valor. Este é um campo reservado e não tem efeito.
annotations	Map<String,String>	Anotações de resource no formato de pares chave-valor.
updateTimestamp	String	Hora da atualização.
creationTimestamp	String	Hora de criação.

**Tabela 8** MasterEIPResponseSpec
Parâmetro	Tipo	Descrição
action	String	Uma operação de vinculação
spec	spec object	Atributos de configuração do endereço IP elástico a ser vinculado
elasticIp	String	EIP

**Tabela 9** spec
Parâmetro	Tipo	Descrição
id	String	ID da ENI
eip	EipSpec object	Detalhes do EIP
IsDynamic	Boolean	Provisionamento dinâmico ou não

**Tabela 10** EipSpec
Parâmetro	Tipo	Descrição
bandwidth	bandwidth object	Informações de largura de banda

**Tabela 11** bandwidth
Parâmetro	Tipo	Descrição
size	Integer	Tamanho da largura de banda
sharetype	String	Tipo da largura de banda

**Tabela 12** status
Parâmetro	Tipo	Descrição
privateEndpoint	String	IP privado para acessar o cluster (VIP no caso de um cluster de HA)
publicEndpoint	String	IP público para acessar o cluster

Exemplo de solicitações

Vincule o endereço público do servidor da API a um cluster.

{
  "spec" : {
    "action" : "bind",
    "spec" : {
      "id" : "a757a69e-f920-455a-b1ba-d7a22db0fd50"
    }
  }
}

Exemplo de respostas

Código de status: 200

Isso indica que o endereço público do servidor da API do cluster foi vinculado com êxito. Nenhum corpo de resposta é retornado se a desvinculação for bem-sucedida.

{
  "metadata" : { },
  "spec" : {
    "action" : "bind",
    "spec" : {
      "id" : "a757a69e-f920-455a-b1ba-d7a22db0fd50",
      "eip" : {
        "bandwidth" : {
          "size" : 5,
          "sharetype" : "PER"
        }
      },
      "IsDynamic" : false
    },
    "elasticIp" : "8.8.8.8"
  },
  "status" : {
    "privateEndpoint" : "https://192.168.3.238:5443",
    "publicEndpoint" : "https://8.8.8.8:5443"
  }
}

Códigos de status

Código de status	Descrição
200	Isso indica que o endereço público do servidor da API do cluster foi vinculado com êxito. Nenhum corpo de resposta é retornado se a desvinculação for bem-sucedida.