Acessar APIs regionais do Google por endpoints

Console

1. No console do Google Cloud , acesse a página Private Service Connect.

   Acessar Private Service Connect

2. Clique em Conectar endpoint.

3. Em Destino, selecione API do Google.

4. Na lista Escopo, selecione Regional.

5. Na lista Região, selecione a região que você quer usar.

6. Na lista Serviço de destino, selecione o serviço que você quer acessar.

7. Em Nome do endpoint, digite um nome para o endpoint.

8. Em Rede, selecione uma rede.

9. Em Sub-rede, selecione uma sub-rede.

10. Em Endereço IP, faça uma destas opções para configurar um endereço IP:

    • Selecione Alocação automática para alocar e reservar automaticamente um novo endereço IP estático.
    • Selecione um endereço IP estático na lista.
    • Clique em Criar endereço IP para reservar um novo endereço IP estático.

11. Opcional: para disponibilizar o endpoint em todas as regiões da rede VPC, selecione Ativar o acesso global.

12. Clique em Adicionar endpoint.

gcloud

Use o comando gcloud network-connectivity regional-endpoints create para criar o endpoint.

gcloud network-connectivity regional-endpoints create ENDPOINT_NAME \
    --region=REGION \
    --address=ADDRESS \
    --network=projects/PROJECT_ID/global/networks/NETWORK_NAME \
    --subnetwork=projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME \
    --target-google-api=REP_DNS_NAME

Se quiser disponibilizar o endpoint para recursos em outras regiões, adicione a flag --enable-global-access.

Substitua:

• ENDPOINT_NAME: um nome para o endpoint.

• REGION: a região em que você quer criar o endpoint.

• ADDRESS: o endereço IPv4 ou IPv6 que você quer usar para o endpoint. Se esse valor for omitido, um endereço IPv4 da sub-rede será alocado. Use um dos seguintes formatos:

  • Endereço IPv4, por exemplo, 10.0.0.2.
  • URI de recurso de endereço IPv4 ou IPv6, por exemplo, projects/PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME.

• PROJECT_ID: o projeto em que você está criando o endpoint.

• NETWORK_NAME: o nome da rede VPC do endpoint.

• SUBNET_NAME: a sub-rede a que você está conectando o endpoint.

• REP_DNS_NAME: o nome do host do endpoint do serviço regional a que você está se conectando. Por exemplo, spanner.me-central2.rep.googleapis.com.

API

Use o método projects.locations.regionalEndpoints.create para criar o endpoint.

Método HTTP e URL:

  POST https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/regionalEndpoints?regionalEndpointId=ENDPOINT_NAME
  

  {
    "accessType": "REGIONAL",
    "address": "ADDRESS",
    "network": "projects/PROJECT_ID/global/networks/NETWORK_NAME",
    "subnetwork": "projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME",
    "targetGoogleApi": "REP_DNS_NAME"
  }
  

Substitua:

• PROJECT_ID: o ID do projeto do endpoint.
• REGION: a região em que você quer criar o endpoint.
• ENDPOINT_NAME: um nome para o endpoint.
• ADDRESS: o endereço IPv4 ou IPv6 que você quer usar para o endpoint. Se esse valor for omitido, um endereço IPv4 da sub-rede será alocado. Use um dos formatos a seguir:
  • Endereço IPv4, por exemplo, 10.0.0.2.
  • URI de recurso de endereço IPv4 ou IPv6, por exemplo, projects/PROJECT_ID/regions/REGION/addresses/ADDRESS_NAME.
• NETWORK_NAME: o nome da rede VPC do endpoint.
• SUBNET_NAME: o nome da sub-rede a que você quer conectar o endpoint.
• REP_DNS_NAME: o nome do host do endpoint de serviço regional a que você quer se conectar. Por exemplo, spanner.me-central2.rep.googleapis.com.

gcloud

1. Reserve um endereço IP estático para usar no endpoint regional com o comando gcloud compute addresses create. O uso de um endereço IP estático é opcional para IPv4 e obrigatório para IPv6.

   Crie o recurso de endereço no projeto de serviço, especificando uma sub-rede no projeto host.

   gcloud compute addresses create ADDRESS_NAME \
       --region=REGION \
       --subnet=projects/HOST_PROJECT/regions/REGION/subnetworks/HOST_SUBNET \
       --ip-version=IP_VERSION \
       --project=SERVICE_PROJECT
   

   Substitua:

   • ADDRESS_NAME: o nome a ser atribuído ao endereço IP reservado.
   • REGION: a região do endereço IP do endpoint. Precisa ser a mesma região que contém o anexo de serviço do produtor de serviço.
   • HOST_PROJECT: adicione o ID do projeto host.
   • HOST_SUBNET: o nome da sub-rede do endereço IP do endpoint.
   • IP_VERSION: a versão do IP do endereço IP, que pode ser IPV4 ou IPV6. O padrão é IPV4. Para especificar IPV6, o endereço IP precisa estar conectado a uma sub-rede com um intervalo de endereços IPv6 internos.
   • SERVICE_PROJECT: o ID do projeto de serviço

2. Use o comando gcloud network-connectivity regional-endpoints create para criar o endpoint regional no projeto de serviço.

   gcloud network-connectivity regional-endpoints create ENDPOINT_NAME \
       --region=REGION \
       --address=ADDRESS \
       --network=projects/HOST_PROJECT/global/networks/HOST_NETWORK \
       --subnetwork=projects/HOST_PROJECT/regions/REGION/subnetworks/HOST_SUBNET \
       --target-google-api=REP_DNS_NAME \
       --project=SERVICE_PROJECT
       

   Se quiser disponibilizar o endpoint para recursos em outras regiões, adicione a flag --enable-global-access.

   Substitua:

   • ENDPOINT_NAME: um nome para o endpoint.

   • REGION: a região em que você quer criar o endpoint.

   • ADDRESS: o endereço IPv4 ou IPv6 que você quer usar para o endpoint. Se esse valor for omitido, um endereço IPv4 da sub-rede será alocado. Use um dos seguintes formatos:

     • Endereço IPv4, por exemplo, 10.0.0.2.
     • URI do recurso de endereço IPv4 ou IPv6. O recurso de endereço precisa ser criado no projeto de serviço, não no projeto host. Por exemplo, projects/SERVICE_PROJECT/regions/REGION/addresses/ADDRESS_NAME.
     • HOST_PROJECT: o ID do projeto host

   • HOST_NETWORK: o nome da rede VPC no projeto host.

   • HOST_SUBNET: a sub-rede no projeto host a que você está conectando o endpoint.

   • REP_DNS_NAME: o nome do host do endpoint do serviço regional a que você está se conectando. Por exemplo, spanner.me-central2.rep.googleapis.com.

   • SERVICE_PROJECT: o ID do projeto de serviço

API

1. Reserve um endereço IP estático para usar no endpoint regional. O uso de um endereço IP estático é opcional para IPv4 e obrigatório para IPv6.

   Crie o recurso de endereço no projeto de serviço, especificando uma sub-rede no projeto host.

   POST https://compute.googleapis.com/compute/v1/projects/SERVICE_PROJECT/regions/REGION/addresses
   

   
   {
       "name": "ADDRESS_NAME",
       "addressType": "INTERNAL",
       "subnetwork": "projects/HOST_PROJECT/regions/REGION/subnetworks/HOST_SUBNET",
       "ipVersion": "IP_VERSION"
   }
   

   Substitua:

   • SERVICE_PROJECT: o ID do projeto de serviço.

   • REGION: a região do endpoint. Ela precisa ser a mesma região do endpoint regional a que você quer se conectar.

   • ADDRESS_NAME: o nome a ser atribuído ao endereço IP estático.

   • HOST_PROJECT: o ID do projeto host

   • HOST_SUBNET: a sub-rede na rede VPC compartilhada para reservar o endereço IP.

   • IP_VERSION: a versão do IP do endereço IP, que pode ser IPV4 ou IPV6. O padrão é IPV4. Para especificar IPV6, o endereço IP precisa estar conectado a uma sub-rede com um intervalo de endereços IPv6 internos.

