sms

package
v1.4.21-0...-9e5bedb Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 24, 2016 License: Apache-2.0 Imports: 7 Imported by: 0

Documentation

Overview

Package sms provides a client for AWS Server Migration Service.

Index

Examples

Constants

View Source
const (
	// ConnectorStatusHealthy is a ConnectorStatus enum value
	ConnectorStatusHealthy = "HEALTHY"

	// ConnectorStatusUnhealthy is a ConnectorStatus enum value
	ConnectorStatusUnhealthy = "UNHEALTHY"
)

Status of on-premise Connector

View Source
const (
	// LicenseTypeAws is a LicenseType enum value
	LicenseTypeAws = "AWS"

	// LicenseTypeByol is a LicenseType enum value
	LicenseTypeByol = "BYOL"
)

The license type to be used for the Amazon Machine Image (AMI) created after a successful ReplicationRun.

View Source
const (
	// ReplicationJobStatePending is a ReplicationJobState enum value
	ReplicationJobStatePending = "PENDING"

	// ReplicationJobStateActive is a ReplicationJobState enum value
	ReplicationJobStateActive = "ACTIVE"

	// ReplicationJobStateFailed is a ReplicationJobState enum value
	ReplicationJobStateFailed = "FAILED"

	// ReplicationJobStateDeleting is a ReplicationJobState enum value
	ReplicationJobStateDeleting = "DELETING"

	// ReplicationJobStateDeleted is a ReplicationJobState enum value
	ReplicationJobStateDeleted = "DELETED"
)

Current state of Replication Job

View Source
const (
	// ReplicationRunStatePending is a ReplicationRunState enum value
	ReplicationRunStatePending = "PENDING"

	// ReplicationRunStateMissed is a ReplicationRunState enum value
	ReplicationRunStateMissed = "MISSED"

	// ReplicationRunStateActive is a ReplicationRunState enum value
	ReplicationRunStateActive = "ACTIVE"

	// ReplicationRunStateFailed is a ReplicationRunState enum value
	ReplicationRunStateFailed = "FAILED"

	// ReplicationRunStateCompleted is a ReplicationRunState enum value
	ReplicationRunStateCompleted = "COMPLETED"

	// ReplicationRunStateDeleting is a ReplicationRunState enum value
	ReplicationRunStateDeleting = "DELETING"

	// ReplicationRunStateDeleted is a ReplicationRunState enum value
	ReplicationRunStateDeleted = "DELETED"
)

Current state of Replication Run

View Source
const (
	// ReplicationRunTypeOnDemand is a ReplicationRunType enum value
	ReplicationRunTypeOnDemand = "ON_DEMAND"

	// ReplicationRunTypeAutomatic is a ReplicationRunType enum value
	ReplicationRunTypeAutomatic = "AUTOMATIC"
)

Type of Replication Run

View Source
const (
	// ServerCatalogStatusNotImported is a ServerCatalogStatus enum value
	ServerCatalogStatusNotImported = "NOT_IMPORTED"

	// ServerCatalogStatusImporting is a ServerCatalogStatus enum value
	ServerCatalogStatusImporting = "IMPORTING"

	// ServerCatalogStatusAvailable is a ServerCatalogStatus enum value
	ServerCatalogStatusAvailable = "AVAILABLE"

	// ServerCatalogStatusDeleted is a ServerCatalogStatus enum value
	ServerCatalogStatusDeleted = "DELETED"

	// ServerCatalogStatusExpired is a ServerCatalogStatus enum value
	ServerCatalogStatusExpired = "EXPIRED"
)

Status of Server catalog

View Source
const (
	// ConnectorCapabilityVsphere is a ConnectorCapability enum value
	ConnectorCapabilityVsphere = "VSPHERE"
)

Capabilities for a Connector

View Source
const (
	// ServerTypeVirtualMachine is a ServerType enum value
	ServerTypeVirtualMachine = "VIRTUAL_MACHINE"
)

Type of server.

View Source
const ServiceName = "sms"

A ServiceName is the name of the service the client will make API calls to.

View Source
const (
	// VmManagerTypeVsphere is a VmManagerType enum value
	VmManagerTypeVsphere = "VSPHERE"
)

VM Management Product

Variables

This section is empty.

Functions

This section is empty.

Types

type Connector

type Connector struct {

	// Timestamp of an operation
	AssociatedOn *time.Time `locationName:"associatedOn" type:"timestamp" timestampFormat:"unix"`

	// List of Connector Capabilities
	CapabilityList []*string `locationName:"capabilityList" locationNameList:"item" type:"list"`

	// Unique Identifier for Connector
	ConnectorId *string `locationName:"connectorId" type:"string"`

	// Internet Protocol (IP) Address
	IpAddress *string `locationName:"ipAddress" type:"string"`

	// Hardware (MAC) address
	MacAddress *string `locationName:"macAddress" type:"string"`

	// Status of on-premise Connector
	Status *string `locationName:"status" type:"string" enum:"ConnectorStatus"`

	// Connector version string
	Version *string `locationName:"version" type:"string"`

	// Unique Identifier for VM Manager
	VmManagerId *string `locationName:"vmManagerId" type:"string"`

	// VM Manager Name
	VmManagerName *string `locationName:"vmManagerName" type:"string"`

	// VM Management Product
	VmManagerType *string `locationName:"vmManagerType" type:"string" enum:"VmManagerType"`
	// contains filtered or unexported fields
}

Object representing a Connector

func (Connector) GoString

func (s Connector) GoString() string

GoString returns the string representation

func (Connector) String

func (s Connector) String() string

String returns the string representation

type CreateReplicationJobInput

type CreateReplicationJobInput struct {

	// The description for a Replication Job/Run.
	Description *string `locationName:"description" type:"string"`

	// Interval between Replication Runs. This value is specified in hours, and
	// represents the time between consecutive Replication Runs.
	//
	// Frequency is a required field
	Frequency *int64 `locationName:"frequency" type:"integer" required:"true"`

	// The license type to be used for the Amazon Machine Image (AMI) created after
	// a successful ReplicationRun.
	LicenseType *string `locationName:"licenseType" type:"string" enum:"LicenseType"`

	// Name of service role in customer's account to be used by SMS service.
	RoleName *string `locationName:"roleName" type:"string"`

	// Timestamp of an operation
	//
	// SeedReplicationTime is a required field
	SeedReplicationTime *time.Time `locationName:"seedReplicationTime" type:"timestamp" timestampFormat:"unix" required:"true"`

	// Unique Identifier for a server
	//
	// ServerId is a required field
	ServerId *string `locationName:"serverId" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (CreateReplicationJobInput) GoString

func (s CreateReplicationJobInput) GoString() string

GoString returns the string representation

func (CreateReplicationJobInput) String

func (s CreateReplicationJobInput) String() string

String returns the string representation

func (*CreateReplicationJobInput) Validate

func (s *CreateReplicationJobInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CreateReplicationJobOutput

type CreateReplicationJobOutput struct {

	// The unique identifier for a Replication Job.
	ReplicationJobId *string `locationName:"replicationJobId" type:"string"`
	// contains filtered or unexported fields
}

func (CreateReplicationJobOutput) GoString

func (s CreateReplicationJobOutput) GoString() string

GoString returns the string representation

func (CreateReplicationJobOutput) String

String returns the string representation

type DeleteReplicationJobInput

type DeleteReplicationJobInput struct {

	// The unique identifier for a Replication Job.
	//
	// ReplicationJobId is a required field
	ReplicationJobId *string `locationName:"replicationJobId" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteReplicationJobInput) GoString

func (s DeleteReplicationJobInput) GoString() string

GoString returns the string representation

func (DeleteReplicationJobInput) String

func (s DeleteReplicationJobInput) String() string

String returns the string representation

func (*DeleteReplicationJobInput) Validate

