DevOpsAgentService / Client / create_agent_space

create_agent_space¶

DevOpsAgentService.Client.create_agent_space(**kwargs)¶

Creates a new AgentSpace with the specified name and description. Duplicate space names are allowed.

Request Syntax

response = client.create_agent_space(
    name='string',
    description='string',
    locale='string',
    kmsKeyArn='string',
    clientToken='string',
    tags={
        'string': 'string'
    },
    preferences={
        'string': True|False
    }
)

Parameters:

name (string) –
[REQUIRED]

The name of the AgentSpace.
description (string) – The description of the AgentSpace.
locale (string) – The locale for the AgentSpace, which determines the language used in agent responses.
kmsKeyArn (string) – The ARN of the AWS Key Management Service (AWS KMS) customer managed key that’s used to encrypt resources.
clientToken (string) –
Client-provided token to ensure request idempotency. When the same token is provided in subsequent calls, the same response is returned within a 8-hour window.

This field is autopopulated if not provided.
tags (dict) –
Tags to add to the AgentSpace at creation time.
- (string) –
  
  Tag key string.
  - (string) –
    
    Tag value string.
preferences (dict) –
The preferences to configure on the agent space. Preferences not provided take their default values.
- (string) –
  
  The key of a preference that can be configured on an agent space. The elevatedActionsEnabled key controls whether elevated directed actions are permitted in the agent space. Elevated directed actions are mutating operations that also require per-action operator approval, and default to false when not set.
  - (boolean) –

Return type:

dict

Returns:

Response Syntax

{
    'agentSpace': {
        'name': 'string',
        'description': 'string',
        'locale': 'string',
        'createdAt': datetime(2015, 1, 1),
        'updatedAt': datetime(2015, 1, 1),
        'kmsKeyArn': 'string',
        'agentSpaceId': 'string',
        'preferences': {
            'string': True|False
        }
    },
    'tags': {
        'string': 'string'
    }
}

Response Structure

(dict) –

Output containing the newly created AgentSpace.
- agentSpace (dict) –
  
  Represents a complete AgentSpace with all its properties, timestamps, encryption settings, and unique identifier.
  - name (string) –
    
    The name of the AgentSpace.
  - description (string) –
    
    The description of the AgentSpace.
  - locale (string) –
    
    The locale for the AgentSpace, which determines the language used in agent responses.
  - createdAt (datetime) –
    
    The timestamp when the resource was created.
  - updatedAt (datetime) –
    
    The timestamp when the resource was last updated.
  - kmsKeyArn (string) –
    
    The ARN of the AWS Key Management Service (AWS KMS) customer managed key that’s used to encrypt resources.
  - agentSpaceId (string) –
    
    The unique identifier of the AgentSpace
  - preferences (dict) –
    
    The preferences configured on the agent space. Preferences that are not set take their default values.
    - (string) –
      
      The key of a preference that can be configured on an agent space. The elevatedActionsEnabled key controls whether elevated directed actions are permitted in the agent space. Elevated directed actions are mutating operations that also require per-action operator approval, and default to false when not set.
      - (boolean) –
- tags (dict) –
  
  Tags associated with the created AgentSpace.
  - (string) –
    
    Tag key string.
    - (string) –
      
      Tag value string.

Exceptions

DevOpsAgentService.Client.exceptions.ValidationException
DevOpsAgentService.Client.exceptions.ContentSizeExceededException
DevOpsAgentService.Client.exceptions.ServiceQuotaExceededException
DevOpsAgentService.Client.exceptions.ConflictException
DevOpsAgentService.Client.exceptions.InternalServerException
DevOpsAgentService.Client.exceptions.AccessDeniedException
DevOpsAgentService.Client.exceptions.InvalidParameterException
DevOpsAgentService.Client.exceptions.ThrottlingException
DevOpsAgentService.Client.exceptions.ResourceNotFoundException