blob: 8983379e503c4c6655427ea621c289089c81348c [file] [log] [blame] [edit]
<html><body>
<style>
body, h1, h2, h3, div, span, p, pre, a {
margin: 0;
padding: 0;
border: 0;
font-weight: inherit;
font-style: inherit;
font-size: 100%;
font-family: inherit;
vertical-align: baseline;
}
body {
font-size: 13px;
padding: 1em;
}
h1 {
font-size: 26px;
margin-bottom: 1em;
}
h2 {
font-size: 24px;
margin-bottom: 1em;
}
h3 {
font-size: 20px;
margin-bottom: 1em;
margin-top: 1em;
}
pre, code {
line-height: 1.5;
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}
pre {
margin-top: 0.5em;
}
h1, h2, h3, p {
font-family: Arial, sans serif;
}
h1, h2, h3 {
border-bottom: solid #CCC 1px;
}
.toc_element {
margin-top: 0.5em;
}
.firstline {
margin-left: 2 em;
}
.method {
margin-top: 1em;
border: solid 1px #CCC;
padding: 1em;
background: #EEE;
}
.details {
font-weight: bold;
font-size: 14px;
}
</style>
<h1><a href="apihub_v1.html">API hub API</a> . <a href="apihub_v1.projects.html">projects</a> . <a href="apihub_v1.projects.locations.html">locations</a> . <a href="apihub_v1.projects.locations.apis.html">apis</a> . <a href="apihub_v1.projects.locations.apis.versions.html">versions</a> . <a href="apihub_v1.projects.locations.apis.versions.definitions.html">definitions</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#close">close()</a></code></p>
<p class="firstline">Close httplib2 connections.</p>
<p class="toc_element">
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
<p class="firstline">Get details about a definition in an API version.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="close">close()</code>
<pre>Close httplib2 connections.</pre>
</div>
<div class="method">
<code class="details" id="get">get(name, x__xgafv=None)</code>
<pre>Get details about a definition in an API version.
Args:
name: string, Required. The name of the definition to retrieve. Format: `projects/{project}/locations/{location}/apis/{api}/versions/{version}/definitions/{definition}` (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Represents a definition for example schema, request, response definitions contained in an API version. A definition is added/updated/deleted in an API version when a new spec is added or an existing spec is updated/deleted in a version. Currently, definition will be created only corresponding to OpenAPI spec as parsing is supported for OpenAPI spec. Also, within OpenAPI spec, only `schema` object is supported.
&quot;attributes&quot;: { # Optional. The list of user defined attributes associated with the definition resource. The key is the attribute name. It will be of the format: `projects/{project}/locations/{location}/attributes/{attribute}`. The value is the attribute values associated with the resource.
&quot;a_key&quot;: { # The attribute values associated with resource.
&quot;attribute&quot;: &quot;A String&quot;, # Output only. The name of the attribute. Format: projects/{project}/locations/{location}/attributes/{attribute}
&quot;enumValues&quot;: { # The attribute values of data type enum. # The attribute values associated with a resource in case attribute data type is enum.
&quot;values&quot;: [ # Required. The attribute values in case attribute data type is enum.
{ # The value that can be assigned to the attribute when the data type is enum.
&quot;description&quot;: &quot;A String&quot;, # Optional. The detailed description of the allowed value.
&quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the allowed value.
&quot;id&quot;: &quot;A String&quot;, # Required. The ID of the allowed value. * If provided, the same will be used. The service will throw an error if the specified id is already used by another allowed value in the same attribute resource. * If not provided, a system generated id derived from the display name will be used. In this case, the service will handle conflict resolution by adding a system generated suffix in case of duplicates. This value should be 4-63 characters, and valid characters are /a-z-/.
&quot;immutable&quot;: True or False, # Optional. When set to true, the allowed value cannot be updated or deleted by the user. It can only be true for System defined attributes.
},
],
},
&quot;jsonValues&quot;: { # The attribute values of data type string or JSON. # The attribute values associated with a resource in case attribute data type is JSON.
&quot;values&quot;: [ # Required. The attribute values in case attribute data type is string or JSON.
&quot;A String&quot;,
],
},
&quot;stringValues&quot;: { # The attribute values of data type string or JSON. # The attribute values associated with a resource in case attribute data type is string.
&quot;values&quot;: [ # Required. The attribute values in case attribute data type is string or JSON.
&quot;A String&quot;,
],
},
&quot;uriValues&quot;: { # The attribute values of data type string or JSON. # The attribute values associated with a resource in case attribute data type is URL, URI or IP, like gs://bucket-name/object-name.
&quot;values&quot;: [ # Required. The attribute values in case attribute data type is string or JSON.
&quot;A String&quot;,
],
},
},
},
&quot;createTime&quot;: &quot;A String&quot;, # Output only. The time at which the definition was created.
&quot;name&quot;: &quot;A String&quot;, # Identifier. The name of the definition. Format: `projects/{project}/locations/{location}/apis/{api}/versions/{version}/definitions/{definition}`
&quot;schema&quot;: { # The schema details derived from the spec. Currently, this entity is supported for OpenAPI spec only. For OpenAPI spec, this maps to the schema defined in the `definitions` section for OpenAPI 2.0 version and in `components.schemas` section for OpenAPI 3.0 and 3.1 version. # Output only. The value of a schema definition.
&quot;displayName&quot;: &quot;A String&quot;, # Output only. The display name of the schema. This will map to the name of the schema in the spec.
&quot;rawValue&quot;: &quot;A String&quot;, # Output only. The raw value of the schema definition corresponding to the schema name in the spec.
},
&quot;spec&quot;: &quot;A String&quot;, # Output only. The name of the spec from where the definition was parsed. Format is `projects/{project}/locations/{location}/apis/{api}/versions/{version}/specs/{spec}`
&quot;type&quot;: &quot;A String&quot;, # Output only. The type of the definition.
&quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time at which the definition was last updated.
}</pre>
</div>
</body></html>