func (s *DeleteReplicationJobInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteReplicationJobOutput

type DeleteReplicationJobOutput struct {
	// contains filtered or unexported fields
}

func (DeleteReplicationJobOutput) GoString

func (s DeleteReplicationJobOutput) GoString() string

GoString returns the string representation

func (DeleteReplicationJobOutput) String

String returns the string representation

type DeleteServerCatalogInput

type DeleteServerCatalogInput struct {
	// contains filtered or unexported fields
}

func (DeleteServerCatalogInput) GoString

func (s DeleteServerCatalogInput) GoString() string

GoString returns the string representation

func (DeleteServerCatalogInput) String

func (s DeleteServerCatalogInput) String() string

String returns the string representation

type DeleteServerCatalogOutput

type DeleteServerCatalogOutput struct {
	// contains filtered or unexported fields
}

func (DeleteServerCatalogOutput) GoString

func (s DeleteServerCatalogOutput) GoString() string

GoString returns the string representation

func (DeleteServerCatalogOutput) String

func (s DeleteServerCatalogOutput) String() string

String returns the string representation

type DisassociateConnectorInput

type DisassociateConnectorInput struct {

	// Unique Identifier for Connector
	//
	// ConnectorId is a required field
	ConnectorId *string `locationName:"connectorId" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DisassociateConnectorInput) GoString

func (s DisassociateConnectorInput) GoString() string

GoString returns the string representation

func (DisassociateConnectorInput) String

String returns the string representation

func (*DisassociateConnectorInput) Validate

func (s *DisassociateConnectorInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DisassociateConnectorOutput

type DisassociateConnectorOutput struct {
	// contains filtered or unexported fields
}

func (DisassociateConnectorOutput) GoString

func (s DisassociateConnectorOutput) GoString() string

GoString returns the string representation

func (DisassociateConnectorOutput) String

String returns the string representation

type GetConnectorsInput

type GetConnectorsInput struct {

	// The maximum number of results to return in one API call. If left empty, this
	// will default to 50.
	MaxResults *int64 `locationName:"maxResults" type:"integer"`

	// Pagination token to pass as input to API call
	NextToken *string `locationName:"nextToken" type:"string"`
	// contains filtered or unexported fields
}

func (GetConnectorsInput) GoString

func (s GetConnectorsInput) GoString() string

GoString returns the string representation

func (GetConnectorsInput) String

func (s GetConnectorsInput) String() string

String returns the string representation

type GetConnectorsOutput

type GetConnectorsOutput struct {

	// List of connectors
	ConnectorList []*Connector `locationName:"connectorList" locationNameList:"item" type:"list"`

	// Pagination token to pass as input to API call
	NextToken *string `locationName:"nextToken" type:"string"`
	// contains filtered or unexported fields
}

func (GetConnectorsOutput) GoString

func (s GetConnectorsOutput) GoString() string

GoString returns the string representation

func (GetConnectorsOutput) String

func (s GetConnectorsOutput) String() string

String returns the string representation

type GetReplicationJobsInput

type GetReplicationJobsInput struct {

	// The maximum number of results to return in one API call. If left empty, this
	// will default to 50.
	MaxResults *int64 `locationName:"maxResults" type:"integer"`

	// Pagination token to pass as input to API call
	NextToken *string `locationName:"nextToken" type:"string"`

	// The unique identifier for a Replication Job.
	ReplicationJobId *string `locationName:"replicationJobId" type:"string"`
	// contains filtered or unexported fields
}

func (GetReplicationJobsInput) GoString

func (s GetReplicationJobsInput) GoString() string

GoString returns the string representation

func (GetReplicationJobsInput) String

func (s GetReplicationJobsInput) String() string

String returns the string representation

type GetReplicationJobsOutput

type GetReplicationJobsOutput struct {

	// Pagination token to pass as input to API call
	NextToken *string `locationName:"nextToken" type:"string"`

	// List of Replication Jobs
	ReplicationJobList []*ReplicationJob `locationName:"replicationJobList" locationNameList:"item" type:"list"`
	// contains filtered or unexported fields
}

func (GetReplicationJobsOutput) GoString

func (s GetReplicationJobsOutput) GoString() string

GoString returns the string representation

func (GetReplicationJobsOutput) String

func (s GetReplicationJobsOutput) String() string

String returns the string representation

type GetReplicationRunsInput

type GetReplicationRunsInput struct {

	// The maximum number of results to return in one API call. If left empty, this
	// will default to 50.
	MaxResults *int64 `locationName:"maxResults" type:"integer"`

	// Pagination token to pass as input to API call
	NextToken *string `locationName:"nextToken" type:"string"`

	// The unique identifier for a Replication Job.
	//
	// ReplicationJobId is a required field
	ReplicationJobId *string `locationName:"replicationJobId" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetReplicationRunsInput) GoString

func (s GetReplicationRunsInput) GoString() string

GoString returns the string representation

func (GetReplicationRunsInput) String

func (s GetReplicationRunsInput) String() string

String returns the string representation

func (*GetReplicationRunsInput) Validate

func (s *GetReplicationRunsInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetReplicationRunsOutput

type GetReplicationRunsOutput struct {

	// Pagination token to pass as input to API call
	NextToken *string `locationName:"nextToken" type:"string"`

	// Object representing a Replication Job
	ReplicationJob *ReplicationJob `locationName:"replicationJob" type:"structure"`

	// List of Replication Runs
	ReplicationRunList []*ReplicationRun `locationName:"replicationRunList" locationNameList:"item" type:"list"`
	// contains filtered or unexported fields
}

func (GetReplicationRunsOutput) GoString

func (s GetReplicationRunsOutput) GoString() string

GoString returns the string representation

func (GetReplicationRunsOutput) String

func (s GetReplicationRunsOutput) String() string

String returns the string representation

type GetServersInput

type GetServersInput struct {

	// The maximum number of results to return in one API call. If left empty, this
	// will default to 50.
	MaxResults *int64 `locationName:"maxResults" type:"integer"`

	// Pagination token to pass as input to API call
	NextToken *string `locationName:"nextToken" type:"string"`
	// contains filtered or unexported fields
}

func (GetServersInput) GoString

func (s GetServersInput) GoString() string

GoString returns the string representation

func (GetServersInput) String

func (s GetServersInput) String() string

String returns the string representation

type GetServersOutput

type GetServersOutput struct {

	// Timestamp of an operation
	LastModifiedOn *time.Time `locationName:"lastModifiedOn" type:"timestamp" timestampFormat:"unix"`

	// Pagination token to pass as input to API call
	NextToken *string `locationName:"nextToken" type:"string"`

	// Status of Server catalog
	ServerCatalogStatus *string `locationName:"serverCatalogStatus" type:"string" enum:"ServerCatalogStatus"`

	// List of servers from catalog
	ServerList []*Server `locationName:"serverList" locationNameList:"item" type:"list"`
	// contains filtered or unexported fields
}

func (GetServersOutput) GoString

func (s GetServersOutput) GoString() string

GoString returns the string representation

func (GetServersOutput) String

func (s GetServersOutput) String() string

String returns the string representation

type ImportServerCatalogInput

type ImportServerCatalogInput struct {
	// contains filtered or unexported fields
}

func (ImportServerCatalogInput) GoString

func (s ImportServerCatalogInput) GoString() string

GoString returns the string representation

func (ImportServerCatalogInput) String

func (s ImportServerCatalogInput) String() string

String returns the string representation

type ImportServerCatalogOutput

type ImportServerCatalogOutput struct {
	// contains filtered or unexported fields
}

func (ImportServerCatalogOutput) GoString

func (s ImportServerCatalogOutput) GoString() string

GoString returns the string representation

func (ImportServerCatalogOutput) String

func (s ImportServerCatalogOutput) String() string

String returns the string representation

type ReplicationJob

type ReplicationJob struct {

	// The description for a Replication Job/Run.
	Description *string `locationName:"description" type:"string"`

	// Interval between Replication Runs. This value is specified in hours, and
	// represents the time between consecutive Replication Runs.
	Frequency *int64 `locationName:"frequency" type:"integer"`

	// The AMI id for the image resulting from a Replication Run.
	LatestAmiId *string `locationName:"latestAmiId" type:"string"`

	// The license type to be used for the Amazon Machine Image (AMI) created after
	// a successful ReplicationRun.
	LicenseType *string `locationName:"licenseType" type:"string" enum:"LicenseType"`

	// Timestamp of an operation
	NextReplicationRunStartTime *time.Time `locationName:"nextReplicationRunStartTime" type:"timestamp" timestampFormat:"unix"`

	// The unique identifier for a Replication Job.
	ReplicationJobId *string `locationName:"replicationJobId" type:"string"`

	// List of Replication Runs
	ReplicationRunList []*ReplicationRun `locationName:"replicationRunList" locationNameList:"item" type:"list"`

	// Name of service role in customer's account to be used by SMS service.
	RoleName *string `locationName:"roleName" type:"string"`

	// Timestamp of an operation
	SeedReplicationTime *time.Time `locationName:"seedReplicationTime" type:"timestamp" timestampFormat:"unix"`

	// Unique Identifier for a server
	ServerId *string `locationName:"serverId" type:"string"`

	// Type of server.
	ServerType *string `locationName:"serverType" type:"string" enum:"ServerType"`

	// Current state of Replication Job
	State *string `locationName:"state" type:"string" enum:"ReplicationJobState"`

	// String describing current status of Replication Job
	StatusMessage *string `locationName:"statusMessage" type:"string"`

	// Object representing a VM server
	VmServer *VmServer `locationName:"vmServer" type:"structure"`
	// contains filtered or unexported fields
}

Object representing a Replication Job

func (ReplicationJob) GoString

func (s ReplicationJob) GoString() string

GoString returns the string representation

func (ReplicationJob) String

func (s ReplicationJob) String() string

String returns the string representation

type ReplicationRun

type ReplicationRun struct {

	// The AMI id for the image resulting from a Replication Run.
	AmiId *string `locationName:"amiId" type:"string"`

	// Timestamp of an operation
	CompletedTime *time.Time `locationName:"completedTime" type:"timestamp" timestampFormat:"unix"`

	// The description for a Replication Job/Run.
	Description *string `locationName:"description" type:"string"`

	// The unique identifier for a Replication Run.
	ReplicationRunId *string `locationName:"replicationRunId" type:"string"`

	// Timestamp of an operation
	ScheduledStartTime *time.Time `locationName:"scheduledStartTime" type:"timestamp" timestampFormat:"unix"`

	// Current state of Replication Run
	State *string `locationName:"state" type:"string" enum:"ReplicationRunState"`

	// String describing current status of Replication Run
	StatusMessage *string `locationName:"statusMessage" type:"string"`

	// Type of Replication Run
	Type *string `locationName:"type" type:"string" enum:"ReplicationRunType"`
	// contains filtered or unexported fields
}

Object representing a Replication Run

func (ReplicationRun) GoString

func (s ReplicationRun) GoString() string

GoString returns the string representation

func (ReplicationRun) String

func (s ReplicationRun) String() string

String returns the string representation

type SMS

type SMS struct {
	*client.Client
}

Amazon Server Migration Service automates the process of migrating servers to EC2. The service client's operations are safe to be used concurrently. It is not safe to mutate any of the client's properties though.

func New

func New(p client.ConfigProvider, cfgs ...*aws.Config) *SMS

New creates a new instance of the SMS client with a session. If additional configuration is needed for the client instance use the optional aws.Config parameter to add your extra config.

Example:

// Create a SMS client from just a session.
svc := sms.New(mySession)

// Create a SMS client with additional configuration
svc := sms.New(mySession, aws.NewConfig().WithRegion("us-west-2"))

func (*SMS) CreateReplicationJob

func (c *SMS) CreateReplicationJob(input *CreateReplicationJobInput) (*CreateReplicationJobOutput, error)

CreateReplicationJob API operation for AWS Server Migration Service.

The CreateReplicationJob API is used to create a ReplicationJob to replicate a server on AWS. Call this API to first create a ReplicationJob, which will then schedule periodic ReplicationRuns to replicate your server to AWS. Each ReplicationRun will result in the creation of an AWS AMI.

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 Server Migration Service's API operation CreateReplicationJob for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter specified in the request is not valid, is unsupported, or cannot be used.

  • MissingRequiredParameterException The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request.

  • UnauthorizedOperationException This user does not have permissions to perform this operation.

  • OperationNotPermittedException The specified operation is not allowed. This error can occur for a number of reasons; for example, you might be trying to start a Replication Run before seed Replication Run.

  • ServerCannotBeReplicatedException The provided server cannot be replicated.

  • ReplicationJobAlreadyExistsException An active Replication Job already exists for the specified server.

  • NoConnectorsAvailableException No connectors are available to handle this request. Please associate connector(s) and verify any existing connectors are healthy and can respond to requests.

  • InternalError An internal error has occured.

Example
package main

import (
	"fmt"
	"time"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/sms"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := sms.New(sess)

	params := &sms.CreateReplicationJobInput{
		Frequency:           aws.Int64(1),           // Required
		SeedReplicationTime: aws.Time(time.Now()),   // Required
		ServerId:            aws.String("ServerId"), // Required
		Description:         aws.String("Description"),
		LicenseType:         aws.String("LicenseType"),
		RoleName:            aws.String("RoleName"),
	}
	resp, err := svc.CreateReplicationJob(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*SMS) CreateReplicationJobRequest

func (c *SMS) CreateReplicationJobRequest(input *CreateReplicationJobInput) (req *request.Request, output *CreateReplicationJobOutput)

CreateReplicationJobRequest generates a "aws/request.Request" representing the client's request for the CreateReplicationJob operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See CreateReplicationJob for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CreateReplicationJob method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the CreateReplicationJobRequest method.
req, resp := client.CreateReplicationJobRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*SMS) DeleteReplicationJob

func (c *SMS) DeleteReplicationJob(input *DeleteReplicationJobInput) (*DeleteReplicationJobOutput, error)

DeleteReplicationJob API operation for AWS Server Migration Service.

The DeleteReplicationJob API is used to delete a ReplicationJob, resulting in no further ReplicationRuns. This will delete the contents of the S3 bucket used to store SMS artifacts, but will not delete any AMIs created by the SMS service.

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 Server Migration Service's API operation DeleteReplicationJob for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter specified in the request is not valid, is unsupported, or cannot be used.

  • MissingRequiredParameterException The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request.

  • UnauthorizedOperationException This user does not have permissions to perform this operation.

  • OperationNotPermittedException The specified operation is not allowed. This error can occur for a number of reasons; for example, you might be trying to start a Replication Run before seed Replication Run.

  • ReplicationJobNotFoundException The specified Replication Job cannot be found.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/sms"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := sms.New(sess)

	params := &sms.DeleteReplicationJobInput{
		ReplicationJobId: aws.String("ReplicationJobId"), // Required
	}
	resp, err := svc.DeleteReplicationJob(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*SMS) DeleteReplicationJobRequest

func (c *SMS) DeleteReplicationJobRequest(input *DeleteReplicationJobInput) (req *request.Request, output *DeleteReplicationJobOutput)

DeleteReplicationJobRequest generates a "aws/request.Request" representing the client's request for the DeleteReplicationJob operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DeleteReplicationJob for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteReplicationJob method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the DeleteReplicationJobRequest method.
req, resp := client.DeleteReplicationJobRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*SMS) DeleteServerCatalog

func (c *SMS) DeleteServerCatalog(input *DeleteServerCatalogInput) (*DeleteServerCatalogOutput, error)

DeleteServerCatalog API operation for AWS Server Migration Service.

The DeleteServerCatalog API clears all servers from your server catalog. This means that these servers will no longer be accessible to the Server Migration Service.

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 Server Migration Service's API operation DeleteServerCatalog for usage and error information.

Returned Error Codes:

  • UnauthorizedOperationException This user does not have permissions to perform this operation.

  • OperationNotPermittedException The specified operation is not allowed. This error can occur for a number of reasons; for example, you might be trying to start a Replication Run before seed Replication Run.

  • InvalidParameterException A parameter specified in the request is not valid, is unsupported, or cannot be used.

  • MissingRequiredParameterException The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/sms"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := sms.New(sess)

	var params *sms.DeleteServerCatalogInput
	resp, err := svc.DeleteServerCatalog(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*SMS) DeleteServerCatalogRequest

func (c *SMS) DeleteServerCatalogRequest(input *DeleteServerCatalogInput) (req *request.Request, output *DeleteServerCatalogOutput)

DeleteServerCatalogRequest generates a "aws/request.Request" representing the client's request for the DeleteServerCatalog operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DeleteServerCatalog for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteServerCatalog method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the DeleteServerCatalogRequest method.
req, resp := client.DeleteServerCatalogRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*SMS) DisassociateConnector

