REST Resource: projects.locations.httpRoutes

Recurso: HttpRoute

HttpRoute é o recurso que define como o tráfego HTTP precisa ser roteado por um recurso de malha ou gateway.

Representação JSON
{
  "name": string,
  "selfLink": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "hostnames": [
    string
  ],
  "meshes": [
    string
  ],
  "gateways": [
    string
  ],
  "labels": {
    string: string,
    ...
  },
  "rules": [
    {
      object (RouteRule)
    }
  ]
}
Campos
name

string

Identificador. Nome do recurso HttpRoute. Ele corresponde ao padrão projects/*/locations/*/httpRoutes/http_route_name>.

description

string

Opcional. Uma descrição de texto livre do recurso. O tamanho máximo é de 1.024 caracteres.

createTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que o recurso foi criado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que o recurso foi atualizado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

hostnames[]

string

Obrigatório. Os nomes de host definem um conjunto de hosts que precisam corresponder ao cabeçalho do host HTTP para selecionar uma HttpRoute para processar a solicitação. O nome do host é o nome de domínio totalmente qualificado de um host de rede, conforme definido pela RFC 1123, com a exceção de que: - IPs não são permitidos. - Um nome de host pode ser prefixado com um rótulo curinga (*.). O rótulo curinga precisa aparecer sozinho como o primeiro rótulo.

O nome do host pode ser "preciso", que é um nome de domínio sem o ponto final de um host de rede (por exemplo, foo.example.com), ou "curinga", que é um nome de domínio prefixado com um único rótulo curinga (por exemplo, *.example.com).

De acordo com as RFC1035 e RFC1123, um rótulo precisa conter caracteres alfanuméricos em letras minúsculas ou "-", além de começar e terminar com caracteres alfanuméricos. Nenhuma outra pontuação é permitida.

As rotas associadas a uma malha ou gateways precisam ter nomes de host exclusivos. Se você tentar anexar várias rotas com nomes de host conflitantes, a configuração será rejeitada.

Por exemplo, embora seja aceitável que as rotas para os nomes de host *.foo.bar.com e *.bar.com sejam associadas à mesma malha (ou gateways no mesmo escopo), não é possível associar duas rotas com *.bar.com ou com bar.com.

meshes[]

string

Opcional. Meshes define uma lista de malhas a que este HttpRoute está anexado, como uma das regras de rota para rotear as solicitações atendidas pela malha.

Cada referência de malha precisa corresponder ao padrão: projects/*/locations/*/meshes/<mesh_name>

A malha anexada precisa ser do tipo SIDECAR

gateways[]

string

Opcional. Gateways define uma lista de gateways a que este HttpRoute está anexado, como uma das regras de rota para rotear as solicitações atendidas pelo gateway.

Cada referência de gateway precisa corresponder ao padrão: projects/*/locations/*/gateways/<gateway_name>

labels

map (key: string, value: string)

Opcional. Conjunto de tags de rótulo associadas ao recurso HttpRoute.

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

rules[]

object (RouteRule)

Obrigatório. Regras que definem como o tráfego é roteado e processado. As regras serão correspondidas sequencialmente com base no RouteMatch especificado para a regra.

RouteRule

Especifica como corresponder o tráfego e como roteá-lo quando houver correspondência.

Representação JSON
{
  "matches": [
    {
      object (RouteMatch)
    }
  ],
  "action": {
    object (RouteAction)
  }
}
Campos
matches[]

object (RouteMatch)

Uma lista de correspondências define as condições usadas para comparar a regra com as solicitações HTTP recebidas. Cada correspondência é independente, ou seja, essa regra será correspondida se QUALQUER uma das correspondências for atendida.

Se nenhum campo de correspondência for especificado, essa regra vai corresponder ao tráfego de forma incondicional.

Se você quiser configurar uma regra padrão, adicione uma regra sem correspondências especificadas ao final da lista de regras.

action

object (RouteAction)

A regra detalhada que define como rotear o tráfego correspondente.

RouteMatch

RouteMatch define as especificações usadas para corresponder solicitações. Se vários tipos de correspondência forem definidos, esse RouteMatch será correspondente se TODOS os tipos de correspondência forem correspondentes.

