Class: AWS.Fis

var params = {
  accountId: 'STRING_VALUE', /* required */
  experimentTemplateId: 'STRING_VALUE', /* required */
  roleArn: 'STRING_VALUE', /* required */
  clientToken: 'STRING_VALUE',
  description: 'STRING_VALUE'
};
fis.createTargetAccountConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • clientToken — (String)

    Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

    If a token is not provided, the SDK will use a version 4 UUID.
  • experimentTemplateId — (String)

    The experiment template ID.

  • accountId — (String)

    The Amazon Web Services account ID of the target account.

  • roleArn — (String)

    The Amazon Resource Name (ARN) of an IAM role for the target account.

  • description — (String)

    The description of the target account.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • targetAccountConfiguration — (map)

      Information about the target account configuration.

      • roleArn — (String)

        The Amazon Resource Name (ARN) of an IAM role for the target account.

      • accountId — (String)

        The Amazon Web Services account ID of the target account.

      • description — (String)

        The description of the target account.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  id: 'STRING_VALUE' /* required */
};
fis.deleteExperimentTemplate(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • id — (String)

    The ID of the experiment template.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • experimentTemplate — (map)

      Information about the experiment template.

      • id — (String)

        The ID of the experiment template.

      • arn — (String)

        The Amazon Resource Name (ARN) of the experiment template.

      • description — (String)

        The description for the experiment template.

      • targets — (map<map>)

        The targets for the experiment.

        • resourceType — (String)

          The resource type.

        • resourceArns — (Array<String>)

          The Amazon Resource Names (ARNs) of the targets.

        • resourceTags — (map<String>)

          The tags for the target resources.

        • filters — (Array<map>)

          The filters to apply to identify target resources using specific attributes.

          • path — (String)

            The attribute path for the filter.

          • values — (Array<String>)

            The attribute values for the filter.

        • selectionMode — (String)

          Scopes the identified resources to a specific count or percentage.

        • parameters — (map<String>)

          The resource type parameters.

      • actions — (map<map>)

        The actions for the experiment.

        • actionId — (String)

          The ID of the action.

        • description — (String)

          A description for the action.

        • parameters — (map<String>)

          The parameters for the action.

        • targets — (map<String>)

          The targets for the action.

        • startAfter — (Array<String>)

          The name of the action that must be completed before the current action starts.

      • stopConditions — (Array<map>)

        The stop conditions for the experiment.

        • source — (String)

          The source for the stop condition.

        • value — (String)

          The Amazon Resource Name (ARN) of the CloudWatch alarm, if applicable.

      • creationTime — (Date)

        The time the experiment template was created.

      • lastUpdateTime — (Date)

        The time the experiment template was last updated.

      • roleArn — (String)

        The Amazon Resource Name (ARN) of an IAM role.

      • tags — (map<String>)

        The tags for the experiment template.

      • logConfiguration — (map)

        The configuration for experiment logging.

        • cloudWatchLogsConfiguration — (map)

          The configuration for experiment logging to Amazon CloudWatch Logs.

          • logGroupArn — (String)

            The Amazon Resource Name (ARN) of the destination Amazon CloudWatch Logs log group.

        • s3Configuration — (map)

          The configuration for experiment logging to Amazon S3.

          • bucketName — (String)

            The name of the destination bucket.

          • prefix — (String)

            The bucket prefix.

        • logSchemaVersion — (Integer)

          The schema version.

      • experimentOptions — (map)

        The experiment options for an experiment template.

        • accountTargeting — (String)

          The account targeting setting for an experiment template.

          Possible values include:
          • "single-account"
          • "multi-account"
        • emptyTargetResolutionMode — (String)

          The empty target resolution mode for an experiment template.

          Possible values include:
          • "fail"
          • "skip"
      • targetAccountConfigurationsCount — (Integer)

        The count of target account configurations for the experiment template.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  accountId: 'STRING_VALUE', /* required */
  experimentTemplateId: 'STRING_VALUE' /* required */
};
fis.deleteTargetAccountConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • experimentTemplateId — (String)

    The ID of the experiment template.

  • accountId — (String)

    The Amazon Web Services account ID of the target account.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • targetAccountConfiguration — (map)

      Information about the target account configuration.

      • roleArn — (String)

        The Amazon Resource Name (ARN) of an IAM role for the target account.

      • accountId — (String)

        The Amazon Web Services account ID of the target account.

      • description — (String)

        The description of the target account.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  id: 'STRING_VALUE' /* required */
};
fis.getAction(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • id — (String)

    The ID of the action.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • action — (map)

      Information about the action.

      • id — (String)

        The ID of the action.

      • arn — (String)

        The Amazon Resource Name (ARN) of the action.

      • description — (String)

        The description for the action.

      • parameters — (map<map>)

        The action parameters, if applicable.

        • description — (String)

          The parameter description.

        • required — (Boolean)

          Indicates whether the parameter is required.

      • targets — (map<map>)

        The supported targets for the action.

        • resourceType — (String)

          The resource type of the target.

      • tags — (map<String>)

        The tags for the action.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  id: 'STRING_VALUE' /* required */
};
fis.getExperiment(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • id — (String)

    The ID of the experiment.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • experiment — (map)

      Information about the experiment.

      • id — (String)

        The ID of the experiment.

      • arn — (String)

        The Amazon Resource Name (ARN) of the experiment.

      • experimentTemplateId — (String)

        The ID of the experiment template.

      • roleArn — (String)

        The Amazon Resource Name (ARN) of an IAM role that grants the FIS service permission to perform service actions on your behalf.

      • state — (map)

        The state of the experiment.

        • status — (String)

          The state of the experiment.

          Possible values include:
          • "pending"
          • "initiating"
          • "running"
          • "completed"
          • "stopping"
          • "stopped"
          • "failed"
          • "cancelled"
        • reason — (String)

          The reason for the state.

        • error — (map)

          The error information of the experiment when the action has failed.

          • accountId — (String)

            The Amazon Web Services Account ID where the experiment failure occurred.

          • code — (String)

            The error code for the failed experiment.

          • location — (String)

            Context for the section of the experiment template that failed.

      • targets — (map<map>)

        The targets for the experiment.

        • resourceType — (String)

          The resource type.

        • resourceArns — (Array<String>)

          The Amazon Resource Names (ARNs) of the resources.

        • resourceTags — (map<String>)

          The tags for the target resources.

        • filters — (Array<map>)

          The filters to apply to identify target resources using specific attributes.

          • path — (String)

            The attribute path for the filter.

          • values — (Array<String>)

            The attribute values for the filter.

        • selectionMode — (String)

          Scopes the identified resources to a specific count or percentage.

        • parameters — (map<String>)

          The resource type parameters.

      • actions — (map<map>)

        The actions for the experiment.

        • actionId — (String)

          The ID of the action.

        • description — (String)

          The description for the action.

        • parameters — (map<String>)

          The parameters for the action.

        • targets — (map<String>)

          The targets for the action.

        • startAfter — (Array<String>)

          The name of the action that must be completed before this action starts.

        • state — (map)

          The state of the action.

          • status — (String)

            The state of the action.

            Possible values include:
            • "pending"
            • "initiating"
            • "running"
            • "completed"
            • "cancelled"
            • "stopping"
            • "stopped"
            • "failed"
            • "skipped"
          • reason — (String)

            The reason for the state.

        • startTime — (Date)

          The time that the action started.

        • endTime — (Date)

          The time that the action ended.

      • stopConditions — (Array<map>)

        The stop conditions for the experiment.

        • source — (String)

          The source for the stop condition.

        • value — (String)

          The Amazon Resource Name (ARN) of the CloudWatch alarm, if applicable.

      • creationTime — (Date)

        The time that the experiment was created.

      • startTime — (Date)

        The time that the experiment started.

      • endTime — (Date)

        The time that the experiment ended.

      • tags — (map<String>)

        The tags for the experiment.

      • logConfiguration — (map)

        The configuration for experiment logging.

        • cloudWatchLogsConfiguration — (map)

          The configuration for experiment logging to Amazon CloudWatch Logs.

          • logGroupArn — (String)

            The Amazon Resource Name (ARN) of the destination Amazon CloudWatch Logs log group.

        • s3Configuration — (map)

          The configuration for experiment logging to Amazon S3.

          • bucketName — (String)

            The name of the destination bucket.

          • prefix — (String)

            The bucket prefix.

        • logSchemaVersion — (Integer)

          The schema version.

      • experimentOptions — (map)

        The experiment options for the experiment.

        • accountTargeting — (String)

          The account targeting setting for an experiment.

          Possible values include:
          • "single-account"
          • "multi-account"
        • emptyTargetResolutionMode — (String)

          The empty target resolution mode for an experiment.

          Possible values include:
          • "fail"
          • "skip"
        • actionsMode — (String)

          The actions mode of the experiment that is set from the StartExperiment API command.

          Possible values include:
          • "skip-all"
          • "run-all"
      • targetAccountConfigurationsCount — (Integer)

        The count of target account configurations for the experiment.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  accountId: 'STRING_VALUE', /* required */
  experimentId: 'STRING_VALUE' /* required */
};
fis.getExperimentTargetAccountConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • experimentId — (String)

    The ID of the experiment.

  • accountId — (String)

    The Amazon Web Services account ID of the target account.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • targetAccountConfiguration — (map)

      Information about the target account configuration.

      • roleArn — (String)

        The Amazon Resource Name (ARN) of an IAM role for the target account.

      • accountId — (String)

        The Amazon Web Services account ID of the target account.

      • description — (String)

        The description of the target account.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  id: 'STRING_VALUE' /* required */
};
fis.getExperimentTemplate(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • id — (String)

    The ID of the experiment template.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • experimentTemplate — (map)

      Information about the experiment template.

      • id — (String)

        The ID of the experiment template.

      • arn — (String)

        The Amazon Resource Name (ARN) of the experiment template.

      • description — (String)

        The description for the experiment template.

      • targets — (map<map>)

        The targets for the experiment.

        • resourceType — (String)

          The resource type.

        • resourceArns — (Array<String>)

          The Amazon Resource Names (ARNs) of the targets.

        • resourceTags — (map<String>)

          The tags for the target resources.

        • filters — (Array<map>)

          The filters to apply to identify target resources using specific attributes.

          • path — (String)

            The attribute path for the filter.

          • values — (Array<String>)

            The attribute values for the filter.

        • selectionMode — (String)

          Scopes the identified resources to a specific count or percentage.

        • parameters — (map<String>)

          The resource type parameters.

      • actions — (map<map>)

        The actions for the experiment.

        • actionId — (String)

          The ID of the action.

        • description — (String)

          A description for the action.

        • parameters — (map<String>)

          The parameters for the action.

        • targets — (map<String>)

          The targets for the action.

        • startAfter — (Array<String>)

          The name of the action that must be completed before the current action starts.

      • stopConditions — (Array<map>)

        The stop conditions for the experiment.

        • source — (String)

          The source for the stop condition.

        • value — (String)

          The Amazon Resource Name (ARN) of the CloudWatch alarm, if applicable.

      • creationTime — (Date)

        The time the experiment template was created.

      • lastUpdateTime — (Date)

        The time the experiment template was last updated.

      • roleArn — (String)

        The Amazon Resource Name (ARN) of an IAM role.

      • tags — (map<String>)

        The tags for the experiment template.

      • logConfiguration — (map)

        The configuration for experiment logging.

        • cloudWatchLogsConfiguration — (map)

          The configuration for experiment logging to Amazon CloudWatch Logs.

          • logGroupArn — (String)

            The Amazon Resource Name (ARN) of the destination Amazon CloudWatch Logs log group.

        • s3Configuration — (map)

          The configuration for experiment logging to Amazon S3.

          • bucketName — (String)

            The name of the destination bucket.

          • prefix — (String)

            The bucket prefix.

        • logSchemaVersion — (Integer)

          The schema version.

      • experimentOptions — (map)

        The experiment options for an experiment template.

        • accountTargeting — (String)

          The account targeting setting for an experiment template.

          Possible values include:
          • "single-account"
          • "multi-account"
        • emptyTargetResolutionMode — (String)

          The empty target resolution mode for an experiment template.

          Possible values include:
          • "fail"
          • "skip"
      • targetAccountConfigurationsCount — (Integer)

        The count of target account configurations for the experiment template.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  id: 'STRING_VALUE' /* required */
};
fis.getSafetyLever(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • id — (String)

    The ID of the safety lever.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • safetyLever — (map)

      Information about the safety lever.

      • id — (String)

        The ID of the safety lever.

      • arn — (String)

        The Amazon Resource Name (ARN) of the safety lever.

      • state — (map)

        The state of the safety lever.

        • status — (String)

          The state of the safety lever.

          Possible values include:
          • "disengaged"
          • "engaged"
          • "engaging"
        • reason — (String)

          The reason for the state of the safety lever.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  accountId: 'STRING_VALUE', /* required */
  experimentTemplateId: 'STRING_VALUE' /* required */
};
fis.getTargetAccountConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • experimentTemplateId — (String)

    The ID of the experiment template.

  • accountId — (String)

    The Amazon Web Services account ID of the target account.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • targetAccountConfiguration — (map)

      Information about the target account configuration.

      • roleArn — (String)

        The Amazon Resource Name (ARN) of an IAM role for the target account.

      • accountId — (String)

        The Amazon Web Services account ID of the target account.

      • description — (String)

        The description of the target account.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  resourceType: 'STRING_VALUE' /* required */
};
fis.getTargetResourceType(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • resourceType — (String)

    The resource type.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • targetResourceType — (map)

      Information about the resource type.

      • resourceType — (String)

        The resource type.

      • description — (String)

        A description of the resource type.

      • parameters — (map<map>)

        The parameters for the resource type.

        • description — (String)

          A description of the parameter.

        • required — (Boolean)

          Indicates whether the parameter is required.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
fis.listActions(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • maxResults — (Integer)

    The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned nextToken value.

  • nextToken — (String)

    The token for the next page of results.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • actions — (Array<map>)

      The actions.

      • id — (String)

        The ID of the action.

      • arn — (String)

        The Amazon Resource Name (ARN) of the action.

      • description — (String)

        The description for the action.

      • targets — (map<map>)

        The targets for the action.

        • resourceType — (String)

          The resource type of the target.

      • tags — (map<String>)

        The tags for the action.

    • nextToken — (String)

      The token to use to retrieve the next page of results. This value is null when there are no more results to return.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  experimentId: 'STRING_VALUE', /* required */
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE',
  targetName: 'STRING_VALUE'
};
fis.listExperimentResolvedTargets(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • experimentId — (String)

    The ID of the experiment.

  • maxResults — (Integer)

    The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned nextToken value.

  • nextToken — (String)

    The token for the next page of results.

  • targetName — (String)

    The name of the target.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • resolvedTargets — (Array<map>)

      The resolved targets.

      • resourceType — (String)

        The resource type of the target.

      • targetName — (String)

        The name of the target.

      • targetInformation — (map<String>)

        Information about the target.

    • nextToken — (String)

      The token to use to retrieve the next page of results. This value is null when there are no more results to return.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  experimentTemplateId: 'STRING_VALUE',
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
fis.listExperiments(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • maxResults — (Integer)

    The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned nextToken value.

  • nextToken — (String)

    The token for the next page of results.

  • experimentTemplateId — (String)

    The ID of the experiment template.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • experiments — (Array<map>)

      The experiments.

      • id — (String)

        The ID of the experiment.

      • arn — (String)

        The Amazon Resource Name (ARN) of the experiment.

      • experimentTemplateId — (String)

        The ID of the experiment template.

      • state — (map)

        The state of the experiment.

        • status — (String)

          The state of the experiment.

          Possible values include:
          • "pending"
          • "initiating"
          • "running"
          • "completed"
          • "stopping"
          • "stopped"
          • "failed"
          • "cancelled"
        • reason — (String)

          The reason for the state.

        • error — (map)

          The error information of the experiment when the action has failed.

          • accountId — (String)

            The Amazon Web Services Account ID where the experiment failure occurred.

          • code — (String)

            The error code for the failed experiment.

          • location — (String)

            Context for the section of the experiment template that failed.

      • creationTime — (Date)

        The time that the experiment was created.

      • tags — (map<String>)

        The tags for the experiment.

      • experimentOptions — (map)

        The experiment options for the experiment.

        • accountTargeting — (String)

          The account targeting setting for an experiment.

          Possible values include:
          • "single-account"
          • "multi-account"
        • emptyTargetResolutionMode — (String)

          The empty target resolution mode for an experiment.

          Possible values include:
          • "fail"
          • "skip"
        • actionsMode — (String)

          The actions mode of the experiment that is set from the StartExperiment API command.

          Possible values include:
          • "skip-all"
          • "run-all"
    • nextToken — (String)

      The token to use to retrieve the next page of results. This value is null when there are no more results to return.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  experimentId: 'STRING_VALUE', /* required */
  nextToken: 'STRING_VALUE'
};
fis.listExperimentTargetAccountConfigurations(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • experimentId — (String)

    The ID of the experiment.

  • nextToken — (String)

    The token for the next page of results.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • targetAccountConfigurations — (Array<map>)

      The target account configurations.

      • roleArn — (String)

        The Amazon Resource Name (ARN) of an IAM role for the target account.

      • accountId — (String)

        The Amazon Web Services account ID of the target account.

      • description — (String)

        The description of the target account.

    • nextToken — (String)

      The token to use to retrieve the next page of results. This value is null when there are no more results to return.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
fis.listExperimentTemplates(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • maxResults — (Integer)

    The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned nextToken value.

  • nextToken — (String)

    The token for the next page of results.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • experimentTemplates — (Array<map>)

      The experiment templates.

      • id — (String)

        The ID of the experiment template.

      • arn — (String)

        The Amazon Resource Name (ARN) of the experiment template.

      • description — (String)

        The description of the experiment template.

      • creationTime — (Date)

        The time that the experiment template was created.

      • lastUpdateTime — (Date)

        The time that the experiment template was last updated.

      • tags — (map<String>)

        The tags for the experiment template.

    • nextToken — (String)

      The token to use to retrieve the next page of results. This value is null when there are no more results to return.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  resourceArn: 'STRING_VALUE' /* required */
};
fis.listTagsForResource(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • resourceArn — (String)

    The Amazon Resource Name (ARN) of the resource.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • tags — (map<String>)

      The tags for the resource.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  experimentTemplateId: 'STRING_VALUE', /* required */
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
fis.listTargetAccountConfigurations(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • experimentTemplateId — (String)

    The ID of the experiment template.

  • maxResults — (Integer)

    The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned nextToken value.

  • nextToken — (String)

    The token for the next page of results.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • targetAccountConfigurations — (Array<map>)

      The target account configurations.

      • roleArn — (String)

        The Amazon Resource Name (ARN) of an IAM role for the target account.

      • accountId — (String)

        The Amazon Web Services account ID of the target account.

      • description — (String)

        The description of the target account.

    • nextToken — (String)

      The token to use to retrieve the next page of results. This value is null when there are no more results to return.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  maxResults: 'NUMBER_VALUE',
  nextToken: 'STRING_VALUE'
};
fis.listTargetResourceTypes(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • maxResults — (Integer)

    The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned nextToken value.

  • nextToken — (String)

    The token for the next page of results.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • targetResourceTypes — (Array<map>)

      The target resource types.

      • resourceType — (String)

        The resource type.

      • description — (String)

        A description of the resource type.

    • nextToken — (String)

      The token to use to retrieve the next page of results. This value is null when there are no more results to return.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  clientToken: 'STRING_VALUE', /* required */
  experimentTemplateId: 'STRING_VALUE', /* required */
  experimentOptions: {
    actionsMode: skip-all | run-all
  },
  tags: {
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
fis.startExperiment(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • clientToken — (String)

    Unique, case-sensitive identifier that you provide to ensure the idempotency of the request.

    If a token is not provided, the SDK will use a version 4 UUID.
  • experimentTemplateId — (String)

    The ID of the experiment template.

  • experimentOptions — (map)

    The experiment options for running the experiment.

    • actionsMode — (String)

      Specifies the actions mode for experiment options.

      Possible values include:
      • "skip-all"
      • "run-all"
  • tags — (map<String>)

    The tags to apply to the experiment.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • experiment — (map)

      Information about the experiment.

      • id — (String)

        The ID of the experiment.

      • arn — (String)

        The Amazon Resource Name (ARN) of the experiment.

      • experimentTemplateId — (String)

        The ID of the experiment template.

      • roleArn — (String)

        The Amazon Resource Name (ARN) of an IAM role that grants the FIS service permission to perform service actions on your behalf.

      • state — (map)

        The state of the experiment.

        • status — (String)

          The state of the experiment.

          Possible values include:
          • "pending"
          • "initiating"
          • "running"
          • "completed"
          • "stopping"
          • "stopped"
          • "failed"
          • "cancelled"
        • reason — (String)

          The reason for the state.

        • error — (map)

          The error information of the experiment when the action has failed.

          • accountId — (String)

            The Amazon Web Services Account ID where the experiment failure occurred.

          • code — (String)

            The error code for the failed experiment.

          • location — (String)

            Context for the section of the experiment template that failed.

      • targets — (map<map>)

        The targets for the experiment.

        • resourceType — (String)

          The resource type.

        • resourceArns — (Array<String>)

          The Amazon Resource Names (ARNs) of the resources.

        • resourceTags — (map<String>)

          The tags for the target resources.

        • filters — (Array<map>)

          The filters to apply to identify target resources using specific attributes.

          • path — (String)

            The attribute path for the filter.

          • values — (Array<String>)

            The attribute values for the filter.

        • selectionMode — (String)

          Scopes the identified resources to a specific count or percentage.

        • parameters — (map<String>)

          The resource type parameters.

      • actions — (map<map>)

        The actions for the experiment.

        • actionId — (String)

          The ID of the action.

        • description — (String)

          The description for the action.

        • parameters — (map<String>)

          The parameters for the action.

        • targets — (map<String>)

          The targets for the action.

        • startAfter — (Array<String>)

          The name of the action that must be completed before this action starts.

        • state — (map)

          The state of the action.

          • status — (String)

            The state of the action.

            Possible values include:
            • "pending"
            • "initiating"
            • "running"
            • "completed"
            • "cancelled"
            • "stopping"
            • "stopped"
            • "failed"
            • "skipped"
          • reason — (String)

            The reason for the state.

        • startTime — (Date)

          The time that the action started.

        • endTime — (Date)

          The time that the action ended.

      • stopConditions — (Array<map>)

        The stop conditions for the experiment.

        • source — (String)

          The source for the stop condition.

        • value — (String)

          The Amazon Resource Name (ARN) of the CloudWatch alarm, if applicable.

      • creationTime — (Date)

        The time that the experiment was created.

      • startTime — (Date)

        The time that the experiment started.

      • endTime — (Date)

        The time that the experiment ended.

      • tags — (map<String>)

        The tags for the experiment.

      • logConfiguration — (map)

        The configuration for experiment logging.

        • cloudWatchLogsConfiguration — (map)

          The configuration for experiment logging to Amazon CloudWatch Logs.

          • logGroupArn — (String)

            The Amazon Resource Name (ARN) of the destination Amazon CloudWatch Logs log group.

        • s3Configuration — (map)

          The configuration for experiment logging to Amazon S3.

          • bucketName — (String)

            The name of the destination bucket.

          • prefix — (String)

            The bucket prefix.

        • logSchemaVersion — (Integer)

          The schema version.

      • experimentOptions — (map)

        The experiment options for the experiment.

        • accountTargeting — (String)

          The account targeting setting for an experiment.

          Possible values include:
          • "single-account"
          • "multi-account"
        • emptyTargetResolutionMode — (String)

          The empty target resolution mode for an experiment.

          Possible values include:
          • "fail"
          • "skip"
        • actionsMode — (String)

          The actions mode of the experiment that is set from the StartExperiment API command.

          Possible values include:
          • "skip-all"
          • "run-all"
      • targetAccountConfigurationsCount — (Integer)

        The count of target account configurations for the experiment.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  id: 'STRING_VALUE' /* required */
};
fis.stopExperiment(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • id — (String)

    The ID of the experiment.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • experiment — (map)

      Information about the experiment.

      • id — (String)

        The ID of the experiment.

      • arn — (String)

        The Amazon Resource Name (ARN) of the experiment.

      • experimentTemplateId — (String)

        The ID of the experiment template.

      • roleArn — (String)

        The Amazon Resource Name (ARN) of an IAM role that grants the FIS service permission to perform service actions on your behalf.

      • state — (map)

        The state of the experiment.

        • status — (String)

          The state of the experiment.

          Possible values include:
          • "pending"
          • "initiating"
          • "running"
          • "completed"
          • "stopping"
          • "stopped"
          • "failed"
          • "cancelled"
        • reason — (String)

          The reason for the state.

        • error — (map)

          The error information of the experiment when the action has failed.

          • accountId — (String)

            The Amazon Web Services Account ID where the experiment failure occurred.

          • code — (String)

            The error code for the failed experiment.

          • location — (String)

            Context for the section of the experiment template that failed.

      • targets — (map<map>)

        The targets for the experiment.

        • resourceType — (String)

          The resource type.

        • resourceArns — (Array<String>)

          The Amazon Resource Names (ARNs) of the resources.

        • resourceTags — (map<String>)

          The tags for the target resources.

        • filters — (Array<map>)

          The filters to apply to identify target resources using specific attributes.

          • path — (String)

            The attribute path for the filter.

          • values — (Array<String>)

            The attribute values for the filter.

        • selectionMode — (String)

          Scopes the identified resources to a specific count or percentage.

        • parameters — (map<String>)

          The resource type parameters.

      • actions — (map<map>)

        The actions for the experiment.

        • actionId — (String)

          The ID of the action.

        • description — (String)

          The description for the action.

        • parameters — (map<String>)

          The parameters for the action.

        • targets — (map<String>)

          The targets for the action.

        • startAfter — (Array<String>)

          The name of the action that must be completed before this action starts.

        • state — (map)

          The state of the action.

          • status — (String)

            The state of the action.

            Possible values include:
            • "pending"
            • "initiating"
            • "running"
            • "completed"
            • "cancelled"
            • "stopping"
            • "stopped"
            • "failed"
            • "skipped"
          • reason — (String)

            The reason for the state.

        • startTime — (Date)

          The time that the action started.

        • endTime — (Date)

          The time that the action ended.

      • stopConditions — (Array<map>)

        The stop conditions for the experiment.

        • source — (String)

          The source for the stop condition.

        • value — (String)

          The Amazon Resource Name (ARN) of the CloudWatch alarm, if applicable.

      • creationTime — (Date)

        The time that the experiment was created.

      • startTime — (Date)

        The time that the experiment started.

      • endTime — (Date)

        The time that the experiment ended.

      • tags — (map<String>)

        The tags for the experiment.

      • logConfiguration — (map)

        The configuration for experiment logging.

        • cloudWatchLogsConfiguration — (map)

          The configuration for experiment logging to Amazon CloudWatch Logs.

          • logGroupArn — (String)

            The Amazon Resource Name (ARN) of the destination Amazon CloudWatch Logs log group.

        • s3Configuration — (map)

          The configuration for experiment logging to Amazon S3.

          • bucketName — (String)

            The name of the destination bucket.

          • prefix — (String)

            The bucket prefix.

        • logSchemaVersion — (Integer)

          The schema version.

      • experimentOptions — (map)

        The experiment options for the experiment.

        • accountTargeting — (String)

          The account targeting setting for an experiment.

          Possible values include:
          • "single-account"
          • "multi-account"
        • emptyTargetResolutionMode — (String)

          The empty target resolution mode for an experiment.

          Possible values include:
          • "fail"
          • "skip"
        • actionsMode — (String)

          The actions mode of the experiment that is set from the StartExperiment API command.

          Possible values include:
          • "skip-all"
          • "run-all"
      • targetAccountConfigurationsCount — (Integer)

        The count of target account configurations for the experiment.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  resourceArn: 'STRING_VALUE', /* required */
  tags: { /* required */
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
fis.tagResource(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • resourceArn — (String)

    The Amazon Resource Name (ARN) of the resource.

  • tags — (map<String>)

    The tags for the resource.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  resourceArn: 'STRING_VALUE', /* required */
  tagKeys: [
    'STRING_VALUE',
    /* more items */
  ]
};
fis.untagResource(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • resourceArn — (String)

    The Amazon Resource Name (ARN) of the resource.

  • tagKeys — (Array<String>)

    The tag keys to remove.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  id: 'STRING_VALUE', /* required */
  actions: {
    '<ExperimentTemplateActionName>': {
      actionId: 'STRING_VALUE',
      description: 'STRING_VALUE',
      parameters: {
        '<ExperimentTemplateActionParameterName>': 'STRING_VALUE',
        /* '<ExperimentTemplateActionParameterName>': ... */
      },
      startAfter: [
        'STRING_VALUE',
        /* more items */
      ],
      targets: {
        '<ExperimentTemplateActionTargetName>': 'STRING_VALUE',
        /* '<ExperimentTemplateActionTargetName>': ... */
      }
    },
    /* '<ExperimentTemplateActionName>': ... */
  },
  description: 'STRING_VALUE',
  experimentOptions: {
    emptyTargetResolutionMode: fail | skip
  },
  logConfiguration: {
    cloudWatchLogsConfiguration: {
      logGroupArn: 'STRING_VALUE' /* required */
    },
    logSchemaVersion: 'NUMBER_VALUE',
    s3Configuration: {
      bucketName: 'STRING_VALUE', /* required */
      prefix: 'STRING_VALUE'
    }
  },
  roleArn: 'STRING_VALUE',
  stopConditions: [
    {
      source: 'STRING_VALUE', /* required */
      value: 'STRING_VALUE'
    },
    /* more items */
  ],
  targets: {
    '<ExperimentTemplateTargetName>': {
      resourceType: 'STRING_VALUE', /* required */
      selectionMode: 'STRING_VALUE', /* required */
      filters: [
        {
          path: 'STRING_VALUE', /* required */
          values: [ /* required */
            'STRING_VALUE',
            /* more items */
          ]
        },
        /* more items */
      ],
      parameters: {
        '<ExperimentTemplateTargetParameterName>': 'STRING_VALUE',
        /* '<ExperimentTemplateTargetParameterName>': ... */
      },
      resourceArns: [
        'STRING_VALUE',
        /* more items */
      ],
      resourceTags: {
        '<TagKey>': 'STRING_VALUE',
        /* '<TagKey>': ... */
      }
    },
    /* '<ExperimentTemplateTargetName>': ... */
  }
};
fis.updateExperimentTemplate(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • id — (String)

    The ID of the experiment template.

  • description — (String)

    A description for the template.

  • stopConditions — (Array<map>)

    The stop conditions for the experiment.

    • source — required — (String)

      The source for the stop condition. Specify aws:cloudwatch:alarm if the stop condition is defined by a CloudWatch alarm. Specify none if there is no stop condition.

    • value — (String)

      The Amazon Resource Name (ARN) of the CloudWatch alarm.

  • targets — (map<map>)

    The targets for the experiment.

    • resourceType — required — (String)

      The resource type. The resource type must be supported for the specified action.

    • resourceArns — (Array<String>)

      The Amazon Resource Names (ARNs) of the targets.

    • resourceTags — (map<String>)

      The tags for the target resources.

    • filters — (Array<map>)

      The filters to apply to identify target resources using specific attributes.

      • path — required — (String)

        The attribute path for the filter.

      • values — required — (Array<String>)

        The attribute values for the filter.

    • selectionMode — required — (String)

      Scopes the identified resources to a specific count or percentage.

    • parameters — (map<String>)

      The resource type parameters.

  • actions — (map<map>)

    The actions for the experiment.

    • actionId — (String)

      The ID of the action.

    • description — (String)

      A description for the action.

    • parameters — (map<String>)

      The parameters for the action, if applicable.

    • targets — (map<String>)

      The targets for the action.

    • startAfter — (Array<String>)

      The name of the action that must be completed before the current action starts. Omit this parameter to run the action at the start of the experiment.

  • roleArn — (String)

    The Amazon Resource Name (ARN) of an IAM role that grants the FIS service permission to perform service actions on your behalf.

  • logConfiguration — (map)

    The configuration for experiment logging.

    • cloudWatchLogsConfiguration — (map)

      The configuration for experiment logging to Amazon CloudWatch Logs.

      • logGroupArn — required — (String)

        The Amazon Resource Name (ARN) of the destination Amazon CloudWatch Logs log group.

    • s3Configuration — (map)

      The configuration for experiment logging to Amazon S3.

      • bucketName — required — (String)

        The name of the destination bucket.

      • prefix — (String)

        The bucket prefix.

    • logSchemaVersion — (Integer)

      The schema version.

  • experimentOptions — (map)

    The experiment options for the experiment template.

    • emptyTargetResolutionMode — (String)

      The empty target resolution mode of the experiment template.

      Possible values include:
      • "fail"
      • "skip"

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • experimentTemplate — (map)

      Information about the experiment template.

      • id — (String)

        The ID of the experiment template.

      • arn — (String)

        The Amazon Resource Name (ARN) of the experiment template.

      • description — (String)

        The description for the experiment template.

      • targets — (map<map>)

        The targets for the experiment.

        • resourceType — (String)

          The resource type.

        • resourceArns — (Array<String>)

          The Amazon Resource Names (ARNs) of the targets.

        • resourceTags — (map<String>)

          The tags for the target resources.

        • filters — (Array<map>)

          The filters to apply to identify target resources using specific attributes.

          • path — (String)

            The attribute path for the filter.

          • values — (Array<String>)

            The attribute values for the filter.

        • selectionMode — (String)

          Scopes the identified resources to a specific count or percentage.

        • parameters — (map<String>)

          The resource type parameters.

      • actions — (map<map>)

        The actions for the experiment.

        • actionId — (String)

          The ID of the action.

        • description — (String)

          A description for the action.

        • parameters — (map<String>)

          The parameters for the action.

        • targets — (map<String>)

          The targets for the action.

        • startAfter — (Array<String>)

          The name of the action that must be completed before the current action starts.

      • stopConditions — (Array<map>)

        The stop conditions for the experiment.

        • source — (String)

          The source for the stop condition.

        • value — (String)

          The Amazon Resource Name (ARN) of the CloudWatch alarm, if applicable.

      • creationTime — (Date)

        The time the experiment template was created.

      • lastUpdateTime — (Date)

        The time the experiment template was last updated.

      • roleArn — (String)

        The Amazon Resource Name (ARN) of an IAM role.

      • tags — (map<String>)

        The tags for the experiment template.

      • logConfiguration — (map)

        The configuration for experiment logging.

        • cloudWatchLogsConfiguration — (map)

          The configuration for experiment logging to Amazon CloudWatch Logs.

          • logGroupArn — (String)

            The Amazon Resource Name (ARN) of the destination Amazon CloudWatch Logs log group.

        • s3Configuration — (map)

          The configuration for experiment logging to Amazon S3.

          • bucketName — (String)

            The name of the destination bucket.

          • prefix — (String)

            The bucket prefix.

        • logSchemaVersion — (Integer)

          The schema version.

      • experimentOptions — (map)

        The experiment options for an experiment template.

        • accountTargeting — (String)

          The account targeting setting for an experiment template.

          Possible values include:
          • "single-account"
          • "multi-account"
        • emptyTargetResolutionMode — (String)

          The empty target resolution mode for an experiment template.

          Possible values include:
          • "fail"
          • "skip"
      • targetAccountConfigurationsCount — (Integer)

        The count of target account configurations for the experiment template.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  id: 'STRING_VALUE', /* required */
  state: { /* required */
    reason: 'STRING_VALUE', /* required */
    status: disengaged | engaged /* required */
  }
};
fis.updateSafetyLeverState(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • id — (String)

    The ID of the safety lever.

  • state — (map)

    The state of the safety lever.

    • status — required — (String)

      The updated state of the safety lever.

      Possible values include:
      • "disengaged"
      • "engaged"
    • reason — required — (String)

      The reason for updating the state of the safety lever.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • safetyLever — (map)

      Information about the safety lever.

      • id — (String)

        The ID of the safety lever.

      • arn — (String)

        The Amazon Resource Name (ARN) of the safety lever.

      • state — (map)

        The state of the safety lever.

        • status — (String)

          The state of the safety lever.

          Possible values include:
          • "disengaged"
          • "engaged"
          • "engaging"
        • reason — (String)

          The reason for the state of the safety lever.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  accountId: 'STRING_VALUE', /* required */
  experimentTemplateId: 'STRING_VALUE', /* required */
  description: 'STRING_VALUE',
  roleArn: 'STRING_VALUE'
};
fis.updateTargetAccountConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • experimentTemplateId — (String)

    The ID of the experiment template.

  • accountId — (String)

    The Amazon Web Services account ID of the target account.

  • roleArn — (String)

    The Amazon Resource Name (ARN) of an IAM role for the target account.

  • description — (String)

    The description of the target account.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • targetAccountConfiguration — (map)

      Information about the target account configuration.

      • roleArn — (String)

        The Amazon Resource Name (ARN) of an IAM role for the target account.

      • accountId — (String)

        The Amazon Web Services account ID of the target account.

      • description — (String)

        The description of the target account.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.