Class: Google::Apis::SecretmanagerV1beta1::SecretManagerService

Inherits:
Core::BaseService show all
Defined in:
generated/google/apis/secretmanager_v1beta1/service.rb

Overview

Secret Manager API

Stores and manages access to application secrets. Provides convenience while improving security.

Examples:

require 'google/apis/secretmanager_v1beta1'

Secretmanager = Google::Apis::SecretmanagerV1beta1 # Alias the module
service = Secretmanager::SecretManagerService.new

See Also:

Instance Attribute Summary collapse

Attributes inherited from Core::BaseService

#authorization, #base_path, #batch_path, #client, #client_options, #request_options, #root_url, #upload_path

Instance Method Summary collapse

Methods inherited from Core::BaseService

#batch, #batch_upload, #fetch_all, #http

Methods included from Core::Logging

#logger

Constructor Details

#initializeSecretManagerService


46
47
48
49
# File 'generated/google/apis/secretmanager_v1beta1/service.rb', line 46

def initialize
  super('https://secretmanager.googleapis.com/', '')
  @batch_path = 'batch'
end

Instance Attribute Details

#keyString


39
40
41
# File 'generated/google/apis/secretmanager_v1beta1/service.rb', line 39

def key
  @key
end

#quota_userString


44
45
46
# File 'generated/google/apis/secretmanager_v1beta1/service.rb', line 44

def quota_user
  @quota_user
end

Instance Method Details

#access_project_secret_version(name, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::SecretmanagerV1beta1::AccessSecretVersionResponse

Accesses a SecretVersion. This call returns the secret data. projects/*/secrets/*/versions/latest is an alias to the latest SecretVersion.

Yields:

  • (result, err)

    Result & error if block supplied

Yield Parameters:

Raises:


470
471
472
473
474
475
476
477
478
# File 'generated/google/apis/secretmanager_v1beta1/service.rb', line 470

def access_project_secret_version(name, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:get, 'v1beta1/{+name}:access', options)
  command.response_representation = Google::Apis::SecretmanagerV1beta1::AccessSecretVersionResponse::Representation
  command.response_class = Google::Apis::SecretmanagerV1beta1::AccessSecretVersionResponse
  command.params['name'] = name unless name.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#add_project_secret_version(parent, add_secret_version_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::SecretmanagerV1beta1::SecretVersion

Creates a new SecretVersion containing secret data and attaches it to an existing Secret.

Yields:

  • (result, err)

    Result & error if block supplied

Yield Parameters:

Raises:


143
144
145
146
147
148
149
150
151
152
153
# File 'generated/google/apis/secretmanager_v1beta1/service.rb', line 143

def add_project_secret_version(parent, add_secret_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:post, 'v1beta1/{+parent}:addVersion', options)
  command.request_representation = Google::Apis::SecretmanagerV1beta1::AddSecretVersionRequest::Representation
  command.request_object = add_secret_version_request_object
  command.response_representation = Google::Apis::SecretmanagerV1beta1::SecretVersion::Representation
  command.response_class = Google::Apis::SecretmanagerV1beta1::SecretVersion
  command.params['parent'] = parent unless parent.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#create_project_secret(parent, secret_object = nil, secret_id: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::SecretmanagerV1beta1::Secret

Creates a new Secret containing no SecretVersions.

Yields:

  • (result, err)

    Result & error if block supplied

Yield Parameters:

Raises:


179
180
181
182
183
184
185
186
187
188
189
190
# File 'generated/google/apis/secretmanager_v1beta1/service.rb', line 179

def create_project_secret(parent, secret_object = nil, secret_id: nil, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:post, 'v1beta1/{+parent}/secrets', options)
  command.request_representation = Google::Apis::SecretmanagerV1beta1::Secret::Representation
  command.request_object = secret_object
  command.response_representation = Google::Apis::SecretmanagerV1beta1::Secret::Representation
  command.response_class = Google::Apis::SecretmanagerV1beta1::Secret
  command.params['parent'] = parent unless parent.nil?
  command.query['secretId'] = secret_id unless secret_id.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#delete_project_secret(name, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::SecretmanagerV1beta1::Empty

