REST Resource: organizations

Resource: Organization

The root node in the resource hierarchy to which a particular entity's (a company, for example) resources belong.

JSON representation 
{
  "name": string,
  "displayName": string,
  "state": enum (State),
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "etag": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "directoryCustomerId": string
  // End of mutually exclusive fields.
}
Fields
name

string

Output only. The resource name of the organization. This is the organization's relative path in the API. Its format is "organizations/[organizationId]". For example, "organizations/1234".
displayName

string

Output only. A human-readable string that refers to the organization in the Google Cloud Console. This string is set by the server and cannot be changed. The string will be set to the primary domain (for example, "google.com") of the Google Workspace customer that owns the organization.
state

enum (State)

Output only. The organization's current lifecycle state.
createTime

string (Timestamp format)

Output only. Timestamp when the Organization was created.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Output only. Timestamp when the Organization was last modified.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
deleteTime

string (Timestamp format)

Output only. Timestamp when the Organization was requested for deletion.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
etag

string

Output only. A checksum computed by the server based on the current value of the Organization resource. This may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.

The owner of this organization. The owner should be specified on creation. Once set, it cannot be changed.

The lifetime of the organization and all of its descendants are bound to the owner. If the owner is deleted, the organization and all its descendants will be deleted. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response:
directoryCustomerId

string

Immutable. The G Suite / Workspace customer id used in the Directory API.
End of mutually exclusive fields.

State

Organization lifecycle states.

Enums
STATE_UNSPECIFIED Unspecified state. This is only useful for distinguishing unset values.
ACTIVE The normal and active state.
DELETE_REQUESTED The organization has been marked for deletion by the user.

Methods

get

 Fetches an organization resource identified by the specified resource name.

getBoundaryConfig

 Retrieves the BoundaryConfig identified by the specified name (for example, folders/123456789/boundaryConfig).

getIamPolicy

 Gets the access control policy for an organization resource.
Searches organization resources that are visible to the user and satisfy the specified filter.

setIamPolicy

 Sets the access control policy on an organization resource.

testIamPermissions

 Returns the permissions that a caller has on the specified organization.

updateBoundaryConfig

 Updates the BoundaryConfig identified by the specified name (for example, folders/123456789/boundaryConfig).