google-apis-managedkafka_v1 0.6.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1658,6 +1658,1716 @@ module Google
1658
1658
  command.query['quotaUser'] = quota_user unless quota_user.nil?
1659
1659
  execute_or_queue_command(command, &block)
1660
1660
  end
1661
+
1662
+ # Create a schema registry instance.
1663
+ # @param [String] parent
1664
+ # Required. The parent whose schema registry instance is to be created.
1665
+ # Structured like: `projects/`project`/locations/`location``
1666
+ # @param [Google::Apis::ManagedkafkaV1::CreateSchemaRegistryRequest] create_schema_registry_request_object
1667
+ # @param [String] fields
1668
+ # Selector specifying which fields to include in a partial response.
1669
+ # @param [String] quota_user
1670
+ # Available to use for quota purposes for server-side applications. Can be any
1671
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1672
+ # @param [Google::Apis::RequestOptions] options
1673
+ # Request-specific options
1674
+ #
1675
+ # @yield [result, err] Result & error if block supplied
1676
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::SchemaRegistry] parsed result object
1677
+ # @yieldparam err [StandardError] error object if request failed
1678
+ #
1679
+ # @return [Google::Apis::ManagedkafkaV1::SchemaRegistry]
1680
+ #
1681
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1682
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1683
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1684
+ def create_schema_registry(parent, create_schema_registry_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1685
+ command = make_simple_command(:post, 'v1/{+parent}/schemaRegistries', options)
1686
+ command.request_representation = Google::Apis::ManagedkafkaV1::CreateSchemaRegistryRequest::Representation
1687
+ command.request_object = create_schema_registry_request_object
1688
+ command.response_representation = Google::Apis::ManagedkafkaV1::SchemaRegistry::Representation
1689
+ command.response_class = Google::Apis::ManagedkafkaV1::SchemaRegistry
1690
+ command.params['parent'] = parent unless parent.nil?
1691
+ command.query['fields'] = fields unless fields.nil?
1692
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1693
+ execute_or_queue_command(command, &block)
1694
+ end
1695
+
1696
+ # Delete a schema registry instance.
1697
+ # @param [String] name
1698
+ # Required. The name of the schema registry instance to delete. Structured like:
1699
+ # `projects/`project`/locations/`location`/schemaRegistries/`schema_registry``
1700
+ # @param [String] fields
1701
+ # Selector specifying which fields to include in a partial response.
1702
+ # @param [String] quota_user
1703
+ # Available to use for quota purposes for server-side applications. Can be any
1704
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1705
+ # @param [Google::Apis::RequestOptions] options
1706
+ # Request-specific options
1707
+ #
1708
+ # @yield [result, err] Result & error if block supplied
1709
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::Empty] parsed result object
1710
+ # @yieldparam err [StandardError] error object if request failed
1711
+ #
1712
+ # @return [Google::Apis::ManagedkafkaV1::Empty]
1713
+ #
1714
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1715
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1716
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1717
+ def delete_project_location_schema_registry(name, fields: nil, quota_user: nil, options: nil, &block)
1718
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1719
+ command.response_representation = Google::Apis::ManagedkafkaV1::Empty::Representation
1720
+ command.response_class = Google::Apis::ManagedkafkaV1::Empty
1721
+ command.params['name'] = name unless name.nil?
1722
+ command.query['fields'] = fields unless fields.nil?
1723
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1724
+ execute_or_queue_command(command, &block)
1725
+ end
1726
+
1727
+ # Get the schema registry instance.
1728
+ # @param [String] name
1729
+ # Required. The name of the schema registry instance to return. Structured like:
1730
+ # `projects/`project`/locations/`location`/schemaRegistries/`schema_registry``
1731
+ # @param [String] fields
1732
+ # Selector specifying which fields to include in a partial response.
1733
+ # @param [String] quota_user
1734
+ # Available to use for quota purposes for server-side applications. Can be any
1735
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1736
+ # @param [Google::Apis::RequestOptions] options
1737
+ # Request-specific options
1738
+ #
1739
+ # @yield [result, err] Result & error if block supplied
1740
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::SchemaRegistry] parsed result object
1741
+ # @yieldparam err [StandardError] error object if request failed
1742
+ #
1743
+ # @return [Google::Apis::ManagedkafkaV1::SchemaRegistry]
1744
+ #
1745
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1746
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1747
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1748
+ def get_project_location_schema_registry(name, fields: nil, quota_user: nil, options: nil, &block)
1749
+ command = make_simple_command(:get, 'v1/{+name}', options)
1750
+ command.response_representation = Google::Apis::ManagedkafkaV1::SchemaRegistry::Representation
1751
+ command.response_class = Google::Apis::ManagedkafkaV1::SchemaRegistry
1752
+ command.params['name'] = name unless name.nil?
1753
+ command.query['fields'] = fields unless fields.nil?
1754
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1755
+ execute_or_queue_command(command, &block)
1756
+ end
1757
+
1758
+ # List schema registries.
1759
+ # @param [String] parent
1760
+ # Required. The parent whose schema registry instances are to be listed.
1761
+ # Structured like: `projects/`project`/locations/`location``
1762
+ # @param [String] fields
1763
+ # Selector specifying which fields to include in a partial response.
1764
+ # @param [String] quota_user
1765
+ # Available to use for quota purposes for server-side applications. Can be any
1766
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1767
+ # @param [Google::Apis::RequestOptions] options
1768
+ # Request-specific options
1769
+ #
1770
+ # @yield [result, err] Result & error if block supplied
1771
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::ListSchemaRegistriesResponse] parsed result object
1772
+ # @yieldparam err [StandardError] error object if request failed
1773
+ #
1774
+ # @return [Google::Apis::ManagedkafkaV1::ListSchemaRegistriesResponse]
1775
+ #
1776
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1777
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1778
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1779
+ def list_project_location_schema_registries(parent, fields: nil, quota_user: nil, options: nil, &block)
1780
+ command = make_simple_command(:get, 'v1/{+parent}/schemaRegistries', options)
1781
+ command.response_representation = Google::Apis::ManagedkafkaV1::ListSchemaRegistriesResponse::Representation
1782
+ command.response_class = Google::Apis::ManagedkafkaV1::ListSchemaRegistriesResponse
1783
+ command.params['parent'] = parent unless parent.nil?
1784
+ command.query['fields'] = fields unless fields.nil?
1785
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1786
+ execute_or_queue_command(command, &block)
1787
+ end
1788
+
1789
+ # Check compatibility of a schema with all versions or a specific version of a
1790
+ # subject.
1791
+ # @param [String] name
1792
+ # Required. The name of the resource to check compatibility for. The format is
1793
+ # either of following: * projects/`project`/locations/`location`/
1794
+ # schemaRegistries/`schema_registry`/compatibility/subjects/*/versions: Check
1795
+ # compatibility with one or more versions of the specified subject. * projects/`
1796
+ # project`/locations/`location`/schemaRegistries/`schema_registry`/compatibility/
1797
+ # subjects/`subject`/versions/`version`: Check compatibility with a specific
1798
+ # version of the subject.
1799
+ # @param [Google::Apis::ManagedkafkaV1::CheckCompatibilityRequest] check_compatibility_request_object
1800
+ # @param [String] fields
1801
+ # Selector specifying which fields to include in a partial response.
1802
+ # @param [String] quota_user
1803
+ # Available to use for quota purposes for server-side applications. Can be any
1804
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1805
+ # @param [Google::Apis::RequestOptions] options
1806
+ # Request-specific options
1807
+ #
1808
+ # @yield [result, err] Result & error if block supplied
1809
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::CheckCompatibilityResponse] parsed result object
1810
+ # @yieldparam err [StandardError] error object if request failed
1811
+ #
1812
+ # @return [Google::Apis::ManagedkafkaV1::CheckCompatibilityResponse]
1813
+ #
1814
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1815
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1816
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1817
+ def check_project_location_schema_registry_compatibility_compatibility(name, check_compatibility_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1818
+ command = make_simple_command(:post, 'v1/{+name}', options)
1819
+ command.request_representation = Google::Apis::ManagedkafkaV1::CheckCompatibilityRequest::Representation
1820
+ command.request_object = check_compatibility_request_object
1821
+ command.response_representation = Google::Apis::ManagedkafkaV1::CheckCompatibilityResponse::Representation
1822
+ command.response_class = Google::Apis::ManagedkafkaV1::CheckCompatibilityResponse
1823
+ command.params['name'] = name unless name.nil?
1824
+ command.query['fields'] = fields unless fields.nil?
1825
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1826
+ execute_or_queue_command(command, &block)
1827
+ end
1828
+
1829
+ # Delete schema config for a subject.
1830
+ # @param [String] name
1831
+ # Required. The resource name of subject to delete the config for. The format is
1832
+ # * projects/`project`/locations/`location`/schemaRegistries/`schema_registry`/
1833
+ # config/`subject`
1834
+ # @param [String] fields
1835
+ # Selector specifying which fields to include in a partial response.
1836
+ # @param [String] quota_user
1837
+ # Available to use for quota purposes for server-side applications. Can be any
1838
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1839
+ # @param [Google::Apis::RequestOptions] options
1840
+ # Request-specific options
1841
+ #
1842
+ # @yield [result, err] Result & error if block supplied
1843
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::SchemaConfig] parsed result object
1844
+ # @yieldparam err [StandardError] error object if request failed
1845
+ #
1846
+ # @return [Google::Apis::ManagedkafkaV1::SchemaConfig]
1847
+ #
1848
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1849
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1850
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1851
+ def delete_project_location_schema_registry_config(name, fields: nil, quota_user: nil, options: nil, &block)
1852
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1853
+ command.response_representation = Google::Apis::ManagedkafkaV1::SchemaConfig::Representation
1854
+ command.response_class = Google::Apis::ManagedkafkaV1::SchemaConfig
1855
+ command.params['name'] = name unless name.nil?
1856
+ command.query['fields'] = fields unless fields.nil?
1857
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1858
+ execute_or_queue_command(command, &block)
1859
+ end
1860
+
1861
+ # Get schema config at global level or for a subject.
1862
+ # @param [String] name
1863
+ # Required. The resource name to get the config for. It can be either of
1864
+ # following: * projects/`project`/locations/`location`/schemaRegistries/`
1865
+ # schema_registry`/config: Get config at global level. * projects/`project`/
1866
+ # locations/`location`/schemaRegistries/`schema_registry`/config/`subject`: Get
1867
+ # config for a specific subject.
1868
+ # @param [Boolean] default_to_global
1869
+ # Optional. If true, the config will fall back to the config at the global level
1870
+ # if no subject level config is found.
1871
+ # @param [String] fields
1872
+ # Selector specifying which fields to include in a partial response.
1873
+ # @param [String] quota_user
1874
+ # Available to use for quota purposes for server-side applications. Can be any
1875
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1876
+ # @param [Google::Apis::RequestOptions] options
1877
+ # Request-specific options
1878
+ #
1879
+ # @yield [result, err] Result & error if block supplied
1880
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::SchemaConfig] parsed result object
1881
+ # @yieldparam err [StandardError] error object if request failed
1882
+ #
1883
+ # @return [Google::Apis::ManagedkafkaV1::SchemaConfig]
1884
+ #
1885
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1886
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1887
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1888
+ def get_project_location_schema_registry_config(name, default_to_global: nil, fields: nil, quota_user: nil, options: nil, &block)
1889
+ command = make_simple_command(:get, 'v1/{+name}', options)
1890
+ command.response_representation = Google::Apis::ManagedkafkaV1::SchemaConfig::Representation
1891
+ command.response_class = Google::Apis::ManagedkafkaV1::SchemaConfig
1892
+ command.params['name'] = name unless name.nil?
1893
+ command.query['defaultToGlobal'] = default_to_global unless default_to_global.nil?
1894
+ command.query['fields'] = fields unless fields.nil?
1895
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1896
+ execute_or_queue_command(command, &block)
1897
+ end
1898
+
1899
+ # Update config at global level or for a subject. Creates a SchemaSubject-level
1900
+ # SchemaConfig if it does not exist.
1901
+ # @param [String] name
1902
+ # Required. The resource name to update the config for. It can be either of
1903
+ # following: * projects/`project`/locations/`location`/schemaRegistries/`
1904
+ # schema_registry`/config: Update config at global level. * projects/`project`/
1905
+ # locations/`location`/schemaRegistries/`schema_registry`/config/`subject`:
1906
+ # Update config for a specific subject.
1907
+ # @param [Google::Apis::ManagedkafkaV1::UpdateSchemaConfigRequest] update_schema_config_request_object
1908
+ # @param [String] fields
1909
+ # Selector specifying which fields to include in a partial response.
1910
+ # @param [String] quota_user
1911
+ # Available to use for quota purposes for server-side applications. Can be any
1912
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1913
+ # @param [Google::Apis::RequestOptions] options
1914
+ # Request-specific options
1915
+ #
1916
+ # @yield [result, err] Result & error if block supplied
1917
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::SchemaConfig] parsed result object
1918
+ # @yieldparam err [StandardError] error object if request failed
1919
+ #
1920
+ # @return [Google::Apis::ManagedkafkaV1::SchemaConfig]
1921
+ #
1922
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1923
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1924
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1925
+ def update_project_location_schema_registry_config(name, update_schema_config_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1926
+ command = make_simple_command(:put, 'v1/{+name}', options)
1927
+ command.request_representation = Google::Apis::ManagedkafkaV1::UpdateSchemaConfigRequest::Representation
1928
+ command.request_object = update_schema_config_request_object
1929
+ command.response_representation = Google::Apis::ManagedkafkaV1::SchemaConfig::Representation
1930
+ command.response_class = Google::Apis::ManagedkafkaV1::SchemaConfig
1931
+ command.params['name'] = name unless name.nil?
1932
+ command.query['fields'] = fields unless fields.nil?
1933
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1934
+ execute_or_queue_command(command, &block)
1935
+ end
1936
+
1937
+ # Get the context.
1938
+ # @param [String] name
1939
+ # Required. The name of the context to return. Structured like: `projects/`
1940
+ # project`/locations/`location`/schemaRegistries/`schema_registry`/contexts/`
1941
+ # context``
1942
+ # @param [String] fields
1943
+ # Selector specifying which fields to include in a partial response.
1944
+ # @param [String] quota_user
1945
+ # Available to use for quota purposes for server-side applications. Can be any
1946
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1947
+ # @param [Google::Apis::RequestOptions] options
1948
+ # Request-specific options
1949
+ #
1950
+ # @yield [result, err] Result & error if block supplied
1951
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::Context] parsed result object
1952
+ # @yieldparam err [StandardError] error object if request failed
1953
+ #
1954
+ # @return [Google::Apis::ManagedkafkaV1::Context]
1955
+ #
1956
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1957
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1958
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1959
+ def get_project_location_schema_registry_context(name, fields: nil, quota_user: nil, options: nil, &block)
1960
+ command = make_simple_command(:get, 'v1/{+name}', options)
1961
+ command.response_representation = Google::Apis::ManagedkafkaV1::Context::Representation
1962
+ command.response_class = Google::Apis::ManagedkafkaV1::Context
1963
+ command.params['name'] = name unless name.nil?
1964
+ command.query['fields'] = fields unless fields.nil?
1965
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1966
+ execute_or_queue_command(command, &block)
1967
+ end
1968
+
1969
+ # List contexts for a schema registry.
1970
+ # @param [String] parent
1971
+ # Required. The parent of the contexts. Structured like: `projects/`project`/
1972
+ # locations/`location`/schemaRegistries/`schema_registry``
1973
+ # @param [String] fields
1974
+ # Selector specifying which fields to include in a partial response.
1975
+ # @param [String] quota_user
1976
+ # Available to use for quota purposes for server-side applications. Can be any
1977
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1978
+ # @param [Google::Apis::RequestOptions] options
1979
+ # Request-specific options
1980
+ #
1981
+ # @yield [result, err] Result & error if block supplied
1982
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::HttpBody] parsed result object
1983
+ # @yieldparam err [StandardError] error object if request failed
1984
+ #
1985
+ # @return [Google::Apis::ManagedkafkaV1::HttpBody]
1986
+ #
1987
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1988
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1989
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1990
+ def list_project_location_schema_registry_contexts(parent, fields: nil, quota_user: nil, options: nil, &block)
1991
+ command = make_simple_command(:get, 'v1/{+parent}/contexts', options)
1992
+ command.response_representation = Google::Apis::ManagedkafkaV1::HttpBody::Representation
1993
+ command.response_class = Google::Apis::ManagedkafkaV1::HttpBody
1994
+ command.params['parent'] = parent unless parent.nil?
1995
+ command.query['fields'] = fields unless fields.nil?
1996
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1997
+ execute_or_queue_command(command, &block)
1998
+ end
1999
+
2000
+ # Check compatibility of a schema with all versions or a specific version of a
2001
+ # subject.
2002
+ # @param [String] name
2003
+ # Required. The name of the resource to check compatibility for. The format is
2004
+ # either of following: * projects/`project`/locations/`location`/
2005
+ # schemaRegistries/`schema_registry`/compatibility/subjects/*/versions: Check
2006
+ # compatibility with one or more versions of the specified subject. * projects/`
2007
+ # project`/locations/`location`/schemaRegistries/`schema_registry`/compatibility/
2008
+ # subjects/`subject`/versions/`version`: Check compatibility with a specific
2009
+ # version of the subject.
2010
+ # @param [Google::Apis::ManagedkafkaV1::CheckCompatibilityRequest] check_compatibility_request_object
2011
+ # @param [String] fields
2012
+ # Selector specifying which fields to include in a partial response.
2013
+ # @param [String] quota_user
2014
+ # Available to use for quota purposes for server-side applications. Can be any
2015
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2016
+ # @param [Google::Apis::RequestOptions] options
2017
+ # Request-specific options
2018
+ #
2019
+ # @yield [result, err] Result & error if block supplied
2020
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::CheckCompatibilityResponse] parsed result object
2021
+ # @yieldparam err [StandardError] error object if request failed
2022
+ #
2023
+ # @return [Google::Apis::ManagedkafkaV1::CheckCompatibilityResponse]
2024
+ #
2025
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2026
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2027
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2028
+ def check_project_location_schema_registry_context_compatibility_compatibility(name, check_compatibility_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2029
+ command = make_simple_command(:post, 'v1/{+name}', options)
2030
+ command.request_representation = Google::Apis::ManagedkafkaV1::CheckCompatibilityRequest::Representation
2031
+ command.request_object = check_compatibility_request_object
2032
+ command.response_representation = Google::Apis::ManagedkafkaV1::CheckCompatibilityResponse::Representation
2033
+ command.response_class = Google::Apis::ManagedkafkaV1::CheckCompatibilityResponse
2034
+ command.params['name'] = name unless name.nil?
2035
+ command.query['fields'] = fields unless fields.nil?
2036
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2037
+ execute_or_queue_command(command, &block)
2038
+ end
2039
+
2040
+ # Delete schema config for a subject.
2041
+ # @param [String] name
2042
+ # Required. The resource name of subject to delete the config for. The format is
2043
+ # * projects/`project`/locations/`location`/schemaRegistries/`schema_registry`/
2044
+ # config/`subject`
2045
+ # @param [String] fields
2046
+ # Selector specifying which fields to include in a partial response.
2047
+ # @param [String] quota_user
2048
+ # Available to use for quota purposes for server-side applications. Can be any
2049
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2050
+ # @param [Google::Apis::RequestOptions] options
2051
+ # Request-specific options
2052
+ #
2053
+ # @yield [result, err] Result & error if block supplied
2054
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::SchemaConfig] parsed result object
2055
+ # @yieldparam err [StandardError] error object if request failed
2056
+ #
2057
+ # @return [Google::Apis::ManagedkafkaV1::SchemaConfig]
2058
+ #
2059
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2060
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2061
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2062
+ def delete_project_location_schema_registry_context_config(name, fields: nil, quota_user: nil, options: nil, &block)
2063
+ command = make_simple_command(:delete, 'v1/{+name}', options)
2064
+ command.response_representation = Google::Apis::ManagedkafkaV1::SchemaConfig::Representation
2065
+ command.response_class = Google::Apis::ManagedkafkaV1::SchemaConfig
2066
+ command.params['name'] = name unless name.nil?
2067
+ command.query['fields'] = fields unless fields.nil?
2068
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2069
+ execute_or_queue_command(command, &block)
2070
+ end
2071
+
2072
+ # Get schema config at global level or for a subject.
2073
+ # @param [String] name
2074
+ # Required. The resource name to get the config for. It can be either of
2075
+ # following: * projects/`project`/locations/`location`/schemaRegistries/`
2076
+ # schema_registry`/config: Get config at global level. * projects/`project`/
2077
+ # locations/`location`/schemaRegistries/`schema_registry`/config/`subject`: Get
2078
+ # config for a specific subject.
2079
+ # @param [Boolean] default_to_global
2080
+ # Optional. If true, the config will fall back to the config at the global level
2081
+ # if no subject level config is found.
2082
+ # @param [String] fields
2083
+ # Selector specifying which fields to include in a partial response.
2084
+ # @param [String] quota_user
2085
+ # Available to use for quota purposes for server-side applications. Can be any
2086
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2087
+ # @param [Google::Apis::RequestOptions] options
2088
+ # Request-specific options
2089
+ #
2090
+ # @yield [result, err] Result & error if block supplied
2091
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::SchemaConfig] parsed result object
2092
+ # @yieldparam err [StandardError] error object if request failed
2093
+ #
2094
+ # @return [Google::Apis::ManagedkafkaV1::SchemaConfig]
2095
+ #
2096
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2097
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2098
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2099
+ def get_project_location_schema_registry_context_config(name, default_to_global: nil, fields: nil, quota_user: nil, options: nil, &block)
2100
+ command = make_simple_command(:get, 'v1/{+name}', options)
2101
+ command.response_representation = Google::Apis::ManagedkafkaV1::SchemaConfig::Representation
2102
+ command.response_class = Google::Apis::ManagedkafkaV1::SchemaConfig
2103
+ command.params['name'] = name unless name.nil?
2104
+ command.query['defaultToGlobal'] = default_to_global unless default_to_global.nil?
2105
+ command.query['fields'] = fields unless fields.nil?
2106
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2107
+ execute_or_queue_command(command, &block)
2108
+ end
2109
+
2110
+ # Update config at global level or for a subject. Creates a SchemaSubject-level
2111
+ # SchemaConfig if it does not exist.
2112
+ # @param [String] name
2113
+ # Required. The resource name to update the config for. It can be either of
2114
+ # following: * projects/`project`/locations/`location`/schemaRegistries/`
2115
+ # schema_registry`/config: Update config at global level. * projects/`project`/
2116
+ # locations/`location`/schemaRegistries/`schema_registry`/config/`subject`:
2117
+ # Update config for a specific subject.
2118
+ # @param [Google::Apis::ManagedkafkaV1::UpdateSchemaConfigRequest] update_schema_config_request_object
2119
+ # @param [String] fields
2120
+ # Selector specifying which fields to include in a partial response.
2121
+ # @param [String] quota_user
2122
+ # Available to use for quota purposes for server-side applications. Can be any
2123
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2124
+ # @param [Google::Apis::RequestOptions] options
2125
+ # Request-specific options
2126
+ #
2127
+ # @yield [result, err] Result & error if block supplied
2128
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::SchemaConfig] parsed result object
2129
+ # @yieldparam err [StandardError] error object if request failed
2130
+ #
2131
+ # @return [Google::Apis::ManagedkafkaV1::SchemaConfig]
2132
+ #
2133
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2134
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2135
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2136
+ def update_project_location_schema_registry_context_config(name, update_schema_config_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2137
+ command = make_simple_command(:put, 'v1/{+name}', options)
2138
+ command.request_representation = Google::Apis::ManagedkafkaV1::UpdateSchemaConfigRequest::Representation
2139
+ command.request_object = update_schema_config_request_object
2140
+ command.response_representation = Google::Apis::ManagedkafkaV1::SchemaConfig::Representation
2141
+ command.response_class = Google::Apis::ManagedkafkaV1::SchemaConfig
2142
+ command.params['name'] = name unless name.nil?
2143
+ command.query['fields'] = fields unless fields.nil?
2144
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2145
+ execute_or_queue_command(command, &block)
2146
+ end
2147
+
2148
+ # Get mode at global level or for a subject.
2149
+ # @param [String] name
2150
+ # Required. The resource name of the mode. The format is * projects/`project`/
2151
+ # locations/`location`/schemaRegistries/`schema_registry`/mode/`subject`: mode
2152
+ # for a schema registry, or * projects/`project`/locations/`location`/
2153
+ # schemaRegistries/`schema_registry`/contexts/`context`/mode/`subject`: mode for
2154
+ # a specific subject in a specific context
2155
+ # @param [String] fields
2156
+ # Selector specifying which fields to include in a partial response.
2157
+ # @param [String] quota_user
2158
+ # Available to use for quota purposes for server-side applications. Can be any
2159
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2160
+ # @param [Google::Apis::RequestOptions] options
2161
+ # Request-specific options
2162
+ #
2163
+ # @yield [result, err] Result & error if block supplied
2164
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::SchemaMode] parsed result object
2165
+ # @yieldparam err [StandardError] error object if request failed
2166
+ #
2167
+ # @return [Google::Apis::ManagedkafkaV1::SchemaMode]
2168
+ #
2169
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2170
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2171
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2172
+ def get_project_location_schema_registry_context_mode(name, fields: nil, quota_user: nil, options: nil, &block)
2173
+ command = make_simple_command(:get, 'v1/{+name}', options)
2174
+ command.response_representation = Google::Apis::ManagedkafkaV1::SchemaMode::Representation
2175
+ command.response_class = Google::Apis::ManagedkafkaV1::SchemaMode
2176
+ command.params['name'] = name unless name.nil?
2177
+ command.query['fields'] = fields unless fields.nil?
2178
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2179
+ execute_or_queue_command(command, &block)
2180
+ end
2181
+
2182
+ # Update mode at global level or for a subject.
2183
+ # @param [String] name
2184
+ # Required. The resource name of the mode. The format is * projects/`project`/
2185
+ # locations/`location`/schemaRegistries/`schema_registry`/mode/`subject`: mode
2186
+ # for a schema registry, or * projects/`project`/locations/`location`/
2187
+ # schemaRegistries/`schema_registry`/contexts/`context`/mode/`subject`: mode for
2188
+ # a specific subject in a specific context
2189
+ # @param [Google::Apis::ManagedkafkaV1::UpdateSchemaModeRequest] update_schema_mode_request_object
2190
+ # @param [String] fields
2191
+ # Selector specifying which fields to include in a partial response.
2192
+ # @param [String] quota_user
2193
+ # Available to use for quota purposes for server-side applications. Can be any
2194
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2195
+ # @param [Google::Apis::RequestOptions] options
2196
+ # Request-specific options
2197
+ #
2198
+ # @yield [result, err] Result & error if block supplied
2199
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::SchemaMode] parsed result object
2200
+ # @yieldparam err [StandardError] error object if request failed
2201
+ #
2202
+ # @return [Google::Apis::ManagedkafkaV1::SchemaMode]
2203
+ #
2204
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2205
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2206
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2207
+ def update_project_location_schema_registry_context_mode(name, update_schema_mode_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2208
+ command = make_simple_command(:put, 'v1/{+name}', options)
2209
+ command.request_representation = Google::Apis::ManagedkafkaV1::UpdateSchemaModeRequest::Representation
2210
+ command.request_object = update_schema_mode_request_object
2211
+ command.response_representation = Google::Apis::ManagedkafkaV1::SchemaMode::Representation
2212
+ command.response_class = Google::Apis::ManagedkafkaV1::SchemaMode
2213
+ command.params['name'] = name unless name.nil?
2214
+ command.query['fields'] = fields unless fields.nil?
2215
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2216
+ execute_or_queue_command(command, &block)
2217
+ end
2218
+
2219
+ # Get the schema for the given schema id.
2220
+ # @param [String] name
2221
+ # Required. The name of the schema to return. Structured like: `projects/`
2222
+ # project`/locations/`location`/schemaRegistries/`schema_registry`/schemas/ids/`
2223
+ # schema``
2224
+ # @param [String] subject
2225
+ # Optional. Used to limit the search for the schema ID to a specific subject,
2226
+ # otherwise the schema ID will be searched for in all subjects in the given
2227
+ # specified context.
2228
+ # @param [String] fields
2229
+ # Selector specifying which fields to include in a partial response.
2230
+ # @param [String] quota_user
2231
+ # Available to use for quota purposes for server-side applications. Can be any
2232
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2233
+ # @param [Google::Apis::RequestOptions] options
2234
+ # Request-specific options
2235
+ #
2236
+ # @yield [result, err] Result & error if block supplied
2237
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::Schema] parsed result object
2238
+ # @yieldparam err [StandardError] error object if request failed
2239
+ #
2240
+ # @return [Google::Apis::ManagedkafkaV1::Schema]
2241
+ #
2242
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2243
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2244
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2245
+ def get_project_location_schema_registry_context_schema(name, subject: nil, fields: nil, quota_user: nil, options: nil, &block)
2246
+ command = make_simple_command(:get, 'v1/{+name}', options)
2247
+ command.response_representation = Google::Apis::ManagedkafkaV1::Schema::Representation
2248
+ command.response_class = Google::Apis::ManagedkafkaV1::Schema
2249
+ command.params['name'] = name unless name.nil?
2250
+ command.query['subject'] = subject unless subject.nil?
2251
+ command.query['fields'] = fields unless fields.nil?
2252
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2253
+ execute_or_queue_command(command, &block)
2254
+ end
2255
+
2256
+ # Get the schema string for the given schema id. The response will be the schema
2257
+ # string.
2258
+ # @param [String] name
2259
+ # Required. The name of the schema to return. Structured like: `projects/`
2260
+ # project`/locations/`location`/schemaRegistries/`schema_registry`/schemas/ids/`
2261
+ # schema``
2262
+ # @param [String] subject
2263
+ # Optional. Used to limit the search for the schema ID to a specific subject,
2264
+ # otherwise the schema ID will be searched for in all subjects in the given
2265
+ # specified context.
2266
+ # @param [String] fields
2267
+ # Selector specifying which fields to include in a partial response.
2268
+ # @param [String] quota_user
2269
+ # Available to use for quota purposes for server-side applications. Can be any
2270
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2271
+ # @param [Google::Apis::RequestOptions] options
2272
+ # Request-specific options
2273
+ #
2274
+ # @yield [result, err] Result & error if block supplied
2275
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::HttpBody] parsed result object
2276
+ # @yieldparam err [StandardError] error object if request failed
2277
+ #
2278
+ # @return [Google::Apis::ManagedkafkaV1::HttpBody]
2279
+ #
2280
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2281
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2282
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2283
+ def get_project_location_schema_registry_context_schema_schema(name, subject: nil, fields: nil, quota_user: nil, options: nil, &block)
2284
+ command = make_simple_command(:get, 'v1/{+name}/schema', options)
2285
+ command.response_representation = Google::Apis::ManagedkafkaV1::HttpBody::Representation
2286
+ command.response_class = Google::Apis::ManagedkafkaV1::HttpBody
2287
+ command.params['name'] = name unless name.nil?
2288
+ command.query['subject'] = subject unless subject.nil?
2289
+ command.query['fields'] = fields unless fields.nil?
2290
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2291
+ execute_or_queue_command(command, &block)
2292
+ end
2293
+
2294
+ # List subjects which reference a particular schema id. The response will be an
2295
+ # array of subject names.
2296
+ # @param [String] parent
2297
+ # Required. The schema resource whose associated subjects are to be listed.
2298
+ # Structured like: `projects/`project`/locations/`location`/schemaRegistries/`
2299
+ # schema_registry`/schemas/ids/`schema`` or `projects/`project`/locations/`
2300
+ # location`/schemaRegistries/`schema_registry`/contexts/`context`/schemas/ids/`
2301
+ # schema``
2302
+ # @param [Boolean] deleted
2303
+ # Optional. If true, the response will include soft-deleted subjects. The
2304
+ # default is false.
2305
+ # @param [String] subject
2306
+ # Optional. The subject to filter the subjects by.
2307
+ # @param [String] fields
2308
+ # Selector specifying which fields to include in a partial response.
2309
+ # @param [String] quota_user
2310
+ # Available to use for quota purposes for server-side applications. Can be any
2311
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2312
+ # @param [Google::Apis::RequestOptions] options
2313
+ # Request-specific options
2314
+ #
2315
+ # @yield [result, err] Result & error if block supplied
2316
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::HttpBody] parsed result object
2317
+ # @yieldparam err [StandardError] error object if request failed
2318
+ #
2319
+ # @return [Google::Apis::ManagedkafkaV1::HttpBody]
2320
+ #
2321
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2322
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2323
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2324
+ def list_project_location_schema_registry_context_schema_subjects(parent, deleted: nil, subject: nil, fields: nil, quota_user: nil, options: nil, &block)
2325
+ command = make_simple_command(:get, 'v1/{+parent}/subjects', options)
2326
+ command.response_representation = Google::Apis::ManagedkafkaV1::HttpBody::Representation
2327
+ command.response_class = Google::Apis::ManagedkafkaV1::HttpBody
2328
+ command.params['parent'] = parent unless parent.nil?
2329
+ command.query['deleted'] = deleted unless deleted.nil?
2330
+ command.query['subject'] = subject unless subject.nil?
2331
+ command.query['fields'] = fields unless fields.nil?
2332
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2333
+ execute_or_queue_command(command, &block)
2334
+ end
2335
+
2336
+ # List the supported schema types. The response will be an array of schema types.
2337
+ # @param [String] parent
2338
+ # Required. The parent schema registry whose schema types are to be listed.
2339
+ # Structured like: `projects/`project`/locations/`location`/schemaRegistries/`
2340
+ # schema_registry``
2341
+ # @param [String] fields
2342
+ # Selector specifying which fields to include in a partial response.
2343
+ # @param [String] quota_user
2344
+ # Available to use for quota purposes for server-side applications. Can be any
2345
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2346
+ # @param [Google::Apis::RequestOptions] options
2347
+ # Request-specific options
2348
+ #
2349
+ # @yield [result, err] Result & error if block supplied
2350
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::HttpBody] parsed result object
2351
+ # @yieldparam err [StandardError] error object if request failed
2352
+ #
2353
+ # @return [Google::Apis::ManagedkafkaV1::HttpBody]
2354
+ #
2355
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2356
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2357
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2358
+ def list_project_location_schema_registry_context_schema_types(parent, fields: nil, quota_user: nil, options: nil, &block)
2359
+ command = make_simple_command(:get, 'v1/{+parent}/schemas/types', options)
2360
+ command.response_representation = Google::Apis::ManagedkafkaV1::HttpBody::Representation
2361
+ command.response_class = Google::Apis::ManagedkafkaV1::HttpBody
2362
+ command.params['parent'] = parent unless parent.nil?
2363
+ command.query['fields'] = fields unless fields.nil?
2364
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2365
+ execute_or_queue_command(command, &block)
2366
+ end
2367
+
2368
+ # List the schema versions for the given schema id. The response will be an
2369
+ # array of subject-version pairs as: [`"subject":"subject1", "version":1`, `"
2370
+ # subject":"subject2", "version":2`].
2371
+ # @param [String] parent
2372
+ # Required. The schema whose schema versions are to be listed. Structured like: `
2373
+ # projects/`project`/locations/`location`/schemaRegistries/`schema_registry`/
2374
+ # schemas/ids/`schema`` or `projects/`project`/locations/`location`/
2375
+ # schemaRegistries/`schema_registry`/contexts/`context`/schemas/ids/`schema``
2376
+ # @param [Boolean] deleted
2377
+ # Optional. If true, the response will include soft-deleted versions of the
2378
+ # schema, even if the subject is soft-deleted. The default is false.
2379
+ # @param [String] subject
2380
+ # Optional. The subject to filter the subjects by.
2381
+ # @param [String] fields
2382
+ # Selector specifying which fields to include in a partial response.
2383
+ # @param [String] quota_user
2384
+ # Available to use for quota purposes for server-side applications. Can be any
2385
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2386
+ # @param [Google::Apis::RequestOptions] options
2387
+ # Request-specific options
2388
+ #
2389
+ # @yield [result, err] Result & error if block supplied
2390
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::HttpBody] parsed result object
2391
+ # @yieldparam err [StandardError] error object if request failed
2392
+ #
2393
+ # @return [Google::Apis::ManagedkafkaV1::HttpBody]
2394
+ #
2395
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2396
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2397
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2398
+ def list_project_location_schema_registry_context_schema_versions(parent, deleted: nil, subject: nil, fields: nil, quota_user: nil, options: nil, &block)
2399
+ command = make_simple_command(:get, 'v1/{+parent}/versions', options)
2400
+ command.response_representation = Google::Apis::ManagedkafkaV1::HttpBody::Representation
2401
+ command.response_class = Google::Apis::ManagedkafkaV1::HttpBody
2402
+ command.params['parent'] = parent unless parent.nil?
2403
+ command.query['deleted'] = deleted unless deleted.nil?
2404
+ command.query['subject'] = subject unless subject.nil?
2405
+ command.query['fields'] = fields unless fields.nil?
2406
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2407
+ execute_or_queue_command(command, &block)
2408
+ end
2409
+
2410
+ # Delete a subject. The response will be an array of versions of the deleted
2411
+ # subject.
2412
+ # @param [String] name
2413
+ # Required. The name of the subject to delete. Structured like: `projects/`
2414
+ # project`/locations/`location`/schemaRegistries/`schema_registry`/subjects/`
2415
+ # subject`` or `projects/`project`/locations/`location`/schemaRegistries/`
2416
+ # schema_registry`/contexts/`context`/subjects/`subject``
2417
+ # @param [Boolean] permanent
2418
+ # Optional. If true, the subject and all associated metadata including the
2419
+ # schema ID will be deleted permanently. Otherwise, only the subject is soft-
2420
+ # deleted. The default is false. Soft-deleted subjects can still be searched in
2421
+ # ListSubjects API call with deleted=true query parameter. A soft-delete of a
2422
+ # subject must be performed before a hard-delete.
2423
+ # @param [String] fields
2424
+ # Selector specifying which fields to include in a partial response.
2425
+ # @param [String] quota_user
2426
+ # Available to use for quota purposes for server-side applications. Can be any
2427
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2428
+ # @param [Google::Apis::RequestOptions] options
2429
+ # Request-specific options
2430
+ #
2431
+ # @yield [result, err] Result & error if block supplied
2432
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::HttpBody] parsed result object
2433
+ # @yieldparam err [StandardError] error object if request failed
2434
+ #
2435
+ # @return [Google::Apis::ManagedkafkaV1::HttpBody]
2436
+ #
2437
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2438
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2439
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2440
+ def delete_project_location_schema_registry_context_subject(name, permanent: nil, fields: nil, quota_user: nil, options: nil, &block)
2441
+ command = make_simple_command(:delete, 'v1/{+name}', options)
2442
+ command.response_representation = Google::Apis::ManagedkafkaV1::HttpBody::Representation
2443
+ command.response_class = Google::Apis::ManagedkafkaV1::HttpBody
2444
+ command.params['name'] = name unless name.nil?
2445
+ command.query['permanent'] = permanent unless permanent.nil?
2446
+ command.query['fields'] = fields unless fields.nil?
2447
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2448
+ execute_or_queue_command(command, &block)
2449
+ end
2450
+
2451
+ # List subjects in the schema registry. The response will be an array of subject
2452
+ # names.
2453
+ # @param [String] parent
2454
+ # Required. The parent schema registry/context whose subjects are to be listed.
2455
+ # Structured like: `projects/`project`/locations/`location`/schemaRegistries/`
2456
+ # schema_registry`` or `projects/`project`/locations/`location`/schemaRegistries/
2457
+ # `schema_registry`/contexts/`context``
2458
+ # @param [Boolean] deleted
2459
+ # Optional. If true, the response will include soft-deleted subjects. The
2460
+ # default is false.
2461
+ # @param [String] subject_prefix
2462
+ # Optional. The context to filter the subjects by, in the format of `:.`context`:
2463
+ # `. If unset, all subjects in the registry are returned. Set to empty string or
2464
+ # add as '?subjectPrefix=' at the end of this request to list subjects in the
2465
+ # default context.
2466
+ # @param [String] fields
2467
+ # Selector specifying which fields to include in a partial response.
2468
+ # @param [String] quota_user
2469
+ # Available to use for quota purposes for server-side applications. Can be any
2470
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2471
+ # @param [Google::Apis::RequestOptions] options
2472
+ # Request-specific options
2473
+ #
2474
+ # @yield [result, err] Result & error if block supplied
2475
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::HttpBody] parsed result object
2476
+ # @yieldparam err [StandardError] error object if request failed
2477
+ #
2478
+ # @return [Google::Apis::ManagedkafkaV1::HttpBody]
2479
+ #
2480
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2481
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2482
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2483
+ def list_project_location_schema_registry_context_subjects(parent, deleted: nil, subject_prefix: nil, fields: nil, quota_user: nil, options: nil, &block)
2484
+ command = make_simple_command(:get, 'v1/{+parent}/subjects', options)
2485
+ command.response_representation = Google::Apis::ManagedkafkaV1::HttpBody::Representation
2486
+ command.response_class = Google::Apis::ManagedkafkaV1::HttpBody
2487
+ command.params['parent'] = parent unless parent.nil?
2488
+ command.query['deleted'] = deleted unless deleted.nil?
2489
+ command.query['subjectPrefix'] = subject_prefix unless subject_prefix.nil?
2490
+ command.query['fields'] = fields unless fields.nil?
2491
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2492
+ execute_or_queue_command(command, &block)
2493
+ end
2494
+
2495
+ # Lookup a schema under the specified subject.
2496
+ # @param [String] parent
2497
+ # Required. The subject to lookup the schema in. Structured like: `projects/`
2498
+ # project`/locations/`location`/schemaRegistries/`schema_registry`/subjects/`
2499
+ # subject`` or `projects/`project`/locations/`location`/schemaRegistries/`
2500
+ # schema_registry`/contexts/`context`/subjects/`subject``
2501
+ # @param [Google::Apis::ManagedkafkaV1::LookupVersionRequest] lookup_version_request_object
2502
+ # @param [String] fields
2503
+ # Selector specifying which fields to include in a partial response.
2504
+ # @param [String] quota_user
2505
+ # Available to use for quota purposes for server-side applications. Can be any
2506
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2507
+ # @param [Google::Apis::RequestOptions] options
2508
+ # Request-specific options
2509
+ #
2510
+ # @yield [result, err] Result & error if block supplied
2511
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::SchemaVersion] parsed result object
2512
+ # @yieldparam err [StandardError] error object if request failed
2513
+ #
2514
+ # @return [Google::Apis::ManagedkafkaV1::SchemaVersion]
2515
+ #
2516
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2517
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2518
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2519
+ def lookup_project_location_schema_registry_context_subject_version(parent, lookup_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2520
+ command = make_simple_command(:post, 'v1/{+parent}', options)
2521
+ command.request_representation = Google::Apis::ManagedkafkaV1::LookupVersionRequest::Representation
2522
+ command.request_object = lookup_version_request_object
2523
+ command.response_representation = Google::Apis::ManagedkafkaV1::SchemaVersion::Representation
2524
+ command.response_class = Google::Apis::ManagedkafkaV1::SchemaVersion
2525
+ command.params['parent'] = parent unless parent.nil?
2526
+ command.query['fields'] = fields unless fields.nil?
2527
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2528
+ execute_or_queue_command(command, &block)
2529
+ end
2530
+
2531
+ # Register a new version under a given subject with the given schema.
2532
+ # @param [String] parent
2533
+ # Required. The subject to create the version for. Structured like: `projects/`
2534
+ # project`/locations/`location`/schemaRegistries/`schema_registry`/subjects/`
2535
+ # subject`` or `projects/`project`/locations/`location`/schemaRegistries/`
2536
+ # schema_registry`/contexts/`context`/subjects/`subject``
2537
+ # @param [Google::Apis::ManagedkafkaV1::CreateVersionRequest] create_version_request_object
2538
+ # @param [String] fields
2539
+ # Selector specifying which fields to include in a partial response.
2540
+ # @param [String] quota_user
2541
+ # Available to use for quota purposes for server-side applications. Can be any
2542
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2543
+ # @param [Google::Apis::RequestOptions] options
2544
+ # Request-specific options
2545
+ #
2546
+ # @yield [result, err] Result & error if block supplied
2547
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::CreateVersionResponse] parsed result object
2548
+ # @yieldparam err [StandardError] error object if request failed
2549
+ #
2550
+ # @return [Google::Apis::ManagedkafkaV1::CreateVersionResponse]
2551
+ #
2552
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2553
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2554
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2555
+ def create_project_location_schema_registry_context_subject_version(parent, create_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2556
+ command = make_simple_command(:post, 'v1/{+parent}/versions', options)
2557
+ command.request_representation = Google::Apis::ManagedkafkaV1::CreateVersionRequest::Representation
2558
+ command.request_object = create_version_request_object
2559
+ command.response_representation = Google::Apis::ManagedkafkaV1::CreateVersionResponse::Representation
2560
+ command.response_class = Google::Apis::ManagedkafkaV1::CreateVersionResponse
2561
+ command.params['parent'] = parent unless parent.nil?
2562
+ command.query['fields'] = fields unless fields.nil?
2563
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2564
+ execute_or_queue_command(command, &block)
2565
+ end
2566
+
2567
+ # Delete a version of a subject. The response will be the deleted version id.
2568
+ # @param [String] name
2569
+ # Required. The name of the subject version to delete. Structured like: `
2570
+ # projects/`project`/locations/`location`/schemaRegistries/`schema_registry`/
2571
+ # subjects/`subject`/versions/`version`` or `projects/`project`/locations/`
2572
+ # location`/schemaRegistries/`schema_registry`/contexts/`context`/subjects/`
2573
+ # subject`/versions/`version``
2574
+ # @param [Boolean] permanent
2575
+ # Optional. If true, both the version and the referenced schema ID will be
2576
+ # permanently deleted. The default is false. If false, the version will be
2577
+ # deleted but the schema ID will be retained. Soft-deleted versions can still be
2578
+ # searched in ListVersions API call with deleted=true query parameter. A soft-
2579
+ # delete of a version must be performed before a hard-delete.
2580
+ # @param [String] fields
2581
+ # Selector specifying which fields to include in a partial response.
2582
+ # @param [String] quota_user
2583
+ # Available to use for quota purposes for server-side applications. Can be any
2584
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2585
+ # @param [Google::Apis::RequestOptions] options
2586
+ # Request-specific options
2587
+ #
2588
+ # @yield [result, err] Result & error if block supplied
2589
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::HttpBody] parsed result object
2590
+ # @yieldparam err [StandardError] error object if request failed
2591
+ #
2592
+ # @return [Google::Apis::ManagedkafkaV1::HttpBody]
2593
+ #
2594
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2595
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2596
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2597
+ def delete_project_location_schema_registry_context_subject_version(name, permanent: nil, fields: nil, quota_user: nil, options: nil, &block)
2598
+ command = make_simple_command(:delete, 'v1/{+name}', options)
2599
+ command.response_representation = Google::Apis::ManagedkafkaV1::HttpBody::Representation
2600
+ command.response_class = Google::Apis::ManagedkafkaV1::HttpBody
2601
+ command.params['name'] = name unless name.nil?
2602
+ command.query['permanent'] = permanent unless permanent.nil?
2603
+ command.query['fields'] = fields unless fields.nil?
2604
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2605
+ execute_or_queue_command(command, &block)
2606
+ end
2607
+
2608
+ # Get a versioned schema (schema with subject/version) of a subject.
2609
+ # @param [String] name
2610
+ # Required. The name of the subject to return versions. Structured like: `
2611
+ # projects/`project`/locations/`location`/schemaRegistries/`schema_registry`/
2612
+ # subjects/`subject`/versions/`version`` or `projects/`project`/locations/`
2613
+ # location`/schemaRegistries/`schema_registry`/contexts/`context`/subjects/`
2614
+ # subject`/versions/`version``
2615
+ # @param [Boolean] deleted
2616
+ # Optional. If true, no matter if the subject/version is soft-deleted or not, it
2617
+ # returns the version details. If false, it returns NOT_FOUND error if the
2618
+ # subject/version is soft-deleted. The default is false.
2619
+ # @param [String] fields
2620
+ # Selector specifying which fields to include in a partial response.
2621
+ # @param [String] quota_user
2622
+ # Available to use for quota purposes for server-side applications. Can be any
2623
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2624
+ # @param [Google::Apis::RequestOptions] options
2625
+ # Request-specific options
2626
+ #
2627
+ # @yield [result, err] Result & error if block supplied
2628
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::SchemaVersion] parsed result object
2629
+ # @yieldparam err [StandardError] error object if request failed
2630
+ #
2631
+ # @return [Google::Apis::ManagedkafkaV1::SchemaVersion]
2632
+ #
2633
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2634
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2635
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2636
+ def get_project_location_schema_registry_context_subject_version(name, deleted: nil, fields: nil, quota_user: nil, options: nil, &block)
2637
+ command = make_simple_command(:get, 'v1/{+name}', options)
2638
+ command.response_representation = Google::Apis::ManagedkafkaV1::SchemaVersion::Representation
2639
+ command.response_class = Google::Apis::ManagedkafkaV1::SchemaVersion
2640
+ command.params['name'] = name unless name.nil?
2641
+ command.query['deleted'] = deleted unless deleted.nil?
2642
+ command.query['fields'] = fields unless fields.nil?
2643
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2644
+ execute_or_queue_command(command, &block)
2645
+ end
2646
+
2647
+ # Get the schema string only for a version of a subject. The response will be
2648
+ # the schema string.
2649
+ # @param [String] name
2650
+ # Required. The name of the subject to return versions. Structured like: `
2651
+ # projects/`project`/locations/`location`/schemaRegistries/`schema_registry`/
2652
+ # subjects/`subject`/versions/`version`` or `projects/`project`/locations/`
2653
+ # location`/schemaRegistries/`schema_registry`/contexts/`context`/subjects/`
2654
+ # subject`/versions/`version``
2655
+ # @param [Boolean] deleted
2656
+ # Optional. If true, no matter if the subject/version is soft-deleted or not, it
2657
+ # returns the version details. If false, it returns NOT_FOUND error if the
2658
+ # subject/version is soft-deleted. The default is false.
2659
+ # @param [String] fields
2660
+ # Selector specifying which fields to include in a partial response.
2661
+ # @param [String] quota_user
2662
+ # Available to use for quota purposes for server-side applications. Can be any
2663
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2664
+ # @param [Google::Apis::RequestOptions] options
2665
+ # Request-specific options
2666
+ #
2667
+ # @yield [result, err] Result & error if block supplied
2668
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::HttpBody] parsed result object
2669
+ # @yieldparam err [StandardError] error object if request failed
2670
+ #
2671
+ # @return [Google::Apis::ManagedkafkaV1::HttpBody]
2672
+ #
2673
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2674
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2675
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2676
+ def get_project_location_schema_registry_context_subject_version_schema(name, deleted: nil, fields: nil, quota_user: nil, options: nil, &block)
2677
+ command = make_simple_command(:get, 'v1/{+name}/schema', options)
2678
+ command.response_representation = Google::Apis::ManagedkafkaV1::HttpBody::Representation
2679
+ command.response_class = Google::Apis::ManagedkafkaV1::HttpBody
2680
+ command.params['name'] = name unless name.nil?
2681
+ command.query['deleted'] = deleted unless deleted.nil?
2682
+ command.query['fields'] = fields unless fields.nil?
2683
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2684
+ execute_or_queue_command(command, &block)
2685
+ end
2686
+
2687
+ # Get all versions of a subject. The response will be an array of versions of
2688
+ # the subject.
2689
+ # @param [String] parent
2690
+ # Required. The subject whose versions are to be listed. Structured like: `
2691
+ # projects/`project`/locations/`location`/schemaRegistries/`schema_registry`/
2692
+ # subjects/`subject`` or `projects/`project`/locations/`location`/
2693
+ # schemaRegistries/`schema_registry`/contexts/`context`/subjects/`subject``
2694
+ # @param [Boolean] deleted
2695
+ # Optional. If true, the response will include soft-deleted versions of an
2696
+ # active or soft-deleted subject. The default is false.
2697
+ # @param [String] fields
2698
+ # Selector specifying which fields to include in a partial response.
2699
+ # @param [String] quota_user
2700
+ # Available to use for quota purposes for server-side applications. Can be any
2701
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2702
+ # @param [Google::Apis::RequestOptions] options
2703
+ # Request-specific options
2704
+ #
2705
+ # @yield [result, err] Result & error if block supplied
2706
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::HttpBody] parsed result object
2707
+ # @yieldparam err [StandardError] error object if request failed
2708
+ #
2709
+ # @return [Google::Apis::ManagedkafkaV1::HttpBody]
2710
+ #
2711
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2712
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2713
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2714
+ def list_project_location_schema_registry_context_subject_versions(parent, deleted: nil, fields: nil, quota_user: nil, options: nil, &block)
2715
+ command = make_simple_command(:get, 'v1/{+parent}/versions', options)
2716
+ command.response_representation = Google::Apis::ManagedkafkaV1::HttpBody::Representation
2717
+ command.response_class = Google::Apis::ManagedkafkaV1::HttpBody
2718
+ command.params['parent'] = parent unless parent.nil?
2719
+ command.query['deleted'] = deleted unless deleted.nil?
2720
+ command.query['fields'] = fields unless fields.nil?
2721
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2722
+ execute_or_queue_command(command, &block)
2723
+ end
2724
+
2725
+ # Get a list of IDs of schemas that reference the schema with the given subject
2726
+ # and version.
2727
+ # @param [String] parent
2728
+ # Required. The version to list referenced by. Structured like: `projects/`
2729
+ # project`/locations/`location`/schemaRegistries/`schema_registry`/subjects/`
2730
+ # subject`/versions/`version`` or `projects/`project`/locations/`location`/
2731
+ # schemaRegistries/`schema_registry`/contexts/`context`/subjects/`subject`/
2732
+ # versions/`version``
2733
+ # @param [String] fields
2734
+ # Selector specifying which fields to include in a partial response.
2735
+ # @param [String] quota_user
2736
+ # Available to use for quota purposes for server-side applications. Can be any
2737
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2738
+ # @param [Google::Apis::RequestOptions] options
2739
+ # Request-specific options
2740
+ #
2741
+ # @yield [result, err] Result & error if block supplied
2742
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::HttpBody] parsed result object
2743
+ # @yieldparam err [StandardError] error object if request failed
2744
+ #
2745
+ # @return [Google::Apis::ManagedkafkaV1::HttpBody]
2746
+ #
2747
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2748
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2749
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2750
+ def list_project_location_schema_registry_context_subject_version_referencedbies(parent, fields: nil, quota_user: nil, options: nil, &block)
2751
+ command = make_simple_command(:get, 'v1/{+parent}/referencedby', options)
2752
+ command.response_representation = Google::Apis::ManagedkafkaV1::HttpBody::Representation
2753
+ command.response_class = Google::Apis::ManagedkafkaV1::HttpBody
2754
+ command.params['parent'] = parent unless parent.nil?
2755
+ command.query['fields'] = fields unless fields.nil?
2756
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2757
+ execute_or_queue_command(command, &block)
2758
+ end
2759
+
2760
+ # Get mode at global level or for a subject.
2761
+ # @param [String] name
2762
+ # Required. The resource name of the mode. The format is * projects/`project`/
2763
+ # locations/`location`/schemaRegistries/`schema_registry`/mode/`subject`: mode
2764
+ # for a schema registry, or * projects/`project`/locations/`location`/
2765
+ # schemaRegistries/`schema_registry`/contexts/`context`/mode/`subject`: mode for
2766
+ # a specific subject in a specific context
2767
+ # @param [String] fields
2768
+ # Selector specifying which fields to include in a partial response.
2769
+ # @param [String] quota_user
2770
+ # Available to use for quota purposes for server-side applications. Can be any
2771
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2772
+ # @param [Google::Apis::RequestOptions] options
2773
+ # Request-specific options
2774
+ #
2775
+ # @yield [result, err] Result & error if block supplied
2776
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::SchemaMode] parsed result object
2777
+ # @yieldparam err [StandardError] error object if request failed
2778
+ #
2779
+ # @return [Google::Apis::ManagedkafkaV1::SchemaMode]
2780
+ #
2781
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2782
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2783
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2784
+ def get_project_location_schema_registry_mode(name, fields: nil, quota_user: nil, options: nil, &block)
2785
+ command = make_simple_command(:get, 'v1/{+name}', options)
2786
+ command.response_representation = Google::Apis::ManagedkafkaV1::SchemaMode::Representation
2787
+ command.response_class = Google::Apis::ManagedkafkaV1::SchemaMode
2788
+ command.params['name'] = name unless name.nil?
2789
+ command.query['fields'] = fields unless fields.nil?
2790
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2791
+ execute_or_queue_command(command, &block)
2792
+ end
2793
+
2794
+ # Update mode at global level or for a subject.
2795
+ # @param [String] name
2796
+ # Required. The resource name of the mode. The format is * projects/`project`/
2797
+ # locations/`location`/schemaRegistries/`schema_registry`/mode/`subject`: mode
2798
+ # for a schema registry, or * projects/`project`/locations/`location`/
2799
+ # schemaRegistries/`schema_registry`/contexts/`context`/mode/`subject`: mode for
2800
+ # a specific subject in a specific context
2801
+ # @param [Google::Apis::ManagedkafkaV1::UpdateSchemaModeRequest] update_schema_mode_request_object
2802
+ # @param [String] fields
2803
+ # Selector specifying which fields to include in a partial response.
2804
+ # @param [String] quota_user
2805
+ # Available to use for quota purposes for server-side applications. Can be any
2806
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2807
+ # @param [Google::Apis::RequestOptions] options
2808
+ # Request-specific options
2809
+ #
2810
+ # @yield [result, err] Result & error if block supplied
2811
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::SchemaMode] parsed result object
2812
+ # @yieldparam err [StandardError] error object if request failed
2813
+ #
2814
+ # @return [Google::Apis::ManagedkafkaV1::SchemaMode]
2815
+ #
2816
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2817
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2818
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2819
+ def update_project_location_schema_registry_mode(name, update_schema_mode_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
2820
+ command = make_simple_command(:put, 'v1/{+name}', options)
2821
+ command.request_representation = Google::Apis::ManagedkafkaV1::UpdateSchemaModeRequest::Representation
2822
+ command.request_object = update_schema_mode_request_object
2823
+ command.response_representation = Google::Apis::ManagedkafkaV1::SchemaMode::Representation
2824
+ command.response_class = Google::Apis::ManagedkafkaV1::SchemaMode
2825
+ command.params['name'] = name unless name.nil?
2826
+ command.query['fields'] = fields unless fields.nil?
2827
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2828
+ execute_or_queue_command(command, &block)
2829
+ end
2830
+
2831
+ # Get the schema for the given schema id.
2832
+ # @param [String] name
2833
+ # Required. The name of the schema to return. Structured like: `projects/`
2834
+ # project`/locations/`location`/schemaRegistries/`schema_registry`/schemas/ids/`
2835
+ # schema``
2836
+ # @param [String] subject
2837
+ # Optional. Used to limit the search for the schema ID to a specific subject,
2838
+ # otherwise the schema ID will be searched for in all subjects in the given
2839
+ # specified context.
2840
+ # @param [String] fields
2841
+ # Selector specifying which fields to include in a partial response.
2842
+ # @param [String] quota_user
2843
+ # Available to use for quota purposes for server-side applications. Can be any
2844
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2845
+ # @param [Google::Apis::RequestOptions] options
2846
+ # Request-specific options
2847
+ #
2848
+ # @yield [result, err] Result & error if block supplied
2849
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::Schema] parsed result object
2850
+ # @yieldparam err [StandardError] error object if request failed
2851
+ #
2852
+ # @return [Google::Apis::ManagedkafkaV1::Schema]
2853
+ #
2854
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2855
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2856
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2857
+ def get_project_location_schema_registry_schema(name, subject: nil, fields: nil, quota_user: nil, options: nil, &block)
2858
+ command = make_simple_command(:get, 'v1/{+name}', options)
2859
+ command.response_representation = Google::Apis::ManagedkafkaV1::Schema::Representation
2860
+ command.response_class = Google::Apis::ManagedkafkaV1::Schema
2861
+ command.params['name'] = name unless name.nil?
2862
+ command.query['subject'] = subject unless subject.nil?
2863
+ command.query['fields'] = fields unless fields.nil?
2864
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2865
+ execute_or_queue_command(command, &block)
2866
+ end
2867
+
2868
+ # Get the schema string for the given schema id. The response will be the schema
2869
+ # string.
2870
+ # @param [String] name
2871
+ # Required. The name of the schema to return. Structured like: `projects/`
2872
+ # project`/locations/`location`/schemaRegistries/`schema_registry`/schemas/ids/`
2873
+ # schema``
2874
+ # @param [String] subject
2875
+ # Optional. Used to limit the search for the schema ID to a specific subject,
2876
+ # otherwise the schema ID will be searched for in all subjects in the given
2877
+ # specified context.
2878
+ # @param [String] fields
2879
+ # Selector specifying which fields to include in a partial response.
2880
+ # @param [String] quota_user
2881
+ # Available to use for quota purposes for server-side applications. Can be any
2882
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2883
+ # @param [Google::Apis::RequestOptions] options
2884
+ # Request-specific options
2885
+ #
2886
+ # @yield [result, err] Result & error if block supplied
2887
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::HttpBody] parsed result object
2888
+ # @yieldparam err [StandardError] error object if request failed
2889
+ #
2890
+ # @return [Google::Apis::ManagedkafkaV1::HttpBody]
2891
+ #
2892
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2893
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2894
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2895
+ def get_project_location_schema_registry_schema_schema(name, subject: nil, fields: nil, quota_user: nil, options: nil, &block)
2896
+ command = make_simple_command(:get, 'v1/{+name}/schema', options)
2897
+ command.response_representation = Google::Apis::ManagedkafkaV1::HttpBody::Representation
2898
+ command.response_class = Google::Apis::ManagedkafkaV1::HttpBody
2899
+ command.params['name'] = name unless name.nil?
2900
+ command.query['subject'] = subject unless subject.nil?
2901
+ command.query['fields'] = fields unless fields.nil?
2902
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2903
+ execute_or_queue_command(command, &block)
2904
+ end
2905
+
2906
+ # List subjects which reference a particular schema id. The response will be an
2907
+ # array of subject names.
2908
+ # @param [String] parent
2909
+ # Required. The schema resource whose associated subjects are to be listed.
2910
+ # Structured like: `projects/`project`/locations/`location`/schemaRegistries/`
2911
+ # schema_registry`/schemas/ids/`schema`` or `projects/`project`/locations/`
2912
+ # location`/schemaRegistries/`schema_registry`/contexts/`context`/schemas/ids/`
2913
+ # schema``
2914
+ # @param [Boolean] deleted
2915
+ # Optional. If true, the response will include soft-deleted subjects. The
2916
+ # default is false.
2917
+ # @param [String] subject
2918
+ # Optional. The subject to filter the subjects by.
2919
+ # @param [String] fields
2920
+ # Selector specifying which fields to include in a partial response.
2921
+ # @param [String] quota_user
2922
+ # Available to use for quota purposes for server-side applications. Can be any
2923
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2924
+ # @param [Google::Apis::RequestOptions] options
2925
+ # Request-specific options
2926
+ #
2927
+ # @yield [result, err] Result & error if block supplied
2928
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::HttpBody] parsed result object
2929
+ # @yieldparam err [StandardError] error object if request failed
2930
+ #
2931
+ # @return [Google::Apis::ManagedkafkaV1::HttpBody]
2932
+ #
2933
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2934
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2935
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2936
+ def list_project_location_schema_registry_schema_subjects(parent, deleted: nil, subject: nil, fields: nil, quota_user: nil, options: nil, &block)
2937
+ command = make_simple_command(:get, 'v1/{+parent}/subjects', options)
2938
+ command.response_representation = Google::Apis::ManagedkafkaV1::HttpBody::Representation
2939
+ command.response_class = Google::Apis::ManagedkafkaV1::HttpBody
2940
+ command.params['parent'] = parent unless parent.nil?
2941
+ command.query['deleted'] = deleted unless deleted.nil?
2942
+ command.query['subject'] = subject unless subject.nil?
2943
+ command.query['fields'] = fields unless fields.nil?
2944
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2945
+ execute_or_queue_command(command, &block)
2946
+ end
2947
+
2948
+ # List the supported schema types. The response will be an array of schema types.
2949
+ # @param [String] parent
2950
+ # Required. The parent schema registry whose schema types are to be listed.
2951
+ # Structured like: `projects/`project`/locations/`location`/schemaRegistries/`
2952
+ # schema_registry``
2953
+ # @param [String] fields
2954
+ # Selector specifying which fields to include in a partial response.
2955
+ # @param [String] quota_user
2956
+ # Available to use for quota purposes for server-side applications. Can be any
2957
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2958
+ # @param [Google::Apis::RequestOptions] options
2959
+ # Request-specific options
2960
+ #
2961
+ # @yield [result, err] Result & error if block supplied
2962
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::HttpBody] parsed result object
2963
+ # @yieldparam err [StandardError] error object if request failed
2964
+ #
2965
+ # @return [Google::Apis::ManagedkafkaV1::HttpBody]
2966
+ #
2967
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
2968
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
2969
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
2970
+ def list_project_location_schema_registry_schema_types(parent, fields: nil, quota_user: nil, options: nil, &block)
2971
+ command = make_simple_command(:get, 'v1/{+parent}/schemas/types', options)
2972
+ command.response_representation = Google::Apis::ManagedkafkaV1::HttpBody::Representation
2973
+ command.response_class = Google::Apis::ManagedkafkaV1::HttpBody
2974
+ command.params['parent'] = parent unless parent.nil?
2975
+ command.query['fields'] = fields unless fields.nil?
2976
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
2977
+ execute_or_queue_command(command, &block)
2978
+ end
2979
+
2980
+ # List the schema versions for the given schema id. The response will be an
2981
+ # array of subject-version pairs as: [`"subject":"subject1", "version":1`, `"
2982
+ # subject":"subject2", "version":2`].
2983
+ # @param [String] parent
2984
+ # Required. The schema whose schema versions are to be listed. Structured like: `
2985
+ # projects/`project`/locations/`location`/schemaRegistries/`schema_registry`/
2986
+ # schemas/ids/`schema`` or `projects/`project`/locations/`location`/
2987
+ # schemaRegistries/`schema_registry`/contexts/`context`/schemas/ids/`schema``
2988
+ # @param [Boolean] deleted
2989
+ # Optional. If true, the response will include soft-deleted versions of the
2990
+ # schema, even if the subject is soft-deleted. The default is false.
2991
+ # @param [String] subject
2992
+ # Optional. The subject to filter the subjects by.
2993
+ # @param [String] fields
2994
+ # Selector specifying which fields to include in a partial response.
2995
+ # @param [String] quota_user
2996
+ # Available to use for quota purposes for server-side applications. Can be any
2997
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
2998
+ # @param [Google::Apis::RequestOptions] options
2999
+ # Request-specific options
3000
+ #
3001
+ # @yield [result, err] Result & error if block supplied
3002
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::HttpBody] parsed result object
3003
+ # @yieldparam err [StandardError] error object if request failed
3004
+ #
3005
+ # @return [Google::Apis::ManagedkafkaV1::HttpBody]
3006
+ #
3007
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3008
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3009
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3010
+ def list_project_location_schema_registry_schema_versions(parent, deleted: nil, subject: nil, fields: nil, quota_user: nil, options: nil, &block)
3011
+ command = make_simple_command(:get, 'v1/{+parent}/versions', options)
3012
+ command.response_representation = Google::Apis::ManagedkafkaV1::HttpBody::Representation
3013
+ command.response_class = Google::Apis::ManagedkafkaV1::HttpBody
3014
+ command.params['parent'] = parent unless parent.nil?
3015
+ command.query['deleted'] = deleted unless deleted.nil?
3016
+ command.query['subject'] = subject unless subject.nil?
3017
+ command.query['fields'] = fields unless fields.nil?
3018
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3019
+ execute_or_queue_command(command, &block)
3020
+ end
3021
+
3022
+ # Delete a subject. The response will be an array of versions of the deleted
3023
+ # subject.
3024
+ # @param [String] name
3025
+ # Required. The name of the subject to delete. Structured like: `projects/`
3026
+ # project`/locations/`location`/schemaRegistries/`schema_registry`/subjects/`
3027
+ # subject`` or `projects/`project`/locations/`location`/schemaRegistries/`
3028
+ # schema_registry`/contexts/`context`/subjects/`subject``
3029
+ # @param [Boolean] permanent
3030
+ # Optional. If true, the subject and all associated metadata including the
3031
+ # schema ID will be deleted permanently. Otherwise, only the subject is soft-
3032
+ # deleted. The default is false. Soft-deleted subjects can still be searched in
3033
+ # ListSubjects API call with deleted=true query parameter. A soft-delete of a
3034
+ # subject must be performed before a hard-delete.
3035
+ # @param [String] fields
3036
+ # Selector specifying which fields to include in a partial response.
3037
+ # @param [String] quota_user
3038
+ # Available to use for quota purposes for server-side applications. Can be any
3039
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3040
+ # @param [Google::Apis::RequestOptions] options
3041
+ # Request-specific options
3042
+ #
3043
+ # @yield [result, err] Result & error if block supplied
3044
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::HttpBody] parsed result object
3045
+ # @yieldparam err [StandardError] error object if request failed
3046
+ #
3047
+ # @return [Google::Apis::ManagedkafkaV1::HttpBody]
3048
+ #
3049
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3050
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3051
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3052
+ def delete_project_location_schema_registry_subject(name, permanent: nil, fields: nil, quota_user: nil, options: nil, &block)
3053
+ command = make_simple_command(:delete, 'v1/{+name}', options)
3054
+ command.response_representation = Google::Apis::ManagedkafkaV1::HttpBody::Representation
3055
+ command.response_class = Google::Apis::ManagedkafkaV1::HttpBody
3056
+ command.params['name'] = name unless name.nil?
3057
+ command.query['permanent'] = permanent unless permanent.nil?
3058
+ command.query['fields'] = fields unless fields.nil?
3059
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3060
+ execute_or_queue_command(command, &block)
3061
+ end
3062
+
3063
+ # List subjects in the schema registry. The response will be an array of subject
3064
+ # names.
3065
+ # @param [String] parent
3066
+ # Required. The parent schema registry/context whose subjects are to be listed.
3067
+ # Structured like: `projects/`project`/locations/`location`/schemaRegistries/`
3068
+ # schema_registry`` or `projects/`project`/locations/`location`/schemaRegistries/
3069
+ # `schema_registry`/contexts/`context``
3070
+ # @param [Boolean] deleted
3071
+ # Optional. If true, the response will include soft-deleted subjects. The
3072
+ # default is false.
3073
+ # @param [String] subject_prefix
3074
+ # Optional. The context to filter the subjects by, in the format of `:.`context`:
3075
+ # `. If unset, all subjects in the registry are returned. Set to empty string or
3076
+ # add as '?subjectPrefix=' at the end of this request to list subjects in the
3077
+ # default context.
3078
+ # @param [String] fields
3079
+ # Selector specifying which fields to include in a partial response.
3080
+ # @param [String] quota_user
3081
+ # Available to use for quota purposes for server-side applications. Can be any
3082
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3083
+ # @param [Google::Apis::RequestOptions] options
3084
+ # Request-specific options
3085
+ #
3086
+ # @yield [result, err] Result & error if block supplied
3087
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::HttpBody] parsed result object
3088
+ # @yieldparam err [StandardError] error object if request failed
3089
+ #
3090
+ # @return [Google::Apis::ManagedkafkaV1::HttpBody]
3091
+ #
3092
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3093
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3094
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3095
+ def list_project_location_schema_registry_subjects(parent, deleted: nil, subject_prefix: nil, fields: nil, quota_user: nil, options: nil, &block)
3096
+ command = make_simple_command(:get, 'v1/{+parent}/subjects', options)
3097
+ command.response_representation = Google::Apis::ManagedkafkaV1::HttpBody::Representation
3098
+ command.response_class = Google::Apis::ManagedkafkaV1::HttpBody
3099
+ command.params['parent'] = parent unless parent.nil?
3100
+ command.query['deleted'] = deleted unless deleted.nil?
3101
+ command.query['subjectPrefix'] = subject_prefix unless subject_prefix.nil?
3102
+ command.query['fields'] = fields unless fields.nil?
3103
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3104
+ execute_or_queue_command(command, &block)
3105
+ end
3106
+
3107
+ # Lookup a schema under the specified subject.
3108
+ # @param [String] parent
3109
+ # Required. The subject to lookup the schema in. Structured like: `projects/`
3110
+ # project`/locations/`location`/schemaRegistries/`schema_registry`/subjects/`
3111
+ # subject`` or `projects/`project`/locations/`location`/schemaRegistries/`
3112
+ # schema_registry`/contexts/`context`/subjects/`subject``
3113
+ # @param [Google::Apis::ManagedkafkaV1::LookupVersionRequest] lookup_version_request_object
3114
+ # @param [String] fields
3115
+ # Selector specifying which fields to include in a partial response.
3116
+ # @param [String] quota_user
3117
+ # Available to use for quota purposes for server-side applications. Can be any
3118
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3119
+ # @param [Google::Apis::RequestOptions] options
3120
+ # Request-specific options
3121
+ #
3122
+ # @yield [result, err] Result & error if block supplied
3123
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::SchemaVersion] parsed result object
3124
+ # @yieldparam err [StandardError] error object if request failed
3125
+ #
3126
+ # @return [Google::Apis::ManagedkafkaV1::SchemaVersion]
3127
+ #
3128
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3129
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3130
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3131
+ def lookup_project_location_schema_registry_subject_version(parent, lookup_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3132
+ command = make_simple_command(:post, 'v1/{+parent}', options)
3133
+ command.request_representation = Google::Apis::ManagedkafkaV1::LookupVersionRequest::Representation
3134
+ command.request_object = lookup_version_request_object
3135
+ command.response_representation = Google::Apis::ManagedkafkaV1::SchemaVersion::Representation
3136
+ command.response_class = Google::Apis::ManagedkafkaV1::SchemaVersion
3137
+ command.params['parent'] = parent unless parent.nil?
3138
+ command.query['fields'] = fields unless fields.nil?
3139
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3140
+ execute_or_queue_command(command, &block)
3141
+ end
3142
+
3143
+ # Register a new version under a given subject with the given schema.
3144
+ # @param [String] parent
3145
+ # Required. The subject to create the version for. Structured like: `projects/`
3146
+ # project`/locations/`location`/schemaRegistries/`schema_registry`/subjects/`
3147
+ # subject`` or `projects/`project`/locations/`location`/schemaRegistries/`
3148
+ # schema_registry`/contexts/`context`/subjects/`subject``
3149
+ # @param [Google::Apis::ManagedkafkaV1::CreateVersionRequest] create_version_request_object
3150
+ # @param [String] fields
3151
+ # Selector specifying which fields to include in a partial response.
3152
+ # @param [String] quota_user
3153
+ # Available to use for quota purposes for server-side applications. Can be any
3154
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3155
+ # @param [Google::Apis::RequestOptions] options
3156
+ # Request-specific options
3157
+ #
3158
+ # @yield [result, err] Result & error if block supplied
3159
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::CreateVersionResponse] parsed result object
3160
+ # @yieldparam err [StandardError] error object if request failed
3161
+ #
3162
+ # @return [Google::Apis::ManagedkafkaV1::CreateVersionResponse]
3163
+ #
3164
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3165
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3166
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3167
+ def create_project_location_schema_registry_subject_version(parent, create_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
3168
+ command = make_simple_command(:post, 'v1/{+parent}/versions', options)
3169
+ command.request_representation = Google::Apis::ManagedkafkaV1::CreateVersionRequest::Representation
3170
+ command.request_object = create_version_request_object
3171
+ command.response_representation = Google::Apis::ManagedkafkaV1::CreateVersionResponse::Representation
3172
+ command.response_class = Google::Apis::ManagedkafkaV1::CreateVersionResponse
3173
+ command.params['parent'] = parent unless parent.nil?
3174
+ command.query['fields'] = fields unless fields.nil?
3175
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3176
+ execute_or_queue_command(command, &block)
3177
+ end
3178
+
3179
+ # Delete a version of a subject. The response will be the deleted version id.
3180
+ # @param [String] name
3181
+ # Required. The name of the subject version to delete. Structured like: `
3182
+ # projects/`project`/locations/`location`/schemaRegistries/`schema_registry`/
3183
+ # subjects/`subject`/versions/`version`` or `projects/`project`/locations/`
3184
+ # location`/schemaRegistries/`schema_registry`/contexts/`context`/subjects/`
3185
+ # subject`/versions/`version``
3186
+ # @param [Boolean] permanent
3187
+ # Optional. If true, both the version and the referenced schema ID will be
3188
+ # permanently deleted. The default is false. If false, the version will be
3189
+ # deleted but the schema ID will be retained. Soft-deleted versions can still be
3190
+ # searched in ListVersions API call with deleted=true query parameter. A soft-
3191
+ # delete of a version must be performed before a hard-delete.
3192
+ # @param [String] fields
3193
+ # Selector specifying which fields to include in a partial response.
3194
+ # @param [String] quota_user
3195
+ # Available to use for quota purposes for server-side applications. Can be any
3196
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3197
+ # @param [Google::Apis::RequestOptions] options
3198
+ # Request-specific options
3199
+ #
3200
+ # @yield [result, err] Result & error if block supplied
3201
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::HttpBody] parsed result object
3202
+ # @yieldparam err [StandardError] error object if request failed
3203
+ #
3204
+ # @return [Google::Apis::ManagedkafkaV1::HttpBody]
3205
+ #
3206
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3207
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3208
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3209
+ def delete_project_location_schema_registry_subject_version(name, permanent: nil, fields: nil, quota_user: nil, options: nil, &block)
3210
+ command = make_simple_command(:delete, 'v1/{+name}', options)
3211
+ command.response_representation = Google::Apis::ManagedkafkaV1::HttpBody::Representation
3212
+ command.response_class = Google::Apis::ManagedkafkaV1::HttpBody
3213
+ command.params['name'] = name unless name.nil?
3214
+ command.query['permanent'] = permanent unless permanent.nil?
3215
+ command.query['fields'] = fields unless fields.nil?
3216
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3217
+ execute_or_queue_command(command, &block)
3218
+ end
3219
+
3220
+ # Get a versioned schema (schema with subject/version) of a subject.
3221
+ # @param [String] name
3222
+ # Required. The name of the subject to return versions. Structured like: `
3223
+ # projects/`project`/locations/`location`/schemaRegistries/`schema_registry`/
3224
+ # subjects/`subject`/versions/`version`` or `projects/`project`/locations/`
3225
+ # location`/schemaRegistries/`schema_registry`/contexts/`context`/subjects/`
3226
+ # subject`/versions/`version``
3227
+ # @param [Boolean] deleted
3228
+ # Optional. If true, no matter if the subject/version is soft-deleted or not, it
3229
+ # returns the version details. If false, it returns NOT_FOUND error if the
3230
+ # subject/version is soft-deleted. The default is false.
3231
+ # @param [String] fields
3232
+ # Selector specifying which fields to include in a partial response.
3233
+ # @param [String] quota_user
3234
+ # Available to use for quota purposes for server-side applications. Can be any
3235
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3236
+ # @param [Google::Apis::RequestOptions] options
3237
+ # Request-specific options
3238
+ #
3239
+ # @yield [result, err] Result & error if block supplied
3240
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::SchemaVersion] parsed result object
3241
+ # @yieldparam err [StandardError] error object if request failed
3242
+ #
3243
+ # @return [Google::Apis::ManagedkafkaV1::SchemaVersion]
3244
+ #
3245
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3246
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3247
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3248
+ def get_project_location_schema_registry_subject_version(name, deleted: nil, fields: nil, quota_user: nil, options: nil, &block)
3249
+ command = make_simple_command(:get, 'v1/{+name}', options)
3250
+ command.response_representation = Google::Apis::ManagedkafkaV1::SchemaVersion::Representation
3251
+ command.response_class = Google::Apis::ManagedkafkaV1::SchemaVersion
3252
+ command.params['name'] = name unless name.nil?
3253
+ command.query['deleted'] = deleted unless deleted.nil?
3254
+ command.query['fields'] = fields unless fields.nil?
3255
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3256
+ execute_or_queue_command(command, &block)
3257
+ end
3258
+
3259
+ # Get the schema string only for a version of a subject. The response will be
3260
+ # the schema string.
3261
+ # @param [String] name
3262
+ # Required. The name of the subject to return versions. Structured like: `
3263
+ # projects/`project`/locations/`location`/schemaRegistries/`schema_registry`/
3264
+ # subjects/`subject`/versions/`version`` or `projects/`project`/locations/`
3265
+ # location`/schemaRegistries/`schema_registry`/contexts/`context`/subjects/`
3266
+ # subject`/versions/`version``
3267
+ # @param [Boolean] deleted
3268
+ # Optional. If true, no matter if the subject/version is soft-deleted or not, it
3269
+ # returns the version details. If false, it returns NOT_FOUND error if the
3270
+ # subject/version is soft-deleted. The default is false.
3271
+ # @param [String] fields
3272
+ # Selector specifying which fields to include in a partial response.
3273
+ # @param [String] quota_user
3274
+ # Available to use for quota purposes for server-side applications. Can be any
3275
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3276
+ # @param [Google::Apis::RequestOptions] options
3277
+ # Request-specific options
3278
+ #
3279
+ # @yield [result, err] Result & error if block supplied
3280
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::HttpBody] parsed result object
3281
+ # @yieldparam err [StandardError] error object if request failed
3282
+ #
3283
+ # @return [Google::Apis::ManagedkafkaV1::HttpBody]
3284
+ #
3285
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3286
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3287
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3288
+ def get_project_location_schema_registry_subject_version_schema(name, deleted: nil, fields: nil, quota_user: nil, options: nil, &block)
3289
+ command = make_simple_command(:get, 'v1/{+name}/schema', options)
3290
+ command.response_representation = Google::Apis::ManagedkafkaV1::HttpBody::Representation
3291
+ command.response_class = Google::Apis::ManagedkafkaV1::HttpBody
3292
+ command.params['name'] = name unless name.nil?
3293
+ command.query['deleted'] = deleted unless deleted.nil?
3294
+ command.query['fields'] = fields unless fields.nil?
3295
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3296
+ execute_or_queue_command(command, &block)
3297
+ end
3298
+
3299
+ # Get all versions of a subject. The response will be an array of versions of
3300
+ # the subject.
3301
+ # @param [String] parent
3302
+ # Required. The subject whose versions are to be listed. Structured like: `
3303
+ # projects/`project`/locations/`location`/schemaRegistries/`schema_registry`/
3304
+ # subjects/`subject`` or `projects/`project`/locations/`location`/
3305
+ # schemaRegistries/`schema_registry`/contexts/`context`/subjects/`subject``
3306
+ # @param [Boolean] deleted
3307
+ # Optional. If true, the response will include soft-deleted versions of an
3308
+ # active or soft-deleted subject. The default is false.
3309
+ # @param [String] fields
3310
+ # Selector specifying which fields to include in a partial response.
3311
+ # @param [String] quota_user
3312
+ # Available to use for quota purposes for server-side applications. Can be any
3313
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3314
+ # @param [Google::Apis::RequestOptions] options
3315
+ # Request-specific options
3316
+ #
3317
+ # @yield [result, err] Result & error if block supplied
3318
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::HttpBody] parsed result object
3319
+ # @yieldparam err [StandardError] error object if request failed
3320
+ #
3321
+ # @return [Google::Apis::ManagedkafkaV1::HttpBody]
3322
+ #
3323
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3324
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3325
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3326
+ def list_project_location_schema_registry_subject_versions(parent, deleted: nil, fields: nil, quota_user: nil, options: nil, &block)
3327
+ command = make_simple_command(:get, 'v1/{+parent}/versions', options)
3328
+ command.response_representation = Google::Apis::ManagedkafkaV1::HttpBody::Representation
3329
+ command.response_class = Google::Apis::ManagedkafkaV1::HttpBody
3330
+ command.params['parent'] = parent unless parent.nil?
3331
+ command.query['deleted'] = deleted unless deleted.nil?
3332
+ command.query['fields'] = fields unless fields.nil?
3333
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3334
+ execute_or_queue_command(command, &block)
3335
+ end
3336
+
3337
+ # Get a list of IDs of schemas that reference the schema with the given subject
3338
+ # and version.
3339
+ # @param [String] parent
3340
+ # Required. The version to list referenced by. Structured like: `projects/`
3341
+ # project`/locations/`location`/schemaRegistries/`schema_registry`/subjects/`
3342
+ # subject`/versions/`version`` or `projects/`project`/locations/`location`/
3343
+ # schemaRegistries/`schema_registry`/contexts/`context`/subjects/`subject`/
3344
+ # versions/`version``
3345
+ # @param [String] fields
3346
+ # Selector specifying which fields to include in a partial response.
3347
+ # @param [String] quota_user
3348
+ # Available to use for quota purposes for server-side applications. Can be any
3349
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
3350
+ # @param [Google::Apis::RequestOptions] options
3351
+ # Request-specific options
3352
+ #
3353
+ # @yield [result, err] Result & error if block supplied
3354
+ # @yieldparam result [Google::Apis::ManagedkafkaV1::HttpBody] parsed result object
3355
+ # @yieldparam err [StandardError] error object if request failed
3356
+ #
3357
+ # @return [Google::Apis::ManagedkafkaV1::HttpBody]
3358
+ #
3359
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
3360
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
3361
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
3362
+ def list_project_location_schema_registry_subject_version_referencedbies(parent, fields: nil, quota_user: nil, options: nil, &block)
3363
+ command = make_simple_command(:get, 'v1/{+parent}/referencedby', options)
3364
+ command.response_representation = Google::Apis::ManagedkafkaV1::HttpBody::Representation
3365
+ command.response_class = Google::Apis::ManagedkafkaV1::HttpBody
3366
+ command.params['parent'] = parent unless parent.nil?
3367
+ command.query['fields'] = fields unless fields.nil?
3368
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
3369
+ execute_or_queue_command(command, &block)
3370
+ end
1661
3371
 
1662
3372
  protected
1663
3373