Deletes a Secret.

Yields:

  • (result, err)

    Result & error if block supplied

Yield Parameters:

Raises:


213
214
215
216
217
218
219
220
221
# File 'generated/google/apis/secretmanager_v1beta1/service.rb', line 213

def delete_project_secret(name, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:delete, 'v1beta1/{+name}', options)
  command.response_representation = Google::Apis::SecretmanagerV1beta1::Empty::Representation
  command.response_class = Google::Apis::SecretmanagerV1beta1::Empty
  command.params['name'] = name unless name.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#destroy_secret_version(name, destroy_secret_version_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::SecretmanagerV1beta1::SecretVersion

Destroys a SecretVersion. Sets the state of the SecretVersion to DESTROYED and irrevocably destroys the secret data.

Yields:

  • (result, err)

    Result & error if block supplied

Yield Parameters:

Raises:


505
506
507
508
509
510
511
512
513
514
515
# File 'generated/google/apis/secretmanager_v1beta1/service.rb', line 505

def destroy_secret_version(name, destroy_secret_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:post, 'v1beta1/{+name}:destroy', options)
  command.request_representation = Google::Apis::SecretmanagerV1beta1::DestroySecretVersionRequest::Representation
  command.request_object = destroy_secret_version_request_object
  command.response_representation = Google::Apis::SecretmanagerV1beta1::SecretVersion::Representation
  command.response_class = Google::Apis::SecretmanagerV1beta1::SecretVersion
  command.params['name'] = name unless name.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#disable_secret_version(name, disable_secret_version_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::SecretmanagerV1beta1::SecretVersion

Disables a SecretVersion. Sets the state of the SecretVersion to DISABLED.

Yields:

  • (result, err)

    Result & error if block supplied

Yield Parameters:

Raises:


541
542
543
544
545
546
547
548
549
550
551
# File 'generated/google/apis/secretmanager_v1beta1/service.rb', line 541

def disable_secret_version(name, disable_secret_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:post, 'v1beta1/{+name}:disable', options)
  command.request_representation = Google::Apis::SecretmanagerV1beta1::DisableSecretVersionRequest::Representation
  command.request_object = disable_secret_version_request_object
  command.response_representation = Google::Apis::SecretmanagerV1beta1::SecretVersion::Representation
  command.response_class = Google::Apis::SecretmanagerV1beta1::SecretVersion
  command.params['name'] = name unless name.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#enable_secret_version(name, enable_secret_version_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::SecretmanagerV1beta1::SecretVersion

Enables a SecretVersion. Sets the state of the SecretVersion to ENABLED.

Yields:

  • (result, err)

    Result & error if block supplied

Yield Parameters:

Raises:


577
578
579
580
581
582
583
584
585
586
587
# File 'generated/google/apis/secretmanager_v1beta1/service.rb', line 577

def enable_secret_version(name, enable_secret_version_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:post, 'v1beta1/{+name}:enable', options)
  command.request_representation = Google::Apis::SecretmanagerV1beta1::EnableSecretVersionRequest::Representation
  command.request_object = enable_secret_version_request_object
  command.response_representation = Google::Apis::SecretmanagerV1beta1::SecretVersion::Representation
  command.response_class = Google::Apis::SecretmanagerV1beta1::SecretVersion
  command.params['name'] = name unless name.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#get_project_location(name, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::SecretmanagerV1beta1::Location

Gets information about a location.

Yields:

  • (result, err)

    Result & error if block supplied

Yield Parameters:

Raises:


71
72
73
74
75
76
77
78
79
# File 'generated/google/apis/secretmanager_v1beta1/service.rb', line 71

