Class ApiHubClient (0.2.2)

This service provides all methods related to the API hub.

Return the API endpoint used by the client instance.

Returns the transport used by the client instance.

Return the universe domain used by the client instance.

Instantiates the api hub client.

Releases underlying transport's resources.

Returns a fully-qualified api_operation string.

Returns a fully-qualified api string.

Returns a fully-qualified attribute string.

Starts asynchronous cancellation on a long-running operation.

The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.

Returns a fully-qualified billing_account string.

Returns a fully-qualified folder string.

Returns a fully-qualified location string.

Returns a fully-qualified organization string.

Returns a fully-qualified project string.

Create an API resource in the API hub. Once an API resource is created, versions can be added to it.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_create_api():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    api = apihub_v1.Api()
    api.display_name = "display_name_value"

    request = apihub_v1.CreateApiRequest(
        parent="parent_value",
        api=api,
    )

    # Make the request
    response = client.create_api(request=request)

    # Handle the response
    print(response)

Create a user defined attribute.

Certain pre defined attributes are already created by the API hub. These attributes will have type as SYSTEM_DEFINED and can be listed via xref_ListAttributes method. Allowed values for the same can be updated via xref_UpdateAttribute method.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_create_attribute():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    attribute = apihub_v1.Attribute()
    attribute.display_name = "display_name_value"
    attribute.scope = "PLUGIN"
    attribute.data_type = "STRING"

    request = apihub_v1.CreateAttributeRequest(
        parent="parent_value",
        attribute=attribute,
    )

    # Make the request
    response = client.create_attribute(request=request)

    # Handle the response
    print(response)

Create a deployment resource in the API hub. Once a deployment resource is created, it can be associated with API versions.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_create_deployment():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    deployment = apihub_v1.Deployment()
    deployment.display_name = "display_name_value"
    deployment.deployment_type.enum_values.values.id = "id_value"
    deployment.deployment_type.enum_values.values.display_name = "display_name_value"
    deployment.resource_uri = "resource_uri_value"
    deployment.endpoints = ['endpoints_value1', 'endpoints_value2']

    request = apihub_v1.CreateDeploymentRequest(
        parent="parent_value",
        deployment=deployment,
    )

    # Make the request
    response = client.create_deployment(request=request)

    # Handle the response
    print(response)

Create an External API resource in the API hub.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_create_external_api():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    external_api = apihub_v1.ExternalApi()
    external_api.display_name = "display_name_value"

    request = apihub_v1.CreateExternalApiRequest(
        parent="parent_value",
        external_api=external_api,
    )

    # Make the request
    response = client.create_external_api(request=request)

    # Handle the response
    print(response)

Add a spec to an API version in the API hub. Multiple specs can be added to an API version. Note, while adding a spec, at least one of contents or source_uri must be provided. If contents is provided, then spec_type must also be provided.

On adding a spec with contents to the version, the operations present in it will be added to the version.Note that the file contents in the spec should be of the same type as defined in the projects/{project}/locations/{location}/attributes/system-spec-type attribute associated with spec resource. Note that specs of various types can be uploaded, however parsing of details is supported for OpenAPI spec currently.

In order to access the information parsed from the spec, use the xref_GetSpec method. In order to access the raw contents for a particular spec, use the xref_GetSpecContents method. In order to access the operations parsed from the spec, use the xref_ListAPIOperations method.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_create_spec():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    spec = apihub_v1.Spec()
    spec.display_name = "display_name_value"
    spec.spec_type.enum_values.values.id = "id_value"
    spec.spec_type.enum_values.values.display_name = "display_name_value"

    request = apihub_v1.CreateSpecRequest(
        parent="parent_value",
        spec=spec,
    )

    # Make the request
    response = client.create_spec(request=request)

    # Handle the response
    print(response)

Create an API version for an API resource in the API hub.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_create_version():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    version = apihub_v1.Version()
    version.display_name = "display_name_value"

    request = apihub_v1.CreateVersionRequest(
        parent="parent_value",
        version=version,
    )

    # Make the request
    response = client.create_version(request=request)

    # Handle the response
    print(response)

Returns a fully-qualified definition string.

Delete an API resource in the API hub. API can only be deleted if all underlying versions are deleted.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_delete_api():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.DeleteApiRequest(
        name="name_value",
    )

    # Make the request
    client.delete_api(request=request)

Delete an attribute.

Note: System defined attributes cannot be deleted. All associations of the attribute being deleted with any API hub resource will also get deleted.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_delete_attribute():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.DeleteAttributeRequest(
        name="name_value",
    )

    # Make the request
    client.delete_attribute(request=request)

Delete a deployment resource in the API hub.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_delete_deployment():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.DeleteDeploymentRequest(
        name="name_value",
    )

    # Make the request
    client.delete_deployment(request=request)

Delete an External API resource in the API hub.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_delete_external_api():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.DeleteExternalApiRequest(
        name="name_value",
    )

    # Make the request
    client.delete_external_api(request=request)

Deletes a long-running operation.

This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED.

