Documentation ¶
Index ¶
- Variables
- func RegisterFoldersServer(s *grpc.Server, srv FoldersServer)
- type CreateFolderRequest
- func (*CreateFolderRequest) Descriptor() ([]byte, []int)
- func (m *CreateFolderRequest) GetFolder() *Folder
- func (m *CreateFolderRequest) GetParent() string
- func (*CreateFolderRequest) ProtoMessage()
- func (m *CreateFolderRequest) Reset()
- func (m *CreateFolderRequest) String() string
- func (m *CreateFolderRequest) XXX_DiscardUnknown()
- func (m *CreateFolderRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
- func (m *CreateFolderRequest) XXX_Merge(src proto.Message)
- func (m *CreateFolderRequest) XXX_Size() int
- func (m *CreateFolderRequest) XXX_Unmarshal(b []byte) error
- type DeleteFolderRequest
- func (*DeleteFolderRequest) Descriptor() ([]byte, []int)
- func (m *DeleteFolderRequest) GetName() string
- func (m *DeleteFolderRequest) GetRecursiveDelete() bool
- func (*DeleteFolderRequest) ProtoMessage()
- func (m *DeleteFolderRequest) Reset()
- func (m *DeleteFolderRequest) String() string
- func (m *DeleteFolderRequest) XXX_DiscardUnknown()
- func (m *DeleteFolderRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
- func (m *DeleteFolderRequest) XXX_Merge(src proto.Message)
- func (m *DeleteFolderRequest) XXX_Size() int
- func (m *DeleteFolderRequest) XXX_Unmarshal(b []byte) error
- type Folder
- func (*Folder) Descriptor() ([]byte, []int)
- func (m *Folder) GetCreateTime() *timestamp.Timestamp
- func (m *Folder) GetDisplayName() string
- func (m *Folder) GetLifecycleState() Folder_LifecycleState
- func (m *Folder) GetName() string
- func (m *Folder) GetParent() string
- func (m *Folder) GetUpdateTime() *timestamp.Timestamp
- func (*Folder) ProtoMessage()
- func (m *Folder) Reset()
- func (m *Folder) String() string
- func (m *Folder) XXX_DiscardUnknown()
- func (m *Folder) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
- func (m *Folder) XXX_Merge(src proto.Message)
- func (m *Folder) XXX_Size() int
- func (m *Folder) XXX_Unmarshal(b []byte) error
- type FolderOperation
- func (*FolderOperation) Descriptor() ([]byte, []int)
- func (m *FolderOperation) GetDestinationParent() string
- func (m *FolderOperation) GetDisplayName() string
- func (m *FolderOperation) GetOperationType() FolderOperation_OperationType
- func (m *FolderOperation) GetSourceParent() string
- func (*FolderOperation) ProtoMessage()
- func (m *FolderOperation) Reset()
- func (m *FolderOperation) String() string
- func (m *FolderOperation) XXX_DiscardUnknown()
- func (m *FolderOperation) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
- func (m *FolderOperation) XXX_Merge(src proto.Message)
- func (m *FolderOperation) XXX_Size() int
- func (m *FolderOperation) XXX_Unmarshal(b []byte) error
- type FolderOperation_OperationType
- type Folder_LifecycleState
- type FoldersClient
- type FoldersServer
- type GetFolderRequest
- func (*GetFolderRequest) Descriptor() ([]byte, []int)
- func (m *GetFolderRequest) GetName() string
- func (*GetFolderRequest) ProtoMessage()
- func (m *GetFolderRequest) Reset()
- func (m *GetFolderRequest) String() string
- func (m *GetFolderRequest) XXX_DiscardUnknown()
- func (m *GetFolderRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
- func (m *GetFolderRequest) XXX_Merge(src proto.Message)
- func (m *GetFolderRequest) XXX_Size() int
- func (m *GetFolderRequest) XXX_Unmarshal(b []byte) error
- type ListFoldersRequest
- func (*ListFoldersRequest) Descriptor() ([]byte, []int)
- func (m *ListFoldersRequest) GetPageSize() int32
- func (m *ListFoldersRequest) GetPageToken() string
- func (m *ListFoldersRequest) GetParent() string
- func (m *ListFoldersRequest) GetShowDeleted() bool
- func (*ListFoldersRequest) ProtoMessage()
- func (m *ListFoldersRequest) Reset()
- func (m *ListFoldersRequest) String() string
- func (m *ListFoldersRequest) XXX_DiscardUnknown()
- func (m *ListFoldersRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
- func (m *ListFoldersRequest) XXX_Merge(src proto.Message)
- func (m *ListFoldersRequest) XXX_Size() int
- func (m *ListFoldersRequest) XXX_Unmarshal(b []byte) error
- type ListFoldersResponse
- func (*ListFoldersResponse) Descriptor() ([]byte, []int)
- func (m *ListFoldersResponse) GetFolders() []*Folder
- func (m *ListFoldersResponse) GetNextPageToken() string
- func (*ListFoldersResponse) ProtoMessage()
- func (m *ListFoldersResponse) Reset()
- func (m *ListFoldersResponse) String() string
- func (m *ListFoldersResponse) XXX_DiscardUnknown()
- func (m *ListFoldersResponse) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
- func (m *ListFoldersResponse) XXX_Merge(src proto.Message)
- func (m *ListFoldersResponse) XXX_Size() int
- func (m *ListFoldersResponse) XXX_Unmarshal(b []byte) error
- type MoveFolderRequest
- func (*MoveFolderRequest) Descriptor() ([]byte, []int)
- func (m *MoveFolderRequest) GetDestinationParent() string
- func (m *MoveFolderRequest) GetName() string
- func (*MoveFolderRequest) ProtoMessage()
- func (m *MoveFolderRequest) Reset()
- func (m *MoveFolderRequest) String() string
- func (m *MoveFolderRequest) XXX_DiscardUnknown()
- func (m *MoveFolderRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
- func (m *MoveFolderRequest) XXX_Merge(src proto.Message)
- func (m *MoveFolderRequest) XXX_Size() int
- func (m *MoveFolderRequest) XXX_Unmarshal(b []byte) error
- type SearchFoldersRequest
- func (*SearchFoldersRequest) Descriptor() ([]byte, []int)
- func (m *SearchFoldersRequest) GetPageSize() int32
- func (m *SearchFoldersRequest) GetPageToken() string
- func (m *SearchFoldersRequest) GetQuery() string
- func (*SearchFoldersRequest) ProtoMessage()
- func (m *SearchFoldersRequest) Reset()
- func (m *SearchFoldersRequest) String() string
- func (m *SearchFoldersRequest) XXX_DiscardUnknown()
- func (m *SearchFoldersRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
- func (m *SearchFoldersRequest) XXX_Merge(src proto.Message)
- func (m *SearchFoldersRequest) XXX_Size() int
- func (m *SearchFoldersRequest) XXX_Unmarshal(b []byte) error
- type SearchFoldersResponse
- func (*SearchFoldersResponse) Descriptor() ([]byte, []int)
- func (m *SearchFoldersResponse) GetFolders() []*Folder
- func (m *SearchFoldersResponse) GetNextPageToken() string
- func (*SearchFoldersResponse) ProtoMessage()
- func (m *SearchFoldersResponse) Reset()
- func (m *SearchFoldersResponse) String() string
- func (m *SearchFoldersResponse) XXX_DiscardUnknown()
- func (m *SearchFoldersResponse) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
- func (m *SearchFoldersResponse) XXX_Merge(src proto.Message)
- func (m *SearchFoldersResponse) XXX_Size() int
- func (m *SearchFoldersResponse) XXX_Unmarshal(b []byte) error
- type UndeleteFolderRequest
- func (*UndeleteFolderRequest) Descriptor() ([]byte, []int)
- func (m *UndeleteFolderRequest) GetName() string
- func (*UndeleteFolderRequest) ProtoMessage()
- func (m *UndeleteFolderRequest) Reset()
- func (m *UndeleteFolderRequest) String() string
- func (m *UndeleteFolderRequest) XXX_DiscardUnknown()
- func (m *UndeleteFolderRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
- func (m *UndeleteFolderRequest) XXX_Merge(src proto.Message)
- func (m *UndeleteFolderRequest) XXX_Size() int
- func (m *UndeleteFolderRequest) XXX_Unmarshal(b []byte) error
- type UpdateFolderRequest
- func (*UpdateFolderRequest) Descriptor() ([]byte, []int)
- func (m *UpdateFolderRequest) GetFolder() *Folder
- func (m *UpdateFolderRequest) GetUpdateMask() *field_mask.FieldMask
- func (*UpdateFolderRequest) ProtoMessage()
- func (m *UpdateFolderRequest) Reset()
- func (m *UpdateFolderRequest) String() string
- func (m *UpdateFolderRequest) XXX_DiscardUnknown()
- func (m *UpdateFolderRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
- func (m *UpdateFolderRequest) XXX_Merge(src proto.Message)
- func (m *UpdateFolderRequest) XXX_Size() int
- func (m *UpdateFolderRequest) XXX_Unmarshal(b []byte) error
Constants ¶
This section is empty.
Variables ¶
var FolderOperation_OperationType_name = map[int32]string{
0: "OPERATION_TYPE_UNSPECIFIED",
1: "CREATE",
2: "MOVE",
}
var FolderOperation_OperationType_value = map[string]int32{
"OPERATION_TYPE_UNSPECIFIED": 0,
"CREATE": 1,
"MOVE": 2,
}
var Folder_LifecycleState_name = map[int32]string{
0: "LIFECYCLE_STATE_UNSPECIFIED",
1: "ACTIVE",
2: "DELETE_REQUESTED",
}
var Folder_LifecycleState_value = map[string]int32{
"LIFECYCLE_STATE_UNSPECIFIED": 0,
"ACTIVE": 1,
"DELETE_REQUESTED": 2,
}
Functions ¶
func RegisterFoldersServer ¶
func RegisterFoldersServer(s *grpc.Server, srv FoldersServer)
Types ¶
type CreateFolderRequest ¶
type CreateFolderRequest struct { // The resource name of the new Folder's parent. // Must be of the form `folders/{folder_id}` or `organizations/{org_id}`. Parent string `protobuf:"bytes,1,opt,name=parent,proto3" json:"parent,omitempty"` // The Folder being created, only the display name will be consulted. // All other fields will be ignored. Folder *Folder `protobuf:"bytes,2,opt,name=folder,proto3" json:"folder,omitempty"` XXX_NoUnkeyedLiteral struct{} `json:"-"` XXX_unrecognized []byte `json:"-"` XXX_sizecache int32 `json:"-"` }
The CreateFolder request message.
func (*CreateFolderRequest) Descriptor ¶
func (*CreateFolderRequest) Descriptor() ([]byte, []int)
func (*CreateFolderRequest) GetFolder ¶
func (m *CreateFolderRequest) GetFolder() *Folder
func (*CreateFolderRequest) GetParent ¶
func (m *CreateFolderRequest) GetParent() string
func (*CreateFolderRequest) ProtoMessage ¶
func (*CreateFolderRequest) ProtoMessage()
func (*CreateFolderRequest) Reset ¶
func (m *CreateFolderRequest) Reset()
func (*CreateFolderRequest) String ¶
func (m *CreateFolderRequest) String() string
func (*CreateFolderRequest) XXX_DiscardUnknown ¶
func (m *CreateFolderRequest) XXX_DiscardUnknown()
func (*CreateFolderRequest) XXX_Marshal ¶
func (m *CreateFolderRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
func (*CreateFolderRequest) XXX_Merge ¶
func (m *CreateFolderRequest) XXX_Merge(src proto.Message)
func (*CreateFolderRequest) XXX_Size ¶
func (m *CreateFolderRequest) XXX_Size() int
func (*CreateFolderRequest) XXX_Unmarshal ¶
func (m *CreateFolderRequest) XXX_Unmarshal(b []byte) error
type DeleteFolderRequest ¶
type DeleteFolderRequest struct { // the resource name of the Folder to be deleted. // Must be of the form `folders/{folder_id}`. Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"` // Instructs DeleteFolderAction to delete a folder even when the folder is not // empty. RecursiveDelete bool `protobuf:"varint,2,opt,name=recursive_delete,json=recursiveDelete,proto3" json:"recursive_delete,omitempty"` XXX_NoUnkeyedLiteral struct{} `json:"-"` XXX_unrecognized []byte `json:"-"` XXX_sizecache int32 `json:"-"` }
The DeleteFolder request message.
func (*DeleteFolderRequest) Descriptor ¶
func (*DeleteFolderRequest) Descriptor() ([]byte, []int)
func (*DeleteFolderRequest) GetName ¶
func (m *DeleteFolderRequest) GetName() string
func (*DeleteFolderRequest) GetRecursiveDelete ¶
func (m *DeleteFolderRequest) GetRecursiveDelete() bool
func (*DeleteFolderRequest) ProtoMessage ¶
func (*DeleteFolderRequest) ProtoMessage()
func (*DeleteFolderRequest) Reset ¶
func (m *DeleteFolderRequest) Reset()
func (*DeleteFolderRequest) String ¶
func (m *DeleteFolderRequest) String() string
func (*DeleteFolderRequest) XXX_DiscardUnknown ¶
func (m *DeleteFolderRequest) XXX_DiscardUnknown()
func (*DeleteFolderRequest) XXX_Marshal ¶
func (m *DeleteFolderRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
func (*DeleteFolderRequest) XXX_Merge ¶
func (m *DeleteFolderRequest) XXX_Merge(src proto.Message)
func (*DeleteFolderRequest) XXX_Size ¶
func (m *DeleteFolderRequest) XXX_Size() int
func (*DeleteFolderRequest) XXX_Unmarshal ¶
func (m *DeleteFolderRequest) XXX_Unmarshal(b []byte) error
type Folder ¶
type Folder struct { // Output only. The resource name of the Folder. // Its format is `folders/{folder_id}`, for example: "folders/1234". Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"` // The Folder’s parent's resource name. // Updates to the folder's parent must be performed via [MoveFolders]. Parent string `protobuf:"bytes,2,opt,name=parent,proto3" json:"parent,omitempty"` // The folder’s display name. // A folder’s display name must be unique amongst its siblings, e.g. // no two folders with the same parent can share the same display name. // The display name must start and end with a letter or digit, may contain // letters, digits, spaces, hyphens and underscores and can be no longer // than 30 characters. This is captured by the regular expression: // [\p{L}\p{N}]({\p{L}\p{N}_- ]{0,28}[\p{L}\p{N}])?. DisplayName string `protobuf:"bytes,3,opt,name=display_name,json=displayName,proto3" json:"display_name,omitempty"` // Output only. The lifecycle state of the folder. // Updates to the lifecycle_state must be performed via // [DeleteFolder] and [UndeleteFolder]. LifecycleState Folder_LifecycleState `` /* 163-byte string literal not displayed */ // Output only. Timestamp when the Folder was created. Assigned by the server. CreateTime *timestamp.Timestamp `protobuf:"bytes,5,opt,name=create_time,json=createTime,proto3" json:"create_time,omitempty"` // Output only. Timestamp when the Folder was last modified. UpdateTime *timestamp.Timestamp `protobuf:"bytes,6,opt,name=update_time,json=updateTime,proto3" json:"update_time,omitempty"` XXX_NoUnkeyedLiteral struct{} `json:"-"` XXX_unrecognized []byte `json:"-"` XXX_sizecache int32 `json:"-"` }
A Folder in an Organization's resource hierarchy, used to organize that Organization's resources.
func (*Folder) Descriptor ¶
func (*Folder) GetCreateTime ¶
func (*Folder) GetDisplayName ¶
func (*Folder) GetLifecycleState ¶
func (m *Folder) GetLifecycleState() Folder_LifecycleState
func (*Folder) GetUpdateTime ¶
func (*Folder) ProtoMessage ¶
func (*Folder) ProtoMessage()
func (*Folder) XXX_DiscardUnknown ¶
func (m *Folder) XXX_DiscardUnknown()
func (*Folder) XXX_Marshal ¶
func (*Folder) XXX_Unmarshal ¶
type FolderOperation ¶
type FolderOperation struct { // The display name of the folder. DisplayName string `protobuf:"bytes,1,opt,name=display_name,json=displayName,proto3" json:"display_name,omitempty"` // The type of this operation. OperationType FolderOperation_OperationType `` /* 168-byte string literal not displayed */ // The resource name of the folder's parent. // Only applicable when the operation_type is MOVE. SourceParent string `protobuf:"bytes,3,opt,name=source_parent,json=sourceParent,proto3" json:"source_parent,omitempty"` // The resource name of the folder or organization we are either creating // the folder under or moving the folder to. DestinationParent string `protobuf:"bytes,4,opt,name=destination_parent,json=destinationParent,proto3" json:"destination_parent,omitempty"` XXX_NoUnkeyedLiteral struct{} `json:"-"` XXX_unrecognized []byte `json:"-"` XXX_sizecache int32 `json:"-"` }
Metadata describing a long running folder operation
func (*FolderOperation) Descriptor ¶
func (*FolderOperation) Descriptor() ([]byte, []int)
func (*FolderOperation) GetDestinationParent ¶
func (m *FolderOperation) GetDestinationParent() string
func (*FolderOperation) GetDisplayName ¶
func (m *FolderOperation) GetDisplayName() string
func (*FolderOperation) GetOperationType ¶
func (m *FolderOperation) GetOperationType() FolderOperation_OperationType
func (*FolderOperation) GetSourceParent ¶
func (m *FolderOperation) GetSourceParent() string
func (*FolderOperation) ProtoMessage ¶
func (*FolderOperation) ProtoMessage()
func (*FolderOperation) Reset ¶
func (m *FolderOperation) Reset()
func (*FolderOperation) String ¶
func (m *FolderOperation) String() string
func (*FolderOperation) XXX_DiscardUnknown ¶
func (m *FolderOperation) XXX_DiscardUnknown()
func (*FolderOperation) XXX_Marshal ¶
func (m *FolderOperation) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
func (*FolderOperation) XXX_Merge ¶
func (m *FolderOperation) XXX_Merge(src proto.Message)
func (*FolderOperation) XXX_Size ¶
func (m *FolderOperation) XXX_Size() int
func (*FolderOperation) XXX_Unmarshal ¶
func (m *FolderOperation) XXX_Unmarshal(b []byte) error
type FolderOperation_OperationType ¶
type FolderOperation_OperationType int32
The type of operation that failed.
const ( // Operation type not specified. FolderOperation_OPERATION_TYPE_UNSPECIFIED FolderOperation_OperationType = 0 // A create folder operation. FolderOperation_CREATE FolderOperation_OperationType = 1 // A move folder operation. FolderOperation_MOVE FolderOperation_OperationType = 2 )
func (FolderOperation_OperationType) EnumDescriptor ¶
func (FolderOperation_OperationType) EnumDescriptor() ([]byte, []int)
func (FolderOperation_OperationType) String ¶
func (x FolderOperation_OperationType) String() string
type Folder_LifecycleState ¶
type Folder_LifecycleState int32
Folder lifecycle states.
const ( // Unspecified state. Folder_LIFECYCLE_STATE_UNSPECIFIED Folder_LifecycleState = 0 // The normal and active state. Folder_ACTIVE Folder_LifecycleState = 1 // The folder has been marked for deletion by the user. Folder_DELETE_REQUESTED Folder_LifecycleState = 2 )
func (Folder_LifecycleState) EnumDescriptor ¶
func (Folder_LifecycleState) EnumDescriptor() ([]byte, []int)
func (Folder_LifecycleState) String ¶
func (x Folder_LifecycleState) String() string
type FoldersClient ¶
type FoldersClient interface { // Lists the Folders that are direct descendants of supplied parent resource. // List provides a strongly consistent view of the Folders underneath // the specified parent resource. // List returns Folders sorted based upon the (ascending) lexical ordering // of their display_name. // The caller must have `resourcemanager.folders.list` permission on the // identified parent. ListFolders(ctx context.Context, in *ListFoldersRequest, opts ...grpc.CallOption) (*ListFoldersResponse, error) // Search for folders that match specific filter criteria. // Search provides an eventually consistent view of the folders a user has // access to which meet the specified filter criteria. // // This will only return folders on which the caller has the // permission `resourcemanager.folders.get`. SearchFolders(ctx context.Context, in *SearchFoldersRequest, opts ...grpc.CallOption) (*SearchFoldersResponse, error) // Retrieves a Folder identified by the supplied resource name. // Valid Folder resource names have the format `folders/{folder_id}` // (for example, `folders/1234`). // The caller must have `resourcemanager.folders.get` permission on the // identified folder. GetFolder(ctx context.Context, in *GetFolderRequest, opts ...grpc.CallOption) (*Folder, error) // Creates a Folder in the resource hierarchy. // Returns an Operation which can be used to track the progress of the // folder creation workflow. // Upon success the Operation.response field will be populated with the // created Folder. // // In order to succeed, the addition of this new Folder must not violate // the Folder naming, height or fanout constraints. // + The Folder's display_name must be distinct from all other Folder's that // share its parent. // + The addition of the Folder must not cause the active Folder hierarchy // to exceed a height of 4. Note, the full active + deleted Folder hierarchy // is allowed to reach a height of 8; this provides additional headroom when // moving folders that contain deleted folders. // + The addition of the Folder must not cause the total number of Folders // under its parent to exceed 100. // // If the operation fails due to a folder constraint violation, // a PreconditionFailure explaining the violation will be returned. // If the failure occurs synchronously then the PreconditionFailure // will be returned via the Status.details field and if it occurs // asynchronously then the PreconditionFailure will be returned // via the the Operation.error field. // // The caller must have `resourcemanager.folders.create` permission on the // identified parent. CreateFolder(ctx context.Context, in *CreateFolderRequest, opts ...grpc.CallOption) (*longrunning.Operation, error) // Updates a Folder, changing its display_name. // Changes to the folder display_name will be rejected if they violate either // the display_name formatting rules or naming constraints described in // the [CreateFolder] documentation. // + The Folder's display name must start and end with a letter or digit, // may contain letters, digits, spaces, hyphens and underscores and can be // no longer than 30 characters. This is captured by the regular expression: // [\p{L}\p{N}]({\p{L}\p{N}_- ]{0,28}[\p{L}\p{N}])?. // The caller must have `resourcemanager.folders.update` permission on the // identified folder. // // If the update fails due to the unique name constraint then a // PreconditionFailure explaining this violation will be returned // in the Status.details field. UpdateFolder(ctx context.Context, in *UpdateFolderRequest, opts ...grpc.CallOption) (*Folder, error) // Moves a Folder under a new resource parent. // Returns an Operation which can be used to track the progress of the // folder move workflow. // Upon success the Operation.response field will be populated with the // moved Folder. // Upon failure, a FolderOperationError categorizing the failure cause will // be returned - if the failure occurs synchronously then the // FolderOperationError will be returned via the Status.details field // and if it occurs asynchronously then the FolderOperation will be returned // via the the Operation.error field. // In addition, the Operation.metadata field will be populated with a // FolderOperation message as an aid to stateless clients. // Folder moves will be rejected if they violate either the naming, height // or fanout constraints described in the [CreateFolder] documentation. // The caller must have `resourcemanager.folders.move` permission on the // folder's current and proposed new parent. MoveFolder(ctx context.Context, in *MoveFolderRequest, opts ...grpc.CallOption) (*longrunning.Operation, error) // Requests deletion of a Folder. The Folder is moved into the // [DELETE_REQUESTED] state immediately, and is deleted approximately 30 days // later. This method may only be called on an empty Folder in the [ACTIVE] // state, where a Folder is empty if it doesn't contain any Folders or // Projects in the [ACTIVE] state. // The caller must have `resourcemanager.folders.delete` permission on the // identified folder. DeleteFolder(ctx context.Context, in *DeleteFolderRequest, opts ...grpc.CallOption) (*Folder, error) // Cancels the deletion request for a Folder. This method may only be // called on a Folder in the [DELETE_REQUESTED] state. // In order to succeed, the Folder's parent must be in the [ACTIVE] state. // In addition, reintroducing the folder into the tree must not violate // folder naming, height and fanout constraints described in the // [CreateFolder] documentation. // The caller must have `resourcemanager.folders.undelete` permission on the // identified folder. UndeleteFolder(ctx context.Context, in *UndeleteFolderRequest, opts ...grpc.CallOption) (*Folder, error) // Gets the access control policy for a Folder. The returned policy may be // empty if no such policy or resource exists. The `resource` field should // be the Folder's resource name, e.g. "folders/1234". // The caller must have `resourcemanager.folders.getIamPolicy` permission // on the identified folder. GetIamPolicy(ctx context.Context, in *v1.GetIamPolicyRequest, opts ...grpc.CallOption) (*v1.Policy, error) // Sets the access control policy on a Folder, replacing any existing policy. // The `resource` field should be the Folder's resource name, e.g. // "folders/1234". // The caller must have `resourcemanager.folders.setIamPolicy` permission // on the identified folder. SetIamPolicy(ctx context.Context, in *v1.SetIamPolicyRequest, opts ...grpc.CallOption) (*v1.Policy, error) // Returns permissions that a caller has on the specified Folder. // The `resource` field should be the Folder's resource name, // e.g. "folders/1234". // // There are no permissions required for making this API call. TestIamPermissions(ctx context.Context, in *v1.TestIamPermissionsRequest, opts ...grpc.CallOption) (*v1.TestIamPermissionsResponse, error) }
FoldersClient is the client API for Folders service.
For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream.
func NewFoldersClient ¶
func NewFoldersClient(cc *grpc.ClientConn) FoldersClient
type FoldersServer ¶
type FoldersServer interface { // Lists the Folders that are direct descendants of supplied parent resource. // List provides a strongly consistent view of the Folders underneath // the specified parent resource. // List returns Folders sorted based upon the (ascending) lexical ordering // of their display_name. // The caller must have `resourcemanager.folders.list` permission on the // identified parent. ListFolders(context.Context, *ListFoldersRequest) (*ListFoldersResponse, error) // Search for folders that match specific filter criteria. // Search provides an eventually consistent view of the folders a user has // access to which meet the specified filter criteria. // // This will only return folders on which the caller has the // permission `resourcemanager.folders.get`. SearchFolders(context.Context, *SearchFoldersRequest) (*SearchFoldersResponse, error) // Retrieves a Folder identified by the supplied resource name. // Valid Folder resource names have the format `folders/{folder_id}` // (for example, `folders/1234`). // The caller must have `resourcemanager.folders.get` permission on the // identified folder. GetFolder(context.Context, *GetFolderRequest) (*Folder, error) // Creates a Folder in the resource hierarchy. // Returns an Operation which can be used to track the progress of the // folder creation workflow. // Upon success the Operation.response field will be populated with the // created Folder. // // In order to succeed, the addition of this new Folder must not violate // the Folder naming, height or fanout constraints. // + The Folder's display_name must be distinct from all other Folder's that // share its parent. // + The addition of the Folder must not cause the active Folder hierarchy // to exceed a height of 4. Note, the full active + deleted Folder hierarchy // is allowed to reach a height of 8; this provides additional headroom when // moving folders that contain deleted folders. // + The addition of the Folder must not cause the total number of Folders // under its parent to exceed 100. // // If the operation fails due to a folder constraint violation, // a PreconditionFailure explaining the violation will be returned. // If the failure occurs synchronously then the PreconditionFailure // will be returned via the Status.details field and if it occurs // asynchronously then the PreconditionFailure will be returned // via the the Operation.error field. // // The caller must have `resourcemanager.folders.create` permission on the // identified parent. CreateFolder(context.Context, *CreateFolderRequest) (*longrunning.Operation, error) // Updates a Folder, changing its display_name. // Changes to the folder display_name will be rejected if they violate either // the display_name formatting rules or naming constraints described in // the [CreateFolder] documentation. // + The Folder's display name must start and end with a letter or digit, // may contain letters, digits, spaces, hyphens and underscores and can be // no longer than 30 characters. This is captured by the regular expression: // [\p{L}\p{N}]({\p{L}\p{N}_- ]{0,28}[\p{L}\p{N}])?. // The caller must have `resourcemanager.folders.update` permission on the // identified folder. // // If the update fails due to the unique name constraint then a // PreconditionFailure explaining this violation will be returned // in the Status.details field. UpdateFolder(context.Context, *UpdateFolderRequest) (*Folder, error) // Moves a Folder under a new resource parent. // Returns an Operation which can be used to track the progress of the // folder move workflow. // Upon success the Operation.response field will be populated with the // moved Folder. // Upon failure, a FolderOperationError categorizing the failure cause will // be returned - if the failure occurs synchronously then the // FolderOperationError will be returned via the Status.details field // and if it occurs asynchronously then the FolderOperation will be returned // via the the Operation.error field. // In addition, the Operation.metadata field will be populated with a // FolderOperation message as an aid to stateless clients. // Folder moves will be rejected if they violate either the naming, height // or fanout constraints described in the [CreateFolder] documentation. // The caller must have `resourcemanager.folders.move` permission on the // folder's current and proposed new parent. MoveFolder(context.Context, *MoveFolderRequest) (*longrunning.Operation, error) // Requests deletion of a Folder. The Folder is moved into the // [DELETE_REQUESTED] state immediately, and is deleted approximately 30 days // later. This method may only be called on an empty Folder in the [ACTIVE] // state, where a Folder is empty if it doesn't contain any Folders or // Projects in the [ACTIVE] state. // The caller must have `resourcemanager.folders.delete` permission on the // identified folder. DeleteFolder(context.Context, *DeleteFolderRequest) (*Folder, error) // Cancels the deletion request for a Folder. This method may only be // called on a Folder in the [DELETE_REQUESTED] state. // In order to succeed, the Folder's parent must be in the [ACTIVE] state. // In addition, reintroducing the folder into the tree must not violate // folder naming, height and fanout constraints described in the // [CreateFolder] documentation. // The caller must have `resourcemanager.folders.undelete` permission on the // identified folder. UndeleteFolder(context.Context, *UndeleteFolderRequest) (*Folder, error) // Gets the access control policy for a Folder. The returned policy may be // empty if no such policy or resource exists. The `resource` field should // be the Folder's resource name, e.g. "folders/1234". // The caller must have `resourcemanager.folders.getIamPolicy` permission // on the identified folder. GetIamPolicy(context.Context, *v1.GetIamPolicyRequest) (*v1.Policy, error) // Sets the access control policy on a Folder, replacing any existing policy. // The `resource` field should be the Folder's resource name, e.g. // "folders/1234". // The caller must have `resourcemanager.folders.setIamPolicy` permission // on the identified folder. SetIamPolicy(context.Context, *v1.SetIamPolicyRequest) (*v1.Policy, error) // Returns permissions that a caller has on the specified Folder. // The `resource` field should be the Folder's resource name, // e.g. "folders/1234". // // There are no permissions required for making this API call. TestIamPermissions(context.Context, *v1.TestIamPermissionsRequest) (*v1.TestIamPermissionsResponse, error) }
FoldersServer is the server API for Folders service.
type GetFolderRequest ¶
type GetFolderRequest struct { // The resource name of the Folder to retrieve. // Must be of the form `folders/{folder_id}`. Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"` XXX_NoUnkeyedLiteral struct{} `json:"-"` XXX_unrecognized []byte `json:"-"` XXX_sizecache int32 `json:"-"` }
The GetFolder request message.
func (*GetFolderRequest) Descriptor ¶
func (*GetFolderRequest) Descriptor() ([]byte, []int)
func (*GetFolderRequest) GetName ¶
func (m *GetFolderRequest) GetName() string
func (*GetFolderRequest) ProtoMessage ¶
func (*GetFolderRequest) ProtoMessage()
func (*GetFolderRequest) Reset ¶
func (m *GetFolderRequest) Reset()
func (*GetFolderRequest) String ¶
func (m *GetFolderRequest) String() string
func (*GetFolderRequest) XXX_DiscardUnknown ¶
func (m *GetFolderRequest) XXX_DiscardUnknown()
func (*GetFolderRequest) XXX_Marshal ¶
func (m *GetFolderRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
func (*GetFolderRequest) XXX_Merge ¶
func (m *GetFolderRequest) XXX_Merge(src proto.Message)
func (*GetFolderRequest) XXX_Size ¶
func (m *GetFolderRequest) XXX_Size() int
func (*GetFolderRequest) XXX_Unmarshal ¶
func (m *GetFolderRequest) XXX_Unmarshal(b []byte) error
type ListFoldersRequest ¶
type ListFoldersRequest struct { // The resource name of the Organization or Folder whose Folders are // being listed. // Must be of the form `folders/{folder_id}` or `organizations/{org_id}`. // Access to this method is controlled by checking the // `resourcemanager.folders.list` permission on the `parent`. Parent string `protobuf:"bytes,1,opt,name=parent,proto3" json:"parent,omitempty"` // The maximum number of Folders to return in the response. // This field is optional. PageSize int32 `protobuf:"varint,2,opt,name=page_size,json=pageSize,proto3" json:"page_size,omitempty"` // A pagination token returned from a previous call to `ListFolders` // that indicates where this listing should continue from. // This field is optional. PageToken string `protobuf:"bytes,3,opt,name=page_token,json=pageToken,proto3" json:"page_token,omitempty"` // Controls whether Folders in the [DELETE_REQUESTED} state should // be returned. ShowDeleted bool `protobuf:"varint,4,opt,name=show_deleted,json=showDeleted,proto3" json:"show_deleted,omitempty"` XXX_NoUnkeyedLiteral struct{} `json:"-"` XXX_unrecognized []byte `json:"-"` XXX_sizecache int32 `json:"-"` }
The ListFolders request message.
func (*ListFoldersRequest) Descriptor ¶
func (*ListFoldersRequest) Descriptor() ([]byte, []int)
func (*ListFoldersRequest) GetPageSize ¶
func (m *ListFoldersRequest) GetPageSize() int32
func (*ListFoldersRequest) GetPageToken ¶
func (m *ListFoldersRequest) GetPageToken() string
func (*ListFoldersRequest) GetParent ¶
func (m *ListFoldersRequest) GetParent() string
func (*ListFoldersRequest) GetShowDeleted ¶
func (m *ListFoldersRequest) GetShowDeleted() bool
func (*ListFoldersRequest) ProtoMessage ¶
func (*ListFoldersRequest) ProtoMessage()
func (*ListFoldersRequest) Reset ¶
func (m *ListFoldersRequest) Reset()
func (*ListFoldersRequest) String ¶
func (m *ListFoldersRequest) String() string
func (*ListFoldersRequest) XXX_DiscardUnknown ¶
func (m *ListFoldersRequest) XXX_DiscardUnknown()
func (*ListFoldersRequest) XXX_Marshal ¶
func (m *ListFoldersRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
func (*ListFoldersRequest) XXX_Merge ¶
func (m *ListFoldersRequest) XXX_Merge(src proto.Message)
func (*ListFoldersRequest) XXX_Size ¶
func (m *ListFoldersRequest) XXX_Size() int
func (*ListFoldersRequest) XXX_Unmarshal ¶
func (m *ListFoldersRequest) XXX_Unmarshal(b []byte) error
type ListFoldersResponse ¶
type ListFoldersResponse struct { // A possibly paginated list of Folders that are direct descendants of // the specified parent resource. Folders []*Folder `protobuf:"bytes,1,rep,name=folders,proto3" json:"folders,omitempty"` // A pagination token returned from a previous call to `ListFolders` // that indicates from where listing should continue. // This field is optional. NextPageToken string `protobuf:"bytes,2,opt,name=next_page_token,json=nextPageToken,proto3" json:"next_page_token,omitempty"` XXX_NoUnkeyedLiteral struct{} `json:"-"` XXX_unrecognized []byte `json:"-"` XXX_sizecache int32 `json:"-"` }
The ListFolders response message.
func (*ListFoldersResponse) Descriptor ¶
func (*ListFoldersResponse) Descriptor() ([]byte, []int)
func (*ListFoldersResponse) GetFolders ¶
func (m *ListFoldersResponse) GetFolders() []*Folder
func (*ListFoldersResponse) GetNextPageToken ¶
func (m *ListFoldersResponse) GetNextPageToken() string
func (*ListFoldersResponse) ProtoMessage ¶
func (*ListFoldersResponse) ProtoMessage()
func (*ListFoldersResponse) Reset ¶
func (m *ListFoldersResponse) Reset()
func (*ListFoldersResponse) String ¶
func (m *ListFoldersResponse) String() string
func (*ListFoldersResponse) XXX_DiscardUnknown ¶
func (m *ListFoldersResponse) XXX_DiscardUnknown()
func (*ListFoldersResponse) XXX_Marshal ¶
func (m *ListFoldersResponse) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
func (*ListFoldersResponse) XXX_Merge ¶
func (m *ListFoldersResponse) XXX_Merge(src proto.Message)
func (*ListFoldersResponse) XXX_Size ¶
func (m *ListFoldersResponse) XXX_Size() int
func (*ListFoldersResponse) XXX_Unmarshal ¶
func (m *ListFoldersResponse) XXX_Unmarshal(b []byte) error
type MoveFolderRequest ¶
type MoveFolderRequest struct { // The resource name of the Folder to move. // Must be of the form folders/{folder_id} Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"` // The resource name of the Folder or Organization to reparent // the folder under. // Must be of the form `folders/{folder_id}` or `organizations/{org_id}`. DestinationParent string `protobuf:"bytes,2,opt,name=destination_parent,json=destinationParent,proto3" json:"destination_parent,omitempty"` XXX_NoUnkeyedLiteral struct{} `json:"-"` XXX_unrecognized []byte `json:"-"` XXX_sizecache int32 `json:"-"` }
The MoveFolder request message.
func (*MoveFolderRequest) Descriptor ¶
func (*MoveFolderRequest) Descriptor() ([]byte, []int)
func (*MoveFolderRequest) GetDestinationParent ¶
func (m *MoveFolderRequest) GetDestinationParent() string
func (*MoveFolderRequest) GetName ¶
func (m *MoveFolderRequest) GetName() string
func (*MoveFolderRequest) ProtoMessage ¶
func (*MoveFolderRequest) ProtoMessage()
func (*MoveFolderRequest) Reset ¶
func (m *MoveFolderRequest) Reset()
func (*MoveFolderRequest) String ¶
func (m *MoveFolderRequest) String() string
func (*MoveFolderRequest) XXX_DiscardUnknown ¶
func (m *MoveFolderRequest) XXX_DiscardUnknown()
func (*MoveFolderRequest) XXX_Marshal ¶
func (m *MoveFolderRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
func (*MoveFolderRequest) XXX_Merge ¶
func (m *MoveFolderRequest) XXX_Merge(src proto.Message)
func (*MoveFolderRequest) XXX_Size ¶
func (m *MoveFolderRequest) XXX_Size() int
func (*MoveFolderRequest) XXX_Unmarshal ¶
func (m *MoveFolderRequest) XXX_Unmarshal(b []byte) error
type SearchFoldersRequest ¶
type SearchFoldersRequest struct { // The maximum number of folders to return in the response. // This field is optional. PageSize int32 `protobuf:"varint,1,opt,name=page_size,json=pageSize,proto3" json:"page_size,omitempty"` // A pagination token returned from a previous call to `SearchFolders` // that indicates from where search should continue. // This field is optional. PageToken string `protobuf:"bytes,2,opt,name=page_token,json=pageToken,proto3" json:"page_token,omitempty"` // Search criteria used to select the Folders to return. // If no search criteria is specified then all accessible folders will be // returned. // // Query expressions can be used to restrict results based upon displayName, // lifecycleState and parent, where the operators `=`, `NOT`, `AND` and `OR` // can be used along with the suffix wildcard symbol `*`. // // Some example queries are: // |Query|Description| // |------|-----------| // |displayName=Test*|Folders whose display name starts with "Test".| // |lifecycleState=ACTIVE|Folders whose lifecycleState is ACTIVE.| // |parent=folders/123|Folders whose parent is "folders/123".| // |parent=folders/123 AND lifecycleState=ACTIVE|Active folders whose // parent is "folders/123".| Query string `protobuf:"bytes,3,opt,name=query,proto3" json:"query,omitempty"` XXX_NoUnkeyedLiteral struct{} `json:"-"` XXX_unrecognized []byte `json:"-"` XXX_sizecache int32 `json:"-"` }
The request message for searching folders.
func (*SearchFoldersRequest) Descriptor ¶
func (*SearchFoldersRequest) Descriptor() ([]byte, []int)
func (*SearchFoldersRequest) GetPageSize ¶
func (m *SearchFoldersRequest) GetPageSize() int32
func (*SearchFoldersRequest) GetPageToken ¶
func (m *SearchFoldersRequest) GetPageToken() string
func (*SearchFoldersRequest) GetQuery ¶
func (m *SearchFoldersRequest) GetQuery() string
func (*SearchFoldersRequest) ProtoMessage ¶
func (*SearchFoldersRequest) ProtoMessage()
func (*SearchFoldersRequest) Reset ¶
func (m *SearchFoldersRequest) Reset()
func (*SearchFoldersRequest) String ¶
func (m *SearchFoldersRequest) String() string
func (*SearchFoldersRequest) XXX_DiscardUnknown ¶
func (m *SearchFoldersRequest) XXX_DiscardUnknown()
func (*SearchFoldersRequest) XXX_Marshal ¶
func (m *SearchFoldersRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
func (*SearchFoldersRequest) XXX_Merge ¶
func (m *SearchFoldersRequest) XXX_Merge(src proto.Message)
func (*SearchFoldersRequest) XXX_Size ¶
func (m *SearchFoldersRequest) XXX_Size() int
func (*SearchFoldersRequest) XXX_Unmarshal ¶
func (m *SearchFoldersRequest) XXX_Unmarshal(b []byte) error
type SearchFoldersResponse ¶
type SearchFoldersResponse struct { // A possibly paginated folder search results. // the specified parent resource. Folders []*Folder `protobuf:"bytes,1,rep,name=folders,proto3" json:"folders,omitempty"` // A pagination token returned from a previous call to `SearchFolders` // that indicates from where searching should continue. // This field is optional. NextPageToken string `protobuf:"bytes,2,opt,name=next_page_token,json=nextPageToken,proto3" json:"next_page_token,omitempty"` XXX_NoUnkeyedLiteral struct{} `json:"-"` XXX_unrecognized []byte `json:"-"` XXX_sizecache int32 `json:"-"` }
The response message for searching folders.
func (*SearchFoldersResponse) Descriptor ¶
func (*SearchFoldersResponse) Descriptor() ([]byte, []int)
func (*SearchFoldersResponse) GetFolders ¶
func (m *SearchFoldersResponse) GetFolders() []*Folder
func (*SearchFoldersResponse) GetNextPageToken ¶
func (m *SearchFoldersResponse) GetNextPageToken() string
func (*SearchFoldersResponse) ProtoMessage ¶
func (*SearchFoldersResponse) ProtoMessage()
func (*SearchFoldersResponse) Reset ¶
func (m *SearchFoldersResponse) Reset()
func (*SearchFoldersResponse) String ¶
func (m *SearchFoldersResponse) String() string
func (*SearchFoldersResponse) XXX_DiscardUnknown ¶
func (m *SearchFoldersResponse) XXX_DiscardUnknown()
func (*SearchFoldersResponse) XXX_Marshal ¶
func (m *SearchFoldersResponse) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
func (*SearchFoldersResponse) XXX_Merge ¶
func (m *SearchFoldersResponse) XXX_Merge(src proto.Message)
func (*SearchFoldersResponse) XXX_Size ¶
func (m *SearchFoldersResponse) XXX_Size() int
func (*SearchFoldersResponse) XXX_Unmarshal ¶
func (m *SearchFoldersResponse) XXX_Unmarshal(b []byte) error
type UndeleteFolderRequest ¶
type UndeleteFolderRequest struct { // The resource name of the Folder to undelete. // Must be of the form `folders/{folder_id}`. Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"` XXX_NoUnkeyedLiteral struct{} `json:"-"` XXX_unrecognized []byte `json:"-"` XXX_sizecache int32 `json:"-"` }
The UndeleteFolder request message.
func (*UndeleteFolderRequest) Descriptor ¶
func (*UndeleteFolderRequest) Descriptor() ([]byte, []int)
func (*UndeleteFolderRequest) GetName ¶
func (m *UndeleteFolderRequest) GetName() string
func (*UndeleteFolderRequest) ProtoMessage ¶
func (*UndeleteFolderRequest) ProtoMessage()
func (*UndeleteFolderRequest) Reset ¶
func (m *UndeleteFolderRequest) Reset()
func (*UndeleteFolderRequest) String ¶
func (m *UndeleteFolderRequest) String() string
func (*UndeleteFolderRequest) XXX_DiscardUnknown ¶
func (m *UndeleteFolderRequest) XXX_DiscardUnknown()
func (*UndeleteFolderRequest) XXX_Marshal ¶
func (m *UndeleteFolderRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
func (*UndeleteFolderRequest) XXX_Merge ¶
func (m *UndeleteFolderRequest) XXX_Merge(src proto.Message)
func (*UndeleteFolderRequest) XXX_Size ¶
func (m *UndeleteFolderRequest) XXX_Size() int
func (*UndeleteFolderRequest) XXX_Unmarshal ¶
func (m *UndeleteFolderRequest) XXX_Unmarshal(b []byte) error
type UpdateFolderRequest ¶
type UpdateFolderRequest struct { // The new definition of the Folder. It must include a // a `name` and `display_name` field. The other fields // will be ignored. Folder *Folder `protobuf:"bytes,1,opt,name=folder,proto3" json:"folder,omitempty"` // Fields to be updated. // Only the `display_name` can be updated. UpdateMask *field_mask.FieldMask `protobuf:"bytes,2,opt,name=update_mask,json=updateMask,proto3" json:"update_mask,omitempty"` XXX_NoUnkeyedLiteral struct{} `json:"-"` XXX_unrecognized []byte `json:"-"` XXX_sizecache int32 `json:"-"` }
The request message for updating a folder's display name.
func (*UpdateFolderRequest) Descriptor ¶
func (*UpdateFolderRequest) Descriptor() ([]byte, []int)
func (*UpdateFolderRequest) GetFolder ¶
func (m *UpdateFolderRequest) GetFolder() *Folder
func (*UpdateFolderRequest) GetUpdateMask ¶
func (m *UpdateFolderRequest) GetUpdateMask() *field_mask.FieldMask
func (*UpdateFolderRequest) ProtoMessage ¶
func (*UpdateFolderRequest) ProtoMessage()
func (*UpdateFolderRequest) Reset ¶
func (m *UpdateFolderRequest) Reset()
func (*UpdateFolderRequest) String ¶
func (m *UpdateFolderRequest) String() string
func (*UpdateFolderRequest) XXX_DiscardUnknown ¶
func (m *UpdateFolderRequest) XXX_DiscardUnknown()
func (*UpdateFolderRequest) XXX_Marshal ¶
func (m *UpdateFolderRequest) XXX_Marshal(b []byte, deterministic bool) ([]byte, error)
func (*UpdateFolderRequest) XXX_Merge ¶
func (m *UpdateFolderRequest) XXX_Merge(src proto.Message)
func (*UpdateFolderRequest) XXX_Size ¶
func (m *UpdateFolderRequest) XXX_Size() int
func (*UpdateFolderRequest) XXX_Unmarshal ¶
func (m *UpdateFolderRequest) XXX_Unmarshal(b []byte) error