Method: projects.locations.metadataStores.metadataSchemas.create

Creates a MetadataSchema.

HTTP request

POST https://{service-endpoint}/v1beta1/{parent}/metadataSchemas

Where {service-endpoint} is one of the supported service endpoints.

Path parameters



Required. The resource name of the MetadataStore where the MetadataSchema should be created. Format: projects/{project}/locations/{location}/metadataStores/{metadatastore}

Query parameters



The {metadataSchema} portion of the resource name with the format: projects/{project}/locations/{location}/metadataStores/{metadatastore}/metadataSchemas/{metadataschema} If not provided, the MetadataStore's id will be a UUID generated by the service. Must be 4-128 characters in length. Valid characters are /[a-z][0-9]-/. Must be unique across all MetadataSchemas in the parent Location. (Otherwise the request will fail with ALREADY_EXISTS, or PERMISSION_DENIED if the caller can't view the preexisting MetadataSchema.)

Request body

The request body contains an instance of MetadataSchema.

Response body

If successful, the response body contains a newly created instance of MetadataSchema.

Authorization scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permission on the parent resource:

  • aiplatform.metadataSchemas.create

For more information, see the IAM documentation.