AWS SDK for Go (PILOT)
API Reference

PREVIEW DOCUMENTATION - This is a preview of a new format for the AWS SDK for Go API Reference documentation. For the current AWS SDK for Go API Reference, see https://docs.aws.amazon.com/sdk-for-go/api/.

We welcome your feedback on this new version of the documentation. Send your comments to aws-sdkdocs-feedback@amazon.com.

ResourceGroups

import "github.com/aws/aws-sdk-go/service/resourcegroups"

type ResourceGroups struct { *client.Client }

ResourceGroups provides the API operation methods for making requests to AWS Resource Groups. See this package's package overview docs for details on the service.

ResourceGroups methods are safe to use concurrently. It is not safe to modify mutate any of the struct's properties though.

Client

Type: *client.Client

Method

CreateGroup

func (c *ResourceGroups) CreateGroup(input *CreateGroupInput) (*CreateGroupOutput, error)

CreateGroup API operation for AWS Resource Groups.

Creates a group with a specified name, description, and resource query.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Resource Groups's API operation CreateGroup for usage and error information.

Returned Error Codes:

  • ErrCodeBadRequestException "BadRequestException" The request does not comply with validation rules that are defined for the request parameters.

  • ErrCodeForbiddenException "ForbiddenException" The caller is not authorized to make the request.

  • ErrCodeMethodNotAllowedException "MethodNotAllowedException" The request uses an HTTP method which is not allowed for the specified resource.

  • ErrCodeTooManyRequestsException "TooManyRequestsException" The caller has exceeded throttling limits.

  • ErrCodeInternalServerErrorException "InternalServerErrorException" An internal error occurred while processing the request.

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/CreateGroup

CreateGroupRequest

func (c *ResourceGroups) CreateGroupRequest(input *CreateGroupInput) (req *request.Request, output *CreateGroupOutput)

CreateGroupRequest generates a "aws/request.Request" representing the client's request for the CreateGroup operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateGroup for more information on using the CreateGroup API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CreateGroupRequest method. req, resp := client.CreateGroupRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/CreateGroup

CreateGroupWithContext

func (c *ResourceGroups) CreateGroupWithContext(ctx aws.Context, input *CreateGroupInput, opts ...request.Option) (*CreateGroupOutput, error)

CreateGroupWithContext is the same as CreateGroup with the addition of the ability to pass a context and additional request options.

See CreateGroup for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

DeleteGroup

func (c *ResourceGroups) DeleteGroup(input *DeleteGroupInput) (*DeleteGroupOutput, error)

DeleteGroup API operation for AWS Resource Groups.

Deletes a specified resource group. Deleting a resource group does not delete resources that are members of the group; it only deletes the group structure.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Resource Groups's API operation DeleteGroup for usage and error information.

Returned Error Codes:

  • ErrCodeBadRequestException "BadRequestException" The request does not comply with validation rules that are defined for the request parameters.

  • ErrCodeForbiddenException "ForbiddenException" The caller is not authorized to make the request.

  • ErrCodeNotFoundException "NotFoundException" One or more resources specified in the request do not exist.

  • ErrCodeMethodNotAllowedException "MethodNotAllowedException" The request uses an HTTP method which is not allowed for the specified resource.

  • ErrCodeTooManyRequestsException "TooManyRequestsException" The caller has exceeded throttling limits.

  • ErrCodeInternalServerErrorException "InternalServerErrorException" An internal error occurred while processing the request.

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/DeleteGroup

DeleteGroupRequest

func (c *ResourceGroups) DeleteGroupRequest(input *DeleteGroupInput) (req *request.Request, output *DeleteGroupOutput)

DeleteGroupRequest generates a "aws/request.Request" representing the client's request for the DeleteGroup operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteGroup for more information on using the DeleteGroup API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteGroupRequest method. req, resp := client.DeleteGroupRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/DeleteGroup

DeleteGroupWithContext

func (c *ResourceGroups) DeleteGroupWithContext(ctx aws.Context, input *DeleteGroupInput, opts ...request.Option) (*DeleteGroupOutput, error)