Delete a spec. Deleting a spec will also delete the associated operations from the version.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_delete_spec():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.DeleteSpecRequest(
        name="name_value",
    )

    # Make the request
    client.delete_spec(request=request)

Delete an API version. Version can only be deleted if all underlying specs, operations, definitions and linked deployments are deleted.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_delete_version():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.DeleteVersionRequest(
        name="name_value",
    )

    # Make the request
    client.delete_version(request=request)

Returns a fully-qualified deployment string.

Returns a fully-qualified external_api string.

Creates an instance of this client using the provided credentials file.

Creates an instance of this client using the provided credentials info.

Creates an instance of this client using the provided credentials file.

Get API resource details including the API versions contained in it.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_get_api():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.GetApiRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_api(request=request)

    # Handle the response
    print(response)

Get details about a particular operation in API version.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_get_api_operation():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.GetApiOperationRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_api_operation(request=request)

    # Handle the response
    print(response)

Get details about the attribute.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_get_attribute():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.GetAttributeRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_attribute(request=request)

    # Handle the response
    print(response)

Get details about a definition in an API version.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_get_definition():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.GetDefinitionRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_definition(request=request)

    # Handle the response
    print(response)

Get details about a deployment and the API versions linked to it.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_get_deployment():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.GetDeploymentRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_deployment(request=request)

    # Handle the response
    print(response)

Get details about an External API resource in the API hub.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_get_external_api():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.GetExternalApiRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_external_api(request=request)

    # Handle the response
    print(response)

Gets information about a location.

Deprecated. Return the API endpoint and client cert source for mutual TLS.

The client cert source is determined in the following order: (1) if GOOGLE_API_USE_CLIENT_CERTIFICATE environment variable is not "true", the client cert source is None. (2) if client_options.client_cert_source is provided, use the provided one; if the default client cert source exists, use the default one; otherwise the client cert source is None.

The API endpoint is determined in the following order: (1) if client_options.api_endpoint if provided, use the provided one. (2) if GOOGLE_API_USE_CLIENT_CERTIFICATE environment variable is "always", use the default mTLS endpoint; if the environment variable is "never", use the default API endpoint; otherwise if client cert source exists, use the default mTLS endpoint, otherwise use the default API endpoint.

More details can be found at https://google.aip.dev/auth/4114.

Gets the latest state of a long-running operation.

Get details about the information parsed from a spec. Note that this method does not return the raw spec contents. Use xref_GetSpecContents method to retrieve the same.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_get_spec():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.GetSpecRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_spec(request=request)

    # Handle the response
    print(response)

Get spec contents.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_get_spec_contents():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.GetSpecContentsRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_spec_contents(request=request)

    # Handle the response
    print(response)

Get details about the API version of an API resource. This will include information about the specs and operations present in the API version as well as the deployments linked to it.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_get_version():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.GetVersionRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_version(request=request)

    # Handle the response
    print(response)

List operations in an API version.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_list_api_operations():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.ListApiOperationsRequest(
        parent="parent_value",
    )

    # Make the request
    page_result = client.list_api_operations(request=request)

    # Handle the response
    for response in page_result:
        print(response)

List API resources in the API hub.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_list_apis():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.ListApisRequest(
        parent="parent_value",
    )

    # Make the request
    page_result = client.list_apis(request=request)

    # Handle the response
    for response in page_result:
        print(response)

List all attributes.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_list_attributes():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.ListAttributesRequest(
        parent="parent_value",
    )

    # Make the request
    page_result = client.list_attributes(request=request)

    # Handle the response
    for response in page_result:
        print(response)

List deployment resources in the API hub.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_list_deployments():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.ListDeploymentsRequest(
        parent="parent_value",
    )

    # Make the request
    page_result = client.list_deployments(request=request)

    # Handle the response
    for response in page_result:
        print(response)

List External API resources in the API hub.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_list_external_apis():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.ListExternalApisRequest(
        parent="parent_value",
    )

    # Make the request
    page_result = client.list_external_apis(request=request)

    # Handle the response
    for response in page_result:
        print(response)

Lists information about the supported locations for this service.

Lists operations that match the specified filter in the request.

List specs corresponding to a particular API resource.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_list_specs():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.ListSpecsRequest(
        parent="parent_value",
    )

    # Make the request
    page_result = client.list_specs(request=request)

    # Handle the response
    for response in page_result:
        print(response)

List API versions of an API resource in the API hub.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_list_versions():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.ListVersionsRequest(
        parent="parent_value",
    )

    # Make the request
    page_result = client.list_versions(request=request)

    # Handle the response
    for response in page_result:
        print(response)

Parses a api_operation path into its component segments.

Parses a api path into its component segments.

Parses a attribute path into its component segments.

Parse a billing_account path into its component segments.

Parse a folder path into its component segments.

Parse a location path into its component segments.

Parse a organization path into its component segments.

Parse a project path into its component segments.

Parses a definition path into its component segments.

Parses a deployment path into its component segments.

Parses a external_api path into its component segments.

Parses a spec path into its component segments.

Parses a version path into its component segments.

