Index: third_party/gsutil/gslib/commands/getlogging.py |
diff --git a/third_party/gsutil/gslib/commands/getlogging.py b/third_party/gsutil/gslib/commands/getlogging.py |
deleted file mode 100644 |
index bffc10fdc5c8929eec42a0362cff17e992c19e9b..0000000000000000000000000000000000000000 |
--- a/third_party/gsutil/gslib/commands/getlogging.py |
+++ /dev/null |
@@ -1,137 +0,0 @@ |
-# Copyright 2011 Google Inc. All Rights Reserved. |
-# |
-# Licensed under the Apache License, Version 2.0 (the "License"); |
-# you may not use this file except in compliance with the License. |
-# You may obtain a copy of the License at |
-# |
-# http://www.apache.org/licenses/LICENSE-2.0 |
-# |
-# Unless required by applicable law or agreed to in writing, software |
-# distributed under the License is distributed on an "AS IS" BASIS, |
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
-# See the License for the specific language governing permissions and |
-# limitations under the License. |
- |
-from gslib.command import Command |
-from gslib.command import COMMAND_NAME |
-from gslib.command import COMMAND_NAME_ALIASES |
-from gslib.command import CONFIG_REQUIRED |
-from gslib.command import FILE_URIS_OK |
-from gslib.command import MAX_ARGS |
-from gslib.command import MIN_ARGS |
-from gslib.command import PROVIDER_URIS_OK |
-from gslib.command import SUPPORTED_SUB_ARGS |
-from gslib.command import URIS_START_ARG |
-from gslib.help_provider import HELP_NAME |
-from gslib.help_provider import HELP_NAME_ALIASES |
-from gslib.help_provider import HELP_ONE_LINE_SUMMARY |
-from gslib.help_provider import HELP_TEXT |
-from gslib.help_provider import HelpType |
-from gslib.help_provider import HELP_TYPE |
- |
-_detailed_help_text = (""" |
-<B>SYNOPSIS</B> |
- gsutil getlogging uri |
- |
- |
-<B>DESCRIPTION</B> |
- If logging is enabled for the specified bucket uri, the server responds |
- with a <Logging> XML element that looks something like this: |
- |
- <?xml version="1.0" ?> |
- <Logging> |
- <LogBucket> |
- logs-bucket |
- </LogBucket> |
- <LogObjectPrefix> |
- my-logs-enabled-bucket |
- </LogObjectPrefix> |
- </Logging> |
- |
- If logging is not enabled, an empty <Logging> element is returned. |
- |
- You can download log data from your log bucket using the gsutil cp command. |
- |
- |
-<B>ACCESS LOG FIELDS</B> |
- Field Type Description |
- time_micros integer The time that the request was completed, in |
- microseconds since the Unix epoch. |
- c_ip string The IP address from which the request was made. |
- The "c" prefix indicates that this is information |
- about the client. |
- c_ip_type integer The type of IP in the c_ip field: |
- A value of 1 indicates an IPV4 address. |
- A value of 2 indicates an IPV6 address. |
- c_ip_region string Reserved for future use. |
- cs_method string The HTTP method of this request. The "cs" prefix |
- indicates that this information was sent from the |
- client to the server. |
- cs_uri string The URI of the request. |
- sc_status integer The HTTP status code the server sent in response. |
- The "sc" prefix indicates that this information |
- was sent from the server to the client. |
- cs_bytes integer The number of bytes sent in the request. |
- sc_bytes integer The number of bytes sent in the response. |
- time_taken_micros integer The time it took to serve the request in |
- microseconds. |
- cs_host string The host in the original request. |
- cs_referrer string The HTTP referrer for the request. |
- cs_user_agent string The User-Agent of the request. |
- s_request_id string The request identifier. |
- cs_operation string The Google Cloud Storage operation e.g. |
- GET_Object. |
- cs_bucket string The bucket specified in the request. If this is a |
- list buckets request, this can be null. |
- cs_object string The object specified in this request. This can be |
- null. |
- |
- |
-<B>STORAGE DATA FIELDS</B> |
- Field Type Description |
- bucket string The name of the bucket. |
- storage_byte_hours integer Average size in bytes/per hour of that bucket. |
-""") |
- |
- |
-class GetLoggingCommand(Command): |
- """Implementation of gsutil getlogging command.""" |
- |
- # Command specification (processed by parent class). |
- command_spec = { |
- # Name of command. |
- COMMAND_NAME : 'getlogging', |
- # List of command name aliases. |
- COMMAND_NAME_ALIASES : [], |
- # Min number of args required by this command. |
- MIN_ARGS : 1, |
- # Max number of args required by this command, or NO_MAX. |
- MAX_ARGS : 1, |
- # Getopt-style string specifying acceptable sub args. |
- SUPPORTED_SUB_ARGS : '', |
- # True if file URIs acceptable for this command. |
- FILE_URIS_OK : False, |
- # True if provider-only URIs acceptable for this command. |
- PROVIDER_URIS_OK : False, |
- # Index in args of first URI arg. |
- URIS_START_ARG : 0, |
- # True if must configure gsutil before running command. |
- CONFIG_REQUIRED : True, |
- } |
- help_spec = { |
- # Name of command or auxiliary help info for which this help applies. |
- HELP_NAME : 'getlogging', |
- # List of help name aliases. |
- HELP_NAME_ALIASES : [], |
- # Type of help: |
- HELP_TYPE : HelpType.COMMAND_HELP, |
- # One line summary of this help. |
- HELP_ONE_LINE_SUMMARY : 'Get logging configuration for a bucket', |
- # The full help text. |
- HELP_TEXT : _detailed_help_text, |
- } |
- |
- # Command entry point. |
- def RunCommand(self): |
- self.GetXmlSubresource('logging', self.args[0]) |
- return 0 |