def get_project_location(name, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:get, 'v1beta1/{+name}', options)
  command.response_representation = Google::Apis::SecretmanagerV1beta1::Location::Representation
  command.response_class = Google::Apis::SecretmanagerV1beta1::Location
  command.params['name'] = name unless name.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#get_project_secret(name, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::SecretmanagerV1beta1::Secret

Gets metadata for a given Secret.

Yields:

  • (result, err)

    Result & error if block supplied

Yield Parameters:

Raises:


244
245
246
247
248
249
250
251
252
# File 'generated/google/apis/secretmanager_v1beta1/service.rb', line 244

def get_project_secret(name, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:get, 'v1beta1/{+name}', options)
  command.response_representation = Google::Apis::SecretmanagerV1beta1::Secret::Representation
  command.response_class = Google::Apis::SecretmanagerV1beta1::Secret
  command.params['name'] = name unless name.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#get_project_secret_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::SecretmanagerV1beta1::Policy

Gets the access control policy for a secret. Returns empty policy if the secret exists and does not have a policy set.

Yields:

  • (result, err)

    Result & error if block supplied

Yield Parameters:

Raises:


283
284
285
286
287
288
289
290
291
292
# File 'generated/google/apis/secretmanager_v1beta1/service.rb', line 283

def get_project_secret_iam_policy(resource, options_requested_policy_version: nil, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:get, 'v1beta1/{+resource}:getIamPolicy', options)
  command.response_representation = Google::Apis::SecretmanagerV1beta1::Policy::Representation
  command.response_class = Google::Apis::SecretmanagerV1beta1::Policy
  command.params['resource'] = resource unless resource.nil?
  command.query['options.requestedPolicyVersion'] = options_requested_policy_version unless options_requested_policy_version.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#get_project_secret_version(name, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::SecretmanagerV1beta1::SecretVersion

Gets metadata for a SecretVersion. projects/*/secrets/*/versions/latest is an alias to the latest SecretVersion.

Yields:

  • (result, err)

    Result & error if block supplied

Yield Parameters:

Raises:


614
615
616
617
618
619
620
621
622
# File 'generated/google/apis/secretmanager_v1beta1/service.rb', line 614

def get_project_secret_version(name, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:get, 'v1beta1/{+name}', options)
  command.response_representation = Google::Apis::SecretmanagerV1beta1::SecretVersion::Representation
  command.response_class = Google::Apis::SecretmanagerV1beta1::SecretVersion
  command.params['name'] = name unless name.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#list_project_locations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::SecretmanagerV1beta1::ListLocationsResponse

Lists information about the supported locations for this service.

Yields:

  • (result, err)

    Result & error if block supplied

Yield Parameters:

Raises:


107
108
109
110
111
112
113
114
115
116
117
118
# File 'generated/google/apis/secretmanager_v1beta1/service.rb', line 107

def list_project_locations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:get, 'v1beta1/{+name}/locations', options)
  command.response_representation = Google::Apis::SecretmanagerV1beta1::ListLocationsResponse::Representation
  command.response_class = Google::Apis::SecretmanagerV1beta1::ListLocationsResponse
  command.params['name'] = name unless name.nil?
  command.query['filter'] = filter unless filter.nil?
  command.query['pageSize'] = page_size unless page_size.nil?
  command.query['pageToken'] = page_token unless page_token.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#list_project_secret_versions(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::SecretmanagerV1beta1::ListSecretVersionsResponse

Lists SecretVersions. This call does not return secret data.

Yields:

  • (result, err)

    Result & error if block supplied

Yield Parameters:

Raises:


654
655
656
657
658
659
660
661
662
663
664
# File 'generated/google/apis/secretmanager_v1beta1/service.rb', line 654

def list_project_secret_versions(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:get, 'v1beta1/{+parent}/versions', options)
  command.response_representation = Google::Apis::SecretmanagerV1beta1::ListSecretVersionsResponse::Representation
  command.response_class = Google::Apis::SecretmanagerV1beta1::ListSecretVersionsResponse
  command.params['parent'] = parent unless parent.nil?
  command.query['pageSize'] = page_size unless page_size.nil?
  command.query['pageToken'] = page_token unless page_token.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#list_project_secrets(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::SecretmanagerV1beta1::ListSecretsResponse

Lists Secrets.

Yields:

  • (result, err)

    Result & error if block supplied

Yield Parameters:

Raises:


322
323
324
325
326
327
328
329
330
331
332
# File 'generated/google/apis/secretmanager_v1beta1/service.rb', line 322

def list_project_secrets(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:get, 'v1beta1/{+parent}/secrets', options)
  command.response_representation = Google::Apis::SecretmanagerV1beta1::ListSecretsResponse::Representation
  command.response_class = Google::Apis::SecretmanagerV1beta1::ListSecretsResponse
  command.params['parent'] = parent unless parent.nil?
  command.query['pageSize'] = page_size unless page_size.nil?
  command.query['pageToken'] = page_token unless page_token.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#patch_project_secret(name, secret_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::SecretmanagerV1beta1::Secret

Updates metadata of an existing Secret.

Yields:

  • (result, err)

    Result & error if block supplied

Yield Parameters:

Raises:


358
359
360
361
362
363
364
365
366
367
368
369
# File 'generated/google/apis/secretmanager_v1beta1/service.rb', line 358

def patch_project_secret(name, secret_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:patch, 'v1beta1/{+name}', options)
  command.request_representation = Google::Apis::SecretmanagerV1beta1::Secret::Representation
  command.request_object = secret_object
  command.response_representation = Google::Apis::SecretmanagerV1beta1::Secret::Representation
  command.response_class = Google::Apis::SecretmanagerV1beta1::Secret
  command.params['name'] = name unless name.nil?
  command.query['updateMask'] = update_mask unless update_mask.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#set_secret_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::SecretmanagerV1beta1::Policy

Sets the access control policy on the specified secret. Replaces any existing policy. Permissions on SecretVersions are enforced according to the policy set on the associated Secret.

Yields:

  • (result, err)

    Result & error if block supplied

Yield Parameters:

Raises:


396
397
398
399
400
401
402
403
404
405
406
# File 'generated/google/apis/secretmanager_v1beta1/service.rb', line 396

def set_secret_iam_policy(resource, set_iam_policy_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:post, 'v1beta1/{+resource}:setIamPolicy', options)
  command.request_representation = Google::Apis::SecretmanagerV1beta1::SetIamPolicyRequest::Representation
  command.request_object = set_iam_policy_request_object
  command.response_representation = Google::Apis::SecretmanagerV1beta1::Policy::Representation
  command.response_class = Google::Apis::SecretmanagerV1beta1::Policy
  command.params['resource'] = resource unless resource.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end

#test_secret_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::SecretmanagerV1beta1::TestIamPermissionsResponse

Returns permissions that a caller has for the specified secret. If the secret does not exist, this call returns an empty set of permissions, not a NOT_FOUND error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may "fail open" without warning.

Yields:

  • (result, err)

    Result & error if block supplied

Yield Parameters:

Raises:


435
436
437
438
439
440
441
442
443
444
445
# File 'generated/google/apis/secretmanager_v1beta1/service.rb', line 435

def test_secret_iam_permissions(resource, test_iam_permissions_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
  command = make_simple_command(:post, 'v1beta1/{+resource}:testIamPermissions', options)
  command.request_representation = Google::Apis::SecretmanagerV1beta1::TestIamPermissionsRequest::Representation
  command.request_object = test_iam_permissions_request_object
  command.response_representation = Google::Apis::SecretmanagerV1beta1::TestIamPermissionsResponse::Representation
  command.response_class = Google::Apis::SecretmanagerV1beta1::TestIamPermissionsResponse
  command.params['resource'] = resource unless resource.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end