docs: update generated docs (#981)
diff --git a/docs/dyn/memcache_v1beta2.projects.locations.instances.html b/docs/dyn/memcache_v1beta2.projects.locations.instances.html
index ddd9941..87a47da 100644
--- a/docs/dyn/memcache_v1beta2.projects.locations.instances.html
+++ b/docs/dyn/memcache_v1beta2.projects.locations.instances.html
@@ -90,7 +90,7 @@
<code><a href="#getIamPolicy">getIamPolicy(resource, options_requestedPolicyVersion=None, x__xgafv=None)</a></code></p>
<p class="firstline">Gets the access control policy for a resource.</p>
<p class="toc_element">
- <code><a href="#list">list(parent, pageToken=None, orderBy=None, pageSize=None, filter=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(parent, filter=None, pageToken=None, pageSize=None, orderBy=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists Instances in a given project and location.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -120,12 +120,12 @@
The object takes the form of:
{ # Request for ApplyParameters.
- "applyAll": True or False, # Whether to apply instance-level parameter group to all nodes. If set to
- # true, will explicitly restrict users from specifying any nodes, and apply
- # parameter group updates to all nodes within the instance.
"nodeIds": [ # Nodes to which we should apply the instance-level parameter group.
"A String",
],
+ "applyAll": True or False, # Whether to apply instance-level parameter group to all nodes. If set to
+ # true, will explicitly restrict users from specifying any nodes, and apply
+ # parameter group updates to all nodes within the instance.
}
x__xgafv: string, V1 error format.
@@ -138,15 +138,24 @@
{ # This resource represents a long-running operation that is the result of a
# network API call.
- "metadata": { # Service-specific metadata associated with the operation. It typically
- # contains progress information and common metadata such as create time.
- # Some services might not provide such metadata. Any method that returns a
- # long-running operation should document the metadata type, if any.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
+ "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.
+ # different programming environments, including REST APIs and RPC APIs. It is
+ # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+ # three pieces of data: error code, error message, and error details.
+ #
+ # You can find out more about this error model and how to work with it in the
+ # [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "details": [ # A list of messages that carry the error details. There is a common set of
+ # message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
},
- "done": True or False, # If the value is `false`, it means the operation is still in progress.
- # If `true`, the operation is completed, and either `error` or `response` is
- # available.
"response": { # The normal response of the operation in case of success. If the original
# method returns no data on success, such as `Delete`, the response is
# `google.protobuf.Empty`. If the original method is standard
@@ -160,24 +169,15 @@
"name": "A String", # The server-assigned name, which is only unique within the same service that
# originally returns it. If you use the default HTTP mapping, the
# `name` should be a resource name ending with `operations/{unique_id}`.
- "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.
- # different programming environments, including REST APIs and RPC APIs. It is
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
- # three pieces of data: error code, error message, and error details.
- #
- # You can find out more about this error model and how to work with it in the
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
+ "metadata": { # Service-specific metadata associated with the operation. It typically
+ # contains progress information and common metadata such as create time.
+ # Some services might not provide such metadata. Any method that returns a
+ # long-running operation should document the metadata type, if any.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "done": True or False, # If the value is `false`, it means the operation is still in progress.
+ # If `true`, the operation is completed, and either `error` or `response` is
+ # available.
}</pre>
</div>
@@ -193,87 +193,87 @@
The object takes the form of:
{
- "memcacheNodes": [ # Output only. List of Memcached nodes.
- # Refer to [Node] message for more details.
- {
- "port": 42, # Output only. The port number of the Memcached server on this node.
- "nodeId": "A String", # Output only. Identifier of the Memcached node. The node id does not
- # include project or location like the Memcached instance name.
- "host": "A String", # Output only. Hostname or IP address of the Memcached node used by the
- # clients to connect to the Memcached server on this node.
- "zone": "A String", # Output only. Location (GCP Zone) for the Memcached node.
- "state": "A String", # Output only. Current state of the Memcached node.
- "parameters": { # User defined parameters currently applied to the node.
- "id": "A String", # Output only. The unique ID associated with this set of parameters. Users
- # can use this id to determine if the parameters associated with the instance
- # differ from the parameters associated with the nodes and any action needs
- # to be taken to apply parameters on nodes.
- "params": { # User defined set of parameters to use in the memcached process.
- "a_key": "A String",
- },
+ "parameters": { # Optional: User defined parameters to apply to the memcached process
+ # on each node.
+ "id": "A String", # Output only. The unique ID associated with this set of parameters. Users
+ # can use this id to determine if the parameters associated with the instance
+ # differ from the parameters associated with the nodes and any action needs
+ # to be taken to apply parameters on nodes.
+ "params": { # User defined set of parameters to use in the memcached process.
+ "a_key": "A String",
},
},
- ],
- "nodeConfig": { # Configuration for a Memcached Node. # Required. Configuration for Memcached nodes.
- "cpuCount": 42, # Required. Number of cpus per Memcached node.
- "memorySizeMb": 42, # Required. Memory size in MiB for each Memcached node.
- },
- "memcacheVersion": "A String", # Optional. The major version of Memcached software.
- # If not provided, latest supported version will be used. Currently the
- # latest supported major version is MEMCACHE_1_5.
- # The minor version will be automatically determined by our system based on
- # the latest supported minor version.
- "memcacheFullVersion": "A String", # Output only. The full version of memcached server running on this instance.
- # System automatically determines the full memcached version for an instance
- # based on the input MemcacheVersion.
- # The full version format will be "memcached-1.5.16".
- "instanceMessages": [ # List of messages that describe current statuses of memcached instance.
- {
- "code": "A String", # A code that correspond to one type of user-facing message.
- "message": "A String", # Message on memcached instance which will be exposed to users.
- },
- ],
- "authorizedNetwork": "A String", # Optional. The full name of the Google Compute Engine
- # [network](/compute/docs/networks-and-firewalls#networks) to which the
- # instance is connected. If left unspecified, the `default` network
- # will be used.
- "state": "A String", # Output only. The state of this Memcached instance.
- "name": "A String", # Required. Unique name of the resource in this scope including project and
- # location using the form:
- # `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
- #
- # Note: Memcached instances are managed and addressed at regional level so
- # location_id here refers to a GCP region; however, users may choose which
- # zones Memcached nodes within an instances should be provisioned in.
- # Refer to [zones] field for more details.
- "discoveryEndpoint": "A String", # Output only. Endpoint for Discovery API
- "displayName": "A String", # Optional. User provided name for the instance only used for display
- # purposes. Cannot be more than 80 characters.
- "nodeCount": 42, # Required. Number of nodes in the Memcached instance.
- "createTime": "A String", # Output only. The time the instance was created.
- "labels": { # Optional. Resource labels to represent user-provided metadata.
- # Refer to cloud documentation on labels for more details.
- # https://cloud.google.com/compute/docs/labeling-resources
- "a_key": "A String",
- },
- "zones": [ # Optional. Zones where Memcached nodes should be provisioned in.
- # Memcached nodes will be equally distributed across these zones. If not
- # provided, the service will by default create nodes in all zones in the
- # region for the instance.
- "A String",
- ],
- "updateTime": "A String", # Output only. The time the instance was updated.
- "parameters": { # Optional: User defined parameters to apply to the memcached process
- # on each node.
- "id": "A String", # Output only. The unique ID associated with this set of parameters. Users
- # can use this id to determine if the parameters associated with the instance
- # differ from the parameters associated with the nodes and any action needs
- # to be taken to apply parameters on nodes.
- "params": { # User defined set of parameters to use in the memcached process.
+ "zones": [ # Zones where Memcached nodes should be provisioned in.
+ # Memcached nodes will be equally distributed across these zones. If not
+ # provided, the service will by default create nodes in all zones in the
+ # region for the instance.
+ "A String",
+ ],
+ "nodeCount": 42, # Required. Number of nodes in the Memcached instance.
+ "instanceMessages": [ # List of messages that describe current statuses of memcached instance.
+ {
+ "message": "A String", # Message on memcached instance which will be exposed to users.
+ "code": "A String", # A code that correspond to one type of user-facing message.
+ },
+ ],
+ "discoveryEndpoint": "A String", # Output only. Endpoint for Discovery API
+ "createTime": "A String", # Output only. The time the instance was created.
+ "memcacheFullVersion": "A String", # Output only. The full version of memcached server running on this instance.
+ # System automatically determines the full memcached version for an instance
+ # based on the input MemcacheVersion.
+ # The full version format will be "memcached-1.5.16".
+ "labels": { # Resource labels to represent user-provided metadata.
+ # Refer to cloud documentation on labels for more details.
+ # https://cloud.google.com/compute/docs/labeling-resources
"a_key": "A String",
},
- },
-}
+ "displayName": "A String", # User provided name for the instance only used for display
+ # purposes. Cannot be more than 80 characters.
+ "memcacheNodes": [ # Output only. List of Memcached nodes.
+ # Refer to [Node] message for more details.
+ {
+ "nodeId": "A String", # Output only. Identifier of the Memcached node. The node id does not
+ # include project or location like the Memcached instance name.
+ "parameters": { # User defined parameters currently applied to the node.
+ "id": "A String", # Output only. The unique ID associated with this set of parameters. Users
+ # can use this id to determine if the parameters associated with the instance
+ # differ from the parameters associated with the nodes and any action needs
+ # to be taken to apply parameters on nodes.
+ "params": { # User defined set of parameters to use in the memcached process.
+ "a_key": "A String",
+ },
+ },
+ "state": "A String", # Output only. Current state of the Memcached node.
+ "zone": "A String", # Output only. Location (GCP Zone) for the Memcached node.
+ "host": "A String", # Output only. Hostname or IP address of the Memcached node used by the
+ # clients to connect to the Memcached server on this node.
+ "port": 42, # Output only. The port number of the Memcached server on this node.
+ },
+ ],
+ "state": "A String", # Output only. The state of this Memcached instance.
+ "memcacheVersion": "A String", # The major version of Memcached software.
+ # If not provided, latest supported version will be used. Currently the
+ # latest supported major version is MEMCACHE_1_5.
+ # The minor version will be automatically determined by our system based on
+ # the latest supported minor version.
+ "name": "A String", # Required. Unique name of the resource in this scope including project and
+ # location using the form:
+ # `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
+ #
+ # Note: Memcached instances are managed and addressed at regional level so
+ # location_id here refers to a GCP region; however, users may choose which
+ # zones Memcached nodes within an instances should be provisioned in.
+ # Refer to [zones] field for more details.
+ "updateTime": "A String", # Output only. The time the instance was updated.
+ "nodeConfig": { # Configuration for a Memcached Node. # Required. Configuration for Memcached nodes.
+ "memorySizeMb": 42, # Required. Memory size in MiB for each Memcached node.
+ "cpuCount": 42, # Required. Number of cpus per Memcached node.
+ },
+ "authorizedNetwork": "A String", # The full name of the Google Compute Engine
+ # [network](https://cloud.google.com/vpc/docs/vpc) to which the
+ # instance is connected. If left unspecified, the `default` network
+ # will be used.
+ }
instanceId: string, Required. The logical name of the Memcached instance in the user
project with the following restrictions:
@@ -293,15 +293,24 @@
{ # This resource represents a long-running operation that is the result of a
# network API call.
- "metadata": { # Service-specific metadata associated with the operation. It typically
- # contains progress information and common metadata such as create time.
- # Some services might not provide such metadata. Any method that returns a
- # long-running operation should document the metadata type, if any.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
+ "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.
+ # different programming environments, including REST APIs and RPC APIs. It is
+ # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+ # three pieces of data: error code, error message, and error details.
+ #
+ # You can find out more about this error model and how to work with it in the
+ # [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "details": [ # A list of messages that carry the error details. There is a common set of
+ # message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
},
- "done": True or False, # If the value is `false`, it means the operation is still in progress.
- # If `true`, the operation is completed, and either `error` or `response` is
- # available.
"response": { # The normal response of the operation in case of success. If the original
# method returns no data on success, such as `Delete`, the response is
# `google.protobuf.Empty`. If the original method is standard
@@ -315,24 +324,15 @@
"name": "A String", # The server-assigned name, which is only unique within the same service that
# originally returns it. If you use the default HTTP mapping, the
# `name` should be a resource name ending with `operations/{unique_id}`.
- "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.
- # different programming environments, including REST APIs and RPC APIs. It is
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
- # three pieces of data: error code, error message, and error details.
- #
- # You can find out more about this error model and how to work with it in the
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
+ "metadata": { # Service-specific metadata associated with the operation. It typically
+ # contains progress information and common metadata such as create time.
+ # Some services might not provide such metadata. Any method that returns a
+ # long-running operation should document the metadata type, if any.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "done": True or False, # If the value is `false`, it means the operation is still in progress.
+ # If `true`, the operation is completed, and either `error` or `response` is
+ # available.
}</pre>
</div>
@@ -354,15 +354,24 @@
{ # This resource represents a long-running operation that is the result of a
# network API call.
- "metadata": { # Service-specific metadata associated with the operation. It typically
- # contains progress information and common metadata such as create time.
- # Some services might not provide such metadata. Any method that returns a
- # long-running operation should document the metadata type, if any.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
+ "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.
+ # different programming environments, including REST APIs and RPC APIs. It is
+ # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+ # three pieces of data: error code, error message, and error details.
+ #
+ # You can find out more about this error model and how to work with it in the
+ # [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "details": [ # A list of messages that carry the error details. There is a common set of
+ # message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
},
- "done": True or False, # If the value is `false`, it means the operation is still in progress.
- # If `true`, the operation is completed, and either `error` or `response` is
- # available.
"response": { # The normal response of the operation in case of success. If the original
# method returns no data on success, such as `Delete`, the response is
# `google.protobuf.Empty`. If the original method is standard
@@ -376,24 +385,15 @@
"name": "A String", # The server-assigned name, which is only unique within the same service that
# originally returns it. If you use the default HTTP mapping, the
# `name` should be a resource name ending with `operations/{unique_id}`.
- "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.
- # different programming environments, including REST APIs and RPC APIs. It is
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
- # three pieces of data: error code, error message, and error details.
- #
- # You can find out more about this error model and how to work with it in the
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
+ "metadata": { # Service-specific metadata associated with the operation. It typically
+ # contains progress information and common metadata such as create time.
+ # Some services might not provide such metadata. Any method that returns a
+ # long-running operation should document the metadata type, if any.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "done": True or False, # If the value is `false`, it means the operation is still in progress.
+ # If `true`, the operation is completed, and either `error` or `response` is
+ # available.
}</pre>
</div>
@@ -414,87 +414,87 @@
An object of the form:
{
- "memcacheNodes": [ # Output only. List of Memcached nodes.
- # Refer to [Node] message for more details.
- {
- "port": 42, # Output only. The port number of the Memcached server on this node.
- "nodeId": "A String", # Output only. Identifier of the Memcached node. The node id does not
- # include project or location like the Memcached instance name.
- "host": "A String", # Output only. Hostname or IP address of the Memcached node used by the
- # clients to connect to the Memcached server on this node.
- "zone": "A String", # Output only. Location (GCP Zone) for the Memcached node.
- "state": "A String", # Output only. Current state of the Memcached node.
- "parameters": { # User defined parameters currently applied to the node.
- "id": "A String", # Output only. The unique ID associated with this set of parameters. Users
- # can use this id to determine if the parameters associated with the instance
- # differ from the parameters associated with the nodes and any action needs
- # to be taken to apply parameters on nodes.
- "params": { # User defined set of parameters to use in the memcached process.
- "a_key": "A String",
- },
+ "parameters": { # Optional: User defined parameters to apply to the memcached process
+ # on each node.
+ "id": "A String", # Output only. The unique ID associated with this set of parameters. Users
+ # can use this id to determine if the parameters associated with the instance
+ # differ from the parameters associated with the nodes and any action needs
+ # to be taken to apply parameters on nodes.
+ "params": { # User defined set of parameters to use in the memcached process.
+ "a_key": "A String",
},
},
- ],
- "nodeConfig": { # Configuration for a Memcached Node. # Required. Configuration for Memcached nodes.
- "cpuCount": 42, # Required. Number of cpus per Memcached node.
- "memorySizeMb": 42, # Required. Memory size in MiB for each Memcached node.
- },
- "memcacheVersion": "A String", # Optional. The major version of Memcached software.
- # If not provided, latest supported version will be used. Currently the
- # latest supported major version is MEMCACHE_1_5.
- # The minor version will be automatically determined by our system based on
- # the latest supported minor version.
- "memcacheFullVersion": "A String", # Output only. The full version of memcached server running on this instance.
- # System automatically determines the full memcached version for an instance
- # based on the input MemcacheVersion.
- # The full version format will be "memcached-1.5.16".
- "instanceMessages": [ # List of messages that describe current statuses of memcached instance.
- {
- "code": "A String", # A code that correspond to one type of user-facing message.
- "message": "A String", # Message on memcached instance which will be exposed to users.
- },
- ],
- "authorizedNetwork": "A String", # Optional. The full name of the Google Compute Engine
- # [network](/compute/docs/networks-and-firewalls#networks) to which the
- # instance is connected. If left unspecified, the `default` network
- # will be used.
- "state": "A String", # Output only. The state of this Memcached instance.
- "name": "A String", # Required. Unique name of the resource in this scope including project and
- # location using the form:
- # `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
- #
- # Note: Memcached instances are managed and addressed at regional level so
- # location_id here refers to a GCP region; however, users may choose which
- # zones Memcached nodes within an instances should be provisioned in.
- # Refer to [zones] field for more details.
- "discoveryEndpoint": "A String", # Output only. Endpoint for Discovery API
- "displayName": "A String", # Optional. User provided name for the instance only used for display
- # purposes. Cannot be more than 80 characters.
- "nodeCount": 42, # Required. Number of nodes in the Memcached instance.
- "createTime": "A String", # Output only. The time the instance was created.
- "labels": { # Optional. Resource labels to represent user-provided metadata.
- # Refer to cloud documentation on labels for more details.
- # https://cloud.google.com/compute/docs/labeling-resources
- "a_key": "A String",
- },
- "zones": [ # Optional. Zones where Memcached nodes should be provisioned in.
- # Memcached nodes will be equally distributed across these zones. If not
- # provided, the service will by default create nodes in all zones in the
- # region for the instance.
- "A String",
- ],
- "updateTime": "A String", # Output only. The time the instance was updated.
- "parameters": { # Optional: User defined parameters to apply to the memcached process
- # on each node.
- "id": "A String", # Output only. The unique ID associated with this set of parameters. Users
- # can use this id to determine if the parameters associated with the instance
- # differ from the parameters associated with the nodes and any action needs
- # to be taken to apply parameters on nodes.
- "params": { # User defined set of parameters to use in the memcached process.
+ "zones": [ # Zones where Memcached nodes should be provisioned in.
+ # Memcached nodes will be equally distributed across these zones. If not
+ # provided, the service will by default create nodes in all zones in the
+ # region for the instance.
+ "A String",
+ ],
+ "nodeCount": 42, # Required. Number of nodes in the Memcached instance.
+ "instanceMessages": [ # List of messages that describe current statuses of memcached instance.
+ {
+ "message": "A String", # Message on memcached instance which will be exposed to users.
+ "code": "A String", # A code that correspond to one type of user-facing message.
+ },
+ ],
+ "discoveryEndpoint": "A String", # Output only. Endpoint for Discovery API
+ "createTime": "A String", # Output only. The time the instance was created.
+ "memcacheFullVersion": "A String", # Output only. The full version of memcached server running on this instance.
+ # System automatically determines the full memcached version for an instance
+ # based on the input MemcacheVersion.
+ # The full version format will be "memcached-1.5.16".
+ "labels": { # Resource labels to represent user-provided metadata.
+ # Refer to cloud documentation on labels for more details.
+ # https://cloud.google.com/compute/docs/labeling-resources
"a_key": "A String",
},
- },
- }</pre>
+ "displayName": "A String", # User provided name for the instance only used for display
+ # purposes. Cannot be more than 80 characters.
+ "memcacheNodes": [ # Output only. List of Memcached nodes.
+ # Refer to [Node] message for more details.
+ {
+ "nodeId": "A String", # Output only. Identifier of the Memcached node. The node id does not
+ # include project or location like the Memcached instance name.
+ "parameters": { # User defined parameters currently applied to the node.
+ "id": "A String", # Output only. The unique ID associated with this set of parameters. Users
+ # can use this id to determine if the parameters associated with the instance
+ # differ from the parameters associated with the nodes and any action needs
+ # to be taken to apply parameters on nodes.
+ "params": { # User defined set of parameters to use in the memcached process.
+ "a_key": "A String",
+ },
+ },
+ "state": "A String", # Output only. Current state of the Memcached node.
+ "zone": "A String", # Output only. Location (GCP Zone) for the Memcached node.
+ "host": "A String", # Output only. Hostname or IP address of the Memcached node used by the
+ # clients to connect to the Memcached server on this node.
+ "port": 42, # Output only. The port number of the Memcached server on this node.
+ },
+ ],
+ "state": "A String", # Output only. The state of this Memcached instance.
+ "memcacheVersion": "A String", # The major version of Memcached software.
+ # If not provided, latest supported version will be used. Currently the
+ # latest supported major version is MEMCACHE_1_5.
+ # The minor version will be automatically determined by our system based on
+ # the latest supported minor version.
+ "name": "A String", # Required. Unique name of the resource in this scope including project and
+ # location using the form:
+ # `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
+ #
+ # Note: Memcached instances are managed and addressed at regional level so
+ # location_id here refers to a GCP region; however, users may choose which
+ # zones Memcached nodes within an instances should be provisioned in.
+ # Refer to [zones] field for more details.
+ "updateTime": "A String", # Output only. The time the instance was updated.
+ "nodeConfig": { # Configuration for a Memcached Node. # Required. Configuration for Memcached nodes.
+ "memorySizeMb": 42, # Required. Memory size in MiB for each Memcached node.
+ "cpuCount": 42, # Required. Number of cpus per Memcached node.
+ },
+ "authorizedNetwork": "A String", # The full name of the Google Compute Engine
+ # [network](https://cloud.google.com/vpc/docs/vpc) to which the
+ # instance is connected. If left unspecified, the `default` network
+ # will be used.
+ }</pre>
</div>
<div class="method">
@@ -593,6 +593,115 @@
#
# For a description of IAM and its features, see the
# [IAM documentation](https://cloud.google.com/iam/docs/).
+ "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
+ { # Specifies the audit configuration for a service.
+ # The configuration determines which permission types are logged, and what
+ # identities, if any, are exempted from logging.
+ # An AuditConfig must have one or more AuditLogConfigs.
+ #
+ # If there are AuditConfigs for both `allServices` and a specific service,
+ # the union of the two AuditConfigs is used for that service: the log_types
+ # specified in each AuditConfig are enabled, and the exempted_members in each
+ # AuditLogConfig are exempted.
+ #
+ # Example Policy with multiple AuditConfigs:
+ #
+ # {
+ # "audit_configs": [
+ # {
+ # "service": "allServices",
+ # "audit_log_configs": [
+ # {
+ # "log_type": "DATA_READ",
+ # "exempted_members": [
+ # "user:jose@example.com"
+ # ]
+ # },
+ # {
+ # "log_type": "DATA_WRITE"
+ # },
+ # {
+ # "log_type": "ADMIN_READ"
+ # }
+ # ]
+ # },
+ # {
+ # "service": "sampleservice.googleapis.com",
+ # "audit_log_configs": [
+ # {
+ # "log_type": "DATA_READ"
+ # },
+ # {
+ # "log_type": "DATA_WRITE",
+ # "exempted_members": [
+ # "user:aliya@example.com"
+ # ]
+ # }
+ # ]
+ # }
+ # ]
+ # }
+ #
+ # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
+ # logging. It also exempts jose@example.com from DATA_READ logging, and
+ # aliya@example.com from DATA_WRITE logging.
+ "auditLogConfigs": [ # The configuration for logging of each type of permission.
+ { # Provides the configuration for logging a type of permissions.
+ # Example:
+ #
+ # {
+ # "audit_log_configs": [
+ # {
+ # "log_type": "DATA_READ",
+ # "exempted_members": [
+ # "user:jose@example.com"
+ # ]
+ # },
+ # {
+ # "log_type": "DATA_WRITE"
+ # }
+ # ]
+ # }
+ #
+ # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
+ # jose@example.com from DATA_READ logging.
+ "logType": "A String", # The log type that this config enables.
+ "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of
+ # permission.
+ # Follows the same format of Binding.members.
+ "A String",
+ ],
+ },
+ ],
+ "service": "A String", # Specifies a service that will be enabled for audit logging.
+ # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
+ # `allServices` is a special value that covers all services.
+ },
+ ],
+ "version": 42, # Specifies the format of the policy.
+ #
+ # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
+ # are rejected.
+ #
+ # Any operation that affects conditional role bindings must specify version
+ # `3`. This requirement applies to the following operations:
+ #
+ # * Getting a policy that includes a conditional role binding
+ # * Adding a conditional role binding to a policy
+ # * Changing a conditional role binding in a policy
+ # * Removing any role binding, with or without a condition, from a policy
+ # that includes conditions
+ #
+ # **Important:** If you use IAM Conditions, you must include the `etag` field
+ # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+ # you to overwrite a version `3` policy with a version `1` policy, and all of
+ # the conditions in the version `3` policy are lost.
+ #
+ # If a policy does not include any conditions, operations on that policy may
+ # specify any valid version or leave the field unset.
+ #
+ # To learn which resources support conditions in their IAM policies, see the
+ # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
"bindings": [ # Associates a list of `members` to a `role`. Optionally, may specify a
# `condition` that determines how and when the `bindings` are applied. Each
# of the `bindings` must contain at least one member.
@@ -639,15 +748,15 @@
# The exact variables and functions that may be referenced within an expression
# are determined by the service that evaluates it. See the service
# documentation for additional information.
- "expression": "A String", # Textual representation of an expression in Common Expression Language
- # syntax.
+ "description": "A String", # Optional. Description of the expression. This is a longer text which
+ # describes the expression, e.g. when hovered over it in a UI.
"title": "A String", # Optional. Title for the expression, i.e. a short string describing
# its purpose. This can be used e.g. in UIs which allow to enter the
# expression.
+ "expression": "A String", # Textual representation of an expression in Common Expression Language
+ # syntax.
"location": "A String", # Optional. String indicating the location of the expression for error
# reporting, e.g. a file name and a position in the file.
- "description": "A String", # Optional. Description of the expression. This is a longer text which
- # describes the expression, e.g. when hovered over it in a UI.
},
"members": [ # Specifies the identities requesting access for a Cloud Platform resource.
# `members` can have the following values:
@@ -710,129 +819,21 @@
# whenever you call `setIamPolicy`. If you omit this field, then IAM allows
# you to overwrite a version `3` policy with a version `1` policy, and all of
# the conditions in the version `3` policy are lost.
- "version": 42, # Specifies the format of the policy.
- #
- # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
- # are rejected.
- #
- # Any operation that affects conditional role bindings must specify version
- # `3`. This requirement applies to the following operations:
- #
- # * Getting a policy that includes a conditional role binding
- # * Adding a conditional role binding to a policy
- # * Changing a conditional role binding in a policy
- # * Removing any role binding, with or without a condition, from a policy
- # that includes conditions
- #
- # **Important:** If you use IAM Conditions, you must include the `etag` field
- # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
- # you to overwrite a version `3` policy with a version `1` policy, and all of
- # the conditions in the version `3` policy are lost.
- #
- # If a policy does not include any conditions, operations on that policy may
- # specify any valid version or leave the field unset.
- #
- # To learn which resources support conditions in their IAM policies, see the
- # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
- "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
- { # Specifies the audit configuration for a service.
- # The configuration determines which permission types are logged, and what
- # identities, if any, are exempted from logging.
- # An AuditConfig must have one or more AuditLogConfigs.
- #
- # If there are AuditConfigs for both `allServices` and a specific service,
- # the union of the two AuditConfigs is used for that service: the log_types
- # specified in each AuditConfig are enabled, and the exempted_members in each
- # AuditLogConfig are exempted.
- #
- # Example Policy with multiple AuditConfigs:
- #
- # {
- # "audit_configs": [
- # {
- # "service": "allServices"
- # "audit_log_configs": [
- # {
- # "log_type": "DATA_READ",
- # "exempted_members": [
- # "user:jose@example.com"
- # ]
- # },
- # {
- # "log_type": "DATA_WRITE",
- # },
- # {
- # "log_type": "ADMIN_READ",
- # }
- # ]
- # },
- # {
- # "service": "sampleservice.googleapis.com"
- # "audit_log_configs": [
- # {
- # "log_type": "DATA_READ",
- # },
- # {
- # "log_type": "DATA_WRITE",
- # "exempted_members": [
- # "user:aliya@example.com"
- # ]
- # }
- # ]
- # }
- # ]
- # }
- #
- # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
- # logging. It also exempts jose@example.com from DATA_READ logging, and
- # aliya@example.com from DATA_WRITE logging.
- "service": "A String", # Specifies a service that will be enabled for audit logging.
- # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
- # `allServices` is a special value that covers all services.
- "auditLogConfigs": [ # The configuration for logging of each type of permission.
- { # Provides the configuration for logging a type of permissions.
- # Example:
- #
- # {
- # "audit_log_configs": [
- # {
- # "log_type": "DATA_READ",
- # "exempted_members": [
- # "user:jose@example.com"
- # ]
- # },
- # {
- # "log_type": "DATA_WRITE",
- # }
- # ]
- # }
- #
- # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
- # jose@example.com from DATA_READ logging.
- "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of
- # permission.
- # Follows the same format of Binding.members.
- "A String",
- ],
- "logType": "A String", # The log type that this config enables.
- },
- ],
- },
- ],
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(parent, pageToken=None, orderBy=None, pageSize=None, filter=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(parent, filter=None, pageToken=None, pageSize=None, orderBy=None, x__xgafv=None)</code>
<pre>Lists Instances in a given project and location.
Args:
parent: string, Required. The resource name of the instance location using the form:
`projects/{project_id}/locations/{location_id}`
where `location_id` refers to a GCP region (required)
+ filter: string, List filter. For example, exclude all Memcached instances with name as
+my-instance by specifying "name != my-instance".
pageToken: string, The next_page_token value returned from a previous List request,
if any.
- orderBy: string, Sort results. Supported values are "name", "name desc" or "" (unsorted).
pageSize: integer, The maximum number of items to return.
If not specified, a default value of 1000 will be used by the service.
@@ -840,8 +841,7 @@
and a caller should only rely on response's
next_page_token
to determine if there are more instances left to be queried.
- filter: string, List filter. For example, exclude all Memcached instances with name as
-my-instance by specifying "name != my-instance".
+ orderBy: string, Sort results. Supported values are "name", "name desc" or "" (unsorted).
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -857,87 +857,87 @@
# If the `location_id` in the parent field of the request is "-", all regions
# available to the project are queried, and the results aggregated.
{
- "memcacheNodes": [ # Output only. List of Memcached nodes.
- # Refer to [Node] message for more details.
- {
- "port": 42, # Output only. The port number of the Memcached server on this node.
- "nodeId": "A String", # Output only. Identifier of the Memcached node. The node id does not
- # include project or location like the Memcached instance name.
- "host": "A String", # Output only. Hostname or IP address of the Memcached node used by the
- # clients to connect to the Memcached server on this node.
- "zone": "A String", # Output only. Location (GCP Zone) for the Memcached node.
- "state": "A String", # Output only. Current state of the Memcached node.
- "parameters": { # User defined parameters currently applied to the node.
- "id": "A String", # Output only. The unique ID associated with this set of parameters. Users
- # can use this id to determine if the parameters associated with the instance
- # differ from the parameters associated with the nodes and any action needs
- # to be taken to apply parameters on nodes.
- "params": { # User defined set of parameters to use in the memcached process.
- "a_key": "A String",
- },
+ "parameters": { # Optional: User defined parameters to apply to the memcached process
+ # on each node.
+ "id": "A String", # Output only. The unique ID associated with this set of parameters. Users
+ # can use this id to determine if the parameters associated with the instance
+ # differ from the parameters associated with the nodes and any action needs
+ # to be taken to apply parameters on nodes.
+ "params": { # User defined set of parameters to use in the memcached process.
+ "a_key": "A String",
},
},
- ],
- "nodeConfig": { # Configuration for a Memcached Node. # Required. Configuration for Memcached nodes.
- "cpuCount": 42, # Required. Number of cpus per Memcached node.
- "memorySizeMb": 42, # Required. Memory size in MiB for each Memcached node.
- },
- "memcacheVersion": "A String", # Optional. The major version of Memcached software.
- # If not provided, latest supported version will be used. Currently the
- # latest supported major version is MEMCACHE_1_5.
- # The minor version will be automatically determined by our system based on
- # the latest supported minor version.
- "memcacheFullVersion": "A String", # Output only. The full version of memcached server running on this instance.
- # System automatically determines the full memcached version for an instance
- # based on the input MemcacheVersion.
- # The full version format will be "memcached-1.5.16".
- "instanceMessages": [ # List of messages that describe current statuses of memcached instance.
- {
- "code": "A String", # A code that correspond to one type of user-facing message.
- "message": "A String", # Message on memcached instance which will be exposed to users.
- },
- ],
- "authorizedNetwork": "A String", # Optional. The full name of the Google Compute Engine
- # [network](/compute/docs/networks-and-firewalls#networks) to which the
- # instance is connected. If left unspecified, the `default` network
- # will be used.
- "state": "A String", # Output only. The state of this Memcached instance.
- "name": "A String", # Required. Unique name of the resource in this scope including project and
- # location using the form:
- # `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
- #
- # Note: Memcached instances are managed and addressed at regional level so
- # location_id here refers to a GCP region; however, users may choose which
- # zones Memcached nodes within an instances should be provisioned in.
- # Refer to [zones] field for more details.
- "discoveryEndpoint": "A String", # Output only. Endpoint for Discovery API
- "displayName": "A String", # Optional. User provided name for the instance only used for display
- # purposes. Cannot be more than 80 characters.
- "nodeCount": 42, # Required. Number of nodes in the Memcached instance.
- "createTime": "A String", # Output only. The time the instance was created.
- "labels": { # Optional. Resource labels to represent user-provided metadata.
- # Refer to cloud documentation on labels for more details.
- # https://cloud.google.com/compute/docs/labeling-resources
- "a_key": "A String",
- },
- "zones": [ # Optional. Zones where Memcached nodes should be provisioned in.
- # Memcached nodes will be equally distributed across these zones. If not
- # provided, the service will by default create nodes in all zones in the
- # region for the instance.
- "A String",
- ],
- "updateTime": "A String", # Output only. The time the instance was updated.
- "parameters": { # Optional: User defined parameters to apply to the memcached process
- # on each node.
- "id": "A String", # Output only. The unique ID associated with this set of parameters. Users
- # can use this id to determine if the parameters associated with the instance
- # differ from the parameters associated with the nodes and any action needs
- # to be taken to apply parameters on nodes.
- "params": { # User defined set of parameters to use in the memcached process.
+ "zones": [ # Zones where Memcached nodes should be provisioned in.
+ # Memcached nodes will be equally distributed across these zones. If not
+ # provided, the service will by default create nodes in all zones in the
+ # region for the instance.
+ "A String",
+ ],
+ "nodeCount": 42, # Required. Number of nodes in the Memcached instance.
+ "instanceMessages": [ # List of messages that describe current statuses of memcached instance.
+ {
+ "message": "A String", # Message on memcached instance which will be exposed to users.
+ "code": "A String", # A code that correspond to one type of user-facing message.
+ },
+ ],
+ "discoveryEndpoint": "A String", # Output only. Endpoint for Discovery API
+ "createTime": "A String", # Output only. The time the instance was created.
+ "memcacheFullVersion": "A String", # Output only. The full version of memcached server running on this instance.
+ # System automatically determines the full memcached version for an instance
+ # based on the input MemcacheVersion.
+ # The full version format will be "memcached-1.5.16".
+ "labels": { # Resource labels to represent user-provided metadata.
+ # Refer to cloud documentation on labels for more details.
+ # https://cloud.google.com/compute/docs/labeling-resources
"a_key": "A String",
},
+ "displayName": "A String", # User provided name for the instance only used for display
+ # purposes. Cannot be more than 80 characters.
+ "memcacheNodes": [ # Output only. List of Memcached nodes.
+ # Refer to [Node] message for more details.
+ {
+ "nodeId": "A String", # Output only. Identifier of the Memcached node. The node id does not
+ # include project or location like the Memcached instance name.
+ "parameters": { # User defined parameters currently applied to the node.
+ "id": "A String", # Output only. The unique ID associated with this set of parameters. Users
+ # can use this id to determine if the parameters associated with the instance
+ # differ from the parameters associated with the nodes and any action needs
+ # to be taken to apply parameters on nodes.
+ "params": { # User defined set of parameters to use in the memcached process.
+ "a_key": "A String",
+ },
+ },
+ "state": "A String", # Output only. Current state of the Memcached node.
+ "zone": "A String", # Output only. Location (GCP Zone) for the Memcached node.
+ "host": "A String", # Output only. Hostname or IP address of the Memcached node used by the
+ # clients to connect to the Memcached server on this node.
+ "port": 42, # Output only. The port number of the Memcached server on this node.
+ },
+ ],
+ "state": "A String", # Output only. The state of this Memcached instance.
+ "memcacheVersion": "A String", # The major version of Memcached software.
+ # If not provided, latest supported version will be used. Currently the
+ # latest supported major version is MEMCACHE_1_5.
+ # The minor version will be automatically determined by our system based on
+ # the latest supported minor version.
+ "name": "A String", # Required. Unique name of the resource in this scope including project and
+ # location using the form:
+ # `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
+ #
+ # Note: Memcached instances are managed and addressed at regional level so
+ # location_id here refers to a GCP region; however, users may choose which
+ # zones Memcached nodes within an instances should be provisioned in.
+ # Refer to [zones] field for more details.
+ "updateTime": "A String", # Output only. The time the instance was updated.
+ "nodeConfig": { # Configuration for a Memcached Node. # Required. Configuration for Memcached nodes.
+ "memorySizeMb": 42, # Required. Memory size in MiB for each Memcached node.
+ "cpuCount": 42, # Required. Number of cpus per Memcached node.
+ },
+ "authorizedNetwork": "A String", # The full name of the Google Compute Engine
+ # [network](https://cloud.google.com/vpc/docs/vpc) to which the
+ # instance is connected. If left unspecified, the `default` network
+ # will be used.
},
- },
],
"nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no more
# results in the list.
@@ -978,87 +978,87 @@
The object takes the form of:
{
- "memcacheNodes": [ # Output only. List of Memcached nodes.
- # Refer to [Node] message for more details.
- {
- "port": 42, # Output only. The port number of the Memcached server on this node.
- "nodeId": "A String", # Output only. Identifier of the Memcached node. The node id does not
- # include project or location like the Memcached instance name.
- "host": "A String", # Output only. Hostname or IP address of the Memcached node used by the
- # clients to connect to the Memcached server on this node.
- "zone": "A String", # Output only. Location (GCP Zone) for the Memcached node.
- "state": "A String", # Output only. Current state of the Memcached node.
- "parameters": { # User defined parameters currently applied to the node.
- "id": "A String", # Output only. The unique ID associated with this set of parameters. Users
- # can use this id to determine if the parameters associated with the instance
- # differ from the parameters associated with the nodes and any action needs
- # to be taken to apply parameters on nodes.
- "params": { # User defined set of parameters to use in the memcached process.
- "a_key": "A String",
- },
+ "parameters": { # Optional: User defined parameters to apply to the memcached process
+ # on each node.
+ "id": "A String", # Output only. The unique ID associated with this set of parameters. Users
+ # can use this id to determine if the parameters associated with the instance
+ # differ from the parameters associated with the nodes and any action needs
+ # to be taken to apply parameters on nodes.
+ "params": { # User defined set of parameters to use in the memcached process.
+ "a_key": "A String",
},
},
- ],
- "nodeConfig": { # Configuration for a Memcached Node. # Required. Configuration for Memcached nodes.
- "cpuCount": 42, # Required. Number of cpus per Memcached node.
- "memorySizeMb": 42, # Required. Memory size in MiB for each Memcached node.
- },
- "memcacheVersion": "A String", # Optional. The major version of Memcached software.
- # If not provided, latest supported version will be used. Currently the
- # latest supported major version is MEMCACHE_1_5.
- # The minor version will be automatically determined by our system based on
- # the latest supported minor version.
- "memcacheFullVersion": "A String", # Output only. The full version of memcached server running on this instance.
- # System automatically determines the full memcached version for an instance
- # based on the input MemcacheVersion.
- # The full version format will be "memcached-1.5.16".
- "instanceMessages": [ # List of messages that describe current statuses of memcached instance.
- {
- "code": "A String", # A code that correspond to one type of user-facing message.
- "message": "A String", # Message on memcached instance which will be exposed to users.
- },
- ],
- "authorizedNetwork": "A String", # Optional. The full name of the Google Compute Engine
- # [network](/compute/docs/networks-and-firewalls#networks) to which the
- # instance is connected. If left unspecified, the `default` network
- # will be used.
- "state": "A String", # Output only. The state of this Memcached instance.
- "name": "A String", # Required. Unique name of the resource in this scope including project and
- # location using the form:
- # `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
- #
- # Note: Memcached instances are managed and addressed at regional level so
- # location_id here refers to a GCP region; however, users may choose which
- # zones Memcached nodes within an instances should be provisioned in.
- # Refer to [zones] field for more details.
- "discoveryEndpoint": "A String", # Output only. Endpoint for Discovery API
- "displayName": "A String", # Optional. User provided name for the instance only used for display
- # purposes. Cannot be more than 80 characters.
- "nodeCount": 42, # Required. Number of nodes in the Memcached instance.
- "createTime": "A String", # Output only. The time the instance was created.
- "labels": { # Optional. Resource labels to represent user-provided metadata.
- # Refer to cloud documentation on labels for more details.
- # https://cloud.google.com/compute/docs/labeling-resources
- "a_key": "A String",
- },
- "zones": [ # Optional. Zones where Memcached nodes should be provisioned in.
- # Memcached nodes will be equally distributed across these zones. If not
- # provided, the service will by default create nodes in all zones in the
- # region for the instance.
- "A String",
- ],
- "updateTime": "A String", # Output only. The time the instance was updated.
- "parameters": { # Optional: User defined parameters to apply to the memcached process
- # on each node.
- "id": "A String", # Output only. The unique ID associated with this set of parameters. Users
- # can use this id to determine if the parameters associated with the instance
- # differ from the parameters associated with the nodes and any action needs
- # to be taken to apply parameters on nodes.
- "params": { # User defined set of parameters to use in the memcached process.
+ "zones": [ # Zones where Memcached nodes should be provisioned in.
+ # Memcached nodes will be equally distributed across these zones. If not
+ # provided, the service will by default create nodes in all zones in the
+ # region for the instance.
+ "A String",
+ ],
+ "nodeCount": 42, # Required. Number of nodes in the Memcached instance.
+ "instanceMessages": [ # List of messages that describe current statuses of memcached instance.
+ {
+ "message": "A String", # Message on memcached instance which will be exposed to users.
+ "code": "A String", # A code that correspond to one type of user-facing message.
+ },
+ ],
+ "discoveryEndpoint": "A String", # Output only. Endpoint for Discovery API
+ "createTime": "A String", # Output only. The time the instance was created.
+ "memcacheFullVersion": "A String", # Output only. The full version of memcached server running on this instance.
+ # System automatically determines the full memcached version for an instance
+ # based on the input MemcacheVersion.
+ # The full version format will be "memcached-1.5.16".
+ "labels": { # Resource labels to represent user-provided metadata.
+ # Refer to cloud documentation on labels for more details.
+ # https://cloud.google.com/compute/docs/labeling-resources
"a_key": "A String",
},
- },
-}
+ "displayName": "A String", # User provided name for the instance only used for display
+ # purposes. Cannot be more than 80 characters.
+ "memcacheNodes": [ # Output only. List of Memcached nodes.
+ # Refer to [Node] message for more details.
+ {
+ "nodeId": "A String", # Output only. Identifier of the Memcached node. The node id does not
+ # include project or location like the Memcached instance name.
+ "parameters": { # User defined parameters currently applied to the node.
+ "id": "A String", # Output only. The unique ID associated with this set of parameters. Users
+ # can use this id to determine if the parameters associated with the instance
+ # differ from the parameters associated with the nodes and any action needs
+ # to be taken to apply parameters on nodes.
+ "params": { # User defined set of parameters to use in the memcached process.
+ "a_key": "A String",
+ },
+ },
+ "state": "A String", # Output only. Current state of the Memcached node.
+ "zone": "A String", # Output only. Location (GCP Zone) for the Memcached node.
+ "host": "A String", # Output only. Hostname or IP address of the Memcached node used by the
+ # clients to connect to the Memcached server on this node.
+ "port": 42, # Output only. The port number of the Memcached server on this node.
+ },
+ ],
+ "state": "A String", # Output only. The state of this Memcached instance.
+ "memcacheVersion": "A String", # The major version of Memcached software.
+ # If not provided, latest supported version will be used. Currently the
+ # latest supported major version is MEMCACHE_1_5.
+ # The minor version will be automatically determined by our system based on
+ # the latest supported minor version.
+ "name": "A String", # Required. Unique name of the resource in this scope including project and
+ # location using the form:
+ # `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
+ #
+ # Note: Memcached instances are managed and addressed at regional level so
+ # location_id here refers to a GCP region; however, users may choose which
+ # zones Memcached nodes within an instances should be provisioned in.
+ # Refer to [zones] field for more details.
+ "updateTime": "A String", # Output only. The time the instance was updated.
+ "nodeConfig": { # Configuration for a Memcached Node. # Required. Configuration for Memcached nodes.
+ "memorySizeMb": 42, # Required. Memory size in MiB for each Memcached node.
+ "cpuCount": 42, # Required. Number of cpus per Memcached node.
+ },
+ "authorizedNetwork": "A String", # The full name of the Google Compute Engine
+ # [network](https://cloud.google.com/vpc/docs/vpc) to which the
+ # instance is connected. If left unspecified, the `default` network
+ # will be used.
+ }
updateMask: string, Required. Mask of fields to update.
* `displayName`
@@ -1072,15 +1072,24 @@
{ # This resource represents a long-running operation that is the result of a
# network API call.
- "metadata": { # Service-specific metadata associated with the operation. It typically
- # contains progress information and common metadata such as create time.
- # Some services might not provide such metadata. Any method that returns a
- # long-running operation should document the metadata type, if any.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
+ "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.
+ # different programming environments, including REST APIs and RPC APIs. It is
+ # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+ # three pieces of data: error code, error message, and error details.
+ #
+ # You can find out more about this error model and how to work with it in the
+ # [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "details": [ # A list of messages that carry the error details. There is a common set of
+ # message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
},
- "done": True or False, # If the value is `false`, it means the operation is still in progress.
- # If `true`, the operation is completed, and either `error` or `response` is
- # available.
"response": { # The normal response of the operation in case of success. If the original
# method returns no data on success, such as `Delete`, the response is
# `google.protobuf.Empty`. If the original method is standard
@@ -1094,24 +1103,15 @@
"name": "A String", # The server-assigned name, which is only unique within the same service that
# originally returns it. If you use the default HTTP mapping, the
# `name` should be a resource name ending with `operations/{unique_id}`.
- "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.
- # different programming environments, including REST APIs and RPC APIs. It is
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
- # three pieces of data: error code, error message, and error details.
- #
- # You can find out more about this error model and how to work with it in the
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
+ "metadata": { # Service-specific metadata associated with the operation. It typically
+ # contains progress information and common metadata such as create time.
+ # Some services might not provide such metadata. Any method that returns a
+ # long-running operation should document the metadata type, if any.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "done": True or False, # If the value is `false`, it means the operation is still in progress.
+ # If `true`, the operation is completed, and either `error` or `response` is
+ # available.
}</pre>
</div>
@@ -1199,6 +1199,115 @@
#
# For a description of IAM and its features, see the
# [IAM documentation](https://cloud.google.com/iam/docs/).
+ "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
+ { # Specifies the audit configuration for a service.
+ # The configuration determines which permission types are logged, and what
+ # identities, if any, are exempted from logging.
+ # An AuditConfig must have one or more AuditLogConfigs.
+ #
+ # If there are AuditConfigs for both `allServices` and a specific service,
+ # the union of the two AuditConfigs is used for that service: the log_types
+ # specified in each AuditConfig are enabled, and the exempted_members in each
+ # AuditLogConfig are exempted.
+ #
+ # Example Policy with multiple AuditConfigs:
+ #
+ # {
+ # "audit_configs": [
+ # {
+ # "service": "allServices",
+ # "audit_log_configs": [
+ # {
+ # "log_type": "DATA_READ",
+ # "exempted_members": [
+ # "user:jose@example.com"
+ # ]
+ # },
+ # {
+ # "log_type": "DATA_WRITE"
+ # },
+ # {
+ # "log_type": "ADMIN_READ"
+ # }
+ # ]
+ # },
+ # {
+ # "service": "sampleservice.googleapis.com",
+ # "audit_log_configs": [
+ # {
+ # "log_type": "DATA_READ"
+ # },
+ # {
+ # "log_type": "DATA_WRITE",
+ # "exempted_members": [
+ # "user:aliya@example.com"
+ # ]
+ # }
+ # ]
+ # }
+ # ]
+ # }
+ #
+ # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
+ # logging. It also exempts jose@example.com from DATA_READ logging, and
+ # aliya@example.com from DATA_WRITE logging.
+ "auditLogConfigs": [ # The configuration for logging of each type of permission.
+ { # Provides the configuration for logging a type of permissions.
+ # Example:
+ #
+ # {
+ # "audit_log_configs": [
+ # {
+ # "log_type": "DATA_READ",
+ # "exempted_members": [
+ # "user:jose@example.com"
+ # ]
+ # },
+ # {
+ # "log_type": "DATA_WRITE"
+ # }
+ # ]
+ # }
+ #
+ # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
+ # jose@example.com from DATA_READ logging.
+ "logType": "A String", # The log type that this config enables.
+ "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of
+ # permission.
+ # Follows the same format of Binding.members.
+ "A String",
+ ],
+ },
+ ],
+ "service": "A String", # Specifies a service that will be enabled for audit logging.
+ # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
+ # `allServices` is a special value that covers all services.
+ },
+ ],
+ "version": 42, # Specifies the format of the policy.
+ #
+ # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
+ # are rejected.
+ #
+ # Any operation that affects conditional role bindings must specify version
+ # `3`. This requirement applies to the following operations:
+ #
+ # * Getting a policy that includes a conditional role binding
+ # * Adding a conditional role binding to a policy
+ # * Changing a conditional role binding in a policy
+ # * Removing any role binding, with or without a condition, from a policy
+ # that includes conditions
+ #
+ # **Important:** If you use IAM Conditions, you must include the `etag` field
+ # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+ # you to overwrite a version `3` policy with a version `1` policy, and all of
+ # the conditions in the version `3` policy are lost.
+ #
+ # If a policy does not include any conditions, operations on that policy may
+ # specify any valid version or leave the field unset.
+ #
+ # To learn which resources support conditions in their IAM policies, see the
+ # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
"bindings": [ # Associates a list of `members` to a `role`. Optionally, may specify a
# `condition` that determines how and when the `bindings` are applied. Each
# of the `bindings` must contain at least one member.
@@ -1245,15 +1354,15 @@
# The exact variables and functions that may be referenced within an expression
# are determined by the service that evaluates it. See the service
# documentation for additional information.
- "expression": "A String", # Textual representation of an expression in Common Expression Language
- # syntax.
+ "description": "A String", # Optional. Description of the expression. This is a longer text which
+ # describes the expression, e.g. when hovered over it in a UI.
"title": "A String", # Optional. Title for the expression, i.e. a short string describing
# its purpose. This can be used e.g. in UIs which allow to enter the
# expression.
+ "expression": "A String", # Textual representation of an expression in Common Expression Language
+ # syntax.
"location": "A String", # Optional. String indicating the location of the expression for error
# reporting, e.g. a file name and a position in the file.
- "description": "A String", # Optional. Description of the expression. This is a longer text which
- # describes the expression, e.g. when hovered over it in a UI.
},
"members": [ # Specifies the identities requesting access for a Cloud Platform resource.
# `members` can have the following values:
@@ -1316,115 +1425,6 @@
# whenever you call `setIamPolicy`. If you omit this field, then IAM allows
# you to overwrite a version `3` policy with a version `1` policy, and all of
# the conditions in the version `3` policy are lost.
- "version": 42, # Specifies the format of the policy.
- #
- # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
- # are rejected.
- #
- # Any operation that affects conditional role bindings must specify version
- # `3`. This requirement applies to the following operations:
- #
- # * Getting a policy that includes a conditional role binding
- # * Adding a conditional role binding to a policy
- # * Changing a conditional role binding in a policy
- # * Removing any role binding, with or without a condition, from a policy
- # that includes conditions
- #
- # **Important:** If you use IAM Conditions, you must include the `etag` field
- # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
- # you to overwrite a version `3` policy with a version `1` policy, and all of
- # the conditions in the version `3` policy are lost.
- #
- # If a policy does not include any conditions, operations on that policy may
- # specify any valid version or leave the field unset.
- #
- # To learn which resources support conditions in their IAM policies, see the
- # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
- "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
- { # Specifies the audit configuration for a service.
- # The configuration determines which permission types are logged, and what
- # identities, if any, are exempted from logging.
- # An AuditConfig must have one or more AuditLogConfigs.
- #
- # If there are AuditConfigs for both `allServices` and a specific service,
- # the union of the two AuditConfigs is used for that service: the log_types
- # specified in each AuditConfig are enabled, and the exempted_members in each
- # AuditLogConfig are exempted.
- #
- # Example Policy with multiple AuditConfigs:
- #
- # {
- # "audit_configs": [
- # {
- # "service": "allServices"
- # "audit_log_configs": [
- # {
- # "log_type": "DATA_READ",
- # "exempted_members": [
- # "user:jose@example.com"
- # ]
- # },
- # {
- # "log_type": "DATA_WRITE",
- # },
- # {
- # "log_type": "ADMIN_READ",
- # }
- # ]
- # },
- # {
- # "service": "sampleservice.googleapis.com"
- # "audit_log_configs": [
- # {
- # "log_type": "DATA_READ",
- # },
- # {
- # "log_type": "DATA_WRITE",
- # "exempted_members": [
- # "user:aliya@example.com"
- # ]
- # }
- # ]
- # }
- # ]
- # }
- #
- # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
- # logging. It also exempts jose@example.com from DATA_READ logging, and
- # aliya@example.com from DATA_WRITE logging.
- "service": "A String", # Specifies a service that will be enabled for audit logging.
- # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
- # `allServices` is a special value that covers all services.
- "auditLogConfigs": [ # The configuration for logging of each type of permission.
- { # Provides the configuration for logging a type of permissions.
- # Example:
- #
- # {
- # "audit_log_configs": [
- # {
- # "log_type": "DATA_READ",
- # "exempted_members": [
- # "user:jose@example.com"
- # ]
- # },
- # {
- # "log_type": "DATA_WRITE",
- # }
- # ]
- # }
- #
- # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
- # jose@example.com from DATA_READ logging.
- "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of
- # permission.
- # Follows the same format of Binding.members.
- "A String",
- ],
- "logType": "A String", # The log type that this config enables.
- },
- ],
- },
- ],
},
"updateMask": "A String", # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only
# the fields in the mask will be modified. If no mask is provided, the
@@ -1508,6 +1508,115 @@
#
# For a description of IAM and its features, see the
# [IAM documentation](https://cloud.google.com/iam/docs/).
+ "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
+ { # Specifies the audit configuration for a service.
+ # The configuration determines which permission types are logged, and what
+ # identities, if any, are exempted from logging.
+ # An AuditConfig must have one or more AuditLogConfigs.
+ #
+ # If there are AuditConfigs for both `allServices` and a specific service,
+ # the union of the two AuditConfigs is used for that service: the log_types
+ # specified in each AuditConfig are enabled, and the exempted_members in each
+ # AuditLogConfig are exempted.
+ #
+ # Example Policy with multiple AuditConfigs:
+ #
+ # {
+ # "audit_configs": [
+ # {
+ # "service": "allServices",
+ # "audit_log_configs": [
+ # {
+ # "log_type": "DATA_READ",
+ # "exempted_members": [
+ # "user:jose@example.com"
+ # ]
+ # },
+ # {
+ # "log_type": "DATA_WRITE"
+ # },
+ # {
+ # "log_type": "ADMIN_READ"
+ # }
+ # ]
+ # },
+ # {
+ # "service": "sampleservice.googleapis.com",
+ # "audit_log_configs": [
+ # {
+ # "log_type": "DATA_READ"
+ # },
+ # {
+ # "log_type": "DATA_WRITE",
+ # "exempted_members": [
+ # "user:aliya@example.com"
+ # ]
+ # }
+ # ]
+ # }
+ # ]
+ # }
+ #
+ # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
+ # logging. It also exempts jose@example.com from DATA_READ logging, and
+ # aliya@example.com from DATA_WRITE logging.
+ "auditLogConfigs": [ # The configuration for logging of each type of permission.
+ { # Provides the configuration for logging a type of permissions.
+ # Example:
+ #
+ # {
+ # "audit_log_configs": [
+ # {
+ # "log_type": "DATA_READ",
+ # "exempted_members": [
+ # "user:jose@example.com"
+ # ]
+ # },
+ # {
+ # "log_type": "DATA_WRITE"
+ # }
+ # ]
+ # }
+ #
+ # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
+ # jose@example.com from DATA_READ logging.
+ "logType": "A String", # The log type that this config enables.
+ "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of
+ # permission.
+ # Follows the same format of Binding.members.
+ "A String",
+ ],
+ },
+ ],
+ "service": "A String", # Specifies a service that will be enabled for audit logging.
+ # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
+ # `allServices` is a special value that covers all services.
+ },
+ ],
+ "version": 42, # Specifies the format of the policy.
+ #
+ # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
+ # are rejected.
+ #
+ # Any operation that affects conditional role bindings must specify version
+ # `3`. This requirement applies to the following operations:
+ #
+ # * Getting a policy that includes a conditional role binding
+ # * Adding a conditional role binding to a policy
+ # * Changing a conditional role binding in a policy
+ # * Removing any role binding, with or without a condition, from a policy
+ # that includes conditions
+ #
+ # **Important:** If you use IAM Conditions, you must include the `etag` field
+ # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
+ # you to overwrite a version `3` policy with a version `1` policy, and all of
+ # the conditions in the version `3` policy are lost.
+ #
+ # If a policy does not include any conditions, operations on that policy may
+ # specify any valid version or leave the field unset.
+ #
+ # To learn which resources support conditions in their IAM policies, see the
+ # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
"bindings": [ # Associates a list of `members` to a `role`. Optionally, may specify a
# `condition` that determines how and when the `bindings` are applied. Each
# of the `bindings` must contain at least one member.
@@ -1554,15 +1663,15 @@
# The exact variables and functions that may be referenced within an expression
# are determined by the service that evaluates it. See the service
# documentation for additional information.
- "expression": "A String", # Textual representation of an expression in Common Expression Language
- # syntax.
+ "description": "A String", # Optional. Description of the expression. This is a longer text which
+ # describes the expression, e.g. when hovered over it in a UI.
"title": "A String", # Optional. Title for the expression, i.e. a short string describing
# its purpose. This can be used e.g. in UIs which allow to enter the
# expression.
+ "expression": "A String", # Textual representation of an expression in Common Expression Language
+ # syntax.
"location": "A String", # Optional. String indicating the location of the expression for error
# reporting, e.g. a file name and a position in the file.
- "description": "A String", # Optional. Description of the expression. This is a longer text which
- # describes the expression, e.g. when hovered over it in a UI.
},
"members": [ # Specifies the identities requesting access for a Cloud Platform resource.
# `members` can have the following values:
@@ -1625,115 +1734,6 @@
# whenever you call `setIamPolicy`. If you omit this field, then IAM allows
# you to overwrite a version `3` policy with a version `1` policy, and all of
# the conditions in the version `3` policy are lost.
- "version": 42, # Specifies the format of the policy.
- #
- # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
- # are rejected.
- #
- # Any operation that affects conditional role bindings must specify version
- # `3`. This requirement applies to the following operations:
- #
- # * Getting a policy that includes a conditional role binding
- # * Adding a conditional role binding to a policy
- # * Changing a conditional role binding in a policy
- # * Removing any role binding, with or without a condition, from a policy
- # that includes conditions
- #
- # **Important:** If you use IAM Conditions, you must include the `etag` field
- # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
- # you to overwrite a version `3` policy with a version `1` policy, and all of
- # the conditions in the version `3` policy are lost.
- #
- # If a policy does not include any conditions, operations on that policy may
- # specify any valid version or leave the field unset.
- #
- # To learn which resources support conditions in their IAM policies, see the
- # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
- "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
- { # Specifies the audit configuration for a service.
- # The configuration determines which permission types are logged, and what
- # identities, if any, are exempted from logging.
- # An AuditConfig must have one or more AuditLogConfigs.
- #
- # If there are AuditConfigs for both `allServices` and a specific service,
- # the union of the two AuditConfigs is used for that service: the log_types
- # specified in each AuditConfig are enabled, and the exempted_members in each
- # AuditLogConfig are exempted.
- #
- # Example Policy with multiple AuditConfigs:
- #
- # {
- # "audit_configs": [
- # {
- # "service": "allServices"
- # "audit_log_configs": [
- # {
- # "log_type": "DATA_READ",
- # "exempted_members": [
- # "user:jose@example.com"
- # ]
- # },
- # {
- # "log_type": "DATA_WRITE",
- # },
- # {
- # "log_type": "ADMIN_READ",
- # }
- # ]
- # },
- # {
- # "service": "sampleservice.googleapis.com"
- # "audit_log_configs": [
- # {
- # "log_type": "DATA_READ",
- # },
- # {
- # "log_type": "DATA_WRITE",
- # "exempted_members": [
- # "user:aliya@example.com"
- # ]
- # }
- # ]
- # }
- # ]
- # }
- #
- # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
- # logging. It also exempts jose@example.com from DATA_READ logging, and
- # aliya@example.com from DATA_WRITE logging.
- "service": "A String", # Specifies a service that will be enabled for audit logging.
- # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
- # `allServices` is a special value that covers all services.
- "auditLogConfigs": [ # The configuration for logging of each type of permission.
- { # Provides the configuration for logging a type of permissions.
- # Example:
- #
- # {
- # "audit_log_configs": [
- # {
- # "log_type": "DATA_READ",
- # "exempted_members": [
- # "user:jose@example.com"
- # ]
- # },
- # {
- # "log_type": "DATA_WRITE",
- # }
- # ]
- # }
- #
- # This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting
- # jose@example.com from DATA_READ logging.
- "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of
- # permission.
- # Follows the same format of Binding.members.
- "A String",
- ],
- "logType": "A String", # The log type that this config enables.
- },
- ],
- },
- ],
}</pre>
</div>
@@ -1813,15 +1813,24 @@
{ # This resource represents a long-running operation that is the result of a
# network API call.
- "metadata": { # Service-specific metadata associated with the operation. It typically
- # contains progress information and common metadata such as create time.
- # Some services might not provide such metadata. Any method that returns a
- # long-running operation should document the metadata type, if any.
- "a_key": "", # Properties of the object. Contains field @type with type URL.
+ "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.
+ # different programming environments, including REST APIs and RPC APIs. It is
+ # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+ # three pieces of data: error code, error message, and error details.
+ #
+ # You can find out more about this error model and how to work with it in the
+ # [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "details": [ # A list of messages that carry the error details. There is a common set of
+ # message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "message": "A String", # A developer-facing error message, which should be in English. Any
+ # user-facing error message should be localized and sent in the
+ # google.rpc.Status.details field, or localized by the client.
},
- "done": True or False, # If the value is `false`, it means the operation is still in progress.
- # If `true`, the operation is completed, and either `error` or `response` is
- # available.
"response": { # The normal response of the operation in case of success. If the original
# method returns no data on success, such as `Delete`, the response is
# `google.protobuf.Empty`. If the original method is standard
@@ -1835,24 +1844,15 @@
"name": "A String", # The server-assigned name, which is only unique within the same service that
# originally returns it. If you use the default HTTP mapping, the
# `name` should be a resource name ending with `operations/{unique_id}`.
- "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.
- # different programming environments, including REST APIs and RPC APIs. It is
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
- # three pieces of data: error code, error message, and error details.
- #
- # You can find out more about this error model and how to work with it in the
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
- {
- "a_key": "", # Properties of the object. Contains field @type with type URL.
- },
- ],
+ "metadata": { # Service-specific metadata associated with the operation. It typically
+ # contains progress information and common metadata such as create time.
+ # Some services might not provide such metadata. Any method that returns a
+ # long-running operation should document the metadata type, if any.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
},
+ "done": True or False, # If the value is `false`, it means the operation is still in progress.
+ # If `true`, the operation is completed, and either `error` or `response` is
+ # available.
}</pre>
</div>