REST Resource: projects.locations.awsClusters

{
  "name": string,
  "description": string,
  "networking": {
    object (AwsClusterNetworking)
  },
  "awsRegion": string,
  "controlPlane": {
    object (AwsControlPlane)
  },
  "authorization": {
    object (AwsAuthorization)
  },
  "state": enum (State),
  "endpoint": string,
  "uid": string,
  "reconciling": boolean,
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "annotations": {
    string: string,
    ...
  },
  "workloadIdentityConfig": {
    object (WorkloadIdentityConfig)
  },
  "clusterCaCertificate": string,
  "fleet": {
    object (Fleet)
  },
  "loggingConfig": {
    object (LoggingConfig)
  },
  "errors": [
    {
      object (AwsClusterError)
    }
  ],
  "monitoringConfig": {
    object (MonitoringConfig)
  },
  "binaryAuthorization": {
    object (BinaryAuthorization)
  }
}

string

O nome desse recurso.

Os nomes de clusters são formatados como projects/<project-number>/locations/<region>/awsClusters/<cluster-id>.

Consulte Nomes de recursos para mais detalhes sobre os nomes de recursos do Google Cloud Platform.

string

Opcional. Uma descrição legível deste cluster. Não pode ter mais de 255 bytes codificados em UTF-8.

object (AwsClusterNetworking)

Obrigatório. Configuração de rede em todo o cluster.

string

Obrigatório. A região da AWS em que o cluster é executado.

Cada região do Google Cloud é compatível com um subconjunto de regiões próximas da AWS. É possível chamar locations.getAwsServerConfig para listar todas as regiões compatíveis da AWS em uma determinada região do Google Cloud.

object (AwsControlPlane)

Obrigatório. Configuração relacionada ao plano de controle do cluster.

object (AwsAuthorization)

Obrigatório. Configuração relacionada às configurações de RBAC do cluster.

enum (State)

Apenas saída. O estado atual do cluster.

string

Apenas saída. O endpoint do servidor da API do cluster.

string

Apenas saída. Um identificador globalmente exclusivo para o cluster.

boolean

Apenas saída. Se definido, há alterações em andamento no cluster.

string (Timestamp format)

Apenas saída. O horário de criação do cluster.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Apenas saída. A hora em que o cluster foi atualizado pela última vez.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

string

Permite que os clientes realizem leituras e modificações da gravação consistentes por meio do controle otimista de simultaneidade.

Pode ser enviado em solicitações de atualização e exclusão para garantir que o cliente tenha um valor atualizado antes de prosseguir.

map (key: string, value: string)

Opcional. Anotações no cluster

Este campo tem as mesmas restrições que as anotações do Kubernetes. O tamanho total de todas as chaves e valores combinados é limitado a 256 mil. A chave pode ter dois segmentos: prefixo (opcional) e nome (exigido), separados por uma barra (/). O prefixo precisa ser um subdomínio DNS. O nome deve ter 63 caracteres ou menos, começar e terminar com caracteres alfanuméricos, com traços (-), sublinhados (_), pontos (.) e caracteres alfanuméricos entre eles.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

object (WorkloadIdentityConfig)

Apenas saída. Configurações de Identidade da carga de trabalho.

string

Apenas saída. Certificado x509 codificado em PEM da raiz de confiança do cluster.

object (Fleet)

Obrigatório. Configuração da frota.

object (LoggingConfig)

Opcional. Configuração do Logging para este cluster.

object (AwsClusterError)

Apenas saída. Um conjunto de erros encontrado no cluster.

object (MonitoringConfig)

Opcional. Configuração de monitoramento para este cluster.

object (BinaryAuthorization)

Opcional. Configuração da autorização binária para este cluster.

{
  "vpcId": string,
  "podAddressCidrBlocks": [
    string
  ],
  "serviceAddressCidrBlocks": [
    string
  ],
  "perNodePoolSgRulesDisabled": boolean
}

string

Obrigatório. A VPC associada ao cluster. Todos os clusters de componentes (ou seja, plano de controle e pools de nós) são executados em uma única VPC.

Este campo não pode ser alterado após a criação.

string

Obrigatório. Todos os pods no cluster recebem um endereço IPv4 desses intervalos. Só é possível usar um intervalo. Este campo não pode ser alterado após a criação.

string

Obrigatório. Todos os serviços do cluster recebem um endereço IPv4 desses intervalos. Só é possível usar um intervalo. Este campo não pode ser alterado após a criação.

boolean

Opcional. Desative as regras do grupo de segurança de sub-rede por pool de nós no grupo de segurança do plano de controle. Quando definido como verdadeiro, é preciso fornecer também um ou mais grupos de segurança que garantam que os pools de nós sejam capazes de enviar solicitações para o plano de controle em TCP/443 e TCP/8132. Se isso não for feito, os pools de nós poderão ficar indisponíveis.

