Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Tipos de endpoint de API
Esta página descreve os diferentes tipos de endpoints de API que podem ser usados em
Assured Workloads. Um endpoint de API (ou endpoint de serviço) é um URL
que especifica o endereço de rede de um serviço de API Google Cloud , como
bigquery.googleapis.com.Os serviços Google Cloud permitem o acesso a recursos usando
diferentes tipos de endpoints de API, incluindo endpoints globais, de localização e regionais. A disponibilidade de cada tipo depende se eles são fornecidos por um
determinado Google Cloud produto ou serviço.
Todos os pacotes de controle do Assured Workloads são compatíveis com endpoints de API globais. O suporte a endpoints de API regionais e de localização varia de acordo com os
pacotes de controle.
Endpoints de API globais
Um endpoint global da API não especifica o local no nome do host do URL. Exemplo:
storage.googleapis.com
bigquery.googleapis.com
logging.googleapis.com
Esses endpoints de escopo global fornecem endpoints de serviço de alta disponibilidade
que encerram a sessão TLS o mais próximo possível do cliente, o que
minimiza a latência ao fornecer chamadas de API de uma população de clientes dispersa
pela Internet.
Endpoints de API de local
Um endpoint de API de localização especifica o local no nome do host do URL. Exemplo:
us-west1-storage.googleapis.com
us-west1-bigquery.googleapis.com
us-west1-logging.googleapis.com
Esses endpoints de locais oferecem benefícios aos clientes que precisam usar
serviços específicos de local e querem verificar se os dados em trânsito permanecem em
um local específico quando acessados por conectividade particular.
Endpoints regionais da API
Um endpoint regional da API especifica o local como um subdomínio. Exemplo:
storage.us-west1.rep.googleapis.com
bigquery.us-west1.rep.googleapis.com
logging.us-west1.rep.googleapis.com
Esses endpoints regionais oferecem mais benefícios aos clientes que precisam usar serviços específicos de local e querem ter maneiras de verificar se os dados em trânsito permanecem em um local específico quando acessados por conectividade privada ou pela Internet pública.
[[["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-09-01 UTC."],[[["\u003cp\u003eAPI endpoints, which are URLs specifying the network address of a Google Cloud API service, can be global, locational, or regional.\u003c/p\u003e\n"],["\u003cp\u003eGlobal API endpoints, like \u003ccode\u003estorage.googleapis.com\u003c/code\u003e, do not specify a location and are designed for high availability and low latency for clients around the world.\u003c/p\u003e\n"],["\u003cp\u003eLocational API endpoints, such as \u003ccode\u003eus-west1-storage.googleapis.com\u003c/code\u003e, include the location in the hostname and are used by customers who require location-specific services and wish to keep in-transit data in a specific area.\u003c/p\u003e\n"],["\u003cp\u003eRegional API endpoints, exemplified by \u003ccode\u003estorage.us-west1.rep.googleapis.com\u003c/code\u003e, use a location subdomain and offer the greatest control for keeping in-transit data within a specific region, either via private connectivity or the internet.\u003c/p\u003e\n"],["\u003cp\u003eAssured Workloads control packages support global API endpoints, while support for locational and regional endpoints varies, with the availability of both locational and regional endpoints being limited across Google Cloud services.\u003c/p\u003e\n"]]],[],null,["# API endpoint types\n==================\n\nThis page describes the different types of API endpoints that can be used in\nAssured Workloads. An API endpoint (or *service endpoint* ) is a URL\nthat specifies the network address of a Google Cloud API service, such as\n`bigquery.googleapis.com`. Google Cloud services allow access to resources using\ndifferent types of API endpoints, including global, locational, and regional\nendpoints. Availability for each type depends on whether they are provided by a\ngiven Google Cloud product or service.\n\nAll Assured Workloads\n[control packages](/assured-workloads/docs/control-packages) support global\nAPI endpoints. Support for locational and regional API endpoints varies across\ncontrol packages.\n\nGlobal API endpoints\n--------------------\n\nA global API endpoint doesn't specify the location in the URL hostname. For\nexample:\n\n- `storage.googleapis.com`\n- `bigquery.googleapis.com`\n- `logging.googleapis.com`\n\nThese globally scoped endpoints provide highly available service endpoints\nthat terminate the TLS session as close to the client as possible, which\nminimizes latency when serving API calls from a dispersed client population\nover the internet.\n\nLocational API endpoints\n------------------------\n\nA locational API endpoint specifies the location in the URL hostname. For\nexample:\n\n- `us-west1-storage.googleapis.com`\n- `us-west1-bigquery.googleapis.com`\n- `us-west1-logging.googleapis.com`\n\nThese locational endpoints offer benefits to customers who require the use of\nlocation-specific services, and want to verify that in-transit data remains in\na particular location when accessed through private connectivity.\n| **Note:** Locational API endpoints are supported by a limited number of services, and their availability may vary. In addition, your organization may require additional configuration to enable them in your organization. Contact [Cloud Customer Care](/support) for more information.\n\nRegional API endpoints\n----------------------\n\nA regional API endpoint specifies the location as a subdomain. For example:\n\n- `storage.us-west1.rep.googleapis.com`\n- `bigquery.us-west1.rep.googleapis.com`\n- `logging.us-west1.rep.googleapis.com`\n\nThese regional endpoints offer the most benefits to customers who require the\nuse of location-specific services, and want to have ways to verify that\nin-transit data remains in a particular location when accessed through either\nprivate connectivity or the public internet.\n| **Note:** Regional API endpoints are supported by a limited number of services, and their availability may vary."]]