DeleteGroupWithContext is the same as DeleteGroup with the addition of the ability to pass a context and additional request options.

See DeleteGroup for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetGroup

func (c *ResourceGroups) GetGroup(input *GetGroupInput) (*GetGroupOutput, error)

GetGroup API operation for AWS Resource Groups.

Returns information about a specified resource group.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Resource Groups's API operation GetGroup for usage and error information.

Returned Error Codes:

  • ErrCodeBadRequestException "BadRequestException" The request does not comply with validation rules that are defined for the request parameters.

  • ErrCodeForbiddenException "ForbiddenException" The caller is not authorized to make the request.

  • ErrCodeNotFoundException "NotFoundException" One or more resources specified in the request do not exist.

  • ErrCodeMethodNotAllowedException "MethodNotAllowedException" The request uses an HTTP method which is not allowed for the specified resource.

  • ErrCodeTooManyRequestsException "TooManyRequestsException" The caller has exceeded throttling limits.

  • ErrCodeInternalServerErrorException "InternalServerErrorException" An internal error occurred while processing the request.

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/GetGroup

GetGroupQuery

func (c *ResourceGroups) GetGroupQuery(input *GetGroupQueryInput) (*GetGroupQueryOutput, error)

GetGroupQuery API operation for AWS Resource Groups.

Returns the resource query associated with the specified resource group.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Resource Groups's API operation GetGroupQuery for usage and error information.

Returned Error Codes:

  • ErrCodeBadRequestException "BadRequestException" The request does not comply with validation rules that are defined for the request parameters.

  • ErrCodeForbiddenException "ForbiddenException" The caller is not authorized to make the request.

  • ErrCodeNotFoundException "NotFoundException" One or more resources specified in the request do not exist.

  • ErrCodeMethodNotAllowedException "MethodNotAllowedException" The request uses an HTTP method which is not allowed for the specified resource.

  • ErrCodeTooManyRequestsException "TooManyRequestsException" The caller has exceeded throttling limits.

  • ErrCodeInternalServerErrorException "InternalServerErrorException" An internal error occurred while processing the request.

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/GetGroupQuery

GetGroupQueryRequest

func (c *ResourceGroups) GetGroupQueryRequest(input *GetGroupQueryInput) (req *request.Request, output *GetGroupQueryOutput)

GetGroupQueryRequest generates a "aws/request.Request" representing the client's request for the GetGroupQuery operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetGroupQuery for more information on using the GetGroupQuery API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetGroupQueryRequest method. req, resp := client.GetGroupQueryRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/GetGroupQuery

GetGroupQueryWithContext

func (c *ResourceGroups) GetGroupQueryWithContext(ctx aws.Context, input *GetGroupQueryInput, opts ...request.Option) (*GetGroupQueryOutput, error)

GetGroupQueryWithContext is the same as GetGroupQuery with the addition of the ability to pass a context and additional request options.

See GetGroupQuery for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetGroupRequest

func (c *ResourceGroups) GetGroupRequest(input *GetGroupInput) (req *request.Request, output *GetGroupOutput)

GetGroupRequest generates a "aws/request.Request" representing the client's request for the GetGroup operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetGroup for more information on using the GetGroup API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetGroupRequest method. req, resp := client.GetGroupRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/GetGroup

GetGroupWithContext

func (c *ResourceGroups) GetGroupWithContext(ctx aws.Context, input *GetGroupInput, opts ...request.Option) (*GetGroupOutput, error)

GetGroupWithContext is the same as GetGroup with the addition of the ability to pass a context and additional request options.

See GetGroup for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

GetTags

func (c *ResourceGroups) GetTags(input *GetTagsInput) (*GetTagsOutput, error)

GetTags API operation for AWS Resource Groups.

Returns a list of tags that are associated with a resource, specified by an ARN.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Resource Groups's API operation GetTags for usage and error information.

