Update all APIs

This commit is contained in:
Sebastian Thiel
2021-04-01 23:11:45 +08:00
parent 9fe80b24eb
commit c28ba92ead
339 changed files with 680792 additions and 444880 deletions

View File

@@ -4,245 +4,251 @@
"scopes": {
"https://www.googleapis.com/auth/cloud-platform": {
"description": "View and manage your data across Google Cloud Platform services"
},
},
"https://www.googleapis.com/auth/trace.append": {
"description": "Write Trace data for a project or application"
},
},
"https://www.googleapis.com/auth/trace.readonly": {
"description": "Read Trace data for a project or application"
}
}
}
},
"basePath": "",
"baseUrl": "https://cloudtrace.googleapis.com/",
"batchPath": "batch",
"canonicalName": "Cloud Trace",
"description": "Sends application trace data to Cloud Trace for viewing. Trace data is collected for all App Engine applications by default. Trace data from other applications can be provided using this API. This library is used to interact with the Cloud Trace API directly. If you are looking to instrument your application for Cloud Trace, we recommend using OpenCensus.\n",
"discoveryVersion": "v1",
"documentationLink": "https://cloud.google.com/trace",
"fullyEncodeReservedExpansion": true,
},
"basePath": "",
"baseUrl": "https://cloudtrace.googleapis.com/",
"batchPath": "batch",
"canonicalName": "Cloud Trace",
"description": "Sends application trace data to Cloud Trace for viewing. Trace data is collected for all App Engine applications by default. Trace data from other applications can be provided using this API. This library is used to interact with the Cloud Trace API directly. If you are looking to instrument your application for Cloud Trace, we recommend using OpenCensus. ",
"discoveryVersion": "v1",
"documentationLink": "https://cloud.google.com/trace",
"fullyEncodeReservedExpansion": true,
"icons": {
"x16": "http://www.google.com/images/icons/product/search-16.gif",
"x16": "http://www.google.com/images/icons/product/search-16.gif",
"x32": "http://www.google.com/images/icons/product/search-32.gif"
},
"id": "cloudtrace:v1",
"kind": "discovery#restDescription",
"mtlsRootUrl": "https://cloudtrace.mtls.googleapis.com/",
"name": "cloudtrace",
"ownerDomain": "google.com",
"ownerName": "Google",
},
"id": "cloudtrace:v1",
"kind": "discovery#restDescription",
"mtlsRootUrl": "https://cloudtrace.mtls.googleapis.com/",
"name": "cloudtrace",
"ownerDomain": "google.com",
"ownerName": "Google",
"parameters": {
"$.xgafv": {
"description": "V1 error format.",
"description": "V1 error format.",
"enum": [
"1",
"1",
"2"
],
],
"enumDescriptions": [
"v1 error format",
"v1 error format",
"v2 error format"
],
"location": "query",
],
"location": "query",
"type": "string"
},
},
"access_token": {
"description": "OAuth access token.",
"location": "query",
"description": "OAuth access token.",
"location": "query",
"type": "string"
},
},
"alt": {
"default": "json",
"description": "Data format for response.",
"default": "json",
"description": "Data format for response.",
"enum": [
"json",
"media",
"json",
"media",
"proto"
],
],
"enumDescriptions": [
"Responses with Content-Type of application/json",
"Media download with context-dependent Content-Type",
"Responses with Content-Type of application/json",
"Media download with context-dependent Content-Type",
"Responses with Content-Type of application/x-protobuf"
],
"location": "query",
],
"location": "query",
"type": "string"
},
},
"callback": {
"description": "JSONP",
"location": "query",
"description": "JSONP",
"location": "query",
"type": "string"
},
},
"fields": {
"description": "Selector specifying which fields to include in a partial response.",
"location": "query",
"description": "Selector specifying which fields to include in a partial response.",
"location": "query",
"type": "string"
},
},
"key": {
"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
"location": "query",
"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
"location": "query",
"type": "string"
},
},
"oauth_token": {
"description": "OAuth 2.0 token for the current user.",
"location": "query",
"description": "OAuth 2.0 token for the current user.",
"location": "query",
"type": "string"
},
},
"prettyPrint": {
"default": "true",
"description": "Returns response with indentations and line breaks.",
"location": "query",
"default": "true",
"description": "Returns response with indentations and line breaks.",
"location": "query",
"type": "boolean"
},
},
"quotaUser": {
"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
"location": "query",
"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
"location": "query",
"type": "string"
},
},
"uploadType": {
"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
"location": "query",
"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
"location": "query",
"type": "string"
},
},
"upload_protocol": {
"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
"location": "query",
"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
"location": "query",
"type": "string"
}
},
"protocol": "rest",
},
"protocol": "rest",
"resources": {
"projects": {
"methods": {
"patchTraces": {
"description": "Sends new traces to Stackdriver Trace or updates existing traces. If the ID\nof a trace that you send matches that of an existing trace, any fields\nin the existing trace and its spans are overwritten by the provided values,\nand any new fields provided are merged with the existing trace data. If the\nID does not match, a new trace is created.\nIn this case, writing traces is not considered an active developer\nmethod since traces are machine generated.",
"flatPath": "v1/projects/{projectId}/traces",
"httpMethod": "PATCH",
"id": "cloudtrace.projects.patchTraces",
"description": "Sends new traces to Cloud Trace or updates existing traces. If the ID of a trace that you send matches that of an existing trace, any fields in the existing trace and its spans are overwritten by the provided values, and any new fields provided are merged with the existing trace data. If the ID does not match, a new trace is created.",
"flatPath": "v1/projects/{projectId}/traces",
"httpMethod": "PATCH",
"id": "cloudtrace.projects.patchTraces",
"parameterOrder": [
"projectId"
],
],
"parameters": {
"projectId": {
"description": "Required. ID of the Cloud project where the trace data is stored.",
"location": "path",
"required": true,
"description": "Required. ID of the Cloud project where the trace data is stored.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v1/projects/{projectId}/traces",
},
"path": "v1/projects/{projectId}/traces",
"request": {
"$ref": "Traces"
},
},
"response": {
"$ref": "Empty"
},
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/trace.append"
]
}
},
},
"resources": {
"traces": {
"methods": {
"get": {
"description": "Gets a single trace by its ID.\nIn this case, getting for traces is considered an active developer method,\neven though it is technically a read-only method.",
"flatPath": "v1/projects/{projectId}/traces/{traceId}",
"httpMethod": "GET",
"id": "cloudtrace.projects.traces.get",
"description": "Gets a single trace by its ID.",
"flatPath": "v1/projects/{projectId}/traces/{traceId}",
"httpMethod": "GET",
"id": "cloudtrace.projects.traces.get",
"parameterOrder": [
"projectId",
"projectId",
"traceId"
],
],
"parameters": {
"projectId": {
"description": "Required. ID of the Cloud project where the trace data is stored.",
"location": "path",
"required": true,
"description": "Required. ID of the Cloud project where the trace data is stored.",
"location": "path",
"required": true,
"type": "string"
},
},
"traceId": {
"description": "Required. ID of the trace to return.",
"location": "path",
"required": true,
"description": "Required. ID of the trace to return.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "v1/projects/{projectId}/traces/{traceId}",
},
"path": "v1/projects/{projectId}/traces/{traceId}",
"response": {
"$ref": "Trace"
},
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/trace.readonly"
]
},
},
"list": {
"description": "Returns of a list of traces that match the specified filter conditions.\nIn this case, listing for traces is considered an active developer method,\neven though it is technically a read-only method.",
"flatPath": "v1/projects/{projectId}/traces",
"httpMethod": "GET",
"id": "cloudtrace.projects.traces.list",
"description": "Returns of a list of traces that match the specified filter conditions.",
"flatPath": "v1/projects/{projectId}/traces",
"httpMethod": "GET",
"id": "cloudtrace.projects.traces.list",
"parameterOrder": [
"projectId"
],
],
"parameters": {
"endTime": {
"description": "End of the time interval (inclusive) during which the trace data was\ncollected from the application.",
"format": "google-datetime",
"location": "query",
"description": "End of the time interval (inclusive) during which the trace data was collected from the application.",
"format": "google-datetime",
"location": "query",
"type": "string"
},
},
"filter": {
"description": "Optional. A filter against labels for the request.\n\nBy default, searches use prefix matching. To specify exact match, prepend\na plus symbol (`+`) to the search term.\nMultiple terms are ANDed. Syntax:\n\n* `root:NAME_PREFIX` or `NAME_PREFIX`: Return traces where any root\n span starts with `NAME_PREFIX`.\n* `+root:NAME` or `+NAME`: Return traces where any root span's name is\n exactly `NAME`.\n* `span:NAME_PREFIX`: Return traces where any span starts with\n `NAME_PREFIX`.\n* `+span:NAME`: Return traces where any span's name is exactly\n `NAME`.\n* `latency:DURATION`: Return traces whose overall latency is\n greater or equal to than `DURATION`. Accepted units are nanoseconds\n (`ns`), milliseconds (`ms`), and seconds (`s`). Default is `ms`. For\n example, `latency:24ms` returns traces whose overall latency\n is greater than or equal to 24 milliseconds.\n* `label:LABEL_KEY`: Return all traces containing the specified\n label key (exact match, case-sensitive) regardless of the key:value\n pair's value (including empty values).\n* `LABEL_KEY:VALUE_PREFIX`: Return all traces containing the specified\n label key (exact match, case-sensitive) whose value starts with\n `VALUE_PREFIX`. Both a key and a value must be specified.\n* `+LABEL_KEY:VALUE`: Return all traces containing a key:value pair\n exactly matching the specified text. Both a key and a value must be\n specified.\n* `method:VALUE`: Equivalent to `/http/method:VALUE`.\n* `url:VALUE`: Equivalent to `/http/url:VALUE`.",
"location": "query",
"description": "Optional. A filter against labels for the request. By default, searches use prefix matching. To specify exact match, prepend a plus symbol (`+`) to the search term. Multiple terms are ANDed. Syntax: * `root:NAME_PREFIX` or `NAME_PREFIX`: Return traces where any root span starts with `NAME_PREFIX`. * `+root:NAME` or `+NAME`: Return traces where any root span's name is exactly `NAME`. * `span:NAME_PREFIX`: Return traces where any span starts with `NAME_PREFIX`. * `+span:NAME`: Return traces where any span's name is exactly `NAME`. * `latency:DURATION`: Return traces whose overall latency is greater or equal to than `DURATION`. Accepted units are nanoseconds (`ns`), milliseconds (`ms`), and seconds (`s`). Default is `ms`. For example, `latency:24ms` returns traces whose overall latency is greater than or equal to 24 milliseconds. * `label:LABEL_KEY`: Return all traces containing the specified label key (exact match, case-sensitive) regardless of the key:value pair's value (including empty values). * `LABEL_KEY:VALUE_PREFIX`: Return all traces containing the specified label key (exact match, case-sensitive) whose value starts with `VALUE_PREFIX`. Both a key and a value must be specified. * `+LABEL_KEY:VALUE`: Return all traces containing a key:value pair exactly matching the specified text. Both a key and a value must be specified. * `method:VALUE`: Equivalent to `/http/method:VALUE`. * `url:VALUE`: Equivalent to `/http/url:VALUE`.",
"location": "query",
"type": "string"
},
},
"orderBy": {
"description": "Optional. Field used to sort the returned traces.\nCan be one of the following:\n\n* `trace_id`\n* `name` (`name` field of root span in the trace)\n* `duration` (difference between `end_time` and `start_time` fields of\n the root span)\n* `start` (`start_time` field of the root span)\n\nDescending order can be specified by appending `desc` to the sort field\n(for example, `name desc`).\n\nOnly one sort field is permitted.",
"location": "query",
"description": "Optional. Field used to sort the returned traces. Can be one of the following: * `trace_id` * `name` (`name` field of root span in the trace) * `duration` (difference between `end_time` and `start_time` fields of the root span) * `start` (`start_time` field of the root span) Descending order can be specified by appending `desc` to the sort field (for example, `name desc`). Only one sort field is permitted.",
"location": "query",
"type": "string"
},
},
"pageSize": {
"description": "Optional. Maximum number of traces to return. If not specified or <= 0, the\nimplementation selects a reasonable value. The implementation may\nreturn fewer traces than the requested page size.",
"format": "int32",
"location": "query",
"description": "Optional. Maximum number of traces to return. If not specified or <= 0, the implementation selects a reasonable value. The implementation may return fewer traces than the requested page size.",
"format": "int32",
"location": "query",
"type": "integer"
},
},
"pageToken": {
"description": "Token identifying the page of results to return. If provided, use the\nvalue of the `next_page_token` field from a previous request.",
"location": "query",
"description": "Token identifying the page of results to return. If provided, use the value of the `next_page_token` field from a previous request.",
"location": "query",
"type": "string"
},
},
"projectId": {
"description": "Required. ID of the Cloud project where the trace data is stored.",
"location": "path",
"required": true,
"description": "Required. ID of the Cloud project where the trace data is stored.",
"location": "path",
"required": true,
"type": "string"
},
},
"startTime": {
"description": "Start of the time interval (inclusive) during which the trace data was\ncollected from the application.",
"format": "google-datetime",
"location": "query",
"description": "Start of the time interval (inclusive) during which the trace data was collected from the application.",
"format": "google-datetime",
"location": "query",
"type": "string"
},
},
"view": {
"description": "Optional. Type of data returned for traces in the list. Default is\n`MINIMAL`.",
"description": "Optional. Type of data returned for traces in the list. Default is `MINIMAL`.",
"enum": [
"VIEW_TYPE_UNSPECIFIED",
"MINIMAL",
"ROOTSPAN",
"VIEW_TYPE_UNSPECIFIED",
"MINIMAL",
"ROOTSPAN",
"COMPLETE"
],
"location": "query",
],
"enumDescriptions": [
"Default is `MINIMAL` if unspecified.",
"Minimal view of the trace record that contains only the project and trace IDs.",
"Root span view of the trace record that returns the root spans along with the minimal trace data.",
"Complete view of the trace record that contains the actual trace data. This is equivalent to calling the REST `get` or RPC `GetTrace` method using the ID of each listed trace."
],
"location": "query",
"type": "string"
}
},
"path": "v1/projects/{projectId}/traces",
},
"path": "v1/projects/{projectId}/traces",
"response": {
"$ref": "ListTracesResponse"
},
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/trace.readonly"
]
}
@@ -250,125 +256,125 @@
}
}
}
},
"revision": "20200622",
"rootUrl": "https://cloudtrace.googleapis.com/",
},
"revision": "20210319",
"rootUrl": "https://cloudtrace.googleapis.com/",
"schemas": {
"Empty": {
"description": "A generic empty message that you can re-use to avoid defining duplicated\nempty messages in your APIs. A typical example is to use it as the request\nor the response type of an API method. For instance:\n\n service Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.",
"id": "Empty",
"properties": {},
"description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.",
"id": "Empty",
"properties": {},
"type": "object"
},
},
"ListTracesResponse": {
"description": "The response message for the `ListTraces` method.",
"id": "ListTracesResponse",
"description": "The response message for the `ListTraces` method.",
"id": "ListTracesResponse",
"properties": {
"nextPageToken": {
"description": "If defined, indicates that there are more traces that match the request\nand that this value should be passed to the next request to continue\nretrieving additional traces.",
"description": "If defined, indicates that there are more traces that match the request and that this value should be passed to the next request to continue retrieving additional traces.",
"type": "string"
},
},
"traces": {
"description": "List of trace records as specified by the view parameter.",
"description": "List of trace records as specified by the view parameter.",
"items": {
"$ref": "Trace"
},
},
"type": "array"
}
},
},
"type": "object"
},
},
"Trace": {
"description": "A trace describes how long it takes for an application to perform an\noperation. It consists of a set of spans, each of which represent a single\ntimed event within the operation.",
"id": "Trace",
"description": "A trace describes how long it takes for an application to perform an operation. It consists of a set of spans, each of which represent a single timed event within the operation.",
"id": "Trace",
"properties": {
"projectId": {
"description": "Project ID of the Cloud project where the trace data is stored.",
"description": "Project ID of the Cloud project where the trace data is stored.",
"type": "string"
},
},
"spans": {
"description": "Collection of spans in the trace.",
"description": "Collection of spans in the trace.",
"items": {
"$ref": "TraceSpan"
},
},
"type": "array"
},
},
"traceId": {
"description": "Globally unique identifier for the trace. This identifier is a 128-bit\nnumeric value formatted as a 32-byte hex string. For example,\n`382d4f4c6b7bb2f4a972559d9085001d`.",
"description": "Globally unique identifier for the trace. This identifier is a 128-bit numeric value formatted as a 32-byte hex string. For example, `382d4f4c6b7bb2f4a972559d9085001d`. The numeric value should not be zero.",
"type": "string"
}
},
},
"type": "object"
},
},
"TraceSpan": {
"description": "A span represents a single timed event within a trace. Spans can be nested\nand form a trace tree. Often, a trace contains a root span that describes the\nend-to-end latency of an operation and, optionally, one or more subspans for\nits suboperations. Spans do not need to be contiguous. There may be gaps\nbetween spans in a trace.",
"id": "TraceSpan",
"description": "A span represents a single timed event within a trace. Spans can be nested and form a trace tree. Often, a trace contains a root span that describes the end-to-end latency of an operation and, optionally, one or more subspans for its suboperations. Spans do not need to be contiguous. There may be gaps between spans in a trace.",
"id": "TraceSpan",
"properties": {
"endTime": {
"description": "End time of the span in nanoseconds from the UNIX epoch.",
"format": "google-datetime",
"description": "End time of the span in nanoseconds from the UNIX epoch.",
"format": "google-datetime",
"type": "string"
},
},
"kind": {
"description": "Distinguishes between spans generated in a particular context. For example,\ntwo spans with the same name may be distinguished using `RPC_CLIENT`\nand `RPC_SERVER` to identify queueing latency associated with the span.",
"description": "Distinguishes between spans generated in a particular context. For example, two spans with the same name may be distinguished using `RPC_CLIENT` and `RPC_SERVER` to identify queueing latency associated with the span.",
"enum": [
"SPAN_KIND_UNSPECIFIED",
"RPC_SERVER",
"SPAN_KIND_UNSPECIFIED",
"RPC_SERVER",
"RPC_CLIENT"
],
],
"enumDescriptions": [
"Unspecified.",
"Indicates that the span covers server-side handling of an RPC or other\nremote network request.",
"Indicates that the span covers the client-side wrapper around an RPC or\nother remote request."
],
"Unspecified.",
"Indicates that the span covers server-side handling of an RPC or other remote network request.",
"Indicates that the span covers the client-side wrapper around an RPC or other remote request."
],
"type": "string"
},
},
"labels": {
"additionalProperties": {
"type": "string"
},
"description": "Collection of labels associated with the span. Label keys must be less than\n128 bytes. Label values must be less than 16 kilobytes (10MB for\n`/stacktrace` values).\n\nSome predefined label keys exist, or you may create your own. When creating\nyour own, we recommend the following formats:\n\n* `/category/product/key` for agents of well-known products (e.g.\n `/db/mongodb/read_size`).\n* `short_host/path/key` for domain-specific keys (e.g.\n `foo.com/myproduct/bar`)\n\nPredefined labels include:\n\n* `/agent`\n* `/component`\n* `/error/message`\n* `/error/name`\n* `/http/client_city`\n* `/http/client_country`\n* `/http/client_protocol`\n* `/http/client_region`\n* `/http/host`\n* `/http/method`\n* `/http/path`\n* `/http/redirected_url`\n* `/http/request/size`\n* `/http/response/size`\n* `/http/route`\n* `/http/status_code`\n* `/http/url`\n* `/http/user_agent`\n* `/pid`\n* `/stacktrace`\n* `/tid`",
},
"description": "Collection of labels associated with the span. Label keys must be less than 128 bytes. Label values must be less than 16 kilobytes (10MB for `/stacktrace` values). Some predefined label keys exist, or you may create your own. When creating your own, we recommend the following formats: * `/category/product/key` for agents of well-known products (e.g. `/db/mongodb/read_size`). * `short_host/path/key` for domain-specific keys (e.g. `foo.com/myproduct/bar`) Predefined labels include: * `/agent` * `/component` * `/error/message` * `/error/name` * `/http/client_city` * `/http/client_country` * `/http/client_protocol` * `/http/client_region` * `/http/host` * `/http/method` * `/http/path` * `/http/redirected_url` * `/http/request/size` * `/http/response/size` * `/http/route` * `/http/status_code` * `/http/url` * `/http/user_agent` * `/pid` * `/stacktrace` * `/tid`",
"type": "object"
},
},
"name": {
"description": "Name of the span. Must be less than 128 bytes. The span name is sanitized\nand displayed in the Stackdriver Trace tool in the\nGoogle Cloud Platform Console.\nThe name may be a method name or some other per-call site name.\nFor the same executable and the same call point, a best practice is\nto use a consistent name, which makes it easier to correlate\ncross-trace spans.",
"description": "Name of the span. Must be less than 128 bytes. The span name is sanitized and displayed in the Trace tool in the Google Cloud Platform Console. The name may be a method name or some other per-call site name. For the same executable and the same call point, a best practice is to use a consistent name, which makes it easier to correlate cross-trace spans.",
"type": "string"
},
},
"parentSpanId": {
"description": "Optional. ID of the parent span, if any.",
"format": "uint64",
"description": "Optional. ID of the parent span, if any.",
"format": "uint64",
"type": "string"
},
},
"spanId": {
"description": "Identifier for the span. Must be a 64-bit integer other than 0 and\nunique within a trace. For example, `2205310701640571284`.",
"format": "uint64",
"description": "Identifier for the span. Must be a 64-bit integer other than 0 and unique within a trace. For example, `2205310701640571284`.",
"format": "uint64",
"type": "string"
},
},
"startTime": {
"description": "Start time of the span in nanoseconds from the UNIX epoch.",
"format": "google-datetime",
"description": "Start time of the span in nanoseconds from the UNIX epoch.",
"format": "google-datetime",
"type": "string"
}
},
},
"type": "object"
},
},
"Traces": {
"description": "List of new or updated traces.",
"id": "Traces",
"description": "List of new or updated traces.",
"id": "Traces",
"properties": {
"traces": {
"description": "List of traces.",
"description": "List of traces.",
"items": {
"$ref": "Trace"
},
},
"type": "array"
}
},
},
"type": "object"
}
},
"servicePath": "",
"title": "Cloud Trace API",
"version": "v1",
},
"servicePath": "",
"title": "Cloud Trace API",
"version": "v1",
"version_module": true
}