func (c *SMS) DisassociateConnector(input *DisassociateConnectorInput) (*DisassociateConnectorOutput, error)

DisassociateConnector API operation for AWS Server Migration Service.

The DisassociateConnector API will disassociate a connector from the Server Migration Service, rendering it unavailable to support replication jobs.

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 Server Migration Service's API operation DisassociateConnector for usage and error information.

Returned Error Codes:

  • MissingRequiredParameterException The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request.

  • UnauthorizedOperationException This user does not have permissions to perform this operation.

  • OperationNotPermittedException The specified operation is not allowed. This error can occur for a number of reasons; for example, you might be trying to start a Replication Run before seed Replication Run.

  • InvalidParameterException A parameter specified in the request is not valid, is unsupported, or cannot be used.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/sms"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := sms.New(sess)

	params := &sms.DisassociateConnectorInput{
		ConnectorId: aws.String("ConnectorId"), // Required
	}
	resp, err := svc.DisassociateConnector(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*SMS) DisassociateConnectorRequest

func (c *SMS) DisassociateConnectorRequest(input *DisassociateConnectorInput) (req *request.Request, output *DisassociateConnectorOutput)

DisassociateConnectorRequest generates a "aws/request.Request" representing the client's request for the DisassociateConnector operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See DisassociateConnector for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DisassociateConnector method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the DisassociateConnectorRequest method.
req, resp := client.DisassociateConnectorRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*SMS) GetConnectors