Representação JSON
{
  "ignoreCase": boolean,
  "headers": [
    {
      object (HeaderMatch)
    }
  ],
  "queryParameters": [
    {
      object (QueryParameterMatch)
    }
  ],

  // Union field PathMatch can be only one of the following:
  "fullPathMatch": string,
  "prefixMatch": string,
  "regexMatch": string
  // End of list of possible types for union field PathMatch.
}
Campos
ignoreCase

boolean

Especifica se as correspondências de prefixMatch e fullPathMatch diferenciam maiúsculas de minúsculas. O valor padrão é falso.

headers[]

object (HeaderMatch)

Especifica uma lista de cabeçalhos da solicitação HTTP para correspondência. TODOS os cabeçalhos fornecidos precisam ser correspondentes.

queryParameters[]

object (QueryParameterMatch)

Especifica uma lista de parâmetros de consulta para correspondência. TODOS os parâmetros de consulta precisam ser correspondentes.

Campo de união PathMatch.

PathMatch pode ser apenas de um dos tipos a seguir:

fullPathMatch

string

O valor do caminho da solicitação HTTP precisa corresponder exatamente a esse valor.

Apenas um dos seguintes deve ser usado: fullPathMatch, prefixMatch ou regexMatch.

prefixMatch

string

O valor do caminho da solicitação HTTP precisa começar com o prefixMatch especificado, que precisa começar com uma barra (/).

Apenas um dos seguintes deve ser usado: fullPathMatch, prefixMatch ou regexMatch.

regexMatch

string

O valor do caminho da solicitação HTTP precisa satisfazer a expressão regular especificada por regexMatch depois de remover todos os parâmetros de consulta e âncoras fornecidos com o URL de origem. Para gramática de expressão regular, consulte https://github.com/google/re2/wiki/Syntax

Apenas um dos seguintes deve ser usado: fullPathMatch, prefixMatch ou regexMatch.

HeaderMatch

Especifica como selecionar uma regra de rota com base nos cabeçalhos da solicitação HTTP.

Representação JSON
{
  "header": string,
  "invertMatch": boolean,

  // Union field MatchType can be only one of the following:
  "exactMatch": string,
  "regexMatch": string,
  "prefixMatch": string,
  "presentMatch": boolean,
  "suffixMatch": string,
  "rangeMatch": {
    object (IntegerRange)
  }
  // End of list of possible types for union field MatchType.
}
Campos
header

string

O nome do cabeçalho HTTP a ser correspondido.

invertMatch

boolean

Se especificado, o resultado da correspondência será invertido antes da verificação. O valor padrão é definido como falso.

Campo de união MatchType.

MatchType pode ser apenas de um dos tipos a seguir:

exactMatch

string

O valor do cabeçalho precisa corresponder exatamente ao conteúdo de exactMatch.

regexMatch

string

O valor do cabeçalho precisa corresponder à expressão regular especificada em regexMatch. Para gramática de expressão regular, consulte: https://github.com/google/re2/wiki/Syntax

prefixMatch

string

O valor do cabeçalho precisa começar com o conteúdo de prefixMatch.

presentMatch

boolean

É preciso que exista um cabeçalho com headerName. A correspondência ocorre independentemente de o cabeçalho ter um valor ou não.

suffixMatch

string

O valor do cabeçalho precisa terminar com o conteúdo de suffixMatch.

rangeMatch

object (IntegerRange)

Se especificado, a regra será correspondente se o valor do cabeçalho da solicitação estiver dentro do intervalo.

IntegerRange

Representa um intervalo de valores inteiros.

Representação JSON
{
  "start": integer,
  "end": integer
}
Campos
start

integer

Início do intervalo (inclusive)

end

integer

Fim do intervalo (exclusivo)

QueryParameterMatch

Especificações para corresponder a um parâmetro de consulta na solicitação.

Representação JSON
{
  "queryParameter": string,

  // Union field MatchType can be only one of the following:
  "exactMatch": string,
  "regexMatch": string,
  "presentMatch": boolean
  // End of list of possible types for union field MatchType.
}
Campos
queryParameter

string

O nome do parâmetro de consulta a ser correspondido.

Campo de união MatchType.

MatchType pode ser apenas de um dos tipos a seguir:

exactMatch

string

O valor do parâmetro de consulta precisa corresponder exatamente ao conteúdo de exactMatch.

Apenas um de exactMatch, regexMatch ou presentMatch precisa ser definido.

