OMGeeky/google-apis-rs
1
0
Fork 0
mirror of https://github.com/OMGeeky/google-apis-rs.git synced 2026-02-23 15:49:49 +01:00
Code Issues Packages Projects Releases Wiki Activity

Update to latest versions of API declarations

Browse Source
This commit is contained in:
Sebastian Thiel
2018-10-13 13:49:14 +02:00
parent 5a67475b54
commit 255c7f5ad5
1508 changed files with 819225 additions and 838421 deletions
Download Patch File Download Diff File Expand all files Collapse all files

125
etc/api/storage/v1/storage-api.json
View File

@@ -1,11 +1,11 @@
{
"kind": "discovery#restDescription",
"etag": "\"YWOzh2SDasdU84ArJnpYek-OMdg/x114uLAdo7We9s8BOFRemUcydyU\"",
"etag": "\"J3WqvAcMk4eQjJXvfSI4Yr8VouA/akd8i6K-8A6ohXFVzxQZomL5PpA\"",
"discoveryVersion": "v1",
"id": "storage:v1",
"name": "storage",
"version": "v1",
"revision": "20171101",
"revision": "20180905",
"title": "Cloud Storage JSON API",
"description": "Stores and retrieves potentially large, immutable data objects.",
"ownerDomain": "google.com",
@@ -23,7 +23,7 @@
"basePath": "/storage/v1/",
"rootUrl": "https://www.googleapis.com/",
"servicePath": "storage/v1/",
"batchPath": "batch",
"batchPath": "batch/storage/v1",
"parameters": {
"alt": {
"type": "string",
@@ -60,12 +60,12 @@
},
"quotaUser": {
"type": "string",
"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. Overrides userIp if both are provided.",
"description": "An opaque string that represents a user for quota purposes. Must not exceed 40 characters.",
"location": "query"
},
"userIp": {
"type": "string",
"description": "IP address of the site where the request originates. Use this if you want to enforce per-user limits.",
"description": "Deprecated. Please use quotaUser instead.",
"location": "query"
}
},
@@ -114,7 +114,7 @@
"properties": {
"requesterPays": {
"type": "boolean",
"description": "When set to true, bucket is requester pays."
"description": "When set to true, Requester Pays is enabled for this bucket."
}
}
},
@@ -153,6 +153,10 @@
}
}
},
"defaultEventBasedHold": {
"type": "boolean",
"description": "The default value for event-based hold on newly created objects in this bucket. Event-based hold is a way to retain objects indefinitely until an event occurs, signified by the hold's release. After being released, such objects will be subject to bucket-level retention (if any). One sample use case of this flag is for banks to hold loan documents for at least 3 years after loan is paid in full. Here, bucket-level retention is 3 years and the event is loan being paid in full. In this example, these objects will be held intact for any number of years until the event has occurred (event-based hold on the object is released) and then 3 more years after that. That means retention duration of the objects begins from the moment event-based hold transitioned from true to false. Objects under event-based hold cannot be deleted, overwritten or archived until the hold is removed."
},
"defaultObjectAcl": {
"type": "array",
"description": "Default access controls to apply to new objects when no ACL is provided.",
@@ -162,10 +166,11 @@
},
"encryption": {
"type": "object",
"description": "Encryption configuration used by default for newly inserted objects, when no encryption config is specified.",
"description": "Encryption configuration for a bucket.",
"properties": {
"defaultKmsKeyName": {
"type": "string"
"type": "string",
"description": "A Cloud KMS key that will be used to encrypt objects inserted into this bucket, if no encryption method is specified."
}
}
},
@@ -175,7 +180,7 @@
},
"id": {
"type": "string",
"description": "The ID of the bucket. For buckets, the id and name properities are the same."
"description": "The ID of the bucket. For buckets, the id and name properties are the same."
},
"kind": {
"type": "string",
@@ -232,6 +237,10 @@
"type": "boolean",
"description": "Relevant only for versioned objects. If the value is true, this condition matches live objects; if the value is false, it matches archived objects."
},
"matchesPattern": {
"type": "string",
"description": "A regular expression that satisfies the RE2 syntax. This condition is satisfied when the name of the object matches the RE2 pattern. Note: This feature is currently in the \"Early Access\" launch stage and is only available to a whitelisted set of users; that means that this feature may be changed in backward-incompatible ways and that it is not guaranteed to be released."
},
"matchesStorageClass": {
"type": "array",
"description": "Objects having any of the storage classes specified by this condition will be matched. Values include MULTI_REGIONAL, REGIONAL, NEARLINE, COLDLINE, STANDARD, and DURABLE_REDUCED_AVAILABILITY.",
@@ -302,6 +311,26 @@
"description": "The project number of the project the bucket belongs to.",
"format": "uint64"
},
"retentionPolicy": {
"type": "object",
"description": "The bucket's retention policy. The retention policy enforces a minimum retention time for all objects contained in the bucket, based on their creation time. Any attempt to overwrite or delete objects younger than the retention period will result in a PERMISSION_DENIED error. An unlocked retention policy can be modified or removed from the bucket via a storage.buckets.update operation. A locked retention policy cannot be removed or shortened in duration for the lifetime of the bucket. Attempting to remove or decrease period of a locked retention policy will result in a PERMISSION_DENIED error.",
"properties": {
"effectiveTime": {
"type": "string",
"description": "Server-determined value that indicates the time from which policy was enforced and effective. This value is in RFC 3339 format.",
"format": "date-time"
},
"isLocked": {
"type": "boolean",
"description": "Once locked, an object retention policy cannot be modified."
},
"retentionPeriod": {
"type": "string",
"description": "The duration in seconds that objects need to be retained. Retention duration must be greater than zero and less than 100 years. Note that enforcement of retention periods less than a day is not guaranteed. Such periods should only be used for testing purposes.",
"format": "int64"
}
}
},
"selfLink": {
"type": "string",
"description": "The URI of this bucket."
@@ -540,7 +569,7 @@
},
"name": {
"type": "string",
"description": "The source object's name. The source object's bucket is implicitly the destination bucket.",
"description": "The source object's name. All source objects must reside in the same bucket.",
"annotations": {
"required": [
"storage.objects.compose"
@@ -607,7 +636,12 @@
"payload_format": {
"type": "string",
"description": "The desired content of the Payload.",
"default": "JSON_API_V1"
"default": "JSON_API_V1",
"annotations": {
"required": [
"storage.notifications.insert"
]
}
},
"selfLink": {
"type": "string",
@@ -711,6 +745,10 @@
"type": "string",
"description": "HTTP 1.1 Entity tag for the object."
},
"eventBasedHold": {
"type": "boolean",
"description": "Whether an object is under event-based hold. Event-based hold is a way to retain objects until an event occurs, which is signified by the hold's release (i.e. this value is set to false). After being released (set to false), such objects will be subject to bucket-level retention (if any). One sample use case of this flag is for banks to hold loan documents for at least 3 years after loan is paid in full. Here, bucket-level retention is 3 years and the event is the loan being paid in full. In this example, these objects will be held intact for any number of years until the event has occurred (event-based hold on the object is released) and then 3 more years after that. That means retention duration of the objects begins from the moment event-based hold transitioned from true to false."
},
"generation": {
"type": "string",
"description": "The content generation of this object. Used for object versioning.",
@@ -768,6 +806,11 @@
}
}
},
"retentionExpirationTime": {
"type": "string",
"description": "A server-determined value that specifies the earliest time that the object's retention period expires. This value is in RFC 3339 format. Note 1: This field is not provided for objects with an active event-based hold, since retention expiration is unknown until the hold is removed. Note 2: This value can be provided even when temporary hold is set (so that the user can reason about policy without having to first unset the temporary hold).",
"format": "date-time"
},
"selfLink": {
"type": "string",
"description": "The link to this object."
@@ -781,6 +824,10 @@
"type": "string",
"description": "Storage class of the object."
},
"temporaryHold": {
"type": "boolean",
"description": "Whether an object is under temporary hold. While this flag is set to true, the object is protected against deletion and overwrites. A common use case of this flag is regulatory investigations where objects need to be retained while the investigation is ongoing. Note that unlike event-based hold, temporary hold does not impact retention expiration time of an object."
},
"timeCreated": {
"type": "string",
"description": "The creation time of the object in RFC 3339 format.",
@@ -1204,7 +1251,7 @@
"id": "storage.bucketAccessControls.patch",
"path": "b/{bucket}/acl/{entity}",
"httpMethod": "PATCH",
"description": "Updates an ACL entry on the specified bucket. This method supports patch semantics.",
"description": "Patches an ACL entry on the specified bucket.",
"parameters": {
"bucket": {
"type": "string",
@@ -1559,6 +1606,44 @@
"https://www.googleapis.com/auth/devstorage.read_write"
]
},
"lockRetentionPolicy": {
"id": "storage.buckets.lockRetentionPolicy",
"path": "b/{bucket}/lockRetentionPolicy",
"httpMethod": "POST",
"description": "Locks retention policy on a bucket.",
"parameters": {
"bucket": {
"type": "string",
"description": "Name of a bucket.",
"required": true,
"location": "path"
},
"ifMetagenerationMatch": {
"type": "string",
"description": "Makes the operation conditional on whether bucket's current metageneration matches the given value.",
"required": true,
"format": "int64",
"location": "query"
},
"userProject": {
"type": "string",
"description": "The project to be billed for this request. Required for Requester Pays buckets.",
"location": "query"
}
},
"parameterOrder": [
"bucket",
"ifMetagenerationMatch"
],
"response": {
"$ref": "Bucket"
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/devstorage.full_control",
"https://www.googleapis.com/auth/devstorage.read_write"
]
},
"patch": {
"id": "storage.buckets.patch",
"path": "b/{bucket}",
@@ -1997,7 +2082,7 @@
"id": "storage.defaultObjectAccessControls.patch",
"path": "b/{bucket}/defaultObjectAcl/{entity}",
"httpMethod": "PATCH",
"description": "Updates a default object ACL entry on the specified bucket. This method supports patch semantics.",
"description": "Patches a default object ACL entry on the specified bucket.",
"parameters": {
"bucket": {
"type": "string",
@@ -2403,7 +2488,7 @@
"id": "storage.objectAccessControls.patch",
"path": "b/{bucket}/o/{object}/acl/{entity}",
"httpMethod": "PATCH",
"description": "Updates an ACL entry on the specified object. This method supports patch semantics.",
"description": "Patches an ACL entry on the specified object.",
"parameters": {
"bucket": {
"type": "string",
@@ -2515,7 +2600,7 @@
"parameters": {
"destinationBucket": {
"type": "string",
"description": "Name of the bucket in which to store the new object.",
"description": "Name of the bucket containing the source objects. The destination object is stored in this bucket.",
"required": true,
"location": "path"
},
@@ -3059,6 +3144,11 @@
"description": "Returns results in a directory-like mode. items will contain only objects whose names, aside from the prefix, do not contain delimiter. Objects whose names, aside from the prefix, contain delimiter will have their name, truncated after the delimiter, returned in prefixes. Duplicate prefixes are omitted.",
"location": "query"
},
"includeTrailingDelimiter": {
"type": "boolean",
"description": "If true, objects that end in exactly one instance of delimiter will have their metadata included in items in addition to prefixes.",
"location": "query"
},
"maxResults": {
"type": "integer",
"description": "Maximum number of items plus prefixes to return in a single page of responses. As duplicate prefixes are omitted, fewer total results may be returned than requested. The service will use this parameter or 1,000 items, whichever is smaller.",
@@ -3596,6 +3686,11 @@
"description": "Returns results in a directory-like mode. items will contain only objects whose names, aside from the prefix, do not contain delimiter. Objects whose names, aside from the prefix, contain delimiter will have their name, truncated after the delimiter, returned in prefixes. Duplicate prefixes are omitted.",
"location": "query"
},
"includeTrailingDelimiter": {
"type": "boolean",
"description": "If true, objects that end in exactly one instance of delimiter will have their metadata included in items in addition to prefixes.",
"location": "query"
},
"maxResults": {
"type": "integer",
"description": "Maximum number of items plus prefixes to return in a single page of responses. As duplicate prefixes are omitted, fewer total results may be returned than requested. The service will use this parameter or 1,000 items, whichever is smaller.",