Returned Error Codes:

  • ErrCodeBadRequestException "BadRequestException" The request does not comply with validation rules that are defined for the request parameters.

  • ErrCodeForbiddenException "ForbiddenException" The caller is not authorized to make the request.

  • ErrCodeNotFoundException "NotFoundException" One or more resources specified in the request do not exist.

  • ErrCodeMethodNotAllowedException "MethodNotAllowedException" The request uses an HTTP method which is not allowed for the specified resource.

  • ErrCodeTooManyRequestsException "TooManyRequestsException" The caller has exceeded throttling limits.

  • ErrCodeInternalServerErrorException "InternalServerErrorException" An internal error occurred while processing the request.

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/GetTags

GetTagsRequest

func (c *ResourceGroups) GetTagsRequest(input *GetTagsInput) (req *request.Request, output *GetTagsOutput)

GetTagsRequest generates a "aws/request.Request" representing the client's request for the GetTags operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetTags for more information on using the GetTags API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetTagsRequest method. req, resp := client.GetTagsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/GetTags

GetTagsWithContext

func (c *ResourceGroups) GetTagsWithContext(ctx aws.Context, input *GetTagsInput, opts ...request.Option) (*GetTagsOutput, error)

GetTagsWithContext is the same as GetTags with the addition of the ability to pass a context and additional request options.

See GetTags for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListGroupResources

func (c *ResourceGroups) ListGroupResources(input *ListGroupResourcesInput) (*ListGroupResourcesOutput, error)

ListGroupResources API operation for AWS Resource Groups.

Returns a list of ARNs of resources that are members of a specified resource group.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Resource Groups's API operation ListGroupResources for usage and error information.

Returned Error Codes:

  • ErrCodeUnauthorizedException "UnauthorizedException" The request has not been applied because it lacks valid authentication credentials for the target resource.

  • ErrCodeBadRequestException "BadRequestException" The request does not comply with validation rules that are defined for the request parameters.

  • ErrCodeForbiddenException "ForbiddenException" The caller is not authorized to make the request.

  • ErrCodeNotFoundException "NotFoundException" One or more resources specified in the request do not exist.

  • ErrCodeMethodNotAllowedException "MethodNotAllowedException" The request uses an HTTP method which is not allowed for the specified resource.

  • ErrCodeTooManyRequestsException "TooManyRequestsException" The caller has exceeded throttling limits.

  • ErrCodeInternalServerErrorException "InternalServerErrorException" An internal error occurred while processing the request.

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/ListGroupResources

ListGroupResourcesPages

func (c *ResourceGroups) ListGroupResourcesPages(input *ListGroupResourcesInput, fn func(*ListGroupResourcesOutput, bool) bool) error

ListGroupResourcesPages iterates over the pages of a ListGroupResources operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See ListGroupResources method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a ListGroupResources operation. pageNum := 0 err := client.ListGroupResourcesPages(params, func(page *ListGroupResourcesOutput, lastPage bool) bool { pageNum++ fmt.Println(page) return pageNum <= 3 })

See Also

For more information about using this API, see AWS API Documentation.

ListGroupResourcesPagesWithContext

func (c *ResourceGroups) ListGroupResourcesPagesWithContext(ctx aws.Context, input *ListGroupResourcesInput, fn func(*ListGroupResourcesOutput, bool) bool, opts ...request.Option) error

ListGroupResourcesPagesWithContext same as ListGroupResourcesPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListGroupResourcesRequest

func (c *ResourceGroups) ListGroupResourcesRequest(input *ListGroupResourcesInput) (req *request.Request, output *ListGroupResourcesOutput)

ListGroupResourcesRequest generates a "aws/request.Request" representing the client's request for the ListGroupResources operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListGroupResources for more information on using the ListGroupResources API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListGroupResourcesRequest method. req, resp := client.ListGroupResourcesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/ListGroupResources

ListGroupResourcesWithContext

func (c *ResourceGroups) ListGroupResourcesWithContext(ctx aws.Context, input *ListGroupResourcesInput, opts ...request.Option) (*ListGroupResourcesOutput, error)

