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.

Macie

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

type Macie struct { *client.Client }

Macie provides the API operation methods for making requests to Amazon Macie. See this package's package overview docs for details on the service.

Macie 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

AssociateMemberAccount

func (c *Macie) AssociateMemberAccount(input *AssociateMemberAccountInput) (*AssociateMemberAccountOutput, error)

AssociateMemberAccount API operation for Amazon Macie.

Associates a specified AWS account with Amazon Macie as a member 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 Amazon Macie's API operation AssociateMemberAccount for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInputException "InvalidInputException" The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

  • ErrCodeLimitExceededException "LimitExceededException" The request was rejected because it attempted to create resources beyond the current AWS account limits. The error code describes the limit exceeded.

  • ErrCodeInternalException "InternalException" Internal server error.

See also, https://docs.aws.amazon.com/goto/WebAPI/macie-2017-12-19/AssociateMemberAccount

AssociateMemberAccountRequest

func (c *Macie) AssociateMemberAccountRequest(input *AssociateMemberAccountInput) (req *request.Request, output *AssociateMemberAccountOutput)

AssociateMemberAccountRequest generates a "aws/request.Request" representing the client's request for the AssociateMemberAccount 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 AssociateMemberAccount for more information on using the AssociateMemberAccount 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 AssociateMemberAccountRequest method. req, resp := client.AssociateMemberAccountRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/macie-2017-12-19/AssociateMemberAccount

AssociateMemberAccountWithContext

func (c *Macie) AssociateMemberAccountWithContext(ctx aws.Context, input *AssociateMemberAccountInput, opts ...request.Option) (*AssociateMemberAccountOutput, error)

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

See AssociateMemberAccount 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.

AssociateS3Resources

func (c *Macie) AssociateS3Resources(input *AssociateS3ResourcesInput) (*AssociateS3ResourcesOutput, error)

AssociateS3Resources API operation for Amazon Macie.

Associates specified S3 resources with Amazon Macie for monitoring and data classification. If memberAccountId isn't specified, the action associates specified S3 resources with Macie for the current master account. If memberAccountId is specified, the action associates specified S3 resources with Macie for the specified member 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 Amazon Macie's API operation AssociateS3Resources for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInputException "InvalidInputException" The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

  • ErrCodeAccessDeniedException "AccessDeniedException" You do not have required permissions to access the requested resource.

  • ErrCodeLimitExceededException "LimitExceededException" The request was rejected because it attempted to create resources beyond the current AWS account limits. The error code describes the limit exceeded.

  • ErrCodeInternalException "InternalException" Internal server error.

See also, https://docs.aws.amazon.com/goto/WebAPI/macie-2017-12-19/AssociateS3Resources

AssociateS3ResourcesRequest

func (c *Macie) AssociateS3ResourcesRequest(input *AssociateS3ResourcesInput) (req *request.Request, output *AssociateS3ResourcesOutput)

AssociateS3ResourcesRequest generates a "aws/request.Request" representing the client's request for the AssociateS3Resources 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 AssociateS3Resources for more information on using the AssociateS3Resources 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 AssociateS3ResourcesRequest method. req, resp := client.AssociateS3ResourcesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/macie-2017-12-19/AssociateS3Resources

AssociateS3ResourcesWithContext

func (c *Macie) AssociateS3ResourcesWithContext(ctx aws.Context, input *AssociateS3ResourcesInput, opts ...request.Option) (*AssociateS3ResourcesOutput, error)

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

See AssociateS3Resources 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.

DisassociateMemberAccount

func (c *Macie) DisassociateMemberAccount(input *DisassociateMemberAccountInput) (*DisassociateMemberAccountOutput, error)

DisassociateMemberAccount API operation for Amazon Macie.

Removes the specified member account from Amazon Macie.

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 Amazon Macie's API operation DisassociateMemberAccount for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInputException "InvalidInputException" The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

  • ErrCodeInternalException "InternalException" Internal server error.

See also, https://docs.aws.amazon.com/goto/WebAPI/macie-2017-12-19/DisassociateMemberAccount

DisassociateMemberAccountRequest

func (c *Macie) DisassociateMemberAccountRequest(input *DisassociateMemberAccountInput) (req *request.Request, output *DisassociateMemberAccountOutput)

