Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Esta página contém a terminologia principal que se aplica ao Diretório de serviços.
Leia estes termos para entender melhor como o Diretório de serviços funciona.
Endpoint
Um endpoint é um par individual de IP/porta que protege um serviço que pode processar solicitações. Qualquer serviço pode ter zero ou mais endpoints. O endpoint
pode ser uma VM, um contêiner, um balanceador de carga ou outra entidade capaz de processar
as solicitações. Um exemplo seria um cluster de servidores Redis gerenciados pelo usuário.
Os endpoints podem ter anotações opcionais, na forma de pares de chave-valor, que
os clientes podem usar. Por exemplo, um serviço Redis pode ter uma anotação
como replica:server. As anotações podem ser usadas para armazenar URLs. Use uma ferramenta como jq para extrair o novo URL da resposta.
No Diretório de serviços, um endpoint só pode existir em um serviço e
é identificado com um nome de endpoint que é um identificador de string exclusivo
para esse serviço.
Serviço
Um serviço é uma coleção de endpoints (IPs/portas) que fornecem um conjunto de
comportamentos. Os clientes procuram um serviço pelo nome e se conectam aos
endpoints que fornecem esse serviço. Os serviços também podem ter anotações
opcionais (pares de chave-valor) associadas a eles, por exemplo,
use_https:true.
Um serviço precisa pertencer a um namespace. Cada nome de serviço precisa ser exclusivo nesse
namespace.
Namespace
Um namespace contém um conjunto de nomes de serviço com
as informações do endpoint. Um namespace é uma forma de agrupar serviços
para facilitar o gerenciamento.
Os namespaces são recursos regionais e pertencem a um projeto. O nome de um
espaço de nomes precisa ser exclusivo para esse projeto e região.
Embora um namespace seja um recurso regional, os serviços que pertencem a ele
podem existir em qualquer lugar e ser consultados de qualquer lugar. Recomendamos
que os clientes escolham uma região que corresponda ao local em que os endpoints estão em execução.
Clientes HTTP/gRPC
O Diretório de serviços oferece suporte à pesquisa de nomes de serviços usando HTTP/gRPC.
Não há requisitos para que o serviço e o cliente estejam na mesma rede.
As operações de pesquisa no gRPC são controladas pelo IAM.
Zona do Diretório de serviços
Uma zona do Diretório de serviços é um tipo específico de zona particular do Cloud DNS, em que a fonte de informações completa e confiável é um namespace do Diretório de serviços. Ele permite que você procure
dados do Diretório de serviços usando solicitações de DNS.
Se um namespace estiver anexado a uma zona do diretório de serviços, todos os serviços nesse namespace vão ficar visíveis para todas as redes que tiverem permissão para consultar a zona.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-11 UTC."],[],[],null,["# Key terms\n\nThis page provides key terminology that applies to Service Directory.\nReview these terms to better understand how Service Directory works.\n\nEndpoint\n\n: An endpoint is an individual IP/port pair fronting a service that can handle\n requests. Any given service can have zero or more endpoints. The endpoint\n can be a VM, container, load balancer, or other entity capable of handling\n the requests. An example would be a cluster of user-managed Redis servers.\n\n: Endpoints can have optional annotations, in the form of key:value pairs, that\n clients can use. For example, a Redis service might have an annotation\n like `replica:server`. Annotations can be used to store URLs. You can use a\n tool such as [jq](https://stedolan.github.io/jq/)\n to pull the new URL out of the response.\n\n: For Service Directory, an endpoint can only exist within a service and\n is identified with an endpoint name that is a string identifier that is unique\n to that service.\n\nService\n\n: A service is a collection of endpoints (IP/ports) that provide a set of\n behaviors. Clients look up a service by its name and then connect to the\n endpoints that provide that service. Services can also have optional\n annotations (key-value pairs) associated with them (for example,\n `use_https:true`).\n\n: A service must belong to a namespace. Each service name must be unique within\n that namespace.\n\nNamespace\n\n: A namespace holds a set of service names along with\n their endpoint information. A namespace is a means of grouping services\n together for easier management.\n\n: Namespaces are regional resources and belong to a project. The name of a\n namespace must be unique for that project and region.\n\n Although a namespace is a regional resource, the services that belong to that\n namespace can exist anywhere and be queried from anywhere. We recommend\n customers choose a region that maps to where their endpoints are running.\n\nHTTP/gRPC clients\n\n: Service Directory supports look up of service names using HTTP/gRPC.\n There are no requirements that the service and client be on the same network.\n\n: Lookup operations over gRPC are controlled by IAM.\n\nService Directory zone\n\n: A Service Directory zone is a specific type of [Cloud DNS private\n zone](/dns/docs/overview#concepts) whose complete and authoritative source of\n information is a Service Directory namespace. It allows you to look up\n Service Directory data using DNS requests.\n\n: If a namespace is attached to a Service Directory zone, then all\n services in that namespace are visible to all networks that are allowed to\n query the zone."]]