ListGroupResourcesWithContext is the same as ListGroupResources with the addition of the ability to pass a context and additional request options.

See ListGroupResources for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListGroups

func (c *ResourceGroups) ListGroups(input *ListGroupsInput) (*ListGroupsOutput, error)

ListGroups API operation for AWS Resource Groups.

Returns a list of existing resource groups in your account.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Resource Groups's API operation ListGroups for usage and error information.

Returned Error Codes:

  • ErrCodeBadRequestException "BadRequestException" The request does not comply with validation rules that are defined for the request parameters.

  • ErrCodeForbiddenException "ForbiddenException" The caller is not authorized to make the request.

  • ErrCodeMethodNotAllowedException "MethodNotAllowedException" The request uses an HTTP method which is not allowed for the specified resource.

  • ErrCodeTooManyRequestsException "TooManyRequestsException" The caller has exceeded throttling limits.

  • ErrCodeInternalServerErrorException "InternalServerErrorException" An internal error occurred while processing the request.

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/ListGroups

ListGroupsPages

func (c *ResourceGroups) ListGroupsPages(input *ListGroupsInput, fn func(*ListGroupsOutput, bool) bool) error

ListGroupsPages iterates over the pages of a ListGroups operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See ListGroups method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a ListGroups operation. pageNum := 0 err := client.ListGroupsPages(params, func(page *ListGroupsOutput, lastPage bool) bool { pageNum++ fmt.Println(page) return pageNum <= 3 })

See Also

For more information about using this API, see AWS API Documentation.

ListGroupsPagesWithContext

func (c *ResourceGroups) ListGroupsPagesWithContext(ctx aws.Context, input *ListGroupsInput, fn func(*ListGroupsOutput, bool) bool, opts ...request.Option) error

ListGroupsPagesWithContext same as ListGroupsPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

ListGroupsRequest

func (c *ResourceGroups) ListGroupsRequest(input *ListGroupsInput) (req *request.Request, output *ListGroupsOutput)

ListGroupsRequest generates a "aws/request.Request" representing the client's request for the ListGroups operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListGroups for more information on using the ListGroups API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListGroupsRequest method. req, resp := client.ListGroupsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/ListGroups

ListGroupsWithContext

func (c *ResourceGroups) ListGroupsWithContext(ctx aws.Context, input *ListGroupsInput, opts ...request.Option) (*ListGroupsOutput, error)

ListGroupsWithContext is the same as ListGroups with the addition of the ability to pass a context and additional request options.

See ListGroups for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

SearchResources

func (c *ResourceGroups) SearchResources(input *SearchResourcesInput) (*SearchResourcesOutput, error)

SearchResources API operation for AWS Resource Groups.

Returns a list of AWS resource identifiers that matches a specified query. The query uses the same format as a resource query in a CreateGroup or UpdateGroupQuery operation.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Resource Groups's API operation SearchResources for usage and error information.

Returned Error Codes:

  • ErrCodeUnauthorizedException "UnauthorizedException" The request has not been applied because it lacks valid authentication credentials for the target resource.

  • ErrCodeBadRequestException "BadRequestException" The request does not comply with validation rules that are defined for the request parameters.

  • ErrCodeForbiddenException "ForbiddenException" The caller is not authorized to make the request.

  • ErrCodeMethodNotAllowedException "MethodNotAllowedException" The request uses an HTTP method which is not allowed for the specified resource.

  • ErrCodeTooManyRequestsException "TooManyRequestsException" The caller has exceeded throttling limits.

  • ErrCodeInternalServerErrorException "InternalServerErrorException" An internal error occurred while processing the request.

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/SearchResources

SearchResourcesPages

func (c *ResourceGroups) SearchResourcesPages(input *SearchResourcesInput, fn func(*SearchResourcesOutput, bool) bool) error

SearchResourcesPages iterates over the pages of a SearchResources operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See SearchResources method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a SearchResources operation. pageNum := 0 err := client.SearchResourcesPages(params, func(page *SearchResourcesOutput, lastPage bool) bool { pageNum++ fmt.Println(page) return pageNum <= 3 })

