Skip to content

Commit 737d909

Browse files
yoshi-automationyoshi-automation
committed
feat(logging)!: update the API
BREAKING CHANGE: This release has breaking changes. #### logging:v2 The following keys were deleted: - schemas.AuditConfig.description - schemas.AuditConfig.id - schemas.AuditConfig.properties.auditLogConfigs.description - schemas.AuditConfig.properties.auditLogConfigs.items.$ref - schemas.AuditConfig.properties.auditLogConfigs.type - schemas.AuditConfig.properties.service.description - schemas.AuditConfig.properties.service.type - schemas.AuditConfig.type - schemas.AuditLogConfig.description - schemas.AuditLogConfig.id - schemas.AuditLogConfig.properties.exemptedMembers.description - schemas.AuditLogConfig.properties.exemptedMembers.items.type - schemas.AuditLogConfig.properties.exemptedMembers.type - schemas.AuditLogConfig.properties.logType.description - schemas.AuditLogConfig.properties.logType.enum - schemas.AuditLogConfig.properties.logType.enumDescriptions - schemas.AuditLogConfig.properties.logType.type - schemas.AuditLogConfig.type - schemas.Policy.properties.auditConfigs.description - schemas.Policy.properties.auditConfigs.items.$ref - schemas.Policy.properties.auditConfigs.type The following keys were added: - schemas.AppHub.description - schemas.AppHub.id - schemas.AppHub.properties.application.$ref - schemas.AppHub.properties.application.description - schemas.AppHub.properties.service.$ref - schemas.AppHub.properties.service.description - schemas.AppHub.properties.workload.$ref - schemas.AppHub.properties.workload.description - schemas.AppHub.type - schemas.AppHubApplication.description - schemas.AppHubApplication.id - schemas.AppHubApplication.properties.container.description - schemas.AppHubApplication.properties.container.type - schemas.AppHubApplication.properties.id.description - schemas.AppHubApplication.properties.id.type - schemas.AppHubApplication.properties.location.description - schemas.AppHubApplication.properties.location.type - schemas.AppHubApplication.type - schemas.AppHubService.description - schemas.AppHubService.id - schemas.AppHubService.properties.criticalityType.description - schemas.AppHubService.properties.criticalityType.type - schemas.AppHubService.properties.environmentType.description - schemas.AppHubService.properties.environmentType.type - schemas.AppHubService.properties.id.description - schemas.AppHubService.properties.id.type - schemas.AppHubService.type - schemas.AppHubWorkload.description - schemas.AppHubWorkload.id - schemas.AppHubWorkload.properties.criticalityType.description - schemas.AppHubWorkload.properties.criticalityType.type - schemas.AppHubWorkload.properties.environmentType.description - schemas.AppHubWorkload.properties.environmentType.type - schemas.AppHubWorkload.properties.id.description - schemas.AppHubWorkload.properties.id.type - schemas.AppHubWorkload.type - schemas.LogEntry.properties.apphub.$ref - schemas.LogEntry.properties.apphub.description - schemas.LogEntry.properties.apphub.readOnly The following keys were changed: - resources.billingAccounts.resources.locations.resources.buckets.resources.views.methods.create.parameters.viewId.description - resources.folders.resources.locations.resources.buckets.resources.views.methods.create.parameters.viewId.description - resources.locations.resources.buckets.resources.views.methods.create.parameters.viewId.description - resources.organizations.resources.locations.resources.buckets.resources.views.methods.create.parameters.viewId.description - resources.projects.resources.locations.resources.buckets.resources.views.methods.create.parameters.viewId.description
1 parent 91cfefe commit 737d909

File tree

2 files changed

+135
-67
lines changed

2 files changed

+135
-67
lines changed

‎discovery/logging-v2.json‎

Lines changed: 72 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -910,7 +910,7 @@
910910
"type": "string"
911911
},
912912
"viewId": {
913-
"description": "Required. A client-assigned identifier such as \"my-view\". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods.",
913+
"description": "Required. A client-assigned identifier such as \"my-view\". Identifiers are limited to 100 characters and can include only letters, digits, underscores, and hyphens.",
914914
"location": "query",
915915
"type": "string"
916916
}
@@ -2736,7 +2736,7 @@
27362736
"type": "string"
27372737
},
27382738
"viewId": {
2739-
"description": "Required. A client-assigned identifier such as \"my-view\". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods.",
2739+
"description": "Required. A client-assigned identifier such as \"my-view\". Identifiers are limited to 100 characters and can include only letters, digits, underscores, and hyphens.",
27402740
"location": "query",
27412741
"type": "string"
27422742
}
@@ -4317,7 +4317,7 @@
43174317
"type": "string"
43184318
},
43194319
"viewId": {
4320-
"description": "Required. A client-assigned identifier such as \"my-view\". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods.",
4320+
"description": "Required. A client-assigned identifier such as \"my-view\". Identifiers are limited to 100 characters and can include only letters, digits, underscores, and hyphens.",
43214321
"location": "query",
43224322
"type": "string"
43234323
}
@@ -5554,7 +5554,7 @@
55545554
"type": "string"
55555555
},
55565556
"viewId": {
5557-
"description": "Required. A client-assigned identifier such as \"my-view\". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods.",
5557+
"description": "Required. A client-assigned identifier such as \"my-view\". Identifiers are limited to 100 characters and can include only letters, digits, underscores, and hyphens.",
55585558
"location": "query",
55595559
"type": "string"
55605560
}
@@ -7356,7 +7356,7 @@
73567356
"type": "string"
73577357
},
73587358
"viewId": {
7359-
"description": "Required. A client-assigned identifier such as \"my-view\". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods.",
7359+
"description": "Required. A client-assigned identifier such as \"my-view\". Identifiers are limited to 100 characters and can include only letters, digits, underscores, and hyphens.",
73607360
"location": "query",
73617361
"type": "string"
73627362
}
@@ -8922,52 +8922,80 @@
89228922
}
89238923
}
89248924
},
8925-
"revision": "20250110",
8925+
"revision": "20250307",
89268926
"rootUrl": "https://logging.googleapis.com/",
89278927
"schemas": {
8928-
"AuditConfig": {
8929-
"description": "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:[email protected]\" ] }, { \"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:[email protected]\" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts [email protected] from DATA_READ logging, and [email protected] from DATA_WRITE logging.",
8930-
"id": "AuditConfig",
8928+
"AppHub": {
8929+
"description": "Metadata associated with App Hub.",
8930+
"id": "AppHub",
89318931
"properties": {
8932-
"auditLogConfigs": {
8933-
"description": "The configuration for logging of each type of permission.",
8934-
"items": {
8935-
"$ref": "AuditLogConfig"
8936-
},
8937-
"type": "array"
8932+
"application": {
8933+
"$ref": "AppHubApplication",
8934+
"description": "Metadata associated with the application."
89388935
},
89398936
"service": {
8940-
"description": "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.",
8937+
"$ref": "AppHubService",
8938+
"description": "Metadata associated with the service."
8939+
},
8940+
"workload": {
8941+
"$ref": "AppHubWorkload",
8942+
"description": "Metadata associated with the workload."
8943+
}
8944+
},
8945+
"type": "object"
8946+
},
8947+
"AppHubApplication": {
8948+
"description": "Resource identifiers associated with an AppHub application AppHub resources are of the form projects//locations//applications/ projects//locations//applications//services/ projects//locations//applications//workloads/ These resources can be reconstructed from the components below.",
8949+
"id": "AppHubApplication",
8950+
"properties": {
8951+
"container": {
8952+
"description": "Resource container that owns the application. Example: \"projects/management_project\"",
8953+
"type": "string"
8954+
},
8955+
"id": {
8956+
"description": "Application Id. Example: \"my-app\"",
8957+
"type": "string"
8958+
},
8959+
"location": {
8960+
"description": "Location associated with the Application. Example: \"us-east1\"",
89418961
"type": "string"
89428962
}
89438963
},
89448964
"type": "object"
89458965
},
8946-
"AuditLogConfig": {
8947-
"description": "Provides the configuration for logging a type of permissions. Example: { \"audit_log_configs\": [ { \"log_type\": \"DATA_READ\", \"exempted_members\": [ \"user:[email protected]\" ] }, { \"log_type\": \"DATA_WRITE\" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting [email protected] from DATA_READ logging.",
8948-
"id": "AuditLogConfig",
8966+
"AppHubService": {
8967+
"description": "Metadata associated with an App Hub service.",
8968+
"id": "AppHubService",
89498969
"properties": {
8950-
"exemptedMembers": {
8951-
"description": "Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members.",
8952-
"items": {
8953-
"type": "string"
8954-
},
8955-
"type": "array"
8970+
"criticalityType": {
8971+
"description": "Service criticality type Example: \"CRITICAL\"",
8972+
"type": "string"
89568973
},
8957-
"logType": {
8958-
"description": "The log type that this config enables.",
8959-
"enum": [
8960-
"LOG_TYPE_UNSPECIFIED",
8961-
"ADMIN_READ",
8962-
"DATA_WRITE",
8963-
"DATA_READ"
8964-
],
8965-
"enumDescriptions": [
8966-
"Default case. Should never be this.",
8967-
"Admin reads. Example: CloudIAM getIamPolicy",
8968-
"Data writes. Example: CloudSQL Users create",
8969-
"Data reads. Example: CloudSQL Users list"
8970-
],
8974+
"environmentType": {
8975+
"description": "Service environment type Example: \"DEV\"",
8976+
"type": "string"
8977+
},
8978+
"id": {
8979+
"description": "Service Id. Example: \"my-service\"",
8980+
"type": "string"
8981+
}
8982+
},
8983+
"type": "object"
8984+
},
8985+
"AppHubWorkload": {
8986+
"description": "Metadata associated with an App Hub workload.",
8987+
"id": "AppHubWorkload",
8988+
"properties": {
8989+
"criticalityType": {
8990+
"description": "Workload criticality type Example: \"CRITICAL\"",
8991+
"type": "string"
8992+
},
8993+
"environmentType": {
8994+
"description": "Workload environment type Example: \"DEV\"",
8995+
"type": "string"
8996+
},
8997+
"id": {
8998+
"description": "Workload Id. Example: \"my-workload\"",
89718999
"type": "string"
89729000
}
89739001
},
@@ -10082,6 +10110,11 @@
1008210110
"description": "An individual entry in a log.",
1008310111
"id": "LogEntry",
1008410112
"properties": {
10113+
"apphub": {
10114+
"$ref": "AppHub",
10115+
"description": "Output only. AppHub application metadata associated with this LogEntry. May be empty if there is no associated AppHub application or multiple associated applications (such as for VPC flow logs)",
10116+
"readOnly": true
10117+
},
1008510118
"errorGroups": {
1008610119
"description": "Output only. The Error Reporting (https://cloud.google.com/error-reporting) error groups associated with this LogEntry. Error Reporting sets the values for this field during error group creation.For more information, see View error details( https://cloud.google.com/error-reporting/docs/viewing-errors#view_error_details)This field isn't available during log routing (https://cloud.google.com/logging/docs/routing/overview)",
1008710120
"items": {
@@ -10927,13 +10960,6 @@
1092710960
"description": "An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources.A Policy is a collection of bindings. A binding binds one or more members, or principals, to a single role. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A role is a named list of permissions; each role can be an IAM predefined role or a user-created custom role.For some types of Google Cloud resources, a binding can also specify a condition, which is a logical expression that allows access to a resource only if the expression evaluates to true. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the IAM documentation (https://cloud.google.com/iam/help/conditions/resource-policies).JSON example: { \"bindings\": [ { \"role\": \"roles/resourcemanager.organizationAdmin\", \"members\": [ \"user:[email protected]\", \"group:[email protected]\", \"domain:google.com\", \"serviceAccount:[email protected]\" ] }, { \"role\": \"roles/resourcemanager.organizationViewer\", \"members\": [ \"user:[email protected]\" ], \"condition\": { \"title\": \"expirable access\", \"description\": \"Does not grant access after Sep 2020\", \"expression\": \"request.time < timestamp('2020-10-01T00:00:00.000Z')\", } } ], \"etag\": \"BwWWja0YfJA=\", \"version\": 3 } YAML example: bindings: - members: - user:[email protected] - group:[email protected] - domain:google.com - serviceAccount:[email protected] role: roles/resourcemanager.organizationAdmin - members: - user:[email protected] role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 For a description of IAM and its features, see the IAM documentation (https://cloud.google.com/iam/docs/).",
1092810961
"id": "Policy",
1092910962
"properties": {
10930-
"auditConfigs": {
10931-
"description": "Specifies cloud audit logging configuration for this policy.",
10932-
"items": {
10933-
"$ref": "AuditConfig"
10934-
},
10935-
"type": "array"
10936-
},
1093710963
"bindings": {
1093810964
"description": "Associates a list of members, or principals, with 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 principal.The bindings in a Policy can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the bindings grant 50 different roles to user:[email protected], and not to any other principal, then you can add another 1,450 principals to the bindings in the Policy.",
1093910965
"items": {

0 commit comments

Comments
 (0)