IssueTracker

This is a PIT to track progress on a public document

Issue Summary:

Currently when a request is made to "https://aiplatform.googleapis.com" the request defaults to us-central1 region and "https://${LOCATION}-aiplatform.googleapis.com" directs the request to the respective region/location. The $LOCATION in the hostname is used to direct the requests to the mentioned region.

When "https://aiplatform.googleapis.com" is used, the request will end up in us-central1 region, despite the $LOCATION mentioned in the URL path [1]. For example when I use URL [2] the request lands in europe-west1 and no error is thrown. However, if I remove the locations/${LOCATION} it throws an error mentioning the URL does not exist.

This can cause ambiguity to customers on the role of $LOCATION in hostname and URL Path. It would be cogent if we could document this behaviour.

[1] https://${LOCATION}-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/${LOCATION}/publishers/google/models/${MODEL_ID}:generateContent

[2] https://europe-west1--aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/*gibberish*/publishers/google/models/${MODEL_ID}:generateContent

Documentation: https://cloud.google.com/vertex-ai/generative-ai/docs/model-reference/inference#syntax