See Also

For more information about using this API, see AWS API Documentation.

SearchResourcesPagesWithContext

func (c *ResourceGroups) SearchResourcesPagesWithContext(ctx aws.Context, input *SearchResourcesInput, fn func(*SearchResourcesOutput, bool) bool, opts ...request.Option) error

SearchResourcesPagesWithContext same as SearchResourcesPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

SearchResourcesRequest

func (c *ResourceGroups) SearchResourcesRequest(input *SearchResourcesInput) (req *request.Request, output *SearchResourcesOutput)

SearchResourcesRequest generates a "aws/request.Request" representing the client's request for the SearchResources operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See SearchResources for more information on using the SearchResources API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the SearchResourcesRequest method. req, resp := client.SearchResourcesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/SearchResources

SearchResourcesWithContext

func (c *ResourceGroups) SearchResourcesWithContext(ctx aws.Context, input *SearchResourcesInput, opts ...request.Option) (*SearchResourcesOutput, error)

SearchResourcesWithContext is the same as SearchResources with the addition of the ability to pass a context and additional request options.

See SearchResources for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

Tag

func (c *ResourceGroups) Tag(input *TagInput) (*TagOutput, error)

Tag API operation for AWS Resource Groups.

Adds specified tags to a resource with the specified ARN. Existing tags on a resource are not changed if they are not specified in the request parameters.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Resource Groups's API operation Tag for usage and error information.

Returned Error Codes:

  • ErrCodeBadRequestException "BadRequestException" The request does not comply with validation rules that are defined for the request parameters.

  • ErrCodeForbiddenException "ForbiddenException" The caller is not authorized to make the request.

  • ErrCodeNotFoundException "NotFoundException" One or more resources specified in the request do not exist.

  • ErrCodeMethodNotAllowedException "MethodNotAllowedException" The request uses an HTTP method which is not allowed for the specified resource.

  • ErrCodeTooManyRequestsException "TooManyRequestsException" The caller has exceeded throttling limits.

  • ErrCodeInternalServerErrorException "InternalServerErrorException" An internal error occurred while processing the request.

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/Tag

TagRequest

func (c *ResourceGroups) TagRequest(input *TagInput) (req *request.Request, output *TagOutput)

TagRequest generates a "aws/request.Request" representing the client's request for the Tag operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See Tag for more information on using the Tag API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the TagRequest method. req, resp := client.TagRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/Tag

TagWithContext

func (c *ResourceGroups) TagWithContext(ctx aws.Context, input *TagInput, opts ...request.Option) (*TagOutput, error)

TagWithContext is the same as Tag with the addition of the ability to pass a context and additional request options.

See Tag for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

Untag

func (c *ResourceGroups) Untag(input *UntagInput) (*UntagOutput, error)

Untag API operation for AWS Resource Groups.

Deletes specified tags from a specified resource.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Resource Groups's API operation Untag for usage and error information.

Returned Error Codes:

  • ErrCodeBadRequestException "BadRequestException" The request does not comply with validation rules that are defined for the request parameters.

  • ErrCodeForbiddenException "ForbiddenException" The caller is not authorized to make the request.

  • ErrCodeNotFoundException "NotFoundException" One or more resources specified in the request do not exist.

  • ErrCodeMethodNotAllowedException "MethodNotAllowedException" The request uses an HTTP method which is not allowed for the specified resource.

  • ErrCodeTooManyRequestsException "TooManyRequestsException" The caller has exceeded throttling limits.

  • ErrCodeInternalServerErrorException "InternalServerErrorException" An internal error occurred while processing the request.

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/Untag

UntagRequest

func (c *ResourceGroups) UntagRequest(input *UntagInput) (req *request.Request, output *UntagOutput)

UntagRequest generates a "aws/request.Request" representing the client's request for the Untag operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See Untag for more information on using the Untag API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the UntagRequest method. req, resp := client.UntagRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/Untag

UntagWithContext

func (c *ResourceGroups) UntagWithContext(ctx aws.Context, input *UntagInput, opts ...request.Option) (*UntagOutput, error)

