Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / dd49464a6262c0d1f71efcf11f131e2f591fe5f6 / . / docs / dyn / cloudasset_v1beta1.projects.html
blob: 467bc110c8eb24648688fbeaf9b2fb7222624496 [file] [log] [blame]
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]1<html><body>
2<style>
3
4body, 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
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, 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="cloudasset_v1beta1.html">Cloud Asset API</a> . <a href="cloudasset_v1beta1.projects.html">projects</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="cloudasset_v1beta1.projects.operations.html">operations()</a></code>
79</p>
80<p class="firstline">Returns the operations Resource.</p>
81
82<p class="toc_element">
83 <code><a href="#batchGetAssetsHistory">batchGetAssetsHistory(parent, contentType=None, assetNames=None, readTimeWindow_startTime=None, readTimeWindow_endTime=None, x__xgafv=None)</a></code></p>
84<p class="firstline">Batch gets the update history of assets that overlap a time window.</p>
85<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]86 <code><a href="#exportAssets">exportAssets(parent, body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]87<p class="firstline">Exports assets with time and resource types to a given Cloud Storage</p>
88<h3>Method Details</h3>
89<div class="method">
90 <code class="details" id="batchGetAssetsHistory">batchGetAssetsHistory(parent, contentType=None, assetNames=None, readTimeWindow_startTime=None, readTimeWindow_endTime=None, x__xgafv=None)</code>
91 <pre>Batch gets the update history of assets that overlap a time window.
92For RESOURCE content, this API outputs history with asset in both
93non-delete or deleted status.
94For IAM_POLICY content, this API outputs history when the asset and its
95attached IAM POLICY both exist. This can create gaps in the output history.
96If a specified asset does not exist, this API returns an INVALID_ARGUMENT
97error.
98
99Args:
100 parent: string, Required. The relative name of the root asset. It can only be an
101organization number (such as "organizations/123"), a project ID (such as
102"projects/my-project-id")", or a project number (such as "projects/12345"). (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]103 contentType: string, Optional. The content type.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]104 assetNames: string, A list of the full names of the assets. For example:
105`//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
106See [Resource
107Names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
108for more info.
109
110The request becomes a no-op if the asset name list is empty, and the max
111size of the asset name list is 100 in one request. (repeated)
112 readTimeWindow_startTime: string, Start time of the time window (exclusive).
113 readTimeWindow_endTime: string, End time of the time window (inclusive).
114Current timestamp if not specified.
115 x__xgafv: string, V1 error format.
116 Allowed values
117 1 - v1 error format
118 2 - v2 error format
119
120Returns:
121 An object of the form:
122
123 { # Batch get assets history response.
124 "assets": [ # A list of assets with valid time windows.
125 { # Temporal asset. In addition to the asset, the temporal asset includes the
126 # status of the asset and valid from and to time of it.
127 "deleted": True or False, # If the asset is deleted or not.
128 "window": { # A time window of (start_time, end_time]. # The time window when the asset data and state was observed.
129 "endTime": "A String", # End time of the time window (inclusive).
130 # Current timestamp if not specified.
131 "startTime": "A String", # Start time of the time window (exclusive).
132 },
133 "asset": { # Cloud asset. This includes all Google Cloud Platform resources, # Asset.
134 # Cloud IAM policies, and other non-GCP assets.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]135 "iamPolicy": { # An Identity and Access Management (IAM) policy, which specifies access # Representation of the actual Cloud IAM policy set on a cloud resource. For
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]136 # each resource, there must be at most one Cloud IAM policy set on it.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]137 # controls for Google Cloud resources.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]138 #
139 #
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]140 # A `Policy` is a collection of `bindings`. A `binding` binds one or more
141 # `members` to a single `role`. Members can be user accounts, service accounts,
142 # Google groups, and domains (such as G Suite). A `role` is a named list of
143 # permissions; each `role` can be an IAM predefined role or a user-created
144 # custom role.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]145 #
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]146 # Optionally, a `binding` can specify a `condition`, which is a logical
147 # expression that allows access to a resource only if the expression evaluates
148 # to `true`. A condition can add constraints based on attributes of the
149 # request, the resource, or both.
150 #
151 # **JSON example:**
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]152 #
153 # {
154 # "bindings": [
155 # {
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]156 # "role": "roles/resourcemanager.organizationAdmin",
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]157 # "members": [
158 # "user:mike@example.com",
159 # "group:admins@example.com",
160 # "domain:google.com",
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]161 # "serviceAccount:my-project-id@appspot.gserviceaccount.com"
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]162 # ]
163 # },
164 # {
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]165 # "role": "roles/resourcemanager.organizationViewer",
166 # "members": ["user:eve@example.com"],
167 # "condition": {
168 # "title": "expirable access",
169 # "description": "Does not grant access after Sep 2020",
170 # "expression": "request.time &lt; timestamp('2020-10-01T00:00:00.000Z')",
171 # }
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]172 # }
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]173 # ],
174 # "etag": "BwWWja0YfJA=",
175 # "version": 3
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]176 # }
177 #
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]178 # **YAML example:**
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]179 #
180 # bindings:
181 # - members:
182 # - user:mike@example.com
183 # - group:admins@example.com
184 # - domain:google.com
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]185 # - serviceAccount:my-project-id@appspot.gserviceaccount.com
186 # role: roles/resourcemanager.organizationAdmin
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]187 # - members:
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]188 # - user:eve@example.com
189 # role: roles/resourcemanager.organizationViewer
190 # condition:
191 # title: expirable access
192 # description: Does not grant access after Sep 2020
193 # expression: request.time &lt; timestamp('2020-10-01T00:00:00.000Z')
194 # - etag: BwWWja0YfJA=
195 # - version: 3
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]196 #
197 # For a description of IAM and its features, see the
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]198 # [IAM documentation](https://cloud.google.com/iam/docs/).
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]199 "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
200 { # Specifies the audit configuration for a service.
201 # The configuration determines which permission types are logged, and what
202 # identities, if any, are exempted from logging.
203 # An AuditConfig must have one or more AuditLogConfigs.
204 #
205 # If there are AuditConfigs for both `allServices` and a specific service,
206 # the union of the two AuditConfigs is used for that service: the log_types
207 # specified in each AuditConfig are enabled, and the exempted_members in each
208 # AuditLogConfig are exempted.
209 #
210 # Example Policy with multiple AuditConfigs:
211 #
212 # {
213 # "audit_configs": [
214 # {
215 # "service": "allServices"
216 # "audit_log_configs": [
217 # {
218 # "log_type": "DATA_READ",
219 # "exempted_members": [
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]220 # "user:jose@example.com"
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]221 # ]
222 # },
223 # {
224 # "log_type": "DATA_WRITE",
225 # },
226 # {
227 # "log_type": "ADMIN_READ",
228 # }
229 # ]
230 # },
231 # {
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]232 # "service": "sampleservice.googleapis.com"
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]233 # "audit_log_configs": [
234 # {
235 # "log_type": "DATA_READ",
236 # },
237 # {
238 # "log_type": "DATA_WRITE",
239 # "exempted_members": [
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]240 # "user:aliya@example.com"
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]241 # ]
242 # }
243 # ]
244 # }
245 # ]
246 # }
247 #
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]248 # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
249 # logging. It also exempts jose@example.com from DATA_READ logging, and
250 # aliya@example.com from DATA_WRITE logging.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]251 "auditLogConfigs": [ # The configuration for logging of each type of permission.
252 { # Provides the configuration for logging a type of permissions.
253 # Example:
254 #
255 # {
256 # "audit_log_configs": [
257 # {
258 # "log_type": "DATA_READ",
259 # "exempted_members": [
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]260 # "user:jose@example.com"
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]261 # ]
262 # },
263 # {
264 # "log_type": "DATA_WRITE",
265 # }
266 # ]
267 # }
268 #
269 # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]270 # jose@example.com from DATA_READ logging.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]271 "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of
272 # permission.
273 # Follows the same format of Binding.members.
274 "A String",
275 ],
276 "logType": "A String", # The log type that this config enables.
277 },
278 ],
279 "service": "A String", # Specifies a service that will be enabled for audit logging.
280 # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
281 # `allServices` is a special value that covers all services.
282 },
283 ],
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]284 "version": 42, # Specifies the format of the policy.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]285 #
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]286 # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
287 # are rejected.
288 #
289 # Any operation that affects conditional role bindings must specify version
290 # `3`. This requirement applies to the following operations:
291 #
292 # * Getting a policy that includes a conditional role binding
293 # * Adding a conditional role binding to a policy
294 # * Changing a conditional role binding in a policy
295 # * Removing any role binding, with or without a condition, from a policy
296 # that includes conditions
297 #
298 # **Important:** If you use IAM Conditions, you must include the `etag` field
299 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
300 # you to overwrite a version `3` policy with a version `1` policy, and all of
301 # the conditions in the version `3` policy are lost.
302 #
303 # If a policy does not include any conditions, operations on that policy may
304 # specify any valid version or leave the field unset.
305 "bindings": [ # Associates a list of `members` to a `role`. Optionally, may specify a
306 # `condition` that determines how and when the `bindings` are applied. Each
307 # of the `bindings` must contain at least one member.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]308 { # Associates `members` with a `role`.
309 "role": "A String", # Role that is assigned to `members`.
310 # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
311 "members": [ # Specifies the identities requesting access for a Cloud Platform resource.
312 # `members` can have the following values:
313 #
314 # * `allUsers`: A special identifier that represents anyone who is
315 # on the internet; with or without a Google account.
316 #
317 # * `allAuthenticatedUsers`: A special identifier that represents anyone
318 # who is authenticated with a Google account or a service account.
319 #
320 # * `user:{emailid}`: An email address that represents a specific Google
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]321 # account. For example, `alice@example.com` .
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]322 #
323 #
324 # * `serviceAccount:{emailid}`: An email address that represents a service
325 # account. For example, `my-other-app@appspot.gserviceaccount.com`.
326 #
327 # * `group:{emailid}`: An email address that represents a Google group.
328 # For example, `admins@example.com`.
329 #
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]330 # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
331 # identifier) representing a user that has been recently deleted. For
332 # example, `alice@example.com?uid=123456789012345678901`. If the user is
333 # recovered, this value reverts to `user:{emailid}` and the recovered user
334 # retains the role in the binding.
335 #
336 # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
337 # unique identifier) representing a service account that has been recently
338 # deleted. For example,
339 # `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`.
340 # If the service account is undeleted, this value reverts to
341 # `serviceAccount:{emailid}` and the undeleted service account retains the
342 # role in the binding.
343 #
344 # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
345 # identifier) representing a Google group that has been recently
346 # deleted. For example, `admins@example.com?uid=123456789012345678901`. If
347 # the group is recovered, this value reverts to `group:{emailid}` and the
348 # recovered group retains the role in the binding.
349 #
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]350 #
351 # * `domain:{domain}`: The G Suite domain (primary) that represents all the
352 # users of that domain. For example, `google.com` or `example.com`.
353 #
354 "A String",
355 ],
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]356 "condition": { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]357 # NOTE: An unsatisfied condition will not allow user access via current
358 # binding. Different bindings, including their conditions, are examined
359 # independently.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]360 # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
361 # are documented at https://github.com/google/cel-spec.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]362 #
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]363 # Example (Comparison):
364 #
365 # title: "Summary size limit"
366 # description: "Determines if a summary is less than 100 chars"
367 # expression: "document.summary.size() &lt; 100"
368 #
369 # Example (Equality):
370 #
371 # title: "Requestor is owner"
372 # description: "Determines if requestor is the document owner"
373 # expression: "document.owner == request.auth.claims.email"
374 #
375 # Example (Logic):
376 #
377 # title: "Public documents"
378 # description: "Determine whether the document should be publicly visible"
379 # expression: "document.type != 'private' &amp;&amp; document.type != 'internal'"
380 #
381 # Example (Data Manipulation):
382 #
383 # title: "Notification string"
384 # description: "Create a notification string with a timestamp."
385 # expression: "'New message received at ' + string(document.create_time)"
386 #
387 # The exact variables and functions that may be referenced within an expression
388 # are determined by the service that evaluates it. See the service
389 # documentation for additional information.
390 "description": "A String", # Optional. Description of the expression. This is a longer text which
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]391 # describes the expression, e.g. when hovered over it in a UI.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]392 "expression": "A String", # Textual representation of an expression in Common Expression Language
393 # syntax.
394 "location": "A String", # Optional. String indicating the location of the expression for error
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]395 # reporting, e.g. a file name and a position in the file.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]396 "title": "A String", # Optional. Title for the expression, i.e. a short string describing
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]397 # its purpose. This can be used e.g. in UIs which allow to enter the
398 # expression.
399 },
400 },
401 ],
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]402 "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help
403 # prevent simultaneous updates of a policy from overwriting each other.
404 # It is strongly suggested that systems make use of the `etag` in the
405 # read-modify-write cycle to perform policy updates in order to avoid race
406 # conditions: An `etag` is returned in the response to `getIamPolicy`, and
407 # systems are expected to put that etag in the request to `setIamPolicy` to
408 # ensure that their change will be applied to the same version of the policy.
409 #
410 # **Important:** If you use IAM Conditions, you must include the `etag` field
411 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
412 # you to overwrite a version `3` policy with a version `1` policy, and all of
413 # the conditions in the version `3` policy are lost.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]414 },
415 "assetType": "A String", # Type of the asset. Example: "google.compute.Disk".
416 "resource": { # Representation of a cloud resource. # Representation of the resource.
417 "resourceUrl": "A String", # The REST URL for accessing the resource. An HTTP GET operation using this
418 # URL returns the resource itself.
419 # Example:
420 # `https://cloudresourcemanager.googleapis.com/v1/projects/my-project-123`.
421 # It will be left unspecified for resources without a REST API.
422 "parent": "A String", # The full name of the immediate parent of this resource. See
423 # [Resource
424 # Names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
425 # for more information.
426 #
427 # For GCP assets, it is the parent resource defined in the [Cloud IAM policy
428 # hierarchy](https://cloud.google.com/iam/docs/overview#policy_hierarchy).
429 # For example:
430 # `"//cloudresourcemanager.googleapis.com/projects/my_project_123"`.
431 #
432 # For third-party assets, it is up to the users to define.
433 "discoveryDocumentUri": "A String", # The URL of the discovery document containing the resource's JSON schema.
434 # For example:
435 # `"https://www.googleapis.com/discovery/v1/apis/compute/v1/rest"`.
436 # It will be left unspecified for resources without a discovery-based API,
437 # such as Cloud Bigtable.
438 "discoveryName": "A String", # The JSON schema name listed in the discovery document.
439 # Example: "Project". It will be left unspecified for resources (such as
440 # Cloud Bigtable) without a discovery-based API.
441 "version": "A String", # The API version. Example: "v1".
442 "data": { # The content of the resource, in which some sensitive fields are scrubbed
443 # away and may not be present.
444 "a_key": "", # Properties of the object.
445 },
446 },
447 "name": "A String", # The full name of the asset. For example:
448 # `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
449 # See [Resource
450 # Names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
451 # for more information.
452 },
453 },
454 ],
455 }</pre>
456</div>
457
458<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]459 <code class="details" id="exportAssets">exportAssets(parent, body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]460 <pre>Exports assets with time and resource types to a given Cloud Storage
461location. The output format is newline-delimited JSON.
462This API implements the google.longrunning.Operation API allowing you
463to keep track of the export.
464
465Args:
466 parent: string, Required. The relative name of the root asset. This can only be an
467organization number (such as "organizations/123"), a project ID (such as
468"projects/my-project-id"), a project number (such as "projects/12345"), or
469a folder number (such as "folders/123"). (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]470 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]471 The object takes the form of:
472
473{ # Export asset request.
474 "assetTypes": [ # A list of asset types of which to take a snapshot for. For example:
475 # "google.compute.Disk". If specified, only matching assets will be returned.
476 # See [Introduction to Cloud Asset
477 # Inventory](https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/overview)
478 # for all supported asset types.
479 "A String",
480 ],
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]481 "contentType": "A String", # Asset content type. If not specified, no content but the asset name will be
482 # returned.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]483 "outputConfig": { # Output configuration for export assets destination. # Required. Output configuration indicating where the results will be output
484 # to. All results will be in newline delimited JSON format.
485 "gcsDestination": { # A Cloud Storage location. # Destination on Cloud Storage.
486 "uriPrefix": "A String", # The uri prefix of all generated Cloud Storage objects. For example:
487 # "gs://bucket_name/object_name_prefix". Each object uri is in format:
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]488 # "gs://bucket_name/object_name_prefix/&lt;asset type&gt;/&lt;shard number&gt; and only
489 # contains assets for that type. &lt;shard number&gt; starts from 0. For example:
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]490 # "gs://bucket_name/object_name_prefix/google.compute.disk/0" is the first
491 # shard of output objects containing all google.compute.disk assets.
492 # An INVALID_ARGUMENT error will be returned if file with the same name
493 # "gs://bucket_name/object_name_prefix" already exists.
494 "uri": "A String", # The uri of the Cloud Storage object. It's the same uri that is used by
495 # gsutil. For example: "gs://bucket_name/object_name". See [Viewing and
496 # Editing Object
497 # Metadata](https://cloud.google.com/storage/docs/viewing-editing-metadata)
498 # for more information.
499 },
500 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]501 "readTime": "A String", # Timestamp to take an asset snapshot. This can only be set to a timestamp
502 # between 2018-10-02 UTC (inclusive) and the current time. If not specified,
503 # the current time will be used. Due to delays in resource data collection
504 # and indexing, there is a volatile window during which running the same
505 # query may get different results.
506 }
507
508 x__xgafv: string, V1 error format.
509 Allowed values
510 1 - v1 error format
511 2 - v2 error format
512
513Returns:
514 An object of the form:
515
516 { # This resource represents a long-running operation that is the result of a
517 # network API call.
518 "metadata": { # Service-specific metadata associated with the operation. It typically
519 # contains progress information and common metadata such as create time.
520 # Some services might not provide such metadata. Any method that returns a
521 # long-running operation should document the metadata type, if any.
522 "a_key": "", # Properties of the object. Contains field @type with type URL.
523 },
524 "error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
525 # different programming environments, including REST APIs and RPC APIs. It is
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]526 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
527 # three pieces of data: error code, error message, and error details.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]528 #
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]529 # You can find out more about this error model and how to work with it in the
530 # [API Design Guide](https://cloud.google.com/apis/design/errors).
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]531 "message": "A String", # A developer-facing error message, which should be in English. Any
532 # user-facing error message should be localized and sent in the
533 # google.rpc.Status.details field, or localized by the client.
534 "code": 42, # The status code, which should be an enum value of google.rpc.Code.
535 "details": [ # A list of messages that carry the error details. There is a common set of
536 # message types for APIs to use.
537 {
538 "a_key": "", # Properties of the object. Contains field @type with type URL.
539 },
540 ],
541 },
542 "done": True or False, # If the value is `false`, it means the operation is still in progress.
543 # If `true`, the operation is completed, and either `error` or `response` is
544 # available.
545 "response": { # The normal response of the operation in case of success. If the original
546 # method returns no data on success, such as `Delete`, the response is
547 # `google.protobuf.Empty`. If the original method is standard
548 # `Get`/`Create`/`Update`, the response should be the resource. For other
549 # methods, the response should have the type `XxxResponse`, where `Xxx`
550 # is the original method name. For example, if the original method name
551 # is `TakeSnapshot()`, the inferred response type is
552 # `TakeSnapshotResponse`.
553 "a_key": "", # Properties of the object. Contains field @type with type URL.
554 },
555 "name": "A String", # The server-assigned name, which is only unique within the same service that
556 # originally returns it. If you use the default HTTP mapping, the
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame^]557 # `name` should be a resource name ending with `operations/{unique_id}`.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]558 }</pre>
559</div>
560
561</body></html>