Search across API-Hub resources.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_search_resources():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    request = apihub_v1.SearchResourcesRequest(
        location="location_value",
        query="query_value",
    )

    # Make the request
    page_result = client.search_resources(request=request)

    # Handle the response
    for response in page_result:
        print(response)

Returns a fully-qualified spec string.

Update an API resource in the API hub. The following fields in the [API][] can be updated:

• xref_display_name
• xref_description
• xref_owner
• xref_documentation
• xref_target_user
• xref_team
• xref_business_unit
• xref_maturity_level
• xref_attributes

The xref_update_mask should be used to specify the fields being updated.

Updating the owner field requires complete owner message and updates both owner and email fields.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_update_api():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    api = apihub_v1.Api()
    api.display_name = "display_name_value"

    request = apihub_v1.UpdateApiRequest(
        api=api,
    )

    # Make the request
    response = client.update_api(request=request)

    # Handle the response
    print(response)

Update the attribute. The following fields in the [Attribute resource][google.cloud.apihub.v1.Attribute] can be updated:

• xref_display_name The display name can be updated for user defined attributes only.
• xref_description The description can be updated for user defined attributes only.
• xref_allowed_values To update the list of allowed values, clients need to use the fetched list of allowed values and add or remove values to or from the same list. The mutable allowed values can be updated for both user defined and System defined attributes. The immutable allowed values cannot be updated or deleted. The updated list of allowed values cannot be empty. If an allowed value that is already used by some resource's attribute is deleted, then the association between the resource and the attribute value will also be deleted.
• xref_cardinality The cardinality can be updated for user defined attributes only. Cardinality can only be increased during an update.

The xref_update_mask should be used to specify the fields being updated.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_update_attribute():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    attribute = apihub_v1.Attribute()
    attribute.display_name = "display_name_value"
    attribute.scope = "PLUGIN"
    attribute.data_type = "STRING"

    request = apihub_v1.UpdateAttributeRequest(
        attribute=attribute,
    )

    # Make the request
    response = client.update_attribute(request=request)

    # Handle the response
    print(response)

Update a deployment resource in the API hub. The following fields in the [deployment resource][google.cloud.apihub.v1.Deployment] can be updated:

• xref_display_name
• xref_description
• xref_documentation
• xref_deployment_type
• xref_resource_uri
• xref_endpoints
• xref_slo
• xref_environment
• xref_attributes

The xref_update_mask should be used to specify the fields being updated.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_update_deployment():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    deployment = apihub_v1.Deployment()
    deployment.display_name = "display_name_value"
    deployment.deployment_type.enum_values.values.id = "id_value"
    deployment.deployment_type.enum_values.values.display_name = "display_name_value"
    deployment.resource_uri = "resource_uri_value"
    deployment.endpoints = ['endpoints_value1', 'endpoints_value2']

    request = apihub_v1.UpdateDeploymentRequest(
        deployment=deployment,
    )

    # Make the request
    response = client.update_deployment(request=request)

    # Handle the response
    print(response)

Update an External API resource in the API hub. The following fields can be updated:

• xref_display_name
• xref_description
• xref_documentation
• xref_endpoints
• xref_paths

The xref_update_mask should be used to specify the fields being updated.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_update_external_api():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    external_api = apihub_v1.ExternalApi()
    external_api.display_name = "display_name_value"

    request = apihub_v1.UpdateExternalApiRequest(
        external_api=external_api,
    )

    # Make the request
    response = client.update_external_api(request=request)

    # Handle the response
    print(response)

Update spec. The following fields in the xref_spec can be updated:

• xref_display_name
• xref_source_uri
• xref_lint_response
• xref_attributes
• xref_contents
• xref_spec_type

In case of an OAS spec, updating spec contents can lead to:

1. Creation, deletion and update of operations.
2. Creation, deletion and update of definitions.
3. Update of other info parsed out from the new spec.

In case of contents or source_uri being present in update mask, spec_type must also be present. Also, spec_type can not be present in update mask if contents or source_uri is not present.

The xref_update_mask should be used to specify the fields being updated.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_update_spec():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    spec = apihub_v1.Spec()
    spec.display_name = "display_name_value"
    spec.spec_type.enum_values.values.id = "id_value"
    spec.spec_type.enum_values.values.display_name = "display_name_value"

    request = apihub_v1.UpdateSpecRequest(
        spec=spec,
    )

    # Make the request
    response = client.update_spec(request=request)

    # Handle the response
    print(response)

Update API version. The following fields in the xref_version can be updated currently:

• xref_display_name
• xref_description
• xref_documentation
• xref_deployments
• xref_lifecycle
• xref_compliance
• xref_accreditation
• xref_attributes

The xref_update_mask should be used to specify the fields being updated.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import apihub_v1

def sample_update_version():
    # Create a client
    client = apihub_v1.ApiHubClient()

    # Initialize request argument(s)
    version = apihub_v1.Version()
    version.display_name = "display_name_value"

    request = apihub_v1.UpdateVersionRequest(
        version=version,
    )

    # Make the request
    response = client.update_version(request=request)

    # Handle the response
    print(response)

Returns a fully-qualified version string.