func (c *SMS) GetConnectors(input *GetConnectorsInput) (*GetConnectorsOutput, error)

GetConnectors API operation for AWS Server Migration Service.

The GetConnectors API returns a list of connectors that are registered with the Server Migration Service.

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 Server Migration Service's API operation GetConnectors for usage and error information.

Returned Error Codes:

  • UnauthorizedOperationException This user does not have permissions to perform this operation.
Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/sms"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := sms.New(sess)

	params := &sms.GetConnectorsInput{
		MaxResults: aws.Int64(1),
		NextToken:  aws.String("NextToken"),
	}
	resp, err := svc.GetConnectors(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*SMS) GetConnectorsPages

func (c *SMS) GetConnectorsPages(input *GetConnectorsInput, fn func(p *GetConnectorsOutput, lastPage bool) (shouldContinue bool)) error

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

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

func (*SMS) GetConnectorsRequest

func (c *SMS) GetConnectorsRequest(input *GetConnectorsInput) (req *request.Request, output *GetConnectorsOutput)

GetConnectorsRequest generates a "aws/request.Request" representing the client's request for the GetConnectors operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See GetConnectors for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetConnectors method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the GetConnectorsRequest method.
req, resp := client.GetConnectorsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*SMS) GetReplicationJobs

func (c *SMS) GetReplicationJobs(input *GetReplicationJobsInput) (*GetReplicationJobsOutput, error)