2. Crie o endpoint do Private Service Connect usando o método projects.locations.regionalEndpoints.create.

   Método HTTP e URL:

   POST https://networkconnectivity.googleapis.com/v1/projects/SERVICE_PROJECT/locations/REGION/regionalEndpoints?regionalEndpointId=ENDPOINT_NAME
   

   {
     "accessType": "REGIONAL",
     "address": "ADDRESS",
     "network": "projects/HOST_PROJECT/global/networks/HOST_NETWORK",
     "subnetwork": "projects/HOST_PROJECT/regions/REGION/subnetworks/HOST_SUBNET",
     "targetGoogleApi": "REP_DNS_NAME"
   }
   

   Substitua:

   • SERVICE_PROJECT: o ID do projeto de serviço.
   • REGION: a região em que você quer criar o endpoint.
   • ENDPOINT_NAME: um nome para o endpoint.
   • ADDRESS: o endereço IPv4 ou IPv6 que você quer usar para o endpoint. Se esse valor for omitido, um endereço IPv4 da sub-rede será alocado. Use um dos formatos a seguir:
     • Endereço IPv4, por exemplo, 10.0.0.2.
     • URI de recurso de endereço IPv4 ou IPv6, por exemplo, projects/SERVICE_PROJECT/regions/REGION/addresses/ADDRESS_NAME.
   • HOST_PROJECT: o ID do projeto host
   • HOST_NETWORK: o nome da rede no projeto host.
   • HOST_SUBNET: o nome da sub-rede no projeto host a que você quer conectar o endpoint.
   • REP_DNS_NAME: o nome do host do endpoint de serviço regional a que você quer se conectar. Por exemplo, spanner.me-central2.rep.googleapis.com.

Console

1. No console do Google Cloud , acesse a página Private Service Connect.

   Acessar Private Service Connect

2. Clique na guia Endpoints conectados.

   Todos os endpoints são exibidos, incluindo aqueles com destinos regionais.

gcloud

Use o comando gcloud network-connectivity regional-endpoints list:

gcloud network-connectivity regional-endpoints list \
    --region=REGION

Substitua REGION pela região dos endpoints que você quer listar.

API

Use o método projects.locations.regionalEndpoints.list.

GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/regionalEndpoints

Substitua:

• PROJECT_ID: o ID do projeto do endpoint.
• REGION: a região dos endpoints que você quer listar.

Console

1. No console do Google Cloud , acesse a página Criar zona de DNS.

   Acessar a página Criar zona de DNS

2. Em Tipo de zona, selecione Particular.

3. Em Nome da zona, digite um nome. Por exemplo, se o endpoint do Private Service Connect apontar para spanner.me-central2.rep.googleapis.com, digite spanner-me-central2-rep-googleapis-com.

4. Em Nome DNS, especifique o nome do host do endpoint regional de destino seguido por um ponto final. Por exemplo, spanner.me-central2.rep.googleapis.com..

5. Opcional: adicione uma descrição.

6. Em Opções, selecione Padrão (privado).

7. Selecione as redes VPC em que você quer que a zona privada fique visível. Somente as redes VPC selecionadas estão autorizadas a consultar registros na zona.

8. Clique em Criar.

gcloud

Execute o comando dns managed-zones create:

gcloud dns managed-zones create ZONE_NAME \
    --dns-name=REP_DNS_NAME. \
    --networks=VPC_NETWORK_LIST \
    --visibility=private \
    --description="Private zone for REP_DNS_NAME"

Substitua:

• ZONE_NAME: um nome para a zona. Por exemplo, spanner-me-central2-rep-googleapis.com.
• DESCRIPTION: uma descrição para a zona
• REP_DNS_NAME: o sufixo DNS da zona. Use o nome do host do endpoint regional de destino. Por exemplo, spanner.me-central2.rep.googleapis.com.
• VPC_NETWORK_LIST: uma lista de VPCs que estão autorizadas a consultar a zona, separadas por vírgulas.

API

Envie uma solicitação POST usando o método managedZones.create:

Método HTTP e URL:

POST https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones

Corpo JSON da solicitação:

{
  "name": "ZONE_NAME",
  "dnsName": "REP_DNS_NAME.",
  "description": "DESCRIPTION",
  "visibility": "private",
  "privateVisibilityConfig": {
    "kind": "dns#managedZonePrivateVisibilityConfig",
    "networks": [
      {
        "kind": "dns#managedZonePrivateVisibilityConfigNetwork",
        "networkUrl": "NETWORK_1_URL"
      },
      {
        "kind": "dns#managedZonePrivateVisibilityConfigNetwork",
        "networkUrl": "NETWORK_2_URL"
      }
    ]
  }
}

Substitua:

