Vertex AI API (aiplatform:v1beta1)

2024-08-27

19 new methods

Additions

    Methods
  • aiplatform.datasets.create

      Description: Creates a Dataset.

      Flat Path: v1beta1/datasets

      Path: v1beta1/datasets

      Parameters:

        parent

          Type: string

          Description: Required. The resource name of the Location to create the Dataset in. Format: `projects/{project}/locations/{location}`

          Location: query

      Scopes: https://www.googleapis.com/auth/cloud-platform

      HTTP Method: POST

  • aiplatform.datasets.get

      Flat Path: v1beta1/datasets/{datasetsId}

      Scopes: https://www.googleapis.com/auth/cloud-platform

      Description: Gets a Dataset.

      Parameters:

        name

          Type: string

          Location: path

          Description: Required. The name of the Dataset resource.

          Pattern: ^datasets/[^/]+$

          Required: Yes

        readMask

          Type: string

          Description: Mask specifying which fields to read.

          Location: query

          Format: google-fieldmask

      HTTP Method: GET

      Parameter Order: name

      Path: v1beta1/{+name}

  • aiplatform.datasets.delete

      Description: Deletes a Dataset.

      Flat Path: v1beta1/datasets/{datasetsId}

      Parameter Order: name

      Path: v1beta1/{+name}

      Scopes: https://www.googleapis.com/auth/cloud-platform

      HTTP Method: DELETE

      Parameters:

        name

          Required: Yes

          Pattern: ^datasets/[^/]+$

          Type: string

          Description: Required. The resource name of the Dataset to delete. Format: `projects/{project}/locations/{location}/datasets/{dataset}`

          Location: path

  • aiplatform.datasets.patch

      Description: Updates a Dataset.

      Path: v1beta1/{+name}

      Parameters:

        updateMask

          Description: Required. The update mask applies to the resource. For the `FieldMask` definition, see google.protobuf.FieldMask. Updatable fields: * `display_name` * `description` * `labels`

          Format: google-fieldmask

          Location: query

          Type: string

        name

          Description: Output only. Identifier. The resource name of the Dataset.

          Type: string

          Required: Yes

          Location: path

          Pattern: ^datasets/[^/]+$

      HTTP Method: PATCH

      Flat Path: v1beta1/datasets/{datasetsId}

      Parameter Order: name

      Scopes: https://www.googleapis.com/auth/cloud-platform

  • aiplatform.datasets.list

      Scopes: https://www.googleapis.com/auth/cloud-platform

      Parameters:

        pageSize

          Type: integer

          Format: int32

          Description: The standard list page size.

          Location: query

        parent

          Type: string

          Description: Required. The name of the Dataset's parent resource. Format: `projects/{project}/locations/{location}`

          Location: query

        readMask

          Location: query

          Type: string

          Description: Mask specifying which fields to read.

          Format: google-fieldmask

        orderBy

          Location: query

          Type: string

          Description: A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `display_name` * `create_time` * `update_time`

        filter

          Type: string

          Description: An expression for filtering the results of the request. For field names both snake_case and camelCase are supported. * `display_name`: supports = and != * `metadata_schema_uri`: supports = and != * `labels` supports general map functions that is: * `labels.key=value` - key:value equality * `labels.key:* or labels:key - key existence * A key including a space must be quoted. `labels."a key"`. Some examples: * `displayName="myDisplayName"` * `labels.myKey="myValue"`

          Location: query

        pageToken

          Description: The standard list page token.

          Type: string

          Location: query

      Path: v1beta1/datasets

      Description: Lists Datasets in a Location.

      HTTP Method: GET

      Flat Path: v1beta1/datasets

  • aiplatform.datasets.datasetVersions.create

      Flat Path: v1beta1/datasets/{datasetsId}/datasetVersions

      HTTP Method: POST

      Parameter Order: parent

      Parameters:

        parent

          Description: Required. The name of the Dataset resource. Format: `projects/{project}/locations/{location}/datasets/{dataset}`

          Pattern: ^datasets/[^/]+$

          Type: string

          Required: Yes

          Location: path

      Description: Create a version from a Dataset.

      Scopes: https://www.googleapis.com/auth/cloud-platform

      Path: v1beta1/{+parent}/datasetVersions

  • aiplatform.datasets.datasetVersions.list

      Description: Lists DatasetVersions in a Dataset.

      HTTP Method: GET

      Parameter Order: parent

      Parameters:

        parent

          Location: path

          Description: Required. The resource name of the Dataset to list DatasetVersions from. Format: `projects/{project}/locations/{location}/datasets/{dataset}`

          Pattern: ^datasets/[^/]+$

          Required: Yes

          Type: string

        pageToken

          Description: Optional. The standard list page token.

          Location: query

          Type: string

        pageSize

          Description: Optional. The standard list page size.

          Type: integer

          Location: query

          Format: int32

        readMask

          Format: google-fieldmask

          Type: string

          Location: query

          Description: Optional. Mask specifying which fields to read.

        orderBy

          Location: query

          Type: string

          Description: Optional. A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending.

        filter

          Location: query

          Type: string

          Description: Optional. The standard list filter.

      Flat Path: v1beta1/datasets/{datasetsId}/datasetVersions

      Scopes: https://www.googleapis.com/auth/cloud-platform

      Path: v1beta1/{+parent}/datasetVersions

  • aiplatform.datasets.datasetVersions.patch

      Flat Path: v1beta1/datasets/{datasetsId}/datasetVersions/{datasetVersionsId}

      HTTP Method: PATCH

      Parameter Order: name

      Scopes: https://www.googleapis.com/auth/cloud-platform

      Description: Updates a DatasetVersion.

      Path: v1beta1/{+name}

      Parameters:

        updateMask

          Description: Required. The update mask applies to the resource. For the `FieldMask` definition, see google.protobuf.FieldMask. Updatable fields: * `display_name`

          Location: query

          Format: google-fieldmask

          Type: string

        name

          Pattern: ^datasets/[^/]+/datasetVersions/[^/]+$

          Type: string

          Required: Yes

          Description: Output only. Identifier. The resource name of the DatasetVersion.

          Location: path

  • aiplatform.datasets.datasetVersions.get

      Flat Path: v1beta1/datasets/{datasetsId}/datasetVersions/{datasetVersionsId}

      HTTP Method: GET

      Parameters:

        readMask

          Location: query

          Type: string

          Description: Mask specifying which fields to read.

          Format: google-fieldmask

        name

          Location: path

          Pattern: ^datasets/[^/]+/datasetVersions/[^/]+$

          Description: Required. The resource name of the Dataset version to delete. Format: `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions/{dataset_version}`

          Type: string

          Required: Yes

      Scopes: https://www.googleapis.com/auth/cloud-platform

      Path: v1beta1/{+name}

      Parameter Order: name

      Description: Gets a Dataset version.

  • aiplatform.datasets.datasetVersions.restore

      Description: Restores a dataset version.

      Flat Path: v1beta1/datasets/{datasetsId}/datasetVersions/{datasetVersionsId}:restore

      Parameters:

        name

          Location: path

          Required: Yes

          Description: Required. The name of the DatasetVersion resource. Format: `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions/{dataset_version}`

          Type: string

          Pattern: ^datasets/[^/]+/datasetVersions/[^/]+$

      HTTP Method: GET

      Path: v1beta1/{+name}:restore

      Parameter Order: name

      Scopes: https://www.googleapis.com/auth/cloud-platform

  • aiplatform.datasets.datasetVersions.delete

      Parameters:

        name

          Location: path

          Pattern: ^datasets/[^/]+/datasetVersions/[^/]+$

          Description: Required. The resource name of the Dataset version to delete. Format: `projects/{project}/locations/{location}/datasets/{dataset}/datasetVersions/{dataset_version}`

          Type: string

          Required: Yes

      Description: Deletes a Dataset version.

      Path: v1beta1/{+name}

      Flat Path: v1beta1/datasets/{datasetsId}/datasetVersions/{datasetVersionsId}

      HTTP Method: DELETE

      Parameter Order: name

      Scopes: https://www.googleapis.com/auth/cloud-platform

  • aiplatform.publishers.models.streamGenerateContent

      Parameter Order: model

      Description: Generate content with multimodal inputs with streaming support.

      HTTP Method: POST

      Path: v1beta1/{+model}:streamGenerateContent

      Parameters:

        model

          Description: Required. The fully qualified name of the publisher model or tuned model endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}`

          Pattern: ^publishers/[^/]+/models/[^/]+$

          Type: string

          Location: path

          Required: Yes

      Flat Path: v1beta1/publishers/{publishersId}/models/{modelsId}:streamGenerateContent

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/cloud-platform.read-only
  • aiplatform.publishers.models.generateContent

      Parameter Order: model

      Path: v1beta1/{+model}:generateContent

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/cloud-platform.read-only
    • Parameters:

        model

          Description: Required. The fully qualified name of the publisher model or tuned model endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}`

          Type: string

          Location: path

          Required: Yes

          Pattern: ^publishers/[^/]+/models/[^/]+$

      HTTP Method: POST

      Description: Generate content with multimodal inputs.

      Flat Path: v1beta1/publishers/{publishersId}/models/{modelsId}:generateContent

  • aiplatform.publishers.models.countTokens

      Parameter Order: endpoint

      Description: Perform a token counting.

      Path: v1beta1/{+endpoint}:countTokens

      Flat Path: v1beta1/publishers/{publishersId}/models/{modelsId}:countTokens

      HTTP Method: POST

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/cloud-platform.read-only
    • Parameters:

        endpoint

          Required: Yes

          Description: Required. The name of the Endpoint requested to perform token counting. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`

          Pattern: ^publishers/[^/]+/models/[^/]+$

          Type: string

          Location: path

  • aiplatform.publishers.models.computeTokens

      Parameter Order: endpoint

      Parameters:

        endpoint

          Required: Yes

          Type: string

          Location: path

          Pattern: ^publishers/[^/]+/models/[^/]+$

          Description: Required. The name of the Endpoint requested to get lists of tokens and token ids.

      Scopes: https://www.googleapis.com/auth/cloud-platform

      Flat Path: v1beta1/publishers/{publishersId}/models/{modelsId}:computeTokens

      Path: v1beta1/{+endpoint}:computeTokens

      HTTP Method: POST

      Description: Return a list of tokens based on the input text.

  • aiplatform.endpoints.computeTokens

      Parameters:

        endpoint

          Location: path

          Type: string

          Required: Yes

          Pattern: ^endpoints/[^/]+$

          Description: Required. The name of the Endpoint requested to get lists of tokens and token ids.

      Description: Return a list of tokens based on the input text.

      HTTP Method: POST

      Parameter Order: endpoint

      Flat Path: v1beta1/endpoints/{endpointsId}:computeTokens

      Path: v1beta1/{+endpoint}:computeTokens

      Scopes: https://www.googleapis.com/auth/cloud-platform

  • aiplatform.endpoints.generateContent

      Parameter Order: model

      HTTP Method: POST

      Flat Path: v1beta1/endpoints/{endpointsId}:generateContent

      Parameters:

        model

          Type: string

          Pattern: ^endpoints/[^/]+$

          Required: Yes

          Description: Required. The fully qualified name of the publisher model or tuned model endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}`

          Location: path

      Description: Generate content with multimodal inputs.

      Path: v1beta1/{+model}:generateContent

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/cloud-platform.read-only
  • aiplatform.endpoints.countTokens

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/cloud-platform.read-only
    • HTTP Method: POST

      Description: Perform a token counting.

      Path: v1beta1/{+endpoint}:countTokens

      Parameter Order: endpoint

      Flat Path: v1beta1/endpoints/{endpointsId}:countTokens

      Parameters:

        endpoint

          Required: Yes

          Description: Required. The name of the Endpoint requested to perform token counting. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}`

          Location: path

          Type: string

          Pattern: ^endpoints/[^/]+$

  • aiplatform.endpoints.streamGenerateContent

      HTTP Method: POST

      Parameters:

        model

          Description: Required. The fully qualified name of the publisher model or tuned model endpoint to use. Publisher model format: `projects/{project}/locations/{location}/publishers/*/models/*` Tuned model endpoint format: `projects/{project}/locations/{location}/endpoints/{endpoint}`

          Type: string

          Required: Yes

          Location: path

          Pattern: ^endpoints/[^/]+$

      Description: Generate content with multimodal inputs with streaming support.

      Scopes:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/cloud-platform.read-only
    • Flat Path: v1beta1/endpoints/{endpointsId}:streamGenerateContent

      Parameter Order: model

      Path: v1beta1/{+model}:streamGenerateContent