docs(samples): improve docstring of Vertex AI Python SDK Model Registry samples (#1705)

* improve doc string * nox tests passed * rename location Co-authored-by: Andrew Ferlitsch <aferlitsch@google.com>

Author: inardini

samples/model-builder/model_registry/assign_aliases_model_version_sample.py

@@ -32,15 +32,15 @@ def assign_aliases_model_version_sample(
  model_id: The ID of the model.
  version_aliases: The version aliases to assign.
  version_id: The version ID of the model to assign the aliases to.
- project: The project name.
- location: The location name.
+ project: The project ID.
+ location: The region name.
  Returns
  None.
  """
  # Initialize the client.
  aiplatform.init(project=project, location=location)
 
- # Initialize the Model Registry resource with the ID 'model_id'.The parent_name of create method can be also
+ # Initialize the Model Registry resource with the ID 'model_id'.The parent_name of the Model resource can be also
  # 'projects/<your-project-id>/locations/<your-region>/models/<your-model-id>'
  model_registry = aiplatform.models.ModelRegistry(model=model_id)
 

samples/model-builder/model_registry/create_aliased_model_sample.py

@@ -25,8 +25,8 @@ def create_aliased_model_sample(
  Args:
  model_id: The ID of the model to initialize. Parent resource name of the model is also accepted.
  version_id: The version ID or version alias of the model to initialize.
- project: The project.
- location: The location.
+ project: The project ID.
+ location: The region name.
  Returns:
  Model resource.
  """

samples/model-builder/model_registry/create_default_model_sample.py

@@ -22,15 +22,15 @@ def create_default_model_sample(model_id: str, project: str, location: str):
  Initialize a Model resource to represent an existing model version with alias 'default'.
  Args:
  model_id: The ID of the model to initialize. Parent resource name of the model is also accepted.
- project: The project.
- location: The location.
+ project: The project ID.
+ location: The region name.
  Returns:
  Model resource.
  """
  # Initialize the client.
  aiplatform.init(project=project, location=location)
 
- # Initialize the Model resource with the ID 'model_id'. The parent_name of create method can be also
+ # Initialize the Model resource with the ID 'model_id'. The parent_name of the Model resource can be also
  # 'projects/<your-project-id>/locations/<your-region>/models/<your-model-id>'
  default_model = aiplatform.Model(model_name=model_id)
 

samples/model-builder/model_registry/create_model_registry_sample.py

@@ -22,16 +22,16 @@ def create_model_registry_sample(model_id: str, project: str, location: str):
  Create a ModelRegistry resource associated to model_id
  Args:
  model_id: The ID of the model.
- project: The project name.
- location: The location name.
+ project: The project ID.
+ location: The region name.
  Returns:
  ModelRegistry resource.
  """
 
  # Initialize the client.
  aiplatform.init(project=project, location=location)
 
- # Initialize the Model Registry resource with the ID 'model_id'.The parent_name of create method can be also
+ # Initialize the Model Registry resource with the ID 'model_id'.The parent_name of Model resource can be also
  # 'projects/<your-project-id>/locations/<your-region>/models/<your-model-id>'
  model_registry = aiplatform.models.ModelRegistry(model=model_id)
 

samples/model-builder/model_registry/delete_aliases_model_version_sample.py

@@ -32,15 +32,15 @@ def delete_aliases_model_version_sample(
  model_id: The ID of the model.
  version_aliases: The version aliases to assign.
  version_id: The version ID of the model to assign the aliases to.
- project: The project name.
- location: The location name.
+ project: The project ID.
+ location: The region name.
  Returns
  None.
  """
  # Initialize the client.
  aiplatform.init(project=project, location=location)
 
- # Initialize the Model Registry resource with the ID 'model_id'.The parent_name of create method can be also
+ # Initialize the Model Registry resource with the ID 'model_id'.The parent_name of Model resource can be also
  # 'projects/<your-project-id>/locations/<your-region>/models/<your-model-id>'
  model_registry = aiplatform.models.ModelRegistry(model=model_id)
 

samples/model-builder/model_registry/delete_model_sample.py

@@ -23,14 +23,14 @@ def delete_model_sample(model_id: str, project: str, location: str):
  Args:
  model_id: The ID of the model to delete. Parent resource name of the model is also accepted.
  project: The project.
- location: The location.
+ location: The region name.
  Returns
  None.
  """
  # Initialize the client.
  aiplatform.init(project=project, location=location)
 
- # Get the model with the ID 'model_id'. The parent_name of delete method can be also
+ # Get the model with the ID 'model_id'. The parent_name of Model resource can be also
  # 'projects/<your-project-id>/locations/<your-region>/models/<your-model-id>'
  model = aiplatform.Model(model_name=model_id)
 

samples/model-builder/model_registry/delete_model_version_sample.py

@@ -25,15 +25,15 @@ def delete_model_version_sample(
  Args:
  model_id: The ID of the model to delete. Parent resource name of the model is also accepted.
  version_id: The version ID or version alias of the model to delete.
- project: The project.
- location: The location.
+ project: The project ID.
+ location: The region name.
  Returns
  None.
  """
  # Initialize the client.
  aiplatform.init(project=project, location=location)
 
- # Initialize the Model Registry resource with the ID 'model_id'.The parent_name of create method can be also
+ # Initialize the Model Registry resource with the ID 'model_id'.The parent_name of Model resource can be also
  # 'projects/<your-project-id>/locations/<your-region>/models/<your-model-id>'
  model_registry = aiplatform.models.ModelRegistry(model=model_id)
 

samples/model-builder/model_registry/get_model_version_info_sample.py

@@ -25,16 +25,16 @@ def get_model_version_info_sample(
  Args:
  model_id: The ID of the model.
  version_id: The version ID of the model version.
- project: The project name.
- location: The location name.
+ project: The project ID.
+ location: The region name.
  Returns:
  VersionInfo resource.
  """
 
  # Initialize the client.
  aiplatform.init(project=project, location=location)
 
- # Initialize the Model Registry resource with the ID 'model_id'.The parent_name of create method can be also
+ # Initialize the Model Registry resource with the ID 'model_id'.The parent_name of Model resource can be also
  # 'projects/<your-project-id>/locations/<your-region>/models/<your-model-id>'
  model_registry = aiplatform.models.ModelRegistry(model=model_id)
 

samples/model-builder/model_registry/get_registered_model_version_sample.py

@@ -26,16 +26,16 @@ def get_registered_model_version_sample(
  Get a registered model version.
  Args:
  model_id: The ID of the model. Parent resource name of the model is also accepted.
- project: The project.
- location: The location.
+ project: The project ID.
+ location: The region name.
  version_id: The version ID of the model.
  Returns:
  Model resource.
  """
  # Initialize the client.
  aiplatform.init(project=project, location=location)
 
- # Initialize the Model Registry resource with the ID 'model_id'. The parent_name of get method can be also
+ # Initialize the Model Registry resource with the ID 'model_id'. The parent_name of Model resource can be also
  # 'projects/<your-project-id>/locations/<your-region>/models/<your-model-id>'
  model_registry = aiplatform.models.ModelRegistry(model=model_id)
 

samples/model-builder/model_registry/list_model_versions_with_model_registry_sample.py

@@ -22,15 +22,15 @@ def list_model_versions_sample(model_id: str, project: str, location: str):
  List all model versions of a model.
  Args:
  model_id: The ID of the model to list. Parent resource name of the model is also accepted.
- project: The project.
- location: The location.
+ project: The project ID.
+ location: The region name.
  Returns:
  versions: List of model versions.
  """
  # Initialize the client.
  aiplatform.init(project=project, location=location)
 
- # Initialize the Model Registry resource with the ID 'model_id'.The parent_name of create method can be also
+ # Initialize the Model Registry resource with the ID 'model_id'.The parent_name of Model resource can be also
  # 'projects/<your-project-id>/locations/<your-region>/models/<your-model-id>'
  model_registry = aiplatform.models.ModelRegistry(model=model_id)