GetReplicationJobs API operation for AWS Server Migration Service.

The GetReplicationJobs API will return all of your ReplicationJobs and their details. This API returns a paginated list, that may be consecutively called with nextToken to retrieve all ReplicationJobs.

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 Server Migration Service's API operation GetReplicationJobs for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter specified in the request is not valid, is unsupported, or cannot be used.

  • MissingRequiredParameterException The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request.

  • UnauthorizedOperationException This user does not have permissions to perform this operation.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/sms"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := sms.New(sess)

	params := &sms.GetReplicationJobsInput{
		MaxResults:       aws.Int64(1),
		NextToken:        aws.String("NextToken"),
		ReplicationJobId: aws.String("ReplicationJobId"),
	}
	resp, err := svc.GetReplicationJobs(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*SMS) GetReplicationJobsPages

func (c *SMS) GetReplicationJobsPages(input *GetReplicationJobsInput, fn func(p *GetReplicationJobsOutput, lastPage bool) (shouldContinue bool)) error

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

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

func (*SMS) GetReplicationJobsRequest

func (c *SMS) GetReplicationJobsRequest(input *GetReplicationJobsInput) (req *request.Request, output *GetReplicationJobsOutput)

GetReplicationJobsRequest generates a "aws/request.Request" representing the client's request for the GetReplicationJobs operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See GetReplicationJobs for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetReplicationJobs method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the GetReplicationJobsRequest method.
req, resp := client.GetReplicationJobsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*SMS) GetReplicationRuns

func (c *SMS) GetReplicationRuns(input *GetReplicationRunsInput) (*GetReplicationRunsOutput, error)

GetReplicationRuns API operation for AWS Server Migration Service.

The GetReplicationRuns API will return all ReplicationRuns for a given ReplicationJob. This API returns a paginated list, that may be consecutively called with nextToken to retrieve all ReplicationRuns for a ReplicationJob.

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 Server Migration Service's API operation GetReplicationRuns for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter specified in the request is not valid, is unsupported, or cannot be used.

  • MissingRequiredParameterException The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request.

  • UnauthorizedOperationException This user does not have permissions to perform this operation.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/sms"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := sms.New(sess)

	params := &sms.GetReplicationRunsInput{
		ReplicationJobId: aws.String("ReplicationJobId"), // Required
		MaxResults:       aws.Int64(1),
		NextToken:        aws.String("NextToken"),
	}
	resp, err := svc.GetReplicationRuns(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*SMS) GetReplicationRunsPages

func (c *SMS) GetReplicationRunsPages(input *GetReplicationRunsInput, fn func(p *GetReplicationRunsOutput, lastPage bool) (shouldContinue bool)) error

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

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

func (*SMS) GetReplicationRunsRequest

func (c *SMS) GetReplicationRunsRequest(input *GetReplicationRunsInput) (req *request.Request, output *GetReplicationRunsOutput)

GetReplicationRunsRequest generates a "aws/request.Request" representing the client's request for the GetReplicationRuns operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See GetReplicationRuns for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetReplicationRuns method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the GetReplicationRunsRequest method.
req, resp := client.GetReplicationRunsRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*SMS) GetServers

func (c *SMS) GetServers(input *GetServersInput) (*GetServersOutput, error)

GetServers API operation for AWS Server Migration Service.

The GetServers API returns a list of all servers in your server catalog. For this call to succeed, you must previously have called ImportServerCatalog.

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 Server Migration Service's API operation GetServers for usage and error information.

Returned Error Codes:

  • UnauthorizedOperationException This user does not have permissions to perform this operation.
Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/sms"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := sms.New(sess)

	params := &sms.GetServersInput{
		MaxResults: aws.Int64(1),
		NextToken:  aws.String("NextToken"),
	}
	resp, err := svc.GetServers(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*SMS) GetServersPages

func (c *SMS) GetServersPages(input *GetServersInput, fn func(p *GetServersOutput, lastPage bool) (shouldContinue bool)) error

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

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

func (*SMS) GetServersRequest

func (c *SMS) GetServersRequest(input *GetServersInput) (req *request.Request, output *GetServersOutput)

GetServersRequest generates a "aws/request.Request" representing the client's request for the GetServers operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See GetServers for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetServers method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the GetServersRequest method.
req, resp := client.GetServersRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*SMS) ImportServerCatalog

func (c *SMS) ImportServerCatalog(input *ImportServerCatalogInput) (*ImportServerCatalogOutput, error)

ImportServerCatalog API operation for AWS Server Migration Service.