regexMatch

string

O valor do parâmetro de consulta precisa corresponder à expressão regular especificada por regexMatch. Para gramática de expressão regular, consulte https://github.com/google/re2/wiki/Syntax

Apenas um de exactMatch, regexMatch ou presentMatch precisa ser definido.

presentMatch

boolean

Especifica que o QueryParameterMatcher vai corresponder se a solicitação tiver um parâmetro de consulta, independentemente de o parâmetro ter um valor ou não.

Apenas um de exactMatch, regexMatch ou presentMatch precisa ser definido.

RouteAction

As especificações para rotear o tráfego e aplicar as políticas associadas.

Representação JSON
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "redirect": {
    object (Redirect)
  },
  "faultInjectionPolicy": {
    object (FaultInjectionPolicy)
  },
  "requestHeaderModifier": {
    object (HeaderModifier)
  },
  "responseHeaderModifier": {
    object (HeaderModifier)
  },
  "urlRewrite": {
    object (URLRewrite)
  },
  "timeout": string,
  "retryPolicy": {
    object (RetryPolicy)
  },
  "requestMirrorPolicy": {
    object (RequestMirrorPolicy)
  },
  "corsPolicy": {
    object (CorsPolicy)
  },
  "statefulSessionAffinity": {
    object (StatefulSessionAffinityPolicy)
  },
  "directResponse": {
    object (HttpDirectResponse)
  },
  "idleTimeout": string
}
Campos
destinations[]

object (Destination)

O destino para onde o tráfego deve ser encaminhado.

redirect

object (Redirect)

Se definido, a solicitação será direcionada conforme configurado por esse campo.

faultInjectionPolicy

object (FaultInjectionPolicy)

A especificação para injeção de falhas introduzida no tráfego para testar a resiliência dos clientes em relação à falha do serviço de back-end. Como parte da injeção de falhas, quando os clientes enviam solicitações para um serviço de back-end, é possível introduzir atrasos em uma porcentagem das solicitações antes de enviá-las ao serviço de back-end. Da mesma forma, as solicitações de clientes podem ser canceladas para uma porcentagem de solicitações.

timeout e retryPolicy serão ignorados por clientes configurados com uma faultInjectionPolicy

requestHeaderModifier

object (HeaderModifier)

A especificação para modificar os cabeçalhos de uma solicitação atendida antes de enviá-la ao destino. Se HeaderModifiers forem definidos no destino e na RouteAction, eles serão mesclados. Os conflitos entre os dois não serão resolvidos na configuração.

responseHeaderModifier

object (HeaderModifier)

A especificação para modificar os cabeçalhos de uma resposta antes de enviá-la de volta ao cliente. Se HeaderModifiers forem definidos no destino e na RouteAction, eles serão mesclados. Os conflitos entre os dois não serão resolvidos na configuração.

urlRewrite

object (URLRewrite)

A especificação para reescrever o URL antes de encaminhar solicitações ao destino.

timeout

string (Duration format)

Especifica o tempo limite da rota selecionada. O tempo limite é calculado a partir do momento em que a solicitação é totalmente processada (ou seja, fim do stream) até que a resposta seja totalmente processada. O tempo limite inclui todas as novas tentativas.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

retryPolicy

object (RetryPolicy)

Especifica a política de repetição associada a essa rota.

requestMirrorPolicy

object (RequestMirrorPolicy)

Especifica a política sobre como as solicitações destinadas ao destino das rotas são espelhadas para um destino separado. O proxy não vai esperar o destino de sombra responder antes de retornar a resposta. Antes de enviar tráfego para o serviço de sombra, o cabeçalho do host/autoridade é sufixado com -shadow.

corsPolicy

object (CorsPolicy)

A especificação para permitir solicitações entre origens do lado do cliente.

statefulSessionAffinity

object (StatefulSessionAffinityPolicy)

Opcional. Especifica a afinidade da sessão com estado baseada em cookie.

directResponse

object (HttpDirectResponse)

Opcional. Objeto de resposta HTTP estático a ser retornado, independentemente da solicitação.

idleTimeout

string (Duration format)

Opcional. Especifica o tempo limite de inatividade da rota selecionada. O tempo limite de inatividade é definido como o período em que nenhum byte é enviado ou recebido na conexão upstream ou downstream. Se não for definido, o tempo limite de inatividade padrão será de 1 hora. Se definido como 0s, o tempo limite será desativado.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

