Container Service for Kubernetes:Java sdk call examples

Etapa 1: Revisar a documentação do openapi

Antes de chamar uma operação do openapi, leia Create an ACK managed cluster by calling an API operation para conhecer os parâmetros e as permissões necessárias para a operação. Para obter mais parâmetros, consulte API overview.

Etapa 2: crie um usuário do Resource Access Management (RAM) e conceder permissões

Chame esta operação usando uma conta Alibaba Cloud, um usuário RAM ou uma função RAM. Para obter informações sobre as diferenças entre essas identidades, consulte Identity.

1. Create a RAM user.

   1. Use sua conta Alibaba Cloud para fazer login no RAM console.

   2. No painel de navegação à esquerda, escolha Credential Management > User.

   3. Na página User, clique em Create User.

   4. Na página Create User, defina Logon Name e Display Name, e defina Access Method como Console Password Logon.

   5. clique em OK.

      Após a criação do usuário RAM, anote o nome de login e a senha. Ao chamar uma operação do openapi, use este usuário RAM para fazer login no Portal do Desenvolvedor do openapi da Alibaba Cloud.

2. Conceda a permissão AliyunCSFullAccess ao usuário RAM. Para obter instruções, consulte Manage RAM user permissions.

   AliyunCSFullAccess: Concede permissões para gerencie o Container Service for Kubernetes. AliyunCSReadOnlyAccess: Concede acesso somente leitura ao Container Service for Kubernetes. Se você precisar, crie uma política personalizada, consulte RAM authorization.

3. acesse a página de detalhes do usuário RAM. Na aba Authentication, clique em Create AccessKey. Para obter instruções, consulte Create an AccessKey.

Etapa 3: Chamar uma operação do openapi

Este exemplo usa um usuário RAM para chamar CreateCluster e crie um cluster gerenciado Pro do ACK. O exemplo utiliza o sdk para Java. Os sdks para outras linguagens de programação funcionam de maneira semelhante. Para obter mais informações, consulte Container Service for Kubernetes (ACK) SDK. Você também pode escolher outros métodos de chamada com base nos requisitos do seu negócio. Para mais detalhes, consulte Calling methods.

configure variáveis de ambiente

Antes de chamar a operação, configure environment variables para obter as credenciais de acesso.

baixe o código de exemplo do sdk

1. acesse CreateCluster.

2. Na seção Parameters no lado esquerdo, especifique os parâmetros necessários e, em seguida, clique em Initiate Call.

   • name—Valor de exemplo: test

   • region_id—Valor de exemplo: cn-beijing

   • cluster_type—Valor de exemplo: ManagedKubernetes

   • cluster_spec—Valor de exemplo: ack.pro.small

   • kubernetes_version—Valor de exemplo: 1.30.1-aliyun.1

   • vpcid—Valor de exemplo: vpc-2zedl8cyb7tnkaux1****

   • container_cidr—Valor de exemplo: 10.0.0.0/8

   • service_cidr—Valor de exemplo: 172.21.0.0/20

   • vswitch_ids—Valor de exemplo: vsw-2ze7hfp0ah8rk1nz9****

3. Na aba sdk Sample no lado direito, selecione sdk V2.0 e uma linguagem de sdk e, em seguida, clique em Download Project. Após a conclusão do download, descompacte o pacote localmente.

   (Recomendado) Use o sdk V2.0. Para mais detalhes, consulte Differences between sdk V1.0 and sdk V2.0.

   Parâmetros de solicitação como name, region_id, cluster_type, cluster_spec e kubernetes_version são especificados na aba Parameters à esquerda. O painel de código à direita gera então o código de exemplo do sdk na linguagem correspondente em tempo real.

execute o código de exemplo do sdk

1. Abra o IntelliJ IDEA, clique em File->Open, selecione a pasta do projeto descompactada e aguarde o Maven instale as dependências automaticamente.

2. execute o código de exemplo.

   clique em duas vezes em Sample para abri-lo. Após confirme que nenhum erro foi relatado, execute o código.

3. Visualize o resultado.

   No console na parte inferior da página, pesquise por statusCode. Se "statusCode":202 for retornado, a chamada foi bem-sucedida e a criação do cluster será iniciada. No ACK console, visualize o novo cluster na página Clusters.

   {
     "headers": {
       "content-type": "application/json;charset=utf-8",
       "access-control-expose-headers": "*",
       "x-acs-trace-id": "30c74bc83a7fae0a081e5f5846be703e"
     },
     "statusCode": 202,
     "body": {
       "clusterId": "c6104ee21d6304ef8..."
     }
   }