Skip to content

agentcore_cli.utils.validation

agentcore_cli.utils.validation

Validation utilities for AgentCore CLI.

validate_agent_name(name)

Validate agent name.

Agent names must be 3-64 characters, start with a letter, and contain only letters, numbers, hyphens, and underscores.

Parameters:

Name Type Description Default
name str

Agent name to validate.

 required

Returns:

Type Description
tuple[bool, str]

Tuple[bool, str]: Success status and error message if any.
Source code in agentcore_cli/utils/validation.py
Python
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
def validate_agent_name(name: str) -> tuple[bool, str]:
    """Validate agent name.

    Agent names must be 3-64 characters, start with a letter, and contain only
    letters, numbers, hyphens, and underscores.

    Args:
        name: Agent name to validate.

    Returns:
        Tuple[bool, str]: Success status and error message if any.
    """
    pattern: re.Pattern = re.compile(r"^[a-zA-Z][a-zA-Z0-9_-]{2,63}$")

    if not pattern.match(name):
        return False, (
            "Agent names must be 3-64 characters, start with a letter, "
            "and contain only letters, numbers, hyphens, and underscores."
        )

    return True, ""

validate_arn(arn)

Validate AWS ARN format.

Parameters:

Name Type Description Default
arn str

ARN to validate.

 required

Returns:

Type Description
tuple[bool, str]

Tuple[bool, str]: Success status and error message if any.
Source code in agentcore_cli/utils/validation.py
Python
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
def validate_arn(arn: str) -> tuple[bool, str]:
    """Validate AWS ARN format.

    Args:
        arn: ARN to validate.

    Returns:
        Tuple[bool, str]: Success status and error message if any.
    """
    pattern: re.Pattern = re.compile(r"^arn:(?:aws|aws-cn|aws-us-gov):([^:]*):([^:]*):([^:]*):([^:]*)(?::(.*))?$")

    if not pattern.match(arn):
        return False, "Invalid ARN format. Expected: arn:partition:service:region:account-id:resource"

    return True, ""

validate_aws_cli()

Check if AWS CLI is available on the system.

Returns:

Name Type Description
bool bool

True if AWS CLI is available, False otherwise.
Source code in agentcore_cli/utils/validation.py
Python
 7
 8
 9
10
11
12
13
14
15
16
17
def validate_aws_cli() -> bool:
    """Check if AWS CLI is available on the system.

    Returns:
        bool: True if AWS CLI is available, False otherwise.
    """
    try:
        returncode, _, _ = execute_command(["aws", "--version"], log_output=False)
        return returncode == 0
    except FileNotFoundError:
        return False

validate_region(region)

Validate AWS region format.

Parameters:

Name Type Description Default
region str

AWS region to validate.

 required

Returns:

Type Description
tuple[bool, str]

Tuple[bool, str]: Success status and error message if any.
Source code in agentcore_cli/utils/validation.py
Python
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
def validate_region(region: str) -> tuple[bool, str]:
    """Validate AWS region format.

    Args:
        region: AWS region to validate.

    Returns:
        Tuple[bool, str]: Success status and error message if any.
    """
    pattern: re.Pattern = re.compile(r"^[a-z]{2}-[a-z]+-\d+$")

    if not pattern.match(region):
        return False, "Invalid region format. Expected: e.g., us-east-1, eu-west-2"

    return True, ""

validate_repo_name(repo_name)

Validate ECR repository name.

Repository names must match: [a-z0-9][a-z0-9._-]{0,254}

Parameters:

Name Type Description Default
repo_name str

Repository name to validate.

 required

Returns:

Type Description
tuple[bool, str]

uple[bool, str]: Success status and error message if any.
Source code in agentcore_cli/utils/validation.py
Python
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
def validate_repo_name(repo_name: str) -> tuple[bool, str]:
    """Validate ECR repository name.

    Repository names must match: `[a-z0-9][a-z0-9._-]{0,254}`

    Args:
        repo_name: Repository name to validate.

    Returns:
        uple[bool, str]: Success status and error message if any.
    """
    pattern: re.Pattern = re.compile(r"^[a-z0-9][a-z0-9._-]{0,254}$")

    if not pattern.match(repo_name):
        return False, "Repository names must match: [a-z0-9][a-z0-9._-]{0,254}"

    return True, ""