Amazon Connect Cases

2023/05/19 - Amazon Connect Cases - 3 updated api methods

Changes  This release adds the ability to create fields with type Url through the CreateField API. For more information see https://docs.aws.amazon.com/cases/latest/APIReference/Welcome.html

BatchGetField (updated) Link ¶
Changes (response)
{'fields': {'type': {'Url'}}}

Returns the description for the list of fields in the request parameters.

See also: AWS API Documentation

Request Syntax

client.batch_get_field(
    domainId='string',
    fields=[
        {
            'id': 'string'
        },
    ]
)
type domainId:

string

param domainId:

[REQUIRED]

The unique identifier of the Cases domain.

type fields:

list

param fields:

[REQUIRED]

A list of unique field identifiers.

  • (dict) --

    Object for unique identifier of a field.

    • id (string) -- [REQUIRED]

      Unique identifier of a field.

rtype:

dict

returns:

Response Syntax

{
    'errors': [
        {
            'errorCode': 'string',
            'id': 'string',
            'message': 'string'
        },
    ],
    'fields': [
        {
            'description': 'string',
            'fieldArn': 'string',
            'fieldId': 'string',
            'name': 'string',
            'namespace': 'System'|'Custom',
            'tags': {
                'string': 'string'
            },
            'type': 'Text'|'Number'|'Boolean'|'DateTime'|'SingleSelect'|'Url'
        },
    ]
}

Response Structure

  • (dict) --

    • errors (list) --

      A list of field errors.

      • (dict) --

        Object for errors on fields.

        • errorCode (string) --

          The error code from getting a field.

        • id (string) --

          The field identifier that caused the error.

        • message (string) --

          The error message from getting a field.

    • fields (list) --

      A list of detailed field information.

      • (dict) --

        Object to store detailed field information.

        • description (string) --

          Description of the field.

        • fieldArn (string) --

          The Amazon Resource Name (ARN) of the field.

        • fieldId (string) --

          Unique identifier of the field.

        • name (string) --

          Name of the field.

        • namespace (string) --

          Namespace of the field.

        • tags (dict) --

          A map of of key-value pairs that represent tags on a resource. Tags are used to organize, track, or control access for this resource.

          • (string) --

            • (string) --

        • type (string) --

          Type of the field.

CreateField (updated) Link ¶
Changes (request)
{'type': {'Url'}}

Creates a field in the Cases domain. This field is used to define the case object model (that is, defines what data can be captured on cases) in a Cases domain.

See also: AWS API Documentation

Request Syntax

client.create_field(
    description='string',
    domainId='string',
    name='string',
    type='Text'|'Number'|'Boolean'|'DateTime'|'SingleSelect'|'Url'
)
type description:

string

param description:

The description of the field.

type domainId:

string

param domainId:

[REQUIRED]

The unique identifier of the Cases domain.

type name:

string

param name:

[REQUIRED]

The name of the field.

type type:

string

param type:

[REQUIRED]

Defines the data type, some system constraints, and default display of the field.

rtype:

dict

returns:

Response Syntax

{
    'fieldArn': 'string',
    'fieldId': 'string'
}

Response Structure

  • (dict) --

    • fieldArn (string) --

      The Amazon Resource Name (ARN) of the field.

    • fieldId (string) --

      The unique identifier of a field.

ListFields (updated) Link ¶
Changes (response)
{'fields': {'type': {'Url'}}}

Lists all fields in a Cases domain.

See also: AWS API Documentation

Request Syntax

client.list_fields(
    domainId='string',
    maxResults=123,
    nextToken='string'
)
type domainId:

string

param domainId:

[REQUIRED]

The unique identifier of the Cases domain.

type maxResults:

integer

param maxResults:

The maximum number of results to return per page.

type nextToken:

string

param nextToken:

The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.

rtype:

dict

returns:

Response Syntax

{
    'fields': [
        {
            'fieldArn': 'string',
            'fieldId': 'string',
            'name': 'string',
            'namespace': 'System'|'Custom',
            'type': 'Text'|'Number'|'Boolean'|'DateTime'|'SingleSelect'|'Url'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • fields (list) --

      List of detailed field information.

      • (dict) --

        Object for the summarized details of the field.

        • fieldArn (string) --

          The Amazon Resource Name (ARN) of the field.

        • fieldId (string) --

          The unique identifier of a field.

        • name (string) --

          Name of the field.

        • namespace (string) --

          The namespace of a field.

        • type (string) --

          The type of a field.

    • nextToken (string) --

      The token for the next set of results. This is null if there are no more results to return.