{
  "version": string,
  "instanceType": string,
  "sshConfig": {
    object (AwsSshConfig)
  },
  "subnetIds": [
    string
  ],
  "securityGroupIds": [
    string
  ],
  "iamInstanceProfile": string,
  "rootVolume": {
    object (AwsVolumeTemplate)
  },
  "mainVolume": {
    object (AwsVolumeTemplate)
  },
  "databaseEncryption": {
    object (AwsDatabaseEncryption)
  },
  "tags": {
    string: string,
    ...
  },
  "awsServicesAuthentication": {
    object (AwsServicesAuthentication)
  },
  "proxyConfig": {
    object (AwsProxyConfig)
  },
  "configEncryption": {
    object (AwsConfigEncryption)
  },
  "instancePlacement": {
    object (AwsInstancePlacement)
  }
}

string

Obrigatório. A versão do Kubernetes a ser executada em réplicas do plano de controle (por exemplo, 1.19.10-gke.1000).

É possível listar todas as versões compatíveis em uma determinada região do Google Cloud chamando locations.getAwsServerConfig.

string

Opcional. O tipo de instância da AWS.

Quando não for especificado, ele usará um padrão com base na versão do cluster.

object (AwsSshConfig)

Opcional. Configuração do SSH para acessar as máquinas do plano de controle.

string

Obrigatório. A lista de sub-redes em que as réplicas do plano de controle serão executadas. Uma réplica será provisionada em cada sub-rede, e até três valores poderão ser fornecidos. Cada sub-rede precisa estar em uma zona de disponibilidade diferente da AWS (AZ).

string

Opcional. Os códigos dos grupos de segurança extras a serem adicionados às réplicas do plano de controle. A API Anthos Multi-Cloud cria e gerencia automaticamente grupos de segurança com as regras mínimas necessárias para um cluster funcional.

string

Obrigatório. O nome ou ARN do perfil da instância do IAM da AWS a ser atribuído a cada réplica do plano de controle.

object (AwsVolumeTemplate)

Opcional. Configuração relacionada ao volume raiz provisionado para cada réplica do plano de controle.

Os volumes serão provisionados na zona de disponibilidade associada à sub-rede correspondente.

Quando não especificado, o padrão é 32 GiB com o tipo de volume GP2.

object (AwsVolumeTemplate)

Opcional. Configuração relacionada ao volume principal provisionado para cada réplica do plano de controle. O volume principal é responsável por armazenar todo o estado do etcd do cluster.

Os volumes serão provisionados na zona de disponibilidade associada à sub-rede correspondente.

Quando não especificado, o padrão é 8 GiB com o tipo de volume GP2.

object (AwsDatabaseEncryption)

Obrigatório. O ARN da chave KMS da AWS usada para criptografar secrets do cluster.

map (key: string, value: string)

Opcional. Um conjunto de tags de recursos da AWS para propagar a todos os recursos subjacentes gerenciados pela AWS.

Especifique no máximo 50 pares contendo caracteres alfanuméricos, espaços e símbolos (.+-=_:@/). As chaves podem ter até 127 caracteres Unicode. Os valores podem ter até 255 caracteres Unicode.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

object (AwsServicesAuthentication)

Obrigatório. Configuração de autenticação para gerenciamento de recursos da AWS.

object (AwsProxyConfig)

Opcional. Configuração de proxy para o tráfego de saída HTTP(S).

object (AwsConfigEncryption)

Obrigatório. Criptografia de configuração para dados do usuário.

object (AwsInstancePlacement)

Opcional. A posição a ser usada nas instâncias do plano de controle. Quando não especificado, o locatário padrão da VPC será usado.

{
  "kmsKeyArn": string
}

string

Obrigatório. O ARN da chave KMS da AWS usada para criptografar secrets do cluster.

{
  "roleArn": string,
  "roleSessionName": string
}

string

Obrigatório. O nome do recurso da Amazon (ARN) do papel que a API Anthos Multi-Cloud assumirá ao gerenciar os recursos da AWS na sua conta.

string

Opcional. Identificador da sessão de papel presumido.

Quando não especificado, o padrão é multicloud-service-agent.

{
  "adminUsers": [
    {
      object (AwsClusterUser)
    }
  ],
  "adminGroups": [
    {
      object (AwsClusterGroup)
    }
  ]
}

object (AwsClusterUser)

Opcional. Usuários que podem executar operações como administrador de cluster. Um ClusterRoleBinding gerenciado será criado para conceder o ClusterRole cluster-admin aos usuários. É possível fornecer até 10 usuários administradores.

Para mais informações sobre o RBAC, consulte https://kubernetes.io/docs/reference/access-authn-authz/rbac/#user-facing-roles

object (AwsClusterGroup)

Opcional. Grupos de usuários que podem executar operações como administrador de cluster. Um ClusterRoleBinding gerenciado será criado para conceder o ClusterRole cluster-admin aos grupos. É possível fornecer até 10 grupos administradores.

Para mais informações sobre o RBAC, consulte https://kubernetes.io/docs/reference/access-authn-authz/rbac/#user-facing-roles

{
  "username": string
}

string

Obrigatório. O nome do usuário, por exemplo, my-gcp-id@gmail.com.

{
  "group": string
}

string

Obrigatório. O nome do grupo, por exemplo, my-group@domain.com.

{
  "message": string
}

string

Descrição do erro legível por humanos.