Skip to content

Commit 82325f1

Browse files
feat(servicenetworking): update the API
#### servicenetworking:v1beta The following keys were added: - schemas.Aspect.description - schemas.Aspect.id - schemas.Aspect.properties.kind.description - schemas.Aspect.properties.kind.type - schemas.Aspect.properties.spec.additionalProperties.description - schemas.Aspect.properties.spec.additionalProperties.type - schemas.Aspect.properties.spec.description - schemas.Aspect.properties.spec.type - schemas.Aspect.type - schemas.BackendRule.properties.loadBalancingPolicy.description - schemas.BackendRule.properties.loadBalancingPolicy.type - schemas.ExperimentalFeatures.properties.unversionedPackageDisabled.description - schemas.ExperimentalFeatures.properties.unversionedPackageDisabled.type - schemas.SelectiveGapicGeneration.properties.generateOmittedAsInternal.description - schemas.SelectiveGapicGeneration.properties.generateOmittedAsInternal.type - schemas.Service.properties.aspects.description - schemas.Service.properties.aspects.items.$ref - schemas.Service.properties.aspects.type The following keys were changed: - schemas.Documentation.properties.sectionOverrides.description - schemas.DocumentationRule.properties.disableReplacementWords.description - schemas.JavaSettings.properties.libraryPackage.description - schemas.Page.properties.content.description - schemas.UsageRule.description - schemas.UsageRule.properties.allowUnregisteredCalls.description #### servicenetworking:v1 The following keys were added: - schemas.Aspect.description - schemas.Aspect.id - schemas.Aspect.properties.kind.description - schemas.Aspect.properties.kind.type - schemas.Aspect.properties.spec.additionalProperties.description - schemas.Aspect.properties.spec.additionalProperties.type - schemas.Aspect.properties.spec.description - schemas.Aspect.properties.spec.type - schemas.Aspect.type - schemas.BackendRule.properties.loadBalancingPolicy.description - schemas.BackendRule.properties.loadBalancingPolicy.type - schemas.ExperimentalFeatures.properties.unversionedPackageDisabled.description - schemas.ExperimentalFeatures.properties.unversionedPackageDisabled.type - schemas.SelectiveGapicGeneration.properties.generateOmittedAsInternal.description - schemas.SelectiveGapicGeneration.properties.generateOmittedAsInternal.type - schemas.Service.properties.aspects.description - schemas.Service.properties.aspects.items.$ref - schemas.Service.properties.aspects.type The following keys were changed: - schemas.Documentation.properties.sectionOverrides.description - schemas.DocumentationRule.properties.disableReplacementWords.description - schemas.JavaSettings.properties.libraryPackage.description - schemas.Page.properties.content.description - schemas.UsageRule.description - schemas.UsageRule.properties.allowUnregisteredCalls.description - schemas.ValidateConsumerConfigResponse.properties.validationError.enum - schemas.ValidateConsumerConfigResponse.properties.validationError.enumDescriptions
1 parent 48814ae commit 82325f1

File tree

4 files changed

+164
-28
lines changed

4 files changed

+164
-28
lines changed

discovery/servicenetworking-v1.json

Lines changed: 49 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1029,7 +1029,7 @@
10291029
}
10301030
}
10311031
},
1032-
"revision": "20250107",
1032+
"revision": "20250312",
10331033
"rootUrl": "https://servicenetworking.googleapis.com/",
10341034
"schemas": {
10351035
"AddDnsRecordSetMetadata": {
@@ -1287,6 +1287,25 @@
12871287
},
12881288
"type": "object"
12891289
},
1290+
"Aspect": {
1291+
"description": "Aspect represents Generic aspect. It is used to configure an aspect without making direct changes to service.proto",
1292+
"id": "Aspect",
1293+
"properties": {
1294+
"kind": {
1295+
"description": "The type of this aspect configuration.",
1296+
"type": "string"
1297+
},
1298+
"spec": {
1299+
"additionalProperties": {
1300+
"description": "Properties of the object.",
1301+
"type": "any"
1302+
},
1303+
"description": "Content of the configuration. The underlying schema should be defined by Aspect owners as protobuf message under `apiserving/configaspects/proto`.",
1304+
"type": "object"
1305+
}
1306+
},
1307+
"type": "object"
1308+
},
12901309
"AuthProvider": {
12911310
"description": "Configuration for an authentication provider, including support for [JSON Web Token (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).",
12921311
"id": "AuthProvider",
@@ -1418,6 +1437,10 @@
14181437
"description": "The JWT audience is used when generating a JWT ID token for the backend. This ID token will be added in the HTTP \"authorization\" header, and sent to the backend.",
14191438
"type": "string"
14201439
},
1440+
"loadBalancingPolicy": {
1441+
"description": "The load balancing policy used for connection to the application backend. Defined as an arbitrary string to accomondate custom load balancing policies supported by the underlying channel, but suggest most users use one of the standard policies, such as the default, \"RoundRobin\".",
1442+
"type": "string"
1443+
},
14211444
"minDeadline": {
14221445
"deprecated": true,
14231446
"description": "Deprecated, do not use.",
@@ -1995,7 +2018,7 @@
19952018
"type": "array"
19962019
},
19972020
"sectionOverrides": {
1998-
"description": "Specifies section and content to override boilerplate content provided by go/api-docgen. Currently overrides following sections: 1. rest.service.client_libraries",
2021+
"description": "Specifies section and content to override the boilerplate content. Currently overrides following sections: 1. rest.service.client_libraries",
19992022
"items": {
20002023
"$ref": "Page"
20012024
},
@@ -2025,7 +2048,7 @@
20252048
"type": "string"
20262049
},
20272050
"disableReplacementWords": {
2028-
"description": "String of comma or space separated case-sensitive words for which method/field name replacement will be disabled by go/api-docgen.",
2051+
"description": "String of comma or space separated case-sensitive words for which method/field name replacement will be disabled.",
20292052
"type": "string"
20302053
},
20312054
"selector": {
@@ -2205,6 +2228,10 @@
22052228
"restAsyncIoEnabled": {
22062229
"description": "Enables generation of asynchronous REST clients if `rest` transport is enabled. By default, asynchronous REST clients will not be generated. This feature will be enabled by default 1 month after launching the feature in preview packages.",
22072230
"type": "boolean"
2231+
},
2232+
"unversionedPackageDisabled": {
2233+
"description": "Disables generation of an unversioned Python package for this client library. This means that the module names will need to be versioned in import statements. For example `import google.cloud.library_v2` instead of `import google.cloud.library`.",
2234+
"type": "boolean"
22082235
}
22092236
},
22102237
"type": "object"
@@ -2513,7 +2540,7 @@
25132540
"description": "Some settings."
25142541
},
25152542
"libraryPackage": {
2516-
"description": "The package name to use in Java. Clobbers the java_package option set in the protobuf. This should be used **only** by APIs who have already set the language_settings.java.package_name\" field in gapic.yaml. API teams should use the protobuf java_package option where possible. Example of a YAML configuration:: publishing: java_settings: library_package: com.google.cloud.pubsub.v1",
2543+
"description": "The package name to use in Java. Clobbers the java_package option set in the protobuf. This should be used **only** by APIs who have already set the language_settings.java.package_name\" field in gapic.yaml. API teams should use the protobuf java_package option where possible. Example of a YAML configuration:: publishing: library_settings: java_settings: library_package: com.google.cloud.pubsub.v1",
25172544
"type": "string"
25182545
},
25192546
"serviceClassNames": {
@@ -3208,7 +3235,7 @@
32083235
"id": "Page",
32093236
"properties": {
32103237
"content": {
3211-
"description": "The Markdown content of the page. You can use (== include {path} ==) to include content from a Markdown file. The content can be used to produce the documentation page such as HTML format page.",
3238+
"description": "The Markdown content of the page. You can use ```(== include {path} ==)``` to include content from a Markdown file. The content can be used to produce the documentation page such as HTML format page.",
32123239
"type": "string"
32133240
},
32143241
"name": {
@@ -3646,6 +3673,10 @@
36463673
"description": "This message is used to configure the generation of a subset of the RPCs in a service for client libraries.",
36473674
"id": "SelectiveGapicGeneration",
36483675
"properties": {
3676+
"generateOmittedAsInternal": {
3677+
"description": "Setting this to true indicates to the client generators that methods that would be excluded from the generation should instead be generated in a way that indicates these methods should not be consumed by end users. How this is expressed is up to individual language implementations to decide. Some examples may be: added annotations, obfuscated identifiers, or other language idiomatic patterns.",
3678+
"type": "boolean"
3679+
},
36493680
"methods": {
36503681
"description": "An allowlist of the fully qualified names of RPCs that should be included on public client surfaces.",
36513682
"items": {
@@ -3667,6 +3698,13 @@
36673698
},
36683699
"type": "array"
36693700
},
3701+
"aspects": {
3702+
"description": "Configuration aspects. This is a repeated field to allow multiple aspects to be configured. The kind field in each ConfigAspect specifies the type of aspect. The spec field contains the configuration for that aspect. The schema for the spec field is defined by the backend service owners.",
3703+
"items": {
3704+
"$ref": "Aspect"
3705+
},
3706+
"type": "array"
3707+
},
36703708
"authentication": {
36713709
"$ref": "Authentication",
36723710
"description": "Auth configuration."
@@ -4061,11 +4099,11 @@
40614099
"type": "object"
40624100
},
40634101
"UsageRule": {
4064-
"description": "Usage configuration rules for the service. NOTE: Under development. Use this rule to configure unregistered calls for the service. Unregistered calls are calls that do not contain consumer project identity. (Example: calls that do not contain an API key). By default, API methods do not allow unregistered calls, and each method call must be identified by a consumer project identity. Use this rule to allow/disallow unregistered calls. Example of an API that wants to allow unregistered calls for entire service. usage: rules: - selector: \"*\" allow_unregistered_calls: true Example of a method that wants to allow unregistered calls. usage: rules: - selector: \"google.example.library.v1.LibraryService.CreateBook\" allow_unregistered_calls: true",
4102+
"description": "Usage configuration rules for the service.",
40654103
"id": "UsageRule",
40664104
"properties": {
40674105
"allowUnregisteredCalls": {
4068-
"description": "If true, the selected method allows unregistered calls, e.g. calls that don't identify any user or application.",
4106+
"description": " Use this rule to configure unregistered calls for the service. Unregistered calls are calls that do not contain consumer project identity. (Example: calls that do not contain an API key). WARNING: By default, API methods do not allow unregistered calls, and each method call must be identified by a consumer project identity.",
40694107
"type": "boolean"
40704108
},
40714109
"selector": {
@@ -4136,7 +4174,8 @@
41364174
"RANGES_NOT_RESERVED",
41374175
"RANGES_DELETED_LATER",
41384176
"COMPUTE_API_NOT_ENABLED",
4139-
"USE_PERMISSION_NOT_FOUND"
4177+
"USE_PERMISSION_NOT_FOUND",
4178+
"SN_SERVICE_AGENT_PERMISSION_DENIED_ON_CONSUMER_PROJECT"
41404179
],
41414180
"enumDescriptions": [
41424181
"",
@@ -4153,7 +4192,8 @@
41534192
"The IP ranges were not reserved.",
41544193
"The IP ranges were reserved but deleted later.",
41554194
"The consumer project does not have the compute api enabled.",
4156-
"The consumer project does not have the permission from the host project."
4195+
"The consumer project does not have the permission from the host project.",
4196+
"The SN service agent {[email protected]} does not have the SN service agent role on the consumer project."
41574197
],
41584198
"type": "string"
41594199
}

discovery/servicenetworking-v1beta.json

Lines changed: 45 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -307,7 +307,7 @@
307307
}
308308
}
309309
},
310-
"revision": "20241212",
310+
"revision": "20250312",
311311
"rootUrl": "https://servicenetworking.googleapis.com/",
312312
"schemas": {
313313
"AddDnsRecordSetMetadata": {
@@ -454,6 +454,25 @@
454454
},
455455
"type": "object"
456456
},
457+
"Aspect": {
458+
"description": "Aspect represents Generic aspect. It is used to configure an aspect without making direct changes to service.proto",
459+
"id": "Aspect",
460+
"properties": {
461+
"kind": {
462+
"description": "The type of this aspect configuration.",
463+
"type": "string"
464+
},
465+
"spec": {
466+
"additionalProperties": {
467+
"description": "Properties of the object.",
468+
"type": "any"
469+
},
470+
"description": "Content of the configuration. The underlying schema should be defined by Aspect owners as protobuf message under `apiserving/configaspects/proto`.",
471+
"type": "object"
472+
}
473+
},
474+
"type": "object"
475+
},
457476
"AuthProvider": {
458477
"description": "Configuration for an authentication provider, including support for [JSON Web Token (JWT)](https://tools.ietf.org/html/draft-ietf-oauth-json-web-token-32).",
459478
"id": "AuthProvider",
@@ -585,6 +604,10 @@
585604
"description": "The JWT audience is used when generating a JWT ID token for the backend. This ID token will be added in the HTTP \"authorization\" header, and sent to the backend.",
586605
"type": "string"
587606
},
607+
"loadBalancingPolicy": {
608+
"description": "The load balancing policy used for connection to the application backend. Defined as an arbitrary string to accomondate custom load balancing policies supported by the underlying channel, but suggest most users use one of the standard policies, such as the default, \"RoundRobin\".",
609+
"type": "string"
610+
},
588611
"minDeadline": {
589612
"deprecated": true,
590613
"description": "Deprecated, do not use.",
@@ -1107,7 +1130,7 @@
11071130
"type": "array"
11081131
},
11091132
"sectionOverrides": {
1110-
"description": "Specifies section and content to override boilerplate content provided by go/api-docgen. Currently overrides following sections: 1. rest.service.client_libraries",
1133+
"description": "Specifies section and content to override the boilerplate content. Currently overrides following sections: 1. rest.service.client_libraries",
11111134
"items": {
11121135
"$ref": "Page"
11131136
},
@@ -1137,7 +1160,7 @@
11371160
"type": "string"
11381161
},
11391162
"disableReplacementWords": {
1140-
"description": "String of comma or space separated case-sensitive words for which method/field name replacement will be disabled by go/api-docgen.",
1163+
"description": "String of comma or space separated case-sensitive words for which method/field name replacement will be disabled.",
11411164
"type": "string"
11421165
},
11431166
"selector": {
@@ -1300,6 +1323,10 @@
13001323
"restAsyncIoEnabled": {
13011324
"description": "Enables generation of asynchronous REST clients if `rest` transport is enabled. By default, asynchronous REST clients will not be generated. This feature will be enabled by default 1 month after launching the feature in preview packages.",
13021325
"type": "boolean"
1326+
},
1327+
"unversionedPackageDisabled": {
1328+
"description": "Disables generation of an unversioned Python package for this client library. This means that the module names will need to be versioned in import statements. For example `import google.cloud.library_v2` instead of `import google.cloud.library`.",
1329+
"type": "boolean"
13031330
}
13041331
},
13051332
"type": "object"
@@ -1593,7 +1620,7 @@
15931620
"description": "Some settings."
15941621
},
15951622
"libraryPackage": {
1596-
"description": "The package name to use in Java. Clobbers the java_package option set in the protobuf. This should be used **only** by APIs who have already set the language_settings.java.package_name\" field in gapic.yaml. API teams should use the protobuf java_package option where possible. Example of a YAML configuration:: publishing: java_settings: library_package: com.google.cloud.pubsub.v1",
1623+
"description": "The package name to use in Java. Clobbers the java_package option set in the protobuf. This should be used **only** by APIs who have already set the language_settings.java.package_name\" field in gapic.yaml. API teams should use the protobuf java_package option where possible. Example of a YAML configuration:: publishing: library_settings: java_settings: library_package: com.google.cloud.pubsub.v1",
15971624
"type": "string"
15981625
},
15991626
"serviceClassNames": {
@@ -2228,7 +2255,7 @@
22282255
"id": "Page",
22292256
"properties": {
22302257
"content": {
2231-
"description": "The Markdown content of the page. You can use (== include {path} ==) to include content from a Markdown file. The content can be used to produce the documentation page such as HTML format page.",
2258+
"description": "The Markdown content of the page. You can use ```(== include {path} ==)``` to include content from a Markdown file. The content can be used to produce the documentation page such as HTML format page.",
22322259
"type": "string"
22332260
},
22342261
"name": {
@@ -2575,6 +2602,10 @@
25752602
"description": "This message is used to configure the generation of a subset of the RPCs in a service for client libraries.",
25762603
"id": "SelectiveGapicGeneration",
25772604
"properties": {
2605+
"generateOmittedAsInternal": {
2606+
"description": "Setting this to true indicates to the client generators that methods that would be excluded from the generation should instead be generated in a way that indicates these methods should not be consumed by end users. How this is expressed is up to individual language implementations to decide. Some examples may be: added annotations, obfuscated identifiers, or other language idiomatic patterns.",
2607+
"type": "boolean"
2608+
},
25782609
"methods": {
25792610
"description": "An allowlist of the fully qualified names of RPCs that should be included on public client surfaces.",
25802611
"items": {
@@ -2596,6 +2627,13 @@
25962627
},
25972628
"type": "array"
25982629
},
2630+
"aspects": {
2631+
"description": "Configuration aspects. This is a repeated field to allow multiple aspects to be configured. The kind field in each ConfigAspect specifies the type of aspect. The spec field contains the configuration for that aspect. The schema for the spec field is defined by the backend service owners.",
2632+
"items": {
2633+
"$ref": "Aspect"
2634+
},
2635+
"type": "array"
2636+
},
25992637
"authentication": {
26002638
"$ref": "Authentication",
26012639
"description": "Auth configuration."
@@ -2956,11 +2994,11 @@
29562994
"type": "object"
29572995
},
29582996
"UsageRule": {
2959-
"description": "Usage configuration rules for the service. NOTE: Under development. Use this rule to configure unregistered calls for the service. Unregistered calls are calls that do not contain consumer project identity. (Example: calls that do not contain an API key). By default, API methods do not allow unregistered calls, and each method call must be identified by a consumer project identity. Use this rule to allow/disallow unregistered calls. Example of an API that wants to allow unregistered calls for entire service. usage: rules: - selector: \"*\" allow_unregistered_calls: true Example of a method that wants to allow unregistered calls. usage: rules: - selector: \"google.example.library.v1.LibraryService.CreateBook\" allow_unregistered_calls: true",
2997+
"description": "Usage configuration rules for the service.",
29602998
"id": "UsageRule",
29612999
"properties": {
29623000
"allowUnregisteredCalls": {
2963-
"description": "If true, the selected method allows unregistered calls, e.g. calls that don't identify any user or application.",
3001+
"description": " Use this rule to configure unregistered calls for the service. Unregistered calls are calls that do not contain consumer project identity. (Example: calls that do not contain an API key). WARNING: By default, API methods do not allow unregistered calls, and each method call must be identified by a consumer project identity.",
29643002
"type": "boolean"
29653003
},
29663004
"selector": {

0 commit comments

Comments
 (0)