Recurso da REST: projects.locations.instances

Recurso: instância

Representação JSON 

{
  "name": string,
  "displayName": string,
  "labels": {
    string: string,
    ...
  },
  "authorizedNetwork": string,
  "zones": [
    string
  ],
  "nodeCount": integer,
  "nodeConfig": {
    object (NodeConfig)
  },
  "memcacheVersion": enum (MemcacheVersion),
  "parameters": {
    object (MemcacheParameters)
  },
  "memcacheNodes": [
    {
      object (Node)
    }
  ],
  "createTime": string,
  "updateTime": string,
  "state": enum (State),
  "memcacheFullVersion": string,
  "instanceMessages": [
    {
      object (InstanceMessage)
    }
  ],
  "discoveryEndpoint": string
}
Campos
name

string

Obrigatório. Nome exclusivo do recurso neste escopo, incluindo projeto e local usando o formulário: projects/{project_id}/locations/{locationId}/instances/{instanceId}

Observação: as instâncias do Memcached são gerenciadas e endereçadas no nível regional. Portanto, locationId se refere a uma região do GCP. No entanto, os usuários podem escolher em quais zonas do Memcached as instâncias serão provisionadas. Consulte o campo [zones] para mais detalhes.
displayName

string

Opcional. Nome fornecido pelo usuário para a instância usada apenas para fins de exibição. Não pode ter mais de 80 caracteres.
labels

map (key: string, value: string)

Opcional. Rótulos de recursos para representar metadados fornecidos por usuários Consulte a documentação da nuvem sobre rótulos para mais detalhes. https://cloud.google.com/compute/docs/labeling-resources

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

string

Opcional. O nome completo da rede do Google Compute Engine à qual a instância está conectada. Se não for especificada, a rede default será usada.
zones[]

string

Opcional. Zonas em que os nós do Memcached precisam ser provisionados. Os nós do Memcached serão distribuídos igualmente entre essas zonas. Se não for fornecido, o serviço criará nós em todas as zonas da região para a instância.
nodeCount

integer

Obrigatório. Número de nós na instância do Memcached.
nodeConfig

object (NodeConfig)

Obrigatório. Configuração para nós do Memcached.
memcacheVersion

enum (MemcacheVersion)

Opcional. A versão principal do software Memcached. Se não for fornecido, a versão mais recente compatível será usada. No momento, a versão principal compatível mais recente é o MEMCACHE_1_5. A versão secundária será determinada automaticamente pelo nosso sistema com base na versão secundária compatível mais recente.
parameters

object (MemcacheParameters)

Opcional: parâmetros definidos pelo usuário para aplicar ao processo do memcached em cada nó.
memcacheNodes[]

object (Node)

Apenas saída. Lista de nós do Memcached. Consulte a mensagem [Node] para mais detalhes.
createTime

string (Timestamp format)

Apenas saída. Hora em que a instância foi criada.

Um carimbo de data/hora no formato UTC “Zulu” RFC3339, medido com precisão de nanossegundos. Exemplo: "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Apenas saída. A hora em que a instância foi atualizada.

Um carimbo de data/hora no formato UTC “Zulu” RFC3339, medido com precisão de nanossegundos. Exemplo: "2014-10-02T15:01:23.045123456Z".
state

enum (State)

Apenas saída. O estado dessa instância do Memcached.
memcacheFullVersion

string

Apenas saída. A versão completa do servidor memcached em execução nesta instância. O sistema determina automaticamente a versão completa do memcached para uma instância com base na MemcacheVersion de entrada. O formato completo da versão será "memcached-1.5.16".
instanceMessages[]

object (InstanceMessage)

Lista de mensagens que descrevem os status atuais da instância do memcached.
discoveryEndpoint

string

Apenas saída. Endpoint para API Discovery

NodeConfig

Configuração para um nó do Memcached.

Representação JSON 

{
  "cpuCount": integer,
  "memorySizeMb": integer
}
Campos
cpuCount

integer

Obrigatório. Número de cpus por nó do Memcached.
memorySizeMb

integer

Obrigatório. Tamanho da memória em MiB para cada nó do Memcached.

MemcacheVersion

Versões do Memcached compatíveis com nosso serviço.

Enums
MEMCACHE_VERSION_UNSPECIFIED
MEMCACHE_1_5 Memcached versão 1.5.

MemcacheParameters

Representação JSON 

{
  "id": string,
  "params": {
    string: string,
    ...
  }
}
Campos
id

string

Apenas saída. O código exclusivo associado a esse conjunto de parâmetros. Os usuários podem usar esse código para determinar se os parâmetros associados à instância são diferentes dos parâmetros associados aos nós, e qualquer ação precisa ser realizada para aplicar parâmetros nos nós.
params

map (key: string, value: string)

Conjunto de parâmetros definido pelo usuário para uso no processo do memcached.

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

Nó

Representação JSON 

{
  "nodeId": string,
  "zone": string,
  "state": enum (State),
  "host": string,
  "port": integer,
  "parameters": {
    object (MemcacheParameters)
  }
}
Campos
nodeId

string

Apenas saída. Identificador do nó do Memcached. O código do nó não inclui projeto ou local, como o nome da instância do Memcached.
zone

string

Apenas saída. Local (zona do GCP) para o nó do Memcached.
state

enum (State)

Apenas saída. Estado atual do nó do Memcached.
host

string

Apenas saída. Nome do host ou endereço IP do nó do Memcached usado pelos clientes para se conectar ao servidor do Memcached neste nó.
port

integer

Apenas saída. O número da porta do servidor Memcached neste nó.
parameters

object (MemcacheParameters)

Parâmetros definidos pelo usuário atualmente aplicados ao nó.

State

Estados diferentes de um nó do Memcached.

Enums
STATE_UNSPECIFIED O estado do nó não está definido.
CREATING O nó está sendo criado.
READY O nó foi criado e está pronto para ser usado.
DELETING O nó está sendo excluído.
UPDATING O nó está sendo atualizado.

State

Estados diferentes de uma instância do Memcached.

Enums
STATE_UNSPECIFIED Estado não definido.
CREATING A instância do Memcached está sendo criada.
READY A instância do Memcached foi criada e está pronta para ser usada.
DELETING A instância do Memcached está sendo excluída.
PERFORMING_MAINTENANCE A instância do Memcached está passando pela manutenção, por exemplo, o lançamento do plano de dados.

InstanceMessage

Representação JSON 

{
  "code": enum (Code),
  "message": string
}
Campos
code

enum (Code)

Um código que corresponde a um tipo de mensagem voltada para o usuário.
message

string

Mensagem na instância do memcached que será exposta aos usuários.

País

Enums
CODE_UNSPECIFIED Código da mensagem não definido.
ZONE_DISTRIBUTION_UNBALANCED Os nós do Memcached são distribuídos de maneira uniforme.

Métodos

applyParameters

 ApplyParameters atualizará o conjunto atual de parâmetros para o conjunto de nós especificados da instância do Memcached.

create

 Cria uma nova instância em um determinado projeto e local.

delete

 Exclui uma única instância.

get

 Recebe detalhes de uma única instância.

getIamPolicy

 Busca a política de controle de acesso de um recurso.

list

 Lista instâncias em um determinado projeto e local.

patch

 Atualiza uma instância atual em um determinado projeto e local.

setIamPolicy

 Define a política de controle de acesso no recurso especificado.

testIamPermissions

 Retorna permissões do autor da chamada no recurso especificado.

updateParameters

 Atualiza os parâmetros do Memcached definidos para uma instância atual.