• PROJECT_ID: o ID do projeto da zona DNS.
• ZONE_NAME: o nome da zona particular que você criou para esse endpoint regional.
• REP_DNS_NAME: o FQDN do registro que você está criando. Use o nome do host do endpoint regional de destino. Por exemplo, spanner.me-central2.rep.googleapis.com.
• DESCRIPTION: uma descrição para a zona de DNS.
• NETWORK_1_URL e NETWORK_2_URL: os URLs completos das redes VPC autorizadas a consultar a zona. Por exemplo, https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/NETWORK_NAME.

Console

1. No console do Google Cloud , acesse a página Zonas do Cloud DNS.

   Acessar Zonas do Cloud DNS

2. Clique no nome da zona gerenciada a que você quer adicionar o registro.

3. Na página Detalhes da zona, clique em Adicionar padrão.

4. Na página Criar conjunto de registros, deixe o campo Nome do DNS em branco. Se você deixar o campo em branco, um registro de recurso será criado na raiz do domínio.

5. Em Tipo de registro de recurso, selecione A.

6. No campo Endereço IPv4, digite ou selecione o endereço IP do endpoint do Private Service Connect.

7. Clique em Criar.

gcloud

Para adicionar um conjunto de registros de recursos, use o comando gcloud dns record-sets create:

gcloud dns record-sets create REP_DNS_NAME \
    --rrdatas=ADDRESS \
    --type=RECORD_TYPE \
    --ttl=TTL \
    --zone=ZONE_NAME

Substitua:

• REP_DNS_NAME: o FQDN do registro que você está criando. Use o nome do host do endpoint regional de destino. Por exemplo, spanner.me-central2.rep.googleapis.com.
• ADDRESS: o endereço IP do endpoint do Private Service Connect.
• RECORD_TYPE: o tipo de registro DNS, como A para registros IPv4 ou AAAA para registros IPv6.
• TTL: o TTL (em segundos) do armazenamento em cache do conjunto de registros de recurso. Por exemplo, 300
• ZONE_NAME: o nome da zona particular que você criou para esse endpoint regional.

API

Para adicionar um conjunto de registros de recursos, use o método resourceRecordSets.create:

Método HTTP e URL:

POST https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/ZONE_NAME/rrsets

Corpo JSON da solicitação:

{
  "name": "REP_DNS_NAME.",
  "type": "RECORD_TYPE",
  "ttl": TTL,
  "rrdatas": [ "ADDRESS" ]
}

Substitua:

• PROJECT_ID: o ID do projeto da zona DNS.
• ZONE_NAME: o nome da zona particular que você criou para esse endpoint regional.
• REP_DNS_NAME: o FQDN do registro que você está criando. Use o nome do host do endpoint regional de destino. Por exemplo, spanner.me-central2.rep.googleapis.com.
• RECORD_TYPE: o tipo de registro DNS, como A para registros IPv4 ou AAAA para registros IPv6.
• TTL: o TTL (em segundos) do armazenamento em cache do conjunto de registros de recurso. Por exemplo, 300
• ADDRESS: o endereço IP do endpoint do Private Service Connect.

gcloud

Use o comando gcloud network-connectivity regional-endpoints describe:

gcloud network-connectivity regional-endpoints describe \
    ENDPOINT_NAME --region=REGION

Substitua:

• ENDPOINT_NAME: o nome do endpoint.
• REGION: a região do endpoint.

API

Use o comando projects.locations.regionalEndpoints.get.

GET https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/regionalEndpoints/ENDPOINT_NAME

Substitua:

• PROJECT_ID: o ID do projeto do endpoint.
• REGION: a região dos endpoints que você quer listar.
• ENDPOINT_NAME: o nome do endpoint.

gcloud

Use o comando gcloud network-connectivity regional-endpoints delete:

gcloud network-connectivity regional-endpoints delete \
    ENDPOINT_NAME --region=REGION

Substitua:

• ENDPOINT_NAME: o nome do endpoint.
• REGION: a região do endpoint.

API

Use o comando projects.location.regionalEndpoints.delete.

DELETE https://networkconnectivity.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/regionalEndpoints/ENDPOINT_NAME

Substitua:

• PROJECT_ID: o ID do projeto do endpoint.
• REGION: a região do endpoint.
• ENDPOINT_NAME: o nome do endpoint.