// Code generated by private/model/cli/gen-api/main.go. DO NOT EDIT.

package lakeformation

import (
	"context"

	"github.com/aws/aws-sdk-go-v2/aws"
	"github.com/aws/aws-sdk-go-v2/internal/awsutil"
)

type RegisterResourceInput struct {
	_ struct{} `type:"structure"`

	// The Amazon Resource Name (ARN) of the resource that you want to register.
	//
	// ResourceArn is a required field
	ResourceArn *string `type:"string" required:"true"`

	// The identifier for the role that registers the resource.
	RoleArn *string `type:"string"`

	// Designates an AWS Identity and Access Management (IAM) service-linked role
	// by registering this role with the Data Catalog. A service-linked role is
	// a unique type of IAM role that is linked directly to Lake Formation.
	//
	// For more information, see Using Service-Linked Roles for Lake Formation (https://docs-aws.amazon.com/lake-formation/latest/dg/service-linked-roles.html).
	UseServiceLinkedRole *bool `type:"boolean"`
}

// String returns the string representation
func (s RegisterResourceInput) String() string {
	return awsutil.Prettify(s)
}

// Validate inspects the fields of the type to determine if they are valid.
func (s *RegisterResourceInput) Validate() error {
	invalidParams := aws.ErrInvalidParams{Context: "RegisterResourceInput"}

	if s.ResourceArn == nil {
		invalidParams.Add(aws.NewErrParamRequired("ResourceArn"))
	}

	if invalidParams.Len() > 0 {
		return invalidParams
	}
	return nil
}

type RegisterResourceOutput struct {
	_ struct{} `type:"structure"`
}

// String returns the string representation
func (s RegisterResourceOutput) String() string {
	return awsutil.Prettify(s)
}

const opRegisterResource = "RegisterResource"

// RegisterResourceRequest returns a request value for making API operation for
// AWS Lake Formation.
//
// Registers the resource as managed by the Data Catalog.
//
// To add or update data, Lake Formation needs read/write access to the chosen
// Amazon S3 path. Choose a role that you know has permission to do this, or
// choose the AWSServiceRoleForLakeFormationDataAccess service-linked role.
// When you register the first Amazon S3 path, the service-linked role and a
// new inline policy are created on your behalf. Lake Formation adds the first
// path to the inline policy and attaches it to the service-linked role. When
// you register subsequent paths, Lake Formation adds the path to the existing
// policy.
//
// The following request registers a new location and gives AWS Lake Formation
// permission to use the service-linked role to access that location.
//
// ResourceArn = arn:aws:s3:::my-bucket UseServiceLinkedRole = true
//
// If UseServiceLinkedRole is not set to true, you must provide or set the RoleArn:
//
// arn:aws:iam::12345:role/my-data-access-role
//
//    // Example sending a request using RegisterResourceRequest.
//    req := client.RegisterResourceRequest(params)
//    resp, err := req.Send(context.TODO())
//    if err == nil {
//        fmt.Println(resp)
//    }
//
// Please also see https://docs.aws.amazon.com/goto/WebAPI/lakeformation-2017-03-31/RegisterResource
func (c *Client) RegisterResourceRequest(input *RegisterResourceInput) RegisterResourceRequest {
	op := &aws.Operation{
		Name:       opRegisterResource,
		HTTPMethod: "POST",
		HTTPPath:   "/",
	}

	if input == nil {
		input = &RegisterResourceInput{}
	}

	req := c.newRequest(op, input, &RegisterResourceOutput{})

	return RegisterResourceRequest{Request: req, Input: input, Copy: c.RegisterResourceRequest}
}

// RegisterResourceRequest is the request type for the
// RegisterResource API operation.
type RegisterResourceRequest struct {
	*aws.Request
	Input *RegisterResourceInput
	Copy  func(*RegisterResourceInput) RegisterResourceRequest
}

// Send marshals and sends the RegisterResource API request.
func (r RegisterResourceRequest) Send(ctx context.Context) (*RegisterResourceResponse, error) {
	r.Request.SetContext(ctx)
	err := r.Request.Send()
	if err != nil {
		return nil, err
	}

	resp := &RegisterResourceResponse{
		RegisterResourceOutput: r.Request.Data.(*RegisterResourceOutput),
		response:               &aws.Response{Request: r.Request},
	}

	return resp, nil
}

// RegisterResourceResponse is the response type for the
// RegisterResource API operation.
type RegisterResourceResponse struct {
	*RegisterResourceOutput

	response *aws.Response
}

// SDKResponseMetdata returns the response metadata for the
// RegisterResource request.
func (r *RegisterResourceResponse) SDKResponseMetdata() *aws.Response {
	return r.response
}