Blame - docs/dyn/firebaserules_v1.projects.rulesets.html - platform/external/python/google-api-python-client

blob: 617178e0cea73d80b31291bfdde2cf72890355fc [file] [log] [blame]

Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	1	<html><body>
				2	<style>
				3
				4	body, h1, h2, h3, div, span, p, pre, a {
				5	margin: 0;
				6	padding: 0;
				7	border: 0;
				8	font-weight: inherit;
				9	font-style: inherit;
				10	font-size: 100%;
				11	font-family: inherit;
				12	vertical-align: baseline;
				13	}
				14
				15	body {
				16	font-size: 13px;
				17	padding: 1em;
				18	}
				19
				20	h1 {
				21	font-size: 26px;
				22	margin-bottom: 1em;
				23	}
				24
				25	h2 {
				26	font-size: 24px;
				27	margin-bottom: 1em;
				28	}
				29
				30	h3 {
				31	font-size: 20px;
				32	margin-bottom: 1em;
				33	margin-top: 1em;
				34	}
				35
				36	pre, code {
				37	line-height: 1.5;
				38	font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
				39	}
				40
				41	pre {
				42	margin-top: 0.5em;
				43	}
				44
				45	h1, h2, h3, p {
				46	font-family: Arial, sans serif;
				47	}
				48
				49	h1, h2, h3 {
				50	border-bottom: solid #CCC 1px;
				51	}
				52
				53	.toc_element {
				54	margin-top: 0.5em;
				55	}
				56
				57	.firstline {
				58	margin-left: 2 em;
				59	}
				60
				61	.method {
				62	margin-top: 1em;
				63	border: solid 1px #CCC;
				64	padding: 1em;
				65	background: #EEE;
				66	}
				67
				68	.details {
				69	font-weight: bold;
				70	font-size: 14px;
				71	}
				72
				73	</style>
				74
				75	<h1><a href="firebaserules_v1.html">Firebase Rules API</a> . <a href="firebaserules_v1.projects.html">projects</a> . <a href="firebaserules_v1.projects.rulesets.html">rulesets</a></h1>
				76	<h2>Instance Methods</h2>
				77	<p class="toc_element">
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame^]	78	<code><a href="#close">close()</a></code></p>
				79	<p class="firstline">Close httplib2 connections.</p>
				80	<p class="toc_element">
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	81	<code><a href="#create">create(name, body=None, x__xgafv=None)</a></code></p>
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame^]	82	<p class="firstline">Create a `Ruleset` from `Source`. The `Ruleset` is given a unique generated name which is returned to the caller. `Source` containing syntactic or semantics errors will result in an error response indicating the first error encountered. For a detailed view of `Source` issues, use TestRuleset.</p>
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	83	<p class="toc_element">
Thomas Coffee	2f24537	2017-03-27 10:39:26 -0700	[diff] [blame]	84	<code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame^]	85	<p class="firstline">Delete a `Ruleset` by resource name. If the `Ruleset` is referenced by a `Release` the operation will fail.</p>
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	86	<p class="toc_element">
Thomas Coffee	2f24537	2017-03-27 10:39:26 -0700	[diff] [blame]	87	<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	88	<p class="firstline">Get a `Ruleset` by name including the full `Source` contents.</p>
				89	<p class="toc_element">
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame^]	90	<code><a href="#list">list(name, pageToken=None, pageSize=None, filter=None, x__xgafv=None)</a></code></p>
				91	<p class="firstline">List `Ruleset` metadata only and optionally filter the results by `Ruleset` name. The full `Source` contents of a `Ruleset` may be retrieved with GetRuleset.</p>
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	92	<p class="toc_element">
				93	<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
				94	<p class="firstline">Retrieves the next page of results.</p>
				95	<h3>Method Details</h3>
				96	<div class="method">
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame^]	97	<code class="details" id="close">close()</code>
				98	<pre>Close httplib2 connections.</pre>
				99	</div>
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	100
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame^]	101	<div class="method">
				102	<code class="details" id="create">create(name, body=None, x__xgafv=None)</code>
				103	<pre>Create a `Ruleset` from `Source`. The `Ruleset` is given a unique generated name which is returned to the caller. `Source` containing syntactic or semantics errors will result in an error response indicating the first error encountered. For a detailed view of `Source` issues, use TestRuleset.
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	104
				105	Args:
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame^]	106	name: string, Resource name for Project which owns this `Ruleset`. Format: `projects/{project_id}` (required)
Dan O'Meara	dd49464	2020-05-01 07:42:23 -0700	[diff] [blame]	107	body: object, The request body.
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	108	The object takes the form of:
				109
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame^]	110	{ # `Ruleset` is an immutable copy of `Source` with a globally unique identifier and a creation time.
				111	"name": "A String", # Name of the `Ruleset`. The ruleset_id is auto generated by the service. Format: `projects/{project_id}/rulesets/{ruleset_id}` Output only.
				112	"createTime": "A String", # Time the `Ruleset` was created. Output only.
				113	"metadata": { # Metadata for a Ruleset. # The metadata for this ruleset. Output only.
				114	"services": [ # Services that this ruleset has declarations for (e.g., "cloud.firestore"). There may be 0+ of these.
				115	"A String",
				116	],
				117	},
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	118	"source": { # `Source` is one or more `File` messages comprising a logical set of rules. # `Source` for the `Ruleset`.
				119	"files": [ # `File` set constituting the `Source` bundle.
				120	{ # `File` containing source content.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	121	"fingerprint": "A String", # Fingerprint (e.g. github sha) associated with the `File`.
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	122	"content": "A String", # Textual Content.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame^]	123	"name": "A String", # File name.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	124	},
				125	],
				126	},
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame^]	127	}
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	128
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	129	x__xgafv: string, V1 error format.
				130	Allowed values
				131	1 - v1 error format
				132	2 - v2 error format
				133
				134	Returns:
				135	An object of the form:
				136
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame^]	137	{ # `Ruleset` is an immutable copy of `Source` with a globally unique identifier and a creation time.
				138	"name": "A String", # Name of the `Ruleset`. The ruleset_id is auto generated by the service. Format: `projects/{project_id}/rulesets/{ruleset_id}` Output only.
				139	"createTime": "A String", # Time the `Ruleset` was created. Output only.
				140	"metadata": { # Metadata for a Ruleset. # The metadata for this ruleset. Output only.
				141	"services": [ # Services that this ruleset has declarations for (e.g., "cloud.firestore"). There may be 0+ of these.
				142	"A String",
				143	],
				144	},
				145	"source": { # `Source` is one or more `File` messages comprising a logical set of rules. # `Source` for the `Ruleset`.
				146	"files": [ # `File` set constituting the `Source` bundle.
				147	{ # `File` containing source content.
				148	"fingerprint": "A String", # Fingerprint (e.g. github sha) associated with the `File`.
				149	"content": "A String", # Textual Content.
				150	"name": "A String", # File name.
				151	},
				152	],
				153	},
				154	}</pre>
				155	</div>
				156
				157	<div class="method">
				158	<code class="details" id="delete">delete(name, x__xgafv=None)</code>
				159	<pre>Delete a `Ruleset` by resource name. If the `Ruleset` is referenced by a `Release` the operation will fail.
				160
				161	Args:
				162	name: string, Resource name for the ruleset to delete. Format: `projects/{project_id}/rulesets/{ruleset_id}` (required)
				163	x__xgafv: string, V1 error format.
				164	Allowed values
				165	1 - v1 error format
				166	2 - v2 error format
				167
				168	Returns:
				169	An object of the form:
				170
				171	{ # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	172	}</pre>
				173	</div>
				174
				175	<div class="method">
Thomas Coffee	2f24537	2017-03-27 10:39:26 -0700	[diff] [blame]	176	<code class="details" id="get">get(name, x__xgafv=None)</code>
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	177	<pre>Get a `Ruleset` by name including the full `Source` contents.
				178
				179	Args:
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame^]	180	name: string, Resource name for the ruleset to get. Format: `projects/{project_id}/rulesets/{ruleset_id}` (required)
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	181	x__xgafv: string, V1 error format.
				182	Allowed values
				183	1 - v1 error format
				184	2 - v2 error format
				185
				186	Returns:
				187	An object of the form:
				188
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame^]	189	{ # `Ruleset` is an immutable copy of `Source` with a globally unique identifier and a creation time.
				190	"name": "A String", # Name of the `Ruleset`. The ruleset_id is auto generated by the service. Format: `projects/{project_id}/rulesets/{ruleset_id}` Output only.
				191	"createTime": "A String", # Time the `Ruleset` was created. Output only.
				192	"metadata": { # Metadata for a Ruleset. # The metadata for this ruleset. Output only.
				193	"services": [ # Services that this ruleset has declarations for (e.g., "cloud.firestore"). There may be 0+ of these.
				194	"A String",
				195	],
				196	},
				197	"source": { # `Source` is one or more `File` messages comprising a logical set of rules. # `Source` for the `Ruleset`.
				198	"files": [ # `File` set constituting the `Source` bundle.
				199	{ # `File` containing source content.
				200	"fingerprint": "A String", # Fingerprint (e.g. github sha) associated with the `File`.
				201	"content": "A String", # Textual Content.
				202	"name": "A String", # File name.
				203	},
				204	],
				205	},
				206	}</pre>
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	207	</div>
				208
				209	<div class="method">
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame^]	210	<code class="details" id="list">list(name, pageToken=None, pageSize=None, filter=None, x__xgafv=None)</code>
				211	<pre>List `Ruleset` metadata only and optionally filter the results by `Ruleset` name. The full `Source` contents of a `Ruleset` may be retrieved with GetRuleset.
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	212
				213	Args:
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame^]	214	name: string, Resource name for the project. Format: `projects/{project_id}` (required)
Bu Sun Kim	d059ad8	2020-07-22 17:02:09 -0700	[diff] [blame]	215	pageToken: string, Next page token for loading the next batch of `Ruleset` instances.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame^]	216	pageSize: integer, Page size to load. Maximum of 100. Defaults to 10. Note: `page_size` is just a hint and the service may choose to load less than `page_size` due to the size of the output. To traverse all of the releases, caller should iterate until the `page_token` is empty.
				217	filter: string, `Ruleset` filter. The list method supports filters with restrictions on `Ruleset.name`. Filters on `Ruleset.create_time` should use the `date` function which parses strings that conform to the RFC 3339 date/time specifications. Example: `create_time > date("2017-01-01T00:00:00Z") AND name=UUID-*`
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	218	x__xgafv: string, V1 error format.
				219	Allowed values
				220	1 - v1 error format
				221	2 - v2 error format
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	222
				223	Returns:
				224	An object of the form:
				225
Sai Cheemalapati	e833b79	2017-03-24 15:06:46 -0700	[diff] [blame]	226	{ # The response for FirebaseRulesService.ListRulesets.
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	227	"rulesets": [ # List of `Ruleset` instances.
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame^]	228	{ # `Ruleset` is an immutable copy of `Source` with a globally unique identifier and a creation time.
				229	"name": "A String", # Name of the `Ruleset`. The ruleset_id is auto generated by the service. Format: `projects/{project_id}/rulesets/{ruleset_id}` Output only.
				230	"createTime": "A String", # Time the `Ruleset` was created. Output only.
				231	"metadata": { # Metadata for a Ruleset. # The metadata for this ruleset. Output only.
				232	"services": [ # Services that this ruleset has declarations for (e.g., "cloud.firestore"). There may be 0+ of these.
				233	"A String",
				234	],
				235	},
				236	"source": { # `Source` is one or more `File` messages comprising a logical set of rules. # `Source` for the `Ruleset`.
				237	"files": [ # `File` set constituting the `Source` bundle.
				238	{ # `File` containing source content.
				239	"fingerprint": "A String", # Fingerprint (e.g. github sha) associated with the `File`.
				240	"content": "A String", # Textual Content.
				241	"name": "A String", # File name.
				242	},
				243	],
				244	},
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	245	},
				246	],
Dmitry Frenkel	3e17f89	2020-10-06 16:46:05 -0700	[diff] [blame^]	247	"nextPageToken": "A String", # The pagination token to retrieve the next page of results. If the value is empty, no further results remain.
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	248	}</pre>
				249	</div>
				250
				251	<div class="method">
				252	<code class="details" id="list_next">list_next(previous_request, previous_response)</code>
				253	<pre>Retrieves the next page of results.
				254
				255	Args:
				256	previous_request: The request for the previous page. (required)
				257	previous_response: The response from the request for the previous page. (required)
				258
				259	Returns:
Bu Sun Kim	6502091	2020-05-20 12:08:20 -0700	[diff] [blame]	260	A request object that you can call 'execute()' on to request the next
Jon Wayne Parrott	0a471d3	2016-05-19 10:54:38 -0700	[diff] [blame]	261	page. Returns None if there are no more items in the collection.
				262	</pre>
				263	</div>
				264
				265	</body></html>