DisassociateMemberAccountRequest generates a "aws/request.Request" representing the client's request for the DisassociateMemberAccount 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 DisassociateMemberAccount for more information on using the DisassociateMemberAccount 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 DisassociateMemberAccountRequest method. req, resp := client.DisassociateMemberAccountRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/macie-2017-12-19/DisassociateMemberAccount

DisassociateMemberAccountWithContext

func (c *Macie) DisassociateMemberAccountWithContext(ctx aws.Context, input *DisassociateMemberAccountInput, opts ...request.Option) (*DisassociateMemberAccountOutput, error)

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

See DisassociateMemberAccount 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.

DisassociateS3Resources

func (c *Macie) DisassociateS3Resources(input *DisassociateS3ResourcesInput) (*DisassociateS3ResourcesOutput, error)

DisassociateS3Resources API operation for Amazon Macie.

Removes specified S3 resources from being monitored by Amazon Macie. If memberAccountId isn't specified, the action removes specified S3 resources from Macie for the current master account. If memberAccountId is specified, the action removes specified S3 resources from Macie for the specified member 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 Amazon Macie's API operation DisassociateS3Resources for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInputException "InvalidInputException" The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

  • ErrCodeAccessDeniedException "AccessDeniedException" You do not have required permissions to access the requested resource.

  • ErrCodeInternalException "InternalException" Internal server error.

See also, https://docs.aws.amazon.com/goto/WebAPI/macie-2017-12-19/DisassociateS3Resources

DisassociateS3ResourcesRequest

func (c *Macie) DisassociateS3ResourcesRequest(input *DisassociateS3ResourcesInput) (req *request.Request, output *DisassociateS3ResourcesOutput)

DisassociateS3ResourcesRequest generates a "aws/request.Request" representing the client's request for the DisassociateS3Resources 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 DisassociateS3Resources for more information on using the DisassociateS3Resources 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 DisassociateS3ResourcesRequest method. req, resp := client.DisassociateS3ResourcesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/macie-2017-12-19/DisassociateS3Resources

DisassociateS3ResourcesWithContext

func (c *Macie) DisassociateS3ResourcesWithContext(ctx aws.Context, input *DisassociateS3ResourcesInput, opts ...request.Option) (*DisassociateS3ResourcesOutput, error)

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

See DisassociateS3Resources 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.

ListMemberAccounts

func (c *Macie) ListMemberAccounts(input *ListMemberAccountsInput) (*ListMemberAccountsOutput, error)

ListMemberAccounts API operation for Amazon Macie.

Lists all Amazon Macie member accounts for the current Amazon Macie master 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 Amazon Macie's API operation ListMemberAccounts for usage and error information.

Returned Error Codes:

  • ErrCodeInternalException "InternalException" Internal server error.

  • ErrCodeInvalidInputException "InvalidInputException" The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

See also, https://docs.aws.amazon.com/goto/WebAPI/macie-2017-12-19/ListMemberAccounts

ListMemberAccountsPages

func (c *Macie) ListMemberAccountsPages(input *ListMemberAccountsInput, fn func(*ListMemberAccountsOutput, bool) bool) error

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

See ListMemberAccounts 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 ListMemberAccounts operation. pageNum := 0 err := client.ListMemberAccountsPages(params, func(page *ListMemberAccountsOutput, lastPage bool) bool { pageNum++ fmt.Println(page) return pageNum <= 3 })

See Also

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

ListMemberAccountsPagesWithContext

func (c *Macie) ListMemberAccountsPagesWithContext(ctx aws.Context, input *ListMemberAccountsInput, fn func(*ListMemberAccountsOutput, bool) bool, opts ...request.Option) error

ListMemberAccountsPagesWithContext same as ListMemberAccountsPages 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.

ListMemberAccountsRequest

func (c *Macie) ListMemberAccountsRequest(input *ListMemberAccountsInput) (req *request.Request, output *ListMemberAccountsOutput)

ListMemberAccountsRequest generates a "aws/request.Request" representing the client's request for the ListMemberAccounts 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 ListMemberAccounts for more information on using the ListMemberAccounts 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 ListMemberAccountsRequest method. req, resp := client.ListMemberAccountsRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/macie-2017-12-19/ListMemberAccounts

ListMemberAccountsWithContext

func (c *Macie) ListMemberAccountsWithContext(ctx aws.Context, input *ListMemberAccountsInput, opts ...request.Option) (*ListMemberAccountsOutput, error)

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

See ListMemberAccounts 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.

ListS3Resources

func (c *Macie) ListS3Resources(input *ListS3ResourcesInput) (*ListS3ResourcesOutput, error)

ListS3Resources API operation for Amazon Macie.

Lists all the S3 resources associated with Amazon Macie. If memberAccountId isn't specified, the action lists the S3 resources associated with Amazon Macie for the current master account. If memberAccountId is specified, the action lists the S3 resources associated with Amazon Macie for the specified member 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 Amazon Macie's API operation ListS3Resources for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInputException "InvalidInputException" The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

  • ErrCodeAccessDeniedException "AccessDeniedException" You do not have required permissions to access the requested resource.

  • ErrCodeInternalException "InternalException" Internal server error.

See also, https://docs.aws.amazon.com/goto/WebAPI/macie-2017-12-19/ListS3Resources

ListS3ResourcesPages

func (c *Macie) ListS3ResourcesPages(input *ListS3ResourcesInput, fn func(*ListS3ResourcesOutput, bool) bool) error

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

See ListS3Resources 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 ListS3Resources operation. pageNum := 0 err := client.ListS3ResourcesPages(params, func(page *ListS3ResourcesOutput, lastPage bool) bool { pageNum++ fmt.Println(page) return pageNum <= 3 })

See Also

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

ListS3ResourcesPagesWithContext

func (c *Macie) ListS3ResourcesPagesWithContext(ctx aws.Context, input *ListS3ResourcesInput, fn func(*ListS3ResourcesOutput, bool) bool, opts ...request.Option) error

ListS3ResourcesPagesWithContext same as ListS3ResourcesPages 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.

ListS3ResourcesRequest

func (c *Macie) ListS3ResourcesRequest(input *ListS3ResourcesInput) (req *request.Request, output *ListS3ResourcesOutput)

ListS3ResourcesRequest generates a "aws/request.Request" representing the client's request for the ListS3Resources 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 ListS3Resources for more information on using the ListS3Resources 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 ListS3ResourcesRequest method. req, resp := client.ListS3ResourcesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/macie-2017-12-19/ListS3Resources

ListS3ResourcesWithContext

func (c *Macie) ListS3ResourcesWithContext(ctx aws.Context, input *ListS3ResourcesInput, opts ...request.Option) (*ListS3ResourcesOutput, error)

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

See ListS3Resources 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.

UpdateS3Resources

func (c *Macie) UpdateS3Resources(input *UpdateS3ResourcesInput) (*UpdateS3ResourcesOutput, error)

UpdateS3Resources API operation for Amazon Macie.

Updates the classification types for the specified S3 resources. If memberAccountId isn't specified, the action updates the classification types of the S3 resources associated with Amazon Macie for the current master account. If memberAccountId is specified, the action updates the classification types of the S3 resources associated with Amazon Macie for the specified member 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 Amazon Macie's API operation UpdateS3Resources for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidInputException "InvalidInputException" The request was rejected because an invalid or out-of-range value was supplied for an input parameter.

  • ErrCodeAccessDeniedException "AccessDeniedException" You do not have required permissions to access the requested resource.

  • ErrCodeInternalException "InternalException" Internal server error.

See also, https://docs.aws.amazon.com/goto/WebAPI/macie-2017-12-19/UpdateS3Resources

UpdateS3ResourcesRequest

func (c *Macie) UpdateS3ResourcesRequest(input *UpdateS3ResourcesInput) (req *request.Request, output *UpdateS3ResourcesOutput)

UpdateS3ResourcesRequest generates a "aws/request.Request" representing the client's request for the UpdateS3Resources 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 UpdateS3Resources for more information on using the UpdateS3Resources 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 UpdateS3ResourcesRequest method. req, resp := client.UpdateS3ResourcesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }

See also, https://docs.aws.amazon.com/goto/WebAPI/macie-2017-12-19/UpdateS3Resources

UpdateS3ResourcesWithContext

func (c *Macie) UpdateS3ResourcesWithContext(ctx aws.Context, input *UpdateS3ResourcesInput, opts ...request.Option) (*UpdateS3ResourcesOutput, error)

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

See UpdateS3Resources 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: