google-cloud-org_policy 1.1.0 → 1.2.1

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 16e987a25a9d64ae778a8b229cccabb9668b28e36ddb896a1adf5306fec58b03
4
- data.tar.gz: 83d4d3890faab388ca38157dd2242ca4ba9e736d956109603d574698c27faffb
3
+ metadata.gz: 23411a95f25054d5f781deba23c361536d2fd8d66a2d93746bda951d4bfe74ae
4
+ data.tar.gz: b670e13c4a4145ec1a13c04f8c1426a69b8d7f4100ad40793fb24adeaa7a3886
5
5
  SHA512:
6
- metadata.gz: eda06cbe87d2cfdab8d00d2332caa9377cd89256844b4c4b81771ca3deaa18cab247f785be2a9f080c60f129fcc8a40147e6494f22a08a7a6048166afd7ee565
7
- data.tar.gz: efffce1176a90007c58de8005a3ccbe628ba934dfce9e843c02f5338fd02d2dc1c169c708b5becc314c7b27bc1715b8756b35b46dfb448f5e69c363d82c873ac
6
+ metadata.gz: 8e2de1cb940d6e6e74cd8698d051897b65ef0257591f62dde69adb416134f3d6b114fe4391d23da8aaebcfdbe5cfee4cc66011ed811400079df09e027bf76154
7
+ data.tar.gz: bb04fc9e9ca3fa4ddad48f76decb4c32c730b8879c97df0e5827ccf0332d9ea6270ed08ce23e535fdf6c8068dc23481664bc7aeb0806a871dd0eafe086467eec
data/AUTHENTICATION.md CHANGED
@@ -114,7 +114,7 @@ credentials are discovered.
114
114
  To configure your system for this, simply:
115
115
 
116
116
  1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
117
- 2. Authenticate using OAuth 2.0 `$ gcloud auth login`
117
+ 2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
118
118
  3. Write code as if already authenticated.
119
119
 
120
120
  **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
data/README.md CHANGED
@@ -16,7 +16,7 @@ for this library, google-cloud-org_policy, to see the convenience methods for
16
16
  constructing client objects. Reference documentation for the client objects
17
17
  themselves can be found in the client library documentation for the versioned
18
18
  client gems:
19
- [google-cloud-org_policy-v2](https://googleapis.dev/ruby/google-cloud-org_policy-v2/latest).
19
+ [google-cloud-org_policy-v2](https://cloud.google.com/ruby/docs/reference/google-cloud-org_policy-v2/latest).
20
20
 
21
21
  See also the [Product Documentation](https://cloud.google.com/resource-manager/docs/organization-policy/overview)
22
22
  for more usage information.
@@ -34,32 +34,6 @@ In order to use this library, you first need to go through the following steps:
34
34
  1. [Enable the API.](https://console.cloud.google.com/apis/library/orgpolicy.googleapis.com)
35
35
  1. {file:AUTHENTICATION.md Set up authentication.}
36
36
 
37
- ## Enabling Logging
38
-
39
- To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
40
- The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
41
- or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
42
- that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
43
- and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
44
-
45
- Configuring a Ruby stdlib logger:
46
-
47
- ```ruby
48
- require "logger"
49
-
50
- module MyLogger
51
- LOGGER = Logger.new $stderr, level: Logger::WARN
52
- def logger
53
- LOGGER
54
- end
55
- end
56
-
57
- # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
58
- module GRPC
59
- extend MyLogger
60
- end
61
- ```
62
-
63
37
  ## Supported Ruby Versions
64
38
 
65
39
  This library is supported on Ruby 2.6+.
@@ -20,7 +20,7 @@
20
20
  module Google
21
21
  module Cloud
22
22
  module OrgPolicy
23
- VERSION = "1.1.0"
23
+ VERSION = "1.2.1"
24
24
  end
25
25
  end
26
26
  end
@@ -48,49 +48,53 @@ module Google
48
48
  # Create a new client object for OrgPolicy.
49
49
  #
50
50
  # By default, this returns an instance of
51
- # [Google::Cloud::OrgPolicy::V2::OrgPolicy::Client](https://googleapis.dev/ruby/google-cloud-org_policy-v2/latest/Google/Cloud/OrgPolicy/V2/OrgPolicy/Client.html)
52
- # for version V2 of the API.
53
- # However, you can specify specify a different API version by passing it in the
51
+ # [Google::Cloud::OrgPolicy::V2::OrgPolicy::Client](https://cloud.google.com/ruby/docs/reference/google-cloud-org_policy-v2/latest/Google-Cloud-OrgPolicy-V2-OrgPolicy-Client)
52
+ # for a gRPC client for version V2 of the API.
53
+ # However, you can specify a different API version by passing it in the
54
54
  # `version` parameter. If the OrgPolicy service is
55
55
  # supported by that API version, and the corresponding gem is available, the
56
56
  # appropriate versioned client will be returned.
57
+ # You can also specify a different transport by passing `:rest` or `:grpc` in
58
+ # the `transport` parameter.
57
59
  #
58
60
  # ## About OrgPolicy
59
61
  #
60
62
  # An interface for managing organization policies.
61
63
  #
62
- # The Cloud Org Policy service provides a simple mechanism for organizations to
63
- # restrict the allowed configurations across their entire Cloud Resource
64
- # hierarchy.
64
+ # The Organization Policy Service provides a simple mechanism for
65
+ # organizations to restrict the allowed configurations across their entire
66
+ # resource hierarchy.
65
67
  #
66
- # You can use a `policy` to configure restrictions in Cloud resources. For
67
- # example, you can enforce a `policy` that restricts which Google
68
- # Cloud Platform APIs can be activated in a certain part of your resource
69
- # hierarchy, or prevents serial port access to VM instances in a particular
70
- # folder.
68
+ # You can use a policy to configure restrictions on resources. For
69
+ # example, you can enforce a policy that restricts which Google
70
+ # Cloud APIs can be activated in a certain part of your resource
71
+ # hierarchy, or prevents serial port access to VM instances in a
72
+ # particular folder.
71
73
  #
72
- # `Policies` are inherited down through the resource hierarchy. A `policy`
74
+ # Policies are inherited down through the resource hierarchy. A policy
73
75
  # applied to a parent resource automatically applies to all its child resources
74
- # unless overridden with a `policy` lower in the hierarchy.
76
+ # unless overridden with a policy lower in the hierarchy.
75
77
  #
76
- # A `constraint` defines an aspect of a resource's configuration that can be
77
- # controlled by an organization's policy administrator. `Policies` are a
78
- # collection of `constraints` that defines their allowable configuration on a
78
+ # A constraint defines an aspect of a resource's configuration that can be
79
+ # controlled by an organization's policy administrator. Policies are a
80
+ # collection of constraints that defines their allowable configuration on a
79
81
  # particular resource and its child resources.
80
82
  #
81
83
  # @param version [::String, ::Symbol] The API version to connect to. Optional.
82
84
  # Defaults to `:v2`.
83
- # @return [OrgPolicy::Client] A client object for the specified version.
85
+ # @param transport [:grpc, :rest] The transport to use. Defaults to `:grpc`.
86
+ # @return [::Object] A client object for the specified version.
84
87
  #
85
- def self.org_policy version: :v2, &block
88
+ def self.org_policy version: :v2, transport: :grpc, &block
86
89
  require "google/cloud/org_policy/#{version.to_s.downcase}"
87
90
 
88
91
  package_name = Google::Cloud::OrgPolicy
89
92
  .constants
90
93
  .select { |sym| sym.to_s.downcase == version.to_s.downcase.tr("_", "") }
91
94
  .first
92
- package_module = Google::Cloud::OrgPolicy.const_get package_name
93
- package_module.const_get(:OrgPolicy).const_get(:Client).new(&block)
95
+ service_module = Google::Cloud::OrgPolicy.const_get(package_name).const_get(:OrgPolicy)
96
+ service_module = service_module.const_get(:Rest) if transport == :rest
97
+ service_module.const_get(:Client).new(&block)
94
98
  end
95
99
 
96
100
  ##
@@ -110,7 +114,7 @@ module Google
110
114
  # * `timeout` (*type:* `Numeric`) -
111
115
  # Default timeout in seconds.
112
116
  # * `metadata` (*type:* `Hash{Symbol=>String}`) -
113
- # Additional gRPC headers to be sent with the call.
117
+ # Additional headers to be sent with the call.
114
118
  # * `retry_policy` (*type:* `Hash`) -
115
119
  # The retry policy. The value is a hash with the following keys:
116
120
  # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-org_policy
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.1.0
4
+ version: 1.2.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2022-07-06 00:00:00.000000000 Z
11
+ date: 2024-01-03 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-cloud-core
@@ -30,7 +30,7 @@ dependencies:
30
30
  requirements:
31
31
  - - ">="
32
32
  - !ruby/object:Gem::Version
33
- version: '0.2'
33
+ version: '0.5'
34
34
  - - "<"
35
35
  - !ruby/object:Gem::Version
36
36
  version: 2.a
@@ -40,7 +40,7 @@ dependencies:
40
40
  requirements:
41
41
  - - ">="
42
42
  - !ruby/object:Gem::Version
43
- version: '0.2'
43
+ version: '0.5'
44
44
  - - "<"
45
45
  - !ruby/object:Gem::Version
46
46
  version: 2.a
@@ -189,7 +189,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
189
189
  - !ruby/object:Gem::Version
190
190
  version: '0'
191
191
  requirements: []
192
- rubygems_version: 3.3.14
192
+ rubygems_version: 3.5.3
193
193
  signing_key:
194
194
  specification_version: 4
195
195
  summary: API Client library for the Organization Policy API