Reference documentation and code samples for the Cloud PubSub Client class Schema.
Represents a Pub/Sub Schema resource.
Schema Support for Cloud Pub/Sub allows you to register schemas in common formats as standalone versioned resources, associates schemas with Pub/Sub topics, validates message structure on-publish, and provides APIs parameterized on your entity types.
Example:
use Google\Cloud\PubSub\PubSubClient; $client = new PubSubClient(['projectId' => 'my-project']); $schema = $client->schema('my-schema');
Namespace
Google \ Cloud \ PubSubMethods
__construct
Parameters | |
---|---|
Name | Description |
requestHandler | Google\Cloud\Core\RequestHandler |
serializer | Google\ApiCore\Serializer The serializer instance to encode/decode messages. |
name | string The schema name. |
info | array [optional] Schema data. |
name
Get the schema resource name.
Example:
$name = $schema->name();
Returns | |
---|---|
Type | Description |
string |
delete
Delete the schema.
Example:
$schema->delete();
Parameter | |
---|---|
Name | Description |
options | array [optional] Configuration options |
Returns | |
---|---|
Type | Description |
void |
info
Get schema information.
Since this method will throw an exception if the schema is not found, you may find that Schema::exists() is a better fit for a true/false check.
This method will use the previously cached result, if available. To force a refresh from the API, use Schema::reload().
Example:
$info = $schema->info(); echo $info['name']; // projects/my-awesome-project/schemas/my-schema
Parameters | |
---|---|
Name | Description |
options | array Configuration Options |
↳ view | string The set of Schema fields to return in the response. If not set, returns Schemas with |
Returns | |
---|---|
Type | Description |
array |
reload
Get schema information from the API.
Since this method will throw an exception if the schema is not found, you may find that Schema::exists() is a better fit for a true/false check.
This method will retrieve a new result from the API. To use a previously cached result, if one exists, use Schema::info().
Example:
$info = $schema->reload(); echo $info['name']; // projects/my-awesome-project/schemas/my-schema
Parameters | |
---|---|
Name | Description |
options | array Configuration Options |
↳ view | string The set of Schema fields to return in the response. If not set, returns Schemas with |
Returns | |
---|---|
Type | Description |
array |
exists
Check if a schema exists.
Example:
if ($schema->exists()) { echo 'Schema exists'; }
Parameter | |
---|---|
Name | Description |
options | array [optional] Configuration Options |
Returns | |
---|---|
Type | Description |
bool |
listRevisions
See also:
Parameter | |
---|---|
Name | Description |
options | array [optional] Configuration Options |
Returns | |
---|---|
Type | Description |
array |
commit
See also:
Parameters | |
---|---|
Name | Description |
definition | string The definition of the schema. This should contain a string representing the full definition of the schema that is a valid schema definition of the type specified in |
type | string The schema type. Allowed values are |
options | array [optional] Configuration options |
Returns | |
---|---|
Type | Description |
array | revision created |
deleteRevision
See also:
Parameters | |
---|---|
Name | Description |
revisionId | string The revisionId |
options | mixed |
Returns | |
---|---|
Type | Description |
array | deleted revision |