Documentation
¶
Overview ¶
Package managementgroups implements the Azure ARM Managementgroups service API version 2017-08-31-preview.
The Azure Management Groups API enables consolidation of multiple subscriptions/resources into an organizational hierarchy and centrally manage access control, policies, alerting and reporting for those resources.
Index ¶
- Constants
- func UserAgent() string
- func Version() string
- type BaseClient
- type ChildInfo
- type ChildType
- type ChildType1
- type Client
- func (client Client) Get(ctx context.Context, expand string, recurse *bool) (result WithHierarchy, err error)
- func (client Client) GetPreparer(ctx context.Context, expand string, recurse *bool) (*http.Request, error)
- func (client Client) GetResponder(resp *http.Response) (result WithHierarchy, err error)
- func (client Client) GetSender(req *http.Request) (*http.Response, error)
- func (client Client) List(ctx context.Context, skiptoken string) (result ListResultPage, err error)
- func (client Client) ListComplete(ctx context.Context, skiptoken string) (result ListResultIterator, err error)
- func (client Client) ListPreparer(ctx context.Context, skiptoken string) (*http.Request, error)
- func (client Client) ListResponder(resp *http.Response) (result ListResult, err error)
- func (client Client) ListSender(req *http.Request) (*http.Response, error)
- type DetailsProperties
- type ErrorDetails
- type ErrorResponse
- type Info
- type InfoProperties
- type ListResult
- type ListResultIterator
- type ListResultPage
- type ManagementGroup
- type ManagementGroupType
- type Operation
- type OperationDisplay
- type OperationListResult
- type OperationListResultIterator
- type OperationListResultPage
- type OperationsClient
- func (client OperationsClient) List(ctx context.Context) (result OperationListResultPage, err error)
- func (client OperationsClient) ListComplete(ctx context.Context) (result OperationListResultIterator, err error)
- func (client OperationsClient) ListPreparer(ctx context.Context) (*http.Request, error)
- func (client OperationsClient) ListResponder(resp *http.Response) (result OperationListResult, err error)
- func (client OperationsClient) ListSender(req *http.Request) (*http.Response, error)
- type ParentGroupInfo
- type Properties
- type PropertiesWithChildren
- type PropertiesWithHierarchy
- type RecursiveChildInfo
- type WithChildren
- type WithHierarchy
Constants ¶
const (
// DefaultBaseURI is the default URI used for the service Managementgroups
DefaultBaseURI = "https://management.azure.com"
)
Variables ¶
This section is empty.
Functions ¶
func UserAgent ¶
func UserAgent() string
UserAgent returns the UserAgent string to use when sending http.Requests.
func Version ¶
func Version() string
Version returns the semantic version (see http://semver.org) of the client.
Types ¶
type BaseClient ¶
BaseClient is the base client for Managementgroups.
func NewWithBaseURI ¶
func NewWithBaseURI(baseURI string, groupID uuid.UUID) BaseClient
NewWithBaseURI creates an instance of the BaseClient client.
type ChildInfo ¶
type ChildInfo struct {
// ChildType - Possible values include: 'Enrollment', 'Department', 'Account', 'Subscription'
ChildType ChildType `json:"childType,omitempty"`
// ChildID - The ID of the child resource (management group or subscription). E.g. /providers/Microsoft.Management/managementGroups/40000000-0000-0000-0000-000000000000
ChildID *string `json:"childId,omitempty"`
// DisplayName - The friendly name of the child resource.
DisplayName *string `json:"displayName,omitempty"`
// TenantID - (Optional) The AAD Tenant ID associated with the child resource.
TenantID *uuid.UUID `json:"tenantId,omitempty"`
}
ChildInfo the unique identifier (ID) of a management group.
type ChildType ¶
type ChildType string
ChildType enumerates the values for child type.
func PossibleChildTypeValues ¶
func PossibleChildTypeValues() []ChildType
PossibleChildTypeValues returns an array of possible values for the ChildType const type.
type ChildType1 ¶
type ChildType1 string
ChildType1 enumerates the values for child type 1.
const ( // ChildType1Account ... ChildType1Account ChildType1 = "Account" // ChildType1Department ... ChildType1Department ChildType1 = "Department" // ChildType1Enrollment ... ChildType1Enrollment ChildType1 = "Enrollment" // ChildType1Subscription ... ChildType1Subscription ChildType1 = "Subscription" )
func PossibleChildType1Values ¶
func PossibleChildType1Values() []ChildType1
PossibleChildType1Values returns an array of possible values for the ChildType1 const type.
type Client ¶
type Client struct {
BaseClient
}
Client is the the Azure Management Groups API enables consolidation of multiple subscriptions/resources into an organizational hierarchy and centrally manage access control, policies, alerting and reporting for those resources.
func NewClient ¶
func NewClient(groupID uuid.UUID) Client
NewClient creates an instance of the Client client.
func NewClientWithBaseURI ¶
NewClientWithBaseURI creates an instance of the Client client.
func (Client) Get ¶
func (client Client) Get(ctx context.Context, expand string, recurse *bool) (result WithHierarchy, err error)
Get get the details of the management group. Parameters: expand - the $expand=children query string parameter allows clients to request inclusion of children in the response payload. recurse - the $recurse=true query string parameter allows clients to request inclusion of entire hierarchy in the response payload.
func (Client) GetPreparer ¶
func (client Client) GetPreparer(ctx context.Context, expand string, recurse *bool) (*http.Request, error)
GetPreparer prepares the Get request.
func (Client) GetResponder ¶
func (client Client) GetResponder(resp *http.Response) (result WithHierarchy, err error)
GetResponder handles the response to the Get request. The method always closes the http.Response Body.
func (Client) GetSender ¶
GetSender sends the Get request. The method will close the http.Response Body if it receives an error.
func (Client) List ¶
List list management groups for the authenticated user. Parameters: skiptoken - page continuation token is only used if a previous operation returned a partial result. If a previous response contains a nextLink element, the value of the nextLink element will include a token parameter that specifies a starting point to use for subsequent calls.
func (Client) ListComplete ¶
func (client Client) ListComplete(ctx context.Context, skiptoken string) (result ListResultIterator, err error)
ListComplete enumerates all values, automatically crossing page boundaries as required.
func (Client) ListPreparer ¶
ListPreparer prepares the List request.
func (Client) ListResponder ¶
func (client Client) ListResponder(resp *http.Response) (result ListResult, err error)
ListResponder handles the response to the List request. The method always closes the http.Response Body.
type DetailsProperties ¶
type DetailsProperties struct {
// Version - The version number of the object.
Version *float64 `json:"version,omitempty"`
// UpdatedTime - The date and time when this object was last updated.
UpdatedTime *date.Time `json:"updatedTime,omitempty"`
// UpdatedBy - The identity of the principal or process that updated the object.
UpdatedBy *string `json:"updatedBy,omitempty"`
Parent *ParentGroupInfo `json:"parent,omitempty"`
// ManagementGroupType - Possible values include: 'ManagementGroupTypeEnrollment', 'ManagementGroupTypeDepartment', 'ManagementGroupTypeAccount', 'ManagementGroupTypeSubscription'
ManagementGroupType ManagementGroupType `json:"managementGroupType,omitempty"`
}
DetailsProperties the details properties of a management group.
type ErrorDetails ¶
type ErrorDetails struct {
// Code - One of a server-defined set of error codes.
Code *string `json:"code,omitempty"`
// Message - A human-readable representation of the error.
Message *string `json:"message,omitempty"`
// Target - (Optional) The target of the error.
Target *string `json:"target,omitempty"`
}
ErrorDetails the details of the error.
type ErrorResponse ¶
type ErrorResponse struct {
Error *ErrorDetails `json:"error,omitempty"`
}
ErrorResponse the error object.
type Info ¶
type Info struct {
// ID - The ID of the management group. E.g. /providers/Microsoft.Management/managementGroups/20000000-0000-0000-0000-000000000000
ID *string `json:"id,omitempty"`
// Type - The type of the resource. E.g. /providers/Microsoft.Management/managementGroups
Type *string `json:"type,omitempty"`
// Name - The name of the management group. E.g. 20000000-0000-0000-0000-000000000000
Name *uuid.UUID `json:"name,omitempty"`
*InfoProperties `json:"properties,omitempty"`
}
Info the management group.
func (Info) MarshalJSON ¶
MarshalJSON is the custom marshaler for Info.
func (*Info) UnmarshalJSON ¶
UnmarshalJSON is the custom unmarshaler for Info struct.
type InfoProperties ¶
type InfoProperties struct {
// TenantID - The AAD Tenant ID associated with the management group. E.g. 10000000-0000-0000-0000-000000000000
TenantID *uuid.UUID `json:"tenantId,omitempty"`
// DisplayName - The friendly name of the management group.
DisplayName *string `json:"displayName,omitempty"`
}
InfoProperties the generic properties of a management group.
type ListResult ¶
type ListResult struct {
autorest.Response `json:"-"`
// Value - The list of management groups.
Value *[]Info `json:"value,omitempty"`
// NextLink - The URL to the next page of results.
NextLink *string `json:"nextLink,omitempty"`
}
ListResult the result of listing management groups.
func (ListResult) IsEmpty ¶
func (lr ListResult) IsEmpty() bool
IsEmpty returns true if the ListResult contains no values.
type ListResultIterator ¶
type ListResultIterator struct {
// contains filtered or unexported fields
}
ListResultIterator provides access to a complete listing of Info values.
func (*ListResultIterator) Next ¶
func (iter *ListResultIterator) Next() error
Next advances to the next value. If there was an error making the request the iterator does not advance and the error is returned.
func (ListResultIterator) NotDone ¶
func (iter ListResultIterator) NotDone() bool
NotDone returns true if the enumeration should be started or is not yet complete.
func (ListResultIterator) Response ¶
func (iter ListResultIterator) Response() ListResult
Response returns the raw server response from the last page request.
func (ListResultIterator) Value ¶
func (iter ListResultIterator) Value() Info
Value returns the current value or a zero-initialized value if the iterator has advanced beyond the end of the collection.
type ListResultPage ¶
type ListResultPage struct {
// contains filtered or unexported fields
}
ListResultPage contains a page of Info values.
func (*ListResultPage) Next ¶
func (page *ListResultPage) Next() error
Next advances to the next page of values. If there was an error making the request the page does not advance and the error is returned.
func (ListResultPage) NotDone ¶
func (page ListResultPage) NotDone() bool
NotDone returns true if the page enumeration should be started or is not yet complete.
func (ListResultPage) Response ¶
func (page ListResultPage) Response() ListResult
Response returns the raw server response from the last page request.
func (ListResultPage) Values ¶
func (page ListResultPage) Values() []Info
Values returns the slice of values for the current page or nil if there are no values.
type ManagementGroup ¶
type ManagementGroup struct {
// ID - The ID of the management group. E.g. /providers/Microsoft.Management/managementGroups/20000000-0000-0000-0000-000000000000
ID *string `json:"id,omitempty"`
// Type - The type of the resource. E.g. /providers/Microsoft.Management/managementGroups
Type *string `json:"type,omitempty"`
// Name - The name of the management group. E.g. 20000000-0000-0000-0000-000000000000
Name *uuid.UUID `json:"name,omitempty"`
*Properties `json:"properties,omitempty"`
}
ManagementGroup the management group details.
func (ManagementGroup) MarshalJSON ¶
func (mg ManagementGroup) MarshalJSON() ([]byte, error)
MarshalJSON is the custom marshaler for ManagementGroup.
func (*ManagementGroup) UnmarshalJSON ¶
func (mg *ManagementGroup) UnmarshalJSON(body []byte) error
UnmarshalJSON is the custom unmarshaler for ManagementGroup struct.
type ManagementGroupType ¶
type ManagementGroupType string
ManagementGroupType enumerates the values for management group type.
const ( // ManagementGroupTypeAccount ... ManagementGroupTypeAccount ManagementGroupType = "Account" // ManagementGroupTypeDepartment ... ManagementGroupTypeDepartment ManagementGroupType = "Department" // ManagementGroupTypeEnrollment ... ManagementGroupTypeEnrollment ManagementGroupType = "Enrollment" // ManagementGroupTypeSubscription ... ManagementGroupTypeSubscription ManagementGroupType = "Subscription" )
func PossibleManagementGroupTypeValues ¶
func PossibleManagementGroupTypeValues() []ManagementGroupType
PossibleManagementGroupTypeValues returns an array of possible values for the ManagementGroupType const type.
type Operation ¶
type Operation struct {
// Name - Operation name: {provider}/{resource}/{operation}.
Name *string `json:"name,omitempty"`
// Display - The object that represents the operation.
Display *OperationDisplay `json:"display,omitempty"`
}
Operation a Management REST API operation.
type OperationDisplay ¶
type OperationDisplay struct {
// Provider - Service provider: Microsoft.Management.
Provider *string `json:"provider,omitempty"`
// Resource - Resource on which the operation is performed: Invoice, etc.
Resource *string `json:"resource,omitempty"`
// Operation - Operation type: Read, write, delete, etc.
Operation *string `json:"operation,omitempty"`
}
OperationDisplay the object that represents the operation.
type OperationListResult ¶
type OperationListResult struct {
autorest.Response `json:"-"`
// Value - List of management operations supported by the Microsoft.Management resource provider.
Value *[]Operation `json:"value,omitempty"`
// NextLink - URL to get the next set of operation list results if there are any.
NextLink *string `json:"nextLink,omitempty"`
}
OperationListResult result listing operations. It contains a list of operations and a URL link to get the next set of results.
func (OperationListResult) IsEmpty ¶
func (olr OperationListResult) IsEmpty() bool
IsEmpty returns true if the ListResult contains no values.
type OperationListResultIterator ¶
type OperationListResultIterator struct {
// contains filtered or unexported fields
}
OperationListResultIterator provides access to a complete listing of Operation values.
func (*OperationListResultIterator) Next ¶
func (iter *OperationListResultIterator) Next() error
Next advances to the next value. If there was an error making the request the iterator does not advance and the error is returned.
func (OperationListResultIterator) NotDone ¶
func (iter OperationListResultIterator) NotDone() bool
NotDone returns true if the enumeration should be started or is not yet complete.
func (OperationListResultIterator) Response ¶
func (iter OperationListResultIterator) Response() OperationListResult
Response returns the raw server response from the last page request.
func (OperationListResultIterator) Value ¶
func (iter OperationListResultIterator) Value() Operation
Value returns the current value or a zero-initialized value if the iterator has advanced beyond the end of the collection.
type OperationListResultPage ¶
type OperationListResultPage struct {
// contains filtered or unexported fields
}
OperationListResultPage contains a page of Operation values.
func (*OperationListResultPage) Next ¶
func (page *OperationListResultPage) Next() error
Next advances to the next page of values. If there was an error making the request the page does not advance and the error is returned.
func (OperationListResultPage) NotDone ¶
func (page OperationListResultPage) NotDone() bool
NotDone returns true if the page enumeration should be started or is not yet complete.
func (OperationListResultPage) Response ¶
func (page OperationListResultPage) Response() OperationListResult
Response returns the raw server response from the last page request.
func (OperationListResultPage) Values ¶
func (page OperationListResultPage) Values() []Operation
Values returns the slice of values for the current page or nil if there are no values.
type OperationsClient ¶
type OperationsClient struct {
BaseClient
}
OperationsClient is the the Azure Management Groups API enables consolidation of multiple subscriptions/resources into an organizational hierarchy and centrally manage access control, policies, alerting and reporting for those resources.
func NewOperationsClient ¶
func NewOperationsClient(groupID uuid.UUID) OperationsClient
NewOperationsClient creates an instance of the OperationsClient client.
func NewOperationsClientWithBaseURI ¶
func NewOperationsClientWithBaseURI(baseURI string, groupID uuid.UUID) OperationsClient
NewOperationsClientWithBaseURI creates an instance of the OperationsClient client.
func (OperationsClient) List ¶
func (client OperationsClient) List(ctx context.Context) (result OperationListResultPage, err error)
List lists all of the available management REST API operations.
func (OperationsClient) ListComplete ¶
func (client OperationsClient) ListComplete(ctx context.Context) (result OperationListResultIterator, err error)
ListComplete enumerates all values, automatically crossing page boundaries as required.
func (OperationsClient) ListPreparer ¶
ListPreparer prepares the List request.
func (OperationsClient) ListResponder ¶
func (client OperationsClient) ListResponder(resp *http.Response) (result OperationListResult, err error)
ListResponder handles the response to the List request. The method always closes the http.Response Body.
func (OperationsClient) ListSender ¶
ListSender sends the List request. The method will close the http.Response Body if it receives an error.
type ParentGroupInfo ¶
type ParentGroupInfo struct {
// ParentID - The ID of the parent management group. E.g. /providers/Microsoft.Management/managementGroups/30000000-0000-0000-0000-000000000000
ParentID *string `json:"parentId,omitempty"`
// DisplayName - The friendly name of the management group.
DisplayName *string `json:"displayName,omitempty"`
}
ParentGroupInfo (Optional) The ID of the parent management group.
type Properties ¶
type Properties struct {
// TenantID - The AAD Tenant ID associated with the management group. E.g. 10000000-0000-0000-0000-000000000000
TenantID *uuid.UUID `json:"tenantId,omitempty"`
// DisplayName - The friendly name of the management group.
DisplayName *string `json:"displayName,omitempty"`
Details *DetailsProperties `json:"details,omitempty"`
}
Properties the generic properties of a management group.
type PropertiesWithChildren ¶
type PropertiesWithChildren struct {
// TenantID - The AAD Tenant ID associated with the management group. E.g. 10000000-0000-0000-0000-000000000000
TenantID *uuid.UUID `json:"tenantId,omitempty"`
// DisplayName - The friendly name of the management group.
DisplayName *string `json:"displayName,omitempty"`
Details *DetailsProperties `json:"details,omitempty"`
// Children - The list of children.
Children *[]ChildInfo `json:"children,omitempty"`
}
PropertiesWithChildren the generic properties of a management group.
type PropertiesWithHierarchy ¶
type PropertiesWithHierarchy struct {
// TenantID - The AAD Tenant ID associated with the management group. E.g. 10000000-0000-0000-0000-000000000000
TenantID *uuid.UUID `json:"tenantId,omitempty"`
// DisplayName - The friendly name of the management group.
DisplayName *string `json:"displayName,omitempty"`
Details *DetailsProperties `json:"details,omitempty"`
// Children - The list of children.
Children *[]RecursiveChildInfo `json:"children,omitempty"`
}
PropertiesWithHierarchy the generic properties of a management group.
type RecursiveChildInfo ¶
type RecursiveChildInfo struct {
// ChildType - Possible values include: 'ChildType1Enrollment', 'ChildType1Department', 'ChildType1Account', 'ChildType1Subscription'
ChildType ChildType1 `json:"childType,omitempty"`
// ChildID - The ID of the child resource (management group or subscription). E.g. /providers/Microsoft.Management/managementGroups/40000000-0000-0000-0000-000000000000
ChildID *string `json:"childId,omitempty"`
// DisplayName - The friendly name of the child resource.
DisplayName *string `json:"displayName,omitempty"`
// TenantID - (Optional) The AAD Tenant ID associated with the child resource.
TenantID *uuid.UUID `json:"tenantId,omitempty"`
// Children - The list of children.
Children *[]RecursiveChildInfo `json:"children,omitempty"`
}
RecursiveChildInfo the unique identifier (ID) of a management group.
type WithChildren ¶
type WithChildren struct {
// ID - The ID of the management group. E.g. /providers/Microsoft.Management/managementGroups/20000000-0000-0000-0000-000000000000
ID *string `json:"id,omitempty"`
// Type - The type of the resource. E.g. /providers/Microsoft.Management/managementGroups
Type *string `json:"type,omitempty"`
// Name - The name of the management group. E.g. 20000000-0000-0000-0000-000000000000
Name *uuid.UUID `json:"name,omitempty"`
*PropertiesWithChildren `json:"properties,omitempty"`
}
WithChildren the management group details.
func (WithChildren) MarshalJSON ¶
func (wc WithChildren) MarshalJSON() ([]byte, error)
MarshalJSON is the custom marshaler for WithChildren.
func (*WithChildren) UnmarshalJSON ¶
func (wc *WithChildren) UnmarshalJSON(body []byte) error
UnmarshalJSON is the custom unmarshaler for WithChildren struct.
type WithHierarchy ¶
type WithHierarchy struct {
autorest.Response `json:"-"`
// ID - The ID of the management group. E.g. /providers/Microsoft.Management/managementGroups/20000000-0000-0000-0000-000000000000
ID *string `json:"id,omitempty"`
// Type - The type of the resource. E.g. /providers/Microsoft.Management/managementGroups
Type *string `json:"type,omitempty"`
// Name - The name of the management group. E.g. 20000000-0000-0000-0000-000000000000
Name *uuid.UUID `json:"name,omitempty"`
*PropertiesWithHierarchy `json:"properties,omitempty"`
}
WithHierarchy the management group details.
func (WithHierarchy) MarshalJSON ¶
func (wh WithHierarchy) MarshalJSON() ([]byte, error)
MarshalJSON is the custom marshaler for WithHierarchy.
func (*WithHierarchy) UnmarshalJSON ¶
func (wh *WithHierarchy) UnmarshalJSON(body []byte) error
UnmarshalJSON is the custom unmarshaler for WithHierarchy struct.