View File

@@ -4,173 +4,173 @@
"scopes": {
"https://www.googleapis.com/auth/cloud-platform": {
"description": "View and manage your data across Google Cloud Platform services"
},
},
"https://www.googleapis.com/auth/trace.append": {
"description": "Write Trace data for a project or application"
}
}
}
},
"basePath": "",
"baseUrl": "https://cloudtrace.googleapis.com/",
"batchPath": "batch",
"canonicalName": "Cloud Trace",
"description": "Sends application trace data to Cloud Trace for viewing. Trace data is collected for all App Engine applications by default. Trace data from other applications can be provided using this API. This library is used to interact with the Cloud Trace API directly. If you are looking to instrument your application for Cloud Trace, we recommend using OpenCensus.\n",
"discoveryVersion": "v1",
"documentationLink": "https://cloud.google.com/trace",
"fullyEncodeReservedExpansion": true,
},
"basePath": "",
"baseUrl": "https://cloudtrace.googleapis.com/",
"batchPath": "batch",
"canonicalName": "Cloud Trace",
"description": "Sends application trace data to Cloud Trace for viewing. Trace data is collected for all App Engine applications by default. Trace data from other applications can be provided using this API. This library is used to interact with the Cloud Trace API directly. If you are looking to instrument your application for Cloud Trace, we recommend using OpenCensus. ",
"discoveryVersion": "v1",
"documentationLink": "https://cloud.google.com/trace",
"fullyEncodeReservedExpansion": true,
"icons": {
"x16": "http://www.google.com/images/icons/product/search-16.gif",
"x16": "http://www.google.com/images/icons/product/search-16.gif",
"x32": "http://www.google.com/images/icons/product/search-32.gif"
},
"id": "cloudtrace:v2",
"kind": "discovery#restDescription",
"mtlsRootUrl": "https://cloudtrace.mtls.googleapis.com/",
"name": "cloudtrace",
"ownerDomain": "google.com",
"ownerName": "Google",
},
"id": "cloudtrace:v2",
"kind": "discovery#restDescription",
"mtlsRootUrl": "https://cloudtrace.mtls.googleapis.com/",
"name": "cloudtrace",
"ownerDomain": "google.com",
"ownerName": "Google",
"parameters": {
"$.xgafv": {
"description": "V1 error format.",
"description": "V1 error format.",
"enum": [
"1",
"1",
"2"
],
],
"enumDescriptions": [
"v1 error format",
"v1 error format",
"v2 error format"
],
"location": "query",
],
"location": "query",
"type": "string"
},
},
"access_token": {
"description": "OAuth access token.",
"location": "query",
"description": "OAuth access token.",
"location": "query",
"type": "string"
},
},
"alt": {
"default": "json",
"description": "Data format for response.",
"default": "json",
"description": "Data format for response.",
"enum": [
"json",
"media",
"json",
"media",
"proto"
],
],
"enumDescriptions": [
"Responses with Content-Type of application/json",
"Media download with context-dependent Content-Type",
"Responses with Content-Type of application/json",
"Media download with context-dependent Content-Type",
"Responses with Content-Type of application/x-protobuf"
],
"location": "query",
],
"location": "query",
"type": "string"
},
},
"callback": {
"description": "JSONP",
"location": "query",
"description": "JSONP",
"location": "query",
"type": "string"
},
},
"fields": {
"description": "Selector specifying which fields to include in a partial response.",
"location": "query",
"description": "Selector specifying which fields to include in a partial response.",
"location": "query",
"type": "string"
},
},
"key": {
"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
"location": "query",
"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
"location": "query",
"type": "string"
},
},
"oauth_token": {
"description": "OAuth 2.0 token for the current user.",
"location": "query",
"description": "OAuth 2.0 token for the current user.",
"location": "query",
"type": "string"
},
},
"prettyPrint": {
"default": "true",
"description": "Returns response with indentations and line breaks.",
"location": "query",
"default": "true",
"description": "Returns response with indentations and line breaks.",
"location": "query",
"type": "boolean"
},
},
"quotaUser": {
"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
"location": "query",
"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
"location": "query",
"type": "string"
},
},
"uploadType": {
"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
"location": "query",
"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
"location": "query",
"type": "string"
},
},
"upload_protocol": {
"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
"location": "query",
"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
"location": "query",
"type": "string"
}
},
"protocol": "rest",
},
"protocol": "rest",
"resources": {
"projects": {
"resources": {
"traces": {
"methods": {
"batchWrite": {
"description": "Sends new spans to new or existing traces. You cannot update\nexisting spans.\nIn this case, writing traces is not considered an active developer\nmethod since traces are machine generated.",
"flatPath": "v2/projects/{projectsId}/traces:batchWrite",
"httpMethod": "POST",
"id": "cloudtrace.projects.traces.batchWrite",
"description": "Sends new spans to new or existing traces. You cannot update existing spans.",
"flatPath": "v2/projects/{projectsId}/traces:batchWrite",
"httpMethod": "POST",
"id": "cloudtrace.projects.traces.batchWrite",
"parameterOrder": [
"name"
],
],
"parameters": {
"name": {
"description": "Required. The name of the project where the spans belong. The format is\n`projects/[PROJECT_ID]`.",
"location": "path",
"pattern": "^projects/[^/]+$",
"required": true,
"description": "Required. The name of the project where the spans belong. The format is `projects/[PROJECT_ID]`.",
"location": "path",
"pattern": "^projects/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v2/{+name}/traces:batchWrite",
},
"path": "v2/{+name}/traces:batchWrite",
"request": {
"$ref": "BatchWriteSpansRequest"
},
},
"response": {
"$ref": "Empty"
},
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/trace.append"
]
}
},
},
"resources": {
"spans": {
"methods": {
"createSpan": {
"description": "Creates a new span.\nIn this case, writing traces is not considered an active developer\nmethod since traces are machine generated.",
"flatPath": "v2/projects/{projectsId}/traces/{tracesId}/spans/{spansId}",
"httpMethod": "POST",
"id": "cloudtrace.projects.traces.spans.createSpan",
"description": "Creates a new span.",
"flatPath": "v2/projects/{projectsId}/traces/{tracesId}/spans/{spansId}",
"httpMethod": "POST",
"id": "cloudtrace.projects.traces.spans.createSpan",
"parameterOrder": [
"name"
],
],
"parameters": {
"name": {
"description": "The resource name of the span in the following format:\n\n projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/SPAN_ID is a unique identifier for a trace within a project;\nit is a 32-character hexadecimal encoding of a 16-byte array.\n\n[SPAN_ID] is a unique identifier for a span within a trace; it\nis a 16-character hexadecimal encoding of an 8-byte array.",
"location": "path",
"pattern": "^projects/[^/]+/traces/[^/]+/spans/[^/]+$",
"required": true,
"description": "Required. The resource name of the span in the following format: projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/SPAN_ID is a unique identifier for a trace within a project; it is a 32-character hexadecimal encoding of a 16-byte array. [SPAN_ID] is a unique identifier for a span within a trace; it is a 16-character hexadecimal encoding of an 8-byte array. It should not be zero.",
"location": "path",
"pattern": "^projects/[^/]+/traces/[^/]+/spans/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v2/{+name}",
},
"path": "v2/{+name}",
"request": {
"$ref": "Span"
},
},
"response": {
"$ref": "Span"
},
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/trace.append"
]
}
@@ -180,431 +180,431 @@
}
}
}
},
"revision": "20200622",
"rootUrl": "https://cloudtrace.googleapis.com/",
},
"revision": "20210319",
"rootUrl": "https://cloudtrace.googleapis.com/",
"schemas": {
"Annotation": {
"description": "Text annotation with a set of attributes.",
"id": "Annotation",
"description": "Text annotation with a set of attributes.",
"id": "Annotation",
"properties": {
"attributes": {
"$ref": "Attributes",
"description": "A set of attributes on the annotation. You can have up to 4 attributes\nper Annotation."
},
"$ref": "Attributes",
"description": "A set of attributes on the annotation. You can have up to 4 attributes per Annotation."
},
"description": {
"$ref": "TruncatableString",
"description": "A user-supplied message describing the event. The maximum length for\nthe description is 256 bytes."
"$ref": "TruncatableString",
"description": "A user-supplied message describing the event. The maximum length for the description is 256 bytes."
}
},
},
"type": "object"
},
},
"AttributeValue": {
"description": "The allowed types for [VALUE] in a `[KEY]:[VALUE]` attribute.",
"id": "AttributeValue",
"description": "The allowed types for [VALUE] in a `[KEY]:[VALUE]` attribute.",
"id": "AttributeValue",
"properties": {
"boolValue": {
"description": "A Boolean value represented by `true` or `false`.",
"description": "A Boolean value represented by `true` or `false`.",
"type": "boolean"
},
},
"intValue": {
"description": "A 64-bit signed integer.",
"format": "int64",
"description": "A 64-bit signed integer.",
"format": "int64",
"type": "string"
},
},
"stringValue": {
"$ref": "TruncatableString",
"$ref": "TruncatableString",
"description": "A string up to 256 bytes long."
}
},
},
"type": "object"
},
},
"Attributes": {
"description": "A set of attributes, each in the format `[KEY]:[VALUE]`.",
"id": "Attributes",
"description": "A set of attributes, each in the format `[KEY]:[VALUE]`.",
"id": "Attributes",
"properties": {
"attributeMap": {
"additionalProperties": {
"$ref": "AttributeValue"
},
"description": "The set of attributes. Each attribute's key can be up to 128 bytes\nlong. The value can be a string up to 256 bytes, a signed 64-bit integer,\nor the Boolean values `true` and `false`. For example:\n\n \"/instance_id\": { \"string_value\": { \"value\": \"my-instance\" } }\n \"/http/request_bytes\": { \"int_value\": 300 }\n \"abc.com/myattribute\": { \"bool_value\": false }",
},
"description": "The set of attributes. Each attribute's key can be up to 128 bytes long. The value can be a string up to 256 bytes, a signed 64-bit integer, or the Boolean values `true` and `false`. For example: \"/instance_id\": { \"string_value\": { \"value\": \"my-instance\" } } \"/http/request_bytes\": { \"int_value\": 300 } \"abc.com/myattribute\": { \"bool_value\": false }",
"type": "object"
},
},
"droppedAttributesCount": {
"description": "The number of attributes that were discarded. Attributes can be discarded\nbecause their keys are too long or because there are too many attributes.\nIf this value is 0 then all attributes are valid.",
"format": "int32",
"description": "The number of attributes that were discarded. Attributes can be discarded because their keys are too long or because there are too many attributes. If this value is 0 then all attributes are valid.",
"format": "int32",
"type": "integer"
}
},
},
"type": "object"
},
},
"BatchWriteSpansRequest": {
"description": "The request message for the `BatchWriteSpans` method.",
"id": "BatchWriteSpansRequest",
"description": "The request message for the `BatchWriteSpans` method.",
"id": "BatchWriteSpansRequest",
"properties": {
"spans": {
"description": "Required. A list of new spans. The span names must not match existing\nspans, or the results are undefined.",
"description": "Required. A list of new spans. The span names must not match existing spans, or the results are undefined.",
"items": {
"$ref": "Span"
},
},
"type": "array"
}
},
},
"type": "object"
},
},
"Empty": {
"description": "A generic empty message that you can re-use to avoid defining duplicated\nempty messages in your APIs. A typical example is to use it as the request\nor the response type of an API method. For instance:\n\n service Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.",
"id": "Empty",
"properties": {},
"description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.",
"id": "Empty",
"properties": {},
"type": "object"
},
},
"Link": {
"description": "A pointer from the current span to another span in the same trace or in a\ndifferent trace. For example, this can be used in batching operations,\nwhere a single batch handler processes multiple requests from different\ntraces or when the handler receives a request from a different project.",
"id": "Link",
"description": "A pointer from the current span to another span in the same trace or in a different trace. For example, this can be used in batching operations, where a single batch handler processes multiple requests from different traces or when the handler receives a request from a different project.",
"id": "Link",
"properties": {
"attributes": {
"$ref": "Attributes",
"description": "A set of attributes on the link. You have have up to 32 attributes per\nlink."
},
"$ref": "Attributes",
"description": "A set of attributes on the link. You have have up to 32 attributes per link."
},
"spanId": {
"description": "The [SPAN_ID] for a span within a trace.",
"description": "The [SPAN_ID] for a span within a trace.",
"type": "string"
},
},
"traceId": {
"description": "The [TRACE_ID] for a trace within a project.",
"description": "The [TRACE_ID] for a trace within a project.",
"type": "string"
},
},
"type": {
"description": "The relationship of the current span relative to the linked span.",
"description": "The relationship of the current span relative to the linked span.",
"enum": [
"TYPE_UNSPECIFIED",
"CHILD_LINKED_SPAN",
"TYPE_UNSPECIFIED",
"CHILD_LINKED_SPAN",
"PARENT_LINKED_SPAN"
],
],
"enumDescriptions": [
"The relationship of the two spans is unknown.",
"The linked span is a child of the current span.",
"The relationship of the two spans is unknown.",
"The linked span is a child of the current span.",
"The linked span is a parent of the current span."
],
],
"type": "string"
}
},
},
"type": "object"
},
},
"Links": {
"description": "A collection of links, which are references from this span to a span\nin the same or different trace.",
"id": "Links",
"description": "A collection of links, which are references from this span to a span in the same or different trace.",
"id": "Links",
"properties": {
"droppedLinksCount": {
"description": "The number of dropped links after the maximum size was enforced. If\nthis value is 0, then no links were dropped.",
"format": "int32",
"description": "The number of dropped links after the maximum size was enforced. If this value is 0, then no links were dropped.",
"format": "int32",
"type": "integer"
},
},
"link": {
"description": "A collection of links.",
"description": "A collection of links.",
"items": {
"$ref": "Link"
},
},
"type": "array"
}
},
},
"type": "object"
},
},
"MessageEvent": {
"description": "An event describing a message sent/received between Spans.",
"id": "MessageEvent",
"description": "An event describing a message sent/received between Spans.",
"id": "MessageEvent",
"properties": {
"compressedSizeBytes": {
"description": "The number of compressed bytes sent or received. If missing assumed to\nbe the same size as uncompressed.",
"format": "int64",
"description": "The number of compressed bytes sent or received. If missing assumed to be the same size as uncompressed.",
"format": "int64",
"type": "string"
},
},
"id": {
"description": "An identifier for the MessageEvent's message that can be used to match\nSENT and RECEIVED MessageEvents. It is recommended to be unique within\na Span.",
"format": "int64",
"description": "An identifier for the MessageEvent's message that can be used to match SENT and RECEIVED MessageEvents. It is recommended to be unique within a Span.",
"format": "int64",
"type": "string"
},
},
"type": {
"description": "Type of MessageEvent. Indicates whether the message was sent or\nreceived.",
"description": "Type of MessageEvent. Indicates whether the message was sent or received.",
"enum": [
"TYPE_UNSPECIFIED",
"SENT",
"TYPE_UNSPECIFIED",
"SENT",
"RECEIVED"
],
],
"enumDescriptions": [
"Unknown event type.",
"Indicates a sent message.",
"Unknown event type.",
"Indicates a sent message.",
"Indicates a received message."
],
],
"type": "string"
},
},
"uncompressedSizeBytes": {
"description": "The number of uncompressed bytes sent or received.",
"format": "int64",
"description": "The number of uncompressed bytes sent or received.",
"format": "int64",
"type": "string"
}
},
},
"type": "object"
},
},
"Module": {
"description": "Binary module.",
"id": "Module",
"description": "Binary module.",
"id": "Module",
"properties": {
"buildId": {
"$ref": "TruncatableString",
"description": "A unique identifier for the module, usually a hash of its\ncontents (up to 128 bytes)."
},
"$ref": "TruncatableString",
"description": "A unique identifier for the module, usually a hash of its contents (up to 128 bytes)."
},
"module": {
"$ref": "TruncatableString",
"description": "For example: main binary, kernel modules, and dynamic libraries\nsuch as libc.so, sharedlib.so (up to 256 bytes)."
"$ref": "TruncatableString",
"description": "For example: main binary, kernel modules, and dynamic libraries such as libc.so, sharedlib.so (up to 256 bytes)."
}
},
},
"type": "object"
},
},
"Span": {
"description": "A span represents a single operation within a trace. Spans can be\nnested to form a trace tree. Often, a trace contains a root span\nthat describes the end-to-end latency, and one or more subspans for\nits sub-operations. A trace can also contain multiple root spans,\nor none at all. Spans do not need to be contiguous&mdash;there may be\ngaps or overlaps between spans in a trace.",
"id": "Span",
"description": "A span represents a single operation within a trace. Spans can be nested to form a trace tree. Often, a trace contains a root span that describes the end-to-end latency, and one or more subspans for its sub-operations. A trace can also contain multiple root spans, or none at all. Spans do not need to be contiguous\u2014there may be gaps or overlaps between spans in a trace.",
"id": "Span",
"properties": {
"attributes": {
"$ref": "Attributes",
"description": "A set of attributes on the span. You can have up to 32 attributes per\nspan."
},
"$ref": "Attributes",
"description": "A set of attributes on the span. You can have up to 32 attributes per span."
},
"childSpanCount": {
"description": "Optional. The number of child spans that were generated while this span\nwas active. If set, allows implementation to detect missing child spans.",
"format": "int32",
"description": "Optional. The number of child spans that were generated while this span was active. If set, allows implementation to detect missing child spans.",
"format": "int32",
"type": "integer"
},
},
"displayName": {
"$ref": "TruncatableString",
"description": "Required. A description of the span's operation (up to 128 bytes).\nStackdriver Trace displays the description in the\nGoogle Cloud Platform Console.\nFor example, the display name can be a qualified method name or a file name\nand a line number where the operation is called. A best practice is to use\nthe same display name within an application and at the same call point.\nThis makes it easier to correlate spans in different traces."
},
"$ref": "TruncatableString",
"description": "Required. A description of the span's operation (up to 128 bytes). Trace displays the description in the Google Cloud Platform Console. For example, the display name can be a qualified method name or a file name and a line number where the operation is called. A best practice is to use the same display name within an application and at the same call point. This makes it easier to correlate spans in different traces."
},
"endTime": {
"description": "Required. The end time of the span. On the client side, this is the time kept by\nthe local machine where the span execution ends. On the server side, this\nis the time when the server application handler stops running.",
"format": "google-datetime",
"description": "Required. The end time of the span. On the client side, this is the time kept by the local machine where the span execution ends. On the server side, this is the time when the server application handler stops running.",
"format": "google-datetime",
"type": "string"
},
},
"links": {
"$ref": "Links",
"$ref": "Links",
"description": "Links associated with the span. You can have up to 128 links per Span."
},
},
"name": {
"description": "The resource name of the span in the following format:\n\n projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/SPAN_ID is a unique identifier for a trace within a project;\nit is a 32-character hexadecimal encoding of a 16-byte array.\n\n[SPAN_ID] is a unique identifier for a span within a trace; it\nis a 16-character hexadecimal encoding of an 8-byte array.",
"description": "Required. The resource name of the span in the following format: projects/[PROJECT_ID]/traces/[TRACE_ID]/spans/SPAN_ID is a unique identifier for a trace within a project; it is a 32-character hexadecimal encoding of a 16-byte array. [SPAN_ID] is a unique identifier for a span within a trace; it is a 16-character hexadecimal encoding of an 8-byte array. It should not be zero.",
"type": "string"
},
},
"parentSpanId": {
"description": "The [SPAN_ID] of this span's parent span. If this is a root span,\nthen this field must be empty.",
"description": "The [SPAN_ID] of this span's parent span. If this is a root span, then this field must be empty.",
"type": "string"
},
},
"sameProcessAsParentSpan": {
"description": "Optional. Set this parameter to indicate whether this span is in\nthe same process as its parent. If you do not set this parameter,\nStackdriver Trace is unable to take advantage of this helpful\ninformation.",
"description": "Optional. Set this parameter to indicate whether this span is in the same process as its parent. If you do not set this parameter, Trace is unable to take advantage of this helpful information.",
"type": "boolean"
},
},
"spanId": {
"description": "Required. The [SPAN_ID] portion of the span's resource name.",
"description": "Required. The [SPAN_ID] portion of the span's resource name.",
"type": "string"
},
},
"spanKind": {
"description": "Distinguishes between spans generated in a particular context. For example,\ntwo spans with the same name may be distinguished using `CLIENT` (caller)\nand `SERVER` (callee) to identify an RPC call.",
"description": "Optional. Distinguishes between spans generated in a particular context. For example, two spans with the same name may be distinguished using `CLIENT` (caller) and `SERVER` (callee) to identify an RPC call.",
"enum": [
"SPAN_KIND_UNSPECIFIED",
"INTERNAL",
"SERVER",
"CLIENT",
"PRODUCER",
"SPAN_KIND_UNSPECIFIED",
"INTERNAL",
"SERVER",
"CLIENT",
"PRODUCER",
"CONSUMER"
],
],
"enumDescriptions": [
"Unspecified. Do NOT use as default.\nImplementations MAY assume SpanKind.INTERNAL to be default.",
"Indicates that the span is used internally. Default value.",
"Indicates that the span covers server-side handling of an RPC or other\nremote network request.",
"Indicates that the span covers the client-side wrapper around an RPC or\nother remote request.",
"Indicates that the span describes producer sending a message to a broker.\nUnlike client and server, there is no direct critical path latency\nrelationship between producer and consumer spans (e.g. publishing a\nmessage to a pubsub service).",
"Indicates that the span describes consumer recieving a message from a\nbroker. Unlike client and server, there is no direct critical path\nlatency relationship between producer and consumer spans (e.g. receiving\na message from a pubsub service subscription)."
],
"Unspecified. Do NOT use as default. Implementations MAY assume SpanKind.INTERNAL to be default.",
"Indicates that the span is used internally. Default value.",
"Indicates that the span covers server-side handling of an RPC or other remote network request.",
"Indicates that the span covers the client-side wrapper around an RPC or other remote request.",
"Indicates that the span describes producer sending a message to a broker. Unlike client and server, there is no direct critical path latency relationship between producer and consumer spans (e.g. publishing a message to a pubsub service).",
"Indicates that the span describes consumer receiving a message from a broker. Unlike client and server, there is no direct critical path latency relationship between producer and consumer spans (e.g. receiving a message from a pubsub service subscription)."
],
"type": "string"
},
},
"stackTrace": {
"$ref": "StackTrace",
"$ref": "StackTrace",
"description": "Stack trace captured at the start of the span."
},
},
"startTime": {
"description": "Required. The start time of the span. On the client side, this is the time kept by\nthe local machine where the span execution starts. On the server side, this\nis the time when the server's application handler starts running.",
"format": "google-datetime",
"description": "Required. The start time of the span. On the client side, this is the time kept by the local machine where the span execution starts. On the server side, this is the time when the server's application handler starts running.",
"format": "google-datetime",
"type": "string"
},
},
"status": {
"$ref": "Status",
"$ref": "Status",
"description": "Optional. The final status for this span."
},
},
"timeEvents": {
"$ref": "TimeEvents",
"description": "A set of time events. You can have up to 32 annotations and 128 message\nevents per span."
"$ref": "TimeEvents",
"description": "A set of time events. You can have up to 32 annotations and 128 message events per span."
}
},
},
"type": "object"
},
},
"StackFrame": {
"description": "Represents a single stack frame in a stack trace.",
"id": "StackFrame",
"description": "Represents a single stack frame in a stack trace.",
"id": "StackFrame",
"properties": {
"columnNumber": {
"description": "The column number where the function call appears, if available.\nThis is important in JavaScript because of its anonymous functions.",
"format": "int64",
"description": "The column number where the function call appears, if available. This is important in JavaScript because of its anonymous functions.",
"format": "int64",
"type": "string"
},
},
"fileName": {
"$ref": "TruncatableString",
"description": "The name of the source file where the function call appears (up to 256\nbytes)."
},
"$ref": "TruncatableString",
"description": "The name of the source file where the function call appears (up to 256 bytes)."
},
"functionName": {
"$ref": "TruncatableString",
"description": "The fully-qualified name that uniquely identifies the function or\nmethod that is active in this frame (up to 1024 bytes)."
},
"$ref": "TruncatableString",
"description": "The fully-qualified name that uniquely identifies the function or method that is active in this frame (up to 1024 bytes)."
},
"lineNumber": {
"description": "The line number in `file_name` where the function call appears.",
"format": "int64",
"description": "The line number in `file_name` where the function call appears.",
"format": "int64",
"type": "string"
},
},
"loadModule": {
"$ref": "Module",
"$ref": "Module",
"description": "The binary module from where the code was loaded."
},
},
"originalFunctionName": {
"$ref": "TruncatableString",
"description": "An un-mangled function name, if `function_name` is\n[mangled](http://www.avabodh.com/cxxin/namemangling.html). The name can\nbe fully-qualified (up to 1024 bytes)."
},
"$ref": "TruncatableString",
"description": "An un-mangled function name, if `function_name` is [mangled](http://www.avabodh.com/cxxin/namemangling.html). The name can be fully-qualified (up to 1024 bytes)."
},
"sourceVersion": {
"$ref": "TruncatableString",
"$ref": "TruncatableString",
"description": "The version of the deployed source code (up to 128 bytes)."
}
},
},
"type": "object"
},
},
"StackFrames": {
"description": "A collection of stack frames, which can be truncated.",
"id": "StackFrames",
"description": "A collection of stack frames, which can be truncated.",
"id": "StackFrames",
"properties": {
"droppedFramesCount": {
"description": "The number of stack frames that were dropped because there\nwere too many stack frames.\nIf this value is 0, then no stack frames were dropped.",
"format": "int32",
"description": "The number of stack frames that were dropped because there were too many stack frames. If this value is 0, then no stack frames were dropped.",
"format": "int32",
"type": "integer"
},
},
"frame": {
"description": "Stack frames in this call stack.",
"description": "Stack frames in this call stack.",
"items": {
"$ref": "StackFrame"
},
},
"type": "array"
}
},
},
"type": "object"
},
},
"StackTrace": {
"description": "A call stack appearing in a trace.",
"id": "StackTrace",
"description": "A call stack appearing in a trace.",
"id": "StackTrace",
"properties": {
"stackFrames": {
"$ref": "StackFrames",
"$ref": "StackFrames",
"description": "Stack frames in this stack trace. A maximum of 128 frames are allowed."
},
},
"stackTraceHashId": {
"description": "The hash ID is used to conserve network bandwidth for duplicate\nstack traces within a single trace.\n\nOften multiple spans will have identical stack traces.\nThe first occurrence of a stack trace should contain both the\n`stackFrame` content and a value in `stackTraceHashId`.\n\nSubsequent spans within the same request can refer\nto that stack trace by only setting `stackTraceHashId`.",
"format": "int64",
"description": "The hash ID is used to conserve network bandwidth for duplicate stack traces within a single trace. Often multiple spans will have identical stack traces. The first occurrence of a stack trace should contain both the `stackFrame` content and a value in `stackTraceHashId`. Subsequent spans within the same request can refer to that stack trace by only setting `stackTraceHashId`.",
"format": "int64",
"type": "string"
}
},
},
"type": "object"
},
},
"Status": {
"description": "The `Status` type defines a logical error model that is suitable for\ndifferent programming environments, including REST APIs and RPC APIs. It is\nused by [gRPC](https://github.com/grpc). Each `Status` message contains\nthree pieces of data: error code, error message, and error details.\n\nYou can find out more about this error model and how to work with it in the\n[API Design Guide](https://cloud.google.com/apis/design/errors).",
"id": "Status",
"description": "The `Status` type defines a logical error model that is suitable for 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).",
"id": "Status",
"properties": {
"code": {
"description": "The status code, which should be an enum value of google.rpc.Code.",
"format": "int32",
"description": "The status code, which should be an enum value of google.rpc.Code.",
"format": "int32",
"type": "integer"
},
},
"details": {
"description": "A list of messages that carry the error details. There is a common set of\nmessage types for APIs to use.",
"description": "A list of messages that carry the error details. There is a common set of message types for APIs to use.",
"items": {
"additionalProperties": {
"description": "Properties of the object. Contains field @type with type URL.",
"description": "Properties of the object. Contains field @type with type URL.",
"type": "any"
},
},
"type": "object"
},
},
"type": "array"
},
},
"message": {
"description": "A developer-facing error message, which should be in English. Any\nuser-facing error message should be localized and sent in the\ngoogle.rpc.Status.details field, or localized by the client.",
"description": "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.",
"type": "string"
}
},
},
"type": "object"
},
},
"TimeEvent": {
"description": "A time-stamped annotation or message event in the Span.",
"id": "TimeEvent",
"description": "A time-stamped annotation or message event in the Span.",
"id": "TimeEvent",
"properties": {
"annotation": {
"$ref": "Annotation",
"$ref": "Annotation",
"description": "Text annotation with a set of attributes."
},
},
"messageEvent": {
"$ref": "MessageEvent",
"$ref": "MessageEvent",
"description": "An event describing a message sent/received between Spans."
},
},
"time": {
"description": "The timestamp indicating the time the event occurred.",
"format": "google-datetime",
"description": "The timestamp indicating the time the event occurred.",
"format": "google-datetime",
"type": "string"
}
},
},
"type": "object"
},
},
"TimeEvents": {
"description": "A collection of `TimeEvent`s. A `TimeEvent` is a time-stamped annotation\non the span, consisting of either user-supplied key:value pairs, or\ndetails of a message sent/received between Spans.",
"id": "TimeEvents",
"description": "A collection of `TimeEvent`s. A `TimeEvent` is a time-stamped annotation on the span, consisting of either user-supplied key:value pairs, or details of a message sent/received between Spans.",
"id": "TimeEvents",
"properties": {
"droppedAnnotationsCount": {
"description": "The number of dropped annotations in all the included time events.\nIf the value is 0, then no annotations were dropped.",
"format": "int32",
"description": "The number of dropped annotations in all the included time events. If the value is 0, then no annotations were dropped.",
"format": "int32",
"type": "integer"
},
},
"droppedMessageEventsCount": {
"description": "The number of dropped message events in all the included time events.\nIf the value is 0, then no message events were dropped.",
"format": "int32",
"description": "The number of dropped message events in all the included time events. If the value is 0, then no message events were dropped.",
"format": "int32",
"type": "integer"
},
},
"timeEvent": {
"description": "A collection of `TimeEvent`s.",
"description": "A collection of `TimeEvent`s.",
"items": {
"$ref": "TimeEvent"
},
},
"type": "array"
}
},
},
"type": "object"
},
},
"TruncatableString": {
"description": "Represents a string that might be shortened to a specified length.",
"id": "TruncatableString",
"description": "Represents a string that might be shortened to a specified length.",
"id": "TruncatableString",
"properties": {
"truncatedByteCount": {
"description": "The number of bytes removed from the original string. If this\nvalue is 0, then the string was not shortened.",
"format": "int32",
"description": "The number of bytes removed from the original string. If this value is 0, then the string was not shortened.",
"format": "int32",
"type": "integer"
},
},
"value": {
"description": "The shortened string. For example, if the original string is 500\nbytes long and the limit of the string is 128 bytes, then\n`value` contains the first 128 bytes of the 500-byte string.\n\nTruncation always happens on a UTF8 character boundary. If there\nare multi-byte characters in the string, then the length of the\nshortened string might be less than the size limit.",
"description": "The shortened string. For example, if the original string is 500 bytes long and the limit of the string is 128 bytes, then `value` contains the first 128 bytes of the 500-byte string. Truncation always happens on a UTF8 character boundary. If there are multi-byte characters in the string, then the length of the shortened string might be less than the size limit.",
"type": "string"
}
},
},
"type": "object"
}
},
"servicePath": "",
"title": "Cloud Trace API",
"version": "v2",
},
"servicePath": "",
"title": "Cloud Trace API",
"version": "v2",
"version_module": true
}

View File

@@ -4,267 +4,267 @@
"scopes": {
"https://www.googleapis.com/auth/cloud-platform": {
"description": "View and manage your data across Google Cloud Platform services"
},
},
"https://www.googleapis.com/auth/trace.append": {
"description": "Write Trace data for a project or application"
},
},
"https://www.googleapis.com/auth/trace.readonly": {
"description": "Read Trace data for a project or application"
}
}
}
},
"basePath": "",
"baseUrl": "https://cloudtrace.googleapis.com/",
"batchPath": "batch",
"canonicalName": "Cloud Trace",
"description": "Sends application trace data to Cloud Trace for viewing. Trace data is collected for all App Engine applications by default. Trace data from other applications can be provided using this API. This library is used to interact with the Cloud Trace API directly. If you are looking to instrument your application for Cloud Trace, we recommend using OpenCensus.\n",
"discoveryVersion": "v1",
"documentationLink": "https://cloud.google.com/trace",
"fullyEncodeReservedExpansion": true,
},
"basePath": "",
"baseUrl": "https://cloudtrace.googleapis.com/",
"batchPath": "batch",
"canonicalName": "Cloud Trace",
"description": "Sends application trace data to Cloud Trace for viewing. Trace data is collected for all App Engine applications by default. Trace data from other applications can be provided using this API. This library is used to interact with the Cloud Trace API directly. If you are looking to instrument your application for Cloud Trace, we recommend using OpenCensus. ",
"discoveryVersion": "v1",
"documentationLink": "https://cloud.google.com/trace",
"fullyEncodeReservedExpansion": true,
"icons": {
"x16": "http://www.google.com/images/icons/product/search-16.gif",
"x16": "http://www.google.com/images/icons/product/search-16.gif",
"x32": "http://www.google.com/images/icons/product/search-32.gif"
},
"id": "cloudtrace:v2beta1",
"kind": "discovery#restDescription",
"mtlsRootUrl": "https://cloudtrace.mtls.googleapis.com/",
"name": "cloudtrace",
"ownerDomain": "google.com",
"ownerName": "Google",
},
"id": "cloudtrace:v2beta1",
"kind": "discovery#restDescription",
"mtlsRootUrl": "https://cloudtrace.mtls.googleapis.com/",
"name": "cloudtrace",
"ownerDomain": "google.com",
"ownerName": "Google",
"parameters": {
"$.xgafv": {
"description": "V1 error format.",
"description": "V1 error format.",
"enum": [
"1",
"1",
"2"
],
],
"enumDescriptions": [
"v1 error format",
"v1 error format",
"v2 error format"
],
"location": "query",
],
"location": "query",
"type": "string"
},
},
"access_token": {
"description": "OAuth access token.",
"location": "query",
"description": "OAuth access token.",
"location": "query",
"type": "string"
},
},
"alt": {
"default": "json",
"description": "Data format for response.",
"default": "json",
"description": "Data format for response.",
"enum": [
"json",
"media",
"json",
"media",
"proto"
],
],
"enumDescriptions": [
"Responses with Content-Type of application/json",
"Media download with context-dependent Content-Type",
"Responses with Content-Type of application/json",
"Media download with context-dependent Content-Type",
"Responses with Content-Type of application/x-protobuf"
],
"location": "query",
],
"location": "query",
"type": "string"
},
},
"callback": {
"description": "JSONP",
"location": "query",
"description": "JSONP",
"location": "query",
"type": "string"
},
},
"fields": {
"description": "Selector specifying which fields to include in a partial response.",
"location": "query",
"description": "Selector specifying which fields to include in a partial response.",
"location": "query",
"type": "string"
},
},
"key": {
"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
"location": "query",
"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
"location": "query",
"type": "string"
},
},
"oauth_token": {
"description": "OAuth 2.0 token for the current user.",
"location": "query",
"description": "OAuth 2.0 token for the current user.",
"location": "query",
"type": "string"
},
},
"prettyPrint": {
"default": "true",
"description": "Returns response with indentations and line breaks.",
"location": "query",
"default": "true",
"description": "Returns response with indentations and line breaks.",
"location": "query",
"type": "boolean"
},
},
"quotaUser": {
"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
"location": "query",
"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
"location": "query",
"type": "string"
},
},
"uploadType": {
"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
"location": "query",
"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
"location": "query",
"type": "string"
},
},
"upload_protocol": {
"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
"location": "query",
"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
"location": "query",
"type": "string"
}
},
"protocol": "rest",
},
"protocol": "rest",
"resources": {
"projects": {
"resources": {
"traceSinks": {
"methods": {
"create": {
"description": "Creates a sink that exports trace spans to a destination. The\nexport of newly-ingested traces begins immediately, unless the sink's\n`writer_identity` is not permitted to write to the destination. A sink can\nexport traces only from the resource owning the sink (the 'parent').",
"flatPath": "v2beta1/projects/{projectsId}/traceSinks",
"httpMethod": "POST",
"id": "cloudtrace.projects.traceSinks.create",
"description": "Creates a sink that exports trace spans to a destination. The export of newly-ingested traces begins immediately, unless the sink's `writer_identity` is not permitted to write to the destination. A sink can export traces only from the resource owning the sink (the 'parent').",
"flatPath": "v2beta1/projects/{projectsId}/traceSinks",
"httpMethod": "POST",
"id": "cloudtrace.projects.traceSinks.create",
"parameterOrder": [
"parent"
],
],
"parameters": {
"parent": {
"description": "Required. The resource in which to create the sink (currently only project\nsinks are supported):\n\n \"projects/[PROJECT_ID]\"\n\nExamples: `\"projects/my-trace-project\"`, `\"projects/123456789\"`.",
"location": "path",
"pattern": "^projects/[^/]+$",
"required": true,
"description": "Required. The resource in which to create the sink (currently only project sinks are supported): \"projects/[PROJECT_ID]\" Examples: `\"projects/my-trace-project\"`, `\"projects/123456789\"`.",
"location": "path",
"pattern": "^projects/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v2beta1/{+parent}/traceSinks",
},
"path": "v2beta1/{+parent}/traceSinks",
"request": {
"$ref": "TraceSink"
},
},
"response": {
"$ref": "TraceSink"
},
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/trace.append"
]
},
},
"delete": {
"description": "Deletes a sink.",
"flatPath": "v2beta1/projects/{projectsId}/traceSinks/{traceSinksId}",
"httpMethod": "DELETE",
"id": "cloudtrace.projects.traceSinks.delete",
"description": "Deletes a sink.",
"flatPath": "v2beta1/projects/{projectsId}/traceSinks/{traceSinksId}",
"httpMethod": "DELETE",
"id": "cloudtrace.projects.traceSinks.delete",
"parameterOrder": [
"name"
],
],
"parameters": {
"name": {
"description": "Required. The full resource name of the sink to delete, including the\nparent resource and the sink identifier:\n\n \"projects/[PROJECT_NUMBER]/traceSinks/[SINK_ID]\"\n\nExample: `\"projects/12345/traceSinks/my-sink-id\"`.",
"location": "path",
"pattern": "^projects/[^/]+/traceSinks/[^/]+$",
"required": true,
"description": "Required. The full resource name of the sink to delete, including the parent resource and the sink identifier: \"projects/[PROJECT_NUMBER]/traceSinks/[SINK_ID]\" Example: `\"projects/12345/traceSinks/my-sink-id\"`.",
"location": "path",
"pattern": "^projects/[^/]+/traceSinks/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v2beta1/{+name}",
},
"path": "v2beta1/{+name}",
"response": {
"$ref": "Empty"
},
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/trace.append"
]
},
},
"get": {
"description": "Get a trace sink by name under the parent resource (GCP project).",
"flatPath": "v2beta1/projects/{projectsId}/traceSinks/{traceSinksId}",
"httpMethod": "GET",
"id": "cloudtrace.projects.traceSinks.get",
"description": "Get a trace sink by name under the parent resource (GCP project).",
"flatPath": "v2beta1/projects/{projectsId}/traceSinks/{traceSinksId}",
"httpMethod": "GET",
"id": "cloudtrace.projects.traceSinks.get",
"parameterOrder": [
"name"
],
],
"parameters": {
"name": {
"description": "Required. The resource name of the sink:\n\n \"projects/[PROJECT_NUMBER]/traceSinks/[SINK_ID]\"\n\nExample: `\"projects/12345/traceSinks/my-sink-id\"`.",
"location": "path",
"pattern": "^projects/[^/]+/traceSinks/[^/]+$",
"required": true,
"description": "Required. The resource name of the sink: \"projects/[PROJECT_NUMBER]/traceSinks/[SINK_ID]\" Example: `\"projects/12345/traceSinks/my-sink-id\"`.",
"location": "path",
"pattern": "^projects/[^/]+/traceSinks/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v2beta1/{+name}",
},
"path": "v2beta1/{+name}",
"response": {
"$ref": "TraceSink"
},
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/trace.readonly"
]
},
},
"list": {
"description": "List all sinks for the parent resource (GCP project).",
"flatPath": "v2beta1/projects/{projectsId}/traceSinks",
"httpMethod": "GET",
"id": "cloudtrace.projects.traceSinks.list",
"description": "List all sinks for the parent resource (GCP project).",
"flatPath": "v2beta1/projects/{projectsId}/traceSinks",
"httpMethod": "GET",
"id": "cloudtrace.projects.traceSinks.list",
"parameterOrder": [
"parent"
],
],
"parameters": {
"pageSize": {
"description": "Optional. The maximum number of results to return from this request.\nNon-positive values are ignored. The presence of `nextPageToken` in the\nresponse indicates that more results might be available.",
"format": "int32",
"location": "query",
"description": "Optional. The maximum number of results to return from this request. Non-positive values are ignored. The presence of `nextPageToken` in the response indicates that more results might be available.",
"format": "int32",
"location": "query",
"type": "integer"
},
},
"pageToken": {
"description": "Optional. If present, then retrieve the next batch of results from the\npreceding call to this method. `pageToken` must be the value of\n`nextPageToken` from the previous response. The values of other method\nparameters should be identical to those in the previous call.",
"location": "query",
"description": "Optional. If present, then retrieve the next batch of results from the preceding call to this method. `pageToken` must be the value of `nextPageToken` from the previous response. The values of other method parameters should be identical to those in the previous call.",
"location": "query",
"type": "string"
},
},
"parent": {
"description": "Required. The parent resource whose sinks are to be listed (currently only\nproject parent resources are supported):\n\n \"projects/[PROJECT_ID]\"",
"location": "path",
"pattern": "^projects/[^/]+$",
"required": true,
"description": "Required. The parent resource whose sinks are to be listed (currently only project parent resources are supported): \"projects/[PROJECT_ID]\"",
"location": "path",
"pattern": "^projects/[^/]+$",
"required": true,
"type": "string"
}
},
"path": "v2beta1/{+parent}/traceSinks",
},
"path": "v2beta1/{+parent}/traceSinks",
"response": {
"$ref": "ListTraceSinksResponse"
},
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/trace.readonly"
]
},
},
"patch": {
"description": "Updates a sink. This method updates fields in the existing sink according\nto the provided update mask. The sink's name cannot be changed nor any\noutput-only fields (e.g. the writer_identity).",
"flatPath": "v2beta1/projects/{projectsId}/traceSinks/{traceSinksId}",
"httpMethod": "PATCH",
"id": "cloudtrace.projects.traceSinks.patch",
"description": "Updates a sink. This method updates fields in the existing sink according to the provided update mask. The sink's name cannot be changed nor any output-only fields (e.g. the writer_identity).",
"flatPath": "v2beta1/projects/{projectsId}/traceSinks/{traceSinksId}",
"httpMethod": "PATCH",
"id": "cloudtrace.projects.traceSinks.patch",
"parameterOrder": [
"name"
],
],
"parameters": {
"name": {
"description": "Required. The full resource name of the sink to update, including the\nparent resource and the sink identifier:\n\n \"projects/[PROJECT_NUMBER]/traceSinks/[SINK_ID]\"\n\nExample: `\"projects/12345/traceSinks/my-sink-id\"`.",
"location": "path",
"pattern": "^projects/[^/]+/traceSinks/[^/]+$",
"required": true,
"description": "Required. The full resource name of the sink to update, including the parent resource and the sink identifier: \"projects/[PROJECT_NUMBER]/traceSinks/[SINK_ID]\" Example: `\"projects/12345/traceSinks/my-sink-id\"`.",
"location": "path",
"pattern": "^projects/[^/]+/traceSinks/[^/]+$",
"required": true,
"type": "string"
},
},
"updateMask": {
"description": "Required. Field mask that specifies the fields in `trace_sink` that are to\nbe updated. A sink field is overwritten if, and only if, it is\nin the update mask. `name` and `writer_identity` fields cannot be updated.\n\nAn empty updateMask is considered an error.\n\nFor a detailed `FieldMask` definition, see\nhttps://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask\n\nExample: `updateMask=output_config`.",
"format": "google-fieldmask",
"location": "query",
"description": "Required. Field mask that specifies the fields in `trace_sink` that are to be updated. A sink field is overwritten if, and only if, it is in the update mask. `name` and `writer_identity` fields cannot be updated. An empty updateMask is considered an error. For a detailed `FieldMask` definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask Example: `updateMask=output_config`.",
"format": "google-fieldmask",
"location": "query",
"type": "string"
}
},
"path": "v2beta1/{+name}",
},
"path": "v2beta1/{+name}",
"request": {
"$ref": "TraceSink"
},
},
"response": {
"$ref": "TraceSink"
},
},
"scopes": [
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/cloud-platform",
"https://www.googleapis.com/auth/trace.append"
]
}
@@ -272,67 +272,68 @@
}
}
}
},
"revision": "20200622",
"rootUrl": "https://cloudtrace.googleapis.com/",
},
"revision": "20210319",
"rootUrl": "https://cloudtrace.googleapis.com/",
"schemas": {
"Empty": {
"description": "A generic empty message that you can re-use to avoid defining duplicated\nempty messages in your APIs. A typical example is to use it as the request\nor the response type of an API method. For instance:\n\n service Foo {\n rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);\n }\n\nThe JSON representation for `Empty` is empty JSON object `{}`.",
"id": "Empty",
"properties": {},
"description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.",
"id": "Empty",
"properties": {},
"type": "object"
},
},
"ListTraceSinksResponse": {
"description": "Result returned from `ListTraceSinks`.",
"id": "ListTraceSinksResponse",
"description": "Result returned from `ListTraceSinks`.",
"id": "ListTraceSinksResponse",
"properties": {
"nextPageToken": {
"description": "If there might be more results than appear in this response, then\n`nextPageToken` is included. To get the next set of results, call the same\nmethod again using the value of `nextPageToken` as `pageToken`.",
"description": "If there might be more results than appear in this response, then `nextPageToken` is included. To get the next set of results, call the same method again using the value of `nextPageToken` as `pageToken`.",
"type": "string"
},
},
"sinks": {
"description": "A list of sinks.",
"description": "A list of sinks.",
"items": {
"$ref": "TraceSink"
},
},
"type": "array"
}
},
},
"type": "object"
},
},
"OutputConfig": {
"description": "OutputConfig contains a destination for writing trace data.",
"id": "OutputConfig",
"description": "OutputConfig contains a destination for writing trace data.",
"id": "OutputConfig",
"properties": {
"destination": {
"description": "The destination for writing trace data. Currently only BigQuery is\nsupported. E.g.:\n\n \"bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]\"",
"description": "The destination for writing trace data. Currently only BigQuery is supported. E.g.: \"bigquery.googleapis.com/projects/[PROJECT_ID]/datasets/[DATASET]\"",
"type": "string"
}
},
},
"type": "object"
},
},
"TraceSink": {
"description": "Describes a sink used to export traces to a BigQuery dataset. The sink must\nbe created within a project.",
"id": "TraceSink",
"description": "Describes a sink used to export traces to a BigQuery dataset. The sink must be created within a project.",
"id": "TraceSink",
"properties": {
"name": {
"description": "Required. The canonical sink resource name, unique within the project. Must be of the\nform:\n\n project/[PROJECT_NUMBER]/traceSinks/[SINK_ID].\n\nE.g.:\n\n `\"projects/12345/traceSinks/my-project-trace-sink\"`.\n\nSink identifiers are limited to 256 characters and can include only the\nfollowing characters: upper and lower-case alphanumeric characters,\nunderscores, hyphens, and periods.",
"description": "Required. The canonical sink resource name, unique within the project. Must be of the form: project/[PROJECT_NUMBER]/traceSinks/[SINK_ID]. E.g.: `\"projects/12345/traceSinks/my-project-trace-sink\"`. Sink identifiers are limited to 256 characters and can include only the following characters: upper and lower-case alphanumeric characters, underscores, hyphens, and periods.",
"type": "string"
},
},
"outputConfig": {
"$ref": "OutputConfig",
"$ref": "OutputConfig",
"description": "Required. The export destination."
},
},
"writerIdentity": {
"description": "Output only. A service account name for exporting the data. This field is\nset by sinks.create and sinks.update. The service account will need to be\ngranted write access to the destination specified in the output\nconfiguration, see [Granting access for a\nresource](/iam/docs/granting-roles-to-service-accounts#granting_access_to_a_service_account_for_a_resource).\nTo create tables and write data this account will need the dataEditor role.\nRead more about roles in the [BigQuery\ndocumentation](https://cloud.google.com/bigquery/docs/access-control).\nE.g.:\n\n \"service-00000001@00000002.iam.gserviceaccount.com\"",
"description": "Output only. A service account name for exporting the data. This field is set by sinks.create and sinks.update. The service account will need to be granted write access to the destination specified in the output configuration, see [Granting access for a resource](/iam/docs/granting-roles-to-service-accounts#granting_access_to_a_service_account_for_a_resource). To create tables and write data this account will need the dataEditor role. Read more about roles in the [BigQuery documentation](https://cloud.google.com/bigquery/docs/access-control). E.g.: \"service-00000001@00000002.iam.gserviceaccount.com\"",
"readOnly": true,
"type": "string"
}
},
},
"type": "object"
}
},
"servicePath": "",
"title": "Cloud Trace API",
"version": "v2beta1",
},
"servicePath": "",
"title": "Cloud Trace API",
"version": "v2beta1",
"version_module": true
}