UntagWithContext is the same as Untag with the addition of the ability to pass a context and additional request options.

See Untag for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

UpdateGroup

func (c *ResourceGroups) UpdateGroup(input *UpdateGroupInput) (*UpdateGroupOutput, error)

UpdateGroup API operation for AWS Resource Groups.

Updates an existing group with a new or changed description. You cannot update the name of a resource group.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Resource Groups's API operation UpdateGroup for usage and error information.

Returned Error Codes:

  • ErrCodeBadRequestException "BadRequestException" The request does not comply with validation rules that are defined for the request parameters.

  • ErrCodeForbiddenException "ForbiddenException" The caller is not authorized to make the request.

  • ErrCodeNotFoundException "NotFoundException" One or more resources specified in the request do not exist.

  • ErrCodeMethodNotAllowedException "MethodNotAllowedException" The request uses an HTTP method which is not allowed for the specified resource.

  • ErrCodeTooManyRequestsException "TooManyRequestsException" The caller has exceeded throttling limits.

  • ErrCodeInternalServerErrorException "InternalServerErrorException" An internal error occurred while processing the request.

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/UpdateGroup

UpdateGroupQuery

func (c *ResourceGroups) UpdateGroupQuery(input *UpdateGroupQueryInput) (*UpdateGroupQueryOutput, error)

UpdateGroupQuery API operation for AWS Resource Groups.

Updates the resource query of a group.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for AWS Resource Groups's API operation UpdateGroupQuery for usage and error information.

Returned Error Codes:

  • ErrCodeBadRequestException "BadRequestException" The request does not comply with validation rules that are defined for the request parameters.

  • ErrCodeForbiddenException "ForbiddenException" The caller is not authorized to make the request.

  • ErrCodeNotFoundException "NotFoundException" One or more resources specified in the request do not exist.

  • ErrCodeMethodNotAllowedException "MethodNotAllowedException" The request uses an HTTP method which is not allowed for the specified resource.

  • ErrCodeTooManyRequestsException "TooManyRequestsException" The caller has exceeded throttling limits.

  • ErrCodeInternalServerErrorException "InternalServerErrorException" An internal error occurred while processing the request.

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/UpdateGroupQuery

UpdateGroupQueryRequest

func (c *ResourceGroups) UpdateGroupQueryRequest(input *UpdateGroupQueryInput) (req *request.Request, output *UpdateGroupQueryOutput)

UpdateGroupQueryRequest generates a "aws/request.Request" representing the client's request for the UpdateGroupQuery operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateGroupQuery for more information on using the UpdateGroupQuery API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the UpdateGroupQueryRequest method. req, resp := client.UpdateGroupQueryRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/UpdateGroupQuery

UpdateGroupQueryWithContext

func (c *ResourceGroups) UpdateGroupQueryWithContext(ctx aws.Context, input *UpdateGroupQueryInput, opts ...request.Option) (*UpdateGroupQueryOutput, error)

UpdateGroupQueryWithContext is the same as UpdateGroupQuery with the addition of the ability to pass a context and additional request options.

See UpdateGroupQuery for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

UpdateGroupRequest

func (c *ResourceGroups) UpdateGroupRequest(input *UpdateGroupInput) (req *request.Request, output *UpdateGroupOutput)

UpdateGroupRequest generates a "aws/request.Request" representing the client's request for the UpdateGroup operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UpdateGroup for more information on using the UpdateGroup API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the UpdateGroupRequest method. req, resp := client.UpdateGroupRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/resource-groups-2017-11-27/UpdateGroup

UpdateGroupWithContext

func (c *ResourceGroups) UpdateGroupWithContext(ctx aws.Context, input *UpdateGroupInput, opts ...request.Option) (*UpdateGroupOutput, error)

UpdateGroupWithContext is the same as UpdateGroup with the addition of the ability to pass a context and additional request options.

See UpdateGroup for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

See Also

For more information about using this API, see AWS API Documentation.

On this page: