1<?php
2/*
3 * Copyright 2014 Google Inc.
4 *
5 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
6 * use this file except in compliance with the License. You may obtain a copy of
7 * the License at
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
13 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
14 * License for the specific language governing permissions and limitations under
15 * the License.
16 */
17
18namespace Google\Service\DataCatalog\Resource;
19
20use Google\Service\DataCatalog\GoogleCloudDatacatalogV1Entry;
21
22/**
23 * The "entries" collection of methods.
24 * Typical usage is:
25 *  <code>
26 *   $datacatalogService = new Google\Service\DataCatalog(...);
27 *   $entries = $datacatalogService->entries;
28 *  </code>
29 */
30class Entries extends \Google\Service\Resource
31{
32  /**
33   * Gets an entry by its target resource name. The resource name comes from the
34   * source Google Cloud Platform service. (entries.lookup)
35   *
36   * @param array $optParams Optional parameters.
37   *
38   * @opt_param string fullyQualifiedName Fully qualified name (FQN) of the
39   * resource. FQNs take two forms: * For non-regionalized resources:
40   * `{SYSTEM}:{PROJECT}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}` * For
41   * regionalized resources:
42   * `{SYSTEM}:{PROJECT}.{LOCATION_ID}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}`
43   * Example for a DPMS table: `dataproc_metastore:{PROJECT_ID}.{LOCATION_ID}.{INS
44   * TANCE_ID}.{DATABASE_ID}.{TABLE_ID}`
45   * @opt_param string linkedResource The full name of the Google Cloud Platform
46   * resource the Data Catalog entry represents. For more information, see [Full
47   * Resource Name]
48   * (https://cloud.google.com/apis/design/resource_names#full_resource_name).
49   * Full names are case-sensitive. For example: * `//bigquery.googleapis.com/proj
50   * ects/{PROJECT_ID}/datasets/{DATASET_ID}/tables/{TABLE_ID}` *
51   * `//pubsub.googleapis.com/projects/{PROJECT_ID}/topics/{TOPIC_ID}`
52   * @opt_param string sqlResource The SQL name of the entry. SQL names are case-
53   * sensitive. Examples: * `pubsub.topic.{PROJECT_ID}.{TOPIC_ID}` *
54   * `pubsub.topic.{PROJECT_ID}.`\``{TOPIC.ID.SEPARATED.WITH.DOTS}`\` *
55   * `bigquery.table.{PROJECT_ID}.{DATASET_ID}.{TABLE_ID}` *
56   * `bigquery.dataset.{PROJECT_ID}.{DATASET_ID}` *
57   * `datacatalog.entry.{PROJECT_ID}.{LOCATION_ID}.{ENTRY_GROUP_ID}.{ENTRY_ID}`
58   * Identifiers (`*_ID`) should comply with the [Lexical structure in Standard
59   * SQL] (https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical).
60   * @return GoogleCloudDatacatalogV1Entry
61   */
62  public function lookup($optParams = [])
63  {
64    $params = [];
65    $params = array_merge($params, $optParams);
66    return $this->call('lookup', [$params], GoogleCloudDatacatalogV1Entry::class);
67  }
68}
69
70// Adding a class alias for backwards compatibility with the previous class name.
71class_alias(Entries::class, 'Google_Service_DataCatalog_Resource_Entries');
72