The ImportServerCatalog API is used to gather the complete list of on-premises servers on your premises. This API call requires connectors to be installed and monitoring all servers you would like imported. This API call returns immediately, but may take some time to retrieve all of the servers.

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 Server Migration Service's API operation ImportServerCatalog for usage and error information.

Returned Error Codes:

  • UnauthorizedOperationException This user does not have permissions to perform this operation.

  • OperationNotPermittedException The specified operation is not allowed. This error can occur for a number of reasons; for example, you might be trying to start a Replication Run before seed Replication Run.

  • InvalidParameterException A parameter specified in the request is not valid, is unsupported, or cannot be used.

  • MissingRequiredParameterException The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request.

  • NoConnectorsAvailableException No connectors are available to handle this request. Please associate connector(s) and verify any existing connectors are healthy and can respond to requests.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/sms"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := sms.New(sess)

	var params *sms.ImportServerCatalogInput
	resp, err := svc.ImportServerCatalog(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*SMS) ImportServerCatalogRequest

func (c *SMS) ImportServerCatalogRequest(input *ImportServerCatalogInput) (req *request.Request, output *ImportServerCatalogOutput)

ImportServerCatalogRequest generates a "aws/request.Request" representing the client's request for the ImportServerCatalog operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See ImportServerCatalog for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the ImportServerCatalog method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the ImportServerCatalogRequest method.
req, resp := client.ImportServerCatalogRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*SMS) StartOnDemandReplicationRun

func (c *SMS) StartOnDemandReplicationRun(input *StartOnDemandReplicationRunInput) (*StartOnDemandReplicationRunOutput, error)

StartOnDemandReplicationRun API operation for AWS Server Migration Service.

The StartOnDemandReplicationRun API is used to start a ReplicationRun on demand (in addition to those that are scheduled based on your frequency). This ReplicationRun will start immediately. StartOnDemandReplicationRun is subject to limits on how many on demand ReplicationRuns you may call per 24-hour period.

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 Server Migration Service's API operation StartOnDemandReplicationRun for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter specified in the request is not valid, is unsupported, or cannot be used.

  • MissingRequiredParameterException The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request.

  • UnauthorizedOperationException This user does not have permissions to perform this operation.

  • OperationNotPermittedException The specified operation is not allowed. This error can occur for a number of reasons; for example, you might be trying to start a Replication Run before seed Replication Run.

  • ReplicationRunLimitExceededException This user has exceeded the maximum allowed Replication Run limit.

Example
package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/sms"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := sms.New(sess)

	params := &sms.StartOnDemandReplicationRunInput{
		ReplicationJobId: aws.String("ReplicationJobId"), // Required
		Description:      aws.String("Description"),
	}
	resp, err := svc.StartOnDemandReplicationRun(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*SMS) StartOnDemandReplicationRunRequest

func (c *SMS) StartOnDemandReplicationRunRequest(input *StartOnDemandReplicationRunInput) (req *request.Request, output *StartOnDemandReplicationRunOutput)

StartOnDemandReplicationRunRequest generates a "aws/request.Request" representing the client's request for the StartOnDemandReplicationRun operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See StartOnDemandReplicationRun for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the StartOnDemandReplicationRun method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the StartOnDemandReplicationRunRequest method.
req, resp := client.StartOnDemandReplicationRunRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

func (*SMS) UpdateReplicationJob

func (c *SMS) UpdateReplicationJob(input *UpdateReplicationJobInput) (*UpdateReplicationJobOutput, error)

UpdateReplicationJob API operation for AWS Server Migration Service.

The UpdateReplicationJob API is used to change the settings of your existing ReplicationJob created using CreateReplicationJob. Calling this API will affect the next scheduled ReplicationRun.

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 Server Migration Service's API operation UpdateReplicationJob for usage and error information.

Returned Error Codes:

  • InvalidParameterException A parameter specified in the request is not valid, is unsupported, or cannot be used.

  • MissingRequiredParameterException The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request.

  • OperationNotPermittedException The specified operation is not allowed. This error can occur for a number of reasons; for example, you might be trying to start a Replication Run before seed Replication Run.

  • UnauthorizedOperationException This user does not have permissions to perform this operation.

  • ServerCannotBeReplicatedException The provided server cannot be replicated.

  • ReplicationJobNotFoundException The specified Replication Job cannot be found.

  • InternalError An internal error has occured.

Example
package main

import (
	"fmt"
	"time"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/sms"
)

func main() {
	sess, err := session.NewSession()
	if err != nil {
		fmt.Println("failed to create session,", err)
		return
	}

	svc := sms.New(sess)

	params := &sms.UpdateReplicationJobInput{
		ReplicationJobId:            aws.String("ReplicationJobId"), // Required
		Description:                 aws.String("Description"),
		Frequency:                   aws.Int64(1),
		LicenseType:                 aws.String("LicenseType"),
		NextReplicationRunStartTime: aws.Time(time.Now()),
		RoleName:                    aws.String("RoleName"),
	}
	resp, err := svc.UpdateReplicationJob(params)

	if err != nil {
		// Print the error, cast err to awserr.Error to get the Code and
		// Message from an error.
		fmt.Println(err.Error())
		return
	}

	// Pretty-print the response data.
	fmt.Println(resp)
}
Output:

func (*SMS) UpdateReplicationJobRequest

func (c *SMS) UpdateReplicationJobRequest(input *UpdateReplicationJobInput) (req *request.Request, output *UpdateReplicationJobOutput)

