Home | History | Annotate | Download | only in dyn
      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">
     78   <code><a href="#create">create(name, body, x__xgafv=None)</a></code></p>
     79 <p class="firstline">Create a `Ruleset` from `Source`.</p>
     80 <p class="toc_element">
     81   <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
     82 <p class="firstline">Delete a `Ruleset` by resource name.</p>
     83 <p class="toc_element">
     84   <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
     85 <p class="firstline">Get a `Ruleset` by name including the full `Source` contents.</p>
     86 <p class="toc_element">
     87   <code><a href="#list">list(name, pageSize=None, filter=None, pageToken=None, x__xgafv=None)</a></code></p>
     88 <p class="firstline">List `Ruleset` metadata only and optionally filter the results by `Ruleset`</p>
     89 <p class="toc_element">
     90   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
     91 <p class="firstline">Retrieves the next page of results.</p>
     92 <h3>Method Details</h3>
     93 <div class="method">
     94     <code class="details" id="create">create(name, body, x__xgafv=None)</code>
     95   <pre>Create a `Ruleset` from `Source`.
     96 
     97 The `Ruleset` is given a unique generated name which is returned to the
     98 caller. `Source` containing syntactic or semantics errors will result in an
     99 error response indicating the first error encountered. For a detailed view
    100 of `Source` issues, use TestRuleset.
    101 
    102 Args:
    103   name: string, Resource name for Project which owns this `Ruleset`.
    104 
    105 Format: `projects/{project_id}` (required)
    106   body: object, The request body. (required)
    107     The object takes the form of:
    108 
    109 { # `Ruleset` is an immutable copy of `Source` with a globally unique identifier
    110       # and a creation time.
    111     "source": { # `Source` is one or more `File` messages comprising a logical set of rules. # `Source` for the `Ruleset`.
    112       "files": [ # `File` set constituting the `Source` bundle.
    113         { # `File` containing source content.
    114           "content": "A String", # Textual Content.
    115           "name": "A String", # File name.
    116           "fingerprint": "A String", # Fingerprint (e.g. github sha) associated with the `File`.
    117         },
    118       ],
    119     },
    120     "name": "A String", # Name of the `Ruleset`. The ruleset_id is auto generated by the service.
    121         # Format: `projects/{project_id}/rulesets/{ruleset_id}`
    122         # Output only.
    123     "createTime": "A String", # Time the `Ruleset` was created.
    124         # Output only.
    125   }
    126 
    127   x__xgafv: string, V1 error format.
    128     Allowed values
    129       1 - v1 error format
    130       2 - v2 error format
    131 
    132 Returns:
    133   An object of the form:
    134 
    135     { # `Ruleset` is an immutable copy of `Source` with a globally unique identifier
    136         # and a creation time.
    137       "source": { # `Source` is one or more `File` messages comprising a logical set of rules. # `Source` for the `Ruleset`.
    138         "files": [ # `File` set constituting the `Source` bundle.
    139           { # `File` containing source content.
    140             "content": "A String", # Textual Content.
    141             "name": "A String", # File name.
    142             "fingerprint": "A String", # Fingerprint (e.g. github sha) associated with the `File`.
    143           },
    144         ],
    145       },
    146       "name": "A String", # Name of the `Ruleset`. The ruleset_id is auto generated by the service.
    147           # Format: `projects/{project_id}/rulesets/{ruleset_id}`
    148           # Output only.
    149       "createTime": "A String", # Time the `Ruleset` was created.
    150           # Output only.
    151     }</pre>
    152 </div>
    153 
    154 <div class="method">
    155     <code class="details" id="delete">delete(name, x__xgafv=None)</code>
    156   <pre>Delete a `Ruleset` by resource name.
    157 
    158 If the `Ruleset` is referenced by a `Release` the operation will fail.
    159 
    160 Args:
    161   name: string, Resource name for the ruleset to delete.
    162 
    163 Format: `projects/{project_id}/rulesets/{ruleset_id}` (required)
    164   x__xgafv: string, V1 error format.
    165     Allowed values
    166       1 - v1 error format
    167       2 - v2 error format
    168 
    169 Returns:
    170   An object of the form:
    171 
    172     { # A generic empty message that you can re-use to avoid defining duplicated
    173       # empty messages in your APIs. A typical example is to use it as the request
    174       # or the response type of an API method. For instance:
    175       #
    176       #     service Foo {
    177       #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
    178       #     }
    179       #
    180       # The JSON representation for `Empty` is empty JSON object `{}`.
    181   }</pre>
    182 </div>
    183 
    184 <div class="method">
    185     <code class="details" id="get">get(name, x__xgafv=None)</code>
    186   <pre>Get a `Ruleset` by name including the full `Source` contents.
    187 
    188 Args:
    189   name: string, Resource name for the ruleset to get.
    190 
    191 Format: `projects/{project_id}/rulesets/{ruleset_id}` (required)
    192   x__xgafv: string, V1 error format.
    193     Allowed values
    194       1 - v1 error format
    195       2 - v2 error format
    196 
    197 Returns:
    198   An object of the form:
    199 
    200     { # `Ruleset` is an immutable copy of `Source` with a globally unique identifier
    201         # and a creation time.
    202       "source": { # `Source` is one or more `File` messages comprising a logical set of rules. # `Source` for the `Ruleset`.
    203         "files": [ # `File` set constituting the `Source` bundle.
    204           { # `File` containing source content.
    205             "content": "A String", # Textual Content.
    206             "name": "A String", # File name.
    207             "fingerprint": "A String", # Fingerprint (e.g. github sha) associated with the `File`.
    208           },
    209         ],
    210       },
    211       "name": "A String", # Name of the `Ruleset`. The ruleset_id is auto generated by the service.
    212           # Format: `projects/{project_id}/rulesets/{ruleset_id}`
    213           # Output only.
    214       "createTime": "A String", # Time the `Ruleset` was created.
    215           # Output only.
    216     }</pre>
    217 </div>
    218 
    219 <div class="method">
    220     <code class="details" id="list">list(name, pageSize=None, filter=None, pageToken=None, x__xgafv=None)</code>
    221   <pre>List `Ruleset` metadata only and optionally filter the results by `Ruleset`
    222 name.
    223 
    224 The full `Source` contents of a `Ruleset` may be retrieved with
    225 GetRuleset.
    226 
    227 Args:
    228   name: string, Resource name for the project.
    229 
    230 Format: `projects/{project_id}` (required)
    231   pageSize: integer, Page size to load. Maximum of 100. Defaults to 10.
    232 Note: `page_size` is just a hint and the service may choose to load less
    233 than `page_size` due to the size of the output. To traverse all of the
    234 releases, caller should iterate until the `page_token` is empty.
    235   filter: string, `Ruleset` filter. The list method supports filters with restrictions on
    236 `Ruleset.name`.
    237 
    238 Filters on `Ruleset.create_time` should use the `date` function which
    239 parses strings that conform to the RFC 3339 date/time specifications.
    240 
    241 Example: `create_time > date("2017-01-01") AND name=UUID-*`
    242   pageToken: string, Next page token for loading the next batch of `Ruleset` instances.
    243   x__xgafv: string, V1 error format.
    244     Allowed values
    245       1 - v1 error format
    246       2 - v2 error format
    247 
    248 Returns:
    249   An object of the form:
    250 
    251     { # The response for FirebaseRulesService.ListRulesets.
    252     "nextPageToken": "A String", # The pagination token to retrieve the next page of results. If the value is
    253         # empty, no further results remain.
    254     "rulesets": [ # List of `Ruleset` instances.
    255       { # `Ruleset` is an immutable copy of `Source` with a globally unique identifier
    256             # and a creation time.
    257           "source": { # `Source` is one or more `File` messages comprising a logical set of rules. # `Source` for the `Ruleset`.
    258             "files": [ # `File` set constituting the `Source` bundle.
    259               { # `File` containing source content.
    260                 "content": "A String", # Textual Content.
    261                 "name": "A String", # File name.
    262                 "fingerprint": "A String", # Fingerprint (e.g. github sha) associated with the `File`.
    263               },
    264             ],
    265           },
    266           "name": "A String", # Name of the `Ruleset`. The ruleset_id is auto generated by the service.
    267               # Format: `projects/{project_id}/rulesets/{ruleset_id}`
    268               # Output only.
    269           "createTime": "A String", # Time the `Ruleset` was created.
    270               # Output only.
    271         },
    272     ],
    273   }</pre>
    274 </div>
    275 
    276 <div class="method">
    277     <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
    278   <pre>Retrieves the next page of results.
    279 
    280 Args:
    281   previous_request: The request for the previous page. (required)
    282   previous_response: The response from the request for the previous page. (required)
    283 
    284 Returns:
    285   A request object that you can call 'execute()' on to request the next
    286   page. Returns None if there are no more items in the collection.
    287     </pre>
    288 </div>
    289 
    290 </body></html>