1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. transcribe
  6. Vocabulary

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.81.0
published on Monday, Sep 28, 2026 by Pulumi
aws-native logo aws-native logo

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.81.0
published on Monday, Sep 28, 2026 by Pulumi

    Creates a custom vocabulary that you can use to improve the transcription accuracy of domain-specific words and phrases.

    Create Vocabulary Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Vocabulary(name: string, args: VocabularyArgs, opts?: CustomResourceOptions);
    @overload
    def Vocabulary(resource_name: str,
                   args: VocabularyArgs,
                   opts: Optional[ResourceOptions] = None)
    
    @overload
    def Vocabulary(resource_name: str,
                   opts: Optional[ResourceOptions] = None,
                   language_code: Optional[str] = None,
                   data_access_role_arn: Optional[str] = None,
                   phrases: Optional[Sequence[str]] = None,
                   tags: Optional[Sequence[_root_inputs.TagArgs]] = None,
                   vocabulary_file_uri: Optional[str] = None,
                   vocabulary_name: Optional[str] = None)
    func NewVocabulary(ctx *Context, name string, args VocabularyArgs, opts ...ResourceOption) (*Vocabulary, error)
    public Vocabulary(string name, VocabularyArgs args, CustomResourceOptions? opts = null)
    public Vocabulary(String name, VocabularyArgs args)
    public Vocabulary(String name, VocabularyArgs args, CustomResourceOptions options)
    
    type: aws-native:transcribe:Vocabulary
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "aws-native_transcribe_vocabulary" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args VocabularyArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args VocabularyArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args VocabularyArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args VocabularyArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args VocabularyArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Vocabulary Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Vocabulary resource accepts the following input properties:

    LanguageCode string
    The language code that represents the language of the entries in your custom vocabulary. Each custom vocabulary must contain terms in only one language.
    DataAccessRoleArn string
    The Amazon Resource Name (ARN) of an IAM role that has permissions to access the Amazon S3 bucket that contains your input file.
    Phrases List<string>
    Use this parameter if you want to create your custom vocabulary by including all desired terms, as comma-separated values, within your request. You cannot use this parameter together with VocabularyFileUri.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    Adds one or more custom tags, each in the form of a key:value pair, to the custom vocabulary.
    VocabularyFileUri string
    The Amazon S3 location of the text file that contains your custom vocabulary. You cannot use this parameter together with Phrases.
    VocabularyName string
    A unique name, chosen by you, for your custom vocabulary. This name is case sensitive, cannot contain spaces, and must be unique within an AWS account.
    LanguageCode string
    The language code that represents the language of the entries in your custom vocabulary. Each custom vocabulary must contain terms in only one language.
    DataAccessRoleArn string
    The Amazon Resource Name (ARN) of an IAM role that has permissions to access the Amazon S3 bucket that contains your input file.
    Phrases []string
    Use this parameter if you want to create your custom vocabulary by including all desired terms, as comma-separated values, within your request. You cannot use this parameter together with VocabularyFileUri.
    Tags TagArgs
    Adds one or more custom tags, each in the form of a key:value pair, to the custom vocabulary.
    VocabularyFileUri string
    The Amazon S3 location of the text file that contains your custom vocabulary. You cannot use this parameter together with Phrases.
    VocabularyName string
    A unique name, chosen by you, for your custom vocabulary. This name is case sensitive, cannot contain spaces, and must be unique within an AWS account.
    language_code string
    The language code that represents the language of the entries in your custom vocabulary. Each custom vocabulary must contain terms in only one language.
    data_access_role_arn string
    The Amazon Resource Name (ARN) of an IAM role that has permissions to access the Amazon S3 bucket that contains your input file.
    phrases list(string)
    Use this parameter if you want to create your custom vocabulary by including all desired terms, as comma-separated values, within your request. You cannot use this parameter together with VocabularyFileUri.
    tags list(object)
    Adds one or more custom tags, each in the form of a key:value pair, to the custom vocabulary.
    vocabulary_file_uri string
    The Amazon S3 location of the text file that contains your custom vocabulary. You cannot use this parameter together with Phrases.
    vocabulary_name string
    A unique name, chosen by you, for your custom vocabulary. This name is case sensitive, cannot contain spaces, and must be unique within an AWS account.
    languageCode String
    The language code that represents the language of the entries in your custom vocabulary. Each custom vocabulary must contain terms in only one language.
    dataAccessRoleArn String
    The Amazon Resource Name (ARN) of an IAM role that has permissions to access the Amazon S3 bucket that contains your input file.
    phrases List<String>
    Use this parameter if you want to create your custom vocabulary by including all desired terms, as comma-separated values, within your request. You cannot use this parameter together with VocabularyFileUri.
    tags List<Tag>
    Adds one or more custom tags, each in the form of a key:value pair, to the custom vocabulary.
    vocabularyFileUri String
    The Amazon S3 location of the text file that contains your custom vocabulary. You cannot use this parameter together with Phrases.
    vocabularyName String
    A unique name, chosen by you, for your custom vocabulary. This name is case sensitive, cannot contain spaces, and must be unique within an AWS account.
    languageCode string
    The language code that represents the language of the entries in your custom vocabulary. Each custom vocabulary must contain terms in only one language.
    dataAccessRoleArn string
    The Amazon Resource Name (ARN) of an IAM role that has permissions to access the Amazon S3 bucket that contains your input file.
    phrases string[]
    Use this parameter if you want to create your custom vocabulary by including all desired terms, as comma-separated values, within your request. You cannot use this parameter together with VocabularyFileUri.
    tags Tag[]
    Adds one or more custom tags, each in the form of a key:value pair, to the custom vocabulary.
    vocabularyFileUri string
    The Amazon S3 location of the text file that contains your custom vocabulary. You cannot use this parameter together with Phrases.
    vocabularyName string
    A unique name, chosen by you, for your custom vocabulary. This name is case sensitive, cannot contain spaces, and must be unique within an AWS account.
    language_code str
    The language code that represents the language of the entries in your custom vocabulary. Each custom vocabulary must contain terms in only one language.
    data_access_role_arn str
    The Amazon Resource Name (ARN) of an IAM role that has permissions to access the Amazon S3 bucket that contains your input file.
    phrases Sequence[str]
    Use this parameter if you want to create your custom vocabulary by including all desired terms, as comma-separated values, within your request. You cannot use this parameter together with VocabularyFileUri.
    tags Sequence[TagArgs]
    Adds one or more custom tags, each in the form of a key:value pair, to the custom vocabulary.
    vocabulary_file_uri str
    The Amazon S3 location of the text file that contains your custom vocabulary. You cannot use this parameter together with Phrases.
    vocabulary_name str
    A unique name, chosen by you, for your custom vocabulary. This name is case sensitive, cannot contain spaces, and must be unique within an AWS account.
    languageCode String
    The language code that represents the language of the entries in your custom vocabulary. Each custom vocabulary must contain terms in only one language.
    dataAccessRoleArn String
    The Amazon Resource Name (ARN) of an IAM role that has permissions to access the Amazon S3 bucket that contains your input file.
    phrases List<String>
    Use this parameter if you want to create your custom vocabulary by including all desired terms, as comma-separated values, within your request. You cannot use this parameter together with VocabularyFileUri.
    tags List<Property Map>
    Adds one or more custom tags, each in the form of a key:value pair, to the custom vocabulary.
    vocabularyFileUri String
    The Amazon S3 location of the text file that contains your custom vocabulary. You cannot use this parameter together with Phrases.
    vocabularyName String
    A unique name, chosen by you, for your custom vocabulary. This name is case sensitive, cannot contain spaces, and must be unique within an AWS account.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Vocabulary resource produces the following output properties:

    Arn string
    The Amazon Resource Name (ARN) of the custom vocabulary.
    Id string
    The provider-assigned unique ID for this managed resource.
    LastModifiedTime string
    The date and time the specified custom vocabulary was last modified.
    VocabularyState Pulumi.AwsNative.Transcribe.VocabularyState
    The processing state of your custom vocabulary. If the state is READY, you can use the custom vocabulary in a StartTranscriptionJob request.
    Arn string
    The Amazon Resource Name (ARN) of the custom vocabulary.
    Id string
    The provider-assigned unique ID for this managed resource.
    LastModifiedTime string
    The date and time the specified custom vocabulary was last modified.
    VocabularyState VocabularyStateEnum
    The processing state of your custom vocabulary. If the state is READY, you can use the custom vocabulary in a StartTranscriptionJob request.
    arn string
    The Amazon Resource Name (ARN) of the custom vocabulary.
    id string
    The provider-assigned unique ID for this managed resource.
    last_modified_time string
    The date and time the specified custom vocabulary was last modified.
    vocabulary_state "PENDING" | "READY" | "FAILED"
    The processing state of your custom vocabulary. If the state is READY, you can use the custom vocabulary in a StartTranscriptionJob request.
    arn String
    The Amazon Resource Name (ARN) of the custom vocabulary.
    id String
    The provider-assigned unique ID for this managed resource.
    lastModifiedTime String
    The date and time the specified custom vocabulary was last modified.
    vocabularyState VocabularyState
    The processing state of your custom vocabulary. If the state is READY, you can use the custom vocabulary in a StartTranscriptionJob request.
    arn string
    The Amazon Resource Name (ARN) of the custom vocabulary.
    id string
    The provider-assigned unique ID for this managed resource.
    lastModifiedTime string
    The date and time the specified custom vocabulary was last modified.
    vocabularyState VocabularyState
    The processing state of your custom vocabulary. If the state is READY, you can use the custom vocabulary in a StartTranscriptionJob request.
    arn str
    The Amazon Resource Name (ARN) of the custom vocabulary.
    id str
    The provider-assigned unique ID for this managed resource.
    last_modified_time str
    The date and time the specified custom vocabulary was last modified.
    vocabulary_state VocabularyState
    The processing state of your custom vocabulary. If the state is READY, you can use the custom vocabulary in a StartTranscriptionJob request.
    arn String
    The Amazon Resource Name (ARN) of the custom vocabulary.
    id String
    The provider-assigned unique ID for this managed resource.
    lastModifiedTime String
    The date and time the specified custom vocabulary was last modified.
    vocabularyState "PENDING" | "READY" | "FAILED"
    The processing state of your custom vocabulary. If the state is READY, you can use the custom vocabulary in a StartTranscriptionJob request.

    Supporting Types

    Tag, TagArgs

    A set of tags to apply to the resource.
    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    VocabularyState, VocabularyStateArgs

    Pending
    PENDING
    Ready
    READY
    Failed
    FAILED
    VocabularyStatePending
    PENDING
    VocabularyStateReady
    READY
    VocabularyStateFailed
    FAILED
    "PENDING"
    PENDING
    "READY"
    READY
    "FAILED"
    FAILED
    Pending
    PENDING
    Ready
    READY
    Failed
    FAILED
    Pending
    PENDING
    Ready
    READY
    Failed
    FAILED
    PENDING
    PENDING
    READY
    READY
    FAILED
    FAILED
    "PENDING"
    PENDING
    "READY"
    READY
    "FAILED"
    FAILED

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo aws-native logo

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.81.0
    published on Monday, Sep 28, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial