[ aws . sagemaker ]

create-workteam

Description

Creates a new work team for labeling your data. A work team is defined by one or more Amazon Cognito user pools. You must first create the user pools before you can create a work team.

You cannot create more than 25 work teams in an account and region.

See also: AWS API Documentation

See ‘aws help’ for descriptions of global parameters.

Synopsis

  create-workteam
--workteam-name <value>
--member-definitions <value>
--description <value>
[--notification-configuration <value>]
[--tags <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--cli-auto-prompt <value>]

Options

--workteam-name (string)

The name of the work team. Use this name to identify the work team.

--member-definitions (list)

A list of MemberDefinition objects that contains objects that identify the Amazon Cognito user pool that makes up the work team. For more information, see Amazon Cognito User Pools .

All of the CognitoMemberDefinition objects that make up the member definition must have the same ClientId and UserPool values.

(structure)

Defines the Amazon Cognito user group that is part of a work team.

CognitoMemberDefinition -> (structure)

The Amazon Cognito user group that is part of the work team.

UserPool -> (string)

An identifier for a user pool. The user pool must be in the same region as the service that you are calling.

UserGroup -> (string)

An identifier for a user group.

ClientId -> (string)

An identifier for an application client. You must create the app client ID using Amazon Cognito.

Shorthand Syntax:

CognitoMemberDefinition={UserPool=string,UserGroup=string,ClientId=string} ...

JSON Syntax:

[
  {
    "CognitoMemberDefinition": {
      "UserPool": "string",
      "UserGroup": "string",
      "ClientId": "string"
    }
  }
  ...
]

--description (string)

A description of the work team.

--notification-configuration (structure)

Configures notification of workers regarding available or expiring work items.

NotificationTopicArn -> (string)

The ARN for the SNS topic to which notifications should be published.

Shorthand Syntax:

NotificationTopicArn=string

JSON Syntax:

{
  "NotificationTopicArn": "string"
}

--tags (list)

An array of key-value pairs.

For more information, see Resource Tag and Using Cost Allocation Tags in the AWS Billing and Cost Management User Guide .

(structure)

Describes a tag.

Key -> (string)

The tag key.

Value -> (string)

The tag value.

Shorthand Syntax:

Key=string,Value=string ...

JSON Syntax:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

--cli-auto-prompt (boolean) Automatically prompt for CLI input parameters.

See ‘aws help’ for descriptions of global parameters.

Output

WorkteamArn -> (string)

The Amazon Resource Name (ARN) of the work team. You can use this ARN to identify the work team.