UpdateReplicationJobRequest generates a "aws/request.Request" representing the client's request for the UpdateReplicationJob operation. The "output" return value can be used to capture response data after the request's "Send" method is called.

See UpdateReplicationJob for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the UpdateReplicationJob method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request.

// Example sending a request using the UpdateReplicationJobRequest method.
req, resp := client.UpdateReplicationJobRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

type Server

type Server struct {

	// The unique identifier for a Replication Job.
	ReplicationJobId *string `locationName:"replicationJobId" type:"string"`

	// An indicator of the Replication Job being deleted or failed.
	ReplicationJobTerminated *bool `locationName:"replicationJobTerminated" type:"boolean"`

	// Unique Identifier for a server
	ServerId *string `locationName:"serverId" type:"string"`

	// Type of server.
	ServerType *string `locationName:"serverType" type:"string" enum:"ServerType"`

	// Object representing a VM server
	VmServer *VmServer `locationName:"vmServer" type:"structure"`
	// contains filtered or unexported fields
}

Object representing a server

func (Server) GoString

func (s Server) GoString() string

GoString returns the string representation

func (Server) String

func (s Server) String() string

String returns the string representation

type StartOnDemandReplicationRunInput

type StartOnDemandReplicationRunInput struct {

	// The description for a Replication Job/Run.
	Description *string `locationName:"description" type:"string"`

	// The unique identifier for a Replication Job.
	//
	// ReplicationJobId is a required field
	ReplicationJobId *string `locationName:"replicationJobId" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (StartOnDemandReplicationRunInput) GoString

GoString returns the string representation

func (StartOnDemandReplicationRunInput) String

String returns the string representation

func (*StartOnDemandReplicationRunInput) Validate

Validate inspects the fields of the type to determine if they are valid.

type StartOnDemandReplicationRunOutput

type StartOnDemandReplicationRunOutput struct {

	// The unique identifier for a Replication Run.
	ReplicationRunId *string `locationName:"replicationRunId" type:"string"`
	// contains filtered or unexported fields
}

func (StartOnDemandReplicationRunOutput) GoString

GoString returns the string representation

func (StartOnDemandReplicationRunOutput) String

String returns the string representation

type UpdateReplicationJobInput

type UpdateReplicationJobInput struct {

	// The description for a Replication Job/Run.
	Description *string `locationName:"description" type:"string"`

	// Interval between Replication Runs. This value is specified in hours, and
	// represents the time between consecutive Replication Runs.
	Frequency *int64 `locationName:"frequency" type:"integer"`

	// The license type to be used for the Amazon Machine Image (AMI) created after
	// a successful ReplicationRun.
	LicenseType *string `locationName:"licenseType" type:"string" enum:"LicenseType"`

	// Timestamp of an operation
	NextReplicationRunStartTime *time.Time `locationName:"nextReplicationRunStartTime" type:"timestamp" timestampFormat:"unix"`

	// The unique identifier for a Replication Job.
	//
	// ReplicationJobId is a required field
	ReplicationJobId *string `locationName:"replicationJobId" type:"string" required:"true"`

	// Name of service role in customer's account to be used by SMS service.
	RoleName *string `locationName:"roleName" type:"string"`
	// contains filtered or unexported fields
}

func (UpdateReplicationJobInput) GoString

func (s UpdateReplicationJobInput) GoString() string

GoString returns the string representation

func (UpdateReplicationJobInput) String

func (s UpdateReplicationJobInput) String() string

String returns the string representation

func (*UpdateReplicationJobInput) Validate

func (s *UpdateReplicationJobInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type UpdateReplicationJobOutput

type UpdateReplicationJobOutput struct {
	// contains filtered or unexported fields
}

func (UpdateReplicationJobOutput) GoString

func (s UpdateReplicationJobOutput) GoString() string

GoString returns the string representation

func (UpdateReplicationJobOutput) String

String returns the string representation

type VmServer

type VmServer struct {

	// VM Manager Name
	VmManagerName *string `locationName:"vmManagerName" type:"string"`

	// VM Management Product
	VmManagerType *string `locationName:"vmManagerType" type:"string" enum:"VmManagerType"`

	// Name of Virtual Machine
	VmName *string `locationName:"vmName" type:"string"`

	// Path to VM
	VmPath *string `locationName:"vmPath" type:"string"`

	// Object representing a server's location
	VmServerAddress *VmServerAddress `locationName:"vmServerAddress" type:"structure"`
	// contains filtered or unexported fields
}

Object representing a VM server

func (VmServer) GoString

func (s VmServer) GoString() string

GoString returns the string representation

func (VmServer) String

func (s VmServer) String() string

String returns the string representation

type VmServerAddress

type VmServerAddress struct {

	// Unique Identifier for a VM
	VmId *string `locationName:"vmId" type:"string"`

	// Unique Identifier for VM Manager
	VmManagerId *string `locationName:"vmManagerId" type:"string"`
	// contains filtered or unexported fields
}

Object representing a server's location

func (VmServerAddress) GoString

func (s VmServerAddress) GoString() string

GoString returns the string representation

func (VmServerAddress) String

func (s VmServerAddress) String() string

String returns the string representation

Directories

Path Synopsis
Package smsiface provides an interface to enable mocking the AWS Server Migration Service service client for testing your code.
Package smsiface provides an interface to enable mocking the AWS Server Migration Service service client for testing your code.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL