What the difference these formats of identifying a resource on gcp when running certain commands

120 views Asked by At

I was trying to list the grantable roles for a project of mine on google cloud platform, and I came across these two formats for identifying the resource and running the command against.

The formats were:

  • //cloudresourcemanager.googleapis.com/projects/PROJECT_ID, and
  • https://cloudresourcemanager.googleapis.com/v3/projects/PROJECT_ID

How come the second uses the v3 in the URI identifier. Both did give the expected results but need to know why the difference.

1

There are 1 answers

1
Iñigo González On BEST ANSWER

TLDR: use the first one.

The 'v3' in the second identifier (with the https URI), tells you that it was retrieved using the 3.x API version.

Right now (as march 2022), both URIs will work but in the future, the second one might not.

Why? because google could deprecate that API version in the next years.

(probably they will remove that 'v3' internally, but who knows).