Destino

Especificações de um destino para onde a solicitação deve ser roteada.

Representação JSON
{
  "serviceName": string,
  "weight": integer,
  "requestHeaderModifier": {
    object (HeaderModifier)
  },
  "responseHeaderModifier": {
    object (HeaderModifier)
  }
}
Campos
serviceName

string

O URL de um BackendService para rotear o tráfego.

weight

integer

Especifica a proporção de solicitações encaminhadas ao back-end referenciado pelo campo serviceName. Isso é calculado como: - peso/soma(pesos nesta lista de destinos). Para valores diferentes de zero, pode haver algum épsilon da proporção exata definida aqui, dependendo da precisão que uma implementação aceita.

Se apenas um serviceName for especificado e tiver um peso maior que 0, 100% do tráfego será encaminhado para esse back-end.

Se os pesos forem especificados para um nome de serviço, eles precisarão ser especificados para todos.

Se os pesos não forem especificados para todos os serviços, o tráfego será distribuído em proporções iguais para todos eles.

requestHeaderModifier

object (HeaderModifier)

Opcional. A especificação para modificar os cabeçalhos de uma solicitação atendida antes de enviá-la ao destino. Se HeaderModifiers forem definidos em Destination e RouteAction, eles serão mesclados. Os conflitos entre os dois não serão resolvidos na configuração.

responseHeaderModifier

object (HeaderModifier)

Opcional. A especificação para modificar os cabeçalhos de uma resposta antes de enviá-la de volta ao cliente. Se HeaderModifiers forem definidos no destino e na RouteAction, eles serão mesclados. Os conflitos entre os dois não serão resolvidos na configuração.

HeaderModifier

A especificação para modificar o cabeçalho HTTP na solicitação HTTP e na resposta HTTP.

Representação JSON
{
  "set": {
    string: string,
    ...
  },
  "add": {
    string: string,
    ...
  },
  "remove": [
    string
  ]
}
Campos
set

map (key: string, value: string)

Substitui completamente os cabeçalhos pelo mapa fornecido, em que a chave é o nome do cabeçalho e o valor é o valor do cabeçalho.

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

add

map (key: string, value: string)

Adiciona os cabeçalhos com o mapa fornecido, em que a chave é o nome do cabeçalho e o valor é o valor do cabeçalho.

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

remove[]

string

Remova os cabeçalhos (correspondentes por nomes de cabeçalho) especificados na lista.

Redirecionado

A especificação para redirecionar o tráfego.

Representação JSON
{
  "hostRedirect": string,
  "pathRedirect": string,
  "prefixRewrite": string,
  "responseCode": enum (ResponseCode),
  "httpsRedirect": boolean,
  "stripQuery": boolean,
  "portRedirect": integer
}
Campos
hostRedirect

string

O host que será usado na resposta de redirecionamento em vez daquele que foi fornecido na solicitação.

pathRedirect

string

O caminho que será usado na resposta de redirecionamento em vez do que foi fornecido na solicitação. pathRedirect não pode ser fornecido junto com prefixRedirect. Forneça apenas um ou nenhum. Se nenhum for fornecido, o caminho da solicitação original será usado para o redirecionamento.

prefixRewrite

string

Indica que, durante o redirecionamento, o prefixo (ou caminho) correspondente precisa ser trocado por esse valor. Essa opção permite que os URLs sejam criados dinamicamente com base na solicitação.

responseCode

enum (ResponseCode)

O código de status HTTP a ser usado para o redirecionamento.

httpsRedirect

boolean

Se definido como verdadeiro, o esquema de URL na solicitação redirecionada será definido como https. Se definido como falso, o esquema de URL da solicitação redirecionada vai permanecer o mesmo da solicitação.

O padrão é definido como falso.

stripQuery

boolean

Se definido como verdadeiro, qualquer parte de consulta que acompanha o URL de origem será removida antes de redirecionar a solicitação. Se definido como "false", a parte de consulta do URL de origem é mantida.

O padrão é definido como falso.

portRedirect

integer

A porta que será usada na solicitação redirecionada em vez daquela que foi fornecida na solicitação.

ResponseCode

Código de resposta HTTP compatível.

Tipos enumerados
RESPONSE_CODE_UNSPECIFIED Valor padrão
MOVED_PERMANENTLY_DEFAULT Corresponde a 301.
FOUND Corresponde a 302.
SEE_OTHER Corresponde a 303.
TEMPORARY_REDIRECT Corresponde a 307. Nesse caso, o método de solicitação será mantido.
PERMANENT_REDIRECT Corresponde a 308. Nesse caso, o método de solicitação será mantido.

FaultInjectionPolicy

A especificação para injeção de falhas introduzida no tráfego para testar a resiliência dos clientes em relação à falha do serviço de destino. Como parte da injeção de falhas, quando os clientes enviam solicitações para um destino, o proxy do cliente pode introduzir atrasos em uma porcentagem das solicitações antes de enviá-las ao serviço de destino. Da mesma forma, as solicitações podem ser canceladas pelo proxy do cliente para uma porcentagem de solicitações.

Representação JSON
{
  "delay": {
    object (Delay)
  },
  "abort": {
    object (Abort)
  }
}
Campos
delay

object (Delay)

A especificação para injetar atraso nas solicitações do cliente.

abort

object (Abort)

A especificação para cancelar solicitações do cliente.

Atraso

Especificação de como as solicitações do cliente são atrasadas como parte da injeção de falhas antes de serem enviadas a um destino.

Representação JSON
{
  "fixedDelay": string,
  "percentage": integer
}
Campos
fixedDelay

string (Duration format)

Especifique um atraso fixo antes de encaminhar a solicitação.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

percentage

integer

A porcentagem de tráfego em que o atraso será injetado.

O valor precisa estar entre [0, 100]

Cancelar

Especificação de como as solicitações do cliente são canceladas como parte da injeção de falhas antes de serem enviadas a um destino.

Representação JSON
{
  "httpStatus": integer,
  "percentage": integer
}
Campos
httpStatus

integer

O código de status HTTP usado para cancelar a solicitação.

O valor precisa estar entre 200 e 599, inclusive.

percentage

integer

A porcentagem de tráfego que será cancelada.

O valor precisa estar entre [0, 100]

URLRewrite

A especificação para modificar o URL da solicitação antes de encaminhá-la ao destino.

Representação JSON
{
  "pathPrefixRewrite": string,
  "hostRewrite": string
}
Campos
pathPrefixRewrite

string

Antes de encaminhar a solicitação para o destino selecionado, a parte correspondente do caminho das solicitações é substituída por esse valor.

hostRewrite

string

Antes de encaminhar a solicitação para o destino selecionado, o cabeçalho do host das solicitações é substituído por esse valor.

RetryPolicy

As especificações para novas tentativas.

Representação JSON
{
  "retryConditions": [
    string
  ],
  "numRetries": integer,
  "perTryTimeout": string
}
Campos
retryConditions[]

string

Especifica uma ou mais condições em que essa política de repetição se aplica. Os valores válidos são: 5xx: o proxy vai tentar novamente se o serviço de destino responder com qualquer código de resposta 5xx ou se o serviço de destino não responder, por exemplo: desconexão, redefinição, tempo limite de leitura, falha de conexão e streams recusados.

gateway-error: semelhante a 5xx, mas só se aplica aos códigos de resposta 502, 503 e 504.

reset: o proxy tentará novamente se o serviço de destino não responder (tempo limite de desconexão/redefinição/leitura)

connect-failure: o proxy vai tentar novamente em caso de falhas na conexão com o destino, por exemplo, devido a tempos limite de conexão.

retriable-4xx: o proxy vai tentar novamente os códigos de resposta 4xx que podem ser repetidos. No momento, o único erro que pode ser repetido é o 409.

refused-stream: o proxy vai tentar novamente se o destino redefinir o stream com um código do erro REFUSED_STREAM. Esse tipo de redefinição indica que é seguro tentar novamente.

numRetries

integer

Especifica o número permitido de novas tentativas. Esse número precisa ser maior que 0. Se não for especificado, o padrão será 1.

perTryTimeout

string (Duration format)

Especifica um tempo limite diferente de zero por tentativa de repetição.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

RequestMirrorPolicy

Especifica a política sobre como as solicitações são ocultadas para um serviço de destino espelhado separado. O proxy não aguarda respostas do serviço de sombra. Antes de enviar tráfego para o serviço de sombra, o cabeçalho do host/autoridade é sufixado com -shadow. No momento, o espelhamento não é compatível com destinos do Cloud Run.

Representação JSON
{
  "destination": {
    object (Destination)
  },
  "mirrorPercent": number
}
Campos
destination

object (Destination)

O destino para onde as solicitações serão espelhadas. O peso do destino será ignorado.

mirrorPercent

number

Opcional. A porcentagem de solicitações a serem espelhadas no destino desejado.

CorsPolicy

A especificação para permitir solicitações entre origens do lado do cliente.

Representação JSON
{
  "allowOrigins": [
    string
  ],
  "allowOriginRegexes": [
    string
  ],
  "allowMethods": [
    string
  ],
  "allowHeaders": [
    string
  ],
  "exposeHeaders": [
    string
  ],
  "maxAge": string,
  "allowCredentials": boolean,
  "disabled": boolean
}
Campos
allowOrigins[]

string

Especifica a lista de origens que podem fazer solicitações de CORS. Uma origem será permitida se corresponder a um item em allowOrigins ou allowOriginRegexes.

allowOriginRegexes[]

string

Especifica os padrões de expressão regular que correspondem às origens permitidas. Para gramática de expressão regular, consulte https://github.com/google/re2/wiki/Syntax.

allowMethods[]

string

Especifica o conteúdo do cabeçalho Access-Control-Allow-Methods.

allowHeaders[]

string

Especifica o conteúdo do cabeçalho Access-Control-Allow-Headers.

exposeHeaders[]

string

Especifica o conteúdo do cabeçalho Access-Control-Expose-Headers.

maxAge

string

Especifica por quanto tempo o resultado de uma solicitação de simulação pode ser armazenado em cache, em segundos. Isso se traduz no cabeçalho Access-Control-Max-Age.

allowCredentials

boolean

Em resposta a uma solicitação de simulação, definir como verdadeiro indica que a solicitação real pode incluir credenciais do usuário. Isso se traduz no cabeçalho Access-Control-Allow-Credentials.

O valor padrão é falso.

disabled

boolean

Se for verdadeiro, a política de CORS será desativada. O valor padrão é falso, o que indica que a política de CORS está em vigor.

StatefulSessionAffinityPolicy

A especificação para afinidade da sessão com estado baseada em cookie, em que o plano de dados fornece um "cookie de sessão" com o nome "GSSA" que codifica um host de destino específico, e cada solicitação que contém esse cookie é direcionada para esse host, desde que ele permaneça ativo e íntegro.

A biblioteca de malha sem proxy do gRPC ou o proxy sidecar vai gerenciar o cookie de sessão, mas o código do aplicativo cliente é responsável por copiar o cookie de cada RPC na sessão para a próxima.

Representação JSON
{
  "cookieTtl": string
}
Campos
cookieTtl

string (Duration format)

Obrigatório. O valor de TTL do cookie para o cabeçalho Set-Cookie gerado pelo plano de dados. A vida útil do cookie pode ser definida como um valor de 0 a 86.400 segundos (24 horas).

Defina como 0s para usar um cookie de sessão e desativar a validade do cookie.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

HttpDirectResponse

Objeto de resposta HTTP estático a ser retornado.

Representação JSON
{
  "status": integer,

  // Union field HttpBody can be only one of the following:
  "stringBody": string,
  "bytesBody": string
  // End of list of possible types for union field HttpBody.
}
Campos
status

integer

Obrigatório. Status a ser retornado como parte da resposta HTTP. Precisa ser um número inteiro positivo.

Campo de união HttpBody. Corpo a ser retornado como parte da resposta HTTP. HttpBody pode ser apenas de um dos tipos a seguir:
stringBody

string

Opcional. Corpo da resposta como uma string. O tamanho máximo do corpo é de 1.024 caracteres.

bytesBody

string (bytes format)

Opcional. Corpo da resposta como bytes. O tamanho máximo do corpo é de 4.096 B.

Uma string codificada em base64.

Métodos

create

Cria uma HttpRoute em determinado projeto e local.

delete

Exclui uma única HttpRoute.

get

Recebe detalhes de uma única HttpRoute.

list

Lista a HttpRoute em determinado projeto e local.

patch

Atualiza os parâmetros de uma única HttpRoute.