Class: Google::Apis::IamV1::ServiceAccount

Inherits:
Object
  • Object
show all
Includes:
Core::Hashable, Core::JsonObjectSupport
Defined in:
lib/google/apis/iam_v1/classes.rb,
lib/google/apis/iam_v1/representations.rb,
lib/google/apis/iam_v1/representations.rb

Overview

An IAM service account. A service account is an account for an application or a virtual machine (VM) instance, not a person. You can use a service account to call Google APIs. To learn more, read the overview of service accounts. When you create a service account, you specify the project ID that owns the service account, as well as a name that must be unique within the project. IAM uses these values to create an email address that identifies the service account. //

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(**args) ⇒ ServiceAccount

Returns a new instance of ServiceAccount.



2578
2579
2580
 
# File 'lib/google/apis/iam_v1/classes.rb', line 2578

def initialize(**args)
   update!(**args)
end

Instance Attribute Details

#description ⇒ String

Optional. A user-specified, human-readable description of the service account. The maximum length is 256 UTF-8 bytes. Corresponds to the JSON property description

Returns:

  • (String) 


2520
2521
2522
 
# File 'lib/google/apis/iam_v1/classes.rb', line 2520

def description
  @description
end

#disabled ⇒ Boolean Also known as: disabled?

Output only. Whether the service account is disabled. Corresponds to the JSON property disabled

Returns:

  • (Boolean) 


2525
2526
2527
 
# File 'lib/google/apis/iam_v1/classes.rb', line 2525

def disabled
  @disabled
end

#display_name ⇒ String

Optional. A user-specified, human-readable name for the service account. The maximum length is 100 UTF-8 bytes. Corresponds to the JSON property displayName

Returns:

  • (String) 


2532
2533
2534
 
# File 'lib/google/apis/iam_v1/classes.rb', line 2532

def display_name
  @display_name
end

#email ⇒ String

Output only. The email address of the service account. Corresponds to the JSON property email

Returns:

  • (String) 


2537
2538
2539
 
# File 'lib/google/apis/iam_v1/classes.rb', line 2537

def email
  @email
end

#etag ⇒ String

Deprecated. Do not use. Corresponds to the JSON property etag NOTE: Values are automatically base64 encoded/decoded in the client library.

Returns:

  • (String) 


2543
2544
2545
 
# File 'lib/google/apis/iam_v1/classes.rb', line 2543

def etag
  @etag
end

#name ⇒ String

The resource name of the service account. Use one of the following formats: * projects/PROJECT_ID/serviceAccounts/EMAIL_ADDRESS* `projects/`PROJECT_ID` /serviceAccounts/`UNIQUE_ID As an alternative, you can use the - wildcard character instead of the project ID: * projects/-/serviceAccounts/ EMAIL_ADDRESS* `projects/-/serviceAccounts/`UNIQUE_ID When possible, avoid using the - wildcard character, because it can cause response messages to contain misleading error codes. For example, if you try to access the service account projects/-/serviceAccounts/fake@example.com, which does not exist, the response contains an HTTP 403 Forbidden error instead of a 404 Not Found error. Corresponds to the JSON property name

Returns:

  • (String) 


2557
2558
2559
 
# File 'lib/google/apis/iam_v1/classes.rb', line 2557

def name
  @name
end

#oauth2_client_id ⇒ String

Output only. The OAuth 2.0 client ID for the service account. Corresponds to the JSON property oauth2ClientId

Returns:

  • (String) 


2562
2563
2564
 
# File 'lib/google/apis/iam_v1/classes.rb', line 2562

def oauth2_client_id
  @oauth2_client_id
end

#project_id ⇒ String

Output only. The ID of the project that owns the service account. Corresponds to the JSON property projectId

Returns:

  • (String) 


2567
2568
2569
 
# File 'lib/google/apis/iam_v1/classes.rb', line 2567

def project_id
  @project_id
end

#unique_id ⇒ String

Output only. The unique, stable numeric ID for the service account. Each service account retains its unique ID even if you delete the service account. For example, if you delete a service account, then create a new service account with the same name, the new service account has a different unique ID than the deleted service account. Corresponds to the JSON property uniqueId

Returns:

  • (String) 


2576
2577
2578
 
# File 'lib/google/apis/iam_v1/classes.rb', line 2576

def unique_id
  @unique_id
end

Instance Method Details

#update!(**args) ⇒ Object

Update properties of this object



2583
2584
2585
2586
2587
2588
2589
2590
2591
2592
2593
 
# File 'lib/google/apis/iam_v1/classes.rb', line 2583

def update!(**args)
  @description = args[:description] if args.key?(:description)
  @disabled = args[:disabled] if args.key?(:disabled)
  @display_name = args[:display_name] if args.key?(:display_name)
  @email = args[:email] if args.key?(:email)
  @etag = args[:etag] if args.key?(:etag)
  @name = args[:name] if args.key?(:name)
  @oauth2_client_id = args[:oauth2_client_id] if args.key?(:oauth2_client_id)
  @project_id = args[:project_id] if args.key?(:project_id)
  @unique_id = args[:unique_id] if args.key?(:unique_id)
end